dsh-codearts

DSH CodeArts Connect

[English](./README.en.md) | 中文

把华为云 CodeArts 接入 DeepSeek Harness（DSH），实现在 DSH 对话窗口里直接使用 CodeArts 提供的模型（GLM-5.2、盘古、Qwen、DeepSeek 等）。

功能

• 账号登录：在设置卡片里点一次「使用华为云账号登录」，浏览器完成授权后凭证自动落盘，无需手工填写密钥。
• 自动续期：凭证过期前自动续期；续期失败会在卡片上提示重新登录，不会静默使用失效凭证。
• 多账号轮转：可以存多个账号（在卡片上再登录一次即可添加）。某个账号的会话槽位被占时，

请求会自动换到下一个账号，不必干等 —— 这是「停止生成后重新提问要等半分钟」的正解。

• 可选模型：可在设置卡片里勾选要出现在模型选择器中的模型（配置项 enabledModels）。未勾选的模型只是不再被推荐，已经选定它的会话仍可继续使用；不勾选等同于提供全部模型。
• 模型清单自动发现：启动后与每小时各拉一次账号真实可用的模型（内置 / 限时福利 / agent-center 三路合并），失败时退回内置种子清单。
• 本机用量：卡片与 dsh-codearts usage 展示今日/累计的请求数与输入输出 token（按模型、按账号），以及每个账号的会话槽位占用（占用时正好解释了「为什么刚才要等半分钟」）。CodeArts 没有额度接口，这里只统计本机经插件发出的请求，官方额度明细见卡片上的链接。
• 用量走势：用量页顶部两张图 —— 近 7 天的缓存命中率按天一根柱子（分三档配色，掉了就说明系统提示词前缀变了或上下文变长），以及今天按小时的 token 量柱。逐小时口径从本版起才开始记，之前的钟点不回填；旧宿主不返回这两个序列时整块跳过，不会报错。
• 图片输入：支持视觉的模型可直接在对话里粘贴或拖入图片。
• 侧边栏图标：可选。在卡片「显示」页勾一下，DSH 左侧图标列里会多一个 CodeArts，点开直接在中间列显示整页版的设置卡片（配置项 showSidebarPanel，默认关闭 —— 那一列是全宿主共用的）。
• 降级路径：也可以在卡片里直接粘贴安全令牌，适用于脚本或排查场景。
• 命令行：status / models / usage / identity / doctor / logout 六个子命令，便于在无图形界面时检查登录状态、发现模型与查用量。

安装

详见 [INSTALL.md](./INSTALL.md)。核心是把 package.json + lib/ + cordis.patch.yml 放进

profiles//node_modules/dsh-codearts/，并在 profile 的 package.json、

node_modules/.package-map.json、node_modules/.modules.yaml 登记。

# 从本仓库构建产物
pnpm install && pnpm run build
node scripts/deploy.mjs [profileDir]     # profileDir 默认 <用户目录>/.dsh/profiles/desktop

改代码调试时不必反复重启：见 [DEV.md](./DEV.md)（宿主侧走 dsh-hmr 模块热重载，客户端卡片走

dsh-client-hmr 自动替换进浏览器）。

使用

1. 打开 DSH 设置 → CodeArts 卡片 → 「使用华为云账号登录」。

2. 浏览器打开授权页 → 登录华为云账号 → 自动跳回本机回调，凭证写入

$DSH_HOME/.codearts-auth.json。

3. 新建对话，provider 选择 codearts，再选一个模型即可开始。

命令行

dsh plugin --profile  exec dsh-codearts status [--json]   # 登录状态与种子模型清单
dsh plugin --profile  exec dsh-codearts models [--json]   # 向上游发现当前账号的真实模型
dsh plugin --profile  exec dsh-codearts usage [--json]    # 本机用量账本（非账号额度）
dsh plugin --profile  exec dsh-codearts identity [--fix]  # 查/回填账号稳定身份，合并重复条目
dsh plugin --profile  exec dsh-codearts doctor            # 不涉及密钥的环境诊断
dsh plugin --profile  exec dsh-codearts logout            # 清除本插件保存的凭证

models 是排查「模型选择器里怎么没有某个模型」的第一手段：它打印上游真实返回的清单

（内置 / 限时福利 / agent-center 三路合并），而不是插件里那份手维护的种子清单。

usage 读的是插件自己的账本（$DSH_HOME/.codearts-usage.json，按天保留 60 天）——

不是账号额度：CodeArts 没有额度接口，官方明细在

codearts.huaweicloud.com/portal/settings/personal-usage，卡片上也有这个链接。

identity 打印每个已存账号在上游的稳定 user_id（同一个 id 出现两次就是重复条目）；

加 --fix 会把它们合并到稳定键上，顺带补上 user_name / domain_id。

doctor 只输出路径、状态与版本，不会打印任何令牌内容，输出可以直接贴进问题反馈；logout

只删除本插件自己的凭证副本，不影响账号本身。

架构

沿用 dsh-codebuddy-cli 的结构：本地 loopback shim + pi-ai adapter。

DSH 对话窗口
   │  OpenAI /chat/completions 格式, Bearer=<本进程随机密钥>
   ▼
dsh-codearts shim  (127.0.0.1:随机端口)
   │  注入 x-auth-token: <华为云 STS security_token>
   │  + 华为云 AK/SK SDK-HMAC-SHA256 签名
   ▼
CodeArts /api/v2/chat/completions

shim 只监听回环地址，并校验 Host、Origin 与本进程随机密钥，其他本机进程无法冒用。

已知限制

• 凭证有效期约 2 小时，过期前会自动续期（刷新令牌与 DPoP 密钥绑定）；续期失败会提示重新登录。
• 上游对每个账号的并发会话数有硬性限制（3 个），每个会话占用约 1 分钟才释放，而且**中途

停止生成并不减免这个占用**：即使只跑了不到一秒就停，同样会占满一个名额。这是上游行为，

客户端无法提前释放。在卡片上添加第二个账号即可化解 —— 插件会把请求自动轮转到还有余量

的账号上。

• 只有一个账号时，刚停止过一次生成就立刻重新提问，仍可能要等约半分钟。插件会自动排队重试，