概览

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。

闭环#

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 才会成功。流水线通过表示已配置的检查全部通过，并不代表软件没有缺陷。

分工#

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

Web 应用#

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

内部原理#

一个实例由一个 Go 网关和其后的两个成熟内核组成：Forgejo 负责 Git、PR 和制品，Woodpecker 负责 CI。内核保持私有，网关是唯一对外暴露的入口。流水线在独立的执行节点主机上运行。参见工作原理。

下一步#

• 安装实例
• 接入 Agent
• 运行演示闭环

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

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

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