Skip to content

RECON.md

Latest commit

 

History

History
668 lines (528 loc) · 32.4 KB

RECON.md

File metadata and controls

668 lines (528 loc) · 32.4 KB
Raw

CodeArts2API 逆向勘察报告

目标：把本机 CodeArts Agent（华为云码道 / CodeArts Doer for Coding）桌面端的 上游模型服务，复刻成一个 OpenAI 兼容网关。

结论：可行，且比参考项目 Doubao2API 简单 —— 上游本身就是 OpenAI 兼容协议，不需要像豆包那样把私有补丁流还原成文本。

本报告已被实现。 对应代码见仓库根目录的 internal/codearts/（凭据 / 签名 / 转发 / 续期） 与 internal/server/（OpenAI + Anthropic 兼容层与控制台）；使用方式见 README.md。

⚠️ 本文件是 2026-10 之前的快照，其中的 benefit（免费权益）通道内容已失效。 上游 benefit-gateway-config 现已返回 enabled:false，gateway/config、 benefit/claim、user/tokens/balance 一律报 4000: invalid channel, group not found。 现状以 UPSTREAM.md 与代码为准。

一、结论速览

环节 逆向结果 难度
应用形态 VS Code 1.109.5 fork（Electron），resources/app/out/main.js 低
AI 能力载体 内置扩展 huaweicloud.vscode-codebot（package name codearts-snap，v26.9.902） 低
Agent 内核 agentkernelServer-win32-x64.exe（173 MB，Bun 单文件 exe，基于 opencode 二次开发） —
推理入口 POST https://snap-access.cn-north-4.myhuaweicloud.com/api/v2/chat/completions —
协议 OpenAI 兼容（chat.completion / chat.completion.chunk SSE），额外带 reasoning_content 极低
鉴权 华为云 SDK-HMAC-SHA256 签名 + X-Security-token（STS 临时凭证） 中
凭据落盘 %APPDATA%\codearts-agent\User\globalStorage\state.vscdb（SQLite） 低
凭据加密 两层：DPAPI 保护的主密钥（Local State）+ AES-256-GCM 逐条加密（v10 前缀） 低（与 Doubao2API 同源）
模型列表 GET https://opengw.developer.huaweicloud.com/api/v1/gateway/config 低
额度查询 GET https://opengw.developer.huaweicloud.com/api/v1/user/tokens/balance 低
续期 POST https://sts.cn-north-4.myhuaweicloud.com/v1/oauth2/tokens（DPoP JWS + refresh_token） 中

实测已跑通：模型列表 / 额度 / 非流式对话 / 流式 SSE / Function Calling，见 tools/。

二、链路

┌──────────────┐  /v1/chat/completions  ┌──────────────┐  SDK-HMAC-SHA256 签名  ┌──────────────────────────────────────┐
│ OpenAI SDK   │  /v1/models            │ CodeArts2API │  + X-Security-token    │ snap-access.cn-north-4.myhuaweicloud │
│ NewAPI / pi  │ ─────────────────────▶ │   (本网关)   │ ─────────────────────▶ │ .com/api/v2/chat/completions         │
└──────────────┘  SSE 流式 / 非流式      └──────┬───────┘      OpenAI SSE        └──────────────────────────────────────┘
                                               │ 只读解密
                                               ▼
                    %APPDATA%\codearts-agent\Local State                 ← DPAPI 主密钥
                    %APPDATA%\codearts-agent\User\globalStorage\state.vscdb
                       secret://{"extensionId":"huaweicloud.authentication",
                                 "key":"HuaweiCloudSession"}               ← AK/SK/STS/refresh_token

和 Doubao2API 最大的差别：上游协议不用转换。豆包那边要把 content_block 补丁流 还原成文本 / 思维链；CodeArts 这边上游直接吐标准 chat.completion.chunk。

三、关键事实与证据位置

3.1 应用形态

F:\IDE\CodeArts Agent\resources\app\product.json

nameShort            codearts-agent          vscodeVersion  1.109.5
dataFolderName       .codearts-doer-for-coding
snapEngineUrl        https://snap-access.cn-north-4.myhuaweicloud.com
apiHost              https://ide.cn-north-4.myhuaweicloud.com
urlProtocol          codearts-agent          ← OAuth client_id

3.2 端点定义

resources/app/extensions/vscode-codebot/product.json → commercialVersionDomain.newFramework.productDomain

