浏览全部

技能包 · v0.3.27

dsh-plugin-guide

github.com/PerryLink/dsh-plugin-guide

能力以 shell 执行命令可执行外部程序写入文件

- 1024 商店渠道:先执行一次 npm i -g dsh1024,然后执行 dsh1024 plugin --profile web add dsh-plugin-guide(计入 deepseek1024.com 的安装排名)。

作者原文(英文)

- 1024 store channel: npm i -g dsh1024 once, then dsh1024 plugin --profile web add dsh-plugin-guide (counts toward the deepseek1024.com install ranking).

简介取自插件 README 开头,由 DeepSeek 模型翻译,仅供参考。

dshdeepseek-harnessdsh-plugincordisagent-skillplugin-developmentknowledge-basecli
认证 L3已扫描 ✓健康 A/90周下载 2.4k
12 项能力
许可
Apache-2.0
发布
2026-10-10
维护者
perrylink
插件 ID
2194

安装命令

dsh plugin --profile web add dsh-plugin-guide@0.3.27

已试装 · 层已挂载

已在一个隔离的 profile 里真装过:包能装上,并且插件层挂载成功。这一条是实测结果,不是作者的声明。

检测报告

关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
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
    • 清单被刻意写乱时,加载行为会难以预测。看原文而不是看渲染结果。
  • 读取文件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…
    • 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
  • 接触凭据或密钥credentials一般24 处命中
    • …ookbook/adding-an-llm-adapter.md:23Registration is effect-based (HMR-safe); one adapter per provider route — duplicates throw, and multi-route registration…
    • …book/adding-an-llm-adapter.zh.md:23注册基于副作用,可安全支持 HMR(热模块替换);每个提供方路由仅对应一个适配器,重复注册会抛出异常,多路由注册要么全部成功,要么全部失败。`options.provider` 用于选择适配器,`options.model` 是提供方模型 …
    • …al-docs/docs/capability-seams.md:104svc_credentials["ctx.credentials<br/>Credential seam"]
    • …al-docs/docs/capability-seams.md:608| `ctx.credentials` | `seam` | [`credentials`](../packages/credentials/credentials) | [`credentials-local`](../packages/…
    • 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
  • 读取环境变量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
读取文件reads-files一般37
接触凭据或密钥credentials一般24
读取环境变量reads-env一般17
文中出现远程脚本地址remote-url-reference一般16
动态加载模块dynamic-import一般14

这份报告的口径

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

可信度

90 健康分 A 扣分项下方逐条附证据
  • -10声明与实物不符:client-present-undeclaredmajor:['references/official-docs/docs/subsystems/client-modules.i18n.yaml', 'references/official-docs/docs/subsystems/client-modules.md', 'referen

认证等级 L3

  • L0静态结构与契约✓sha512-GgWMmwna326mfbaw… 与本地 tarball 复算一致,补丁与入口齐备,另有 1 项声明不一致(计入健康扣分)
  • L1配置组合与依赖图✓跨包无 entry id 冲突,插入模块可解析,目录内 peer 满足
  • L2隔离沙箱冒烟✓隔离 profile 安装成功,5.2s,层已挂载;宿主带它启动(booted)
  • L3运行时健康监控✓抽样会话内未观测到外部进程 / 越界写 / 外连(2 个事件)
评分口径与作者信息

从 100 分开始按规则扣减:fail −20 / major −10 / warn −5 / minor −2;star 数、下载量、LLM 输出都不参与评分

维护者
perrylink
仓库
https://github.com/PerryLink/dsh-plugin-guide
许可
Apache-2.0
最后发布
2026-10-10
周下载
2.4k
star
49

扫描状态:已扫描。能力是事实,不是缺陷; 周下载与 star 只作参考,不参与评分。

认证等级只回答四件事:包本身是否完整可解析(L0)、能不能与别的插件组合(L1)、隔离环境里装不装得上并起得来(L2)、抽样运行时有没有异常(L3)。依赖漏洞、仓库存活、下载量都不参与评级,只作为独立信号标注。可信 ≠ 无漏洞,上架 ≠ 推荐。

DSH peer 依赖1 个dsh均为 @deepseek-ai/ 下的包
Node 要求^22.19.0 || >=24.0.0
第三方依赖2 个
bundle patch./cordis.patch.yml
依赖安全公告已查询全部依赖,没有匹配到已公开的安全公告(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。)

元数据

主页https://github.com/PerryLink/dsh-plugin-guide#readme
仓库最近提交2026-10-13
仓库创建2026-08-13

返回首页