@kairyou/agent-tools 0.6.0 → 0.7.1

package/README.md

@@ -109,14 +109,12 @@ and never touch your edits or comments.
 For API relay / gateway setups: shows the relay's balance / quota inside the
 agent, so when you pay per use or have plan limits you always know how much you
 have spent and how much is left — without opening the gateway console.
-Works with the usage APIs of Sub2API, NewAPI/OneAPI-family panels (OneHub,
-DoneHub, Veloera, ...), and OpenRouter; compatibility can vary with a
-deployment's version and auth scheme.
+Works with API-key usage endpoints exposed by Sub2API, One API, New API, and
+OpenRouter. Compatibility depends on the gateway version and whether the
+corresponding usage endpoint is enabled.
 
 ```bash
-npx -y @kairyou/agent-tools@latest usage -a claude
-npx -y @kairyou/agent-tools@latest usage -a codex
-npx -y @kairyou/agent-tools@latest usage -a opencode
+npx -y @kairyou/agent-tools@latest usage -a claude codex opencode
 ```
 
 - **Claude Code** — installs the `at-usage` skill into `~/.claude/skills`; invoke
@@ -140,14 +138,17 @@ endpoint and key — and tune `providerUsage` in `~/.agent-tools/config.jsonc`:
 ```jsonc
 {
   "providerUsage": {
-    "preset": "auto", // sub2api | new-api | veloera | openrouter | ...
-    "userId": "",     // some NewAPI/Veloera panels require your panel user id
-    "days": 30,       // spend window for the "30d" field (max 90)
+    "preset": "auto", // auto | sub2api | one-api | new-api | openrouter | <custom-route-id>
+    "days": 30,       // how many recent days of spend to count
     "debug": false    // true: log probes to ~/.agent-tools/logs/usage-debug.log
   }
 }
 ```
 
+Keep `preset` set to `auto` for automatic detection. Select a specific protocol
+only when you know which usage endpoint the gateway exposes; a configured
+custom route id is also accepted.
+
 #### Custom gateway routes
 
 For gateways the built-in probes cannot reach (e.g. cookie-authenticated
@@ -217,8 +218,7 @@ Lets a main model that cannot see images ask a multimodal model specific questio
 #### Install
 
 ```bash
-npx -y @kairyou/agent-tools@latest vision -a claude
-npx -y @kairyou/agent-tools@latest vision -a codex claude opencode
+npx -y @kairyou/agent-tools@latest vision -a claude codex opencode
 ```
 
 Uninstalling keeps your vision provider config. The installer registers the

package/README.zh-CN.md

@@ -102,13 +102,11 @@ npx -y @kairyou/agent-tools@latest statusline -a claude
 
 面向使用 API 中转的场景: 在 agent 内直接显示中转网关的余额/额度, 按量付费或
 有套餐限额时, 随时知道花了多少, 还剩多少, 不用切出去登录网关后台.
-支持 Sub2API, NewAPI/OneAPI 系面板 (OneHub, DoneHub, Veloera 等)
-与 OpenRouter 的用量接口; 同类网关的部署版本和鉴权方式不同, 兼容性可能有差异.
+支持 Sub2API, One API, New API 与 OpenRouter 提供的 API Key 用量接口.
+具体兼容性取决于网关版本及其是否开放相应接口.
 
 ```bash
-npx -y @kairyou/agent-tools@latest usage -a claude
-npx -y @kairyou/agent-tools@latest usage -a codex
-npx -y @kairyou/agent-tools@latest usage -a opencode
+npx -y @kairyou/agent-tools@latest usage -a claude codex opencode
 ```
 
 - **Claude Code** — 把 `at-usage` skill 装入 `~/.claude/skills`; 调用
@@ -130,14 +128,16 @@ provider 的 `base_url` 和密钥; Claude Code: 读取 `ANTHROPIC_BASE_URL` 与
 ```jsonc
 {
   "providerUsage": {
-    "preset": "auto", // sub2api | new-api | veloera | openrouter | ...
-    "userId": "",     // 部分 NewAPI/Veloera 面板需要填面板用户 id
-    "days": 30,       // "30d" 字段的统计窗口(最大 90)
+    "preset": "auto", // auto | sub2api | one-api | new-api | openrouter | <自定义 route id>
+    "days": 30,       // 统计最近多少天的消耗
     "debug": false    // true: 探测过程写入 ~/.agent-tools/logs/usage-debug.log
   }
 }
 ```
 
+保持 `preset: "auto"` 即可自动探测. 只有明确知道网关开放的是哪种用量协议时,
+才指定相应的内置 preset 或已配置的自定义 route id.
+
 #### 自定义网关路由
 
 内置探测覆盖不到的网关(比如 cookie 认证的中转), 可以自己写路由模块并在
@@ -204,8 +204,7 @@ API | balance $362 | today $61.7 | 30d $566
 #### 安装
 
 ```bash
-npx -y @kairyou/agent-tools@latest vision -a claude
-npx -y @kairyou/agent-tools@latest vision -a codex claude opencode
+npx -y @kairyou/agent-tools@latest vision -a claude codex opencode
 ```
 
 卸载默认保留 vision provider 配置. 安装器会为每个 agent 注册 `inspect_image`