weiyi
项目MewCode

MewCode,把模型决策接到真实开发任务

从一次工具调用开始,理解 Go Coding Agent 的协议、上下文、安全与协作。

依据源码分析笔记整理。已实现的机制与待完善的安全、调度和测试边界分别说明。

  1. 接收任务
  2. 模型决策
  3. 受控工具执行
  4. 观察与继续

一个真实开发任务会经历读代码、定位问题、改文件、执行命令、观察错误和再次修改。模型每次看到的只是当前上下文,文件、进程和 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