dsh-plugin-dev-kb
github.com/Pasumao/dsh-plugin-dev-kb
v1.4.0
界面与主题
以 shell 执行命令写入文件发起网络请求
dsh 插件开发知识库:DeepSeek Harness 官方文档站完整 Markdown 镜像(中英双语 188 页)+ 182 篇仓库补充开发参考 + 主题导航与 373 文件全量搜索索引;以 dsh-plugin-dev-kb 技能让 agent 在插件开发任务中自动加载定位文档。纯数据插件,零运行时依赖。
该插件尚未翻译,显示作者原文。
dshdsh-plugindeepseekharnesscordispluginknowledgeknowledge-base
检测报告
关注度高。命中了不少能力模式,其中可能有需要留意的。逐条看下面的清单。
1高关注3需留意5一般15未命中
高关注需留意一般
能力清单
- 以 shell 执行命令
shell-exec高关注4 处命中…ite/develop/framework/service.md:125shell: true…ite/develop/framework/service.md:136shell: true…/en/develop/framework/service.md:123shell: true…/en/develop/framework/service.md:134shell: true- 看命令字符串是拼出来的还是写死的。拼接用户输入才是真正的风险。
- 写入文件
writes-files需留意19 处命中…/cookbook/adding-a-remote-api.md:77export async function rename(noteId: string, title: string): Promise<void> {…/cookbook/adding-a-remote-api.md:157declare function rename(noteId: string, title: string): Promise<void>…/cookbook/adding-a-remote-api.md:160const failure = await rename('n-404', 'fresh title').catch((error: unknown) => error)…okbook/adding-a-remote-api.zh.md:77export async function rename(noteId: string, title: string): Promise<void> {- 看写入位置。写自己的配置目录是正常的,写系统目录不是。
- 发起网络请求
network需留意14 处命中…site/reference/config-catalog.md:1024/** Maximum request-body prefix retained for one fetch. */…site/reference/config-catalog.md:1026/** Maximum response-body prefix retained for one fetch. */kb/site/en/guide/github-review.md:82const response = await fetch('https://policy.internal/pr-review', {kb/site/guide/github-review.md:82const response = await fetch('https://policy.internal/pr-review', {- 看请求发往哪些域名。发往作者自己的后端是常见做法。
- 启动伪终端
spawns-pty需留意4 处命中…ference/subsystems/subprocess.md:259The abstract [`SubprocessRuntime`](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/subprocess/subpr……ference/subsystems/subprocess.md:259抽象的 [`SubprocessRuntime`](https://github.com/deepseek-ai/deepseek-harness/blob/master/packages/subprocess/subprocess/src…- 伪终端等于给了一个完整 shell。确认这是插件的核心功能。
- 接触凭据或密钥
credentials一般795 处命中kb/meta/search-index.json:1533"path": "kb/site/en/reference/subsystems/credentials.md",kb/meta/search-index.json:1534"url": "https://deepseek-harness.github.io/deepseek-harness/en/reference/subsystems/credentials",kb/meta/search-index.json:1535"title": "User Credentials",kb/meta/search-index.json:1989"path": "kb/site/reference/subsystems/credentials.md",- 看它读取哪些凭据、发往哪里。用于登录自己的服务是正常的。
- 读取文件
reads-files一般13 处命中lib/index.js:53if (!existsSync(SKILLS_DIR)) {lib/index.js:57for (const file of readdirSync(SKILLS_DIR)) {lib/index.js:60const fm = parseFrontmatter(readFileSync(join(SKILLS_DIR, file), 'utf8'))…erence/cookbook/adding-a-tool.md:35return readFile(args.path, { encoding: 'utf8', signal: exec.signal })- 读文件是绝大多数插件的正常工作方式,本身不构成顾虑。
- 动态加载模块
dynamic-import一般9 处命中…/en/reference/subsystems/goal.md:311'goal/changed'(this: import('@deepseek-ai/dsh-scope').Scoped<Agent>, payload: { agent: Agent; change: GoalChanged }): vo……ite/reference/subsystems/goal.md:311'goal/changed'(this: import('@deepseek-ai/dsh-scope').Scoped<Agent>, payload: { agent: Agent; change: GoalChanged }): vo……reference/persistence-catalog.md:340sourceEventSeq?: import('@deepseek-ai/dsh-session/types').SessionSeq…reference/persistence-catalog.md:861sessionId: import('@deepseek-ai/dsh-session/types').SessionId- 动态导入本身无害,但会让依赖关系难以静态审阅。
- 读取环境变量
reads-env一般6 处命中…lop/cordis-tutorial/05-config.md:107greeting: !!js process.env.DEMO_GREETING ?? 'Hello'…lop/cordis-tutorial/05-config.md:107greeting: !!js process.env.DEMO_GREETING ?? 'Hello'…ookbook/adding-an-llm-adapter.md:26Registration is effect-based (HMR-safe); one adapter per provider route — duplicates throw, and multi-route registration……ookbook/adding-an-llm-adapter.md:26注册基于副作用,可安全支持 HMR(热模块替换);每个提供方路由仅对应一个适配器,重复注册会抛出异常,多路由注册要么全部成功,要么全部失败。`options.provider` 用于选择适配器,`options.model` 是提供方模型 …- 环境变量里常混有密钥。看它是否把整个 env 都读走。
- 文中出现远程脚本地址
remote-url-reference一般2 处命中…develop/cordis-tutorial/index.md:41这个单文件启动器(见 [vendor/cordis/bin.js](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/cordis/bin.js))会创建根……develop/cordis-tutorial/index.md:39That one-file launcher (see [vendor/cordis/bin.js](https://github.com/deepseek-ai/deepseek-harness/blob/master/vendor/co…- 只是文本里出现了远程脚本地址,没有看到加载它的调用。多半是文档或注释;若确实可疑,搜一下这个地址在包里的其他出现位置。
逐条扫描明细
| 能力 | 标识 | 关注度 | 命中次数 |
|---|---|---|---|
| 以 shell 执行命令 | shell-exec | 高关注 | 4 |
| 写入文件 | writes-files | 需留意 | 19 |
| 发起网络请求 | network | 需留意 | 14 |
| 启动伪终端 | spawns-pty | 需留意 | 4 |
| 接触凭据或密钥 | credentials | 一般 | 795 |
| 读取文件 | reads-files | 一般 | 13 |
| 动态加载模块 | dynamic-import | 一般 | 9 |
| 读取环境变量 | reads-env | 一般 | 6 |
| 文中出现远程脚本地址 | remote-url-reference | 一般 | 2 |
这份报告的口径
扫描读的是包里的源码,全程不执行第三方代码。 本次读了 384 个文件,扫描于 2026-10-15。 命中次数只说明源码里出现过这类调用,不说明行为好坏——一个插件读写文件 500 次和 1 次 都会被记为「读取文件」。这是能力清单,不是信任评分,也不是安全结论: 没扫出来的能力可能只是写法没被规则覆盖。
依赖安全公告
已查询这个插件声明的全部依赖,没有匹配到已公开的安全公告。(含 DSH 框架包在内的 @deepseek-ai/* 不作查询——那是运行时自己的问题,不是插件的。)