@dsh-plugins/dsh-llm-hub 0.7.2 → 0.7.3

package/CHANGELOG.md

@@ -2,6 +2,29 @@
 
 本项目遵循 [Semantic Versioning](https://semver.org/lang/zh-CN/)。
 
+## [0.7.3] - 2026-09-17
+
+### 新增
+
+- **模型页显示外部 harness 一览**：设置 → 模型 页脚多一行 chips，直接看到
+  codex / claude / agy 三者各自的状态 —— 可委派（绿点）、已由其它插件提供、未安装。
+  鼠标悬停给出该做什么，并显示**解析到的可执行文件路径**（「装了却不生效」时，
+  第一件要确认的就是它找到的是哪个副本）。
+
+  几个刻意的取舍：
+  - **未安装的也显示**（置灰）。这一行的用处一半是「现在能派给谁」，另一半是
+    「装上哪个就能多派一个」；全过滤掉就只剩前一半，没人会知道还能有什么。
+  - **`probed` 为 false 时整行不渲染**。host 半是异步探测的，页面可能在探完前就
+    打开了 —— 这时渲染「未安装 ×3」是在说谎，会让人去装一个其实已经装了的 CLI。
+  - **前端只读 host 探好的快照**（`/api/dsh-llm-hub/harness`），不自己探。探测要
+    解析可执行文件，那是 host 的活，两处各探一遍只会不一致。
+  - 排在页脚那行之上（order 90 vs 100）：harness 讲的是「能派给谁」属能力信息，
+    页脚那行是插件版本与链接属元信息。
+
+  挂载点测试同步更新 —— 它本来就钉住了「一共挂几个 slot」，这次如实抓到了新增的
+  那个，顺便补了「footer 是 list slot，两个条目都必须带 id 与 order」的断言
+  （漏 id 会被宿主静默丢弃：接口通、组件在、页面上什么都没有）。
+
 ## [0.7.0] - 2026-09-17
 
 ### 新增

package/lib/client.js

@@ -60,6 +60,8 @@ window.__ModuleLoader__.load({
 		const META_URL = '/api/dsh-llm-hub/meta'
 
 		/** 模型可用性：读缓存 / 强制全量重探（host 半同名路由）。 */
+		/** harness 探测快照；host 半在 apply 时探一次，这里只读。 */
+		const HARNESS_URL = '/api/dsh-llm-hub/harness'
 		const AVAILABILITY_URL = '/api/dsh-llm-hub/availability'
 		const AVAILABILITY_RECHECK_URL = '/api/dsh-llm-hub/availability/recheck'
 
@@ -75,6 +77,13 @@ window.__ModuleLoader__.load({
 				toppedUp: '充值',
 				unavailable: '账户不可用',
 				failed: '查询失败',
+				harnessTitle: '外部 Agent',
+				harnessReady: '可委派',
+				harnessOccupied: '已由其它插件提供',
+				harnessMissing: '未安装',
+				harnessHintReady: '会话里可用 subagent_%s 把独立任务交给它',
+				harnessHintOccupied: '本机装了，但这个提供方已被另一个插件注册',
+				harnessHintMissing: '装上 %s 并重启 DSH，它就会出现',
 				probe: '探测网关',
 				probing: '探测中…',
 				reachable: '可达',
@@ -124,6 +133,13 @@ window.__ModuleLoader__.load({
 				toppedUp: 'Topped up',
 				unavailable: 'Account unavailable',
 				failed: 'Balance check failed',
+				harnessTitle: 'External agents',
+				harnessReady: 'ready',
+				harnessOccupied: 'provided by another plugin',
+				harnessMissing: 'not installed',
+				harnessHintReady: 'Delegate a standalone task with subagent_%s',
+				harnessHintOccupied: 'Installed here, but another plugin already registered this provider',
+				harnessHintMissing: 'Install %s and restart DSH to make it appear',
 				probe: 'Probe gateway',
 				probing: 'Probing…',
 				reachable: 'Reachable',
@@ -178,6 +194,17 @@ window.__ModuleLoader__.load({
 				'margin-top:8px;padding:8px 10px;border-radius:8px;',
 				'border:.5px solid var(--dsw-alias-border-l1);background:var(--dsw-alias-bg-layer-2);',
 				'font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}',
+				'.dsh-llm-hub-harness{display:flex;align-items:center;gap:8px;flex-wrap:wrap;',
+				'font-size:12px;line-height:18px;color:var(--dsw-alias-label-secondary)}',
+				'.dsh-llm-hub-harness__chip{display:inline-flex;align-items:center;gap:5px;',
+				'padding:2px 8px;border-radius:999px;border:.5px solid var(--dsw-alias-border-l1);',
+				'background:var(--dsw-alias-bg-layer-2)}',
+				'.dsh-llm-hub-harness__chip--missing{opacity:.55}',
+				'.dsh-llm-hub-harness__dot{width:6px;height:6px;border-radius:50%;',
+				'background:var(--dsw-alias-label-secondary);flex:none}',
+				'.dsh-llm-hub-harness__dot--ready{background:var(--dsw-alias-state-success-primary,#3fb950)}',
+				'.dsh-llm-hub-harness__name{color:var(--dsw-alias-label-primary)}',
+				'.dsh-llm-hub-harness__state{opacity:.75}',
 				'.dsh-llm-hub-balance__label{color:var(--dsw-alias-label-secondary)}',
 				'.dsh-llm-hub-balance__amount{color:var(--dsw-alias-label-primary);font-weight:600;',
 				'font-variant-numeric:tabular-nums}',
@@ -625,6 +652,56 @@ window.__ModuleLoader__.load({
 		 * @param props - 注入的 `t`。
 		 * @returns 页脚节点；元信息读不到时返回 null（不占位、不报错）。
 		 */
+		/**
+		 * 外部 harness 一览。
+		 *
+		 * 只读 host 半 apply 时探好的快照（`/api/dsh-llm-hub/harness`），不自己探 ——
+		 * 探测要 spawn 解析可执行文件，那是 host 的活，前端重复做一遍只会两处不一致。
+		 *
+		 * 未安装的**也显示**（置灰）：这一行的用处一半是「现在能派给谁」，另一半是
+		 * 「装上哪个就能多派一个」。全过滤掉就只剩前一半，用户永远不知道还能有什么。
+		 * @param props - `t` 文案函数。
+		 * @returns 一行 chips；探测未完成或接口不可用时返回 null。
+		 */
+		function HarnessRow(props) {
+			const t = typeof props.t === 'function' ? props.t : fallbackT
+			const [report, setReport] = React.useState(null)
+			React.useEffect(() => {
+				let alive = true
+				fetch(HARNESS_URL, { headers: { accept: 'application/json' } })
+					.then((res) => res.json())
+					.then((body) => { if (alive) setReport(body) })
+					.catch(() => { if (alive) setReport({ ok: false }) })
+				return () => { alive = false }
+			}, [])
+			// probed 为 false 是启动竞态（host 还没探完），不是「一个都没装」——
+			// 这时候渲染「未安装 ×3」会说谎，所以什么都不显示。
+			if (report === null || report.ok !== true || report.probed !== true) return null
+			const list = Array.isArray(report.harnesses) ? report.harnesses : []
+			if (list.length === 0) return null
+			ensureStyle()
+			return h('div', { className: 'dsh-llm-hub-harness' },
+				h('span', { className: 'dsh-llm-hub-harness__state' }, t('harnessTitle')),
+				list.map((item) => {
+					const state = item.registered === true
+						? { text: t('harnessReady'), hint: t('harnessHintReady').replace('%s', String(item.id).replace(/-/g, '_')), ready: true }
+						: (item.installed === true
+							? { text: t('harnessOccupied'), hint: t('harnessHintOccupied'), ready: false }
+							: { text: t('harnessMissing'), hint: t('harnessHintMissing').replace('%s', item.bin), ready: false })
+					return h('span', {
+						key: item.id,
+						className: 'dsh-llm-hub-harness__chip' + (item.installed === true ? '' : ' dsh-llm-hub-harness__chip--missing'),
+						// 路径放进 tooltip：装了却不生效时，第一件要确认的就是「它找到的是哪个副本」。
+						title: state.hint + (typeof item.executable === 'string' ? '\n' + item.executable : '')
+					},
+						h('span', { className: 'dsh-llm-hub-harness__dot' + (state.ready ? ' dsh-llm-hub-harness__dot--ready' : '') }),
+						h('span', { className: 'dsh-llm-hub-harness__name' }, item.displayName),
+						h('span', { className: 'dsh-llm-hub-harness__state' }, state.text)
+					)
+				})
+			)
+		}
+
 		function HubFooter(props) {
 			const t = typeof props.t === 'function' ? props.t : fallbackT
 			const availability = props.availability
@@ -846,6 +923,15 @@ window.__ModuleLoader__.load({
 			// 的 children 声明），list 类 slot 注册**必须带 id** —— 参照宿主自己的
 			// settings.onboarding 注册（id:'welcome-notice', order:-100）。
 			// 第一版漏了 id，注册被静默丢弃：接口通、组件在、页面上什么都没有。
+			// harness 一览排在 footer 那行之上（order 更小）：它讲的是「能派给谁」，
+			// 属于能力信息；footer 那行是插件自身的版本与链接，属于元信息。
+			ctx.slots.inject('settings.models.footer', () => ctx.slots.register({
+				name: 'settings.models.footer',
+				id: 'dsh-llm-hub-harness',
+				order: 90,
+				locale: NS,
+				inject: () => ({ t })
+			}, HarnessRow))
 			ctx.slots.inject('settings.models.footer', () => ctx.slots.register({
 				name: 'settings.models.footer',
 				id: 'dsh-llm-hub-footer',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dsh-plugins/dsh-llm-hub",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "给 DSH 模型页补上官方适配器缺的那半：网关可达性探测、模型目录拉取、DeepSeek 余额常驻，以及 MiniMax / 智谱 / Moonshot / StepFun 的余额与配额卡；再把本机装好的 codex / claude / agy 注册成子代理（装了才出现）。零运行时依赖，不改动 DSH 安装。",
   "type": "module",
   "main": "lib/index.js",
@@ -26,7 +26,7 @@
     }
   },
   "scripts": {
-    "deploy": "rsync -av --delete lib/ ~/.dsh/profiles/web/node_modules/@webkubor/dsh-llm-hub/lib/ && rsync -av package.json cordis.patch.yml README.md README.en.md LICENSE ~/.dsh/profiles/web/node_modules/@webkubor/dsh-llm-hub/",
+    "deploy": "rsync -av --delete lib/ ~/.dsh/profiles/web/node_modules/@dsh-plugins/dsh-llm-hub/lib/ && rsync -av package.json cordis.patch.yml README.md README.en.md LICENSE ~/.dsh/profiles/web/node_modules/@dsh-plugins/dsh-llm-hub/",
     "preview": "npm run deploy && open http://127.0.0.1:3080",
     "check": "for f in lib/*.js; do node --check \"$f\" || exit 1; done",
     "test": "node --test"