snapApigDomain    https://snap-access.cn-north-4.myhuaweicloud.com   (备用 .cn)
snapApigBackupDomain  https://snap-access.cn-north-4.myhuaweicloud.cn
codeGenDomain / chatDomain / policyCenterDomain / agentModeDomain / memoryServiceDomain
                 均 = snapApigDomain
iamStsOpenDomain https://sts.cn-north-4.myhuaweicloud.com
OTDomain         https://collector-agents-access.cn-north-4.myhuaweicloud.com/collector

out/extension.js 里拼出的 URL：

this.chatUrl          = `${chatDomain}/v1/chat/chat`          // 旧框架，不用
this.codeGenUrl       = `${codeGenDomain}/v1/code/complete`   // 旧框架，不用
// 新框架（Agent Kernel）
inferhubBaseUrl       = `${agentChatDomain}/api/v2/`          → /api/v2/chat/completions

3.3 Agent 内核（opencode 二次开发）

agentkernelServer-win32-x64.exe 内的关键片段：

function CA(n){let t=n.replace(/\/$/,"");
  if(t.endsWith("/chat/completions"))return t;
  return `${t}/chat/completions`}                      // → /api/v2/chat/completions

// 凭据优先级：global config userToken > env W3_TOKEN
function FA(n){let t=n?.userToken?.trim(); if(t)return{token:t,source:"global_userToken"};
  let e=process.env.W3_TOKEN?.trim(); if(e)return{token:e,source:"env_W3_TOKEN"};
  return{source:"none"}}

// 真正发请求时走的是 HC 签名分支（PLUGIN_ENV=hc）
//   resolveAkSk(): GlobalConfig.userInfo.{accessKeyId,secretAccessKey,accessToken}
//   Th.sign(req, new Uh(ak, sk))   ← 华为云 SDK-HMAC-SHA256

out/extension.js 把配置推给内核：POST/PATCH /v1/config、/cag/global/config， body 字段含 userName / userToken / inferhubBaseUrl / policyCenterDomain / ...。

3.4 真实抓包（内核日志）

~/.codeartsdoer/codearts-data/log/kernel-codeartsdoer-incognito-*.log

service=inferhub-provider "[header-debug] full headers: {
  "x-ot-trace-id": "...", "x-ot-span-id": "...", "x-snap-traceid": "...",
  "x-ot-session-id": "ses_...", "user-session-id": "ses_...",
  "x-ot-function": "agent-general", "maas_type": "benefit", "X-Language": "zh-cn",
  "user-msg-id": "msg_...", "created-time": "2026-10-16T01:37:44Z",
  "model-id": "glm-5.3-flash", "model-name": "glm-5.3-flash",
  "x-ot-client-type": "IDE", "x-ot-client-version": "26.9.902",
  "plugin-name": "codemate_vscode", "plugin-version": "26.9.902",
  "ide-name": "VSCode", "ide-version": "26.9.902",
  "client-ip": "198.18.0.1", "X-Sdk-Date": "20261016T013744Z",
  "host": "snap-access.cn-north-4.myhuaweicloud.com" }"
   ← 日志里被过滤掉的两个头就是 X-Security-token 和 Authorization

3.5 签名算法（必须逐字对齐）

out/extension.js 中打包的 huaweicloud-sdk-core signer：

function d(O,N){ ... return O.method+`\n`+p(O)+`\n`+g(O)+`\n`+m(O,N)+`\n`+N.join(";")+`\n`+M }

// ★ CanonicalURI：每段单独 urlencode，且强制补尾斜杠
function p(O){ let N=O.uri.split("/"), M=[]; for(let Q of N) M.push(c(Q));
               let k=M.join("/"); return k[k.length-1]!=="/" && (k=k+"/"), k }

// ★ CanonicalHeaders：每个 k:v.trim() 用 \n 连接后自带尾 \n，
//   外层 d() 又补了一个 \n —— 于是 signed headers 前有一个空行
function m(O,N){ ... k.push(Q+":"+U.trim()); return k.join(`\n`)+`\n` }

// 所有请求头都参与签名（含 x-security-token）
function y(O){ ... N.push(M.toLowerCase()); return N.sort(), N }

两个坑（PoC 里已复现验证）：

  1. CanonicalURI 末尾补 /：/api/v2/chat/completions → /api/v2/chat/completions/
  2. CanonicalHeaders 与 SignedHeaders 之间是两个 \n（一个空行）

3.6 凭据存储

