@huai_xin/dsh-workbuddy 0.1.0 → 0.1.1

package/README.md

@@ -22,11 +22,16 @@ WorkBuddy 模型接入插件（DeepSeek Harness / DSH），同时支持两个部
 # 从 npm 安装到某个 profile（会同时把 bundle 挂进该 profile）
 dsh plugin --profile <profile> add @huai_xin/dsh-workbuddy
 
-# 本地目录（未发布时）
+# 直接从 GitHub 安装（npm 版本还没跟上改动时用它）
+dsh plugin --profile <profile> add github:2424830124/dsh-workbuddy
+
+# 本地目录（开发时）
 dsh plugin --profile <profile> add /path/to/dsh-workbuddy
 ```
 
-也可以在 Web UI 的插件管理里安装（效果相同，都是往 profile 的 `dsh.profile.bundles` 里加一条并应用 patch）。
+npm 页面：<https://www.npmjs.com/package/@huai_xin/dsh-workbuddy>
+
+也可以在 Web UI 的插件管理里安装（效果相同，都是往 profile 的依赖里加一条并应用 patch）。
 
 安装后需要重启 DSH（替换已加载的 JS 模块需要新的 generation），随后 `/workbuddy` 命令即可使用。
 
@@ -34,12 +39,9 @@ dsh plugin --profile <profile> add /path/to/dsh-workbuddy
 
 ### 设置页
 
-**设置 → WorkBuddy**（侧边栏齿轮 → WorkBuddy）是**一张卡片 + 账号标签页**：海外版与大陆版各自独立登录，点标签只切换查看，不影响已登录的账号。
+界面长什么样、每块显示什么，见下面的 [设置面板](#设置面板) 一节（含截图）。
 
-- 卡片头：状态圆点 + 部署名 + provider/端点 + 状态胶囊
-- 信息区：账号、到期时间、是否可自动续期、**积分**（总量 + 其中签到获得的）、**每日签到**（今日状态、连续天数、本周进度点）
-- 按钮：**登录**、**立即领取**（签到未完成时可点）、**续期**、**退出登录**
-- 卡片下方**常驻该账号的模型列表**，切标签即换列表
+面板通过宿主路由 `/workbuddy/{state,login,logout,refresh,models,checkin,availability,credits,busy,enabled,import}` 读写状态，这些路由走与宿主一致的连接信任栅栏，只对本机已被 GUI 接纳的来源开放。
 
 积分与签到：
 
@@ -48,8 +50,6 @@ dsh plugin --profile <profile> add /path/to/dsh-workbuddy
 - 登录成功后也会立刻补一次签到
 - 海外版后端没有签到接口，只显示积分、不显示领取按钮
 
-面板通过宿主路由 `/workbuddy/{state,login,logout,refresh,models,checkin}` 读写状态，这些路由走与宿主一致的连接信任栅栏，只对本机已被 GUI 接纳的来源开放。
-
 ### 命令
 
 ```
@@ -163,6 +163,7 @@ dsh-workbuddy/
 - 繁忙程度**只有大陆版有**（`POST /v2/chat/busy`；海外版 404，那一列整个不显示）：空闲 / 繁忙 / 拥堵 / 未知四档，用词与官方前端一致（官方把 `normal` 与 `idle` 并成「空闲」），悬停给出官方的完整说法（轻微拥堵 / 极度拥堵）。
 - 工具栏：搜索框、「全部启用 / 全部停用」（**只作用于可用分组**，不可用分组自己手动调）、「⟳ 刷新列表」、「检测可用性」（手动，立即执行）。这两个按钮宽度固定，「检测中…」不会把 ⟳ 挤走。
 - 打开面板时会自动检测一次（国内零消耗、可频繁；海外版每次探测一 token，每天最多一次）。
+- 开关**立即生效**：翻转后插件会通知 harness「模型集变了」，模型选择器随即重读目录（它的目录是缓存的，不通知就会一直显示已关掉的模型）。可用性探测结果与真实调用中学到的判定也会即时反映到默认开关上。
 
 > 该预览由 `node test/live/ui-preview.mjs` 用真实样式表生成到 `%TEMP%/wb-ui-preview.html`，改版后可以直接截图对比。
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huai_xin/dsh-workbuddy",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "WorkBuddy model provider for DeepSeek Harness (international + China deployments)",
   "type": "module",
   "main": "./src/index.js",

package/src/adapter.js

