@foxden-app/foxclaw 0.4.11 → 0.4.12

package/CHANGELOG.md

@@ -2,6 +2,16 @@
 
 All notable FoxClaw changes are listed here. Each release note is bilingual so GitHub Releases and the npm package are useful to both Chinese and English readers.
 
+## 0.4.12 - 2026-06-02
+
+### 中文
+- `/auth` 面板顶部、候选列表和切换按钮省略标准候选名中重复的 `auth.json_` 前缀，让额度与账号标识在窄屏 Telegram 客户端中更容易完整显示。
+- 磁盘文件名、文件名搜索、候选编号、切换和镜像同步行为保持不变；非标准候选名仍原样展示。
+
+### English
+- Omitted the repeated `auth.json_` prefix from the `/auth` panel header, candidate rows, and switch buttons so quota and account labels fit better in narrow Telegram clients.
+- Kept filenames on disk, filename search, candidate numbering, switching, and mirroring unchanged. Non-standard candidate names still render verbatim.
+
 ## 0.4.11 - 2026-06-02
 
 ### 中文

package/README.md

@@ -128,7 +128,7 @@ FoxClaw 的一大特色是自动多账号切换。当一个账号触发用量限
 3. 用 `/auth` 查看所有候选账号状态。
 4. 用 `/auth enable <n>` / `/auth disable <n>` 控制哪些账号参与自动轮换。
 
-候选较多时，`/auth` 每页显示 8 个账号，并提供翻页、`全部 / 已启用 / 需关注` 筛选。也可以用 `/auth list <关键词>` 搜索文件名，或用 `/auth page <页码>` 直接跳页。额度窗口按 Codex 实际返回值展示，例如 `5h:20|7d:25` 或单月窗口 `30d:97`。
+候选较多时，`/auth` 每页显示 8 个账号，并提供翻页、`全部 / 已启用 / 需关注` 筛选。也可以用 `/auth list <关键词>` 搜索文件名，或用 `/auth page <页码>` 直接跳页。额度窗口按 Codex 实际返回值展示，例如 `5h:20|7d:25` 或单月窗口 `30d:97`。面板会省略候选名中重复的 `auth.json_` 前缀，磁盘文件名保持不变。
 
 当 Codex 报告用量限制错误时，FoxClaw 会自动：
 - 切换到下一个未失败的候选账号

package/README_EN.md

@@ -128,7 +128,7 @@ Setup:
 3. Use `/auth` to view all candidate account statuses.
 4. Use `/auth enable <n>` / `/auth disable <n>` to control which accounts participate in auto-rotation.
 
-For larger inventories, `/auth` shows 8 candidates per page with paging and `All / Enabled / Attention` filters. Use `/auth list <keyword>` to search filenames or `/auth page <n>` to jump directly. Quota windows use the values reported by Codex, for example `5h:20|7d:25` or a single monthly window such as `30d:97`.
+For larger inventories, `/auth` shows 8 candidates per page with paging and `All / Enabled / Attention` filters. Use `/auth list <keyword>` to search filenames or `/auth page <n>` to jump directly. Quota windows use the values reported by Codex, for example `5h:20|7d:25` or a single monthly window such as `30d:97`. The panel omits the repeated `auth.json_` prefix from candidate labels without renaming files on disk.
 
 When Codex reports a usage-limit error, FoxClaw automatically:
 - Switches to the next non-failed candidate account

package/dist/controller/controller.js

