canhta/dsh-autopilot

Autopilot — 使用 DeepSeek Harness 将已批准的工作转化为可审查的拉取请求。

Autopilot

License: MIT
npm: alpha
CI
Status: alpha
Built for DeepSeek Harness

Autopilot 将已批准的跟踪器工作转化为有边界的代理运行和可审查的拉取请求，这一切都在 DeepSeek Harness (DSH) 内完成。

它解决什么问题

运行一个编码代理很容易。持续运营一个则更难：仍然需要有人来决定哪个工单已就绪、跟踪上报的 token 使用量、限制并发、恢复中断的工作、发布经过确切验证的提交，并告知团队发生了什么。

Autopilot 为 DSH 添加了这一运营层。它将批准、审查和合并保留给人类，同时自动化已批准工单与拉取请求之间的工作。

它不替代 DSH 或供应商集成。DSH 拥有代理运行时、Sessions、凭据和 Web shell。跟踪器和代码托管访问复用官方 MCP 服务器及其现有身份验证；Autopilot 仅添加将它们连接在一起的调度、生命周期和发布行为。

它的功能

- 仅接纳带有配置的就绪标记和当前人类授权的工单。
- 在调度和并发限制下排队工作，并根据提供商上报的 token 使用量预留配置的额度。
- 通过 DSH 在受管理的 Git 工作树中运行仓库自身的指令。
- 暂停、恢复和取消，而不丢弃持久化的运行历史。
- 在重启后恢复中断的发布、通知和保留的工作树。
- 在创建拉取请求之前重新验证确切的 Git 状态。
- 在 DSH Web 中显示队列、运行详情、工作树、交付状态和设置。
- 在创建拉取请求时停止；人类仍然拥有审查、CI 决策和合并。

贡献者测试套件使用受控的提供商验证当前 alpha 版本。生产提供商的晋升仍受提供商一致性的约束。Jira、GitHub Issues 和 GitHub 代码托管是首批适配器；Linear、Bitbucket 及后续提供商使用相同的提供商契约和 MCP 优先的身份验证策略。
alpha 预算字段预留容量，并在请求后核对提供商报告的使用量。它们并非精确的累计请求前硬性上限；在 DSH 预算边界 完成之前，请对按量计费的生产环境保持原生执行禁用。

工作原理

flowchart LR
ticket["已批准的工单"] --> gate["就绪标记 + 授权"]
gate --> queue["调度 + 容量 + 预算"]
queue --> dsh["托管工作树中的 DSH 代理"]
dsh --> verify["检查 + 精确 Git 状态"]
verify --> pr["可供审查的拉取请求"]
pr -.-> notify["通知"]

如果代理需要做出决策，Autopilot 会将阻塞项回传到跟踪器，并等待明确回复。暂停的运行会保留其 Session 和工作树，以便进行受检的恢复。已取消的排队中或静止的运行会干净地停止，同时保留理解所发生情况所需的证据。

提供商故障与持久化的运行结果相互隔离。例如，通知中断不会撤销已完成的拉取请求，而重启可以重试不确定的发布，而不会创建重复项。

安装

需要已安装 DSH。

dsh plugin --profile web add @canhta/dsh-autopilot@alpha
dsh --profile web

打开 DSH 打印的 URL，然后在侧边栏中选择 Autopilot。

尚未安装 DSH？

使用 npm 安装其 CLI，然后运行一次 DSH Web 以完成常规的 DSH 设置：

npm install --global @deepseek-ai/dsh
dsh web

有关其自身的安装和安全指南，请参阅 DSH 仓库。Autopilot 不管理或升级此安装。

配置

打开 Settings → Autopilot 以设置跟踪器和代码托管绑定、调度、并发、预算、通知和保留策略。在该提供商关联的 Settings 部分中配置就绪标记和提供商特定的资源映射。

全新安装会保持执行禁用。在启用之前，请选择 DSH 默认 Agent 预设和模型，然后在同一配置文件中配置每个提供商的 DSH Settings 命名空间和官方 MCP 服务器。将供应商 OAuth、模型密钥和令牌保留在 DSH Credentials 中；Autopilot 不会创建第二套身份验证流程。

连接 GitHub 和 Jira MCP 服务器

Autopilot 的提供商通过 DSH 的 dsh-mcp-client 插件调用供应商的官方 MCP 服务器，而非第三方克隆。为每个服务器向配置文件的补丁层（$DSH_HOME/profiles//cordis.patch.yml）添加一个条目，然后重启配置文件（dsh --profile web）。

GitHub — 官方远程服务器无需本地安装或 Docker：

- insert:
- id: mcp-github
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: github
transport: streamable-http
url: https://api.githubcopilot.com/mcp/
headers:
Authorization: !!js 'Bearer ${process.env.GITHUB_TOKEN}'

在 github.com/settings/personal-access-tokens/new 创建一个具有 Contents、Issues 和 Pull requests 读写权限的令牌，然后在启动 DSH 之前在你的环境中设置 GITHUB_TOKEN。

Jira — Jira 提供商的 MCP 契约针对的是 Atlassian 官方的 Rovo MCP Server，而不是社区版 Jira MCP 服务器。serverName 必须为 atlassian（该提供商的默认值）：

- insert:
- id: mcp-jira
name: '@deepseek-ai/dsh-mcp-client'
config:
serverName: atlassian
transport: streamable-http
tools=all: Rovo only advertises a "primary" tool subset by default and expects
on-demand discovery, which dsh-mcp-client's one-time tools/list bridge doesn't do.
url: https://mcp.atlassian.com/v2/mcp?tools=all
headers:
Authorization: !!js >-
Basic ${Buffer.from(${process.env.JIRA_EMAIL}:${process.env.JIRA_API_TOKEN}).toString('base64')}

在 id.atlassian.com/manage-profile/security/api-tokens 创建一个 API 令牌，然后设置 JIRA_EMAIL（你的 Atlassian 登录名）和 JIRA_API_TOKEN。组织管理员还必须为 Rovo MCP Server 启用 API 令牌身份验证（Atlassian Administration → Rovo → Rovo MCP server → Authentication）——仅支持 OAuth 的组织无法使用这种 Basic 认证头形式，需要采用不同的客户端集成方式。

连接成功后，Autopilot 中每个提供商的 Settings 卡片会报告实时的 lookup 状态，而不是占位符——这是针对该提供商所声明的 MCP 工具进行的真实、带缓存的探测，而非静态消息。

关于由 systemd 管理的 VPS 安装以及备份/恢复流程，请参阅 单 VPS 运维。

贡献

请先创建一个 GitHub issue，以便明确问题和验收标准。然后在提交聚焦的 pull request 之前运行仓库检查：

git clone https://github.com/canhta/dsh-autopilot.git
cd dsh-autopilot
pnpm install
pnpm run check

完整的贡献流程、验证预期和包检查详见 贡献指南。