codearts2api

把 deepseek-harness-codearts 的 Jet Hub 多渠道账号管理与本机 OpenAI 网关搬到独立后端运行，不依赖 DSH 宿主，面向自建服务与容器部署。

上游本身是一个标准 cordis 插件。本项目把它的宿主依赖面就位后直接装载 —— 不 fork、不改上游代码，因此上游新增渠道、修协议、改界面时，本仓库通常 0 行代码改动（见升级时需要改多少代码）。

特性

多渠道账号管理：/admin 原样复用上游 Jet Hub 设置页 —— 14 个渠道的增删改查、账号池、额度与限流、模型级 / 渠道级开关、聚合路由面板、备份与迁移。
OpenAI 兼容网关：/v1/models、/v1/chat/completions、/v1/responses，支持 SSE 流式、图片输入与 token 用量统计。
两条聚合路由：aggregate/* 把同一模型的跨渠道候选归一化后按额度临期选号并失败切换；jet-hub-auto/auto 自动选渠道与模型。
状态隔离：账号、凭据与网关密钥全在本程序自己的目录（默认 ~/.codearts2api）， 不读写 ~/.dsh，可与 DSH 共存。
薄胶水：与上游的代码耦合只有一行 import，升级成本极低且可回滚。

提供的 HTTP 接口：

路径	说明
`GET /admin`	管理界面（上游 Jet Hub 设置页，无鉴权）
`POST /api/jet-hub`	Jet Hub 管理 RPC（上游实现的原样透传）
`GET /v1/models`、`POST /v1/chat/completions`、`POST /v1/responses`	OpenAI 兼容接口（上游网关）
`GET /healthz`	健康检查（不含密钥，可给监控用）

📋 变更记录见 CHANGELOG.md（新的在最前面），含历次上游升级的验证结果与踩到的坑。

快速开始

要求：Node.js ^22.19.0 || >=24.0.0，且 pnpm 在 PATH 上。

npm install          # 需要 pnpm，见下方说明
npm run build        # 生成 public/admin.js 与 public/upstream-jet-hub.js
npm start            # 默认 http://127.0.0.1:8080/admin

打开 http://127.0.0.1:8080/admin 即可看到与 DSH 里一致的 Jet Hub 界面。

⚠️ npm install 会从 gitee 拉取上游并执行它的 prepare（pnpm build:all），因为上游的 lib/ 不入库、必须现场编译。所以先确保 pnpm 可用： corepack enable（Node 自带）或 npm i -g pnpm。装不上时最典型的报错是 pnpm: command not found。

配置

环境变量

变量	默认	说明
`CODEARTS2API_HOME`	`~/.codearts2api`	本程序自己的状态目录：账号池、凭据、网关 Key 全在这里
`PORT`	`8080`	本服务端口（管理界面 + RPC + 可选反代）
`HOST`	`0.0.0.0`	监听地址
`PROXY_GATEWAY`	关	置 `1` 时把 `/v1/` 反代到插件网关（容器部署必须开*）
`DSH_OPENAI_GATEWAY_PORT`	`8326`	插件网关端口（只绑 `127.0.0.1`，见下）
`DSH_OPENAI_GATEWAY_ENABLED`	`1`	置 `0/false/off/no` 则强制停用网关（面板开关会显示被 env 阻止，且无法再打开）
`DSH_OPENAI_GATEWAY_API_KEY`	自动生成	网关 Bearer Key，优先于文件
`LOG_LEVEL`	`info`	`silent` / `error` / `info` / `debug`

状态目录

本程序是独立网关，状态全放在自己的目录（默认 ~/.codearts2api），不读写 ~/.dsh。启动时会把 DSH_HOME 与 DSH_JET_HUB_STATE_DIR 两个环境变量覆盖成这个目录（插件内部所有落盘点都读它们，这是让插件待在自家目录的唯一办法），因此外层 shell 里已有的 DSH_HOME（DSH 自己导出的）不会把我们的数据带进 DSH 的目录。

⚠️ 早期版本沿用了插件的判据（DSH_HOME → ~/.dsh），于是在装过 DSH 的机器上会把账号写进 ~/.dsh，与 DSH 抢同一份状态 —— 且当时凭据文件名写的是 jet-hub/credentials.json（臆造格式），而真实 DSH 用 .credentials.yaml，于是界面一直提示「凭据未配置」。现已修正。

从 DSH 或旧版本迁移账号

新版本启动时用的是空目录，所以第一次跑起来看不到原有账号。两种搬法：

方式 A：直接拷文件（推荐，最快）

本程序的存储格式与 DSH 完全一致（jet-hub/state.json + .credentials.yaml），所以直接把两个文件拷过去即可（已实测：账号与凭据全部可读）：

mkdir -p ~/.codearts2api/jet-hub
cp ~/.dsh/jet-hub/state.json       ~/.codearts2api/jet-hub/state.json
cp ~/.dsh/.credentials.yaml        ~/.codearts2api/.credentials.yaml
chmod 600 ~/.codearts2api/.credentials.yaml      # 权限校验要求，否则启动即报错

⚠️ 别整目录拷：~/.dsh 里还有 DSH 自己的缓存与 records 段，只需上面两个文件。

方式 B：走界面备份

用 /admin 的「备份」导出 → 在目标实例「恢复」导入（自包含 JSON，凭据一并带走）。导入模式的区别见远程部署的登录隧道。

⚠️ 无论哪种，不要再让两个程序共用同一个目录：它们对同一份状态各有假设，互相覆盖时很难排查。

使用

管理界面

打开 /admin。左侧导航为 14 个渠道 + 1 个「聚合 (跨渠道)」面板，页头「网关」按钮可查看监听地址、复制 API Key 与模型清单。

⚠️ /admin 没有鉴权，请先读安全边界。

OpenAI 兼容接口

先拿到网关地址与密钥，二选一：

打开 /admin → 页头 「网关」 按钮 → 显示实际监听地址、可复制 API Key、模型清单。
或命令行：

KEY=$(curl -s -X POST http://127.0.0.1:8080/api/jet-hub \
  -H 'content-type: application/json' \
  -d '{"type":"client-request","rpcId":"1","method":"jet-hub","payload":{"method":"gateway.getEnabled","payload":{}}}' \
  | python3 -c "import sys,json;print(json.load(sys.stdin)['result']['value']['apiKey']['value'])")
echo "$KEY"

客户端把 base_url 指向网关、api_key 填上面这个 Key 即可。模型 ID 形如 provider/模型名（如 codearts/deepseek-v4.1-flash、opencode/big-pickle）， 必须带渠道前缀；可用模型以 GET /v1/models 返回为准。

聚合路由

除各渠道自己的模型外，上游还提供两条聚合路由：

路由	行为
`aggregate/<规范模型名>`	把同一模型在各渠道的条目归一化，按额度临期顺序选号，失败时切换下一个候选
`jet-hub-auto/auto`	在候选渠道中自动挑选可用者与模型

/admin 的「聚合 (跨渠道)」面板可查看候选并设置是否参与轮换。两条路由都需要先配置好对应渠道的账号，否则目录为空。

部署

本机直跑

PROXY_GATEWAY=1 PORT=8080 CODEARTS2API_HOME=/var/lib/codearts2api node src/index.js

此时一个端口同时提供 /admin 与 /v1/*，可直接挂反代（nginx / caddy）。

Docker

docker build -t codearts2api .
docker run -d --name codearts2api \
  -p 8080:8080 \
  -v codearts2api-data:/data \
  codearts2api

CODEARTS2API_HOME=/data 已由镜像设好并声明为 VOLUME；不挂卷则容器重建后账号会丢。

⚠️ -p 8080:8080 会把无鉴权的管理接口一起暴露。公网部署务必在反代上加访问控制，或改为只监听回环再由反代转发。

为什么容器里必须开 `PROXY_GATEWAY`

插件网关的监听地址在上游是硬编码的 127.0.0.1（DEFAULT_GATEWAY_HOST 不可经环境变量修改 —— 那是上游刻意的安全边界，避免被误暴露成公网服务）。所以容器外无法直接访问 8326。开启 PROXY_GATEWAY=1 后，本服务把 /v1/* 透明转发到回环上的网关，于是对外只需暴露 8080。

反代不碰 Authorization：客户端仍须带网关的 Bearer Key，鉴权判定权始终只在插件网关一处，不存在两套鉴权。

反向代理

server {
  listen 443 ssl;
  server_name your-host;

  # 管理界面：建议加一层访问控制（本项目默认不带鉴权，见下）
  location / {
    proxy_pass http://127.0.0.1:8080;
  }

  # OpenAI 兼容接口：流式，必须关闭缓冲
  location /v1/ {
    proxy_pass http://127.0.0.1:8080;
    proxy_buffering off;          # 否则 SSE 被攒起来再吐，客户端会超时
    proxy_read_timeout 600s;
    proxy_set_header Connection '';
    proxy_http_version 1.1;
  }
}

安全边界

/admin 与 /api/jet-hub 没有鉴权（按需求如此）。它们能看到并操作你的全部账号凭据，也会明文回传网关 API Key。绝不要直接暴露在公网 —— 请在反代上加 Basic Auth / OAuth / IP 白名单，覆盖整个站点而不只是 /admin 页面。
网关密钥以明文存在 <CODEARTS2API_HOME>/openai-gateway/api-key（0600）。文件被改坏时上游会明确报错而不是悄悄换一个 —— 因为静默换钥会让所有已配置的客户端同时 401。恢复办法：删掉该文件重启（会重建），或改用 DSH_OPENAI_GATEWAY_API_KEY 环境变量。
/healthz 刻意不含密钥（只回开关、地址、模型数），可以安全地给监控用。

常见问题

远程部署的登录隧道

上游所有回调式登录（CodeArts / LobsterAI / TRAE / Loomy / Raccoon）都硬编码绑 127.0.0.1，端口随机且必须 ≥10000（真实插件的要求）。因此在远程服务器上部署时，浏览器授权后的回调会打到你本机，而不是服务器 —— 服务器上的登录流程会一直等不到回调。

可行工作流（不影响设备码类的渠道）：

在 /admin 点「+ 新建账号」，把返回的 loginUrl 复制出来，读出其中的端口（形如 ...:19283/...）；
在你本机执行隧道：ssh -L 19283:127.0.0.1:19283 user@your-server；
再打开那个 loginUrl 完成授权。

不受影响的渠道（无需隧道）：qoder / qodercn / cline（设备码轮询）、 buddy / workbuddy（轮询）、opencode（可直接粘贴 sk- key）。

远程部署的务实替代方案：在本地机器登录好，然后用 /admin 的 「备份」导出 → 在服务器上「恢复」导入，账号与凭据一并搬过去。导入时可选：

模式	行为	适用
整体还原（默认）	用备份内容覆盖整个账号池与模型黑名单	「恢复」按钮、整机迁移
单独导入	只追加账号，已存在的跳过，不碰黑名单与锁定表	从别人的备份里挑一个账号

⚠️ 「整体还原」会覆盖现有状态：若导出的那份备份里没有 OpenCode 的匿名通道条目，导入后它会消失、/v1/models 随之变空（模型数 0）。重启一次即可恢复（插件启动时会自动补一条匿名通道）。只想加账号、不想动本机现有配置时，请选**「单独导入」**。

图片输入

已支持。要点：

只接受 base64 内联的 data: URL。外部 http(s) 图片链接会被明确拒绝，错误码 unsupported_content（理由见下）。
媒体类型按字节硬校验：声明 image/jpeg 但内容是 png 会被拒（Declared image type does not match its bytes），不会把坏图发给上游。
图片落 <CODEARTS2API_HOME>/attachments/，内容寻址（文件名 = 图片的 sha256），同一张图重复发只存一份。
限制沿用官方默认：单张 ≤ 20MB、单条消息 ≤ 20 张 / 200MB、边长 ≤ 8192，支持 png / jpeg / webp / gif。

客户端要发图，必须选声明了图片能力的模型（GET /v1/models 的 input 字段含 image，例如 opencode/mimo-v2.6-flash-free）。用不支持图片的模型发图，上游会拒 —— 这与网关无关。

# 用 data URL 发图（B64 是图片的 base64；注意 data:image/png 要与真实字节一致）
curl -H "Authorization: Bearer $KEY" -H 'content-type: application/json' \
  -d "{\"model\":\"opencode/mimo-v2.6-flash-free\",\"messages\":[{\"role\":\"user\",
       \"content\":[{\"type\":\"text\",\"text\":\"这是什么颜色？\"},
       {\"type\":\"image_url\",\"image_url\":{\"url\":\"data:image/png;base64,$B64\"}}]}]}" \
  http://127.0.0.1:8326/v1/chat/completions

图片两端都要附件服务：

方向	谁调	方法
入站	网关把客户端 data URL 落成附件	`attachments.saveImage({data, mediaType})`
出站	各 provider 适配器把附件字节内联进上游请求	`attachments.readImage(ref)`（另有 `readImageRequest` 取缩放版）

⚠️ 插件是用 ctx.get('attachments') 取这个服务的（不是 inject），所以服务缺失时 不报错、只在真收到图片时才暴露。因此它必须在 ctx.plugin(plugin) 之前装载 —— 这也是本项目直接复用官方 @deepseek-ai/dsh-attachment-local 的原因（自实现要重担格式、权限、原子写、mime 校验、缩放等一堆细节）。

设计说明：为什么暂不支持外部 image_url

现状：拒绝（错误码 unsupported_content）。这是上游硬编码的行为，本仓库无法通过配置打开 —— 见 deepseek-harness-codearts/src/openai-gateway/images.ts：

if (typeof url === "string" && !url.trim().startsWith("data:")) {
  throw new Error("网关暂不支持 http(s) 图片链接：出于安全考虑（避免 SSRF），" + "只接受 base64 内联的 data URL 图片。")
}

为什么先不改（2026-10-03 的决定）

大多数客户端（Cline / Cherry Studio 等）拖图进对话框时本来就转 base64， URL 形态并不常见 —— 先观察实际会不会碰到。
上游的拒绝理由在「网关可能被共享」时是成立的：让网关去下载外部 URL 是一个真实的 SSRF 面（能打环回、内网服务、云元数据端点 169.254.169.254），而且响应内容会被模型看到，等于把内网接口的返回泄露给模型 / 日志。
本项目是自用网关，风险确实比上游设想的小；但风险大小取决于部署形态 （是否被反代到公网、同机是否跑着别的内部服务），而不是「自用」这个词本身。

将来若要支持，建议做法（方案 B）

在本仓库的 /v1/* 反代层拦一道（src/server.js 的 proxyToGateway）：检测请求体里的 http(s) image_url → 下载 → 转 base64 data URL → 重写请求体再转发给插件网关。不要改上游。必须带的防护（缺一不可）：

防护	原因
只允许 `https`	明文传输 + 降级攻击
解析 DNS 后拒绝私有/保留地址（`10.` / `172.16.` / `192.168.` / `127.` / `169.254.` / `::1` 等）	SSRF 的核心防线
每次重定向都重新校验	否则一个 302 就能绕到内网
超时 + 大小上限（≤20MB，与附件上限一致）	防止挂死与内存打爆
环境变量开关（默认关）+ 文档写明风险	SSRF 风险随部署形态变化，属运维决策

环境变量建议：ALLOW_IMAGE_URL=1（默认关）—— 打开后 /healthz 应回显该状态，让人一眼看出「这台机器允许外部图片 URL」，避免忘记自己开过。另可加 ALLOW_IMAGE_URL_HOSTS= （逗号分隔白名单）只放行受信任图床，比全局放开更稳妥。

已知边界

网关关闭后：/v1/* 会回 502 gateway_unreachable 并提示去 /admin 检查，而不是挂起或回 HTML 错误页。
DSH_OPENAI_GATEWAY_ENABLED=0 时面板开关会被禁用并提示「已被环境变量停用」 —— 这是上游的优先级设计（env > 面板），不是开关坏了。
端口冲突（8326 被占用）：网关只记日志、跳过启动，不影响 /admin。

架构

本仓库是薄胶水：全部实现都是「把上游需要的宿主环境就位」，业务逻辑一行都不复制。因此本仓库不含上游源码或其构建产物 —— public/admin.js 与 public/upstream-jet-hub.js 均由 npm run build 现场生成并被 .gitignore 排除，上游只通过 package.json 的 git 依赖引入。

宿主依赖面

上游插件的入口是 apply(ctx)，宿主依赖面只有这五个服务。本项目把它们就位后即可直接 ctx.plugin() 装载它：

服务	本项目怎么做	为什么
`credentials`	复用官方 `@deepseek-ai/dsh-credentials-local`	写 `<home>/.credentials.yaml`；自己实现会重担格式/权限/原子写/锁，任何一处偏差都表现为静默读不到凭据
`attachments`	复用官方 `@deepseek-ai/dsh-attachment-local`	图片输入的地基（入站落盘 + 出站内联）。插件用 `ctx.get` 取它，缺了不报错、只静默失去图片能力
`commands`	空对象	插件把它列在 `inject` 里但代码零调用；缺了会永久 pending
`connection`	自实现注册表（`src/connection.js`）	Jet Hub 管理端点经此接入，请求原样透传
`llm`	真实 `@deepseek-ai/dsh-llm` 的 `LlmRuntime`	网关与各渠道适配器都通过它发请求，不能替身

⚠️ 凭据服务必须走 ctx.plugin()，不能 new LocalCredentialProvider(...)：载入既有凭据的逻辑在它的 [Service.init] 生成器里，只有被 cordis 作为插件装载时才会执行。手动 new 出来的实例不会读磁盘上的既有凭据，且不报任何错 —— 症状同样是「凭据未配置」（已实测）。

管理界面同理：上游的浏览器产物（dsh-codearts-auth/client）只 external 了 react，本项目用两个 script 标签 + 一个桩 ctx 把它的 JetHubPage 组件捞出来直接渲染（见 web/admin.jsx）。因此界面随上游走，本仓库不含任何布局代码，上游改版后重新 npm run build 即可。

依赖划分

一个常见疑问：界面要用 react，为什么它不算运行期依赖？

因为 /admin 用的是构建期打包：npm run build 时 esbuild 把 react / react-dom 与页面代码一起打进 public/admin.js（约 1.2MB，自带 React 运行时、无任何外部 require）。运行期（node src/index.js）不加载 react，只是把这份静态文件发给浏览器。据此划分：

包	分类	谁在用
`@deepseek-ai/cordis`、`dsh-llm`、`dsh-credentials`、`dsh-credentials-local`、`dsh-codearts-auth`	`dependencies`	服务器进程运行期真正 `import`
`esbuild`	`devDependencies`	只在 `npm run build` 时运行
`react`、`react-dom`	`devDependencies`	只在构建期作为输入被 esbuild 读取；产物已内联
`jsdom`	`devDependencies`	只在 `npm test` 里模拟浏览器 DOM

⚠️ 唯一的坑：npm run build 需要 devDependencies。若构建环境里设了 NODE_ENV=production，npm install 会默认跳过它们，构建直接失败。故 Dockerfile 里显式写了 npm install --include=dev。

开发

欢迎提 Issue / PR。

测试与规范

npm test              # 单元 / 集成测试（node --test）
npm run lint          # ESLint
npm run lint:fix      # ESLint 自动修
npm run format        # Prettier 写入
npm run format:check  # Prettier 只检查（CI 用）

代码风格为 semi: false / printWidth: 120（flat config）。几处项目特有的约定：

eslint.config.js 排除编译产物：public/admin.js、public/upstream-jet-hub.js 是构建时从上游拷贝 / 打包出来的（约 1.6MB），既不是本仓库代码，也会让 lint 从秒级变成分钟级。
Node 与浏览器端分别配置 globals：src/、tests/ 用 globals.node； web/admin.jsx 用 globals.browser（它用到 document / fetch）。
.jsx 显式列进 files：flat config 默认只匹配 *.js，不写的话 web/admin.jsx 会被静默跳过（不报错也不检查）。
.prettierignore 同样排除那两个产物（npm run format 会写文件，不排除就会把上游代码重排一遍，既无意义、又可能改变产物）。public/admin.html 不排除 —— 它是手写源码（已实测：格式化后 <script> 的加载顺序不变，/admin 仍正常渲染）。

⚠️ 两个产物由 npm run build 生成，被 .gitignore 与 .prettierignore 双重排除。不要提交或格式化它们。

测试覆盖

宿主装配（provider 路由注册与双向比对、端点挂载）、/admin 真实渲染、账号增删改查、备份往返、网关启停（含端口真实释放）、模型 / 供应商开关、/v1/* 反代（含鉴权不被绕过、网关不可达时的错误信封）、SSE 流式、状态目录隔离（不污染 ~/.dsh）、凭据可读性、关闭后无残留文件监听、图片输入（附件服务装配、落盘往返与内容寻址、mime 硬校验、外部链接被拒、坏图报可读错）。

目录结构

src/
  index.js         进程入口：装配 → 监听 → 优雅退出
  host.js          宿主装配（五个服务 + 装载插件 + 契约核对）★核心
  upstream.js      对上游的全部假设（契约常量 + RPC 信封）
  connection.js    connection seam（管理端点注册表）
  server.js        HTTP：/admin、/api/jet-hub、/v1/* 反代、/healthz
  home.js          state home 解析（自己的目录，与 DSH 隔离）
  logger.js        cordis 日志 → stdout/stderr
  （credentials / attachments 用官方实现，无自实现文件）
web/admin.jsx      /admin 的薄入口（复用上游 JetHubPage）
public/admin.html  页面外壳（两个 script + loader shim）
build.mjs          前端构建（拷贝上游产物 + 打包入口）
tests/             行为测试（node --test）
eslint.config.js   ESLint（flat config，排除编译产物）
.prettierrc.json   代码风格
Dockerfile         容器构建
CHANGELOG.md       变更记录（新的在最前面）

升级上游

依赖锁在某个 commit 上。下面是实测验证过的完整流程（含一个必须避开的坑）。

第 1 步：查上游最新 commit

上游仓库：https://gitee.com/iJetLi/deepseek-harness-codearts

git ls-remote https://gitee.com/iJetLi/deepseek-harness-codearts.git refs/heads/master
# 输出形如：6fc1f61523df915166dae20922d05689ae7eccba  refs/heads/master
#            ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 这就是要用的 commit

如果你本地有 clone，也可以：

cd /path/to/deepseek-harness-codearts
git fetch origin && git log --oneline -5 origin/master          # 看新提交
git log --oneline <当前锁的commit>..origin/master               # 看这次更新了什么
git diff --stat <当前锁的commit>..origin/master -- src/ | tail  # 看改了哪些文件

第 2 步：更新依赖

⚠️ 这步有坑，别只改 package.json。

NEW=<第 1 步拿到的 commit>

npm install "dsh-codearts-auth@git+https://gitee.com/iJetLi/deepseek-harness-codearts.git#$NEW" \
  --include=dev --no-audit --no-fund

⚠️ 必须用上面的写法（带包名与 @ spec），不能只改 package.json 再 npm install。 实测过：package-lock.json 里记着旧 commit 的 resolved，只改 package.json 的话普通 npm install 会静默沿用 lock 里的旧 commit（输出只说 added 1 package，不报错），你以为升级了其实没有。上面的写法会让 npm 同时更新 package.json 与 package-lock.json。

若已经踩坑，两个文件都改成新 commit 后 rm -rf node_modules/dsh-codearts-auth && npm install。升级后务必核对一次：
node -e "console.log(require('./package-lock.json').packages['node_modules/dsh-codearts-auth'].resolved)"
# 末尾应是新 commit

npm install 会重新 clone 上游并跑它的 prepare（pnpm build:all）现场编译 lib/ —— 所以要确保 pnpm 可用（corepack enable）。

第 3 步：重建前端产物（必做）

界面的 JS 是上游产物的拷贝，不重建就还是旧界面：

npm run build

第 4 步：测试与规范

npm test              # 行为测试
npm run lint          # 上游若改了产物形态，这里能发现我们的代码跟不上了
npm run format:check  # 确认代码风格一致

按失败信息分两种处理：

失败的是	说明	怎么办
`host.test.mjs` 的「provider 列表与期望不一致」	上游增删了渠道	按报错里给出的实际列表，更新 `tests/host.test.mjs` 的 `EXPECTED_PROVIDERS`（只改测试）
`admin-ui.test.mjs` 的「只请求我们 shim 能提供的模块」	上游引入新的外部依赖	在 `web/admin.jsx` 的 `captured.factory()` 里补上该模块（或改用别的接入方式）
`home-isolation.test.mjs`	存储格式/隔离被改坏了	看具体断言，通常与 `src/home.js` 或凭据服务有关
其它	契约漂移	对照 `src/upstream.js` 顶部契约表

第 5 步：启动确认契约（关键一步）

npm start

启动日志里必须有这一行：

[codearts2api] 上游契约核对通过：/api/jet-hub, /api/jet-hub/captcha-carrier

没有这行、或直接抛错，就说明上游改了端点路径或装配方式 —— 错误信息会告诉你去 src/upstream.js 改哪个常量：

上游插件未注册预期的管理端点 /api/jet-hub（实际注册：…）。
这通常意味着上游改了端点路径或装配方式 —— 请对照 src/upstream.js 顶部的契约表…

第 6 步：真机点一下（建议）

# 打开 http://127.0.0.1:8080/admin
# 1. 左侧导航完整（14 个渠道 + aggregate 聚合设置面板；另有 jet-hub-auto 路由）
# 2. 账号列表能读出 source（不是「凭据未配置」）
# 3. 点页头「网关」→ 开关能开关、能复制 Key

万一升级后出问题：回滚

npm install "dsh-codearts-auth@git+https://gitee.com/iJetLi/deepseek-harness-codearts.git#<旧commit>" --include=dev
npm run build && npm test

💡 升级只会改 package.json / package-lock.json / public/*.js（产物）。 你的账号数据在 ~/.codearts2api，与升级无关。升级前想稳妥可以在 /admin 里「备份」导出一份。

历次升级的详细结果（改了哪些文件、测试与真机验证、踩到的坑）记在 CHANGELOG.md。查当前锁定版本：

node -e "console.log(require('./package.json').dependencies['dsh-codearts-auth'])"

升级时需要改多少代码

我们与上游的代码耦合只有一处：

import * as plugin from "dsh-codearts-auth" // src/host.js 唯一的一行

其余全靠 cordis 的注入机制与 HTTP 转发。因此上游常见的改动类型（新增渠道、修协议、改额度逻辑、加模型、改 UI 布局）都不需要动本仓库：

上游改了什么	我们要改	为什么
新增一个渠道（provider）	0 行（仅测试期望列表）	我们不含任何渠道名单，界面与 `provider.status` 都是动态的
改某个渠道的协议/登录	0 行	逻辑全在上游
改界面布局 / 样式	0 行（只需 `npm run build`）	界面是上游产物的原样复用
改网关行为（/v1/*）	0 行	网关是上游的，我们只转发
加 RPC 方法	0 行	我们的转发是通用透传，不枚举方法
改管理端点路径	1 个常量	`src/upstream.js`
改 RPC 信封 / 线协议	1 个函数	`src/upstream.js` 的 `rpcEnvelope()`
改客户端 loader 形态	可能 1~2 处	`public/admin.html` + `web/admin.jsx`
改 slot 名 `settings.section`	1 个常量	`src/upstream.js`
改插件 `inject` 列表	`src/host.js` 的 provide	少了服务插件会永久 pending

Name		Name	Last commit message	Last commit date
public		public
src		src
tests		tests
web		web
.dockerignore		.dockerignore
.gitignore		.gitignore
.prettierignore		.prettierignore
.prettierrc.json		.prettierrc.json
CHANGELOG.md		CHANGELOG.md
Dockerfile		Dockerfile
README.md		README.md
build.mjs		build.mjs
eslint.config.js		eslint.config.js
package-lock.json		package-lock.json
package.json		package.json

Latest commit

History

Folders and files

Repository files navigation