# 概览

Acahti 是面向编码 Agent 的自托管交付控制平面。一个实例为团队提供 Git 托管、PR、带结构化检查结果的 CI，以及 npm 和 PyPI 仓库源，统一使用一个身份和一个 MCP 端点。Agent 运行交付闭环，人负责制定策略并进行监督。

## 产品与实例

- **产品**就在这里，即 acahti.benchyard.com：文档、Agent skill（技能）和安装指南。
- **实例**是部署在你自己基础设施上的一套服务，例如 `https://acahti.example.com`。它提供 Web 应用、位于 `/mcp` 的 MCP、位于 `/acahti/v1` 的 REST API、基于 HTTPS 的 Git，以及制品仓库源。

Agent 从产品站点安装一次 skill，然后连接到它要工作的任意实例。所有与实例相关的信息（URL、组织、Git 身份、管理和创建权限、已安装的插件）都来自该实例的 `whoami`。

## 闭环

```text
repo_get → branch_list → edit and push
                           ↓
                     checks_wait
                      ↙       ↘
           failed-step logs    green checks
                ↓                   ↓
            fix / rerun       review → pr_merge
```

Agent 负责决策和修复，Acahti 提供经过认证的操作和结果。只有当 PR head 上最新的流水线通过时，`pr_merge` 才会成功。流水线通过表示已配置的检查全部通过，并不代表软件没有缺陷。

## 分工

| Agent | 人 |
|---|---|
| 使用个人访问令牌（MCP）或访问令牌（CLI）连接 | 邀请成员，设置分支保护 |
| 推送、等待检查、读取失败日志、重跑 | 管理流水线密钥和仓库访问权限 |
| 创建并合并 PR，发布制品 | 关注看板和收件箱 |
| 报告受阻的运行 | 审批需要放行的部署（`deploy_approve`） |

Aidy 在 Acahti 内使用管理员配置的模型，回答时附带引用来源，并执行你确认过的操作。外部编码 Agent 通过同一套经过认证的 MCP 目录接入。Claude Code、Codex、Cursor 或任意 MCP 客户端都可以使用。

## Web 应用

页头左侧是组织和「仪表盘 | 智能体」切换，中间是各个板块（看板、仓库、流水线、制品、工单、项目、知识库、Argos、已安装的插件和追踪），右侧是搜索、侧边栏、通知和账户菜单。账户菜单包含你的显示名称和邮箱、访问令牌、管理后台（管理员可见）、语言、主题、本文档以及退出登录。可以用侧栏的折叠控件或 `Ctrl/Cmd+B` 把侧栏收起为一列窄的首字母图标。「仓库」列出每个仓库的语言、星标、复刻、未关闭的 PR、最近提交、最新流水线和主题，可按团队、类型和语言筛选，按最近更新、名称或星标排序；组织管理员可以归档仓库，使其只读并对成员隐藏（`repo_archive`）。侧边栏承载 Aidy 和你的聊天；智能体模式会把它变成主界面。参见 [Aidy 与全局搜索](/docs/aidy/) 和 [追踪](/docs/track/)。

## 内部原理

一个实例由一个 Go 网关和其后的两个成熟内核组成：[Forgejo](https://forgejo.org) 负责 Git、PR 和制品，[Woodpecker](https://woodpecker-ci.org) 负责 CI。内核保持私有，网关是唯一对外暴露的入口。流水线在独立的执行节点主机上运行。参见[工作原理](/docs/how-it-works/)。

## 下一步

- [安装实例](/docs/install/)
- [接入 Agent](/docs/agents/)
- [运行演示闭环](/demo.md)

## 规划、构建、验证与复盘

规划由人和 Agent 共同完成。系统通过一次读取 `planning_brief` 给出各项度量（相对基线的范围、逾期和延期的工作、容量、燃起图）；Aidy 据此写出进展汇报，提议如何关闭迭代，起草交付的变更日志，并根据你的活动填写当天工时。它提出的每项变更都需要你确认。

- [项目](/docs/projects/)：人、Agent、仓库和工作集中在一个有序列表中，每项都有风险、负载和近期交付的总览。
- [产品迭代](/docs/iterations/)：开始工作时建立范围基线，记录计划外变更、容量和燃起图，关闭时对每个未完成待办逐一交代去向，交付会列明其包含的待办。
- [追踪](/docs/track/)：从上报到发布，全程跟踪工单、待办、迭代或交付。
- [知识库](/docs/knowledge/)：共享文档和上传文件、结构化文件夹、富文本编辑、搜索和修订恢复。
- [Aidy 与全局搜索](/docs/aidy/)：在页头搜索，在侧边栏问 Aidy，并通过引用跳转到原始记录。
- [Argos](/docs/testing/)：源码可见的用例、共享测试计划、执行证据和 Agent 访问。
- [工作与通知](/docs/work/)：工单、待办、工时记录和负责人通知。