@@ -7785,7 +7785,11 @@ function renderAuthListMessage(locale, state, botLabel = null, includeWeixinCopy
     if (botLabel) {
         lines.push(t(locale, 'auth_bot', { value: botLabel }));
     }
-    lines.push(t(locale, 'auth_current', { value: state.currentLabel ?? t(locale, 'none') }), t(locale, 'auth_dir', { value: state.authDir }));
+    lines.push(t(locale, 'auth_current', {
+        value: state.currentLabel
+            ? formatCodexAuthCandidateDisplayName(state.currentLabel)
+            : t(locale, 'none'),
+    }), t(locale, 'auth_dir', { value: state.authDir }));
     if (state.candidates.length === 0) {
         lines.push(t(locale, 'auth_no_candidates'));
         if (includeWeixinCopyPaste) {
@@ -7817,7 +7821,7 @@ function renderAuthListMessage(locale, state, botLabel = null, includeWeixinCopy
     }
     page.visible.forEach(({ candidate, index }) => {
         const marker = candidate.isCurrent ? ' *' : '';
-        lines.push(`${index + 1}. ${formatAuthQuotaPrefix(locale, candidate.quota)}|${candidate.name}${marker} ${formatCodexAuthCandidateStatus(locale, candidate)}`);
+        lines.push(`${index + 1}. ${formatAuthQuotaPrefix(locale, candidate.quota)}|${formatCodexAuthCandidateDisplayName(candidate.name)}${marker} ${formatCodexAuthCandidateStatus(locale, candidate)}`);
     });
     if (includeWeixinCopyPaste) {
         lines.push('', t(locale, 'weixin_copy_paste_divider'), t(locale, 'weixin_copy_auth_title'), ...page.visible.map(({ index }) => `/auth use ${index + 1}`), ...page.visible.map(({ candidate, index }) => candidate.disabled
@@ -7830,7 +7834,7 @@ function authChoiceKeyboard(locale, record) {
     const page = codexAuthListPage(record.candidates, record);
     const rows = page.visible.map(({ candidate, index }) => [
         {
-            text: clipButtonText(`${candidate.isCurrent ? '✅ ' : '🔐 '}${formatAuthQuotaPrefix(locale, candidate.quota)}|${candidate.name}${candidate.disabled ? ' · off' : ''}`),
+            text: clipButtonText(`${candidate.isCurrent ? '✅ ' : '🔐 '}${formatAuthQuotaPrefix(locale, candidate.quota)}|${formatCodexAuthCandidateDisplayName(candidate.name)}${candidate.disabled ? ' · off' : ''}`),
             callback_data: `auth:${record.localId}:${index}`,
         },
         {
@@ -7863,6 +7867,12 @@ function authChoiceKeyboard(locale, record) {
     rows.push([{ text: t(locale, 'button_auth_reload'), callback_data: `auth:${record.localId}:reload` }]);
     return rows;
 }
+function formatCodexAuthCandidateDisplayName(name) {
+    const prefix = 'auth.json_';
+    return name.length > prefix.length && name.startsWith(prefix)
+        ? name.slice(prefix.length)
+        : name;
+}
 function authFilterButton(locale, record, filter) {
     const label = t(locale, `button_auth_filter_${filter}`);
     return {

package/docs/user-manual.md

@@ -389,7 +389,7 @@ If the login is cancelled or fails, FoxClaw tries to restore the previous auth t
 
 ### 6.3 The `/auth` Panel
 
-`/auth` lists candidate accounts, the current account, and the auth directory. It also provides buttons for switching, disabling, login, and reload. In multi-bot mode the panel names the `@botname` runtime being managed, because private chats, groups, and topics on one bot share that bot's current auth. The panel shows 8 candidates per page and supports paging, `All / Enabled / Attention` filters, and `/auth list <keyword>` filename search for large local inventories. `/auth use <n>` always uses the full-list candidate number, independent of panel paging.
+`/auth` lists candidate accounts, the current account, and the auth directory. It also provides buttons for switching, disabling, login, and reload. In multi-bot mode the panel names the `@botname` runtime being managed, because private chats, groups, and topics on one bot share that bot's current auth. The panel shows 8 candidates per page and supports paging, `All / Enabled / Attention` filters, and `/auth list <keyword>` filename search for large local inventories. Panel text and buttons omit the repeated `auth.json_` prefix from standard candidate filenames, so `auth.json_personal` on disk renders as `personal`; files are not renamed, and search and commands still operate on the original candidates. `/auth use <n>` always uses the full-list candidate number, independent of panel paging.
 
 Each filename is prefixed with observed `window:remaining-percent` values. For example, a Plus account may show `5h:20|7d:25`, while an account with one monthly window may show `30d:97`. The current auth quota is refreshed when the panel opens; other candidates are not switched merely to query quota. When multiple bot runtimes have recently used the same ChatGPT account, FoxClaw combines their cached quota snapshots by verified account ID, so one bot's `/auth` panel can show quota information learned by another bot without mixing different accounts.
 
@@ -397,15 +397,15 @@ Approximation:
 
 ```text
 Codex auth
-Current: auth.json_personal
+Current: personal
 Auth dir: /home/alice/.codex
 Candidates: 2
 Quota remaining: window:percent|auth
-1. 5h:20|7d:25|auth.json_personal * [Plus · ready · refreshed 2h ago]
-2. --|auth.json_team [quota unknown]
+1. 5h:20|7d:25|personal * [Plus · ready · refreshed 2h ago]
+2. --|team [quota unknown]
 
-[✅ 5h:20|7d:25|auth.json_personal] [✅]
-[🔐 --|auth.json_team]              [✅]
+[✅ 5h:20|7d:25|personal] [✅]
+[🔐 --|team]              [✅]
 [☑️ All] [Enabled] [Attention]
 [🛡️ Access]             [🔑 Login]
 [🔄 Reload auth]

package/docs/zh/user-manual.md

@@ -389,7 +389,7 @@ cp -L ~/.codex/auth.json ~/.codex/auth.json_personal
 
 ### 6.3 `/auth` 面板
 
-`/auth` 会列出候选账号、当前账号和 auth 目录，并提供按钮切换、禁用、登录和重载。多 bot 模式中，面板顶部还会显示当前正在管理的 `@botname`，因为该 bot 内的私聊、群聊和话题共享同一个当前 auth。面板每页显示 8 个候选，支持翻页、`全部 / 已启用 / 需关注` 筛选和 `/auth list <关键词>` 文件名搜索，适合管理较大的本地候选清单。命令 `/auth use <n>` 的编号始终对应完整候选列表，不会因为分页变化。
+`/auth` 会列出候选账号、当前账号和 auth 目录，并提供按钮切换、禁用、登录和重载。多 bot 模式中，面板顶部还会显示当前正在管理的 `@botname`，因为该 bot 内的私聊、群聊和话题共享同一个当前 auth。面板每页显示 8 个候选，支持翻页、`全部 / 已启用 / 需关注` 筛选和 `/auth list <关键词>` 文件名搜索，适合管理较大的本地候选清单。面板文本和按钮会省略标准候选文件名中重复的 `auth.json_` 前缀，例如磁盘上的 `auth.json_personal` 显示为 `personal`；文件本身不会重命名，搜索和命令仍按原候选工作。命令 `/auth use <n>` 的编号始终对应完整候选列表，不会因为分页变化。
 
 每个候选名前的 `窗口:剩余百分比` 来自最近一次观察到的真实额度窗口，例如 Plus 账号可能显示 `5h:20|7d:25`，只有一个月度窗口的账号可能显示 `30d:97`。当前 auth 会在打开面板时刷新额度；其他候选不会为了查询额度被自动切换。如果多个 bot runtime 最近使用过同一个 ChatGPT 账号，FoxClaw 会按已验证的账号 ID 合并它们缓存到的额度快照，因此一个 bot 的 `/auth` 面板可以显示另一个 bot 掌握到的额度信息，同时不会把不同账号混在一起。
 
@@ -397,15 +397,15 @@ cp -L ~/.codex/auth.json ~/.codex/auth.json_personal
 
 ```text
 Codex auth
-Current: auth.json_personal
+Current: personal
 Auth dir: /home/alice/.codex
 Candidates: 2
 额度剩余：窗口:百分比|auth
-1. 5h:20|7d:25|auth.json_personal * [Plus · 正常 · 刷新于 2小时前]
-2. --|auth.json_team [额度未知]
+1. 5h:20|7d:25|personal * [Plus · 正常 · 刷新于 2小时前]
+2. --|team [额度未知]
 
-[✅ 5h:20|7d:25|auth.json_personal] [✅]
-[🔐 --|auth.json_team]              [✅]
+[✅ 5h:20|7d:25|personal] [✅]
+[🔐 --|team]              [✅]
 [☑️ 全部] [已启用] [需关注]
 [🛡️ Access]             [🔑 设备登录]
 [🔄 Reload auth]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@foxden-app/foxclaw",
-  "version": "0.4.11",
+  "version": "0.4.12",
   "description": "Foxden local execution claw for controlling Codex from trusted chat interfaces.",
   "type": "module",
   "main": "dist/main.js",

package/skills/foxclaw/SKILL.md

@@ -67,7 +67,7 @@ Telegram behavior:
 - when `TG_BOT_TOKENS` contains multiple bots, one FoxClaw service starts independent Codex app-servers and auth selections per bot
 - isolated Telegram runtimes use independent `CODEX_HOME` directories and file-backed credentials; they do not share Codex sessions
 - refreshed ChatGPT candidates are mirrored only after online usage-endpoint validation; before auth switch or reload, a runtime restores any newer same-account credential found in another Codex home
-- `/auth` paginates large candidate inventories at 8 rows per page, supports all/enabled/attention filters and filename search, and renders the actual observed quota windows rather than assuming every account has 5-hour and 7-day windows
+- `/auth` paginates large candidate inventories at 8 rows per page, supports all/enabled/attention filters and filename search, renders the actual observed quota windows rather than assuming every account has 5-hour and 7-day windows, and omits the repeated `auth.json_` prefix from panel labels without renaming files
 - treat the `/auth` `not recently refreshed` state as a maintenance hint only: OpenAI does not publish a fixed ChatGPT refresh-token lifetime or replay grace period, and FoxClaw must not add routine bulk keepalive refreshes
 - `/auth refresh all` remains a command-only maintenance action, not a panel button; it requires explicit token-rotation risk confirmation, then force-refreshes every ChatGPT candidate through Codex `account/read refreshToken=true`, validates usage, mirrors successful candidates, and restores the original current auth while every runtime is globally idle
 - if `TG_BOT_TOKEN` is also set to one exact token from `TG_BOT_TOKENS`, that bot uses the default/shared-terminal runtime instead of an isolated Telegram home