Archon 中文教程：v0.10.1 安装、工作流与安全边界
Archon 当前 0.x 系列是 AI 编码 Agent 的工作流引擎。你用 YAML 定义步骤和依赖，Archon 把任务分派给编码 Agent 或本地脚本，并默认在独立 git worktree 中运行。
1. 选择 v0.10.1 并核对安装包
当前最新正式版是 v0.10.1，发布于 2026-08-30。官方提供 macOS、Linux 和 Windows 二进制、Homebrew、Docker 及源码安装。为了能审查下载内容，优先从 GitHub Release 下载对应二进制与 checksums.txt，核对 SHA-256 后再加入 PATH。
# 安装后先只读取版本 archon version # 在测试仓库中列出工作流 archon workflow list --cwd /path/to/test-repo
预编译二进制不要求 Bun。从源码开发才需要 Git 和 Bun；Windows 的 bash: 节点还需要 Git Bash 等 bash 实现。
2. v0.10.1 的升级陷阱
v0.10.1 的 CHANGELOG 明确标成破坏性变化：内置模型层级只覆盖 claude 和 codex。若旧安装用 pi、copilot 或 opencode，又没有显式 tiers:，内置工作流会拒绝加载。
升级前导出配置、列出实际 provider 与 tier，再在副本仓库跑一次工作流。不要先升级生产调度器，再临时猜模型名称。
3. 理解六种节点
| 节点 | 作用 | 首先检查 |
|---|---|---|
| command / prompt | 把命令或提示交给编码 Agent | 权限、模型与上下文 |
| bash | 执行本地脚本并捕获输出 | 删除、网络、凭据和退出码 |
| loop | 重复调用直到完成信号 | 最大次数与停止条件 |
| approval | 等待人工批准或拒绝 | 审批人看到的证据 |
| cancel | 按条件提前终止 | 清理 worktree 和外部资源 |
无依赖节点会并行，同一层的脚本可能同时修改外部系统。worktree 只能隔离 git 工作目录，不能隔离云账号、数据库、容器或共享缓存。
4. 第一个流程只做低权限检查
在没有生产密钥的测试仓库中，建立一个含三步的工作流：只读脚本收集仓库状态，一个 Agent 生成计划，一个 approval 节点等待人工检查。确认以下内容后再加入写代码和开 PR：
- 新 worktree 和分支名称符合预期；
- 脚本失败时下游不会误判成功；
- 人工拒绝后运行状态和临时目录可清理；
- Agent 输出、费用和调用 provider 可追踪；
- 远端推送需要单独、最小范围的凭据。
5. 项目与全局工作流的优先级
全局文件放在 ~/.archon/workflows、~/.archon/commands 和 ~/.archon/scripts。仓库本地定义优先于全局定义。团队应把关键工作流提交进项目，审查同名覆盖，避免开发者机器上的全局脚本悄悄改变 CI 或发布步骤。
6. Archon 与 GitHub Spec Kit 的区别
GitHub Spec Kit 以 specification、plan、tasks、implement 和 converge 等工件与命令组织开发，也提供工作流能力。Archon 更偏通用执行引擎，强调 DAG 节点、并行、worktree 和多入口触发。需求容易漂移、需要长期保存规格工件时先看 Spec Kit；需要把脚本、多个 Agent 和审批编排成调度流程时，Archon 更直接。
7. 本次验证边界
验证状态：本次核对官方仓库、archon.diy 安装/概念/CLI/工作流文档、CHANGELOG、MIT LICENSE 和 GitHub Releases；没有下载或执行二进制。
已经确认：当前产品形态、v0.10.1、六种节点、worktree 默认隔离、Bun 的源码依赖和模型 tiers 破坏性变化均有官方依据。
没有验证：二进制签名与校验和、安装、数据库迁移、Agent 登录、YAML 调度、脚本权限、worktree 清理、并发、外部入口和费用。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合把 issue 修复、规格到实现、测试、PR 评审和发布前检查固化为可重复流程，并行分派到隔离分支。一次性问答、无需仓库状态的小任务，或没有能力审查自动执行脚本的环境，不必引入完整引擎。
采用建议
Archon 适合已经有稳定工程流程、希望把多 Agent 任务变成可审查 DAG 的团队。先从单个测试仓库、一个审批门和无破坏性的脚本开始，验证失败恢复与 worktree 清理后再增加并发和外部触发；从旧 RAG 版迁移或升级 v0.10.1 时必须重新核对文档和模型层级。
原教程未展开的系统信息
核心功能
YAML DAG 工作流
节点支持 command、prompt、bash、loop、approval 和 cancel，并可声明 depends_on、条件与 trigger rule。
多入口调度
同一工作流可以从 CLI、Web、Slack、Telegram 或 GitHub 评论触发，工作流节点可选择不同 Agent 或模型层级。
社区工作流包
官方目录可安装修复 issue、PR 评审、PIV 循环、Ralph DAG 等工作流，仓库局部定义可覆盖全局定义。
架构与数据流
CLI 读取项目、全局或安装包中的工作流 YAML，解析成 DAG；无依赖节点可以并行，command/prompt/loop 节点交给配置的编码 Agent，bash 节点执行本地脚本，approval 节点等待人工响应。运行状态、节点输出和隔离环境被持久化，每个 git 项目默认使用独立 worktree。
常见问题
现在的 Archon 还是 RAG 知识库项目吗？
不是。官方文档明确说明当前 0.x 是 AI 编码 Agent 工作流引擎；早期 v1-v6 的 RAG、embedding 和向量库教程属于另一种产品形态。
升级到 Archon v0.10.1 前要检查什么？
若使用 pi、copilot 或 opencode，要先显式配置模型 tiers。v0.10.1 只为 claude 和 codex 提供内置 tier，其他 provider 没配置时工作流会拒绝加载。
Archon 的 worktree 能保证 Agent 不会破坏仓库吗？
不能。worktree 隔离工作分支，但 Agent 和 bash 节点仍能执行命令、访问凭据或推送远端。敏感步骤仍要限制权限并设置 approval。
安装 Archon 二进制还需要 Bun 吗？
官方预编译二进制路径不要求 Bun；从源码安装和开发才需要 Bun。Windows 工作流中的 bash 节点仍需要 Git Bash 等 bash 环境。