前言¶
在 DeepSeek Harness（DSH）里做智能体相关开发，往往需要把「工单、执行、策略」放在本机可控的环境里，而不是完全依赖在线演示或重量级自建服务。社区里已有 dsh-superagent-prototype 等原型概念；若你希望在自己的 DSH 桌面端里挂一个个人向入口，并沿原型思路逐步落地领域逻辑，可以关注维护者 kulebbb 发布的 dsh-superagent。需要说明：这不是 DeepSeek 官方插件，当前以 GitHub 安装为主，npm 包 @kulebbb/dsh-superagent 尚未发布。
这是什么¶
dsh-superagent 是个人版 superagent：参考 dsh-superagent-prototype 的概念，为 DSH 桌面端制作的插件，目标用户是个人开发者，在自己的电脑上使用。
- 维护者：kulebbb
- 目录页：https://www.skillhub.cn/plugins/kulebbb/dsh-superagent
- 源码：https://github.com/kulebbb/dsh-superagent
- 许可证：MIT（版权人 Liang；部分代码取自原型，见仓库内 THIRD_PARTY_NOTICES.md）
当前能力与进度¶
安装并启用后，在 阶段 0（骨架） 下，你应能在侧边栏看到 Superagent 入口，面板显示「插件骨架已加载」。该阶段已在 DSH 桌面端 0.2.1-rc.5 上验收。
阶段 1（领域核心） 在仓库中已完成代码与测试，包括：从原型搬入的领域核心、基于 node:sqlite 的 Store、Effects 持久队列，以及简化为「只有我」的个人版 Policy。README 写明：这些内容尚未接到插件入口上，接线计划在阶段 2。因此，现阶段不要把本插件当成「已可完整下单与执行」的生产能力，而是可安装的骨架与可本地验证的核心模块。
后续阶段（来自 README 路线图，尚未全部落地）包括：下单与执行（本地来源、每工单一个执行器 Session 与 git worktree）、面板与通知、GitHub 来源（gh 监听）、主动工作等。
核心模块概览¶
| 路径 | 内容 |
|---|---|
src/index.ts |
服务端 cordis 插件入口 |
src/core/ |
领域核心（取自原型）：Engine、模型、工单阶段、理由码，无 I/O |
src/policy.ts |
个人版设置与准入：只有我、规则、accept 模式（off / observe / auto） |
src/app/store.ts |
SQLite 存储，实现领域仓储、设置版本与发件箱回执 |
src/app/effects.ts |
持久副作用队列：事务内入队、提交后执行、失败指数退避 |
src/client/ |
客户端插件：侧边栏图标、主面板、中英文案 |
cordis.patch.yml |
bundle 层，把插件插入 profile |
个人版准入规则（src/policy.ts）大意如下：你向智能体发起的明确请求、或在已有工单线程上的追问会生效；他人直接 @ 智能体不接；推断类候选在 off 下不接，默认 observe 只记录「本来会接单」，只有 auto 且命中已启用规则时才会开工。
环境要求¶
- DSH：^0.2.1-rc.5（
package.json中engines.dsh锁定在该版本线） - Node.js：22.19+ 或 24+
- 包管理：pnpm 11
桌面端请使用 DSH Desktop 自带的 dsh；README 指出 npm 上的 @deepseek-ai/dsh 不能管理名为 desktop 的 profile。
安装与启用¶
仓库已提交构建产物 lib/。从 Git 安装不会执行 build，也不需要在 profile 的 pnpm-workspace.yaml 里为该包打开 allowBuilds。
桌面端安装命令（来自 README 原文）：
dsh plugin --profile desktop add github:kulebbb/dsh-superagent
若希望钉住某次提交，避免后续推送替换已安装代码，将 <commit> 换成完整 40 位 SHA：
dsh plugin --profile desktop add github:kulebbb/dsh-superagent#<commit>
说明：Git 安装地址是 github:kulebbb/dsh-superagent，不是 npm 包名。若装到命令行 Web profile，把命令中的 desktop 换成 web。安装后启用对应 bundle；若提示 restart-required，需完全退出并重启 DSH，再在侧边栏点开 Superagent 确认骨架文案。
npm 注意：包名是 @kulebbb/dsh-superagent；无作用域的 dsh-superagent 因与已有包 dsh-super-agent 过于相似被拒绝发布。README 明确不要安装他人发布的 dsh-superagent-desktop。包发布到 npm 之后，可用：
dsh plugin --profile desktop add @kulebbb/dsh-superagent
本地开发与目录安装¶
贡献或二次开发时，在仓库根目录执行：
pnpm install
pnpm check # 类型检查 + 构建 + 测试，产物在 lib/
修改 src/ 后需重新 pnpm build，并把新的 lib/ 一并提交；用户通过 Git 安装依赖的是仓库里的 lib/，不会在用户机器上编译。
本机绝对路径安装（开发时）：
dsh plugin --profile desktop add /absolute/path/to/dsh-superagent
开发安装后若提示 restart-required，同样需要重启 DSH。
适用场景与注意¶
适合谁：已在用 DSH 桌面端（0.2.1-rc.5 线）、想了解 superagent 原型如何在个人环境以插件形态落地，并愿意接受当前仅为骨架 + 未接线领域核心的开发者。
权限与安全：插件以当前 DSH 进程权限运行。安装前请阅读源码与 MIT 许可证，自行评估 Policy、存储与后续将接入的执行能力是否符合你的本机安全策略。
生态说明：DSH 生态强调「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系，本文介绍的插件亦不属于官方应用商店条目。
结尾¶
dsh-superagent 把个人版 superagent 的工程骨架与阶段 1 领域核心带到 DSH 桌面端：现在能验证安装、侧边栏入口与骨架面板；完整下单、执行与 GitHub 来源等能力按 README 阶段表陆续推进。进一步了解可从目录页 https://www.skillhub.cn/plugins/kulebbb/dsh-superagent 进入，或直接查看仓库 https://github.com/kulebbb/dsh-superagent。
