dsh-cnb-assist 1.0.4 → 1.0.5

package/README.md

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

package/client.js

@@ -762,32 +762,49 @@ window.__ModuleLoader__.load({
       useStyles()
       const [form, setForm] = useState({ token: '', syncProvider: 'cnb' })
       const [state, setState] = useState({ saving: false, message: null, error: null })
-
+      const [saved, setSaved] = useState({ hasToken: false, tokenSource: 'none' })
+
+      /**
+       * 回填已保存的值。
+       * ★ 不能只依赖 `ctx.configForms`：那个服务在行没有 schema、或客户端没注册时
+       *   取不到，表单就会永远空白，用户以为"保存没生效"。所以这里始终向 Host
+       *   要一次当前行的 config（`method: 'loadConfig'`），configForms 只作补充。
+       * ★ Host 不回令牌明文，只回 hasToken；输入框留空表示"保持原值"。
+       */
       useEffect(() => {
-        const face = configFormOf(ctx)
-        if (face === undefined) return undefined
         let alive = true
-        const read = (snapshot) => {
-          if (!alive) return
-          const value = snapshot?.value ?? snapshot?.config ?? {}
+        const apply = (value) => {
+          if (!alive || value === null || typeof value !== 'object') return
           setForm((current) => ({
-            ...current,
-            token: String(value?.token ?? current.token ?? ''),
+            token: current.token === '' ? String(value?.token ?? '') : current.token,
             syncProvider: String(value?.syncProvider ?? current.syncProvider ?? 'cnb') || 'cnb',
           }))
         }
-        if (typeof face.getSnapshot === 'function') {
-          read(face.getSnapshot())
+
+        // 1) Host 侧真实配置（唯一可靠来源）
+        callHost('loadConfig')
+          .then((result) => {
+            if (!alive) return
+            apply(result?.config)
+            setSaved({
+              hasToken: result?.hasToken === true,
+              tokenSource: String(result?.tokenSource ?? 'none'),
+            })
+          })
+          .catch(() => { /* Host 不可达时静默 */ })
+
+        // 2) configForms 有就顺带订阅
+        const face = configFormOf(ctx)
+        if (face !== undefined && typeof face.getSnapshot === 'function') {
+          const read = (snapshot) => {
+            const value = snapshot?.value ?? snapshot?.config
+            if (value !== undefined && value !== null) apply(value)
+          }
+          try { read(face.getSnapshot()) } catch { /* 忽略 */ }
           if (typeof face.subscribe === 'function') {
-            const off = face.subscribe(() => { read(face.getSnapshot()) })
+            const off = face.subscribe(() => { try { read(face.getSnapshot()) } catch { /* 忽略 */ } })
             return () => { alive = false; if (typeof off === 'function') off() }
           }
-          return () => { alive = false }
-        }
-        if (typeof face.read === 'function') {
-          Promise.resolve(face.read())
-            .then(read)
-            .catch((error) => { if (alive) setState({ saving: false, message: null, error: String(error?.message ?? error) }) })
         }
         return () => { alive = false }
       }, [ctx])
@@ -799,23 +816,21 @@ window.__ModuleLoader__.load({
 
       const save = async () => {
         setState({ saving: true, message: null, error: null })
-        // 只写这两项：其余设置项已从界面移除，配置文件里的值保持不动。
-        const next = {
-          token: form.token.trim(),
-          syncProvider: form.syncProvider || 'cnb',
-        }
+        // ★ 令牌留空 = 保持原值不动，不要用空串把已保存的令牌覆盖掉。
+        const trimmed = form.token.trim()
+        const next = { syncProvider: form.syncProvider || 'cnb' }
+        if (trimmed !== '') next.token = trimmed
         try {
-          const face = configFormOf(ctx)
-          if (face !== undefined && typeof face.set === 'function') {
-            await face.set(next)
-          } else if (face !== undefined && typeof face.update === 'function') {
-            await face.update(next)
-          } else {
-            // 没有可用的表单面：交给 Host 走 Config 编辑通道。
-            const result = await callHost('saveConfig', { config: next })
-            if (result?.ok !== true) throw new Error(String(result?.message ?? 'save failed'))
-          }
+          // ★ 一律走 Host 的 saveConfig：它经 Config 编辑通道写回 profile 的
+          //   cordis.patch.yml，本进程立即生效，重启后也还在。
+          //   configForms.set 只改客户端表单状态、不落盘，之前两条路径混用，
+          //   导致"点保存看似成功、实际读到的还是旧令牌"。
+          const result = await callHost('saveConfig', { config: next })
+          if (result?.ok !== true) throw new Error(String(result?.message ?? 'save failed'))
           setState({ saving: false, message: copy.saved, error: null })
+          // 存完把输入框清空并标记"已设置"，避免明文长期停在输入框里。
+          setForm((current) => ({ ...current, token: '' }))
+          if (trimmed !== '') setSaved({ hasToken: true, tokenSource: 'config' })
         } catch (error) {
           setState({ saving: false, message: null, error: String(error?.message ?? error) })
         }
@@ -829,11 +844,14 @@ window.__ModuleLoader__.load({
             type: 'password',
             value: form.token,
             onChange: set('token'),
-            placeholder: 'cnb_…',
+            placeholder: saved.hasToken ? '已保存，留空则不修改' : 'cnb_…',
             autoComplete: 'off',
             spellCheck: false,
           }),
-          h('span', { className: 'cnba-note' }, copy.fTokenHint)),
+          h('span', { className: 'cnba-note' },
+            saved.hasToken
+              ? `当前令牌来源：${saved.tokenSource}（留空保存则保持不变）`
+              : copy.fTokenHint)),
         h('div', { className: 'cnba-field', key: 'provider' },
           h('span', { className: 'cnba-label' }, copy.fProvider),
           h('input', {

package/index.js

@@ -1209,11 +1209,29 @@ export function apply(ctx, config) {
     }
   }
 
+  /**
+   * 读回本行当前的 config（设置页回填用）。
+   * ★ 不回令牌明文：它一旦进了页面 DOM，任何能读这个页面的人都拿得到。
+   *   这里只回 `hasToken`，输入框留空即表示"保持原值不动"。
+   */
+  const loadConfig = async () => {
+    const resolved = await resolveToken(settings.token)
+    return {
+      config: {
+        token: '',
+        syncProvider: settings.syncProvider,
+      },
+      hasToken: resolved.token !== '',
+      tokenSource: resolved.source,
+    }
+  }
+
   const dispatch = async (body) => {
     const method = String(body?.method ?? '')
     switch (method) {
       case 'snapshot': return await service.snapshot({ groups: body?.groups })
       case 'config': return await service.config()
+      case 'loadConfig': return await loadConfig()
       case 'restart': return await service.restart(body ?? {})
       case 'apply': return await service.apply(body?.url)
       case 'saveConfig': return await saveConfig(body?.config)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-cnb-assist",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "CNB 反代辅助：额度、本月 AI 用量、运行中容器反代地址，一键写回 DSH 模型配置",
   "type": "module",
   "main": "index.js",