前言¶

在 DSH 里接 GitHub、飞书等来源的开发请求时，常见做法是单 Session 堆叠所有任务：上下文混在一起，Skill 和模型不好按工单隔离，长任务也容易拖垮主对话。若希望「主 Session 只做路由、每个工单在独立目录和 Worker 里跑完再回贴结果」，需要把调度、授权和执行拆开。下面介绍社区插件 uuicdown/dsh-project-agent（仓库 README 仍以 dsh-superagent 称呼同一套实现），它在 DSH 上以 Host 运行时承载，把项目工作派发到带 per-ticket Skill 的持久 Worker Session。

这是什么¶

dsh-project-agent 由 uuicdown 维护，在 SkillHub 分类为「工作流」。package.json 中的描述是：面向 DSH 的项目工作区智能体，路由主 Session 将 Ticket 分派到持久 Worker Session，并为每个 Ticket 配置独立 Skill。

同一仓库的 README 说明：这是针对单个 GitHub 仓库的主动式编码智能体，打包为 DeepSeek Harness 插件；可监听 GitHub，并可选监听飞书。经授权的人发起工作后，智能体开启工作项，在独立的 agent Session 与目录中执行，并在原对话中回复（例如提交 Pull Request）。Web 面板用于标出仍需人工处理的事项。README 明确写明：仅供参考的研究原型，不是 DeepSeek 官方产品，工程上可能存在缺陷，使用前需自行审阅与改造。

核心功能¶

工单调度与 Worker Session¶

与「一切堆在主 Session」相比，插件强调路由层与执行层分离：主 Session 负责派发 Ticket，Worker Session 持久存在，按工单携带各自的 Skill（及简介中提到的 per-ticket 模型配置）。这与 package.json 对插件能力的表述一致。

多来源监听与闭环回复¶

在 GitHub 上（以及可选的飞书）接收请求后，智能体在允许执行的条件下开工，在独立工作区完成修改，并把结果回到触发对话——README 以 Pull Request 为例。设计上要求：仅在有人提出请求，或团队编写的规则允许时行动；仅在需要人处理或可提供结果时发言，以减少对整个团队的注意力占用。理念细节见仓库文档 docs/000-philosophy.md。

Web 面板与 Cordis 集成¶

package.json 中 dsh.runtime 为 host，通过 cordis.patch.yml 做 bundle 补丁；客户端为 Web 平台，并注入 locale、settings、renderer、layout、sidebar、workspace 等 DSH 客户端模块。面板相关行为见 docs/005-panel.md。

文档与领域模型¶

仓库提供按序号阅读的文档：000 哲学、001 领域模型、002 授权、003 执行、004 提示词、005 面板、006 部署与排错、007 架构、008 Cookbook（例如新增 Source）。后文步骤会依赖 006 中的手工配置说明。

安装与启用¶

SkillHub 目录页的指引是：在 DeepSeek Harness 中安装插件 uuicdown/dsh-project-agent（页面表述为「请安装 DSH 插件 uuicdown/dsh-project-agent」）。社区目录 SkillHub 是独立站点，与 DeepSeek / 幻方无官方从属关系；安装前请打开 GitHub 仓库 阅读源码与 MIT 许可证。

README 写明初始化步骤较多，建议让编码智能体按 SETUP.md 协助完成。可向 DSH 中的智能体发送：

Read SETUP.md in this repository and set up dsh-superagent with me.

按 README 说明，智能体会逐项短问、展示完整计划后安装并配置。手工路径见 docs/006-deployment.md。

环境与版本（来自 package.json，使用前以仓库当前文件为准）：

• Node：^22.19.0 || >=24.0.0
• DSH：^0.2.1-alpha.2
• 插件包版本：0.1.21
• 包管理：pnpm@11.7.0（开发侧 pnpm check 会执行 typecheck、测试与 build）

注意： 插件在当前 DSH 进程权限下运行。安装与启用前请核对仓库声明的研究原型性质，并评估 GitHub / 飞书等凭据与授权规则（docs/002-authorization.md）。

典型用法¶

用 SETUP 向导完成首次部署¶

1、在 Harness 中安装 uuicdown/dsh-project-agent。
2、让智能体读取仓库根目录 SETUP.md 并按上文引用的提示与您协作配置。
3、配置完成后，按 docs/006-deployment.md 检查监听源、授权与升级方式。

按文档理解运行行为¶

需要调整「何时自动行动、对谁回复」时，先读 docs/000-philosophy.md 与 docs/002-authorization.md，再读 docs/003-execution.md。需要改提示词或面板时，分别参考 004 与 005。若要扩展新的消息来源，参考 008 Cookbook。

本地开发自检¶

若在仓库内改插件代码，可在克隆后的开发环境中执行（README）：

pnpm check

该命令依次运行类型检查、测试与构建。

适用场景与注意¶

适合： 已在 DSH 上维护单个 GitHub 仓库、希望通过 Ticket + 持久 Worker 隔离任务，并可能对接飞书与 Web 面板的团队或个体维护者；愿意按编号文档自行部署、授权与排错。

不适合或未承诺： 需要「开箱即产线」官方支持的场景——README 反复说明这是研究原型，与论文 Exploring Super-agent Design 中的部分设计并不完全一致，部分能力仅为未来方向。

再次强调：插件不以独立系统用户运行，而是依附 DSH Host；错误配置可能导致在仓库上的过度自动化或越权回复。务必在启用 GitHub / 飞书监听前完成授权审阅，并保留人工在面板中介入的路径。

结尾¶

dsh-project-agent 把 DSH 上的项目协作收成「主 Session 路由 Ticket → 持久 Worker 按工单 Skill 执行 → 回原对话交付结果」的工作流，并配合文档化的授权与部署体系。若要查看简介与安装入口，见 SkillHub 目录页；若要阅读完整 README、SETUP 与 docs/，见 GitHub：uuicdown/dsh-project-agent。