chore: sync CLIProxyAPI upstream

Author: linhay

docs-linhay/dev/20260519-cliproxyapi-upstream-sync-session-distillation.md

@@ -196,3 +196,21 @@ git check-ignore -v <path>
 4. `git diff --check`
 
 沉淀结论：该流程属于 CLIProxyAPI fork 领域维护规则，已补入 `gettokens-domain-engineering`；不升级 `AGENTS.md`。
+
+## 2026-05-28 v7.1.28 同步记录
+
+本轮将 `docs-linhay/references/CLIProxyAPI#gettokens/sidecar` 从 `fbcf3bb5` 合并到 `upstream/main@c65275fd`（tag `v7.1.28`），生成 merge commit `e2ec7262` 并推送到 `AxApp/CLIProxyAPI#gettokens/sidecar`。
+
+上游增量集中在 usage telemetry、file-backed logging cleanup、signature validation 抽取和 codex-free 模型目录清理。冲突点都在 usage telemetry 相邻逻辑：
+
+1. `internal/runtime/executor/helps/usage_helpers.go`：保留 fork 的 translated reasoning 非空才覆盖逻辑，同时接入 upstream `service_tier` 提取。
+2. `internal/runtime/executor/helps/usage_helpers_test.go`：同时保留 reasoning preservation 测试和 upstream service tier 测试。
+3. `internal/redisqueue/plugin_test.go`：payload 同时断言 `ttft_ms` 与 `service_tier`。
+
+验证：
+
+1. 合并前 focused baseline：`go test ./internal/runtime/executor`、`go test ./sdk/api/handlers/openai`、`go test ./internal/gettokenshooks ./internal/gettokensrouting ./sdk/cliproxy/auth`。
+2. 冲突解决后局部验证：`go test ./internal/runtime/executor/helps`、`go test ./internal/redisqueue`、`go test ./sdk/cliproxy/usage ./internal/logging`。
+3. 合并后验证：`go test ./internal/runtime/executor`、`go test ./internal/translator/claude/openai/responses ./internal/translator/openai/openai/responses`、`go test ./sdk/api/handlers/openai`、`go test ./internal/gettokenshooks ./internal/gettokensrouting ./sdk/cliproxy/auth`、`go test ./...`、`git diff --check`。
+
+本地 sidecar 已通过 `./scripts/ensure-sidecar.sh darwin arm64` 重建，`build/bin/cli-proxy-api.meta.json` 记录 `commit=e2ec7262`、`dirty=clean`、`goos=darwin`、`goarch=arm64`。本次仍属于既有 CLIProxyAPI fork 同步流程，不升级 `AGENTS.md`。

docs-linhay/memory/2026-05-28.md

@@ -156,3 +156,10 @@
 ## 账号导入统一 modal 交接复核
 - 复核接手 `docs-linhay/spaces/20260528-account-import-unified-modal/handoff-20260528-account-import-preview.md`：账号导入聚焦 tests `30 pass / 0 fail`，当前工作区 `typecheck` 与完整 `npm --prefix frontend run test:unit` 均通过。
 - 浏览器预览确认统一导入入口可打开 modal，粘贴 auth JSON 可加入候选队列，预览会脱敏敏感字段；移除候选后队列恢复为空且提交按钮重新禁用。
+
+## CLIProxyAPI v7.1.28 上游同步
+- 完成：`docs-linhay/references/CLIProxyAPI#gettokens/sidecar` 已合并 `upstream/main@c65275fd`（tag `v7.1.28`），生成并推送 merge commit `e2ec7262` 到 `AxApp/CLIProxyAPI#gettokens/sidecar`。
+- 冲突处理：`SetTranslatedReasoningEffort` 保留 fork 的“translated payload 无 reasoning 时不清空 context reasoning effort”修复，同时接入 upstream `service_tier`；redisqueue payload 测试同时锁定 `ttft_ms` 和 `service_tier`。
+- sidecar 已重建：`build/bin/cli-proxy-api.meta.json` 记录 `commit=e2ec7262`、`dirty=clean`、`goos=darwin`、`goarch=arm64`。
+- 验证通过：fork focused baseline、冲突包测试、合并后 focused regression、`go test ./...`、`git diff --check`、`./scripts/ensure-sidecar.sh darwin arm64`。
+- 文档：同步记录已追加到 `docs-linhay/spaces/20260527-cliproxyapi-upstream-merge/plans/upstream-merge-plan-v01.md` 与 `docs-linhay/dev/20260519-cliproxyapi-upstream-sync-session-distillation.md`；本次仍属于既有 CLIProxyAPI fork 同步流程，不升级 `AGENTS.md`。

