English quick start · 环境配置 · 安全说明 · 测试报告
为 Pi 和 OMP（Oh My Pi） 接入 CodeArts 的非官方 Provider 插件。直接使用官方网页授权、DPoP Refresh Token 和签名请求，不启动 CodeArts CLI，不需要本地代理，不要求手工复制 Token。
- 双宿主原生入口，共享认证与协议代码，不通过另一宿主中转。
- 独立 OAuth 登录，各宿主按需续期，并持久保存自己轮换后的凭据。
- 动态发现账号可见的模型、图片能力和服务端公布的思考等级。
- 多环境独立 Provider：官方环境、兼容协议的企业/区域环境分别授权，不混用凭据。
- 流式文本/思考、工具调用与结果回传、图片、取消、busy/idle 心跳。
- 官方环境可只读查询个人套餐、Token 已用量和剩余量。
- 默认不读取或依赖原 CodeArts 客户端登录；临时票据登录不会冒充长期授权。
不是华为官方项目。不是整个华为云的通用认证插件。 兼容协议、账号权益与已验证范围见下文。
当前验证版本：Pi 1.5.0、OMP 18.18.6。无需自行编译。
pi install git:github.com/dull-bird/pi-codearts@v0.4.0在正在运行的 Pi 中执行 /reload；新启动的 Pi 自动加载。
如果此前已手动安装开发软链接，不要再同时安装 Git 包。先移除自己创建的
~/.pi/agent/extensions/codearts链接，再用pi install，避免重复注册。
omp plugin install 'github:dull-bird/pi-codearts#v0.4.0'
omp login codearts
omp --model codearts/glm-5.3-flashOMP 使用自己的 omp.mjs 原生入口，不加载 Pi 专用的 index.ts。重启 OMP 后生效。开发者也可在克隆的仓库执行 omp plugin link .。
Pi 与 OMP 必须分别登录。不要复制两者的 Refresh Token 或认证数据库，否则两个宿主轮换同一个令牌可能互相使登录失效。升级无需重做已有 Pi 独立授权。
- 在 Pi 执行
/login，选择 CodeArts（官方）。 - 在官方浏览器页面完成授权。插件不接触账号密码。
- 成功后自动发现模型。若目录查询临时失败，执行
/codearts-refresh。 /model选择 CodeArts 模型，例如：
/model codearts/glm-5.3-flash
之后可以直接启动：
pi --model codearts/glm-5.3-flash每个使用者登录自己的账号，不共享作者的账号、权益或凭据。没有安装 CodeArts CLI 也可以使用独立登录。
浏览器授权使用 PKCE 和 ES256 DPoP，取得服务端签发的临时 AK/SK、Security Token 和 Refresh Token。两个宿主分别保存到自己的认证存储，在宿主的刷新协调机制下按需续期并保存轮换后的凭据。OMP 使用原生 SQLite AuthStorage；不复用 Pi 或原客户端的 Refresh Token。
- 到期时间以服务端响应为准，不硬编码“永久有效”或固定天数。
- 扩展预留 1 分钟；Pi 自己还会应用提前刷新窗口，当前默认约 5 分钟。
- 续期是按需发生的，退出 Pi 后不需要常驻一个登录进程。
- 刷新后的凭据会持久保存，下次启动继续使用。
- Refresh Token 被撤销、过期或账号政策改变，仍须重新
/login。 长期登录不等于永久绕过服务端认证。 - 默认要求 Refresh Token。旧式临时 ticket 授权、未发放 Refresh Token 的授权会明确失败，不会偷偷退回原客户端登录。
少数旧部署只能临时登录，可在专用环境显式启用 allowTemporaryLogin；这会失去自动续期保证。只读复用原客户端也必须显式启用 allowLocalLogin。详见环境配置。
插件额外查询 CodeArts 的 thinking-variants 能力接口，不再只根据模型目录里的 thinking_type 判断。只有服务端公布的等级会显示在 Pi 选择器里；缺失等级使用 null 排除，而不是把所有模型强行标成可选 low/medium/high。
当前测试账号中：
| 模型 | 服务端公布的思考强度 |
|---|---|
GLM-5.2 |
high、max |
glm-5.2-sft-harmony |
high、max |
| 其余当前可见模型 | 当前未公布可选强度 |
GLM-5.2 的 high 和 max 在两个宿主中均已真实收到结构化思考流；选择映射为请求中的 reasoning_effort。开启思考不保证每次回答都有可见思考：简单题可能只有正文；插件不伪造思考文本，也不删除系统提示词来强制触发。未公布强度不等于模型本身完全不能思考，只表示此服务当前没有提供可依赖的强度选择。
刷新能力后，重新选择模型；必要时 /reload，使当前选中的旧模型对象也得到更新。Pi 中可使用 /thinking（或配置的思考等级快捷键）选择支持的等级，也可：
pi --model codearts/GLM-5.2 --thinking high数据会动态更新，协议不会凭空猜测。
- 登录时查询目录；交互会话启动时，超过 6 小时的模型缓存会在后台尝试刷新。
/codearts-refresh可立即重新查询模型和思考等级。- 新增模型、服务端公布的能力或强度变化，可在接口兼容的前提下自动跟随。
- 兼容协议的其他环境可配置授权入口、Token 服务、API 网关、路径、Client ID、PKCE 方法和模型发现策略。
- 未知域名不会接收已有凭据；探测候选环境只读配置，不扫描网络或逐域名试 Token。
- 如果服务端改了认证协议、签名算法或响应格式，仍需要更新插件。
官方环境目前使用原官方客户端所使用并已验证的北京四服务入口；这不是按用户位置自动选区，也不能仅凭入口判断模型执行位置或数据驻留政策。
| 场景 | 状态 |
|---|---|
当前官方授权和 cn-north-4 网关 |
真实验证 |
| 同协议、不同账号/Agent/区域/企业地址 | 可配置；需相应环境实测 |
| 企业 SSO 最终返回兼容的 CodeArts OAuth 凭据 | 可配置；未宣称全部企业 SSO 已验证 |
| Agent 目录没有固定默认 Agent | 自动发现该账号可访问的其他 Agent |
兼容签名认证、使用 OpenAI /models 的目录 |
可配置 openai 发现策略 |
| 没有发现接口的兼容部署 | 可配置静态模型及明确的思考等级 |
| 认证协议完全不同的私有部署 | 需要新适配器，不保证只换地址即可 |
| 华为云其他产品账号、任意 API Key | 不据此认定兼容 |
目前发现的 11 个模型不是发布时的硬编码模型清单；账号权限、可见模型和积分以服务端为准。
在 Pi 或 OMP 的交互界面执行：
/codearts-usage
只读调用官方客户端使用的 /snap-manager/v1/statistics/plugin，沿用当前宿主自己的独立 OAuth 凭据。显示套餐、统计周期、Token 已用量/总额以及按两者计算的剩余量，不输出凭据或账户原始响应。如果当前账号有 model_metrics，也显示其用量百分比和启用状态。
- 这是套餐统计，不是本次会话 token usage，也不是推理请求。
- 剩余量按服务端总额减已用量计算；有效期、套餐变更和统计延迟以控制台为准。
- 积分与 Token 是不同计量单位，不能把 Token 数值换算为现金或积分余额。
- 目前只适配已实测的官方环境；自定义企业环境不会被探测，也不会收到该请求。
- 可选
npm run test:usage验证真实账号查询（无推理消耗）；OAuth 无法读取套餐时会明确报错。
| 命令 | 用途 |
|---|---|
/login |
独立登录官方环境或已配置的其他环境 |
/codearts-usage |
只读查询官方套餐、Token 用量和剩余量 |
/codearts-refresh [provider-id] |
刷新该环境的模型和思考能力 |
/codearts-status [provider-id] |
登录来源、续期能力、到期时间、网关和思考等级；不显示秘密 |
/codearts-environments |
列出已信任的环境，不发送认证请求 |
/codearts-configure [id] |
从完整本机配置导入候选环境，或手动配置，确认后单独授权 |
未指定环境时，优先使用当前选中的 CodeArts Provider，否则使用官方 codearts。其他环境如 company 注册为 codearts-company。
默认目录：
~/.pi/agent/codearts.json 用户明确配置的环境；不是认证文件
~/.pi/agent/auth.json Pi 管理的敏感凭据，请勿分享
~/.pi/agent/codearts-models.json 官方环境模型缓存，不含凭据
~/.pi/agent/codearts-models-<id>.json 其他环境的隔离缓存
OMP 默认在 ~/.omp/agent/ 下保存同名环境配置和模型缓存，凭据由 agent.db 管理；profile/XDG 设置可能改变位置，以宿主实际 agent 目录为准。账户显示为不含账户 JSON 的稳定不透明 ID。
遵循宿主解析的 agent 目录，包括 Pi 的 PI_CODING_AGENT_DIR。PI_CODEARTS_CONFIG 可指定个人环境配置文件。不自动读取项目仓库里的端点配置，以免项目文件把凭据引向陌生服务器。 企业地址本身也可能敏感，不要随意把个人配置提交到 Git。
已有 v0.1 独立官方凭据可继续使用；无需为了升级立即重新授权。其他环境必须分别授权；变更认证地址会使原绑定失效，而不是迁移 Refresh Token。
上面的版本标签安装固定在 v0.4.0。升级时安装新的版本标签，并移除旧的包声明。若希望手动跟随 main，可不指定标签：
pi install git:github.com/dull-bird/pi-codearts
pi update --extensions更新后 /reload。不后台下载执行新代码。
用 pi list 查看实际安装来源，再用 pi remove <source> 移除。移除插件不会改写原 CodeArts 客户端认证文件。需要删除 Pi 的独立登录时，先通过 Pi /logout 操作。
git clone https://github.com/dull-bird/pi-codearts.git
cd pi-codearts
npm ci --ignore-scripts
npm run check
npm test宿主包是 peer dependencies，开发依赖用于离线测试；发布包不捆绑另一份 Pi，也没有额外运行时 npm 依赖。测试使用 Node 24/26；插件运行时由 Pi 加载 TypeScript。
npm run test:live # 真实文本、工具、取消、图片、思考强度；需先独立登录
npm run test:e2e # 真正运行 Pi，执行临时目录里的 read 工具
npm run test:refresh # 在凭据锁内真实刷新 Pi 自有凭据，再用新进程验证持久登录
npm run test:login # 重新打开浏览器，走 Pi 原生登录，再测试真实刷新
npm run test:omp:live # OMP 独立登录后的刷新、文本、工具、图片、思考和取消
npm run test:omp:e2e # 真正运行 OMP，read 工具循环与 high/max 思考 deltanpm test 的 OMP 集成测试需已安装 OMP（默认 ~/.local/bin/omp，可设置 CODEARTS_OMP_BINARY），否则明确跳过。该测试解包发布 tarball，再使用合成凭据及响应运行 9 阶段原生宿主测试。Linux CI 默认不安装 OMP，不把跳过说成通过。
真实测试会消耗少量账号额度。 只上传固定测试文本、本地生成的 PNG 和临时测试文件，不上传用户项目。test:login 会更新 Pi 的 CodeArts 登录，不作为普通离线回归的一部分。离线 CI 不使用账号或 secrets。
费用字段当前为 0，表示没有配置可直接换算的现金定价，不代表 CodeArts 免费。兼容性限制、测试详情和安全边界见对应文档。
An unofficial dual-host Pi / OMP package registering a native CodeArts provider. Native browser OAuth with refresh-token rotation; no CodeArts CLI subprocess and no local proxy.
pi install git:github.com/dull-bird/pi-codearts@v0.4.0For OMP: omp plugin install 'github:dull-bird/pi-codearts#v0.4.0', then omp login codearts. Each host uses its own entry point and credential store; never share refresh tokens between hosts.
In Pi: /reload, /login → CodeArts, then /model. Each user authorizes their own account. Models and supported reasoning levels are discovered from the service, not copied from the author's account. Compatible enterprise endpoints can be configured as separate, credential-isolated providers; arbitrary Huawei Cloud products and incompatible SSO deployments are not automatically supported. Refresh tokens can still be revoked by the service.
MIT licensed. Not affiliated with or endorsed by Huawei. Use only with authorized accounts and in accordance with applicable service terms and organizational policies.