D

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
分类
market
发布
2026-10-12
版本
v0.13.1

检测报告

关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
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_DIR
    • scripts/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/* 不作查询——那是运行时自己的问题,不是插件的。)

← 返回全部插件