dsh-cnb
useragent-1/dsh-cnb
CNB (cnb.cool) integration: WeChat QR sign-in, repository and environment control, organization usage, and CNB AI gateway wiring. Its HTTP routes have no DSH access check, so a web page open in your browser could call them.
설치
dsh plugin --profile web add github:useragent-1/dsh-cnbREADME
dsh-cnb
CNB(cnb.cool)接入 DeepSeek Harness 的插件:扫码登录拿 token、管仓库、看云原生开发环境与组织用量,并把仓库自带的 CNB 网关模型一键写进 dsh 的模型配置。
一个插件,三个入口共用同一套能力:侧边栏 CNB 面板、cnb_* 工具、以及 llm-pi-ai 的 provider 路由。
能力
| 模块 | 面板 | 工具 | 说明 |
|---|---|---|---|
| 扫码登录 | 账号 | cnb_status cnb_login_begin cnb_login_poll | 微信扫码 → 自动创建访问令牌 → 存进 dsh 凭证库 |
| 仓库 | 仓库 | cnb_repos cnb_repo_status cnb_repo_create cnb_repo_delete | 列表 / 详情 / 新建 / 删除(删除需 confirm: true) |
| 云原生开发 | 开发环境 | cnb_workspaces cnb_workspace_open cnb_workspace_control | 列表 / 启动 / 停止 / 删除,读取 .cnb/settings.yml 里的按钮配置 |
| 组织用量 | 用量 | cnb_usage | 额度 + 当月用量,构建/开发核时、GPU、Git、对象存储、AI Credits |
| 网关模型 | 网关模型 | cnb_gateway_probe cnb_gateway_configure | 探测仓库的 CNB AI 网关,并写入 llm-pi-ai 路由 |
安装
插件是标准 dsh bundle。下载后把目录装进你的 profile:
# 克隆到任意位置
git clone https://github.com/useragent-1/dsh-cnb.git
cd dsh-cnb && npm test # 可选:先跑一遍离线测试
# 装进你的 profile(把 <profile> 换成你实际用的,例如 web)
dsh plugin --profile <profile> add /绝对路径/dsh-cnb
dsh plugin 转发给 pnpm,所以本地目录要用绝对路径。
装完在 dsh 的 Web 界面侧边栏会出现 CNB 入口,同时注册 15 个 cnb_* 工具给 agent。
配置项只有一个可选的覆盖点,写在 cordis.patch.yml 里:
- id: dsh-cnb
name: dsh-cnb
config:
webOrigin: https://cnb.cool # 默认值,一般不用改
apiOrigin: https://api.cnb.cool # 默认值,一般不用改
requestTimeoutMs: 25000
扫码登录
面板「账号」页点 扫码登录:插件向 CNB 取一个登录票据,把 https://cnb.cool/login/wx/jump?ticket=… 渲染成二维码(Host 侧编码成 SVG path,浏览器只画一个 <path>),每 2 秒轮询一次。
手机微信确认后,插件立刻用同一个会话调用 CNB 的令牌接口,按下面这些 scope 创建一个访问令牌:
全部 26 项权限,每项都取它能授予的最高级别,由 CNB 自己的 GET /config/token/scope 表在扫码时现取现算,不写死:
repo-code:rw repo-pr:rw repo-issue:rw repo-notes:rw repo-release:rw
repo-commit-status:rw repo-cnb-trigger:rw repo-cnb-history:r
repo-cnb-detail:rw repo-basic-info:r repo-manage:rw repo-delete:rw
repo-security:r registry-package:rw registry-package-delete:rw
registry-security:r registry-manage:rw registry-delete:rw
account-profile:rw account-email:r account-engage:rw
group-resource:rw group-manage:rw group-delete:rw
mission-delete:rw mission-manage:rw
权限不足时的替代路径
两项权限没有放宽的余地,但停止环境有一条等价的替代路径:
| 操作 | 账号级接口 | 需要 | 替代路径 | 需要 |
|---|---|---|---|---|
| 停止环境 | POST /workspace/stop | account-engage:rw | POST /{repo}/-/build/stop/{sn} | repo-cnb-trigger:rw |
| 删除环境 | POST /workspace/delete | account-engage:rw | 无 | — |
| 新建仓库 | POST /{slug}/-/repos | group-resource:rw | 无 | — |
停止环境时插件先走账号级接口;若返回缺 account-engage,自动改走仓库级流水线停止(只需 repo-cnb-trigger:rw,也就是启动环境本来就需要的权限),面板会标注「经仓库级流水线停止」。已结束的流水线返回 422,插件识别为「该环境已经结束」而不是失败。为此 workspaces.stop 接受 repo 参数;面板在列表里会自动带上。
删除环境与新建仓库只有组织/账号级接口,没有仓库级替代路径。它们靠的是另一条路:登录会话(见下节),而不是令牌的 scope。
用登录会话绕过 token 的 scope 限制
CNB 有两套彼此独立的鉴权模型:
- 访问令牌(
Authorization: Bearer):权限由签发时写入的 scope 决定,导入的令牌可能永远缺group-resource:rw或account-engage:rw。 - 网页登录会话(cookie):代表"已登录的这个人"本身,不受 token scope 限制。而且
cnb.cool这个网页 origin 上同样挂载了同一批 JSON API。
所以插件遇到 10023(缺 scope)时不会立刻失败:它会把同一个请求改发到 cnb.cool,带上保存下来的会话 cookie 和 csrftoken。成功就用这个结果。只有会话也被拒(说明这个人本身没有该权限)才报告缺权限。
这条路径对新建仓库和删除环境是决定性的:只要你的账号在这些组织里是管理员/负责人,扫码一次之后这两项就能用,不需要改动令牌的任何 scope。
让这两项可用的三条路
按代价从低到高:
A. 扫码一次(最省事) —— 会话被保存,之后缺 scope 的调用自动改走会话。不需要碰令牌的任何 scope,只要你在组织里是管理员/负责人。
B. 在 CNB 令牌页给令牌补 scope —— cnb.cool/profile/token → 对应令牌 → 编辑:
| 权限项 | 级别 | 勾选后的效果 |
|---|---|---|
账号 · account-engage | 读写 | 关注仓库/关注者,以及云原生开发环境的停止/删除 |
组织 · group-resource | 读写 | 组织资源:新建仓库、任务集等 |
C. 重新签发令牌 —— 插件会按 26 项全权限重签。若重签后仍缺,说明账号被角色限制,不是令牌问题。
A 和 B 的区别在于谁承担授权:A 用的是你这个人的身份,B 把权限固化进令牌。令牌会过期、会丢,会话不会因为 scope 缺失而失效,所以 A 更稳。
「账号」页的 检测权限 会把缺的项直接列成可点行(权限名 + 中文含义 + 打开令牌页按钮),不用自己猜代码名对应哪个勾选框。
级别后缀是必须的。 CNB 的授权项写法是 <group>-<code>:<level>。只发 repo-code(不带 :r/:rw)时,创建接口不会报错,但签出的令牌不含任何有效权限——之后每个调用都返回 10023,看起来就像账号没有权限。这就是为什么列表要现取现算,并且 test/scopes.test.mjs 会逐项断言级别存在且合法。
想只授权这个插件用到的部分,把 profile 换成 plugin:11 项,覆盖仓库、组织、身份与环境控制,不含制品库与任务集。
扫码后自动保证拿到能用的令牌
CNB 的创建接口对一份"授予不了任何权限"的 scope 也返回成功,所以"签出成功"不等于"能用"。插件因此不是签完就结束:
- 签:按平台权限表现取现算,全部 26 项、每项取最高级别(
<group>-<code>:<level>)。 - 验:立刻拿新令牌读账号、仓库、组织。任一项读不到,就判定这个令牌不可用,不写入、不报告成功。
- 换:依次换用更窄的授权清单重试——全权限 → 插件所需 11 项 → 最小 8 项。账号角色限制了某类授权时,更窄的清单有时仍能通过。
- 报:只在某个清单真的产出可用令牌后才存进凭证库,并告诉你用的是哪一档。全部失败时明确说明这是账号角色限制,而不是令牌格式问题。
所以扫码是"一次操作、必然有结论",不需要你事后自己去核对权限。
登录 Cookie 的有效期
有效期由 CNB 决定,插件只读取并显示,不提供设置项。
读取方式是看 CNB 确认登录时实际下发的 Set-Cookie 属性:
Max-Age优先(按 RFC 6265 它压过Expires),其次Expires- 只认带生命周期的会话类 cookie(名称匹配
session/alive/auth/token/login);csrfkey、csrftoken没有生命周期,忽略 - 服务端没给时长时,才回退到文档里的默认 7 天,并且明确标注是估算
「账号」页显示成这样:
登录 Cookie 到期 2026-12-21 19:54:23 · 还剩 29d0h
若来源是估算,会多一句「(按默认 7 天估算)」。没有保存会话时显示「未保存」,不编日期。
自动重签会保留原始到期时间,不会因为续签而把计时清零。
早先版本在面板上放过 1/7/30/90 天的选择器,那是错的:有效期不是用户该配的东西,而且它发送的
login_days只被一条本插件走不到的确认路由识别。已删除。
登录会话会被保存,令牌问题自动修复
扫码时浏览器拿到的那份 cookie 会话会被一并存进凭证库(和令牌同一条记录,session 字段)。它的作用:
- 令牌过期、被撤销、或权限不足时,插件用这份会话自动向 CNB 重新申请一次令牌,并在换成功后重试刚才失败的那次调用。你在面板上看到的不是"请重新扫码",而是调用直接成功。
- 重签走的是与扫码完全相同的三档清单(全权限 → 插件所需 → 最小)和验证流程,所以新令牌同样保证可用。
- 会话本身失效(回答 401)时才会提示重新扫码——这时也确实只有扫码能解决。
「账号」页的「自动续签」一行会告诉你当前是否已保存会话。保存了就不需要你再管令牌;没保存(比如手动粘贴令牌)就只在那一次有效。
令牌自检
「账号」页有 令牌自检 卡片(工具 cnb_token_doctor),逐个探测面板实际用到的 8 个接口——身份、仓库、组织、额度用量、环境列表,加上停止环境、新建仓库、删除仓库这三项写权限。
界面分三层读:
- 一行结论:
8/8 可用或7/8 可用,并分开统计读取 5/5、写入 2/3。 - 按读写分组:每项一行,显示中文名、判定和一句人话摘要(如「19 个仓库 · yvkongzhuimeng/k」),不输出原始 JSON。
- 判定只有四种:
可用/降级可用(经仓库级回退,如「停止环境」走流水线停止)/受限(缺 scope,直接列出缺哪项)/失败(非权限原因)。
判定里的 经会话可用 是关键:令牌缺这项权限,但保存的登录会话把它完成了——功能能用,所以不算失败,只用黄色标注并说明原因。自检的探测客户端本身带着会话,因此它测的是功能是否可用,而不是令牌的字面 scope。
只有会话也拒绝时才会显示 受限 并列出「去 CNB 令牌页勾选」。
写权限的探测不会产生副作用:CNB 先查权限、再查对象,所以探测请求故意指向不可能存在的对象。权限缺失时返回 403,权限具备时会返回 400/404——两种情况都不会真的停环境、建仓库或删仓库。扫码成功后也会自动跑一遍自检——如果签出的令牌仍然缺权限,面板直接告诉你缺哪些,而不是让你对着空列表猜。
自检能区分三种情况:令牌无效(CNB 不接受)、令牌有效但缺权限项、一切正常。
令牌明文只出现一次,随后写进 dsh 的凭证库,不落配置文件:
- 记录
dsh-cnb/cnb-token(kind: grant)——面板与工具的身份来源; - 键
CNB_TOKEN——llm-pi-ai的apiKeyEnv解析到的同一个值。
也可以在「已有访问令牌?」里粘贴一个在 cnb.cool/profile/token 建好的令牌。
内容风控:为什么直连会 400
CNB 的 AI 网关会扫描请求体,命中「客户端指纹」就整条拒绝:
HTTP 400 {"code":11128,"msg":"Illegal API invocation from an unapproved channel"}
换令牌、换账号、换模型、补请求头都无效——被拦的是提示词本身。而且只在请求体较大时稳定触发(约 >1KB),所以表现为时好时坏:短探测通过,真实对话失败。
实测确认(2026-11,本机复现):
| 请求体里的文本 | 结果 |
|---|---|
Main branch (the usual target for pull requests) | 400 / 11128 |
| 同上,经插件改写后 | 200 |
只扫 system 和 assistant 两个角色的文本;user 内容和工具描述不扫。所以插件在发请求前做三件事,都不改语义:
- 改写已知指纹:把被拦的表述换成等价说法;身份词(
DeepSeek Harness)中间插入零宽空格——人读不出差别,匹配不到。路径语境(D:\...\DeepSeek Harness\...)会跳过,否则会把坏路径交给工具调用。 - 归一消息形状:新的
developer角色映射成system,中途的system提前。 - 兜底重试:真的吃到 400/11128 时,逐级把 system 并进首条 user,再把非 user 消息逐词打散。
这套逻辑内置在插件里,不需要额外部署任何代理。
移植自 MIT 许可的 cnb2api 中性化实现,见 LICENSE-cnb2api。短语表已对真实网关验证。
让新仓库自动配好网关(推荐)
网关令牌只对签发它的仓库有效,但它可以从密钥仓库自动注入。配置一次,之后任何仓库启动环境都自带令牌,插件读到就直接用——不需要任何人手动粘贴。
1. 建一个密钥仓库(cnb.cool/new/repos,类型选「密钥仓库」),内容:
# env.yml
CNB_GATEWAY_TOKEN: <你的流水线令牌>
密钥仓库禁止本地 clone,只能在网页编辑,带审计日志。
2. 在需要网关的仓库里,改 .cnb.yml:
$:
vscode:
- services:
- vscode
imports:
- https://cnb.cool/<密钥仓库路径>/-/blob/main/env.yml
3. 完成。 这个仓库每次启动开发环境,CNB_GATEWAY_TOKEN 都会作为环境变量注入;插件启动时自动读取、验证、存为网关令牌。
插件认可三个名字,按此顺序检查:
CNB_TOKEN ← CNB 自己注入的(云环境自带)
CNB_API_TOKEN
CNB_GATEWAY_TOKEN ← 密钥仓库导入的
所以老仓库不用改,新仓库加两行 imports 即可。
局限:令牌仍然只对它所属的那个仓库有效。用
k的令牌,所有环境都会走k的网关与额度,这正是「统一一套网关」的做法;想让每个仓库各走各的额度,就得各自注入各自的令牌。
第一次使用的完整路径
网关只接受流水线令牌,而这种令牌只存在于运行中的环境里。个人访问令牌既读不到它,也调不了网关(两条 AI 路径都返回 [NO_RIGHT] OpenAPI only allowed in pipeline),所以插件无法代你取得。
能省掉的是猜测。面板上有一个 帮我启动一个环境:
- 它在你能用的仓库里启动一个云环境(没有就自动挑一个)
- 返回三步操作:打开 WebIDE → 在终端执行
echo $CNB_TOKEN→ 把输出粘到「导入网关令牌」 - 顺带给出可复制的命令和直达 WebIDE 的链接
导入时会先验证:个人令牌或属于别的仓库的令牌会被当场拒绝并说明原因,不会存下来变成以后每次调用都失败的配置。
如果你的部署已经有本地代理
有些部署用本地反向代理(如 127.0.0.1:8791)承担同样的改写,并通过 --patch 接管了 llm-pi-ai。那种情况下插件不会覆盖它:--patch 优先级高于 profile 层,DSH 会拒绝写入,面板会说明「由更高优先级的配置层接管」,并建议保持现状。
云原生开发
启动不跳转,列出所有链接
点「启动开发」后不会自动打开任何页面。CNB 一次启动可能返回好几种地址(WebIDE 入口、跳转页、构建中的 loading 页、流水线日志),该看哪个取决于你为什么启动——直接替你打开一个等于替你猜。所以面板把这次拿到的全部链接列成卡片,每条都有:
- 标签说明这条是什么(
WebIDE 入口/启动页(环境就绪前)/流水线日志/仓库主页) - 完整 URL,可直接选中复制
- 复制按钮(优先用 Clipboard API,老浏览器回退到 textarea + execCommand)
- 打开链接(想跳的时候自己点)
地址按去掉尾部斜杠去重,vscode-web/cnb-1/ 和 vscode-web/cnb-1 只出现一次。
Cursor / VS Code 等桌面编辑器怎么接
它们没有各自的 CNB 链接。 这一点我实测确认过,值得说明白:
- CNB 前端构建清单里,
/-/workspace/下只有jump、loading、error三个页面; - 页面是 catch-all 路由,所以
/-/workspace/cursor/<sn>/这种编出来的路径会返回 401,和真实路径的响应一模一样,无法用状态码区分; - 官方文档写的机制是:VS Code / Cursor / CodeBuddy 通过 Remote-SSH 连接,JetBrains 通过 Gateway(同样走 SSH)。
所以插件不编造 per-editor 链接,而是给出连接坐标:
Remote-SSH 连接串 ssh <pipelineId>@<ssh-host>
~/.ssh/config 片段 Host cnb-<pipelineId> / HostName … / User … / Port 22
前提两条,面板会写在链接下面:镜像需预装 openssh-server;JetBrains 还需把 IDE 装到 /ide_cnb。
SSH 主机名只在环境内部可获取(CNB_WORKSPACE_SSH_HOST)。拿不到时插件不猜——宁可少一条,也不给一个看起来对、连不上的地址。
一个环境有七类入口
workspace/detail 只返回两条(WebIDE、跳转页),但一个环境实际有这些:
| 入口 | 形态 | 说明 |
|---|---|---|
| WebIDE | <web>/<repo>/-/workspace/vscode-web/<pipelineId>/ | 编辑器 |
| CodeBuddy Web | <web>/<repo>/-/workspace/codebuddy/<pipelineId>/ | 浏览器里的 AI 编码 |
| 跳转页 | <web>/<repo>/-/workspace/jump?pipelineId=<pipelineId> | 环境状态页 |
| 端口预览模板 | https://<prefix>-{{port}}.cnb.run | 把 {{port}} 换成实际端口 |
| 端口预览 3000/5173/8080/8000/5000 | 同上 | 直接可用的常见端口 |
| 流水线日志 | <web>/<repo>/-/build/logs/<pipelineId> | 构建日志 |
| 仓库主页 | <web>/<repo> | — |
端口预览最容易漏,但它往往是最需要的:开发环境里起的服务在浏览器里打不开本地端口,只能通过这个域名访问,而且服务必须监听 0.0.0.0。
两种 sn 不能混用
CNB 对同一个环境有两种叫法,混用就 404:
workspace/detail只认短 sn:cnb-lod-1k81349st- 链接路径里要用流水线 id:
cnb-lod-1k81349st-001
插件在调用前把带后缀的 sn 归一化成短的,构造链接时再用带后缀的。
端口预览前缀只属于它自己的环境
前缀(如 iti87odsrp)由 CNB 按环境分配,只在环境内部通过 CNB_VSCODE_PROXY_URI 暴露。插件只在本机所在的那个仓库上使用它,对别的仓库不填——否则会生成一个看起来正确、实际返回 500 的链接。其他仓库需要时显式传 proxyDomain。
刚启动时流水线还没跑完,CNB 只给得出 loading 页、webide 还是空的。卡片会显示「刷新地址(环境就绪后)」,点一下重新向 workspace/detail 取真实入口,等环境起来就能拿到可直接用的 WebIDE 地址。
地址随时可查,不依赖"刚启动"
每个环境在列表里都有 地址 按钮:点开就在该行下方展开全部链接,再点收起。不需要重新启动,也不需要记得上次的卡片——任何时候都能查。
- 按需读取:每次展开都向
workspace/detail重新取一遍,所以环境起来之后新出现的端口和入口能反映出来。 - 保留在本地:结果写进
localStorage(dsh-cnb.addresses.v1,最多 40 个环境,按时间淘汰)。刷新页面、关掉面板再打开,地址仍然在。 - 接口挂了也不丢:拉取失败时保留已有缓存,只在上面加一条错误提示——地址不会因为网络抖一下就变错,你可能只是想再复制一次。
- 复制全部:一次把这批地址按行拼好放进剪贴板。
- 自选端口:
workspaces.detail接受ports参数。给了就只用你给的端口(不再混入默认的 3000/5173/…),因为常用端口是你自己的习惯,不该被默认值覆盖。
启动环境时 branch 是必填的(CNB 对空 body 直接答 [PARAM_MISS]branch is required,只给 ref 也不行)。所以省略 branch 时插件自己解析:仓库对象没有 default_branch 字段,于是读取分支列表,优先 main、其次 master、否则取第一个。显式给了 branch 就完全不做这次查询。
重开一个已存在的环境时 CNB 只返回 URL、不返回 sn,而 sn 是之后停止环境要用的。插件从 URL 的 sn= 参数里取回来,所以「启动 → 停止」能闭环。
「开发环境」页列出当前账号的全部环境(运行中/已关闭),可直接打开 WebIDE、停止或删除。查询某个仓库时会额外读取默认分支的 .cnb/settings.yml,把开发按钮的 name / description / hoverImage / cpus / disabled / autoOpenWebIDE 显示出来,并列出该仓库已有环境。
组织用量
「用量」页按组织展示 7 类资源的「已用 / 总额度」与占比条:Git 存储、对象存储、云原生构建、云原生开发、构建 GPU、开发 GPU、AI Credits。
额度接口任何成员都能读;用量接口需要根组织负责人权限,读不到时该组织的用量显示为不可读,额度仍然展示。
网关模型
CNB 的 AI 网关挂在仓库下,只接受流式 Chat Completions:
POST https://api.cnb.cool/<repo>/-/ai/chat/completions
Authorization: Bearer <CNB token>
{ "model": "deepseek-v4.1-flash", "stream": true, "messages": [...] }
「网关模型」页填仓库 → 测试调用 会对网关发一次真实请求;一键配置到 dsh 会往 llm-pi-ai 写一个 provider 路由:
- id: llm-pi-ai
config:
providers:
cnb-gateway:
api: openai-completions
baseURL: https://api.cnb.cool/<repo>/-/ai
apiKeyEnv: CNB_TOKEN
models:
- id: deepseek-v4.1-flash
勾选「同时设为默认模型」会一并改写 agent-default-model。两处写入都走 dsh 的 configEditor,因此配置文件仍是唯一事实来源。
如果这两个条目被 home patch 或命令行 --patch 覆盖,configEditor 会拒绝写入(它不写在更高优先级层之下)。这时面板不会报错收场,而是给出可直接并入那份 overlay 的 YAML 片段,并附「复制片段」。
工具清单
| 工具 | 参数 | 作用 |
|---|---|---|
cnb_status | — | 登录状态、账号、令牌有效期、待扫码会话 |
cnb_login_begin | — | 取扫码票据,返回 URL 与二维码 SVG path |
cnb_login_poll | — | 轮询一次;confirmed 时已自动建好并保存令牌 |
cnb_repos | search page pageSize | 仓库列表,附每个仓库的环境 |
cnb_repo_status | repo | 元信息 + 最近构建 + 环境 + 开发按钮 |
cnb_repo_create | slug name visibility description | 建仓库 |
cnb_repo_delete | repo confirm | 删仓库(必须 confirm: true) |
cnb_workspaces | repo status | 环境列表 |
cnb_workspace_open | repo branch | 启动/复用环境,返回 WebIDE 地址 |
cnb_workspace_control | action repo sn pipelineId | 停止或删除环境(repo 让停止可改走仓库级) |
cnb_usage | slug month | 组织额度与用量 |
cnb_gateway_probe | repo model prompt | 网关真实调用 |
cnb_gateway_configure | repo route model makeDefault | 写入 llm-pi-ai 路由 |
cnb_login_scopes | — | 列出 CNB 可授权的权限项及级别 |
cnb_token_doctor | — | 逐接口探测令牌能做什么、缺哪个权限项 |
实现要点
- 令牌只在 Host。浏览器调
/dsh-cnb/api/*,由 Host 用凭证库里的令牌访问 CNB;响应里不会出现令牌。 - 面板路由自带同源校验:校验
Origin/Host一致并拒绝Sec-Fetch-Site: cross-site。 - 不用第三方依赖。二维码用 MIT 许可的
qrcode-generator(vendored,vendor/qrcode.cjs);.cnb/settings.yml由一个只读该文件格式子集的解析器处理(lib/mini-yaml.js),不往 profile 里塞 YAML 库。 - 一个能力表。
lib/index.js里的operations同时驱动面板路由和 agent 工具,两边不会漂移。
dsh-cnb/
├── lib/
│ ├── index.js Host:能力表、路由、工具、configEditor 写入
│ ├── cnb-client.js 扫码状态机 + OpenAPI 客户端
│ ├── mini-yaml.js .cnb/settings.yml 子集解析
│ └── qr.js 票据 → SVG path
├── client.js 面板(React,slots 注册)
├── vendor/qrcode.cjs MIT 二维码编码器
└── test/ 离线测试 + 需 CNB_TOKEN 的实网冒烟
测试
npm test # 离线:权限表与级别、扫码状态机、自检、mini-yaml、二维码、overlay
CNB_TOKEN=... npm test # 追加实网冒烟:仓库、用量、网关、配置写入
实网冒烟只读 CNB,不建/删仓库,也不启停环境。gateway-overlay 这组会把生成的 YAML 片段丢给真实的 llm-pi-ai Config schema 校验,保证复制出去的东西能被 loader 接受。
二维码那组在装了 jsqr 时会额外把 SVG path 光栅化后解码,断言解出来的正是票据 URL;没装就只校验几何。
许可
MIT。vendor/qrcode.cjs 来自 qrcode-generator(Copyright © 2009 Kazuhiko Arase,MIT)。