嗨，老友！今天聊聊那个叫mini‑cc的神器，它是怎么让AI跑起来的。

你想象一下AI本来只会说话，突然Neng直接读写文件、跑脚本，那可就像给它装了发动机。 在mini‑cc里这一步叫Zuo工具调用。 每个工具dou有一个统一接口：{name:string, description:string, inputSchema:any, execute:=>Promise}。 这样LLM就Neng知道“我需要执行一个FileReadTool”，然后把参数传进去。

所有可用工具dou放在一个数组里叫Zuotools。 当启动时系统会遍历这个数组，把每个tool的名字和描述塞进提示词，让模型知道Neng用什么。 Ru果你想加新工具，只需写一个符合接口的文件，然后在注册中心导入即可——不需要改核心代码。

AICPU没那么靠谱，所以我们给敏感操作加了门槛。 我们把工具分成两类：SAFE和SENSITIVE。SAFEKe以直接执行；SENSITIVE需要用户手动授权，如

例子：

const SAFE_TOOLS = new Set;
const SENSITIVE_TOOLS = new Set;

Ru果你问AI “跑个ls”，它会先检查是否在SENSITIVE里；Ru果是就会弹出“请 /allow BashTool”。咱就是说这点hen重要，因为不然AI可Neng误删文件。

嘿，你可Neng会问，“为什么百度不收录这篇文章？”其实啊，百度爬虫geng爱抓传统网页，而我们的内容是纯粹技术博客，结构化程度高、关键词密度低，不太符合搜索引擎偏好。另外我们没有外链，也没有太多社交媒体曝光，导致抓取频率低。

以前我直接在工具里读全局状态，单测时结果乱套——全靠外部变量。后来改成依赖注入：Agent调用tool时把context传进去。这样就Neng把工作目录、权限等信息集中管理，而不是硬编码。

MCP协议：

export const fileReadTool: Tool<{file_path:string},string> = {
 name:'FileReadTool',
 description:'读取文件内容',
 execute: async=>{
   const path = args.file_path.startsWith ? args.file_path : `${workspaceDir}/${args.file_path}`;
   return await fs.readFile;
 }
};

No URL here—just pure code.

MCP让我们Ke以从服务器拉取新的tool，而不用重启应用。只要服务器端发布了JSON描述，客户端就Neng自动包装成可调用对象并注入到tools数组里。

AICPU对话里它Ke以展示reasoning_content，让你kan到模型思考过程，好像kan见它的大脑转动。

AIs收到用户输入后把文本交给LLM生成动作列表。

LMM返回需要执行的tool名和参数。

AICPU检查权限；若通过就调用对应tool；若未授权，则提示用户手动允许。

常见坑与经验分享

- 别忘了路径校验，否则相对路径会跑到根目录导致404。

- 在调试时用console.log打印contextKe以帮你快速定位问题。

- Ru果遇到权限被拦截，Ke以先跑一次/allow BashTool;之后同一会话内就无需再授权。哈哈，有点像游戏里的钥匙系统哦！