mini-coding-agent 是 Sebastian Raschka（rasbt）写的一个极简、可读的「编码代理 harness」实现，目的是讲清楚编码代理（coding agent）的核心组件长什么样。它是单文件 Python（mini_coding_agent.py），除标准库外零运行时依赖，模型后端基于本地 Ollama。它把一个完整的本地 agent 循环拆成六大实用模块：工作区快照、稳定提示 + 轮次状态、结构化工具与权限、上下文压缩与输出管理、转录与记忆持久化、有界委派。配套一篇详细教程博文。Apache-2.0、约 870 星，是「读懂编码代理是怎么搭的」的教学型项目。
来源：README 顶部/Six Core Components、GitHub meta（rasbt/mini-coding-agent，Python，Apache-2.0，homepage 教程博文） 查看 GitHub 仓库 →编码代理（Claude Code/Codex 等）很强但内部如何搭建对多数人是黑盒，而市面实现要么闭源要么庞杂。出自知名作者 rasbt 的 mini-coding-agent 用单文件、零依赖、本地 Ollama 的极简实现，把「一个编码代理的六大核心组件」讲得清清楚楚，并配详细教程，正好满足「想从代码层面读懂 agent」的学习需求，因此受到关注（约 870 星，教学定位、规模适中）。
来源：README 顶部/Six Core Components、GitHub meta（stars 873、created_at 2026-04-02、pushed_at 2026-04-07）围绕六个实用模块组织：①实时仓库上下文（预先收集仓库布局/指令/git 状态等稳定事实）②提示结构与缓存复用（稳定前缀与变化的请求/转录/记忆分离，复用静态部分）③结构化工具+校验+权限（命名工具、输入校验、路径校验、危险操作审批门）。
来源：README Six Core Components（1-3）④上下文压缩与输出管理（裁剪长输出、去重重复读取、压缩较旧转录以控提示大小）⑤转录、记忆与续跑（同时保留完整持久转录与较小工作记忆，借工作记忆保状态可恢复会话）。
来源：README Six Core Components（4-5）⑥委派与有界子代理：可把限定范围的子任务委派给继承足够上下文的助手代理，但在限制内运作，避免失控。
来源：README Six Core Components（6）全部逻辑在 mini_coding_agent.py，除标准库外无 Python 运行时依赖，可直接 `python mini_coding_agent.py` 跑；模型走本地 Ollama 的 /api/generate（默认 qwen3.5:4b，可换更大模型），可选用 uv 管环境与 CLI。
来源：README 顶部/Requirements/Install Ollama 段项目极简：核心是单文件 mini_coding_agent.py（提供 mini-coding-agent CLI），除标准库外零依赖，配 pyproject.toml、tests/、EXAMPLE.md。它实现一个本地 agent 循环：启动时收集工作区快照与稳定事实，构造「稳定提示前缀 + 变化的请求/转录/记忆」以复用缓存，模型通过命名的结构化工具行动（带输入与路径校验、危险工具审批门），对长输出做裁剪/去重/压缩以控上下文，并维护完整转录 + 工作记忆以支持续跑，还能把有界子任务委派给子代理。模型后端是本地 Ollama（默认 qwen3.5:4b，调用 /api/generate）。整体把「编码代理的六大组件」用最小可读的代码呈现，便于学习与改造。
来源：README Six Core Components/Requirements、仓库目录（mini_coding_agent.py、tests、EXAMPLE.md、pyproject.toml）中心为项目本体，内环 = 核心功能模块，外环 = 关键技术依赖；按 deep.json 中的 core_features 与 tech_stack.key_deps 自动生成
Ollama（本地模型后端，/api/generate）默认模型 qwen3.5uv（可选，环境与 CLI 入口）纯学习与研究用途：想从代码层面搞懂「编码代理是怎么搭的」——仓库上下文、提示与缓存、结构化工具与权限、上下文压缩、转录/记忆/续跑、子代理委派这六大组件如何配合；可在本地用 Ollama 跑起来、改一改加深理解，或作为自建轻量 agent 的脚手架起点。配 rasbt 的教程博文，是教学/自学编码代理原理的优质材料。它不是生产级编码工具，能力受本地小模型限制。
来源：README 顶部/Six Core Components、教程链接项目以单文件仓库形式发布，配教程博文，无打 tag 的正式 Release。已实现编码代理的六大核心组件（仓库上下文、提示/缓存、结构化工具与权限、上下文管理、转录/记忆/续跑、有界委派），本地 Ollama 后端。Apache-2.0、约 870 星。仓库最近一次更新在 2026-04-07。
来源：README/教程、GitHub meta pushed_at 2026-04-07、created_at 2026-04-02mini-coding-agent 是「想读懂编码代理怎么搭」的绝佳教材：rasbt 用单文件、零依赖、本地 Ollama 的极简实现，把仓库上下文、提示与缓存、结构化工具与权限、上下文压缩、转录/记忆/续跑、有界子代理委派这六大核心组件讲得明明白白，还配了详细教程。对学习 agent 原理或想自建轻量编码代理的人，它清晰、可跑、可改，价值很高。要清楚它是教学/最小实现而非生产工具，能力受本地小模型限制、需 Ollama 环境、让 agent 操作工作区仍需谨慎。作为「从代码层面理解编码代理」的入门项目，它简洁而到位。
来源：综合 README、Six Core Components 与 GitHub meta 的事实判断