docs-linhay/references/CLIProxyAPI

@@ -1 +1 @@
-Subproject commit fbcf3bb559cdd8c3f85a31950814df763814e237
+Subproject commit e2ec7262faafd2346ed16297e5a76f3e65442d61

docs-linhay/spaces/20260527-cliproxyapi-upstream-merge/plans/upstream-merge-plan-v01.md

@@ -198,3 +198,60 @@
 - 这次 upstream 增量没有触碰父仓库 Wails DTO、frontend binding 或用户可见配置面。
 - 冲突点位于 Codex WebSocket executor，是 GetTokens live sessions 与 upstream TTFT usage reporting 的相邻逻辑；后续若该文件继续冲突，仍优先同时保留 live-session 生命周期事件和 upstream usage timing。
 - 父仓库仍有大量无关未提交改动，本次日常同步只应纳入 `docs-linhay/references/CLIProxyAPI` gitlink、此执行记录和 memory 写回。
+
+## 2026-05-28 二次同步记录
+
+### 上游增量
+
+- `upstream/main` 从 `94c1b251` 前进到 `c65275fd`，最新 tag 到 `v7.1.28`。
+- 新增 upstream 提交：
+  1. `d9c01a63 chore(models): remove deprecated GPT-5.x models from codex-free catalog`
+  2. `2bcc7622 feat(logging): improve file-backed source cleanup and directory recreation logic`
+  3. `65e760aa feat(usage): include cache tokens in total token calculation and add tests`
+  4. `71c185f6 feat(usage): add service tier tracking and defaults in usage reporting`
+  5. `b3d6d5d7 refactor: extract signature validation`
+  6. `c65275fd Merge pull request #3591 from sususu98/feat/signature-check-extraction`
+
+### 合并结果
+
+- 合并前 fork 状态：`gettokens/sidecar` 干净，当前 HEAD 为 `fbcf3bb5 fix: harden usage reasoning and ttft reporting`。
+- 冲突文件：
+  - `internal/runtime/executor/helps/usage_helpers.go`
+  - `internal/runtime/executor/helps/usage_helpers_test.go`
+  - `internal/redisqueue/plugin_test.go`
+- 冲突处理：
+  - `SetTranslatedReasoningEffort` 保留 fork 的“没有 translated reasoning 时不清空 context reasoning effort”修复，同时接入 upstream `service_tier` 提取与默认值。
+  - redisqueue payload 测试同时锁定 fork 的 `ttft_ms` 和 upstream 的 `service_tier` 字段。
+- fork 合并提交：`e2ec7262 Merge upstream CLIProxyAPI main`
+- 远端推送：`origin/gettokens/sidecar` 已更新到 `e2ec7262`。
+- 父仓库 sidecar gitlink 从 `fbcf3bb5` 前进到 `e2ec7262`。
+- 本地 sidecar：已通过 `./scripts/ensure-sidecar.sh darwin arm64` 重建，meta 为 `e2ec7262:clean:01d5ae7eed81e5c11ea0cc01902a1361fc75b449a7aa3ee84c18fba0cc76a181:darwin:arm64`。
+
+### 验证记录
+
+合并前基线：
+
+- `go test ./internal/runtime/executor`
+- `go test ./sdk/api/handlers/openai`
+- `go test ./internal/gettokenshooks ./internal/gettokensrouting ./sdk/cliproxy/auth`
+
+冲突解决后局部验证：
+
+- `go test ./internal/runtime/executor/helps`
+- `go test ./internal/redisqueue`
+- `go test ./sdk/cliproxy/usage ./internal/logging`
+
+合并后验证：
+
+- `go test ./internal/runtime/executor`
+- `go test ./internal/translator/claude/openai/responses ./internal/translator/openai/openai/responses`
+- `go test ./sdk/api/handlers/openai`
+- `go test ./internal/gettokenshooks ./internal/gettokensrouting ./sdk/cliproxy/auth`
+- `go test ./...`
+- `git diff --check`
+- `./scripts/ensure-sidecar.sh darwin arm64`
+
+### 注意事项
+
+- 这次同步没有新增父仓库 Wails DTO、frontend binding 或用户可见配置面。
+- 后续若 upstream usage telemetry 继续调整，`reasoning_effort`、`service_tier`、`ttft_ms` 需要作为同一条 usage record contract 联合验证，不能只跑其中一个入口。