@unitsvc/cc-helper 1.0.15 → 1.0.16

package/README-zh.md

@@ -6,7 +6,7 @@
 
 [**English**](./README.md) | **简体中文**
 
-> ⚡ 一键启用 Claude Code CLI 的隐藏功能：`/loop` 和 `/btw`
+> ⚡ 一键启用 Claude Code CLI 的隐藏功能：`/loop`、`/btw` 和 `MCPSearch`
 
 ## 环境要求
 
@@ -20,9 +20,14 @@ npm install -g @anthropic-ai/claude-code@v2.1.71
 ## 使用方法
 
 ```bash
-# 启用所有功能（默认）
+# 启用默认功能（/loop, /btw）
 npx @unitsvc/cc-helper enable
 
+# 启用特定功能
+npx @unitsvc/cc-helper enable loop
+npx @unitsvc/cc-helper enable btw
+npx @unitsvc/cc-helper enable toolsearch
+
 # 查看状态
 npx @unitsvc/cc-helper status
 
@@ -30,25 +35,16 @@ npx @unitsvc/cc-helper status
 npx @unitsvc/cc-helper disable
 ```
 
-### 代理支持
-
-如果下载失败，使用 `--proxy` 参数：
-
-```bash
-# 使用默认代理 (https://edgeone.gh-proxy.org)
-npx @unitsvc/cc-helper --proxy enable
-
-# 使用自定义代理
-npx @unitsvc/cc-helper --proxy https://your-proxy.com enable
-```
-
 ### 命令说明
 
-| 命令      | 说明                    |
-| --------- | ----------------------- |
-| `enable`  | 启用 `/loop` 和 `/btw` 功能 |
-| `disable` | 恢复原始状态            |
-| `status`  | 查看当前状态            |
+| 命令 | 说明 |
+|---------|-------------|
+| `enable` | 启用 `/loop` 和 `/btw` 功能（默认，不包含 toolsearch） |
+| `enable loop` | 仅启用 `/loop` 功能 |
+| `enable btw` | 仅启用 `/btw` 功能 |
+| `enable toolsearch` | 启用 toolsearch 功能（需要显式激活） |
+| `disable` | 恢复原始状态 |
+| `status` | 查看当前状态及版本要求 |
 
 ## 赞助
 
@@ -132,13 +128,75 @@ cancel the deploy check job       # 按描述或 ID 取消
 /btw 为什么这里要用 async/await？
 ```
 
+## 什么是工具搜索？
+
+工具搜索（Tool Search）是一项允许 Claude 在运行时动态搜索和加载工具的功能，而不是一次性发送所有工具定义。这可以节省 token 并提高性能。
+
+### 为什么为第三方 API 启用？
+
+默认情况下，Claude Code 在使用第三方 API 代理（如 Kimi、自定义端点）时会禁用工具搜索。此功能修改该行为，为这些代理启用工具搜索。
+
+### 优势
+
+- **Token 效率**：减少大型 MCP 工具目录的上下文窗口占用
+- **性能提升**：延迟加载工具，响应更快
+- **代理兼容**：支持 Kimi 和其他第三方 Claude API 提供商
+
+### 要求
+
+- 您的代理必须支持 API 响应中的 `tool_reference` 块
+- 仅支持 Claude Sonnet 4+ 和 Opus 4+ 模型（不支持 Haiku）
+
+### 配置说明
+
+使用官方 Anthropic API 时，工具搜索默认启用。但当 `ANTHROPIC_BASE_URL` 指向非第一方主机时，工具搜索默认禁用（大多数代理不转发 `tool_reference` 块）。
+
+通过 `ENABLE_TOOL_SEARCH` 环境变量控制工具搜索行为：
+
+| 值         | 行为                                                   |
+| ---------- | ------------------------------------------------------ |
+| （未设置） | 默认启用。当 `ANTHROPIC_BASE_URL` 为非第一方主机时禁用 |
+| `true`     | 始终启用，包括非第一方 `ANTHROPIC_BASE_URL`            |
+| `auto`     | 当 MCP 工具超过上下文 10% 时激活                       |
+| `auto:<N>` | 自定义阈值激活（如 `auto:5` 表示 5%）                  |
+| `false`    | 禁用，所有 MCP 工具预先加载                            |
+
+**示例：**
+
+```bash
+# 使用 5% 自定义阈值
+ENABLE_TOOL_SEARCH=auto:5 claude
+
+# 完全禁用工具搜索
+ENABLE_TOOL_SEARCH=false claude
+
+# 始终启用（适用于支持 tool_reference 的代理）
+ENABLE_TOOL_SEARCH=true claude
+```
+
+或在 `settings.json` 的 env 字段中设置。
+
+#### 禁用 MCPSearch 工具
+
+您还可以使用 `disallowedTools` 设置专门禁用 `MCPSearch` 工具：
+
+```json
+{
+  "permissions": {
+    "deny": ["MCPSearch"]
+  }
+}
+```
+
 ## 功能特点
 
-- 一键启用 `/loop` 和 `/btw` 功能
+- 一键启用 `/loop`、`/btw` 功能（toolsearch 需要显式激活）
+- 可单独启用特定功能
 - 轻松恢复原始状态
 - 自动备份原文件
 - 零运行时依赖
 - 跨平台支持
+- 支持版本：2.1.71、2.1.72、2.1.73、2.1.74
 
 ### 示例
 

package/README.md

@@ -6,7 +6,7 @@
 
 **English** | [**简体中文**](./README-zh.md)
 
-> ⚡ Enable hidden features in Claude Code CLI with one command: `/loop` and `/btw`
+> ⚡ Enable hidden features in Claude Code CLI with one command: `/loop`, `/btw`, and `MCPSearch`
 
 ## Requirements
 
@@ -20,9 +20,14 @@ npm install -g @anthropic-ai/claude-code@v2.1.71
 ## Usage
 
 ```bash
