@adversity/coding-tool-x 3.0.4 → 3.0.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -31,6 +31,7 @@
31
31
  | **智能会话管理** | 自动识别 Claude/Codex/Gemini 历史会话,支持命名、搜索、Fork 分支 |
32
32
  | **多渠道负载均衡** | 同时启用多个渠道,按权重自动分配请求,支持并发控制和健康检查 |
33
33
  | **动态渠道切换** | 管理多个 API 渠道,一键切换无需重启,成本优化与稳定性兼得 |
34
+ | **模型智能重定向** | 代理模式下自动将高成本模型重定向到低成本模型(如 opus → sonnet),大幅节省 token 消耗 |
34
35
  | **实时 Token 监控** | 可视化展示每次请求的 Token 消耗(输入/输出/缓存命中) |
35
36
  | **全局搜索** | `⌘/Ctrl + K` 跨项目搜索会话内容,快速定位历史对话 |
36
37
  | **现代化 Web UI** | 响应式设计,支持亮色/暗色主题,三列拖拽排序 |
@@ -200,6 +201,40 @@ ctx
200
201
 
201
202
  </details>
202
203
 
204
+ <details>
205
+ <summary><b>模型智能重定向(节省 Token)</b></summary>
206
+
207
+ 在代理模式下,可以将高成本模型自动重定向到低成本模型,大幅节省 token 消耗。
208
+
209
+ **使用场景**:
210
+ - GitHub 插件或 oh-my-claudecode skills 默认使用 opus 模型
211
+ - 修改插件配置过于复杂,希望透明地降低成本
212
+
213
+ **配置步骤**:
214
+ 1. 启动代理:`ctx proxy start`
215
+ 2. 在 Web UI 中编辑渠道,展开「模型重定向」部分
216
+ 3. 配置重定向规则,例如:
217
+ - **Opus 重定向** → `claude-sonnet-4-5`(将所有 opus 请求重定向到 sonnet)
218
+ - **Sonnet 重定向** → 留空(保持不变)
219
+ - **Haiku 重定向** → 留空(保持不变)
220
+ 4. 保存配置,重定向立即生效
221
+
222
+ **成本节省示例**:
223
+ - Opus → Sonnet:节省约 **80%** 成本($15/M → $3/M 输入,$75/M → $15/M 输出)
224
+ - 对于大量使用 opus 的场景,成本节省非常显著
225
+
226
+ **验证重定向**:
227
+ - 查看代理服务器控制台,会输出重定向日志:
228
+ ```
229
+ [Model Redirect] claude-opus-4-20250514 → claude-sonnet-4-5 (channel: xxx)
230
+ ```
231
+
232
+ > **注意**:模型重定向仅在代理开启时生效。代理关闭时,modelConfig 用于模型映射(写入 settings.json)。
233
+
234
+ 详细文档:[docs/model-redirection.md](docs/model-redirection.md)
235
+
236
+ </details>
237
+
203
238
  <details>
204
239
  <summary><b>后台运行服务</b></summary>
205
240