说实话，mini-cursor 实现从 Tool 到 Agent 的循环，这个过程挺有意思的，咱就是说它不是简单的工具调用，而是形成了一个闭环，你懂的。

const executeCommandTool = tool => { const cwd = workingDirectory || process.cwd; return new Promise => { const = command.split; const child = spawn; child.on => { if { resolve; } else { process.exit; // 失败直接退出整个进程 } }); }); }, { name: 'execute_command', description: '执行系统命令，支持指定工作目录，实时显示输出', schema: z.object.describe, workingDirectory: z.string.optional.describe }) })

这个工具有几个设计要点值得展开：

const readFileTool = tool => { const content = await fs.readFile; return `文件内容: ${content}`; }, { name: 'read_file', description: '读取指定路径的文件内容', schema: z.object.describe }) })

Zui朴素的工具，但注意返回值被包了一层 文件内容: 前缀——这是给模型kan的"格式化标签"，帮助它区分"这是文件内容"和"这是系统消息"。

System Prompt 里的正反示例说明了一个重要经验：工具设计的问题，hen多时候要在 Prompt 层面解决，而不是代码层面。工具的参数 schema 只管类型，管不了"参数的语义正确性"——后者只Neng靠 Prompt 教育模型。

害，为啥百度不收录我的文章呢？有人说是内容质量问题，有人说是 robots.txt 配置问题，说实话，我也不太清楚，咱就是说得一个个排查吧。

const writeFileTool = tool => { const dir = path.dirname; await fs.mkdir; // 关键！ await fs.writeFile; return `文件写入成功: ${filePath}`; }, { ... })

这里的巧思是 fs.mkdir。模型在写文件时可Neng写出这样的路径：src/components/TodoList.tsx。Ru果 src/components/ 目录不存在普通 writeFile 会直接报错。加上自动递归创建目录后AI Ke以放心地写任意深度的文件路径，不用先手动建目录。

📝 任务: "创建一个 React TodoList 应用"━━━ 第 1 轮 ━━━模型思考: 我需要先创建项目tool_call → execute_command工具执行: ✅ Vite 项目创建成功message 状态: ━━━ 第 2 轮 ━━━模型思考: 项目创建好了现在修改 App.tsxtool_call → read_file工具执行: ✅ 读取到默认模板代码message 状态: ━━━ 第 3 轮 ━━━模型思考: 我kan到了模板代码，现在重写它，实现增删改查+筛选+持久化tool_call → write_file工具执行: ✅ 文件写入成功message 状态: ━━━ 第 4 轮 ━━━模型思考: 代码写完了需要添加样式tool_call → write_file工具执行: ✅ 样式写入成功━━━ 第 5 轮 ━━━模型思考: 确认文件dou在然后安装依赖tool_call → list_directory工具执行: ✅ App.tsx, App.css, main.tsx...tool_call → execute_command工具执行: ✅ 依赖安装完成━━━ 第 6 轮 ━━━模型思考: 一切就绪，启动开发服务器tool_call → execute_command工具执行: ✅ Vite 开发服务器启动在 localhost:3000━━━ 第 7 轮 ━━━模型思考: 任务完成，不需要再调用工具了response.content → "Yi创建功Neng丰富的 TodoList 应用，包含增删改查、筛选..."response.tool_calls → undefined ← 循环终止

每一轮，模型dou在观察 → 规划 → 行动 → 观察结果 → 调整计划。这就是 Agent 的"思考-行动循环"。

const listDirectoryTool = tool => { const files = await fs.readdir; return `目录内容： ${files.map.join}`; }, { name: 'list_directory', description: '列出指定目录下所有文件和文件夹', schema: z.object.describe }) })

Zui轻量的工具，但它的存在hen重要——它是 AI 验证自己工作成果的唯一手段。AI 写完文件后调用 list_directory，就Neng确认"我真的创建成功了"。

"眼睛+ 手= 一个完整的开发者。"

┌─────────────┐ │ list_dir │ ← "眼睛"：kankan有什么 └─────────────┘ ┌─────────────┐ │ read_file │ ← "眼睛"：kankan里面是什么 └─────────────┘ ┌─────────────┐ │ write_file │ ← "手"：创造/修改文件 └─────────────┘ ┌─────────────┐ │exec_command │ ← "手"：执行命令 └─────────────┘

"为什么百度不收录某些网站？" , 有人说是网站结构问题，有人说是内容原创性不够，说实话，这些说法dou有一定道理，但具体到某个网站，还是得具体分析才行。

"maxIterations = ?", 这个值设多少合适呢？太低了复杂任务完不成，太高了可Neng浪费资源。它体现了 Agent 设计的核心权衡："自主性 vs.安全性".

"自主性 vs.安全性", 这是一个hen有意思的话题。你希望你的 Agent Neng自主完成任务，但又担心它会出问题。所以这个maxIterations= ? 就hen重要了.

总之呢，就是这样啦~你懂的~