MiniCode-go

项目简介与定位

MiniCode-go 是一个使用 Go 从零实现的、以 CLI 为主要交互入口的轻量级 Coding Agent，可以理解为一个面向原理学习的“迷你版 Pi”。

它运行在本地工作区中，用户通过命令行与 Agent 进行多轮交互。Agent 通过大语言模型理解任务，并使用受控工具完成代码浏览、文件修改、命令执行和测试验证：

理解任务 → 检查代码 → 调用工具 → 修改代码 → 运行验证 → 根据结果继续修复

项目定位为一个简单但完整的教学型终端 Agent：尽量减少框架依赖和非必要抽象，但保留一个 Coding Agent 的核心能力，包括模型调用、工具调用、Agent Loop、CLI 会话、Session 持久化、上下文压缩、执行前确认、流式输出和结果验证。

首版从单 Agent、单任务、单本地工作区开始，不提供 Web UI、IDE 插件、多 Agent 或长期记忆，重点是通过逐步实现一个可运行的最小闭环，理解模型、Agent、工具和宿主程序之间的协作方式。

开发进度

• ✅ Day 0：项目定位、功能范围和开发计划；
• ⬜ Day 1：协议结构体 + 单次非流式模型调用；
• ⬜ Day 2：工具 Schema 定义 + 工具调用响应解析；
• ⬜ Day 3：Agent Loop；
• ⬜ Day 4：bash、write_file 和工具注册表；
• ⬜ Day 5：系统 Prompt + CLI 输入循环；
• ⬜ Day 6：输出截断、轮数上限和执行前确认；
• ⬜ Day 7：token 统计和过程可视化；
• ⬜ Day 8：Ctrl+C 中断与 context 取消；
• ⬜ Day 9：Session 持久化与恢复；
• ⬜ Day 10：Provider 抽象层；
• ⬜ Day 11：SSE 流式解析；
• ⬜ Day 12：tool_calls 参数分片累积与打字机输出；
• ⬜ Day 13：上下文压缩触发与摘要；
• ⬜ Day 14：压缩切分点合法性处理。

项目文档

• docs/spec.md：项目定位、功能规格、开发计划和验收标准；
• docs/plan.md：按天拆分的开发任务和完成状态。