dsh-cnb-assist 1.0.2 → 1.0.4

package/README.md

@@ -1,6 +1,6 @@
 # CNB 反代辅助
 
-DeepSeek Harness（DSH）插件。把 CNB 的额度、AI 用量和运行中容器的反代地址放进 IDE 侧栏，
+DeepSeek​ Harness（DSH）插件。把 CNB 的额度、AI 用量和运行中容器的反代地址放进 IDE 侧栏，
 并提供「一键写回模型地址」和「四步重启容器」。
 
 - **令牌不出 Host 进程** —— 浏览器那半只拿到算好的数字。
@@ -17,7 +17,7 @@ DeepSeek Harness（DSH）插件。把 CNB 的额度、AI 用量和运行中容
 plugin_manager → install_bundle → target: dsh-cnb-assist
 ```
 
-要固定版本就写 `dsh-cnb-assist@1.0.2`。
+要固定版本就写 `dsh-cnb-assist@1.0.4`。
 
 离线安装也行，把 `dsh-cnb-assist-*.tgz` 拷到目标机器后填该文件的绝对路径。
 安装器认**目录**和 **`.tgz`/`.tar.gz`**，`.zip` 不被接受。
@@ -59,6 +59,17 @@ plugin_manager → install_bundle → target: dsh-cnb-assist
 容器那一行点「设为模型地址」，插件把 `https://<business_id>-9001.cnb.run` 写进
 设置里那个 provider 的 `baseURL`。写前会留 `.bak`，只替换地址字符串本身。
 
+### 反代地址从哪来
+
+优先读容器构建日志里平台注入的模板行：
+
+```
+PROXY_URI=https://<business_id>-{{port}}.cnb.run
+```
+
+把 `{{port}}` 换成 `9001` 后作为地址显示。日志里取不到时，才用容器的 `business_id`
+直接拼 `https://<business_id>-9001.cnb.run`。两条路都走，有哪个显示哪个。
+
 ---
 
 ## 面板之外
@@ -85,6 +96,8 @@ plugin_manager → install_bundle → target: dsh-cnb-assist
 
 **重启后地址变了** —— 正常。重启会重建容器，`business_id` 变，地址跟着变。
 
+**地址里出现 `{{port}}`** —— 升级到 1.0.4 及以上。
+
 **改完配置没生效** —— `cordis.patch.yml` 属于 Host 层，要重启 dsh，刷新页面不够。
 
 ---

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

@@ -29,6 +29,17 @@ export const inject = ['webServer', 'tools']
 /** CNB 地址固定的反代端口（用户已确认固定，见 AGENTS.md §7）。 */
 const RELAY_PORT = 9001
 
