前言¶
在 DeepSeek Harness（DSH）里做「监听 GitHub、按策略接单、在独立 Session 里改代码并回链」这类主动代理，若再单独起进程、单独配置或手写 token URL，往往会和日常用的 desktop 配置脱节。dsh-superagent-desktop 把上游 MIT 研究原型 dsh-superagent 打成可装进已有 Harness profile 的桌面 bundle：不另起宿主、不拆 profile，装好后在侧栏用面板完成机器配置即可。下文说明它是什么、能做什么，以及安装与使用要注意的事项。
这是什么¶
dsh-superagent-desktop 是面向 一个 GitHub 仓库 的主动编码代理插件包。它在被授权的人提出工作时打开工单，在独立的 agent Session 与工作目录中执行任务，并在原对话中给出结果（例如 Pull Request）。可选监听飞书（Feishu）；侧栏面板会标出需要人工处理的事项。
设计原则沿用上游：尽量少占用人注意力，尽量多产出可用结果——仅在被人请求或团队编写的规则允许时行动，且仅在需要人操作或可用结果就绪时发言。详见上游文档 docs/000-philosophy.md。
- 维护：desktop bundle 由社区维护者 jinghuaihuaxiang-star 维护；代码 fork 自 DeepSeek Harness 团队的
dsh-superagent研究原型，不是 DeepSeek 官方产品，应按研究代码对待。 - 分类：客户端（Harness 侧栏注入面板与配置视图）。
- 许可证：MIT（当前包版本 0.1.3，以仓库
package.json为准）。
核心功能¶
以下能力均来自仓库 README 与包描述，安装前请以 GitHub 最新文档为准。
- 宿主插件
dsh-superagent：Sources、Tickets、授权、executor Sessions，以及 GitHub 与可选的 Feishu 监听。 - 管理面板：侧栏锤子图标、全页面面板、插件管理器中的配置视图。
- 两套 agent 预设：
worker与router，供 Session 使用。 - bundled 文档与引导：
docs/中的上游文档，以及首次配置的SETUP.md。
运行依赖概括如下：
- DeepSeek Harness：
^0.2.1-alpha.2 || ^0.2.2-rc.1（README 写明在 Windows 11 上以 desktop0.2.2-rc.1开发与测试；更早原型文档偏向 macOS/Linux）。 git2.32 及以上，gh（GitHub CLI）用于 GitHub Source。- 可授予 token 或 App 权限的一个 GitHub 仓库；飞书为可选项，需
lark-cli。
安装与启用¶
在 Harness 界面安装¶
- 打开 Settings → Plugins → Add bundle。
- 输入包名
dsh-superagent-desktop，启用后 重启应用。
在 CLI 安装（desktop profile）¶
在需要运行该 agent 的 profile 下执行：
dsh plugin --profile desktop add dsh-superagent-desktop
随后在该 profile 的 package.json 中把 "dsh-superagent-desktop" 加入 dsh.profile.bundles，再重启宿主。
若使用本地 checkout 而非 registry 版本，可用绝对路径 link（README 示例路径名为 dsh-superagent，请改为你本机 checkout 路径）：
dsh plugin --profile desktop add "link:/absolute/path/to/dsh-superagent"
经过上面的步骤，重启后侧栏会出现 锤子图标。打开面板，完成 Machine configuration（仓库、agent 账号、若使用飞书则一并配置）。
状态目录与多实例¶
机器状态默认位于 <DSH_HOME>/state/superagent（DSH_HOME 默认为 ~/.dsh），新装一般无需改配置。宿主运行时该目录会被锁定：两个宿主进程不能共用同一状态目录。
若要为当前 profile 单独指定目录，可在 profile 的 cordis.patch.yml 中覆盖：
- id: dsh-superagent
config:
stateDir: /absolute/path/to/state/superagent
在客户端配置表单可用时，也可在面板的机器配置里编辑 stateDir。
典型用法与后续配置¶
- 按
SETUP.md走一遍首次配置（可由 agent 引导）。 - 部署与运维细节沿用上游文档，从 docs/006-deployment.md 开始；其中命令里的 profile 名应换成你实际安装所在的 profile（本文为
desktop），且stateDir在 desktop bundle 中已为可选项。 - 升级：更新包（或对 checkout 执行
git pull && pnpm install && pnpm build）后重启宿主。
代理在用户授权的 GitHub（及可选飞书）对话中响应；执行权限与 DSH 宿主、所配置仓库 token/App 一致，安装前请阅读源码与 MIT 许可证，确认策略与授权范围符合团队要求。
适用场景与注意¶
更适合：已在 DSH desktop（或对应 profile）日常开发、希望 单仓库 上自动化「听事件 → 建 Ticket → Session 内改代码 → PR/回链」，且愿意按上游 Policy 与团队规则约束 agent 行为的团队。
使用前建议确认：
- 插件以 当前 DSH 进程权限 运行，可访问你配置的 GitHub（及飞书）凭证与仓库；勿在未审计代码的情况下在生产敏感仓上启用。
- 非官方 DeepSeek 发行物；行为与升级路径以 jinghuaihuaxiang-star/dsh-superagent-desktop 仓库为准。
- Windows 上上游测试套件可能因 POSIX 工具假设而失败；README 指出
pnpm build与 typecheck 与平台无关，实际以运行中的面板与宿主 API 为准。
DSH 生态强调「一切皆插件」；社区目录 SkillHub 插件页 为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
dsh-superagent-desktop 把研究型 superagent 收成装进现有 Harness profile 的客户端 bundle，省去第二进程与重复 profile，用侧栏面板完成仓库与账号配置即可监听 GitHub（可选飞书）并在独立 Session 中交付工单结果。
