mini-cc：打造你的专属轻量级 AI 编程智能体-开发者社区

你是否想过拥有一个像 Claude Code 一样强大的命令行 AI 编程助手？

你是否想深入了解 Agent（智能体）背后的核心事件循环与工具调用（Tool Use）原理？

mini-cc就是为你准备的开源解决方案！

这是一个完全使用 TypeScript 编写的轻量级 AI 编程 Agent 核心框架。

它摒弃了复杂的历史包袱，采用纯粹的**函数式编程（Functional Programming）**范式，将大模型、工具系统、记忆上下文与事件循环精简到了极致。

✨ 核心能力与亮点

1. 🧠 多模型兼容与无缝切换

双擎驱动：原生支持 Anthropic API（如 Claude 3.5 Sonnet/Opus）以及基于 OpenAI 标准的各类大模型接口。
开源/国产模型适配：完美适配 Qwen（通义千问）、DeepSeek、Kimi 等热门模型。只需修改.env环境变量，即可一键切换底层大脑。

2. 💡 沉浸式的“思考”体验（深度适配推理模型）

流式输出：支持极速的流式文本渲染，告别漫长的等待。
思维链（CoT）可视化：深度适配如 Qwen-Max / DeepSeek-R1 等带有reasoning_content的模型。
AI 的推导和思考过程在终端中实时呈现，让你清晰看到它解决问题的每一步逻辑。

3. 🛠️ 强大的自主行动力（Tool Use 系统）

BashTool：赋予 AI 终端执行权限，它可以帮你自动执行npm install、git commit、运行测试脚本等。安全沙盒机制保障高危命令被有效拦截。
FileReadTool：赋予 AI 读取本地代码库的权限，支持突破长度限制的智能截断。
FileWriteTool：赋予 AI 修改、覆盖代码的能力，支持自动补全缺失的目录层级。你只需提出需求，代码修改全自动完成。

4. 🔁 永不言弃的 Agent 循环

实现了专业的 Tool Use 事件循环（Agent Loop）。
当任务复杂时，AI 会连续多次调用工具（如：先FileReadTool看代码 -> 再BashTool运行测试 -> 最后FileWriteTool修复 Bug），直到彻底解决你的问题。

5. 🛡️ 纯粹的函数式架构

全面拥抱函数式编程（FP）思想，零class依赖。闭包状态管理使得核心更加安全、高效且易于测试与扩展。
附带详尽的中文注释，是学习和二次开发 Agent 的绝佳教科书。

🎮 交互效果展示：一句话生成五子棋游戏！

在终端中启动mini-cc后，你只需一句自然语言指令，它就能化身为全栈开发工程师，从构思到编码，一气呵成。

以下是真实交互实录（还原了利用test_file/gomoku编写五子棋的过程）：

mini-cc> 帮我写一个网页版的五子棋游戏，放在 test_file/gomoku 目录下。页面要好看，带黑白棋提示。 [Agent] 已收到指令，正在思考中... ==================== 思考过程 ==================== 1. 用户需要一个五子棋游戏，包含 HTML/CSS/JS。 2. 目标目录是相对于当前工作目录的 test_file/gomoku。 3. 需要提供漂亮的 UI 界面，以及当前轮到哪一方下棋的提示（如：黑棋先行）。 4. 我将使用 FileWriteTool 分别创建 index.html、style.css 和 script.js。 5. 棋盘可以使用 Canvas 或者 DOM 元素网格来实现，为了简单直观，我这里使用 DOM 网格结合 CSS 样式来实现。 ==================== 模型回复 ==================== 好的，我这就为您创建带有精美 UI 和状态提示的五子棋小游戏。 ▶ [Agent] 正在调用工具: FileWriteTool ... [FileWriteTool] 正在写入文件: /xxxx/mini-cc/test_file/gomoku/index.html ✔ [Agent] 工具 FileWriteTool 执行完毕。 ▶ [Agent] 正在调用工具: FileWriteTool ... [FileWriteTool] 正在写入文件: /xxxx/mini-cc/test_file/gomoku/style.css ✔ [Agent] 工具 FileWriteTool 执行完毕。 ▶ [Agent] 正在调用工具: FileWriteTool ... [FileWriteTool] 正在写入文件: /xxxx/mini-cc/test_file/gomoku/script.js ✔ [Agent] 工具 FileWriteTool 执行完毕。 ==================== 思考过程 ==================== 文件均已创建成功。 ==================== 完整回复 ==================== 五子棋小游戏已经为您创建完成！ 我为您生成了以下文件： 1. `index.html`: 包含游戏棋盘和状态提示栏（`<div class="status" id="status">黑棋先行</div>`）。 2. `style.css`: 提供了木质棋盘配色和黑白棋子的立体阴影效果。 3. `script.js`: 实现了 15x15 的棋盘逻辑、落子交替规则以及横、竖、斜向的五子连珠胜负判断。 您可以直接用浏览器打开 `test_file/gomoku/index.html` 体验游戏！

只需几秒钟，一个带有<div class="status" id="status">黑棋先行</div>状态提示的五子棋网页便自动生成并落盘！