尧图网页设计 
如何开始参与 Archon 源码开发并完成本地构建验证【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/ArchonArchon 是一个可自托管的 agentic 自动化引擎用 TypeScriptBun 工作区实现。如果你想修改它的代码并提交贡献需要走一条固定的本地路径克隆仓库、装好依赖、能跑起开发进程然后用仓库自带的检查脚本完成本地构建验证——所有检查通过之后才有资格开 Pull Request。本文按 CONTRIBUTING.md、From Source 安装说明 和 DX Quirks 中记录的步骤展开。准备环境三个前置依赖源码方式运行 Archon 需要以下依赖见 installation.md 的 Prerequisites (Source Install)Bun文档要求 1.0.0同时仓库根 package.json 的engines字段将 bun 固定为1.4.2。两个来源要求不一致建议直接使用 1.4.2避免触发引擎版本冲突。GitHub CLIgh。Claude CodeclaudeArchon 编排 Claude Code 但不捆绑它需要单独安装。源码安装bun run会通过node_modules自动找到 Claude Code 可执行文件不需要配置CLAUDE_BIN_PATH。获取代码并安装依赖从仓库获取源码并在根目录安装依赖git clone https://gitcode.com/GitHub_Trending/archon3/Archon cd Archon bun install上面的克隆地址对应本文所在的仓库按 CONTRIBUTING.md 的流程实际贡献时你应 fork 后克隆自己的 fork。安装完成后按 CONTRIBUTING.md 的 Getting Startedcp .env.example .env # 然后按其中说明配置 bun run devbun run dev等价于bun --filter * dev见 package.json 的 scripts会同时启动所有工作区包的开发进程。看到开发进程正常拉起、日志中没有报错即表示本地环境可以进入开发循环。开发模式下的两个已知现象DX Quirks 记录了开发时容易踩到的两点根目录bun dev使用--filter修复热重载路径问题但会截断日志出现[N lines elided]。要看 server 完整日志直接从包目录运行cd packages/server bun --watch src/index.ts主仓库默认监听端口 3090worktree 会自动分配 3190–4089 范围的确定性端口需要换端口时用PORT4000 bun dev覆盖。本地构建验证从窄检查到完整 validate修改代码后先跑能证明你改的行为的窄检查开 PR 前再跑完整验证。只跑单个测试文件不要从仓库根直接执行bun test——Bun 的mock.module()是进程级且不可逆的全仓单进程跑会触发约 135 个 mock 污染失败。始终使用bun run test它按包分组隔离执行# 从仓库根按路径定位到所属包运行 bun run test packages/paths/src/effort.test.ts路径参数必须指向packages/name/、scripts/或.archon/scripts/下的文件不指定 owner 的调用会直接报错而不是跑全量测试实现见 scripts/repo-tests.ts。完整验证链CONTRIBUTING.md 要求在提交 PR 前保证以下检查通过bun run check:bundled # bundled 默认文件是最新的 bun run type-check # TypeScript 类型 bun run lint # ESLint bun run format # Prettier bun run test # 全部测试按包隔离 # 或者一次性跑完整验证套件 bun run validatebun run validate的完整链路package.json依次为check:cli-import-boundary、check:bundled、check:bundled-skill、check:bundled-schema、check:pi-vendor-map、check:capability-matrix、check:api-types、type-check、lint --max-warnings 0、format:check、test:install、test。全部命令成功退出即为验证通过任一步失败会停在对应步骤。两点补充改过数据库 schema 时bun run validate不覆盖migrations/000_combined.sql的升级检查那需要真实 PostgreSQL。对任意一个 PostgreSQL 实例自行运行bun run check:schema-upgrades # 使用 PGHOST/PGUSER/… 或 DATABASE_URL本地冒烟检查环境就绪后可以用 CLI 验证工作流发现是否正常工作workflow命令要求当前目录是 git 仓库仓库本身即是bun run cli workflow list该命令会列出 bundled 默认工作流并合并.archon/workflows/下的仓库工作流见 New Developer Guide。提交前的代码规范与 PR 边界AGENTS.md 是代码层面的权威指引动手前建议通读。与本地验证通过后能否被接收直接相关的硬性规则TypeScript strict 模式强制执行所有函数必须显式返回类型没有理由不得使用any。遵循 AGENTS.md 与.archon/engineering.md的代码风格。分支从dev拉出PR 回到dev提交信息用 Conventional Commit 风格标题描述有意义的结果禁止 AI attribution、机器人 emoji 或Co-Authored-By字段。PR 必须使用.github/pull_request_template.md模板保留 Problem and outcome、Review guidance、Solution、Validation 等适用章节并用Closes #number等形式关联 issue——没有关联 issue 的 PR 会被关闭。不接受修改.archon/workflows/sdlc/的 PR这类改动需要开 issue 说明。提出大型功能前先读.archon/direction.md与产品方向冲突的 PR 会被关闭。完成以上路径后你的贡献就具备了进入审查的条件窄测试、bun run validate涉及 schema 时加上check:schema-upgrades全部通过PR 从dev分支按模板提交并关联 issue。【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 如何开始参与 Archon 源码开发并完成本地构建验证？
如何开始参与 Archon 源码开发并完成本地构建验证【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/ArchonArchon 是一个可自托管的 agentic 自动化引擎用 TypeScriptBun 工作区实现。如果你想修改它的代码并提交贡献需要走一条固定的本地路径克隆仓库、装好依赖、能跑起开发进程然后用仓库自带的检查脚本完成本地构建验证——所有检查通过之后才有资格开 Pull Request。本文按 CONTRIBUTING.md、From Source 安装说明 和 DX Quirks 中记录的步骤展开。准备环境三个前置依赖源码方式运行 Archon 需要以下依赖见 installation.md 的 Prerequisites (Source Install)Bun文档要求 1.0.0同时仓库根 package.json 的engines字段将 bun 固定为1.4.2。两个来源要求不一致建议直接使用 1.4.2避免触发引擎版本冲突。GitHub CLIgh。Claude CodeclaudeArchon 编排 Claude Code 但不捆绑它需要单独安装。源码安装bun run会通过node_modules自动找到 Claude Code 可执行文件不需要配置CLAUDE_BIN_PATH。获取代码并安装依赖从仓库获取源码并在根目录安装依赖git clone https://gitcode.com/GitHub_Trending/archon3/Archon cd Archon bun install上面的克隆地址对应本文所在的仓库按 CONTRIBUTING.md 的流程实际贡献时你应 fork 后克隆自己的 fork。安装完成后按 CONTRIBUTING.md 的 Getting Startedcp .env.example .env # 然后按其中说明配置 bun run devbun run dev等价于bun --filter * dev见 package.json 的 scripts会同时启动所有工作区包的开发进程。看到开发进程正常拉起、日志中没有报错即表示本地环境可以进入开发循环。开发模式下的两个已知现象DX Quirks 记录了开发时容易踩到的两点根目录bun dev使用--filter修复热重载路径问题但会截断日志出现[N lines elided]。要看 server 完整日志直接从包目录运行cd packages/server bun --watch src/index.ts主仓库默认监听端口 3090worktree 会自动分配 3190–4089 范围的确定性端口需要换端口时用PORT4000 bun dev覆盖。本地构建验证从窄检查到完整 validate修改代码后先跑能证明你改的行为的窄检查开 PR 前再跑完整验证。只跑单个测试文件不要从仓库根直接执行bun test——Bun 的mock.module()是进程级且不可逆的全仓单进程跑会触发约 135 个 mock 污染失败。始终使用bun run test它按包分组隔离执行# 从仓库根按路径定位到所属包运行 bun run test packages/paths/src/effort.test.ts路径参数必须指向packages/name/、scripts/或.archon/scripts/下的文件不指定 owner 的调用会直接报错而不是跑全量测试实现见 scripts/repo-tests.ts。完整验证链CONTRIBUTING.md 要求在提交 PR 前保证以下检查通过bun run check:bundled # bundled 默认文件是最新的 bun run type-check # TypeScript 类型 bun run lint # ESLint bun run format # Prettier bun run test # 全部测试按包隔离 # 或者一次性跑完整验证套件 bun run validatebun run validate的完整链路package.json依次为check:cli-import-boundary、check:bundled、check:bundled-skill、check:bundled-schema、check:pi-vendor-map、check:capability-matrix、check:api-types、type-check、lint --max-warnings 0、format:check、test:install、test。全部命令成功退出即为验证通过任一步失败会停在对应步骤。两点补充改过数据库 schema 时bun run validate不覆盖migrations/000_combined.sql的升级检查那需要真实 PostgreSQL。对任意一个 PostgreSQL 实例自行运行bun run check:schema-upgrades # 使用 PGHOST/PGUSER/… 或 DATABASE_URL本地冒烟检查环境就绪后可以用 CLI 验证工作流发现是否正常工作workflow命令要求当前目录是 git 仓库仓库本身即是bun run cli workflow list该命令会列出 bundled 默认工作流并合并.archon/workflows/下的仓库工作流见 New Developer Guide。提交前的代码规范与 PR 边界AGENTS.md 是代码层面的权威指引动手前建议通读。与本地验证通过后能否被接收直接相关的硬性规则TypeScript strict 模式强制执行所有函数必须显式返回类型没有理由不得使用any。遵循 AGENTS.md 与.archon/engineering.md的代码风格。分支从dev拉出PR 回到dev提交信息用 Conventional Commit 风格标题描述有意义的结果禁止 AI attribution、机器人 emoji 或Co-Authored-By字段。PR 必须使用.github/pull_request_template.md模板保留 Problem and outcome、Review guidance、Solution、Validation 等适用章节并用Closes #number等形式关联 issue——没有关联 issue 的 PR 会被关闭。不接受修改.archon/workflows/sdlc/的 PR这类改动需要开 issue 说明。提出大型功能前先读.archon/direction.md与产品方向冲突的 PR 会被关闭。完成以上路径后你的贡献就具备了进入审查的条件窄测试、bun run validate涉及 schema 时加上check:schema-upgrades全部通过PR 从dev分支按模板提交并关联 issue。【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考