-# Enable all features (default)
+# Enable default features (/loop, /btw)
 npx @unitsvc/cc-helper enable
 
+# Enable specific features
+npx @unitsvc/cc-helper enable loop
+npx @unitsvc/cc-helper enable btw
+npx @unitsvc/cc-helper enable toolsearch
+
 # Check status
 npx @unitsvc/cc-helper status
 
@@ -32,11 +37,14 @@ npx @unitsvc/cc-helper disable
 
 ### Commands
 
-| Command   | Description              |
-| --------- | ------------------------ |
-| `enable`  | Enable `/loop` and `/btw` features |
-| `disable` | Restore original         |
-| `status`  | Check current status     |
+| Command             | Description                                                       |
+| ------------------- | ----------------------------------------------------------------- |
+| `enable`            | Enable `/loop` and `/btw` features (default, excludes toolsearch) |
+| `enable loop`       | Enable only `/loop` feature                                       |
+| `enable btw`        | Enable only `/btw` feature                                        |
+| `enable toolsearch` | Enable toolsearch feature (requires explicit activation)          |
+| `disable`           | Restore original                                                  |
+| `status`            | Check current status with version requirements                    |
 
 ### Proxy Support
 
@@ -132,13 +140,75 @@ cancel the deploy check job       # Cancel by description or ID
 /btw why use async/await in this case?
 ```
 
+## What is Tool Search?
+
+Tool Search is a feature that allows Claude to dynamically search and load tools at runtime instead of sending all tool definitions upfront. This saves tokens and improves performance.
+
+### Why Enable for Third-Party APIs?
+
+By default, Claude Code disables Tool Search when using third-party API proxies (like Kimi, custom endpoints). This feature patches that behavior to enable Tool Search for these proxies.
+
+### Benefits
+
+- **Token efficiency**: Reduces context window usage for large MCP tool catalogs
+- **Better performance**: Faster response times with deferred tool loading
+- **Proxy compatibility**: Works with Kimi and other third-party Claude API providers
+
+### Requirements
+
+- Your proxy must support `tool_reference` blocks in API responses
+- Works with Claude Sonnet 4+ and Opus 4+ models (not Haiku)
+
+### Configuration
+
+Tool Search is enabled by default when using official Anthropic APIs. However, when `ANTHROPIC_BASE_URL` points to a non-first-party host, Tool Search is disabled by default (most proxies do not forward `tool_reference` blocks).
+
+Control Tool Search behavior using the `ENABLE_TOOL_SEARCH` environment variable:
+
+| Value      | Behavior                                                                         |
+| ---------- | -------------------------------------------------------------------------------- |
+| (unset)    | Enabled by default. Disabled when `ANTHROPIC_BASE_URL` is a non-first-party host |
+| `true`     | Always enabled, including for non-first-party `ANTHROPIC_BASE_URL`               |
+| `auto`     | Activates when MCP tools exceed 10% of context                                   |
+| `auto:<N>` | Activates at custom threshold (e.g., `auto:5` for 5%)                            |
+| `false`    | Disabled, all MCP tools loaded upfront                                           |
+
+**Examples:**
+
+```bash
+# Use custom 5% threshold
+ENABLE_TOOL_SEARCH=auto:5 claude
+
+# Disable tool search entirely
+ENABLE_TOOL_SEARCH=false claude
+
+# Always enable (useful for proxies that support tool_reference)
+ENABLE_TOOL_SEARCH=true claude
+```
+
+Or set the value in your `settings.json` env field.
+
+#### Disabling MCPSearch Tool
+
+You can also disable the `MCPSearch` tool specifically using the `disallowedTools` setting:
+
+```json
+{
+  "permissions": {
+    "deny": ["MCPSearch"]
+  }
+}
+```
+
 ## Features
 
-- Enable `/loop` and `/btw` with one command
+- Enable `/loop`, `/btw`, and toolsearch with one command
+- Enable specific features individually
 - Easy restore functionality
 - Automatic backup
 - Zero runtime dependencies
 - Cross-platform support
+- Version support: 2.1.71, 2.1.72, 2.1.73, 2.1.74
 
 ### Examples
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unitsvc/cc-helper",
-  "version": "1.0.15",
+  "version": "1.0.16",
   "description": "Claude Code /loop feature bypass tool",
   "main": "dist/index.js",
   "bin": {
@@ -14,10 +14,8 @@
   },
   "keywords": [
     "claude code",
-    "claude",
     "loop",
-    "cli",
-    "zai"
+    "cli"
   ],
   "author": "next-bin",
   "license": "AGPL-3.0",