dsh-cnb-assist 1.0.1 → 1.0.2

package/README.md

@@ -1,99 +1,101 @@
-# CNB 反代辅助（DSH 插件）
+# CNB 反代辅助
 
-把 `cnb-assist-wpf` 那套已经跑通的 CNB 逻辑搬进 DeepSeek Harness 现在的 IDE 里。
-令牌留在 Host 进程，浏览器半身只拿算好的数字；写配置只替换 `baseURL` 那一个字符串。
+DeepSeek Harness（DSH）插件。把 CNB 的额度、AI 用量和运行中容器的反代地址放进 IDE 侧栏，
+并提供「一键写回模型地址」和「四步重启容器」。
 
-包名：`dsh-cnb-assist` · 当前版本 `1.0.1`
+- **令牌不出 Host 进程** —— 浏览器那半只拿到算好的数字。
+- **写配置只改一个字符串** —— 只替换模型 `baseURL` 里那条 `*.cnb.run` 地址，不动整份 YAML。
+- **零运行时依赖** —— 纯 ESM 源码，装上就能用。
 
-## 装法
+---
 
-### 方式 A：从 npm 装（推荐，换机器最省事）
+## 装
 
-```bash
+在 DSH 里打开插件管理：
+
+```
 plugin_manager → install_bundle → target: dsh-cnb-assist
