- 接收任务
- 模型决策
- 受控工具执行
- 观察与继续
一个真实开发任务会经历读代码、定位问题、改文件、执行命令、观察错误和再次修改。模型每次看到的只是当前上下文,文件、进程和 Git 状态却持续变化。MewCode 围绕这个落差实现本地终端 Coding Agent,让多轮决策与实际执行能够衔接。
项目目标
MewCode 也称 Co-Coder 或 code-golang。材料将其描述为独立设计与实现的 Go 终端 Agent,支持流式问答、Tool Calling、Plan、Skill、MCP、上下文管理、记忆、Sub-Agent 和 Agent Team。
核心目标是让不同模型协议进入相同的循环,让工具副作用在执行前有可检查边界,让长任务在上下文增长和会话恢复后继续工作,让并行修改最后能够收敛到一个可验证结果。
为什么这样组织运行时
| 机制 | 解决的实际问题 | 成本或限制 |
|---|---|---|
| Go、事件通道与 goroutine | UI 呈现流、接收工具结果和异步工作需要同时推进 | 取消、状态同步和关闭顺序必须清晰 |
llm.Client 与 Provider Adapter |
不同模型的消息、工具增量和错误语义不同 | 适配器仍需理解各协议的能力与边界 |
| Tool Registry、MCP | 内置工具和外部服务使用统一查找与执行入口 | 外部工具还带来超时、参数和权限元数据问题 |
| Skill Catalog | 多套任务 SOP 长期注入会占用上下文 | 需要发现、激活和退出阶段的生命周期管理 |
| JSONL、Markdown Memory | 任务恢复与稳定知识继承有不同存储需求 | 恢复日志与语义记忆需要分别维护 |
| Git Worktree、Mailbox | 并行任务需要独立文件状态和持续通信 | 外部资源仍共享,最终合并仍需验证 |
五个逻辑边界怎样协作
交互与配置层把用户输入、会话选择和配置交给 Agent。编排层控制轮次、计划、工具调度和结束条件。模型与能力适配层把 Provider、Registry、MCP 和 Skill 收敛到中立接口。状态与上下文层维护 Conversation、Session、预算和记忆。受控执行与协作层落实权限检查、文件命令操作与多 Agent 工作区。
这些是解释变化原因的逻辑边界,代码目录可以跨越多个包。更换一个 Provider 时,主要变化集中在适配层;加入一个工具时,主要变化集中在工具接口、注册和执行前检查。
一轮任务如何推进
用户消息进入 Conversation。Agent 每轮构造当前可见的工具 Schema,处理运行阶段的提示、记忆和异步消息,再调用模型流。
适配器将文本、思考和工具参数增量转换为内部事件。收到完整 ToolCall 后,运行时查 Registry、检查权限、执行 PreToolUse Hook,随后启动工具。流结束后等待工具完成,按提交顺序把带原 tool_use_id 的结果回填,再进入下一轮。
模型未产生工具调用时,本轮可以结束;轮次上限、未知工具计数、空响应、限流和上下文错误分别走自己的停止或重试路径。MaxIterations=0 的配置允许不设置轮数上限,因此运行预算需要明确配置。
长任务最容易断在哪里
大工具输出会耗尽上下文。MewCode 一方面把超预算结果溢出到文件,另一方面在接近窗口时摘要早期历史并保留最近尾部。压缩仍需维护调用 ID 和工具结果配对,冻结结果替换决策则让重复发送的历史前缀保持稳定。
会话恢复依赖 JSONL 的消息和运行边界,长期知识则保存在用户级与项目级 Markdown 记忆中。一次任务的进度、一个稳定的协作偏好和一份工具输出,有各自合适的保存位置。
复杂任务可以委托独立 Agent。Team 中的 Teammate 保留自己的会话、身份和邮箱,Worktree 隔离文件 checkout 与分支。Lead 收集结果、审查 diff、按依赖合并并测试,承担最终收敛。
当前实现中值得保留的诚实边界
当前执行器会并发提交多个完整 ToolCall,工具 Category 主要用于权限判断,尚未提供自动识别写依赖的完整调度。Plan Mode 也有权限矩阵尚未硬化的边界。路径沙箱存在前缀与符号链接问题,部分子 Agent 的安全继承需要补齐。
上下文管理具备局部结果预算和全局摘要两类机制,实际循环先进行全局窗口判断,再生成预算化请求视图,可能提前触发摘要。资料中的设计目标与源码顺序因此需要分别说明。
材料记录的 2026 年 9 月本机测试还有 Team 后端检测和 macOS 路径规范化断言失败。这里展示的是运行时探索及其边界,稳定性仍需要通过协议回归、安全测试与可重放任务继续验证。
阅读路线
先读Agent Loop 与多模型协议,再看工具、Skill 与 MCP如何进入循环。接着读上下文和记忆,理解长任务如何保留当前工作与跨会话知识。
最后进入权限与受控执行以及多 Agent 与 Worktree,看模型提出动作之后,系统怎样约束副作用,并验证协作结果。
本文整理依据
内容依据项目复习材料整理,本次发布没有重新审计源码或复跑历史实验。相同主题按专项笔记和较新复盘统一,原始笔记保留在本机。
- Co Coder/MewCode_90分钟面试复习笔记.md
- Co Coder/MewCode_Multi-Agent实现机制复习笔记.md
- Co Coder/MewCode_上下文管理机制源码分析.md
- Co Coder/MewCode_五层架构设计复习笔记.md
- Co Coder/MewCode_工具注册到使用流程源码分析.md
- Co Coder/MewCode_记忆系统设计与源码分析.md
- Co Coder/MewCode_项目面试题.md
- Co Coder/MewCode_项目面试题与答案.md
- Co Coder/code-golang简历题分析.md