1. 多轮 AI 编程为什么总在第三轮开始崩如果你用 AI 写过稍微像样的项目大概率遇到过这个场景第一轮让它建个 Spring Boot 骨架干净利落第二轮加个用户登录也还行到第三轮让它补个多租户隔离它开始把 Controller 的注解写到 Entity 上把数据库连接池配置塞进 Service 层甚至忘了你前面定好的包名规范。你不得不把前面聊过的架构约定重新贴一遍贴完它又忘了上一轮刚改过的字段名。这不是模型不够聪明而是无状态对话的天然缺陷。每一次新会话AI 对项目的认知都从零开始它看不到你上周做的架构决策也读不到你昨天写的分层规范。上下文窗口再大也扛不住几十轮任务累积的信息量更别说窗口一满就被截断。我试过把架构规范写进系统提示词效果有限——提示词是静态的项目是动态演进的。真正的问题在于记忆没有落地成文件执行没有约束成流程。这套方案要解决的就是这件事。核心思路是把 AI 编程拆成两个角色一个负责“记住并规划”一个负责“动手并回报”。前者用 Hermes 做记忆中枢后者用 OpenCode 做执行终端中间用一套叫 Harness 的工程化约束把两者串起来。Hermes 是什么你可以把它理解成一个带长期记忆和技能库的规划智能体它维护项目的架构宪法和任务清单。OpenCode 是什么它是一个能读写文件、执行命令的编码终端动手能力强但缺乏长期规划。Harness 则是连接两者的规则层强制代码分层、强制先规划后执行。适合谁适合那些已经用 AI 写过小项目、但一上规模就失控的开发者。如果你还在纠结怎么让 AI 写个冒泡排序这篇可能偏重了但如果你想让 AI 帮你维护一个持续迭代的后台系统这套流程值得跟做。整篇文章我会按“问题场景 → 前置准备 → 可复制配置 → 验证请求 → 错排查 → 工具入口”的顺序展开每一步都给能直接复制的片段。下面先从环境准备说起。2. Hermes 记忆中枢与 OpenCode 终端的前置准备在动手配置之前得先把两个角色的职责边界划清楚。很多人一上来就急着装工具结果配完发现 Hermes 和 OpenCode 各说各话记忆文件写了没人读任务清单生成了没人执行。根因是没搞明白它们各自该干什么。Hermes 的定位是记忆与规划中枢。它需要具备三样能力长期记忆存储、任务拆解规划、架构规范维护。长期记忆不是指模型参数里的知识而是指它能把你项目的关键决策写成文件并持续读取。任务拆解是指你给一个模糊需求它能输出带优先级和依赖关系的任务清单。架构规范维护是指它能在生成代码前检查分层依赖发现违规就拦截。OpenCode 的定位是执行终端。它需要能读写项目文件、执行 shell 命令、调用模型生成代码。它不负责记住架构只负责在给定指令下精准落地。指令里必须带角色属性比如“你现在是 java-developer”否则它会用通用风格乱写。两者之间的桥梁是 Harness 工程化约束。Harness 原本是为 Qwen Code 设计的一套分层规范核心是 Layer 0 到 Layer 4 的依赖规则Layer 0 是纯数据类型无任何依赖Layer 1 到 2 是工具类和配置Layer 3 是核心业务逻辑Layer 4 是控制器和接口。规则很简单——高层可以依赖低层低层严禁感知高层。Hermes 在生成代码前会检查这个依赖关系OpenCode 在执行时按这个规则写文件。前置准备分三步。第一步确认你本地有 Node.js 18 以上和 GitOpenCode 依赖 Node 运行时。第二步准备一个模型接入点Hermes 和 OpenCode 都需要调用大模型这里我用 TaoToken 做统一接入后面会给具体配置。第三步建一个空项目目录比如superboot-admin在里面初始化 Git 仓库因为 Harness 的 trace 日志和记忆文件都建议纳入版本管理。关于模型接入TaoToken 的 API 地址是https://taotoken.net/api官网是https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end。它提供兼容 OpenAI 风格的接口Hermes 和 OpenCode 都能直接对接。你需要先去控制台创建一个 API Key这个 Key 后面会写进两个工具的配置文件里。注意Key 只显示一次创建后立刻复制保存。环境就绪后目录结构建议这样组织项目根目录下建harness/放任务清单和 trace 日志建docs/放架构规范建src/main/java放 Java 代码。这个结构不是随便定的Hermes 读写记忆文件时依赖固定路径OpenCode 执行任务时也按这个路径找文件。路径一旦定好后面所有配置都围绕它展开。还有一点容易被忽略Hermes 和 OpenCode 的模型选择可以不同。Hermes 负责规划和审查建议用推理能力强的模型OpenCode 负责生成代码可以用响应更快的模型。TaoToken 支持在请求里指定 model 参数所以两个工具可以各配各的。具体怎么配下一节给完整片段。3. 可复制的 Hermes 与 OpenCode 配置片段这一节是全文最核心的部分所有配置都给完整片段你复制后改掉 Key 和路径就能用。配置分三块Hermes 的记忆层配置、OpenCode 的终端配置、Harness 的分层规则文件。先看 Hermes 的记忆层配置。Hermes 需要一个配置文件告诉它记忆文件放在哪、用哪个模型、API 地址是什么。在项目根目录建hermes.config.json内容如下{ memory: { tasksFile: harness/tasks.md, architectureFile: docs/ARCHITECTURE.md, traceDir: harness/trace, schemaFile: docs/DATABASE_SCHEMA.md }, model: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: claude-sonnet-4-20250514, temperature: 0.3 }, planner: { enabled: true, maxTasksPerRound: 5, requireArchitectureCheck: true } }这里baseUrl填 TaoToken 的 API 地址apiKey换成你控制台创建的 KeymodelId按你实际可用的模型填。temperature设 0.3 是因为规划任务需要稳定输出太高会乱拆任务。requireArchitectureCheck设为 true 后Hermes 每次生成代码前都会读docs/ARCHITECTURE.md做依赖检查。再看 OpenCode 的终端配置。OpenCode 的配置文件通常在用户目录下的.opencode/config.json如果你用的是项目级配置就放在项目根目录.opencode/config.json。内容如下{ provider: { name: taotoken, baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, modelId: claude-sonnet-4-20250514 }, workspace: { root: ./, srcDir: src/main/java, readOnly: [docs/ARCHITECTURE.md] }, execution: { requireRolePrefix: true, logToTrace: true, traceDir: harness/trace } }requireRolePrefix设为 true 后OpenCode 只接受带角色前缀的指令比如“你现在是 java-developer”这样能防止通用指令乱写代码。readOnly把架构规范设为只读OpenCode 不能改它只有 Hermes 能写。logToTrace让每次执行都写日志到harness/traceHermes 后续读这些日志做验证。第三块是 Harness 的分层规则文件放在docs/ARCHITECTURE.md。这个文件是 Hermes 和 OpenCode 共同遵守的“法律”内容如下# 架构规范 ## 分层规则 - Layer 0 (Types): 纯数据对象无任何 import 依赖 - Layer 1-2 (Utils/Config): 工具类与配置可依赖 Layer 0 - Layer 3 (Domain): 核心业务逻辑可依赖 Layer 0-2 - Layer 4 (Interfaces): 控制器与接口可依赖 Layer 0-3 ## 禁止事项 - Layer 0 严禁 import Layer 3 或 Layer 4 - Layer 3 严禁 import Layer 4 - 所有实体类必须放在 Layer 0 对应包下 - 数据库字段规范见 docs/DATABASE_SCHEMA.md ## 包结构 - com.superboot.types - com.superboot.utils - com.superboot.config - com.superboot.domain - com.superboot.interfaces这个文件写好后Hermes 在规划任务时会读它OpenCode 在执行时会按它检查。比如 OpenCode 要写User.java它会先看这个文件确认 User 属于 Layer 0然后检查有没有 import Controller 类有就报违规。三块配置配完还需要一个任务清单文件harness/tasks.md作为初始占位。内容可以先写个空模板# 任务清单 ## 待执行 !-- Hermes 会在这里追加任务 -- ## 已完成 !-- OpenCode 完成后由 Hermes 移动到这里 --到这里配置就齐了。你可能会问Hermes 和 OpenCode 怎么知道对方的存在答案是它们不直接通信全靠文件。Hermes 写tasks.mdOpenCode 读tasks.mdOpenCode 写trace/日志Hermes 读trace/日志。这种文件化通信的好处是解耦任何一方挂了另一方还能继续工作而且所有状态都可追溯。配置过程中有个坑要注意baseUrl末尾不要加/v1TaoToken 的接口路径已经内置了版本处理加了会 404。另外apiKey如果泄露去控制台吊销重新生成即可不要硬编码在会提交到 Git 的文件里建议用环境变量注入。下一节我们验证这套配置能不能跑通。4. 验证多轮任务连续性的完整请求配置写完不代表能跑得用真实请求验证。这一节我给一个完整的多轮任务场景从 Hermes 规划到 OpenCode 执行再到 Hermes 验证每一步都给可复制的指令和预期结果。先启动 Hermes 的规划流程。假设我们要开发一个“SuperBoot 后台管理系统”支持多租户。你给 Hermes 的输入是我要一个支持多租户的 Java 后台管理系统基于 Spring Boot 3。 请阅读 docs/ARCHITECTURE.md 和 docs/DATABASE_SCHEMA.md 拆解出第一轮任务写入 harness/tasks.md。Hermes 收到后会先读架构规范和数据库规范然后启动 Planner 智能体拆任务。预期它会在harness/tasks.md的“待执行”下追加类似内容## 待执行 - [ ] 任务1: 初始化 Maven 结构创建 pom.xml引入 Spring Boot 3 依赖 - [ ] 任务2: 设计 sys_user 表包含 tenant_id 字段写入 docs/DATABASE_SCHEMA.md - [ ] 任务3: 在 Layer 0 创建 User 实体类字段与 sys_user 表对应 - [ ] 任务4: 在 Layer 3 实现登录逻辑依赖 Layer 0 的 User如果 Hermes 没写tenant_id或者把 User 放到了 Layer 3说明它没读架构规范检查hermes.config.json里的requireArchitectureCheck是否为 true。接下来指挥 OpenCode 执行任务1。你给 OpenCode 的指令必须带角色前缀你现在是 java-developer。 请阅读 harness/tasks.md 中的任务1。 在项目根目录创建 pom.xml符合 Spring Boot 3 标准。 完成后把执行日志写入 harness/trace/task1.log。OpenCode 执行后会生成pom.xml并写日志。预期日志内容包含它读了哪些文件、生成了什么、有没有报错。你可以用cat harness/trace/task1.log查看。然后让 Hermes 验证任务1。你给 Hermes 的输入是请阅读 harness/trace/task1.log 和生成的 pom.xml 检查是否符合 docs/ARCHITECTURE.md 的规范。 如果合规把任务1移到 harness/tasks.md 的已完成区。Hermes 会读日志和 pom.xml检查依赖版本、包结构。合规就移动任务不合规就生成修正指令写回tasks.md。关键验证点在第三轮。假设任务1和任务2都完成了现在执行任务3——创建 User 实体类。你给 OpenCode 的指令是你现在是 java-developer。 请阅读 harness/tasks.md 中的任务3 和 docs/DATABASE_SCHEMA.md。 在 src/main/java/com/superboot/types 下创建 User.java 字段与 sys_user 表对应严禁 import 任何 Layer 3 或 Layer 4 的类。这里的关键是 OpenCode 能不能记住sys_user表的字段。因为任务2已经把表结构写进了docs/DATABASE_SCHEMA.mdOpenCode 读这个文件就能拿到字段不需要你重新贴一遍。这就是记忆文件化的价值——跨轮次的信息不靠对话上下文传递靠文件传递。执行完后让 Hermes 做架构检查请阅读 src/main/java/com/superboot/types/User.java 检查它是否 import 了 Layer 3 或 Layer 4 的类。 如果有违规生成修正指令写入 harness/tasks.md。预期 Hermes 会报告“无违规”或列出具体违规行。如果 User.java 里出现了import com.superboot.interfaces.*Hermes 会拦截并生成修正任务。为了验证多轮连续性你可以故意制造一个断链场景清空对话历史重新启动 Hermes 和 OpenCode然后直接让 OpenCode 执行任务4。如果它能通过读tasks.md和DATABASE_SCHEMA.md正确实现登录逻辑说明记忆层生效了。如果它问“sys_user 表有哪些字段”说明文件没读全检查hermes.config.json里的schemaFile路径对不对。整个验证流程跑通后你会看到harness/trace/下累积了多个日志文件tasks.md里任务从待执行移到已完成docs/下的规范文件被 Hermes 持续更新。这套状态是跨会话持久的关掉终端明天再来Hermes 读一遍文件就能恢复上下文。验证时如果遇到请求失败先看错误信息。下一节我列几个常见报错和排查方法。5. 常见报错排查401、local proxy failed 与 reading choices配置和验证过程中最容易卡在几个固定报错上。这一节我按真实遇到的错误信息逐个拆解每个都给排查路径。报错一401 Unauthorized这是最常见的通常出现在 Hermes 或 OpenCode 第一次调用模型时。错误信息类似Error: 401 Unauthorized - invalid api key排查三步。第一检查hermes.config.json和.opencode/config.json里的apiKey是否填了完整 Key有没有多余空格。第二确认 Key 没有过期或被吊销去 TaoToken 控制台的 API Keys 页面看状态。第三确认baseUrl填的是https://taotoken.net/api不是首页地址也不是带/v1的地址。如果三样都对还是 401重新生成一个 Key 替换试试。报错二local proxy failed这个报错通常出现在 OpenCode 执行 shell 命令时信息类似Error: local proxy failed - connection refused根因是 OpenCode 尝试通过本地代理转发请求但代理没启动或端口不对。排查方法检查你的环境变量里有没有HTTP_PROXY或HTTPS_PROXY指向一个不存在的本地端口。如果有临时清掉再试unset HTTP_PROXY unset HTTPS_PROXY然后重启 OpenCode。如果清掉后正常说明是代理配置冲突后续要么不设代理要么确保代理服务真的在跑。另外检查.opencode/config.json里有没有误配proxy字段有就删掉。报错三reading choices 相关错误这个报错出现在模型返回格式不符合预期时信息类似Error: failed to read choices from response根因通常是modelId填错了或者 TaoToken 返回的响应结构和你用的客户端解析逻辑不匹配。排查第一确认modelId是 TaoToken 支持的模型标识不要填成其他平台的模型名。第二用 curl 直接测一下接口curl -X POST https://taotoken.net/api/chat/completions \ -H Authorization: Bearer sk-你的密钥 \ -H Content-Type: application/json \ -d {model:claude-sonnet-4-20250514,messages:[{role:user,content:hi}]}如果 curl 返回正常但工具报错说明是工具侧的解析问题检查工具版本是否最新。如果 curl 也报错说明 Key 或模型 ID 有问题。报错四OAuth 相关错误如果你在配置过程中看到 OAuth 报错通常是因为某些工具默认走 OAuth 流程但你用的是 API Key 模式。排查检查配置文件里有没有authType或oauth字段有就改成apiKey模式。另外确认没有同时启用两套认证冲突会导致 OAuth 流程被触发。报错五任务清单读不到Hermes 或 OpenCode 报“tasks.md not found”或“empty task list”。排查确认harness/tasks.md文件存在路径和配置里的tasksFile一致。如果文件存在但读不到检查文件权限确保当前用户有读权限。另外注意路径是相对项目根目录还是绝对路径配置里写的是相对路径的话工具的工作目录必须是项目根目录。排查完这些基本能覆盖 90% 的配置问题。如果遇到其他报错先看错误信息里的关键词再去对应工具的文档里搜。记住一个原则Hermes 的问题多半在记忆文件路径和模型配置OpenCode 的问题多半在角色前缀和代理设置。配置跑通后你可能想把这套流程固化下来长期用。下一节给工具入口和长期使用建议。6. 从单次验证到长期 AI 编程流的落地入口单次验证跑通只是开始真正有价值的是把这套流程变成日常开发习惯。这一节说几个长期使用的关键点和工具入口。第一个关键点是记忆文件的维护节奏。harness/tasks.md会随着任务累积越来越长建议每完成一轮大任务就归档一次把已完成区的内容移到harness/archive/下按日期命名。docs/ARCHITECTURE.md不要频繁改它是项目的宪法改一次要让 Hermes 重新读一遍并检查现有代码是否合规。docs/DATABASE_SCHEMA.md每次加表都要更新OpenCode 生成实体类时依赖它。第二个关键点是角色前缀的规范。OpenCode 支持多种角色比如java-developer、architect、reviewer。建议固定几个常用角色写进docs/ARCHITECTURE.md里让 Hermes 规划任务时直接指定角色。这样 OpenCode 执行时不用你每次手写前缀Hermes 会在任务描述里带上。第三个关键点是 trace 日志的利用。harness/trace/下的日志不只是记录Hermes 会读它们做验证。建议每次 OpenCode 执行后都让 Hermes 跑一遍验证形成“执行-验证-修正”的闭环。时间长了这些日志还能帮你回溯某个决策是什么时候做的、为什么这么做。工具入口方面你需要几个固定地址。模型对话和调试用https://taotoken.net/api配合模型对话页面接入文档在官网的文档区API Key 管理在控制台。如果你要长期跑编码任务和 Agent 流程建议用 Coding Plan它针对多轮任务做了优化比单次调用更稳定。Claude Code 和 Anthropic 相关的接入配置官网也有对应说明。具体操作路径先去控制台创建 API Key然后按本文第三节的配置片段填进 Hermes 和 OpenCode接着按第四节验证多轮任务遇到报错按第五节排查。跑通后把配置文件和记忆文件纳入 Git 版本管理团队协作时每个人拉下来改一下 Key 就能用。这套流程的价值不在于某个工具多强而在于它把 AI 编程从“每次重新解释需求”变成了“持续维护一个项目记忆”。Hermes 记住架构和任务OpenCode 执行具体编码Harness 约束质量。三者配合多轮任务不再断链上下文不再丢失。你可以先从一个小项目试起跑顺了再往大项目迁移。