GitHub 热门项目推荐：dsh-superagent-prototype（TypeScript｜7380 Star）

这个项目有什么用

dsh-superagent 是一个面向单个 GitHub 仓库的主动式编码 agent，以 bundle 形式打包给 DeepSeek Harness 使用。它监听 GitHub 事件，也可以选择监听 Feishu；当被允许的人向它派活时，它会创建一个工作项，在自己的 agent 会话和目录中处理，并回到原对话中给出答复，例如提交一个 pull request。

它要解决的问题是：让 agent 以尽可能少的人类注意力，产出尽可能多的价值。一个能替整个团队行动的 agent，同样可能消耗整个团队的注意力，因此它的设计约束是——只在被要求、或团队写下的规则允许时才行动；只在有人必须行动、或结果能被使用时才发言。项目中的 docs/000-philosophy.md 专门解释了这一原则以及对运维者的要求。

典型使用场景

• 团队希望把 GitHub 仓库上的部分开发任务交给 agent 自主推进，并自动以 PR 形式交付结果。
• 需要一个人工看板统一查看「哪些事情需要人处理」，而不是在多个对话里来回确认。
• 已经在使用 DeepSeek Harness，希望以 bundle 方式接入一个可监听的编码 agent。

适合愿意为 agent 编写授权规则、并接受「少打扰」协作方式的开发者或小团队。

核心特性

• 主动监听与响应：监听 GitHub，可选监听 Feishu，在被允许的人请求工作时启动任务。
• 独立会话与独立目录：每个工作项在自己的 agent 会话和目录中处理，任务之间互不干扰。
• 回到原对话答复：处理完成后在原始对话中回复，例如直接给出 pull request。
• Web 面板：展示哪些事项需要人来处理，减少人工巡检成本。
• 授权驱动行动：只在被要求或团队规则允许时行动，避免 agent 过度打扰。
• 引导式安装：安装步骤较多，由 agent 陪同完成，一次只问一个简短问题，先展示完整计划再安装配置。

怎么安装

README 说明安装步骤较多，因此由 agent 与你一起完成，具体流程记录在 SETUP.md 中。README 未给出语言版本、系统依赖等前提条件，官方文档未说明的部分请以 docs/006-deployment.md 中的手动部署章节为准。

1. 向你的编码 agent 提出安装请求，由它按 SETUP.md 引导你完成配置。README 在此处未给出具体命令，官方文档未说明具体提示词。
2. 按 agent 的提问逐个回答，它会一次只问一个简短问题。
3. 确认它展示的完整计划，随后由它安装并配置全部内容。
4. 如需手动安装、配置、升级或排查问题，参考 docs/006-deployment.md。

如果你要参与开发，README 给出的检查命令是：

pnpm check

该命令会运行类型检查、测试和构建。

怎么使用

最基础的用法是：在安装配置完成后，由被允许的人在 GitHub（或可选的 Feishu）对话中向 agent 请求工作。agent 会创建 work item，在自己的会话与目录中处理，然后回到原对话答复，例如提交 pull request。README 未提供具体的调用命令或 API 示例，官方文档未说明。

进阶用法与配置项可参考以下文档：

• 授权规则：docs/002-authorization.md，决定 agent 在什么条件下可以行动。
• 执行机制：docs/003-execution.md，说明工作项如何被执行。
• Web 面板：docs/005-panel.md，了解如何查看需要人处理的事项。
• 新增数据源：docs/008-cookbook.md 介绍了如何添加一个 Source。

阅读文档时建议按编号顺序进行，每篇只建立在前面文档的基础之上。

适用场景与注意事项

适合的场景：单个 GitHub 仓库需要长期有人（或 agent）响应开发请求；团队希望用授权规则约束 agent 的行为边界；希望用看板集中管理「需要人介入」的事项。

不适合的场景：需要同时管理多个仓库；不希望引入 DeepSeek Harness；无法接受为 agent 编写规则与授权配置的团队。

注意事项：

• 项目以 bundle 形式提供给 DeepSeek Harness，使用前需要具备该运行环境。
• 需要接入 GitHub，Feishu 为可选项；这意味着需要相应的账号与权限配置。
• agent 的行动受授权规则约束，规则写得不清楚会直接影响它的行为范围。
• 项目采用 MIT 协议，可自由使用与修改。
• 安装步骤较多，官方建议由 agent 陪同完成，而不是手工逐步操作。

项目地址

仓库地址：https://github.com/deepseek-ai/dsh-superagent-prototype

作者/组织：deepseek-ai

dsh-superagent-prototype 用一套「少打扰、多产出」的授权模型，把编码 agent 接入单个 GitHub 仓库的日常协作流程，配套文档按编号组织，适合愿意先读文档再落地的团队评估。