DSH插件目录
D

dsh-plugin-guide

github.com/PerryLink/dsh-plugin-guide

v0.3.27 技能包 以 shell 执行命令可执行外部程序写入文件

这个插件是 DSH 插件家族的一员（40+ 个，全部 Apache-2.0）。如果你在用，**给个 star** —— 它不会解锁任何功能，但会让下一个人在搜索里更容易找到它。

作者原文（英文）

The dsh-plugin-guide knowledge base plus the dsh-plugin-dev CLI toolchain: official docs, Cordis primer, community deep-dives, and battle-tested pitfalls registered as an on-demand agent skill, with a scaffolder, static checker, and pack verifier for buil

中文简介由 DeepSeek 模型翻译，仅供参考。

dshdeepseek-harnessdsh-plugincordisagent-skillplugin-developmentknowledge-basecli
分类
skill
发布
2026-10-10
版本
v0.3.27

检测报告

关注度高。命中了不少能力模式，其中可能有需要留意的。逐条看下面的清单。
2高关注5需留意5一般12未命中
高关注需留意一般

能力清单

  • 以 shell 执行命令shell-exec高关注8 处命中
    • dist/dsh-plugin-dev.js:1535shell: true,
    • references/harness-repo.md:335- 例子（`service.md` L115–L137）用 `@deepseek-ai/cordis-plugin-group` + `isolate: { shell: true }` + `config:` 子列表。
    • …ser/develop/framework/service.md:120shell: true
    • …ser/develop/framework/service.md:131shell: true
    • 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
  • 可执行外部程序spawns-processes高关注2 处命中
    • dist/dsh-plugin-dev.js:5import { spawn } from "node:child_process";
    • scripts/verify-artifacts.mjs:7import { spawnSync } from 'node:child_process'
    • 看它调用哪些程序。调用本机已有的工具是常见做法。
  • 写入文件writes-files需留意21 处命中
    • dist/dsh-plugin-dev.js:87rmSync(dir, {
    • dist/dsh-plugin-dev.js:115mkdirSync(dirname(path), { recursive: true });
    • dist/dsh-plugin-dev.js:116writeFileSync(path, content, "utf8");
    • …/cookbook/adding-a-remote-api.md:77export async function rename(noteId: string, title: string): Promise<void> {
    • 看写入位置。写自己的配置目录是正常的，写系统目录不是。
  • 发起网络请求network需留意14 处命中
    • …l-docs/docs/config-catalog.zh.md:1021/** Maximum request-body prefix retained for one fetch. */
    • …l-docs/docs/config-catalog.zh.md:1023/** Maximum response-body prefix retained for one fetch. */
    • …docs/user/guide/github-review.md:79const response = await fetch('https://policy.internal/pr-review', {
    • …s/user/guide/github-review.zh.md:79const response = await fetch('https://policy.internal/pr-review', {
    • 看请求发往哪些域名。发往作者自己的后端是常见做法。
  • 启动伪终端spawns-pty需留意14 处命中
    • dist/dsh-plugin-dev.js:1639node-pty: true
    • …ocs/docs/dependency-catalog.json:6556"name": "node-pty",
    • …ocs/docs/dependency-catalog.json:6560"location": "node_modules/node-pty",
    • guide/choosing-a-plugin.md:146**Leader: `omdsh-dev/DSH-better-sidebar`** — **127** installs / 99 installers / 38 in 30 days / **57,806** weekly downlo…
    • 伪终端等于给了一个完整 shell。确认这是插件的核心功能。
  • 动态执行代码dynamic-code需留意2 处命中
    • references/upstream-cordis.md:330- Loader 在 entry 激活、声明注入已激活之后，对 entry 的 `config` 做 `interpolate(ctx, config)`——递归把 `__jsExpr` 节点替换为 `evaluate(ctx, expr)…
    • 看 eval / new Function 的入参来自哪里。常量字符串和用户输入是两回事。
  • R013 清单可疑manifest-obfuscation需留意1 处命中
    • 安装脚本: prepare
    • 清单被刻意写乱时，加载行为会难以预测。看原文而不是看渲染结果。
  • 接触凭据或密钥credentials一般880 处命中
    • dist/dsh-plugin-dev.js:1768detail: smokeOk ? `${smoke.stdout}\n${smoke.stderr}`.includes("MISSING_CREDENTIAL") ? "ok (keyless)" : "ok (with key)" :…
    • dist/dsh-plugin-dev.js:1828"MISSING_CREDENTIAL",
    • dist/dsh-plugin-dev.js:1838* a keyless run printing `MISSING_CREDENTIAL`, a keyed run printing `ok`, or a
    • …ocs/docs/dependency-catalog.json:112"name": "@aws-sdk/credential-provider-env",
    • 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
  • 读取文件reads-files一般37 处命中
    • dist/dsh-plugin-dev.js:98return readFileSync(path, "utf8");
    • dist/dsh-plugin-dev.js:121return statSync(path).isFile();
    • dist/dsh-plugin-dev.js:129return statSync(path).isDirectory();
    • dist/dsh-plugin-dev.js:163for (const candidate of candidates) if (existsSync(join(candidate, "ts")) && existsSync(join(candidate, "js"))) return r…
    • 读文件是绝大多数插件的正常工作方式，本身不构成顾虑。
  • 读取环境变量reads-env一般17 处命中
    • dist/dsh-plugin-dev.js:155const env = process.env.DSH_PLUGIN_DEV_TEMPLATES;
    • dist/dsh-plugin-dev.js:1487const env = { ...process.env };
    • dist/dsh-plugin-dev.js:1855return flag ?? process.env.DSH_PLUGIN_DEV_DSH ?? "dsh";
    • dist/dsh-plugin-dev.js:1859return flag ?? process.env.DSH_PLUGIN_DEV_PNPM ?? "pnpm";
    • 环境变量里常混有密钥。看它是否把整个 env 都读走。
  • 文中出现远程脚本地址remote-url-reference一般16 处命中
    • …cial-docs/THIRD_PARTY_NOTICES.md:54| [`@octokit/webhooks`](https://github.com/octokit/webhooks.js) | MIT |
    • …cial-docs/THIRD_PARTY_NOTICES.md:70| [`@xterm/addon-fit`](https://github.com/xtermjs/xterm.js/tree/master/addons/addon-fit) | MIT |
    • …cial-docs/THIRD_PARTY_NOTICES.md:71| [`@xterm/addon-serialize`](https://github.com/xtermjs/xterm.js/tree/master/addons/addon-serialize) | MIT |
    • …cial-docs/THIRD_PARTY_NOTICES.md:72| [`@xterm/headless`](https://github.com/xtermjs/xterm.js) | MIT |
    • 只是文本里出现了远程脚本地址，没有看到加载它的调用。多半是文档或注释；若确实可疑，搜一下这个地址在包里的其他出现位置。
  • 动态加载模块dynamic-import一般14 处命中
    • …nces/community-repo-deep-dive.md:283- 已挂载插件改源码需 web 重启（ESM 模块缓存按 URL 永久缓存，`import(entryUrl)` 无 query bust）（`gotchas.md`）；
    • …ial-docs/docs/subsystems/goal.md:307'goal/changed'(this: import('@deepseek-ai/dsh-scope').Scoped<Agent>, payload: { agent: Agent; change: GoalChanged }): vo…
    • …-docs/docs/subsystems/goal.zh.md:307'goal/changed'(this: import('@deepseek-ai/dsh-scope').Scoped<Agent>, payload: { agent: Agent; change: GoalChanged }): vo…
    • …docs/docs/persistence-catalog.md:334sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq
    • 动态导入本身无害，但会让依赖关系难以静态审阅。
逐条扫描明细
能力标识关注度命中次数
以 shell 执行命令shell-exec高关注8
可执行外部程序spawns-processes高关注2
写入文件writes-files需留意21
发起网络请求network需留意14
启动伪终端spawns-pty需留意14
动态执行代码dynamic-code需留意2
R013 清单可疑manifest-obfuscation需留意1
接触凭据或密钥credentials一般880
读取文件reads-files一般37
读取环境变量reads-env一般17
文中出现远程脚本地址remote-url-reference一般16
动态加载模块dynamic-import一般14

这份报告的口径

扫描读的是包里的源码，全程不执行第三方代码。 本次读了 671 个文件，扫描于 2026-10-14。 命中次数只说明源码里出现过这类调用，不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单，不是信任评分，也不是安全结论： 没扫出来的能力可能只是写法没被规则覆盖。

依赖安全公告

已查询这个插件声明的全部依赖，没有匹配到已公开的安全公告。（含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题，不是插件的。）

← 返回全部插件