安装验证:沙盒安装通过,Web 冒烟失败 (L5 failed) · 验证于 dsh 0.2.1-rc.2 · 验证日期 安装验证详情 →
功能介绍AI
帮助完成技术文档写作,涵盖开发简报、用户手册、报告及API文档,并减少AIGC痕迹。
- 完成技术文档撰写
- 涵盖开发简报、手册、报告及API文档
- 降低AIGC痕迹,输出更自然
能力标签为 AI 推断或 README 规则抽取(见角标),词表受限、未经安装验证;AI = 推断,README = 原文关键词。
安装
dsh plugin --profile web add github:zh851233/docs-mode#v2.0.0安装方式: GitHub · 沙盒安装通过,Web 冒烟失败 (L5 failed)
验证与兼容性
按插件版本分组:每张卡是该插件版本实测过的 dsh 版本与安装兼容结论(L5 优先)。只列真测过的组合——未列出 = 未实测,不推定兼容。L1–L3 为插件级静态档(与 dsh 版本无关,各 dsh 行同值):在行内「验证等级」格里与 L4/L5 并列显示、标注「静态」,证据体为插件级单份、随行内「查看检查项与证据」出现,不在各版本重复存储。
External credentials(插件级):未检测到
○ 作者未声明 dsh 版本要求 —— 安装不会因版本被拒。
| 插件版本 \ dsh | dsh 0.2.1-rc.2 当前 | dsh 0.2.1-alpha.4 | dsh 0.2.1-alpha.2 | dsh 0.2.0-rc.2 | dsh 0.2.0-rc.1 |
|---|---|---|---|---|---|
| v2.1.1 | · | · | · | · | · |
| v2.0.0 | ✗ | ✗ | ✗ | ✗ | · |
v2.1.1github2026-10-25
https://github.com/zh851233/docs-mode
该版本无运行时安装实测(仅静态扫描)——兼容性未知,不推定。
v2.0.0github失败 42026-10-19
https://github.com/zh851233/docs-mode
✗dsh 0.2.1-rc.2当前2026-10-19L5 · 失败
- • Node.js: v24.14.0
- • DSH: 0.2.1-rc.2
- • 被测插件工件: github · https://github.com/zh851233/docs-mode#v2.0.0
ID: docs-mode@v2.0.0@dsh0.2.1-rc.2 · 档位: l4-sandbox
签发:2026-10-19 · 有效至:2026-10-26
查看检查项与证据
L1–L3 为插件级静态结论(基础门槛,全 dsh 版本相同):证据为插件级单份,不在各版本重复存储。
✗dsh 0.2.1-alpha.42026-10-17L5 · 失败
- • Node.js: v24.14.0
- • DSH: 0.2.1-alpha.4
- • 被测插件工件: github · https://github.com/zh851233/docs-mode#v2.0.0
ID: docs-mode@v2.0.0@dsh0.2.1-alpha.4 · 档位: l4-sandbox
签发:2026-10-17 · 有效至:2026-10-24
查看检查项与证据
L1–L3 为插件级静态结论(基础门槛,全 dsh 版本相同):证据为插件级单份,不在各版本重复存储。
✗dsh 0.2.1-alpha.22026-10-11L5 · 失败
- • Node.js: v24.14.0
- • DSH: 0.2.1-alpha.2
- • 被测插件工件: github · https://github.com/zh851233/docs-mode#v2.0.0
ID: docs-mode@v2.0.0@dsh0.2.1-alpha.2 · 档位: l4-sandbox
签发:2026-10-11 · 有效至:2026-10-18
查看检查项与证据
L1–L3 为插件级静态结论(基础门槛,全 dsh 版本相同):证据为插件级单份,不在各版本重复存储。
✗dsh 0.2.0-rc.22026-10-09L5 · 失败
- • Node.js: v24.14.0
- • DSH: 0.2.0-rc.2
- • 被测插件工件: github · https://github.com/zh851233/docs-mode#v2.0.0
ID: docs-mode@v2.0.0@dsh0.2.0-rc.2 · 档位: l4-sandbox
签发:2026-10-09 · 有效至:2026-10-16
查看检查项与证据
L1–L3 为插件级静态结论(基础门槛,全 dsh 版本相同):证据为插件级单份,不在各版本重复存储。
仅展示最近 3 个已发布版本;源码快照(commit hash)组、未标注工件组与更早版本不展示——全量档案保留在数据层(插件无任何已发布版本时,快照/未标注组才照常展示)。
作者徽章
将官方徽章嵌入你的 README,展示插件的安全与安装检测状态:
`[](https://www.dsh.so/artifact/docs-mode/)``[](https://www.dsh.so/artifact/docs-mode/)``[](https://www.dsh.so/artifact/docs-mode/)``[](https://www.dsh.so/artifact/docs-mode/)`安全报告
两层自动化检查,都不是人工审核:静态扫描(逐插件规则判定)与模型驱动的动态安全审计(只覆盖静态判定 warn 及以上的插件子集,不执行插件代码)。
静态扫描 低;动态审计最高 低(有结论时以动态为准)→ 总评级 低。
v2.1.1dsh 清单v2.1.1git2026-10-24v2.1.1版本一致clean · gitvet 为 AST 静态扫描(npm 发布物或 git 源码)。
静态发现(4 条)
- 严重spawnShell · shell
preset/assets/screenshot-tools/screenshots.mjs:48serverProc = spawn(serverCmd, { shell: true, cwd: serverDir || process.cwd(), stdio: 'ignore' }); - 警告manifest-fs-unfenced · sandbox
preset/agent.cordis.ymlMutating filesystem tool has no explicit fs backend in realm - 警告manifest-search-unfenced · sandbox
preset/agent.cordis.ymlSearch tool reads without an explicit fs mount - 警告manifest-shell-unfenced · sandbox
preset/agent.cordis.ymlShell tool without a sandbox runner or policy in realm
展开 3 条审计发现
- low截图助手通过 shell 执行 argv 传入的命令
assets/screenshot-tools/screenshots.mjs:48serverCmd 来自 --server-command 命令行参数并由 shell 解释,字符串中的 shell 元字符会被执行。可达性有限:该参数由调用脚本的运营者/Agent 提供,而同一 Agent 本就拥有 tool-bash/tool-pwsh,因此不构成权限提升;只有当命令字符串被从不可信仓库文本中抄入调用时才有实际影响。
- low安装器在插件加载时写入 $DSH_HOME,且未列入发布文件清单
lib/index.js:34apply() 在插件加载时无条件把包内 preset/ 递归复制到 $DSH_HOME/.agent-presets/docs(DSH_DOCS_MODE_FORCE=1 时覆盖),属于会话工作区之外的文件副作用。另外 package.json 的 `files` 未包含 "lib",发布 tarball 很可能根本不带这个入口——包内注释也写明该格式自 dsh 0.2 起已废弃。路径不可被攻击者控制(条目来自包自身 preset/ 的 readdirSync),因此影响是意外的家目录写入与死代码,而非可利用行为。
- lowbundle patch 通过硬编码的 ~/.dsh/profiles/desktop 清单解析包路径
cordis.patch.yml:57该 !!js 表达式(以及 skill-filesystem 的 customSkillDirs 中完全相同的一处)在挂载时由配置加载器求值,不受攻击者影响——只用于解析插件自身的安装目录。其缺陷是硬编码 $HOME/.dsh/profiles/desktop 而未遵循 DSH_HOME,非默认 profile 布局下 createRequire/resolve 会抛错,导致 preset 挂载失败且缺乏可读诊断。
文书写作 Agent 预设包;被标记的 shell 启动与 YAML !!js 均属运营者提供的路径解析,非攻击者可控输入,仅余低危加固问题。
口径(2026-10-24):有动态审计结论时以动态结论为准(可能上调也可能下调);无结论时以静态/vet 融合档为准。动态审计永不写豁免表(豁免只能人工三筛手写);模型判错时由人工复核撤回,撤回后档位回到静态/vet。
免责声明:静态扫描与动态安全审计都是自动化分析,不构成安全保证。安装前请自行审查。
活跃度
最近提交 2026-10-24 · 活跃度:活跃
• 仓库创建: 2026-08-25
• 星标: ★ 4 · 复刻: 0
• 健康度: 活跃 — 近 30 天有提交
来源
GitHub: github.com/zh851233/docs-mode
作者 README
GitHub 原文 ↗展示作者仓库中的原始 README 内容,实时抓取、未做改写;优先加载中文版(README.zh-CN.md 等),无中文版时回退英文。
