DSHdsh-plugin-subagent-roles
github.com/troytse/dsh-plugin-subagent-roles
`dsh-plugin-subagent-roles` 用文件来定义子代理角色。一个角色就是一个 Markdown 文件：frontmatter 里是显示名、路由描述、可选的模型路由、工具策略和可选的工具调用预算，正文是子代理要遵循的 persona。项目级角色放在 ` /.dsh/roles/`，全局角色放在 `~/.dsh/roles/`；同 id 同时存在时项目级生效。
作者原文（英文）
File-defined subagent roles for DeepSeek Harness: project (.dsh/roles) and global (~/.dsh/roles) role files, a compact role catalog, real per-role tool filtering, and a per-role tool-call budget.
中文简介由 DeepSeek 模型翻译，仅供参考。
检测报告
能力清单
- 写入文件
writes-files需留意1 处命中README.md:234- Hiding a tool removes its schema and any scope-aware prompt guidance. Prompt sections with static text stay in the chi…- 看写入位置。写自己的配置目录是正常的，写系统目录不是。
- 读取文件
reads-files一般10 处命中lib/roles.js:431if (existsSync(join(current, marker))) {lib/roles.js:451stats = statSync(path)lib/roles.js:474raw = readFileSync(path, 'utf8')lib/roles.js:493stats = statSync(root.path)- 读文件是绝大多数插件的正常工作方式，本身不构成顾虑。
- 读取环境变量
reads-env一般1 处命中lib/roles.js:99function resolveDshHome(configured, env = process.env) {- 环境变量里常混有密钥。看它是否把整个 env 都读走。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 写入文件 | writes-files | 需留意 | 1 |
| 读取文件 | reads-files | 一般 | 10 |
| 读取环境变量 | reads-env | 一般 | 1 |
这份报告的口径
扫描读的是包里的源码，全程不执行第三方代码。 本次读了 19 个文件，扫描于 2026-10-16。 命中次数只说明源码里出现过这类调用，不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单，不是信任评分，也不是安全结论： 没扫出来的能力可能只是写法没被规则覆盖。
依赖安全公告
这个插件声明的依赖中，有 2 条已公开的安全公告 （最高等级：中）：
| 等级 | 依赖包 | 编号 | 摘要 |
|---|---|---|---|
| 中 | yaml | CVE-2023-2251 | Uncaught Exception in yaml 修复版本：2.2.2 详情 → |
| 低 | yaml | CVE-2026-33532 | yaml is vulnerable to Stack Overflow via deeply nested YAML collections 修复版本：1.10.3, 2.8.3 详情 → |
查询的是依赖声明范围的下界（如 ^4.2.0 查 4.2.0），
不是实际安装到的版本。真正装的时候如果解析到了修复版本，就不受影响——
所以这是「可能受影响」，不是「这个插件有漏洞」。数据来自
OSV.dev。
可信度
- 0没有可扣分的项
认证等级 L3
- L0内容完整性✓sha512-8/+9b2N9mxhuA6n7… 与本地 tarball 复算一致
- L1来源✓维护者 troytse，仓库 troytse/dsh-plugin-subagent-roles（未做仓库审计）
- L2发行✓隔离 profile 安装成功，3.8s，层已挂载
- L3生态✓契约一致，宿主带它启动成功
- L4多方独立验证—本站不做第三方独立背书
评分口径与作者信息
从 100 分开始按规则扣减：fail −20 / major −10 / warn −5 / minor −2；star 数、下载量、LLM 输出都不参与评分
- 维护者
- troytse
- 仓库
- https://github.com/troytse/dsh-plugin-subagent-roles
- 许可
- MIT
- 最后发布
- 2026-09-30
- 周下载
- 417
- star
- 1
扫描状态：已扫描。能力是事实，不是缺陷； 周下载与 star 只作参考，不参与评分。
认证等级核验的是这个包本身（内容指纹、来源、能否安装、声明是否属实）；依赖漏洞是独立标注的，两者正交、不互相掩盖。可信 ≠ 无漏洞，上架 ≠ 推荐。