%APPDATA%\codearts-agent\Local State
  os_crypt.encrypted_key = base64("DPAPI" + CryptProtectData(AES-256 key))

%APPDATA%\codearts-agent\User\globalStorage\state.vscdb  (SQLite, ItemTable)
  key   secret://{"extensionId":"huaweicloud.authentication","key":"HuaweiCloudSession"}
  value {"type":"Buffer","data":[118,49,48,...]}   # "v10" + nonce(12) + AES-256-GCM(ct||tag)

载荷有两种写法（VS Code 改过）

实测同一台机器上，ItemTable 里的值在两种格式之间出现过：

{"type":"Buffer","data":[118,49,48, ...]}     // 字节数组（早期）
{"type":"Buffer","data":"djEwupakP/REo1+c..."} // base64 字符串（后来）

两种都要支持。Go 的 encoding/json 把 JSON 字符串解到 []byte 时自动按 base64 解码， 数组形式也能直接解，所以 Data []byte 一个字段就同时兼容两种写法 —— 这是 session_windows.go 至今没被这个变更打挂的原因。该列本身也可能是 TEXT 或 BLOB。

解密后的 session 结构：

{
  "account": {"id": "...", "label": "hid_..."},
  "accessKey": "HSTA...",            // STS 临时 AK
  "secretKey": "...",                // STS 临时 SK
  "securitytoken": "...",            // X-Security-token
  "accessToken": "",                 // 商业版为空（IAM token 走签名，不用它）
  "expires_at": "2026-10-16T03:32:19.788Z",   // 约 2 小时
  "domainId": "...",
  "refresh_token": "eyJ0eXAi...",    // JWT，约 30 天
  "loginContext": {
    "pkcePair": {"codeVerifier": "...", "codeChallenge": "..."},
    "dpopKeyPair": {"privateKeyJwk": {"kty":"EC","crv":"P-256","x":"...","y":"...","d":"..."},
                    "publicKeyJwk": {...}}
  },
  "id": "huawei-cloud-authentication"
}

提供者 ID 是 huawei-cloud-authentication（state.vscdb 里有 huawei-cloud-authentication-hid_xxx-usages），但 secret key 挂在 huaweicloud.authentication 扩展下。

3.7 模型与额度

GET https://opengw.developer.huaweicloud.com/api/v1/gateway/config
→ {"base_url":"https://opengw.developer.huaweicloud.com/v2",
   "models":[{"model_id":"deepseek-v4-flash-0731","context_window":1048576,"max_tokens":393216,"sort":10},
             {"model_id":"glm-5.3-flash","context_window":1048576,"max_tokens":131072,"sort":20},
             {"model_id":"deepseek-v4-pro-0813","context_window":1000000,"max_tokens":393216,"sort":30},
             {"model_id":"deepseek-v4.1-flash","context_window":1000000,"max_tokens":384000,"sort":40}]}

GET https://opengw.developer.huaweicloud.com/api/v1/user/tokens/balance
→ {"channel":"codearts","daily_token_limit":10000000,"daily_tokens_used":1234567,
   "total_balance":8765433,"total_quota":10000000}

另有一条 builtin 列表（企业/订阅模型，走 Agent-Type: PromptCenter）：

GET https://snap-access.cn-north-4.myhuaweicloud.com/v1/model/builtin
→ GLM-5.2 / Qwen3-VL-235B / kimi-k2.6-vl / openpangu-2.0-flash /
  openpangu-2.0-pro / glm-5.3 / glm-5.2-sft-harmony

3.7.1 免费福利 Token 活动（官方口径）

额度接口返回的 daily_token_limit = 10000000 对应官方活动 限时领取 Tokens （更新于 2026-09-23）：

项目 官方说明
适用人群 所有用户
额度 每位用户每日 1000 万 Tokens
清零 当日 24:00 清零，不累积至次日
领取 登录后客户端自动领取（网关复用同一凭据 → 自动共享同一份额度）
活动模型 deepseek-v4.1-flash、glm-5.3-flash、deepseek-v4-flash-0731、deepseek-v4-pro-0813
互通性 仅消耗福利 Token，不与积分包互通；额度用尽后这 4 个模型不可再使用
条款 权益不可转让；违规时官方保留立即取消、作废并收回的权利

"不与积分包互通"这一条决定了网关的设计：两条通道必须严格隔离， 且无法识别的模型名要默认落到免费通道 —— 宁可报 4005，也不能静默扣积分。

