mini-coding-agent

收录理由

如果你好奇一个编码代理在内部到底是怎么运作的，这个项目是个很好的观察窗口。它刻意保持小巧，用单个 Python 文件实现了一个完整的代理循环，后端接本地 Ollama 模型。整个设计围绕六个实际构件展开：先收集仓库上下文，保持稳定的提示前缀以便重复调用时复用缓存，提供带路径校验和审批门控的结构化工具，对长输出做裁剪和压缩，持久化对话记录与工作记忆以支持会话恢复，还能把有边界的子任务委派给受限的子代理。由于除了标准库之外没有任何运行时依赖，你可以一口气读完整个实现，然后对着自己的工作区跑一遍，亲眼看到每个环节如何协作。对于想先弄懂代理内部机制再动手自建的工程师，这是一份扎实的教学参考；对于想要一个本地运行、注重隐私的编码助手的人来说，它也是一个极简的起点，能在你自己的机器上检查和修改仓库。