dsh-subagent-registry
github.com/fan56/dsh-subagent-registry
v0.13.1
市场与管理
可执行外部程序以 shell 执行命令写入文件
把 `~/.dsh/agents/*.md` 定义的自定义 agent(frontmatter 元数据 + markdown 正文作为 persona/system prompt)注册成 dsh 可按名调用的 subagent:主对话通过 `use_agent` 点名调用,`ask_agent` 对后台 代理追问并等回复。跑在 dsh 自带的 `spawn` provider 上,纯插件、不改 dsh 本体。
作者原文(英文)
dsh plugin: register locally-defined custom agents (~/.dsh/agents/*.md) as callable subagents via the use_agent tool, with continuable background dispatch and ask_agent follow-ups
中文简介由 DeepSeek 模型翻译,仅供参考。
dshdsh-pluginsubagentagentregistryinteractivebackgroundsend-message
检测报告
关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
2高关注3需留意3一般16未命中
高关注需留意一般
能力清单
- 可执行外部程序
spawns-processes高关注2 处命中scripts/link-dsh-closure.mjs:36import { execFileSync } from 'node:child_process'scripts/smoke-boot.mjs:30import { spawnSync } from 'node:child_process'- 看它调用哪些程序。调用本机已有的工具是常见做法。
- 以 shell 执行命令
shell-exec高关注2 处命中scripts/link-dsh-closure.mjs:69const bin = execFileSync('which', ['dsh'], { encoding: 'utf8' }).trim()scripts/link-dsh-closure.mjs:79const root = execFileSync('npm', ['root', '-g'], { encoding: 'utf8' }).trim()- 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
- 写入文件
writes-files需留意11 处命中lib/seed-defaults.js:36mkdirSync(targetDir, { recursive: true });lib/seed-defaults.js:53writeFileSync(join(targetDir, `${parsed.agent.meta.name}.md`), readFileSync(sourcePath));scripts/link-dsh-closure.mjs:97mkdirSync(scopeDir, { recursive: true })scripts/link-dsh-closure.mjs:105rmSync(target, { recursive: true, force: true })- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 运行时改写自身配置
modifies-own-manifest需留意2 处命中scripts/smoke-boot.mjs:58writeFileSync(path.join(profile, 'cordis.patch.yml'), '# scratch smoke profile: no extra patch layer\n[]\n')scripts/smoke-boot.mjs:59writeFileSync(path.join(profile, 'package.json'), JSON.stringify({- 运行时改写自身配置会让下次启动的行为和你看过的源码不一致。
- R013 清单可疑
manifest-obfuscation需留意1 处命中- 安装脚本: postinstall
- 清单被刻意写乱时,加载行为会难以预测。看原文而不是看渲染结果。
- 读取文件
reads-files一般33 处命中lib/agents-dir.js:172if (!existsSync(dir))lib/agents-dir.js:174for (const entry of readdirSync(dir, { withFileTypes: true })) {lib/agents-dir.js:178const result = parseAgentMarkdown(readFileSync(path, 'utf8'), path);lib/index.js:69content: stripFrontmatter(await readFile(SKILL_BODY_URL, 'utf8')),- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 读取环境变量
reads-env一般4 处命中lib/agents-dir.js:56return process.env.DSH_HOME ?? join(homedir(), '.dsh');scripts/link-dsh-closure.mjs:60const override = process.env.DSH_CLOSURE_DIRscripts/smoke-boot.mjs:86const dshEnv = { ...process.env, DSH_HOME: home }src/agents-dir.ts:101return process.env.DSH_HOME ?? join(homedir(), '.dsh')- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 动态加载模块
dynamic-import一般2 处命中lib/interactive.d.ts:116export declare function askAgentTool(ctx: Context, cfg: AskAgentConfig): import("@deepseek-ai/dsh-tools").ToolDefinition…lib/tool-run-agent.d.ts:176export declare function runAgentTool(ctx: Context, cfg: RunAgentConfig): import("@deepseek-ai/dsh-tools").ToolDefinition…- 动态导入本身无害,但会让依赖关系难以静态审阅。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 可执行外部程序 | spawns-processes | 高关注 | 2 |
| 以 shell 执行命令 | shell-exec | 高关注 | 2 |
| 写入文件 | writes-files | 需留意 | 11 |
| 运行时改写自身配置 | modifies-own-manifest | 需留意 | 2 |
| R013 清单可疑 | manifest-obfuscation | 需留意 | 1 |
| 读取文件 | reads-files | 一般 | 33 |
| 读取环境变量 | reads-env | 一般 | 4 |
| 动态加载模块 | dynamic-import | 一般 | 2 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 37 个文件,扫描于 2026-10-14。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
依赖安全公告
已查询这个插件声明的全部依赖,没有匹配到已公开的安全公告。(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。)