领取接口（每日签到）

复刻 out/extension.js 的 B3c()：

function Uce(){ return Iz()
  ? { claim:"https://snapengine-apig.cn-north-7.myhuaweicloud.com/api/v1/benefit/claim", ... }
  : { claim:"opengw.developer.huaweicloud.com/api/v1/benefit/claim", ... } }

async function B3c(){
  const [t,e,r] = await Promise.all([ getBenefitGatewayConfig(), getEducationGatewayConfig(), getExaminationGatewayConfig() ]);
  if (t) {                                    // benefit 通道开放才领
    const s = Uce().claim;
    const o = Iz() ? await U5(s,"GET","getClaimBenefit",n.host) : await q5("GET",s,"getClaimBenefit");
    ...
  }
  if (e) { ... claim with {channel:"education"} ... }
  if (r) { ... examination ... }
}

实测（商业版）：

GET https://opengw.developer.huaweicloud.com/v1/benefit-gateway-config
  → 200 {"enabled":true,"is_examination_domain":false,"examination_model_enable":false}

GET https://opengw.developer.huaweicloud.com/api/v1/benefit/claim
  → 200 {"error_code":"0000","error_msg":"success",
         "result":{"channel":"codearts","domain_id":"...","user_id":"...",
                   "user_name":"hid_xxx","create_time":...,"update_time":...}}

领取是幂等的：当天已领过再领一次仍返回 0000 success，额度不变。 因此网关的「每日自动签到」可以放心地按本地日期轮询执行， 重复调用没有副作用。

3.7.2 两条通道：maas_type 决定路由与计费

上游用请求头 maas_type 区分两条完全不同的通道 —— 同一个模型名在不同通道下 是否可用、是否计费都不一样：

通道 请求头 计费 模型清单来源 实测模型
benefit maas_type: benefit 消耗福利 Token（每日 1000 万，24:00 清零） opengw.developer.huaweicloud.com/api/v1/gateway/config glm-5.3-flash、deepseek-v4-pro-0813 …
credit 不带 maas_type 按积分计费 snap-access…/v1/model/builtin（需 Agent-Type: PromptCenter） glm-5.3、GLM-5.2、openpangu-2.0-pro …

实测矩阵（同一份请求体，只改 maas_type）：

glm-5.3     maas=(none)   -> 400 (空 body)      ← 见 3.7.3
glm-5.3     maas=benefit  -> 200 {"error_code":"4005","error_msg":"unsupported model"}
GLM-5.2     maas=(none)   -> 200 正常返回
GLM-5.2     maas=benefit  -> 200 {"error_code":"4005","error_msg":"unsupported model"}
openpangu-2.0-pro  maas=(none)  -> 200 正常返回
glm-5.3     maas=education -> 403 {"error_code":"TM.00001027","error_msg":"未通过学生认证，无法访问教育模型"}

结论：

  • 不带 maas_type → 积分（订阅）通道，可用 glm-5.3 / GLM-5.2 / openpangu-2.0-pro
  • 带 maas_type: benefit → 只认 benefit 清单里的模型名，其余报 4005
  • 还有 education / examination 两条特殊通道（学生认证 / 考试），普通账号用不了

3.7.3 上游怪癖：glm-5.3 只支持流式

glm-5.3  stream=false  -> HTTP 400，body 长度为 0
glm-5.3  stream=true   -> 200，正常 SSE（含工具调用）

这是目前唯一一个踩到这个坑的模型。网关的应对：检测到「4xx + 空 body」就自动改用 流式请求，再用本地聚合把分片拼回一次性响应，对客户端保持非流式语义； 同时把这个模型记为 stream-only，后续直接走流式，不再多打一次空枪。

3.7.4 模型名必须与请求头完全一致

body.model = "glm-5.3 "（尾随空格）
-> 406 {"error_code":"InferHub.001001011.406","error_msg":"The model not equals requestHeader's Model-Id"}

上游会校验 model-id 请求头与请求体里的 model 完全相等， 因此网关改写模型名时必须两处同步。

3.8 本地浏览器登录（OAuth 2.0 授权码 + PKCE + DPoP）

复刻 extensions/huaweicloud.authentication/dist/plugin.js。

授权 URL（buildLoginUrl）：

