agent/cpa-plugin
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore: upgrade CLIProxyAPI to v7.2.139

Browse Source
This commit is contained in:
chuan
2026-08-22 19:18:54 +08:00
parent 00f2da4a39
commit 25736099ee
7 changed files with 30 additions and 29 deletions
Download Patch File Download Diff File Expand all files Collapse all files
.externals/CLIProxyAPI
+1 -1
Submodule .externals/CLIProxyAPI updated: 85d2faddd1...0a14eb70ce
.gitattributes
+1
View File
@@ -0,0 +1 @@
patch/*.patch whitespace=-space-before-tab
AGENTS.md
+2 -2
View File
@@ -34,8 +34,8 @@
- 本地 CPA 在 WSL 中运行，项目运行目录统一使用 `cpa-plugin/.runtime`；Windows 客户端经 `127.0.0.1` 访问 WSL 时，localhost 转发层可能不会立即向 CPA 传递客户端断开，取消链路测试优先在 WSL 内直连执行。
- 从 PowerShell 跨 WSL 或 SSH 执行包含 Bash 变量、命令替换或多层引号的逻辑时，优先在 `.runtime/tmp/` 创建临时脚本后传入目标环境执行，不拼接复杂的单行 shell；临时脚本不提交。
- CLIProxyAPI 宿主补丁保存在 `patch/`，当前已验证基线为 `v7.2.137` / `85d2fadd`，必须按 `usage-context`、`usage-identity`、`request-lifecycle-cancel` 的顺序应用；升级 CPA 后按 `docs/operations.md` 核对补丁和已知上游测试例外。
- 构建本项目 patched CPA 时必须按上游 release workflow 使用 `-ldflags` 注入 `main.Version`、`main.Commit` 和 `main.BuildDate`。`Version` 固定使用“当前上游最新 tag + `-dev`”格式（例如 `v7.2.137-dev`），用于明确区分官方 Release 与本项目补丁构建；不得发布只显示 `dev`、`none` 或 `unknown` 的产物。上传前先在本地执行二进制并核对完整版本输出。
- CLIProxyAPI 宿主补丁保存在 `patch/`，当前已验证基线为 `v7.2.139` / `0a14eb70`，必须按 `usage-context`、`usage-identity`、`request-lifecycle-cancel` 的顺序应用；升级 CPA 后按 `docs/operations.md` 核对补丁和已知上游测试例外。
- 构建本项目 patched CPA 时必须按上游 release workflow 使用 `-ldflags` 注入 `main.Version`、`main.Commit` 和 `main.BuildDate`。`Version` 固定使用“当前上游最新 tag + `-dev`”格式（例如 `v7.2.139-dev`），用于明确区分官方 Release 与本项目补丁构建；不得发布只显示 `dev`、`none` 或 `unknown` 的产物。上传前先在本地执行二进制并核对完整版本输出。
- CPA Linux 可执行文件解压后约 60 MiB，`gzip -9` 后约 20 MiB。上传远端时使用 gzip/tar.gz 或 `scp -C`，不要直接传输未压缩二进制；部署后的运行文件仍需解压为原始可执行文件。
- 实际服务器为 `root@akko.pchuan.top`，CPA 根目录为 `/root/cpa`。只维护本项目的 `billing` 和已要求启用的 `keeper`，不启用或部署其他参考插件。
- 远端替换 CPA 或 billing 前，先停止 `/root/cpa/cpa.sh` 管理的进程，并把旧二进制、插件和 `data/cpa-ext.db*` 备份到 `/root/cpa/backups/<timestamp>/`；新版本启动失败时恢复旧二进制和插件。
README.md
+1 -1
View File
@@ -66,7 +66,7 @@ CLIProxyAPI 负责 HTTP 接入、协议转换、上游凭证和实际请求执
## 当前兼容目标
- CLIProxyAPI 基线：`v7.2.137` / `85d2faddd17e6f4f8675a84ee28b131f702e8eaa`，由 `.externals/CLIProxyAPI` submodule 锁定，需依次应用 `patch/` 中三项宿主补丁
- CLIProxyAPI 基线：`v7.2.139` / `0a14eb70ce19fac1d114bcdb4a476d61adc819e2`，由 `.externals/CLIProxyAPI` submodule 锁定，需依次应用 `patch/` 中三项宿主补丁
- 插件版本：`0.1.0`
- Native ABI：`1`
- RPC schema：最高 `4`，注册时按宿主版本向下协商；schema v4 提供 Usage 请求身份
docs/operations.md
+7 -7
View File
@@ -4,9 +4,9 @@
| 项目 | 当前值 |
|---|---|
| CLIProxyAPI Tag | `v7.2.137` |
| submodule 提交 | `85d2faddd17e6f4f8675a84ee28b131f702e8eaa` |
| patched 构建版本 | `v7.2.137-dev` |
| CLIProxyAPI Tag | `v7.2.139` |
| submodule 提交 | `0a14eb70ce19fac1d114bcdb4a476d61adc819e2` |
| patched 构建版本 | `v7.2.139-dev` |
| Native ABI | `1` |
| RPC schema | `4` |
| Go | `1.26.x` |
@@ -29,7 +29,7 @@ DeepSeek 必须配置在 CPA 的 `codex-api-key` 通道，`base-url` 使用 `htt
## 已知上游测试失败
CLIProxyAPI `85d2fadd` 在 Debian WSL 中运行 `go test ./... -count=1` 时有以下失败：
CLIProxyAPI `0a14eb70` 在 Debian WSL 中运行 `go test ./... -count=1` 时有以下失败：
| 测试 | 实际值 | 期望值 |
|---|---|---|
@@ -39,11 +39,11 @@ CLIProxyAPI `85d2fadd` 在 Debian WSL 中运行 `go test ./... -count=1` 时有
| `TestInPlaceByteWritesAreReviewed` | `internal/home/client.go` 清单项已过期 | 文件已无原地字节写入 |
| `TestInPlaceByteWritesAreReviewed` | `internal/pluginstore/auth.go` 清单项已过期 | 文件已无原地字节写入 |
2026-08-20 已在未应用任何 billing 补丁的纯上游 `85d2fadd` 临时 worktree 中复现以上 5 项。三项补丁不修改 `internal/runtime/executor`、`internal/util`、`internal/home` 或 `internal/pluginstore`，因此同一提交、同一 WSL 环境、同一失败内容再次出现时，直接记为已知上游失败，不修复、不再创建干净 worktree复测。
2026-08-22 已在未应用任何 billing 补丁的纯上游 `0a14eb70` 临时 worktree 中复现以上 5 项。三项补丁不修改 `internal/runtime/executor`、`internal/util`、`internal/home` 或 `internal/pluginstore`，因此同一提交、同一 WSL 环境、同一失败内容再次出现时，直接记为已知上游失败，不修复、不再创建干净 worktree复测。
出现以下任一情况时重新验证：
- submodule 提交不再是 `85d2fadd`；
- submodule 提交不再是 `0a14eb70`；
- 上游修改了 `internal/runtime/executor/claude_executor_test.go`、`claude_executor_request.go` 或 `helps/claude_device_profile.go`；
- 失败测试、行号、实际值或期望值发生变化；
- 三项补丁开始修改 `internal/runtime/executor`。
@@ -110,7 +110,7 @@ CPA 版本必须使用当前最新 Tag 加 `-dev`，提交取 submodule HEAD：
```bash
cd .externals/CLIProxyAPI
version=v7.2.137-dev
version=v7.2.139-dev
commit="$(git rev-parse --short=8 HEAD)"
build_date="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
CGO_ENABLED=1 go build -buildvcs=false \
patch/README.md
+6 -6
View File
@@ -1,6 +1,6 @@
# CLIProxyAPI 宿主补丁
这里保存 billing 最初为 CLIProxyAPI `v7.2.133` 制作、已在 `v7.2.137` 重新验证的三项宿主修复。三项补丁都不改变计费规则或数据库结构，必须按下列顺序应用：
这里保存 billing 最初为 CLIProxyAPI `v7.2.133` 制作、已在 `v7.2.139` 重新验证的三项宿主修复。三项补丁都不改变计费规则或数据库结构，必须按下列顺序应用：
1. [`cli-proxy-api-usage-context.patch`](cli-proxy-api-usage-context.patch)
2. [`cli-proxy-api-usage-identity.patch`](cli-proxy-api-usage-identity.patch)
@@ -8,8 +8,8 @@
适用基线：
- CLIProxyAPI：`v7.2.137`
- 提交：`85d2faddd17e6f4f8675a84ee28b131f702e8eaa`
- CLIProxyAPI：`v7.2.139`
- 提交：`0a14eb70ce19fac1d114bcdb4a476d61adc819e2`
- Native ABI：`1`
- 第二项补丁把 RPC schema 从 `3` 提升到 `4`
@@ -84,8 +84,8 @@ git -C .externals/CLIProxyAPI apply ../../patch/cli-proxy-api-request-lifecycle-
cd .externals/CLIProxyAPI
gofmt -w internal/pluginhost sdk/api/handlers sdk/cliproxy/usage sdk/pluginabi sdk/pluginapi
go test -race ./internal/pluginhost ./sdk/api/handlers ./sdk/cliproxy/usage -count=1
version=v7.2.137-dev
commit=85d2fadd
version=v7.2.139-dev
commit=0a14eb70
build_date="$(date -u +%Y-%m-%dT%H:%M:%SZ)"
CGO_ENABLED=1 go build -buildvcs=false \
-ldflags="-s -w -X main.Version=$version -X main.Commit=$commit -X main.BuildDate=$build_date" \
@@ -129,7 +129,7 @@ billing 必须使用 RPC schema v4 重新构建；旧 billing 动态库会向下
- billing 全部测试、billing race 测试及 CLIProxyAPI 相关包 race 测试通过；
- schema v3 对照插件仍能正常注册，新增字段不会发送给旧 schema。
升级到 CLIProxyAPI `v7.2.137` / `85d2fadd` 后，三项补丁可从干净基线按顺序重放，补丁涉及的三个包及其 race 测试通过。宿主全仓测试中的 3 个 Claude 指纹失败和 2 个 `reviewedInPlaceByteWrites` 清单过期失败均已在未应用补丁的纯上游 `85d2fadd` 上原样复现，属于上游例外，详见 [`../docs/operations.md`](../docs/operations.md)。
升级到 CLIProxyAPI `v7.2.139` / `0a14eb70` 后，三项补丁可从干净基线按顺序重放，补丁涉及的三个包及其 race 测试通过。`usage-identity` 已适配上游插件 executor 的独立 `execCtx`，保留嵌套执行防重复统计逻辑。宿主全仓测试中的 3 个 Claude 指纹失败和 2 个 `reviewedInPlaceByteWrites` 清单过期失败均已在未应用补丁的纯上游 `0a14eb70` 上原样复现，属于上游例外，详见 [`../docs/operations.md`](../docs/operations.md)。
## 性能影响
patch/cli-proxy-api-usage-identity.patch
+12 -12
View File
@@ -131,13 +131,13 @@ index 994bd33a..3cc7743e 100644
opts := coreexecutor.Options{
Stream: false,
Alt: alt,
@@ -177,6 +179,7 @@ func (h *BaseAPIHandler) executeWithPluginExecutor(ctx context.Context, entryPro
}
req, opts := h.pluginExecutorRequest(ctx, entryProtocol, responseProtocol, modelName, originalRequestedModel, rawJSON, alt, false, execOptions)
lifecycle := h.newRequestLifecycleTracker(ctx, entryProtocol, modelName, originalRequestedModel, false, opts.Metadata, execOptions.SkipInterceptorPluginID)
+ ctx = lifecycle.executionContext()
@@ -179,6 +181,7 @@ func (h *BaseAPIHandler) executeWithPluginExecutor(ctx context.Context, entryPro
execCtx, nestedTracker := withNestedExecutionTracker(ctx)
req, opts := h.pluginExecutorRequest(execCtx, entryProtocol, responseProtocol, modelName, originalRequestedModel, rawJSON, alt, false, execOptions)
lifecycle := h.newRequestLifecycleTracker(execCtx, entryProtocol, modelName, originalRequestedModel, false, opts.Metadata, execOptions.SkipInterceptorPluginID)
+ execCtx = lifecycle.executionContext()
var interceptErr *interfaces.ErrorMessage
req, opts, interceptErr = h.applyRequestInterceptorsBeforeAuth(ctx, entryProtocol, originalRequestedModel, lifecycle.requestID(), req, opts, execOptions.SkipInterceptorPluginID)
req, opts, interceptErr = h.applyRequestInterceptorsBeforeAuth(execCtx, entryProtocol, originalRequestedModel, lifecycle.requestID(), req, opts, execOptions.SkipInterceptorPluginID)
if interceptErr != nil {
@@ -211,6 +214,7 @@ func (h *BaseAPIHandler) countWithPluginExecutor(ctx context.Context, handlerTyp
}
@@ -209,13 +209,13 @@ diff --git a/sdk/api/handlers/handlers_stream.go b/sdk/api/handlers/handlers_str
index 9cceec54..dcdc08df 100644
--- a/sdk/api/handlers/handlers_stream.go
+++ b/sdk/api/handlers/handlers_stream.go
@@ -41,6 +41,7 @@ func (h *BaseAPIHandler) streamWithPluginExecutor(ctx context.Context, entryProt
}
req, opts := h.pluginExecutorRequest(ctx, entryProtocol, responseProtocol, modelName, originalRequestedModel, rawJSON, alt, true, execOptions)
lifecycle := h.newRequestLifecycleTracker(ctx, entryProtocol, modelName, originalRequestedModel, true, opts.Metadata, execOptions.SkipInterceptorPluginID)
+ ctx = lifecycle.executionContext()
@@ -43,6 +43,7 @@ func (h *BaseAPIHandler) streamWithPluginExecutor(ctx context.Context, entryProt
execCtx, nestedTracker := withNestedExecutionTracker(ctx)
req, opts := h.pluginExecutorRequest(execCtx, entryProtocol, responseProtocol, modelName, originalRequestedModel, rawJSON, alt, true, execOptions)
lifecycle := h.newRequestLifecycleTracker(execCtx, entryProtocol, modelName, originalRequestedModel, true, opts.Metadata, execOptions.SkipInterceptorPluginID)
+ execCtx = lifecycle.executionContext()
var interceptErr *interfaces.ErrorMessage
req, opts, interceptErr = h.applyRequestInterceptorsBeforeAuth(ctx, entryProtocol, originalRequestedModel, lifecycle.requestID(), req, opts, execOptions.SkipInterceptorPluginID)
req, opts, interceptErr = h.applyRequestInterceptorsBeforeAuth(execCtx, entryProtocol, originalRequestedModel, lifecycle.requestID(), req, opts, execOptions.SkipInterceptorPluginID)
if interceptErr != nil {
@@ -305,6 +306,7 @@ func (h *BaseAPIHandler) executeStreamWithAuthManagerFormats(ctx context.Context
}