🚀 10x-Tool-Calls

10x-Tool-Calls 是一套为 Cursor IDE、Windsurf 或任何支持工具调用的代理型编码助手设计的简单规则配置。它通过在用户输入的基础上循环执行任务，帮助你充分利用每月的工具调用额度——而无需每次都重新开始对话。

注意：此功能仅适用于代理模式。

✅ 功能简介

• 当 AI 完成一项任务后，会运行一段小型 Python 脚本，提示如下：

提示：

• 你可以输入下一条指令（例如：“添加注释”、“重构这段代码”等）。
• AI 将根据你的输入继续工作。
• 这一循环会持续进行，直到：
• 你手动停止，或
• 会话达到你的 工具调用上限。

---

💡 为什么重要

大多数 AI 编码工具（如 Cursor）提供每月 500 次请求，而每次请求最多可包含 25 次工具调用。通常情况下，即使只是说一句“你好”，也会消耗掉一次完整的请求，从而浪费了潜在的机会。

使用 10x-Tool-Calls：

• 你只需发起一次请求。
• 在该会话中，你可以多次给出后续指令。
• 所有后续指令都会在同一请求内利用剩余的工具调用次数执行。
• 这意味着你可以用同样的配额完成 10 倍甚至更多的实际工作。

---

⚙️ 如何设置（基础版）

1. 将 userinput.py 复制到你的项目根目录

该脚本用于在任务之间收集用户输入。

2. 将 rules.md 复制到你的 IDE 中

• 打开 IDE 的规则配置界面（例如，在 Cursor 中：.cursorrules 文件或项目规则，并设置为“始终启用”）。
• 将 rules.md 中的规则粘贴进去（该文件包含在本仓库中）。

这样就完成了设置！系统现在将以交互式循环模式运行。

---

🧪 当前版本

• ✅ 支持： 仅支持纯文本输入
• ❌ 暂不支持： 图片上传或文件拖放（即将推出！）

我们计划推出更高级的版本，支持以下功能：

• 图片上传
• 文件拖放

---

⚠️ 重要提示

请仅将此配置用于基于工具调用计费的工具，而非基于 Token 计费的工具（如 OpenAI 的按 Token 收费模式）。此配置旨在 最大化工具调用的使用效率，而非减少 Token 的消耗。

---

🧠 示例

假设你每月有 500 次请求，且每次请求最多可使用 25 次工具调用：

• 通常情况： 你说“你好” → AI 回复“你好” = 消耗 1 次请求。

• 使用 10x-Tool-Calls： 你说“你好” → AI 回复 → 执行提示 → 你说“添加注释” → AI 继续...（最多可执行 25 次调用） = 仍然 只消耗 1 次请求，但你完成了更多的工作。

---

完成更多任务，减少请求次数，节省配额。

→ 这就是 10x-Tool-Calls 的强大之处。

如果你有任何其他需求，请告诉我。

支持

如果你觉得这个工具很有帮助，可以通过以下方式支持开发：

• 在 https://ko-fi.com/perrypixel 上请我喝杯咖啡。
• 通过 UPI 向 kevinp@apl 转账。

10x-Tool-Calls 快速上手指南

10x-Tool-Calls 是一套专为 Cursor IDE、Windsurf 或其他支持工具调用（Tool Calls）的 AI 编程助手设计的规则配置。它通过在单次请求中构建交互式循环，让你在不重启对话的情况下连续下达指令，从而最大化利用每月的工具调用额度（例如将原本只能做 1 次任务的配额提升至 25 次以上）。

注意：本方案仅适用于 Agent Mode（代理模式），且适合按“请求次数”而非“ Token 用量”计费的场景。

---

🛠️ 环境准备

在开始之前，请确保满足以下条件：

• 操作系统：Windows / macOS / Linux（需支持 Python 运行）
• 核心依赖：
  • 已安装 Python 3.x 并确保 python 命令可用。
  • 已安装支持 Agent Mode 的 IDE（推荐 Cursor 或 Windsurf）。
• 账号要求：拥有包含每月固定请求次数（如 500 次/月）且每次请求允许多次工具调用的 AI 服务订阅。

---

📥 安装步骤

本项目无需复杂的包管理安装，只需将两个核心文件放入你的项目根目录并配置规则即可。

1. 获取核心文件

从 10x-Tool-Calls GitHub 仓库 下载以下两个文件，或直接复制其内容：

• userinput.py
• rules.md

2. 部署脚本

将 userinput.py 复制到你的项目根目录下。 该脚本用于在 AI 完成任务后暂停并等待你的下一条指令。

# 示例：假设你已下载文件到当前文件夹
cp userinput.py /path/to/your/project/root/

3. 配置 IDE 规则

将 rules.md 中的内容复制到你的 IDE 规则配置文件中：

• 对于 Cursor:

  1. 在项目根目录创建或编辑 .cursorrules 文件。
  2. 或者在设置中找到 "Project Rules" 并设置为 "Always"。
  3. 粘贴 rules.md 的全部内容。

• 对于 Windsurf:

  1. 打开规则配置界面。
  2. 粘贴 rules.md 的全部内容。

---

🚀 基本使用

配置完成后，启动 IDE 的 Agent Mode 即可开始高效工作。

使用流程示例

1. 发起初始任务 在对话框中输入你的第一个需求，例如：

   帮我创建一个简单的 Python Flask 应用骨架
   

2. 自动进入循环 AI 执行任务后，会自动运行 userinput.py 脚本，并在终端或对话框中提示你输入下一步指令（通常显示为 prompt:）。

3. 连续下达指令 直接输入后续需求，无需重新开始对话。例如：

   add comments to the main file
   

   或

   refactor the database connection logic
   

4. 重复操作 AI 会根据你的新指令继续工作，完成后再次等待输入。此过程会一直持续，直到：

   • 你手动停止会话。
   • 单次请求达到了工具调用上限（通常为 25 次）。

💡 效果对比

• 传统模式：说 "Hi" -> AI 回复 -> 消耗 1 次请求配额。
• 10x-Tool-Calls 模式：说 "Hi" -> AI 回复 -> 自动询问下一步 -> 你说 "加注释" -> AI 执行 -> 自动询问下一步 -> 你说 "重构代码" ... -> 仅消耗 1 次请求配额，但完成了多项任务。

通过这种方式，你可以用同样的月度配额完成 10 倍甚至更多 的实际工作量。