@@ -24,6 +24,7 @@ import { readCatalogCache, writeCatalogCache } from './catalog-cache.js'
 import { readPrefs, isEnabled } from './model-prefs.js'
 import { applyOfficialList, readOfficialList } from './official-list.js'
 import { chatRoutes } from './regions.js'
+import { notifyModelTopology } from './topology.js'
 
 const CATALOG_TTL_MS = 10 * 60_000
 const TOOL_RESULT_IMAGE_TEXT = 'Attached image(s) from tool result:'
@@ -450,12 +451,15 @@ export class WorkBuddyAdapter {
     if (/11102|service info not found/i.test(text)) {
       writeAvailability(this.region.id, [{ id: model, state: 'dead', detail: '模型不存在（11102 service info not found）', at: Date.now() }])
       this.invalidateCatalog()
+      // The verdict feeds the default on/off state, so the picker has to re-read.
+      notifyModelTopology(this.ctx)
       return
     }
     if (/11158|is not allowed for user type/i.test(text)) {
       const type = /user type \[([^\]]{0,40})\]/i.exec(text)?.[1] ?? ''
       writeAvailability(this.region.id, [{ id: model, state: 'denied', detail: `账号无权限（11158${type.length > 0 ? `，用户类型 ${type}` : ''}）`, at: Date.now() }])
       this.invalidateCatalog()
+      notifyModelTopology(this.ctx)
     }
   }
 