const a = `&ticket_id=${ticketId}&plugin-name=${LOGIN_PLUGIN_NAME}&plugin-version=${EXTENSION_VERSION}`;
return `${getPortalHost()}/authorize?theme=${themeKind}&locale=${env.language}` +
       `&uri_scheme=${CLIENT_ID}&client_id=${CLIENT_ID}&port=${port}` +
       `&code_challenge=${t.codeChallenge}&code_challenge_method=${t.codeChallengeMethod}${a}`;
参数 取值
getPortalHost() https://codearts.huaweicloud.com/portal（国际站 https://codearts.ap-southeast-1.huaweicloud.com/portal）
CLIENT_ID codearts-agent（= product.json 的 urlProtocol）
LOGIN_PLUGIN_NAME snap_AIIDE
code_challenge_method SHA-256
ticket_id WordArray.random(32).toString(hex) → 64 位十六进制
port 本地回调端口，≥10000（低于则重新随机）

PKCE 的 code_verifier = WordArray.random(32).toString(hex)（64 位 hex）， code_challenge = base64url(SHA-256(verifier))。

回调服务器（express，只监听 127.0.0.1）：

app.get("/oauth/callback", async (req, res) => {
  const secret = req.query.secret, redirect = req.query.redirect;
  if (secret && redirect) { this.secret = secret; res.redirect(307, redirect); return; }
  const code = req.query.code;
  if (code) {
    this.authorizationCode = code;
    res.redirect(307, `${portalHost}/login?login_succeed=true&uri_scheme=codearts-agent&locale=...`);
  } else {
    res.redirect(307, `${portalHost}/login?login_succeed=false&...`);
  }
});

注意是两跳：先 ?secret=&redirect=（门户校验后跳转），再 ?code=（真授权码）。

换凭据（getTokenByAuthenticationCode → requestToken）：

{ client_id: "codearts-agent",
  code: <authorizationCode>,
  code_verifier: <pkcePair.codeVerifier>,
  grant_type: "authorization_code",
  redirect_uri: `http://127.0.0.1:${port}/oauth/callback` }
// POST https://sts.cn-north-4.myhuaweicloud.com/v1/oauth2/tokens
// header: DPoP: <ES256 JWS，htm=POST，htu=上面的 URL>

实测：网关按上述格式发起请求，STS 返回 STS5.1805 invalid authorization code（因为用的是假 code）—— 说明请求格式已被服务端正确解析，链路是通的。

登录成功后可再调 GET https://sts.cn-north-4.myhuaweicloud.com/v5/caller-identity 补全账号名与 domain id（getUserInfo() 用的就是这个）。

3.8.1 回调地址为什么不能改成域名

authorize URL 只传 port=，不传 redirect_uri；门户按 client_id 的注册信息 自己拼出 http://127.0.0.1:<port>/oauth/callback。换凭据时 redirect_uri 同样是 写死的：

{ client_id: "codearts-agent",
  code: <authorizationCode>,
  code_verifier: <pkcePair.codeVerifier>,
  grant_type: "authorization_code",
  redirect_uri: `http://127.0.0.1:${i}${AUTH_REDIRECT_URL}` }   // 写死环回

也就是说 codearts-agent 是注册成 native app（RFC 8252 环回重定向） 的， 只接受环回地址。因此：

  • 反代 / CF 域名无法成为回调地址（STS 侧会拒绝 redirect_uri 不匹配）；
  • 浏览器永远把 127.0.0.1 解析到它自己，远端服务器上的回调服务器收不到。

可行的三条路：

方案 做法 依赖
SSH 本地转发 固定回调端口，本机跑 ssh -N -L <port>:127.0.0.1:<port> user@server 有 SSH 访问
OOB 粘贴回调 URL 浏览器停在 http://127.0.0.1:<port>/oauth/callback?... 报错页时，把地址栏 URL 粘回控制台；网关服务端把剩下的重定向链走完 无
导出 / 导入 session JSON 在能跑登录的机器上导出，导进服务器 无

OOB 模式的关键是：门户的两跳链 （?secret=&redirect= → ?code=）都是纯 HTTP 307， 所以网关可以用一个不自动跟随重定向的 HTTP client 逐跳走完， 直到 Location 指回自己的回调服务器，再从 query 里取 code。

3.9 运营活动子系统（「活动福利」）

复刻 out/extension.js 里的 s6i：

getWelfareDelivery: async () => {
  // Tokens 制套餐不参与
  if (subscription?.package?.is_token_package === true) return {code:0, data:{items:[]}};
  const headers = { "x-snap-traceid", "x-auth-token", "Agent-Type": "PromptCenter", "X-Language" };
  GET ${policyCenterDomain}/v1/ops/delivery?channel=IDE
}

