@wengine-ai/llms 2.3.20 → 2.3.23

package/README.md

@@ -93,6 +93,9 @@ npm install -g @wengine-ai/claude-code-router-next@latest && ccr restart
 
 | 版本 | 发布内容 |
 | --- | --- |
+| **v2.3.23** | <ul><li>**修复状态栏 token 速率虚高（撞到 999 上限）**: `ccr statusline` 的 token 速率常显示几百、极端撞到 999 上限，与「用量统计」的几十 t/s 对不上。根因是 token-speed 插件流式过程中每秒上报的是「最近 1 秒到达的 token 数」滑动窗口值，而 SSE delta 常成批到达（同一时间戳）使瞬时计数虚高；现改为与用量统计同一套解码平均公式（`输出 token ÷ (总耗时 − TTFT)`）上报，速率随流式收敛到最终值、与用量统计一致，并移除失效的滑动窗口记账。</li><li>**状态栏默认改为无图标表格风格**: 默认主题不再带装饰图标，模块之间改用细竖线 `│` 分隔，呈简洁表格样式，默认模块顺序为「模型 │ 工作目录 │ git 分支 │ 上下文进度条 │ token 速率 │ 会话总 token」。动机是歧义宽度的 emoji 图标（如闪电 `⚡` U+26A1）会让 Claude Code 误算状态栏显示宽度、在双击等重绘时产生数字重影/位移；改用定宽字符或不带图标可避免。图标仍支持在 UI 中自定义。</li><li>**修复 UI 状态栏图标无法删除 + 旧圆圈模块迁移**: 切换所选模块时图标搜索框（`IconSearchInput`）不随 `value` 同步、与模块真实图标脱节导致看似删不掉，现已在 `value` 变化时同步；同时加载配置时把旧 `contextCircle` 模块迁移为 `contextBar`，配置弹窗显示长条进度条而非旧圆圈图标。</li><li>**`build:ui` 构建后同步产物到 CLI/根 dist**: `pnpm build:ui` 现会把 `index.html` 同步到 `packages/cli/dist` 与根 `dist`，使单独运行 `build:ui` 也能更新本地运行中的 ccr 实际读取的包。</li></ul> |
+| **v2.3.22** | <ul><li>**状态栏按用户配置的压缩阈值显示上下文上限**: `ccr statusline` 优先用 `CLAUDE_CODE_AUTO_COMPACT_WINDOW`（CCR 从顶层 `ContextWindow` 写入）作为上下文上限与百分比分母，未设才回退到 Claude Code 的窗口值，使状态栏与实际 auto-compact 触发点对齐，不再固定显示 1M/200k。</li><li>**接管保留用户手写的 auto-compact 自定义值**: CCR 接管 Claude Code 时不再无条件用 `ContextWindow` 覆盖 `CLAUDE_CODE_AUTO_COMPACT_WINDOW`，改用状态文件（`~/.claude-code-router/client-state.json` 全局、`<project-id>/ccr-state.json` 项目级）区分 CCR 写入值（可随 `ContextWindow` 更新）与用户手写值（保留）；卸载只清自己写的、保留用户的；状态缺失时保守保留，绝不误覆盖。</li><li>**UI 上下文窗口与扩展上下文配合提示**: 顶层 `ContextWindow` > 200000 但未启用对应模型家族「扩展上下文 (1M)」（模型名带 `[1m]`）时显示红色警告，并在两处配置补充配合说明——否则 Claude Code 会将其封顶至 200000。</li><li>**修复状态栏百分比按 1M 计算与偶发闪 0%**: statusline 子进程不一定继承项目级 settings 的环境变量，导致项目里设的 `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 被漏读而按 1M 计算，现在依次从 `process.env`→项目 `settings.local.json`→全局 `settings.json` 读取；另 `current_usage` 在请求进行中/刚 auto-compact 后会暂态为空使百分比偶发闪 0%，现回退到 transcript 最近一条 assistant 消息的上下文用量保持稳定。</li><li>**修复项目接管 disable→enable 循环冻结窗口与 disable 残留**: 项目级 `ccr-state.json` 在 disable 后丢失、再 enable 时不重建，导致 CCR 无法识别自己写入的窗口——既会让 `ContextWindow` 变更无法刷新生效，也会在关闭接管时把 `CLAUDE_CODE_AUTO_COMPACT_WINDOW` 当用户值残留。现在状态缺失时按「值等于当前 `ContextWindow`」兜底识别 CCR-managed，enable 重建状态、disable 清残留，真正的用户手写值仍保留。</li></ul> |
+| **v2.3.21** | <ul><li>**新增 pi (earendil-works) 客户端接管**: 新增 pi 作为第三个接管目标（与 Claude Code、Codex 并列），pi 使用 Anthropic `/v1/messages` 协议直连无需 transformer；接管会在 `~/.pi/agent` 写入 `models.json`（注册指向 ccr 代理的 `ccr` provider，暴露 `ccr-opus`/`ccr-sonnet`/`ccr-haiku` 族别名）与 `settings.json`（默认 provider/model 指向 ccr），并备份原文件，仅做配置注入不含账号管理；用量统计也会把 pi 识别为独立客户端（pi 与 Claude Code 共用 `ccr-*` 别名，靠 pi system prompt 特征 + Anthropic SDK 请求头区分）。</li><li>**项目级接管支持多客户端多选**: 「项目级配置」页「CCR 接管」从只接管 Claude Code 改为客户端多选下拉（Claude Code + pi + qwen-code + opencode），不选默认接管全部；pi 项目级接管在项目目录写 `.pi/settings.json` 指向全局 ccr provider 并在 `trust.json` 信任该目录，接管状态从各客户端项目级配置文件实时推导、自动兼容既有项目（Codex 配置全局-only 不纳入）。</li><li>**新增 qwen-code (Alibaba) 客户端接管**: 新增 qwen-code（`@qwen-code/qwen-code`）作为第四个接管目标，走 Anthropic `/v1/messages` 直连；接管在 `~/.qwen/settings.json`（用户级）/ `<项目>/.qwen/settings.json`（项目级）写入指向 ccr 的 `modelProviders.anthropic`（暴露 ccr-opus/sonnet/haiku）、备份原文件，项目级还在 `trustedFolders.json` 信任该目录。用量统计区分 qwen-code：qwen 经代理时会伪装成 Claude Code 的 `claude-cli` UA，故改用 qwen system prompt 特征（`You are Qwen Code`）正向识别、Claude Code 用 `cc_version`/`metadata.user_id` 强信号识别。</li><li>**新增 opencode (opencode.ai) 客户端接管**: 新增 opencode 作为第五个接管目标，走 Anthropic `/v1/messages` 直连；接管在 `~/.config/opencode/opencode.json`（全局）/ `<项目>/opencode.json`（项目级）注入一个 `@ai-sdk/anthropic` 的 `provider.ccr`（baseURL=`…/v1`、apiKey 内联、暴露 ccr-opus/sonnet/haiku）并设 `model: ccr/ccr-opus`，备份原文件，无需 trust。用量统计区分 opencode：其请求带 `opencode/…` UA 且不伪装，直接按 UA 识别。</li></ul> |
 | **v2.3.20** | <ul><li>**清理改名/删除模型后残留的僵尸熔断记录**: 从 provider 的 `models` 重命名/删除模型后（如 `ollama,glm-5.2` → `ollama,glm-5.2:cloud`），旧名字在 `provider-health.json` 中的熔断记录会成为僵尸，UI 上该供应商一直显示 `Failed`，且因状态持久化落盘 `ccr restart` 与点刷新都清不掉（probe 成功只 `recover` 当前配置的模型名）。现在新增 `health-reconcile`：服务启动、保存配置、probe 成功时分别按当前配置对账清理残留记录；「可路由」集合同时取自各 provider `models` 与 Router/fallback 引用，避免误删 `models` 为空但仅靠 Router 路由的模型（如 `阿里云 Coding Plan,glm-5`）健康状态。新增 7 个单元测试。</li></ul> |
 | **v2.3.19** | <ul><li>**新增 OpenCode (opencode.ai) Transformer**: 为暴露 OpenAI 兼容 `/v1/chat/completions`、底层由 GLM/智谱驱动的 OpenCode 类 provider 新增专用 transformer，显式声明 `endPoint` 避免误触 bypass 把 Anthropic 格式工具发给 OpenAI 兼容接口；同时清理 GLM 不识别的 `cache_control`/`image_url`/`media_type`，转换 `reasoning_content` 为 thinking 格式，并把纯数字 `tool_call` ID 替换为 UUID。在 provider `transformer` 中配置 `"opencode"` 启用。</li><li>**设置页代理地址与 API 密钥输入框禁用浏览器自动填充**: 弹窗版与整页版设置的「代理地址」「API 密钥」此前会被 Chrome 用已保存表单数据/密码自动填充覆盖真实值；现在通过 `Input` 的 `disableAutofill` 提供随机 `name`、初始 `readOnly` 至首次聚焦解除、`autoComplete="off"` 及密码管理器忽略标记三重防护，并配合隐藏 honeypot 字段。</li></ul> |
 | **v2.3.18** | <ul><li>**模型族长上下文阈值继承主路由配置**: `ccr-opus`/`ccr-sonnet`/`ccr-haiku` 的 family routing 未配置族级阈值时会继承 `Router.longContextThreshold`，避免主路由设为 100k 时约 70k token 请求仍误进 `<family>/longContext`。</li><li>**fallback 候选模型也执行 Double-Check 重试**: 每个 fallback 候选第一次 `fetch failed`/空 SSE/隐藏错误后会先对同一候选重试一次，第二次仍失败才切到下一个，降低智谱等接口短暂不稳定导致的过早切换；同时修正失败记录的 `originalModel` 显示。</li><li>**全局配置保存后同步项目级 CCR 接管字段**: 跟随全局 Router 且已开启 CCR Takeover 的项目，在保存全局配置或切回使用全局配置时自动刷新 `.claude/settings.local.json` 中的模型族别名、auto-compact、状态栏与代理字段。</li><li>**默认降低日志量并保留最近 7 天**: 服务器日志默认级别从 `debug` 调整为 `error`，只在显式配置 `LOG_LEVEL=info/debug/trace` 时输出详细日志，并自动清理超过 7 天的 `ccr-*.log`。</li></ul> |
@@ -100,9 +103,7 @@ npm install -g @wengine-ai/claude-code-router-next@latest && ccr restart
 | **v2.3.16** | <ul><li>**修复 system 消息顺序兼容 DeepSeek/vLLM**: OpenAI 兼容提供商（DeepSeek V4、GLM、vLLM）要求 `[system, user, assistant]` 顺序，此前 system 排在 user/assistant 之后会导致输出乱码；现在将 system 消息前置并去重。</li><li>**接管时去除 Attribution 动态头以提升缓存命中**: CCR 接管 Claude Code 时默认写入 `CLAUDE_CODE_ATTRIBUTION_HEADER=0`，去掉系统提示词开头随请求变化的 attribution 头（客户端版本 + prompt fingerprint），稳定上游 prompt 缓存前缀；可在设置页或 `disableAttributionHeader: false` 关闭。</li><li>**设置页布局紧凑化**: 「日志级别」下拉从独占整行移入两列网格，与「API 密钥」并排显示，减少纵向留白。</li></ul> |
 | **v2.3.15** | <ul><li>**Fallback 前同模型重试一次**: 模型调用出现一次异常不再立即切换到备用模型，而是先对同一模型自动重试一次（Double-Check），避免因瞬时错误（网络抖动、偶发限流、空 SSE 响应等）导致不必要的模型切换；重试仍失败才走原有 fallback 流程。</li><li>**用量统计显示上游真实模型**: 部分上游网关会偷偷将请求路由/降级到另一个后端模型（如请求 glm-5 实际返回 MiniMax-M2.5）。用量统计的模型映射现在追加上游返回的真实模型，格式为 `originalModel → routedModel → upstreamModel`（如 `ccr-opus → glm-5 → minimax-m2.5`），上游未偷换时自动省略。</li></ul> |
 | **v2.3.14** | <ul><li>**修复状态栏显示 `<synthetic>` 模型名**：Claude Code 在 auto-compact 自动压缩、中断恢复时写入的 `<synthetic>` 合成消息（非真实 LLM 响应）此前被状态栏当作模型名显示（从 Claude 账号会话切换到 ccr 接管、或发生自动压缩后尤其常见）；现在过滤该合成标识，正确显示实际路由模型，同时不再把合成消息的 usage 计入 token 统计。</li></ul> |
-| **v2.3.13** | <ul><li>**修复删除项目配置未清理项目 `settings.local.json`**：添加项目时自动写入的 ccr 托管字段（代理地址、模型族路由环境变量、auto-compact、statusline 等）此前在删除项目时未被清理；现在删除前会先关闭 takeover，移除这些字段。</li></ul> |
-| **v2.3.12** | <ul><li>**修复定时唤醒未真正触发计费周期**：唤醒请求由 `max_tokens: 1` 的 dummy ping 改为真实推理 prompt 与 `max_tokens: 10`，确保 Coding Plan 类提供商产生实际 token 消耗并激活日额度周期。</li><li>**修复 Codex 等 `/messages` 端点唤醒 404**：以 `baseUrl` 是否包含 `/messages` 判断 Anthropic 协议，且 `baseUrl` 作为完整路径直接使用，不再拼接后缀。</li><li>**唤醒/探测请求增加来源头**：新增 `x-claude-code-router-source` 与 `x-claude-code-router-version` 请求头，便于上游识别 CCR 内部探测/唤醒流量。</li></ul> |
-| **v2.3.11** | <ul><li>**修复新会话首个请求绕过项目级路由（会话检测竞态）**：新会话的第一个请求（如标题生成元请求，比主请求早到约十几毫秒）到达时 session 转写文件可能尚未落盘，导致项目匹配失败、回退全局 `Router`，使该请求绕过项目级路由（如项目已关 `enableFamilyRouting` 仍走全局模型族路由）。现在缓存未命中时短延迟重试（最多 3×50ms）给文件落盘留时间，并保证每个 session 仅重试一次，避免非托管会话每请求都被加延迟。</li></ul> |
+
 > 仅保留最近 10 个版本，更早版本的发布摘要见 [CHANGELOG-archive.md](./CHANGELOG-archive.md)，完整详细变更记录见 [CHANGELOG.md](./CHANGELOG.md)。
 
 ### 2. 配置