dsh-cnb-assist 1.0.3 → 1.0.5

package/README.md

@@ -1,101 +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.2`。
-
-离线安装也行，把 `dsh-cnb-assist-*.tgz` 拷到目标机器后填该文件的绝对路径。
-安装器认**目录**和 **`.tgz`/`.tar.gz`**，`.zip` 不被接受。
-
-装完**重启一次 dsh**（Host 层代码不会热更新），然后刷新页面。
-
----
-
-## 用
-
-### 1. 填令牌
-
-`设置 → CNB 反代辅助`，只有两项：
+### 方式 B：另一台电脑（推荐）
 
-| 项 | 说明 |
-|---|---|
-| **CNB 令牌** | CNB 的 access token，至少要有容器与构建日志的读权限 |
-| **模型 provider** | 写回地址时要改哪个 provider，默认 `cnb`，需与配置里的键名一致 |
-
-令牌也可以不填，插件会按顺序兜底查找：
-
-1. 插件设置里的 `config.token`
-2. `%APPDATA%\CnbAssist\settings.json`（桌面版辅助程序存过的那份）
-3. 环境变量 `CNB_API_KEY`
-
-令牌与地址**不随包分发**，每台机器各自配置。
-
-### 2. 打开面板
+**安装器只认目录或 `.tgz`/`.tar.gz`，不认 `.zip`**（`.zip` 会被当成目录去读 `package.json`，
+所以会报"该路径不存在或不是有效的插件包"）。
 
-点左侧栏底部的橘黄叶片图标，面板从上到下是四块：
+```bash
+# 把 local-dsh-cnb-assist-1.0.1.tgz 拷过去，然后在 DSH 里：
+plugin_manager → install_bundle → target: 该 tgz 的绝对路径
+# 也可以直接填解压后的目录绝对路径（目录里要有 package.json）
+```
 
-- **运行中容器** —— 反代地址，可复制、可四步重启、可一键写回模型地址
-- **当前配置** —— 从本 profile 的 `cordis.patch.yml` 里读出来的现有地址，标了行号和 provider
-- **额度** —— 每个组织的月额度 / 已用 / 预冻结，带进度条
-- **本月按组织** —— 本月创建的容器按组织汇总的 credits 与 token 用量
+> 版本号要在两台机器上对得起来。`files` 字段只列真实存在的条目（`locale` 写成目录而不是
+> `locale/*.json`），否则 `pnpm pack` 的 `scandir` 会直接报 ENOENT。
 
-### 3. 写回模型地址
+本包是纯 ESM 源码、零运行时依赖，除 `@deepseek-ai/schemastery`（从 dsh 安装里解析，不需要
+随包分发）之外不 import 任何第三方包，所以不存在"换台机器装不上"的 node_modules 问题。
 
-容器那一行点「设为模型地址」，插件把 `https://<business_id>-9001.cnb.run` 写进
-设置里那个 provider 的 `baseURL`。写前会留 `.bak`，只替换地址字符串本身。
+### 方式 C：私有 npm / git
 
----
+```bash
+# 推到自己的 npm 或 git 仓库后
+plugin_manager → install_bundle → target: 包名@版本 或 git+ssh://...
+```
 
-## 面板之外
+**装完重启一次 dsh**：`cordis.patch.yml` 属于 Host 层，HMR 不会重建 Host 模块。
 
-模型工具 `cnb_assist` 始终可用，四个动作：
+## 落点
 
-| 动作 | 作用 |
+| 位置 | 说明 |
 |---|---|
-| `snapshot` | 额度 / 用量 / 容器 / 当前配置，一次拿全 |
-| `config` | 读配置，或从中解析出现有反代地址 |
-| `restart` | 走 stop → 等停稳 → start → 等新地址 |
-| `apply` | 把地址写进指定 provider |
-
----
-
-## 常见问题
+| 左侧栏底部按钮 + 居中浮层 | 主入口（橘黄叶片图标） |
+| 设置 →「CNB 反代辅助」 | 只两项：CNB 令牌、模型 provider |
+| 模型工具 `cnb_assist` | 始终注册：`snapshot` / `config` / `restart` / `apply` |
 
-**面板说「未配置令牌」** —— 去设置里填，或把 `CNB_API_KEY` 设成环境变量后重启 dsh。
+> 右侧栏页签已移除：与左侧按钮重复，插件也不再依赖 `dsh-better-sidebar`。
 
-**额度是空的** —— 令牌权限不够。读容器列表要 `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。
 
-## 兼容性
+## 令牌从哪来
 
-- 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

@@ -1,5 +1,5 @@
 /**
- * @local/dsh-cnb-assist — Client half.
+ * dsh-cnb-assist — Client half.
  *
  * 三个落点，按有没有装 dsh-better-sidebar 自动选：
  *   1. better-sidebar 在 → 右侧栏页签「CNB」（页签 = 一个组件，数据经 host.call 从 Host 半身取）
@@ -10,13 +10,13 @@
  * 样式只用 --dsw-alias-* 主题令牌，亮色/暗色跟随宿主。
  */
 window.__ModuleLoader__.load({
-  id: '@local/dsh-cnb-assist',
+  id: 'dsh-cnb-assist',
   factory(require) {
     const React = require('react')
     const h = React.createElement
     const { useState, useEffect, useMemo, useRef, useSyncExternalStore, createContext, useContext } = React
 
-    const PLUGIN_ID = '@local/dsh-cnb-assist'
+    const PLUGIN_ID = 'dsh-cnb-assist'
     const ROUTE = 'cnb-assist/api'
     const ASSIST_KEY = 'dsh-cnb-assist'
     /** 本插件在宿主 locale 注册表里的命名空间（也是 slot 项的 locale 标记）。 */
@@ -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/cordis.patch.yml

@@ -1,7 +1,9 @@
 # CNB 反代辅助（DSH 插件）
 #
 # 一行 Host 半身：提供 cnbAssist 服务、/cnb-assist/api 路由、cnb_assist 工具。
-# 浏览器半身由 package.json 的 dsh.client 自动加载。
+# 浏览器半身由 package.json 的 dsh.client 自动加载：
+#   · 装了 dsh-better-sidebar → 右侧栏页签「CNB」
+#   · 没装 → 侧栏底部一个按钮 + 居中浮层面板
 - insert:
     - id: cnb-assist
       name: 'dsh-cnb-assist'

package/index.js

@@ -1,5 +1,5 @@
 /**
- * @local/dsh-cnb-assist — Host half.
+ * dsh-cnb-assist — Host half.
  *
  * 把 cnb-assist-wpf/core 里那套已经跑通的 CNB 逻辑搬进 DSH：
  *   Api.cs        → 这里的 callCnb / 各 endpoint
@@ -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,7 +1,7 @@
 {
   "name": "dsh-cnb-assist",
-  "version": "1.0.3",
-  "description": "CNB 反代辅助（DSH 插件）：查看各组织额度与本月 AI 用量，管理运行中容器的反代地址，一键写回模型 baseURL",
+  "version": "1.0.5",
+  "description": "CNB 反代辅助：额度、本月 AI 用量、运行中容器反代地址，一键写回 DSH 模型配置",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -18,26 +18,16 @@
     "locale",
     "README.md",
     "selfcheck.mjs",
-    "selfcheck-relay.mjs"
+    "selfcheck-relay.mjs",
+    "selfcheck-identity.mjs"
   ],
   "icon": "./icon.svg",
   "keywords": [
     "dsh",
     "dsh-plugin",
-    "cordis",
-    "deepseek-harness",
-    "cnb",
-    "cnb-cool"
+    "cnb"
   ],
   "license": "MIT",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/lonelymud/dsh-cnb-assist.git"
-  },
-  "homepage": "https://cnb.cool",
-  "engines": {
-    "node": ">=20"
-  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
@@ -50,5 +40,9 @@
         "@deepseek-ai/dsh-client-locale"
       ]
     }
+  },
+  "scripts": {
+    "test": "node selfcheck-identity.mjs && node selfcheck.mjs && node selfcheck-relay.mjs",
+    "prepublishOnly": "node selfcheck-identity.mjs && node selfcheck.mjs && node selfcheck-relay.mjs"
   }
 }

package/selfcheck-identity.mjs

@@ -0,0 +1,108 @@
+/**
+ * 发布前一致性门禁。
+ *
+ * 背景：1.0.3 发出去后 dsh 启动崩溃，根因是 client.js 里的
+ * `__ModuleLoader__.load({ id })` 还写着 `@local/dsh-cnb-assist`，
+ * 而包名已经是 `dsh-cnb-assist`。客户端按 @local/... 注册，设置表单按新包名查，
+ * 两边对不上直接把宿主带崩。
+ *
+ * 这个脚本把这些"必须处处一致"的标识全部对一遍，任何一个跑偏就非零退出，
+ * 让 npm publish 在 commit 之前就失败。
+ */
+import assert from 'node:assert/strict'
+import { readFileSync } from 'node:fs'
+import { fileURLToPath } from 'node:url'
+import { dirname, join } from 'node:path'
+
+const here = dirname(fileURLToPath(import.meta.url))
+const read = f => readFileSync(join(here, f), 'utf8')
+
+const pkg = JSON.parse(read('package.json'))
+const clientJs = read('client.js')
+const indexJs = read('index.js')
+const patchYml = read('cordis.patch.yml')
+
+let pass = 0
+function ok(name) {
+  pass += 1
+  console.log('PASS ', name)
+}
+function eq(name, actual, expected) {
+  assert.equal(actual, expected, `${name}\n  actual  : ${actual}\n  expected: ${expected}`)
+  pass += 1
+  console.log('PASS ', name)
+}
+
+const PLUGIN = pkg.name
+
+// ── 1. 包名必须是公开可发布的形态
+ok('包名非空')
+assert.ok(PLUGIN && PLUGIN.length > 0)
+ok('包名不是 @local/ 私有 scope')
+assert.ok(!PLUGIN.startsWith('@local/'), `包名仍是私有 scope：${PLUGIN}`)
+ok('没有 private:true')
+assert.notEqual(pkg.private, true)
+
+// ── 2. client.js 的加载 id 必须与包名一致
+const loadId = /__ModuleLoader__\.load\(\{\s*\n\s*id:\s*'([^']+)'/.exec(clientJs)?.[1]
+eq('client.js __ModuleLoader__ id 与包名一致', loadId, PLUGIN)
+
+const pluginId = /const PLUGIN_ID = '([^']+)'/.exec(clientJs)?.[1]
+eq('client.js PLUGIN_ID 与包名一致', pluginId, PLUGIN)
+
+// ── 3. host 半身导出名必须与包名一致
+const hostName = /export const name = '([^']+)'/.exec(indexJs)?.[1]
+eq('index.js export name 与包名一致', hostName, PLUGIN)
+
+// ── 4. bundle patch 里 insert 的 name 必须与包名一致
+const patchName = /^\s*name:\s*'([^']+)'/m.exec(patchYml)?.[1]
+eq('cordis.patch.yml insert name 与包名一致', patchName, PLUGIN)
+
+// ── 5. 任何文件都不该再出现 @local/
+const files = ['client.js', 'index.js', 'cordis.patch.yml', 'package.json', 'README.md',
+  'locale/zh.json', 'locale/en.json', 'selfcheck.mjs', 'selfcheck-relay.mjs']
+const offenders = []
+for (const f of files) {
+  let text
+  try { text = read(f) } catch { continue }
+  const lines = text.split('\n')
+  lines.forEach((line, i) => {
+    if (line.includes('@local/')) offenders.push(`${f}:${i + 1} ${line.trim()}`)
+  })
+}
+if (offenders.length > 0) {
+  console.log('\n发现 @local/ 残留：')
+  for (const o of offenders) console.log('  ' + o)
+}
+eq('全仓库无 @local/ 残留', offenders.length, 0)
+
+// ── 6. files 清单里每一项都要真实存在（locale 作为目录）
+const { existsSync } = await import('node:fs')
+for (const entry of pkg.files ?? []) {
+  ok(`files 清单存在：${entry}`)
+  assert.ok(existsSync(join(here, entry)), `files 里列了不存在的条目：${entry}`)
+}
+
+// ── 7. 两个必需文件必须在清单里
+ok('index.js 在 files 里')
+assert.ok((pkg.files ?? []).includes('index.js'))
+ok('client.js 在 files 里')
+assert.ok((pkg.files ?? []).includes('client.js'))
+ok('cordis.patch.yml 在 files 里')
+assert.ok((pkg.files ?? []).includes('cordis.patch.yml'))
+
+// ── 8. dsh 清单字段完整
+eq('dsh.bundle.patch 指向 cordis.patch.yml', pkg.dsh?.bundle?.patch, './cordis.patch.yml')
+eq('dsh.client.platform 是 web', pkg.dsh?.client?.platform, 'web')
+ok('dsh.client.immediately 为 true')
+assert.equal(pkg.dsh?.client?.immediately, true)
+ok('dsh.client.inject 含 ui-slots')
+assert.ok(pkg.dsh?.client?.inject?.includes('@deepseek-ai/dsh-client-ui-slots'))
+ok('dsh.client.inject 含 locale')
+assert.ok(pkg.dsh?.client?.inject?.includes('@deepseek-ai/dsh-client-locale'))
+
+// ── 9. 版本号形态
+ok('version 是 x.y.z')
+assert.match(pkg.version, /^\d+\.\d+\.\d+$/)
+
+console.log(`\nall ${pass} consistency checks passed (package: ${PLUGIN}@${pkg.version})`)