dsh-superagent-prototype

1. 项目概览

dsh-superagent-prototype 是一个开源的 TypeScript 编码智能体原型，它把针对单个 GitHub 仓库的经授权请求转化为受跟踪的工作，在专用的 DeepSeek Harness 会话和目录中执行每个任务，并将结果返回原始对话。仓库 README

2. 背景与定位

该项目源于 DeepSeek Harness 团队的日常开发工作。其使命是在尽量减少队友所需投入注意力的同时，交付有用的工程成果。工作通过明确的请求或书面的团队规则启动，沟通聚焦于可操作的问题和可用的结果。设计理念

其显著重点是持久的团队工作流：请求、授权、执行、跟进和交付都围绕一个仓库统一建模。这使它对于探索交互式编码会话之外的仓库智能体的开发者具有相关性，不过该项目并未发布对比性能基准。领域模型

维护者明确将其描述为研究代码，而非官方 DeepSeek 产品或可投入生产的服务。公开原型与内部实现及配套研究文章有所不同；该文章中讨论的一些想法仍是未来方向。项目状态

3. 功能类别

以下计数描述的是每个类别中列出的具体功能或资源，而非官方总能力数量。

协作与事件接入

🔌 仓库与聊天输入 — 4 项代表性功能

• 针对所配置仓库的 GitHub 通知接入。
• 可选的飞书/Lark 机器人集成。
• 线程订阅，将后续上下文传递给现有工作。
• 基于频道的回复，发送到与请求关联的对话。

目的：将团队对话连接到可执行的工作，同时保留继续该工作所需的上下文。领域模型

授权与主动工作

🛡️ 策略控制 — 5 项代表性功能

• 每个来源的允许发送者列表。
• 基于范围、发送者成员资格以及智能体是否被提及的准入表。
• 针对推断出的主动请求的书面规则。
• 三种接受模式：关闭、观察和自动。
• 工单授权，记录接受工作所依据的权限。

目的：区分启动工作的许可与仅提供上下文的消息。授权指南

任务执行

⚙️ 执行生命周期 — 4 项代表性功能

• 每个工单都有专用的执行器会话。
• 可配置的任务目录准备命令，包括 Git 工作树。
• 工作线程并发与模型配置。
• 中断任务的恢复与重试处理。

目的：使工作项在执行轮次和重启之间保持独立可追踪和可管理。执行指南

人工监督

📊 操作面板 — 6 个标签页，含 5 个代表性示例

• 概览突出显示需要人工关注的工作。
• 来源显示集成健康状况和交付问题。
• 触发器呈现线程、传入事件和订阅。
• 评估记录决策、原因和匹配的规则。
• 执行暴露工单状态、工作线程活动和干预控制。

目的：使待决决策和工作流历史可见；第六个标签页“设置”用于配置来源、评估、执行、提示词和部署。面板指南

定制与扩展

🧩 扩展资源 — 4 项代表性资源

• 可编辑的团队提示词部分。
• 内置的 GitHub 和飞书技能。
• 一个示例 DeepSeek Harness 配置档案。
• 一份用于实现额外来源插件的实操指南。

目的：让团队根据自身的仓库工作流调整指令和事件集成。提示词指南、来源实操指南

4. 关键亮点

• 先观察，再启用主动执行。 默认的观察模式会记录推断出的工作是否会被接受，但不创建该工作，从而让操作者先评估其规则。授权
• 从请求到结果的可追踪工作。 触发器、决策、工单和分配提供了一套共享词汇，用于理解智能体接受了什么以及如何推进。领域模型
• 分离的执行上下文。 每个工单都有自己的会话和工作目录；Git 工作树可以提供独立的仓库检出。这些是工作流边界，而非操作系统安全沙箱。执行、部署
• 聚焦注意力的监督。 面板优先显示受阻的工作和可操作的问题，并在需要时提供详细历史。面板
• 可扩展的事件来源。 实操指南解释了事件转换、回复投递、授权集成和来源生命周期行为。实操指南

5. 按角色的使用场景

以下是所记录工作流的潜在应用，而非对专门内置功能的声明。

角色	实际用途
普通开发者	从仓库对话中委派范围明确的缺陷修复或功能工作，并审查产生的更改或拉取请求。
DevOps/SRE	运维专用智能体配置档案，监控健康状况，并试验由规则授权对仓库 CI 事件的响应。
安全工程师	审查发送者权限、执行凭据和运行时隔离；通过常规仓库请求分配范围明确的修复工作。
数据/研究科学家	研究事件路由、策略评估和任务恢复，或在研究仓库中委派代码更改。
项目经理	审查等待决策的工单，澄清所请求的结果，并通过监督面板跟进工作。

底层机制记录在领域模型、面板指南和部署指南中。

6. 快速上手

路径 1：找到所需内容

从 README 开始，然后按顺序阅读九份编号文档，从设计理念一直到来源实操指南。使用架构来导航实现，使用部署了解运维细节。

路径 2：安装与集成

推荐的起点是智能体辅助的 SETUP.md。将以下指令交给你的编码智能体：

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

前提条件包括 Node.js 22.19+（22.x 系列）或 Node.js 24+、pnpm、Git 2.32+、Python 3.8+、tmux、GitHub CLI 2.48+、github.com 上的一个仓库，以及在 DeepSeek Harness 中配置的模型提供方。飞书还需要其机器人设置和 lark-cli。