-# 或指定版本：
-plugin_manager → install_bundle → target: dsh-cnb-assist@1.0.1
 ```
 
-DSH 的插件管理用 pnpm 去 registry 拉包，目标机器能访问 npm 即可。
+要固定版本就写 `dsh-cnb-assist@1.0.2`。
 
-### 方式 B：离线 tgz
+离线安装也行，把 `dsh-cnb-assist-*.tgz` 拷到目标机器后填该文件的绝对路径。
+安装器认**目录**和 **`.tgz`/`.tar.gz`**，`.zip` 不被接受。
 
-**安装器只认目录或 `.tgz`/`.tar.gz`，不认 `.zip`**（`.zip` 会被当成目录去读 `package.json`，
-所以会报"该路径不存在或不是有效的插件包"）。
+装完**重启一次 dsh**（Host 层代码不会热更新），然后刷新页面。
 
-```bash
-npm pack dsh-cnb-assist          # 得到 dsh-cnb-assist-1.0.1.tgz
-plugin_manager → install_bundle → target: 该 tgz 的绝对路径
-```
+---
 
-### 方式 C：本机源码目录（改代码时用）
+## 用
 
-```bash
-plugin_manager → install_bundle → target: 本目录的绝对路径
-# 示例：C:\Users\LMUD\Desktop\cnb2api\dsh-cnb-assist
-# 用 link: 安装，改完代码只刷新页面即可（Host 半身改动才需要重启 dsh）
-```
+### 1. 填令牌
 
-### 方式 B：另一台电脑（推荐）
+`设置 → CNB 反代辅助`，只有两项：
 
-**安装器只认目录或 `.tgz`/`.tar.gz`，不认 `.zip`**（`.zip` 会被当成目录去读 `package.json`，
-所以会报"该路径不存在或不是有效的插件包"）。
+| 项 | 说明 |
+|---|---|
+| **CNB 令牌** | CNB 的 access token，至少要有容器与构建日志的读权限 |
+| **模型 provider** | 写回地址时要改哪个 provider，默认 `cnb`，需与配置里的键名一致 |
 
-```bash
-# 把 dsh-cnb-assist-1.0.1.tgz 拷过去，然后在 DSH 里：
-plugin_manager → install_bundle → target: 该 tgz 的绝对路径
-# 也可以直接填解压后的目录绝对路径（目录里要有 package.json）
-```
+令牌也可以不填，插件会按顺序兜底查找：
+
+1. 插件设置里的 `config.token`
+2. `%APPDATA%\CnbAssist\settings.json`（桌面版辅助程序存过的那份）
+3. 环境变量 `CNB_API_KEY`
 
-> 版本号要在两台机器上对得起来。`files` 字段只列真实存在的条目（`locale` 写成目录而不是
-> `locale/*.json`），否则 `pnpm pack` 的 `scandir` 会直接报 ENOENT。
+令牌与地址**不随包分发**，每台机器各自配置。
 
-本包是纯 ESM 源码、零运行时依赖，除 `@deepseek-ai/schemastery`（从 dsh 安装里解析，不需要
-随包分发）之外不 import 任何第三方包，所以不存在"换台机器装不上"的 node_modules 问题。
+### 2. 打开面板
 
-**装完重启一次 dsh**：`cordis.patch.yml` 属于 Host 层，HMR 不会重建 Host 模块。
+点左侧栏底部的橘黄叶片图标，面板从上到下是四块：
 
-## 落点
+- **运行中容器** —— 反代地址，可复制、可四步重启、可一键写回模型地址
+- **当前配置** —— 从本 profile 的 `cordis.patch.yml` 里读出来的现有地址，标了行号和 provider
+- **额度** —— 每个组织的月额度 / 已用 / 预冻结，带进度条
+- **本月按组织** —— 本月创建的容器按组织汇总的 credits 与 token 用量
 
-| 位置 | 说明 |
+### 3. 写回模型地址
+
+容器那一行点「设为模型地址」，插件把 `https://<business_id>-9001.cnb.run` 写进
+设置里那个 provider 的 `baseURL`。写前会留 `.bak`，只替换地址字符串本身。
+
+---
+
+## 面板之外
+
+模型工具 `cnb_assist` 始终可用，四个动作：
+
+| 动作 | 作用 |
 |---|---|
-| 左侧栏底部按钮 + 居中浮层 | 主入口（橘黄叶片图标） |
-| 设置 →「CNB 反代辅助」 | 只两项：CNB 令牌、模型 provider |
-| 模型工具 `cnb_assist` | 始终注册：`snapshot` / `config` / `restart` / `apply` |
+| `snapshot` | 额度 / 用量 / 容器 / 当前配置，一次拿全 |
+| `config` | 读配置，或从中解析出现有反代地址 |
+| `restart` | 走 stop → 等停稳 → start → 等新地址 |
+| `apply` | 把地址写进指定 provider |
+
+---
+
+## 常见问题
 
-> 右侧栏页签已移除：与左侧按钮重复，插件也不再依赖 `dsh-better-sidebar`。
+**面板说「未配置令牌」** —— 去设置里填，或把 `CNB_API_KEY` 设成环境变量后重启 dsh。
 
-## 换到新机器后要做的事
+**额度是空的** —— 令牌权限不够。读容器列表要 `account-engage:r`，读构建日志要
+`repo-cnb-history:r`。
 
-1. 装好后刷新页面，点左侧栏底部的橘黄叶片
-2. 设置 →「CNB 反代辅助」→ 填 **CNB 令牌**（或让它读 `CNB_API_KEY` / 旧的
-   `%APPDATA%\CnbAssist\settings.json`）
-3. 确认 **模型 provider** 与 `llm-pi-ai` 行里的键名一致（默认 `cnb`）
-4. 面板里点容器那一行的「设为模型地址」，把反代地址写进该 provider 的 `baseURL`
+**本月合计比网页上少** —— 已删除的容器查不到归属，会被丢弃，这是预期行为。
 
-令牌与地址**不会**随包带走，每台机器各自配置。
+**重启后地址变了** —— 正常。重启会重建容器，`business_id` 变，地址跟着变。
 
-## 面板有什么
+**改完配置没生效** —— `cordis.patch.yml` 属于 Host 层，要重启 dsh，刷新页面不够。
 
-- **额度**：每个组织的月额度 / 已用 / 预冻结，带进度条。`credit_in_milli` 一律 ÷1000；
-  特权用四重判定（`total<=0 || bonus<=0 || 已过期 || bonus>total` 即视为无）。
-- **本月按组织**：只统计本地时区本月创建的容器，归属只认构建日志的 `groupName`，
-  查不到的容器直接丢弃（不拿 slug 兜底）。
-- **运行中容器**：反代地址（`business_id` + `-9001` 优先，解析不到就从阶段日志里抠），
-  复制、四步重启、一键写回模型 `baseURL`。
-- **配置里现有的地址**：从本 profile 的 `cordis.patch.yml` 里正则读出来，标行号与 provider。
+---
 
-## 令牌从哪来
+## 兼容性
 
-1. 设置页 / 插件行 `config.token`
-2. `%APPDATA%\CnbAssist\settings.json`（桌面版辅助程序已经存过的那一份，不用再抄一遍）
-3. `CNB_API_KEY` 环境变量
+- Node.js ≥ 20
+- 只依赖宿主提供的 `@deepseek-ai/dsh-client-ui-slots` 与 `@deepseek-ai/dsh-client-locale`，
+  无需额外安装任何包
+- 样式只用 DSH 主题变量，跟随亮色 / 暗色
 
-## 关键约定（来自 cnb-assist-wpf/AGENTS.md）
+## 许可
 
-- 所有 CNB 请求必须带单值 `Accept: application/vnd.cnb.api+json`，多值会 406。
-- 组织归属只认 `build/logs` 的 `groupName`，查不到就丢弃。
-- 「本月」按本机时区取 1 号 00:00。
-- 重启必须四步：`stop → 等非 running → start → 等新地址`；`start` 的 `branch` 必填。
-- 写配置绝不重写整份 YAML：只替换匹配到的 `-9001.cnb.run` 字符串，写前留 `.bak`。
+MIT

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-cnb-assist",
-  "version": "1.0.1",
-  "description": "CNB 反代辅助（DSH 插件）：各组织额度、本月 AI 用量、运行中容器反代地址，一键写回 DSH 模型配置",
+  "version": "1.0.2",
+  "description": "CNB 反代辅助（DSH 插件）：查看各组织额度与本月 AI 用量，管理运行中容器的反代地址，一键写回模型 baseURL",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -38,7 +38,9 @@
     "node": ">=20"
   },
   "dsh": {
-    "bundle": { "patch": "./cordis.patch.yml" },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
     "client": {
       "platform": "web",
       "immediately": true,