+/**
+ * 阶段日志里平台注入的地址模板，形如：
+ *   PROXY_URI=https://n2lc6c2bdm-{{port}}.cnb.run
+ * ★ {{port}} 是字面量双大括号，不是模板字符串语法。
+ * ★ 这一行有时会和后面的输出粘在同一行尾（`... ===== register skipped`），必须按空白截断。
+ */
+const PROXY_URI_RX = /PROXY_URI\s*=\s*([^\s"'`,;]+)/
+
+/** 把地址模板里的 {{port}} 换成真实端口。 */
+const PORT_PLACEHOLDER_RX = /\{\{\s*port\s*\}\}/gi
+
 /** 浏览器半身投递的路由。 */
 const ROUTE = '/cnb-assist/api'
 
@@ -542,15 +553,47 @@ async function buildMonthSummary(call) {
 
 // ───────────────────────────── 反代地址 ─────────────────────────────
 
-/** business_id + 固定端口拼地址（最后一级兜底）。 */
+/** business_id + 固定端口拼地址（兜底之一）。 */
 function relayFromBusinessId(businessId) {
   const id = String(businessId ?? '').trim()
   return id === '' ? null : `https://${id}-${RELAY_PORT}.cnb.run/v1`
 }
 
+/**
+ * 把地址里的 {{port}} 占位符换成真实端口，再补成可用的 /v1 地址。
+ * 已经是成品地址的（没有占位符）原样保留，只补 /v1。
+ */
+function materializeRelayUrl(raw) {
+  const text = String(raw ?? '').trim()
+  if (text === '') return null
+  let url = text.replace(PORT_PLACEHOLDER_RX, String(RELAY_PORT))
+  let parsed
+  try {
+    parsed = new URL(url)
+  } catch {
+    return null
+  }
+  if (!parsed.host.toLowerCase().endsWith('.cnb.run')) return null
+  const path = parsed.pathname.replace(/\/+$/, '')
+  parsed.pathname = path.toLowerCase().endsWith('/v1') ? path : `${path}/v1`
+  return parsed.toString()
+}
+
+/**
+ * 从阶段日志里取 PROXY_URI 模板。
+ * ★ 这是最权威的来源：容器重建后 business_id 由平台重新分配，模板里的就是新值。
+ */
+function relayFromProxyUri(text) {
+  if (typeof text !== 'string' || text === '') return null
+  const match = PROXY_URI_RX.exec(text)
+  return match === null ? null : materializeRelayUrl(match[1])
+}
+
 /**
  * 从阶段日志里抠地址，带打分：来自该 business_id 的 > 路径以 /v1 结尾的 >
  * 端口是 9001 的。找不到 cnb.run 就返回 null。
+ * ★ new URL() 能"接受" {{port}}（它把整段当主机名），所以旧写法不会报错，
+ *   只会把没替换占位符的字符串原样展示出去。必须先 materialize 再判分。
  */
 function extractRelayAddress(text, businessId = '') {
   if (typeof text !== 'string' || text === '') return null
@@ -561,9 +604,11 @@ function extractRelayAddress(text, businessId = '') {
     const raw = match[0].replace(/[.，。；]+$/, '')
     if (raw.length <= 12) continue
     if (!raw.includes('.cnb.run')) continue
+    const normalized = materializeRelayUrl(raw)
+    if (normalized === null) continue
     let url
     try {
-      url = new URL(raw)
+      url = new URL(normalized)
     } catch {
       continue
     }
@@ -571,17 +616,18 @@ function extractRelayAddress(text, businessId = '') {
     let score = 1
     if (businessId !== '' && host.startsWith(`${businessId.toLowerCase()}-`)) score += 10
     if (url.pathname.replace(/\/+$/, '').toLowerCase().endsWith('/v1')) score += 4
-    if (url.port === String(RELAY_PORT) || host.endsWith(`-${RELAY_PORT}.cnb.run`)) score += 3
+    if (host.endsWith(`-${RELAY_PORT}.cnb.run`)) score += 3
+    if (PORT_PLACEHOLDER_RX.test(raw)) score += 5
+    PORT_PLACEHOLDER_RX.lastIndex = 0
     if (score > bestScore) {
       bestScore = score
-      best = raw
+      best = normalized
     }
   }
   return bestScore > 0 ? best : null
 }
 
 async function resolveRelayAddress(call, slug, sn, pipelineId) {
-  const businessRelay = (item) => relayFromBusinessId(item?.business_id)
   if (slug === '' || sn === '') return null
   const status = await call(`/${enc(slug)}/-/build/status/${enc(sn)}`)
   const stageIds = []
@@ -595,18 +641,25 @@ async function resolveRelayAddress(call, slug, sn, pipelineId) {
   }
   // stage-0 优先（AGENTS.md §7.3：不同仓库可能没有这个阶段名，所以逐阶段扫）。
   stageIds.sort((a, b) => (a === 'stage-0' ? 0 : 1) - (b === 'stage-0' ? 0 : 1))
+
+  // 先找 PROXY_URI 那一行（权威来源），扫不到再退回通用打分。两轮都扫同一批日志。
+  let scanned = ''
   for (const stage of stageIds) {
     const log = await call(
       `/${enc(slug)}/-/build/logs/stage/${enc(sn)}/${enc(pipelineId)}/${enc(stage)}`,
     )
     if (!log.ok) continue
     const content = Array.isArray(log.json?.content) ? log.json.content.join('\n') : ''
-    const found = extractRelayAddress(content, '')
-    if (found !== null) return found
+    scanned += `${content}\n`
+    const fromTemplate = relayFromProxyUri(content)
+    if (fromTemplate !== null) return fromTemplate
   }
+  const fromLog = extractRelayAddress(scanned, '')
+  if (fromLog !== null) return fromLog
+
   const listed = await listWorkspaces(call)
   const me = listed.items.find(item => String(item?.sn ?? '') === sn)
-  return businessRelay(me)
+  return relayFromBusinessId(me?.business_id)
 }
 
 /** 运行中容器一行：地址还没解析出来时先给 business_id 兜底值。 */
@@ -622,13 +675,19 @@ async function buildRelayRows(call) {
     const slug = String(item?.slug ?? '')
     const pipelineId = String(item?.pipeline_id ?? '')
     const businessRelay = relayFromBusinessId(item?.business_id)
-    let address = businessRelay
+    // ★ 两路都要试：日志里的 PROXY_URI 模板是平台重建后注入的新值，比 business_id 新。
+    //   先查日志，查不到才退回 business_id 拼的地址。
+    let address = null
+    let source = 'none'
+    try {
+      address = await resolveRelayAddress(call, slug, sn, pipelineId)
+      if (address !== null) source = 'log'
+    } catch {
+      address = null
+    }
     if (address === null) {
-      try {
-        address = await resolveRelayAddress(call, slug, sn, pipelineId)
-      } catch {
-        address = null
-      }
+      address = businessRelay
+      if (address !== null) source = 'businessId'
     }
     const created = parseTime(item?.create_time)
     const seconds = created === null ? Number(item?.duration) || 0 : (Date.now() - created) / 1000
@@ -641,6 +700,7 @@ async function buildRelayRows(call) {
       pipelineId,
       businessId: String(item?.business_id ?? ''),
       address,
+      addressSource: source,
       createdAt: created,
       runningSeconds: Math.max(0, seconds),
       text: {
@@ -734,8 +794,13 @@ async function runRestart(call, input, settings) {
     const listed = await listWorkspaces(call)
     const me = listed.items.find(item => String(item?.sn ?? '') === newSn)
     if (me === undefined) continue
-    address = relayFromBusinessId(me?.business_id)
-      ?? await resolveRelayAddress(call, String(me?.slug ?? slug), newSn, String(me?.pipeline_id ?? ''))
+    let fromLog = null
+    try {
+      fromLog = await resolveRelayAddress(call, String(me?.slug ?? slug), newSn, String(me?.pipeline_id ?? ''))
+    } catch {
+      fromLog = null
+    }
+    address = fromLog ?? relayFromBusinessId(me?.business_id)
     if (address !== null) break
   }
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-cnb-assist",
-  "version": "1.0.2",
-  "description": "CNB 反代辅助（DSH 插件）：查看各组织额度与本月 AI 用量，管理运行中容器的反代地址，一键写回模型 baseURL",
+  "version": "1.0.4",
+  "description": "CNB 反代辅助：额度、本月 AI 用量、运行中容器反代地址，一键写回 DSH 模型配置",
   "type": "module",
   "main": "index.js",
   "exports": {
@@ -17,26 +17,17 @@
     "icon.svg",
     "locale",
     "README.md",
-    "selfcheck.mjs"
+    "selfcheck.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"
@@ -49,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})`)

package/selfcheck-relay.mjs

@@ -0,0 +1,127 @@
+/**
+ * 反代地址规则的离线自检：不联网，纯字符串。
+ * 覆盖两种来源（PROXY_URI 模板 / business_id 拼）、占位符替换、以及旧版会漏掉的情形。
+ */
+import assert from 'node:assert/strict'
+
+const RELAY_PORT = 9001
+const PROXY_URI_RX = /PROXY_URI\s*=\s*([^\s"'`,;]+)/
+const PORT_PLACEHOLDER_RX = /\{\{\s*port\s*\}\}/gi
+
+function materializeRelayUrl(raw) {
+  const text = String(raw ?? '').trim()
+  if (text === '') return null
+  let url = text.replace(PORT_PLACEHOLDER_RX, String(RELAY_PORT))
+  let parsed
+  try {
+    parsed = new URL(url)
+  } catch {
+    return null
+  }
+  if (!parsed.host.toLowerCase().endsWith('.cnb.run')) return null
+  const path = parsed.pathname.replace(/\/+$/, '')
+  parsed.pathname = path.toLowerCase().endsWith('/v1') ? path : `${path}/v1`
+  return parsed.toString()
+}
+
+function relayFromProxyUri(text) {
+  if (typeof text !== 'string' || text === '') return null
+  const match = PROXY_URI_RX.exec(text)
+  return match === null ? null : materializeRelayUrl(match[1])
+}
+
+function relayFromBusinessId(businessId) {
+  const id = String(businessId ?? '').trim()
+  return id === '' ? null : `https://${id}-${RELAY_PORT}.cnb.run/v1`
+}
+
+let pass = 0
+function ok(name, cond) {
+  assert.ok(cond, 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)
+}
+
+// ── 1. 真实日志原样（今天从 cnb-ps0-1k77t7qst 抓的）
+const REAL = [
+  'Runner[10.235.16.12][docker] 2026-11-12 20:55:52 $',
+  '===== proxy self-check: health OK =====',
+  '{"status":"ok","uptime_sec":1}',
+  'PROXY_URI=https://n2lc6c2bdm-{{port}}.cnb.run',
+  '===== register skipped (REGISTER_URL / REG_TOKEN / PROXY_URI missing) =====',
+].join('\n')
+
+eq('真实日志 → 模板地址',
+  relayFromProxyUri(REAL),
+  'https://n2lc6c2bdm-9001.cnb.run/v1')
+
+// ── 2. 占位符替换本身
+eq('{{port}} 换成 9001',
+  materializeRelayUrl('https://n2lc6c2bdm-{{port}}.cnb.run'),
+  'https://n2lc6c2bdm-9001.cnb.run/v1')
+eq('带空格 {{ port }} 也认',
+  materializeRelayUrl('https://abc-{{ port }}.cnb.run'),
+  'https://abc-9001.cnb.run/v1')
+eq('大写 {{PORT}} 也认',
+  materializeRelayUrl('https://abc-{{PORT}}.cnb.run'),
+  'https://abc-9001.cnb.run/v1')
+
+// ── 3. 已经是成品地址的不该被破坏
+eq('成品地址原样保留',
+  materializeRelayUrl('https://n2lc6c2bdm-9001.cnb.run/v1'),
+  'https://n2lc6c2bdm-9001.cnb.run/v1')
+eq('成品地址缺 /v1 要补',
+  materializeRelayUrl('https://n2lc6c2bdm-9001.cnb.run'),
+  'https://n2lc6c2bdm-9001.cnb.run/v1')
+
+// ── 4. 粘在行尾的情形（真实日志里出现过）
+eq('PROXY_URI 后面粘了别的输出',
+  relayFromProxyUri('PROXY_URI=https://n2lc6c2bdm-{{port}}.cnb.run ===== register skipped ====='),
+  'https://n2lc6c2bdm-9001.cnb.run/v1')
+
+// ── 5. 多行里夹杂其它 URL，只认 PROXY_URI 那行
+eq('只认 PROXY_URI 那行',
+  relayFromProxyUri('see https://example.com/x\nPROXY_URI=https://zz9-{{port}}.cnb.run\nmore https://other.cnb.run/y'),
+  'https://zz9-9001.cnb.run/v1')
+
+// ── 6. 没有模板行 → null，交给 business_id 兜底
+eq('无模板行返回 null', relayFromProxyUri('nothing here'), null)
+eq('空串返回 null', relayFromProxyUri(''), null)
+eq('非字符串返回 null', relayFromProxyUri(null), null)
+
+// ── 7. business_id 兜底
+eq('business_id 拼地址',
+  relayFromBusinessId('n2lc6c2bdm'),
+  'https://n2lc6c2bdm-9001.cnb.run/v1')
+eq('business_id 为空返回 null', relayFromBusinessId(''), null)
+eq('business_id 是 undefined 返回 null', relayFromBusinessId(undefined), null)
+
+// ── 8. 两种来源必须同址（本容器实测）
+eq('模板与 business_id 结果一致',
+  relayFromProxyUri(REAL),
+  relayFromBusinessId('n2lc6c2bdm'))
+
+// ── 9. 旧版行为回归：模板行不会被 new URL() 拒绝（它把 {{port}} 当主机名的一部分），
+//    但旧代码会以"未替换占位符"的形态胜出并展示出去，且拿不到端口那 3 分。
+//    ★ 这一点很容易误判成"旧代码会抛异常"——实测不会。
+const oldParsed = new URL('https://n2lc6c2bdm-{{port}}.cnb.run')
+ok('模板能被 new URL() 解析（所以旧代码不是抛异常，是错在别处）',
+  oldParsed.host === 'n2lc6c2bdm-{{port}}.cnb.run')
+ok('旧代码的端口判分条件不成立（拿不到 +3 分）',
+  oldParsed.host.toLowerCase().endsWith(`-${RELAY_PORT}.cnb.run`) === false)
+ok('旧代码会原样输出未替换的占位符',
+  oldParsed.toString().includes('{{port}}'))
+ok('新代码输出已替换的成品地址',
+  relayFromProxyUri(REAL) === 'https://n2lc6c2bdm-9001.cnb.run/v1')
+ok('新代码输出不再含占位符',
+  !relayFromProxyUri(REAL).includes('{{'))
+
+// ── 10. 非 cnb.run 域名不该被当成反代地址
+eq('非 cnb.run 返回 null', materializeRelayUrl('https://evil.example.com/{{port}}'), null)
+
+console.log(`\nall ${pass} checks passed`)