claimWelfare: async (t, e) => {
  const { campaignId, idempotentKey } = e?.value ?? e ?? {};
  POST ${policyCenterDomain}/v1/ops/claim
  data: { campaignId, idempotentKey, channel: "IDE" }        // 幂等
}

generateInviteCode: async (t, e) => {
  const { campaignId } = e?.value ?? e ?? {};
  POST ${policyCenterDomain}/v1/ops/invite/generate
  data: { campaignId }
}

商业版（无 PromptCenterService 前缀）实测线上三个 campaign：

GET https://snap-access.cn-north-4.myhuaweicloud.com/v1/ops/delivery?channel=IDE
→ {"code":0,"message":"ok","data":{"items":[
     {"campaignId":3,"title":"推荐码上有礼","type":"INVITE_USER",
      "benefitAmount":1000,"benefitUnit":"CREDIT","status":"CLAIMED","claimable":false,
      "extra":{"triggerMode":"MANUAL_CLAIM","triggerEvent":"invite.success",
               "startTime":"2026-09-22T16:00:00Z","endTime":"2026-11-15T16:00:00Z"}},
     {"campaignId":2,"title":"学生认证领4000积分","type":"STUDENT_CERTIFIED", ...},
     {"campaignId":1,"title":"每日签到领1000积分","type":"USER_LOGIN",
      "benefitAmount":1000,"benefitUnit":"CREDIT","status":"CLAIMED","claimable":false,
      "extra":{"triggerMode":"MANUAL_CLAIM","triggerEvent":"user.login",
               "startTime":"2026-09-08T16:00:00Z","endTime":"2026-12-30T16:00:00Z"}}]}}

状态机：ELIGIBLE（可领）→ CLAIMED（已领）→ CONFIRMED（已到账）→ CONSUMED（已用）； claimable 仅在 ELIGIBLE 时为真。

领取的边界（重要）：

POST /v1/ops/claim  {"campaignId":1,...}
→ {"code":40001,"message":"尚未到达权益刷新时间，暂时无法领取"}      ← 每日签到，今天已领

POST /v1/ops/claim  {"campaignId":3,...}
→ {"code":40001,"message":"该活动类型需要先通过触发接口激活，无法直接领取"}  ← 邀请，需真实事件

也就是说：

campaign 触发方式 能否自动化
USER_LOGIN（每日签到） 每天时间推进 ✅ 可以，服务端到点会把 status 置为 ELIGIBLE
INVITE_USER（邀请） invite.success —— 好友真实注册 ❌ 服务端拒绝直接领取
STUDENT_CERTIFIED student.certified —— 真实学生认证 ❌ 同上

因此实现上只领服务端标记 claimable 且靠时间推进的活动， 并在代码层面把 INVITE_USER / STUDENT_CERTIFIED 硬排除（有单测锁定）—— 自动刷邀请属于多账号恶意注册，活动条款明确禁止。

邀请链接本身是合法的，可以生成：

POST /v1/ops/invite/generate  {"campaignId":3}
→ {"code":0,"data":{"inviteCode":"INV-...","inviteUrl":"https://devcloud...",
                    "status":"ACTIVE","valid":true,
                    "activationCount":2,"maxActivations":50}}

3.10 续期流程（代码已确认，未实跑）

extensions/huaweicloud.authentication/dist/plugin.js

CLIENT_ID   = env.uriScheme                       // "codearts-agent"
IAM_TOKEN_API = "/v1/oauth2/tokens"
iamStsHost  = "https://sts.cn-north-4.myhuaweicloud.com"

refreshToken(e,t){ requestToken(e, {
    client_id:     CLIENT_ID,
    code_verifier: e.pkcePair.codeVerifier,
    grant_type:    "refresh_token",
    refresh_token: t }) }

generateDpopPayload(htm,htu) => { htm, htu, iat, jti }
generateDpopJWE(pair,payload) =>
    new SignJWT(payload).setProtectedHeader({alg:"ES256", typ:"dpop+jwt", jwk: pair.publicKeyJwk})
                        .sign(importJWK(pair.privateKeyJwk,"ES256"))
// POST，headers: { DPoP: <jws>, Content-Type: application/x-www-form-urlencoded }
// 响应: { credentials: {access_key_id, secret_access_key, security_token, expiration},
//         refresh_token }

