# 与传统工具的不同

用编码 Agent 交付的团队，通常要运行一个工单系统、一个代码托管平台、一个 CI 服务、一个制品仓库、一个测试管理工具和一个 Wiki，再给 Agent 为每个工具各配一个令牌和一套 API。Acahti 是为人和 Agent 共同打造的一个工作区，并由追踪把所有记录串起来。

| | 常见组合 | Acahti |
|---|---|---|
| 谁在干活 | 人在各个工具的界面里操作；Agent 通过各自独立的 API 和令牌 | 人和 Agent 使用同一套操作目录：Web、MCP、REST 和 CLI |
| 身份 | 每个工具一个账号、一个令牌 | Git、MCP、API、npm 和 PyPI 共用一个账号和令牌 |
| 工作进展 | 靠人手动更新状态字段 | [追踪](mainline.md)从 PR、流水线、Argos 运行和交付中读出 |
| 合并 | 检查可以被管理员绕过 | `pr_merge` 要求 head 上最新的流水线通过 |
| 规划 | 另一个工具；报告靠人拼凑 | 迭代带范围基线，容量和燃起图一次读出，由 Aidy 写成汇报 |
| 测试 | 用例在测试工具里，结果在 CI 日志里 | Argos：用例在源码里，运行关联到工作，失败用例作为流程跟踪 |
| 知识 | Wiki 与工作分离 | 文档和文件就在工作旁边，关联进流程，Aidy 可以检索 |
| 助手 | 只会回答的聊天面板 | Aidy 引用来源作答，你确认后执行改动 |
| 部署 | SaaS，或者要运维好几套系统 | 一条命令安装的单个自托管实例 |

## 核心特性

### 一个身份

同一个账号和令牌可以登录 Web 应用、MCP、REST API、基于 HTTPS 的 Git、npm 和 PyPI。提交带着实例分配给 Agent 的身份，流水线以 head 提交的作者身份运行，所以发布制品不需要保存令牌。参见[身份与 SSO](sso.md)。

### 有检查的合并

只有 PR head 上最新的流水线通过时，`pr_merge` 才会成功，对人和 Agent 一视同仁。需要放行的部署等待人来批准。参见[安全](security.md#merge-gate)。

### 用证据代替状态

在分支、PR 或提交里写上待办或工单编号，Acahti 就会把它们关联起来。追踪随后显示每条流程的阶段、由谁推动、卡了多久，无需任何人手动更新。参见[追踪是主线](mainline.md)。

### 共享的规划

项目承载人、Agent、仓库和工作。迭代从范围基线开始，记录每一次变更，度量容量和燃起图，关闭时对每个未完成的待办逐一交代去向。一次 `planning_brief` 读取，人、Agent 和 Aidy 看到的是同一组数字。参见[项目](projects.md)和[产品迭代](iterations.md)。

### 测试在闭环内

Argos 把测试用例放在源码里，共享测试计划，保存每次运行的证据。流水线把运行结果回传到实例，失败的用例成为流程，从运行发起的工单会带上这次运行。参见 [Argos](testing.md)。

### 知识就在工作旁边

文档、上传的文件和原型都在同一个工作区里，有修订历史、分享和搜索，并能关联到所属的流程。参见[知识库](knowledge.md)。

### Aidy，应用内的 Agent

Aidy 搜索并阅读项目、待办、工单、迭代和知识库，引用来源作答，撰写进展汇报和迭代收尾，并执行你确认过的改动。参见 [Aidy 与全局搜索](aidy.md)。

### 你的基础设施，开源

一个公开网关挡在 Forgejo 和 Woodpecker 之前，二者保持私有；流水线在独立的执行节点上运行。Apache-2.0 许可，Git 数据保存在标准的代码托管里，随时可以导出。参见[工作原理](how-it-works.md)和[与代码托管平台对比](compare.md)。