DSH工具与效率 · v0.2.6
dsh-git-readonly
面向 DeepSeek Harness 智能体的只读 git 溯源工具：模型可以针对会话仓库回答“这次改动是为哪个任务做的”——分支 → 历史 → blame → 提交——全程无需接收命令行。
作者原文（英文）
Read-only git provenance tools for DeepSeek Harness agents: the model can answer "what task was this changed for" against the session repository — branch → history → blame → commit — without ever receiving a command line.
简介取自插件 README 开头，由 DeepSeek 模型翻译，仅供参考。
安装命令
dsh plugin --profile web add @yadsh/dsh-git-readonly@0.2.6
已试装 · 层已挂载
已在一个隔离的 profile 里真装过：包能装上，并且插件层挂载成功。这一条是实测结果，不是作者的声明。
检测报告
能力清单
- 可执行外部程序
spawns-processes高关注1 处命中lib/git/runner.js:15import { spawn } from "node:child_process";- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 写入文件
writes-files需留意1 处命中package.json:77"clean": "node -e \"require('node:fs').rmSync('lib', { recursive: true, force: true })\"",- 看写入位置。写自己的配置目录是正常的，写系统目录不是。
- 动态加载模块
dynamic-import一般6 处命中lib/tools/blame.d.ts:15export declare function createGitBlameTool(deps: GitToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition;lib/tools/context.d.ts:22export declare function createGitContextTool(deps: GitToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition;lib/tools/history.d.ts:21export declare function createGitHistoryTool(deps: GitToolDeps): import("@deepseek-ai/dsh-tools").ToolDefinition;lib/index.d.ts:31export declare const Config: import("@deepseek-ai/schemastery").default<GitReadonlyConfig>;- 动态导入本身无害，但会让依赖关系难以静态审阅。
- 读取环境变量
reads-env一般1 处命中lib/git/env.js:48export function buildGitEnv(base = process.env) {- 环境变量里常混有密钥。看它是否把整个 env 都读走。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 1 |
| 写入文件 | writes-files | 需留意 | 1 |
| 动态加载模块 | dynamic-import | 一般 | 6 |
| 读取环境变量 | reads-env | 一般 | 1 |
这份报告的口径
扫描读的是包里的源码，全程不执行第三方代码。 本次读了 31 个文件，扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用，不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单，不是信任评分，也不是安全结论： 没扫出来的能力可能只是写法没被规则覆盖。
可信度
- 0没有可扣分的项
认证等级 L3
- L0静态结构与契约✓sha512-423iEJ9XvLUI537g… 与本地 tarball 复算一致，补丁与入口齐备
- L1配置组合与依赖图✓跨包无 entry id 冲突，插入模块可解析，目录内 peer 满足
- L2隔离沙箱冒烟✓隔离 profile 安装成功，3.4s，层已挂载；宿主带它启动（booted）
- L3运行时健康监控✓抽样会话内未观测到外部进程 / 越界写 / 外连（2 个事件）
评分口径与作者信息
从 100 分开始按规则扣减：fail −20 / major −10 / warn −5 / minor −2；star 数、下载量、LLM 输出都不参与评分
- 维护者
- xarleyn
- 仓库
- https://github.com/xarleyn/dsh-plugins
- 许可
- MIT
- 最后发布
- 2026-10-11
- 周下载
- 342
- star
- 2
扫描状态：已扫描。能力是事实，不是缺陷； 周下载与 star 只作参考，不参与评分。
认证等级只回答四件事：包本身是否完整可解析（L0）、能不能与别的插件组合（L1）、隔离环境里装不装得上并起得来（L2）、抽样运行时有没有异常（L3）。依赖漏洞、仓库存活、下载量都不参与评级，只作为独立信号标注。可信 ≠ 无漏洞，上架 ≠ 推荐。
| DSH peer 依赖 | 1 个dsh-tools均为 @deepseek-ai/ 下的包 |
|---|---|
| Node 要求 | ^22.19.0 || >=24.0.0 |
| 第三方依赖 | 1 个 |
| bundle patch | ./cordis.patch.yml |
| 依赖安全公告 | 已查询全部依赖，没有匹配到已公开的安全公告（含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题，不是插件的。） |
元数据
| 主页 | https://github.com/xarleyn/dsh-plugins/tree/main/plugins/dsh-git-readonly#readme |
|---|---|
| 仓库最近提交 | 2026-10-12 |
| 仓库创建 | 2026-08-29 |