@@ -538,14 +542,16 @@ export class WorkBuddyAdapter {
     // when the user asks for it, which is how one gets tried anyway.
     const prefs = readPrefs(this.region.id)
     const dead = unusableModelIds(this.region.id)
-    return catalog
-      .filter((entry) => isEnabled(prefs, entry.id, dead.has(entry.id)))
-      .map((entry) => ({
-        provider,
-        id: entry.id,
-        name: entry.name,
-        inputModalities: [...entry.input]
-      }))
+    const offered = catalog.filter((entry) => isEnabled(prefs, entry.id, dead.has(entry.id)))
+    // Always logged: one line per picker open, and the fastest way to answer
+    // "did the picker re-read the list after that switch was flipped?".
+    this.ctx.logger.info(`[workbuddy] ${this.region.id}: 选择器读取目录 → ${offered.length}/${catalog.length} 个可选`)
+    return offered.map((entry) => ({
+      provider,
+      id: entry.id,
+      name: entry.name,
+      inputModalities: [...entry.input]
+    }))
   }
 
   /**

package/src/api.js

@@ -22,6 +22,7 @@ import { localDayKey } from './http.js'
 import { isEnabled, readPrefs, setEnabled } from './model-prefs.js'
 import { readOfficialList, writeOfficialList } from './official-list.js'
 import { REGIONS, REGION_IDS } from './regions.js'
+import { notifyModelTopology } from './topology.js'
 
 const API_PREFIX = '/workbuddy'
 const MAX_BODY_BYTES = 16 * 1024
@@ -219,7 +220,12 @@ export function registerWorkbuddyApi(ctx, adapters) {
           // The adapter's catalog is the merged one the model picker sees:
           // both live endpoints merged when they answer, otherwise the last
           // successful read from disk. `source` lets the panel say which.
-          if (url.searchParams.get('refresh') === '1') adapter.invalidateCatalog()
+          if (url.searchParams.get('refresh') === '1') {
+            adapter.invalidateCatalog()
+            // A manual refresh can change what the picker may offer, so the
+            // client's cached directory has to be told to re-read.
+            notifyModelTopology(ctx)
+          }
           const models = await adapter.models()
           const ledger = readAvailability(region.id)
           const imported = readOfficialList(region.id)
@@ -292,6 +298,9 @@ export function registerWorkbuddyApi(ctx, adapters) {
         const models = adapter === undefined ? [] : await adapter.models()
         const dead = unusableModelIds(region.id)
         const prefs = readPrefs(region.id)
+        // The picker caches its catalog until it hears this, so without the
+        // notification a model switched off here stays selectable there.
+        notifyModelTopology(ctx)
         ctx.logger.info(`[workbuddy] ${region.id}: ${reset ? '恢复默认' : (enabled ? '启用' : '停用')} ${ids.length} 个模型（${ids.length <= 3 ? ids.join(', ') : `${ids.slice(0, 3).join(', ')}…`}），手工设定 开${result.on}/关${result.off}`)
         sendJson(res, 200, {
           region: region.id,
@@ -440,6 +449,7 @@ export function registerWorkbuddyApi(ctx, adapters) {
           const result = writeOfficialList(region.id, body.models, { from: source })
           adapter?.invalidateCatalog()
           const models = adapter === undefined ? [] : await adapter.models()
+          notifyModelTopology(ctx)
           ctx.logger.info(`[workbuddy] ${region.id}: 账号名单${result.cleared === true ? '已清除' : `已导入 ${result.count} 个（其中 ${result.withMeta ?? 0} 个带元数据）`}（${source}），当前列表 ${models.length} 个`)
           sendJson(res, 200, {
             region: region.id,

package/src/index.js

@@ -23,6 +23,7 @@ import { claimDailyCheckin, runAutoClaim } from './credits.js'
 import { msUntilNextMidnight } from './http.js'
 import { readPrefs } from './model-prefs.js'
 import { REGIONS, REGION_IDS, regionList } from './regions.js'
+import { notifyModelTopology } from './topology.js'
 
 export const name = 'dsh-workbuddy'
 export const inject = ['commands', 'credentials', 'llm']
@@ -257,6 +258,8 @@ export function apply(ctx) {
         for (const verdict of result.results) counts.set(verdict.state, (counts.get(verdict.state) ?? 0) + 1)
         ctx.logger.info(`[workbuddy] ${id}: 启动可用性检测完成 ${result.results.length} 个${region.freeProbe === true ? '（零消耗）' : '（每个模型一个 token）'} — ${[...counts.entries()].map(([state, count]) => `${state} ${count}`).join(' / ')}`)
         adapter.invalidateCatalog()
+        // Verdicts decide the default on/off state, so tell the picker to re-read.
+        notifyModelTopology(ctx)
       })().catch((error) => {
         ctx.logger.warn(`[workbuddy] ${id}: 启动可用性检测失败 — ${error instanceof Error ? error.message : String(error)}`)
       })

package/src/topology.js

@@ -0,0 +1,56 @@
+/**
+ * The one place that tells the harness its model list changed.
+ *
+ * The Web client's model directory caches the catalog and only re-reads it when
+ * it hears a forwarded host event — `llm/adapters-updated` among them. Its
+ * declared contract says exactly what this needs: a payload-free notification
+ * after which "consumers re-read `listProviders()`, `listModels()`, or
+ * `listConfigurableProviders()` for the new state". Nothing else re-lists on a
+ * timer, so a switch the user just flipped, an imported account list, or a probe
+ * that retired a model stays invisible: the picker keeps offering models the panel
+ * has already switched off.
+ *
+ * `llm/adapters-updated` is on the app's forwarded-event allowlist and the
+ * forwarding layer subscribes with a plain `ctx.on(event, …)`, so emitting it
+ * reaches host listeners and every connected client. `ctx.emit` is preferred
+ * because the event name is a declared contract; the `llm` service's own
+ * `emitAdaptersUpdated()` (same dispatch, absent from the published contract) is
+ * the fallback.
+ *
+ * Everything is duck-typed, and the outcome is logged: when neither channel
+ * exists the panel still works, and the log says so instead of leaving a silent
+ * "the picker didn't refresh" mystery.
+ */
+
+/**
+ * @param {object} ctx - host plugin context.
+ * @returns {boolean} whether a notification was delivered.
+ */
+export function notifyModelTopology(ctx) {
+  let route = 'none'
+  let delivered = false
+  try {
+    if (typeof ctx?.emit === 'function') {
+      ctx.emit('llm/adapters-updated')
+      route = 'ctx.emit'
+      delivered = true
+    } else {
+      const llm = ctx?.llm ?? ctx?.get?.('llm')
+      if (llm !== undefined && llm !== null && typeof llm.emitAdaptersUpdated === 'function') {
+        llm.emitAdaptersUpdated()
+        route = 'llm.emitAdaptersUpdated'
+        delivered = true
+      }
+    }
+  } catch (error) {
+    ctx?.logger?.warn?.(`[workbuddy] 通知模型拓扑变化失败（不影响本次操作）：${error instanceof Error ? error.message : String(error)}`)
+    return false
+  }
+
+  ctx?.logger?.info?.(
+    delivered
+      ? `[workbuddy] 已通知模型拓扑变化（${route}）`
+      : '[workbuddy] 无法通知模型拓扑变化：当前上下文既没有 ctx.emit 也没有 llm.emitAdaptersUpdated，模型选择器要等它自己重读才会更新'
+  )
+  return delivered
+}