applyRenewedToken 里读的正是 e.credentials.access_key_id / secret_access_key / security_token / expiration + e.refresh_token。

四、实测结果（PoC）

tools/decrypt_session.py + tools/probe_api.py 均已跑通：

$ python tools/probe_api.py --tools
账号: hid_xxxxxxxxxxxx | 过期: 2026-01-01T03:32:19.788Z
== 可用模型 == 200   (4 个 benefit 模型)
== 额度 == 200       daily_tokens_used=1234567 / 10000000
== 对话 == 200
{"id":"as-vgdmew7p4h","object":"chat.completion","model":"glm-5.3-flash",
 "choices":[{"index":0,"message":{"role":"assistant","content":"你好",
   "reasoning_content":"The user asked me to reply with only two characters..."},
   "finish_reason":"stop"}],
 "usage":{"prompt_tokens":156,"completion_tokens":40,"total_tokens":196,
          "completion_tokens_details":{"reasoning_tokens":37}}}

Function Calling 也 OK：

{"choices":[{"index":0,"message":{"role":"assistant","content":"",
  "tool_calls":[{"index":0,"id":"chatcmpl-tool-...","type":"function",
    "function":{"name":"get_weather","arguments":"{\"city\": \"北京\"}"}}],
  "reasoning_content":"..."},"finish_reason":"tool_calls"}]}

流式 SSE 也是标准 chat.completion.chunk：

data:{"id":"as-pn2czaefth","object":"chat.completion.chunk",...,"delta":{"role":"assistant","content":"","reasoning_content":"The"}}

五、与参考项目 Doubao2API 的对照

参考项目：Doubao2API（把豆包工作桌面端复刻成 OpenAI 网关）。

维度 Doubao2API CodeArts2API（本方案）
应用形态 Chromium 原生（Lark 内核，biz.pak 224 MB） Electron（VS Code fork，app.asar 未打包，源码基本裸露）
凭据落盘 SQLite Cookies + DPAPI + AES-GCM + host 前缀 SQLite secret + DPAPI + AES-GCM（同源，无 host 前缀）
凭据解析 手写 SQLite b-tree 解析器（零依赖） 同样可手写；或直接读 ItemTable 单行
上游协议 私有 SSE（content_block 补丁流），需还原 OpenAI 原生，零转换
上游鉴权 Cookie + x-tt-passport-csrf-token SDK-HMAC-SHA256 签名 + X-Security-token
凭据有效期 长（Cookie） 2 小时，需要续期
逆向难度 高（要拆 pak + source map） 低（有 source map / 有完整日志 / 有明文 JS）

结论：核心工作量比 Doubao2API 小，唯一的额外件是「华为云签名器 + 凭证续期」。

六、落地实现

本报告的结论已全部实现，代码结构如下（每一项都标注了对应的逆向依据）：

CodeArts2API/
├─ main.go                     # 启动 / 参数 / 自动导入
├─ cmd/probe/                  # 本机诊断：凭据 / 模型 / 额度 / 对话探活
├─ internal/
│  ├─ codearts/                # 上游复刻层
│  │  ├─ session.go            #   Session / Account 模型（§3.6 的字段）
│  │  ├─ session_windows.go    #   DPAPI + AES-GCM 读取与安全回写（§3.6）
│  │  ├─ session_other.go      #   非 Windows 降级（手工录入）
│  │  ├─ sqlite.go             #   极简 SQLite 只读 + 定长原地写
│  │  ├─ signer.go             #   SDK-HMAC-SHA256（§3.5 的两个坑）
│  │  ├─ client.go             #   inferhub 转发 / 模型 / 额度（§3.2 §3.7）
│  │  ├─ refresh.go            #   DPoP(ES256 JWS) 续期（§3.8）
│  │  ├─ manager.go            #   凭据三级解析与续期编排
│  │  └─ debug.go              #   state.vscdb 键名转储
│  ├─ registry/                # 模型清单与别名解析（§3.7）
│  ├─ server/                  # OpenAI / Anthropic 兼容层 + 控制台
│  └─ store/                   # APIKey / 日志 / 设置 / 账号池
├─ tools/                      # 逆向 PoC 脚本（Python，与实现相互印证）
└─ docs/RECON.md               # 本报告
逆向结论 实现位置 验证方式
§3.5 签名两个坑 signer.go TestCanonicalURIAddsTrailingSlash、TestSignRequestStableVector
§3.6 凭据加密 session_windows.go TestReadItemValueFindsSecret
§3.7.2 两条通道路由 registry.go + client.go TestChannelRouting
§3.7.3 glm-5.3 只支持流式 codearts/sse.go + server/chat.go TestAggregateSSE*、TestIsEmptyRejection
§7.10 并发上限属临时故障 codearts/sse.go + server/chat.go TestIsTransientUpstream
§3.7.1 每日签到接口 codearts/benefit.go + server/claim.go TestDescribeClaimError
§3.8 浏览器登录 codearts/login.go + server/login.go TestPKCEPairShape、TestBuildAuthorizeURL、TestLoginCallbackTwoHops、TestListenCallbackPortInRange
§3.9 活动福利（每日积分 / 邀请） codearts/welfare.go + server/claim.go TestIsAutoClaimableSafetyInvariant、TestWelfareDeliveryParse
§3.8 DPoP 密钥绑定 refresh.go TestJWKThumbprintMatchesRefreshTokenBinding（比对 cnf.jkt）
回写安全性 sqlite.go + session_windows.go TestPatchItemValueRoundTrip、TestWriteBackSessionRoundTrip