对于没有现有 superagent 配置档案的全新安装，部署指南提供了以下序列，并填入仓库 URL：

npm install -g @deepseek-ai/[email protected]
git clone https://github.com/deepseek-ai/dsh-superagent-prototype.git dsh-superagent
cd dsh-superagent
pnpm install
pnpm build
dsh superagent --from-default-profile web --dump-config > /dev/null
dsh plugin --profile superagent add "link:$PWD"

创建配置档案的命令会替换现有配置档案，因此不要在升级时复用它。在开始之前，请遵循其余部署步骤：配置专用的智能体 GitHub 账户和 CLI 凭据，填写示例配置档案，并配置来源、策略、执行和团队提示词。仅靠安装命令并不能完成设置。

路径 3：贡献

在更改行为之前，请阅读架构指南。对于集成，请遵循来源扩展实操指南，包括其文档和测试要求。

在你的开发检出目录中，运行仓库的类型检查、测试和构建组合命令：

pnpm check

所审查的代码树不包含独立的 CONTRIBUTING.md。请使用所记录的开发工作流和 GitHub 的拉取请求界面提交拟议更改。

7. 项目结构

dsh-superagent-prototype/
├── README.md                  # Overview and documentation index
├── SETUP.md                   # Agent-assisted setup workflow
├── LICENSE                    # MIT license
├── docs/                      # Nine ordered design and operation documents
├── examples/
│   └── profile.cordis.patch.yml
├── prompts/                   # Agent instructions and team sections
├── skills/                    # GitHub and Feishu skills
├── locale/                    # English and Chinese interface resources
├── scripts/
│   └── dsh-superagent          # Service lifecycle helper
├── src/
│   ├── index.ts               # Bundle entry point
│   ├── core/                  # Domain engine and lifecycle rules
│   ├── app/                   # Runtime, storage, API, and orchestration
│   ├── executor/              # Harness execution adapter
│   ├── sources/               # GitHub, Feishu, and Source infrastructure
│   └── client/                # Web supervision interface
├── tests/                     # Domain, integration, and interface tests
├── cordis.patch.yml           # Bundle plugin configuration
└── package.json               # Dependencies, compatibility, and scripts

架构将领域规则与执行和集成适配器分离，而客户端提供面向操作者的面板。参见源代码树和架构指南。

8. 相关生态

• DeepSeek Harness： 提供智能体会话、工具、模型集成和 Web 界面的宿主运行时。其官方主页链接到运行时仓库和开发者文档；其通用能力不应与本原型实现的功能混淆。
• Cordis： Harness 生态和本包配置所使用的插件架构。该项目的包清单列出了其 Harness 和 Cordis 兼容性要求。
• GitHub 和 GitHub CLI： 用于智能体身份和仓库操作的仓库协作平台和命令接口。
• 飞书/Lark 和 lark-cli： 用于接收请求和返回回复的可选聊天集成。账户设置记录在部署中。
• Git 工作树和 tmux： 用于准备任务检出和管理服务进程的补充工具，如部署工作流所示。

9. 许可证

该仓库使用 MIT 许可证，版权归 DeepSeek Harness 团队所有。

• ✅ 允许商业和私人使用、修改、复制、分发、再许可和销售副本。
• ✅ 修改版本可以按你选择的条款分发，前提是保留所需的声明。
• ❌ 你不得从软件的副本或实质性部分中删除版权和许可声明。
• ℹ️ 软件不提供任何担保，许可证免除作者责任。
• ℹ️ 本原型的许可证不替代外部服务、模型提供方或依赖项的条款。

10. 常见问题

问：这是官方、可投入生产的 DeepSeek 服务吗？

答：不是。README 将其标识为供参考的研究原型。在采用之前，请审查并调整其实现。

问：主动模式是否意味着智能体会启动任意工作？

答：推断出的工作需要所配置的准入路径、评估、匹配的书面规则和自动模式。观察模式会记录潜在的接受情况而不执行；显式请求在三种模式下都可用。参见授权。

问：一个实例可以管理多个仓库或 GitHub Enterprise Server 吗？

答：所记录的范围是每个实例一个 GitHub 仓库，且部署要求使用 github.com。明确不支持 GitHub Enterprise Server。参见部署。

问：工作线程目录是安全沙箱吗？

答：不是。受管会话以操作者的操作系统用户身份拥有完全访问权限运行；凭据包装器选择账户但不隔离进程。部署指南建议在需要隔离时使用仅包含智能体凭据的专用操作系统账户。参见权限与隔离。

问：飞书是必需的吗，我可以添加另一个集成吗？

答：飞书是可选的。GitHub 是核心仓库集成，实操指南解释了如何实现另一个来源，包括其策略、上下文和投递行为。

11. 快速链接

• 项目仓库
• README 与项目状态
• 官方项目文档
• 智能体辅助设置
• 手动部署与故障排查
• 贡献指南：架构与开发工作流
• 来源扩展指南
• 拉取请求与代码审查
• DeepSeek Harness 主页与社区插件链接
• MIT 许可证

所审查的 README 中未链接独立的贡献指南或专门的项目讨论论坛；请将仓库和上游主页作为所记录的参与起点。

12. 总结

dsh-superagent-prototype 为全球开发者提供了一个具体参考，将仓库对话、显式授权、持久任务执行和人工监督结合起来。它对于研究仓库编码智能体并扩展 DeepSeek Harness 生态的团队和研究人员很有用，但需预期其研究性实现需要经过审查和调整才能投入运营使用。