七、风险与注意点

  1. 凭证续期是唯一的硬骨头。refresh_token 可能是单次使用 + 轮转的。 如果网关自己刷新，IDE 里存的旧 refresh_token 可能失效，导致 IDE 掉登录。 → 已落地策略：优先只读 state.vscdb（IDE 活着时它自己会续期，网关按 10 秒 TTL 跟随），只有在「IDE 未运行且凭证已过期」时才自己走 DPoP 续期， 并把新 session 安全回写 state.vscdb。
  2. 回写必须是无结构风险的。state.vscdb 是 SQLite，随便写会改坏页结构。 → 已落地策略：只做同长度字节覆写（不足处用 JSON 尾随空格补齐）， 不增删 cell、不动 freelist，写前自动备份 .codearts2api.bak； 长度超出时按设计跳过。
  3. SQLite 溢出页本地长度公式容易写错：取模基数是 M = ((U-12)*32/255)-23 而不是 X = U-35。用错会让带溢出页的记录 整行读不出来（state.vscdb 里那条 secret 就是 10 KB 的溢出记录）。
  4. 配额是共享的：daily_token_limit = 10,000,000，IDE 和网关共用同一份额度， 网关跑太多会把 IDE 当天的额度吃光。
  5. maas_type: benefit 是免费权益通道，模型集合由 gateway/config 决定； 换账号 / 换套餐会变。不带该头会 404 Route missed for model。
  6. 上游错误可能是 HTTP 200：未知模型返回 {"error_code":"4005","error_msg":"unsupported model"}，必须识别， 否则会被当成正常回复透传给客户端。
  7. 两条通道的计费完全不同：不带 maas_type 就是积分通道，会真实扣费。 网关必须按模型自动选通道，且对无法识别的模型名默认落到免费通道 —— 宁可报错，也不静默扣积分。
  8. snap-access.cn-north-4.myhuaweicloud.com 有备用域名 .cn，已做故障转移。
  9. 日志脱敏：内核日志会把 x-auth-token 截断、Authorization 打码，说明官方 自己也认为这些是敏感信息；网关的控制台与日志同样做了脱敏。
  10. 上游有并发上限：每个账号 3 个并发会话，打满返回 TM.00001041 并发会话数已达上限(3个)。这属于临时性故障， 必须与「账号失效」区分开：退避重试即可，不能计入账号失败， 否则一次并发打满就会让健康账号被熔断。 → 已落地策略：① x-ot-session-id / user-session-id 按凭据推导并复用 （不再每请求随机，否则等于每次开新会话）；② 尝试次数与账号数量解耦 （只有 1 个账号时也要能退避重试）；③ 退避 1s / 2s / 3s 上限。
  11. 客户端断开不等于账号故障：流式请求被客户端提前掐断时不应计入账号失败， 否则账号会被误判为不可用。
  12. refresh_token 是单次使用 + 轮转的：IDE 与网关同时持有 state.vscdb 时， 任一方消费掉 token 后另一方就可能拿到「已使用」的死 token（STS5.1806）， 此时只能重新登录。→ 网关侧对策：拿到新会话后立即写回 state.vscdb 并落盘（任何一次静默落盘失败都可能让账号不可恢复）， 同时状态文件落盘已改为串行 + 唯一临时文件。