dsh-router-core 0.3.21 → 0.4.0

package/src/client/ExtDetail.tsx

@@ -1,20 +1,11 @@
 /**
  * 扩展详情页 —— 从设置 → 路由 → 扩展 的卡片点进来。
  *
- * 通用：返回键 + 扩展名/说明/就绪态。`watch` 扩展再渲染进程监控面板：
- * 实时采样「agent 启动的进程」，每行 PID / 命令 / CPU% / 内存%，**只读**——不提供
- * kill（杀进程是大事，交由用户在 CLI 自己操作）。面板提供「复制 PID」和
- * 「复制 kill 命令」两个剪贴板动作方便用户去终端处理。
- * 进程数据走后端 `/router/api/ext/:id/processes`；`ps` 瞬时失败时保留上一帧，别刷成
- * 整屏错误。
+ * 布局同供应商详情：返回链接 + 图标 + 名称/副行，头部右侧是启用开关；下面跟扩展说明
+ * 卡与未就绪横幅。有 `api`() 支持的自定义扩展可在未来按需加独立面板，此处不内置任何
+ * 具体扩展的专属视图。
  */
-import { useEffect, useRef, useState } from 'react'
-import {
-  ROUTER_API_BASE,
-  type RouterExtItem,
-  type RouterWatchProcess,
-  type RouterWatchResponse,
-} from '../shared.ts'
+import type { RouterExtItem } from '../shared.ts'
 
 function Icon({ d, size = 18 }: { d: string; size?: number }): JSX.Element {
   return (
@@ -26,32 +17,7 @@ function Icon({ d, size = 18 }: { d: string; size?: number }): JSX.Element {
 
 const I = {
   back: 'M19 12H5M12 19l-7-7 7-7',
-  refresh: 'M20.5 12a8.5 8.5 0 1 1-2.6-6.1M20.5 4v5h-5',
-  node: 'M8 5.5L12 3l4 2.5v5L12 13l-4-2.5v-5zM4 9v5l4 2.5M12 13v5l4-2.5M20 9v5l-4 2.5',
   bolt: 'M13 2L4 14h6l-1 8 9-12h-6z',
-  copy: 'M8 8h11v11H8zM5 14H4a1 1 0 0 1-1-1V4a1 1 0 0 1 1-1h10a1 1 0 0 1 1 1v1',
-  check: 'M4 12.5l5 5L20 6.5',
-}
-
-/** 刷新按钮（带禁用中旋转）。 */
-function RefreshBtn({ onClick, busy }: { onClick: () => void; busy: boolean }): JSX.Element {
-  return (
-    <button
-      type="button"
-      className="dshr-iconButton"
-      onClick={onClick}
-      disabled={busy}
-      title="刷新进程"
-      aria-label="刷新进程"
-    >
-      <span className={busy ? 'dshr-spin' : undefined}><Icon d={I.refresh} size={16} /></span>
-    </button>
-  )
-}
-
-function fmtPct(v: number | undefined): string {
-  const n = v ?? 0
-  return `${n.toFixed(1)}%`
 }
 
 interface ExtDetailProps {
@@ -72,7 +38,17 @@ export function ExtDetail({ item, onBack, onToggle }: ExtDetailProps): JSX.Eleme
         </button>
         <div className="dshr-providerTitleRow">
           <div className="dshr-providerIcon" style={{ color: 'var(--rs-faint)', background: 'var(--rs-layer-2)' }}>
-            <Icon d={I.bolt} size={22} />
+            {item.icon !== undefined
+              ? (
+                <img
+                  className="dshr-providerImg"
+                  src={item.icon}
+                  alt=""
+                  // 同上：失败就藏，露出备用图标位置（不显示碎图）
+                  onError={(e) => { e.currentTarget.style.display = 'none' }}
+                />
+              )
+              : <Icon d={I.bolt} size={22} />}
           </div>
           <div className="dshr-providerMeta">
             <h1 className="dshr-providerName">{item.name}</h1>
@@ -113,145 +89,6 @@ export function ExtDetail({ item, onBack, onToggle }: ExtDetailProps): JSX.Eleme
           <span>{item.detail !== undefined && item.detail !== '' ? item.detail : '当前不可用'}</span>
         </div>
       )}
-
-      {item.id === 'watch' ? <WatchPanel /> : null}
     </div>
   )
-}
-
-/** watch 的进程监控面板：轮询采样（只读）+ 复制 PID / 复制 kill 命令。 */
-function WatchPanel(): JSX.Element {
-  const [processes, setProcesses] = useState<RouterWatchProcess[]>([])
-  const [error, setError] = useState('')
-  const [loading, setLoading] = useState(true)
-  // 刚复制成的那条（pid + 文本），显示「已复制」提示，1.2s 后清除。
-  const [copied, setCopied] = useState<{ pid: number; text: string } | null>(null)
-  const alive = useRef(true)
-  const now = useRef(Date.now())
-
-  useEffect(() => {
-    alive.current = true
-    return () => { alive.current = false }
-  }, [])
-
-  const load = async (): Promise<void> => {
-    try {
-      const res = await fetch(`${ROUTER_API_BASE}/ext/watch/processes`, { cache: 'no-store' })
-      if (!res.ok) {
-        // 尽量把后端的原因露出来（如「extension not found」/「extension api not found」），
-        // 别只剩 `HTTP 404`——它分不清是扩展没装、还是 api 没命中。
-        let reason = ''
-        try {
-          const err = await res.json() as { error?: string }
-          if (err.error) reason = ` — ${err.error}`
-        } catch { /* 非 JSON 响应体,忽略 */ }
-        if (alive.current) setError(`HTTP ${res.status}${reason}`)
-        return
-      }
-      // 响应体非 JSON(历史上 404 空 body 会在这里抛 Unexpected end of JSON input)。
-      // 分开 try,别把"非 JSON"混进网络错误的文案里。
-      let data: RouterWatchResponse
-      try {
-        data = await res.json() as RouterWatchResponse
-      } catch {
-        if (alive.current) setError('响应不是 JSON')
-        return
-      }
-      if (!alive.current) return
-      setError(data.ok ? '' : (data.error ?? '加载进程失败'))
-      if (data.ok && data.processes !== undefined) setProcesses(data.processes) // ?: 失败保留上一帧
-    } catch (err) {
-      if (alive.current) setError((err as Error).message) // 失败保留上一帧
-    } finally {
-      if (alive.current) setLoading(false)
-    }
-  }
-
-  // 进入面板后轮询采样（3s；离开卸载）。
-  useEffect(() => {
-    void load()
-    const timer = setInterval(() => { void load() }, 3000)
-    return () => clearInterval(timer)
-    // eslint-disable-next-line react-hooks/exhaustive-deps
-  }, [])
-
-  const copy = (pid: number, text: string): void => {
-    const stamp = Date.now()
-    now.current = stamp
-    void navigator.clipboard.writeText(text)
-      .then(() => {
-        if (alive.current && now.current === stamp) {
-          setCopied({ pid, text })
-          setTimeout(() => { if (alive.current) setCopied((c) => c?.pid === pid ? null : c) }, 1200)
-        }
-      })
-      .catch(() => { if (alive.current) setError('复制失败') })
-  }
-
-  return (
-    <section className="dshr-card">
-      <div className="dshr-cardHead">
-        <span className="dshr-cardIcon"><Icon d={I.node} /></span>
-        <div className="dshr-cardTitle">运行进程</div>
-        <span className="dshr-cardMeta">agent 启动 · 只读 · 3s 采样</span>
-        <RefreshBtn onClick={() => void load()} busy={loading} />
-      </div>
-
-      {error !== '' && (
-        <div className="dshr-alert"><strong>采样失败</strong><span>{error}（保留上一帧）</span></div>
-      )}
-
-      {!loading && processes.length === 0 ? (
-        <div className="dshr-empty">
-          暂无会话中 agent 启动的进程。运行诸如 <code>node server.js</code> 的长驻命令后
-          会出现在这里。
-        </div>
-      ) : (
-        <div className="dshr-rankList">
-          <div className="dshr-rankRow dshr-rankHead">
-            <span className="dshr-rankName">PID / 命令</span>
-            <span className="dshr-rankNum">CPU</span>
-            <span className="dshr-rankNum">内存</span>
-            <span className="dshr-rankNum" />
-          </div>
-          {processes.map((p) => {
-            const done = copied?.pid === p.pid
-            return (
-              <div key={p.pid} className="dshr-rankRow">
-                <span className="dshr-rankName dshr-mono" title={p.command}>
-                  <span className="dshr-muted">{p.pid}</span>&ensp;{p.command}
-                </span>
-                <span className="dshr-rankNum">{fmtPct(p.cpu)}</span>
-                <span className="dshr-rankNum">{fmtPct(p.mem)}</span>
-                <span className="dshr-rankNum dshr-procOps">
-                  {done
-                    ? <span className="dshr-muted"><Icon d={I.check} size={13} /> 已复制</span>
-                    : (
-                      <>
-                        <button
-                          type="button"
-                          className="dshr-miniButton"
-                          onClick={() => copy(p.pid, String(p.pid))}
-                          title={`复制 PID ${p.pid}`}
-                        >
-                          <Icon d={I.copy} size={13} /> PID
-                        </button>
-                        <button
-                          type="button"
-                          className="dshr-miniButton"
-                          onClick={() => copy(p.pid, `kill -TERM ${p.pid}`)}
-                          title={`复制 kill -TERM ${p.pid}`}
-                        >
-                          <Icon d={I.copy} size={13} /> kill
-                        </button>
-                      </>
-                    )}
-                </span>
-              </div>
-            )
-          })}
-        </div>
-      )}
-    </section>
-  )
 }

package/src/client/LastHitDock.tsx

@@ -0,0 +1,141 @@
+/**
+ * 输入框上方的「最近命中」徽章 —— 走 DSH 官方 `conversation.input.dock` 座位
+ * （scope: session，见 dsh-client-ui-conversation 的 slots 契约）。
+ *
+ * 为什么用 slot 而不是认领 DOM：
+ *   - slot 的 session scope 会**注入 `sessionId`**（SessionStandardProps），
+ *     于是能按当前会话取「最近命中」—— team 多会话下不会显示别的成员；
+ *   - slot 是稳定契约，宿主 hash 类名（如之前的 `.JObwrW_root`）随版本会变。
+ * 参照实现：@deepseek-ai/dsh-client-ui-goal 的 GoalDock 同挂这个座位，
+ * 组件 props 由宿主注入，`inject(sessionId)` 拿会话身份。
+ *
+ * 数据源：核心 `/router/api/last-hit?session=`（按会话取一条轻记录）。
+ */
+import { useEffect, useRef, useState } from 'react'
+import { ROUTER_API_BASE } from '../shared.ts'
+import { getLastHit, subscribeLastHit, type LastHit } from './last-hit-store.ts'
+
+/** 路由字形（纯 currentColor 描边，14px 与相邻控件对齐）。 */
+const ICON = (
+  <svg viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round" aria-hidden="true">
+    <circle cx="5" cy="5" r="2.4" />
+    <circle cx="19" cy="5" r="2.4" />
+    <circle cx="12" cy="19" r="2.4" />
+    <path d="M7.4 5h9.2" />
+    <path d="M5 7.4v6.2c0 2.6 3 3.4 4.6 3.8" />
+    <path d="M19 7.4v6.2c0 2.6-3 3.4-4.6 3.8" />
+  </svg>
+)
+
+/** 账号名：别名 → uid → 「无连接」。 */
+function connectionName(hit: LastHit): string {
+  const name = hit.account !== undefined && hit.account !== '' ? hit.account : hit.uid
+  return name === '' ? '无连接' : name
+}
+
+/**
+ * 积分展示。**未知就是未知**：`-1` / 缺省一律显示「未知」，
+ * 绝不编一个 0 —— 沿用 store 那条「不用 0 冒充未知」的纪律。
+ */
+function creditsText(hit: LastHit): string {
+  return hit.credits === undefined || hit.credits < 0 ? '未知' : `${Math.round(hit.credits)}`
+}
+
+/** 模型短名（去掉 `prefix/`；前缀在「服务商」行已单独列出）。 */
+function modelShort(hit: LastHit): string {
+  const full = hit.model === '' ? hit.supplier : hit.model
+  const slash = full.lastIndexOf('/')
+  return slash > 0 ? full.slice(slash + 1) : full
+}
+
+/** 宿主注入的 props（只声明用到的）。 */
+interface LastHitDockProps {
+  /** 宿主注入的会话身份；宿主未注入时为 undefined。 */
+  sessionId?: string
+}
+
+/**
+ * 输入框上方的「最近命中」徽章：图标 + 模型短名；点击展开连接/积分卡片。
+ *
+ * @param props 宿主注入的会话身份
+ */
+export function LastHitDock({ sessionId }: LastHitDockProps): JSX.Element {
+  const [hit, setHit] = useState<LastHit | null>(() => getLastHit(sessionId))
+  const [open, setOpen] = useState(false)
+  const rootRef = useRef<HTMLDivElement>(null)
+
+  useEffect(() => {
+    // 诊断：确认 slot 真挂上了、以及宿主是否注入了 sessionId
+    console.info('[dsh-router] last-hit dock mounted, sessionId =', sessionId)
+    return subscribeLastHit(sessionId, setHit)
+  }, [sessionId])
+
+  // 点外部收起：对齐宿主原生 popover 的关闭语义（primitives.Menu /
+  // useDismissOnOutsidePointer）——document 级 `pointerdown` 冒泡相位（早于
+  // click，避免"先选中后关闭"）、根节点含自身则忽略；另补 Escape 关闭。
+  useEffect(() => {
+    if (!open) return
+    const onPointerDown = (e: PointerEvent): void => {
+      if (e.target instanceof Node && rootRef.current?.contains(e.target) === true) return
+      setOpen(false)
+    }
+    const onKeyDown = (e: KeyboardEvent): void => {
+      if (e.key === 'Escape') setOpen(false)
+    }
+    document.addEventListener('pointerdown', onPointerDown)
+    document.addEventListener('keydown', onKeyDown)
+    return () => {
+      document.removeEventListener('pointerdown', onPointerDown)
+      document.removeEventListener('keydown', onKeyDown)
+    }
+  }, [open])
+
+  // 无数据时**仍渲染占位**（不返回 null）：否则「挂载成功但暂无记录」看起来
+  // 就像"整个控件不见了"，无法与"根本没挂上"区分。
+  const rows: Array<[string, string]> = hit === null
+    ? []
+    : [
+        ['服务商', hit.supplier],
+        ['模型', modelShort(hit)],
+        ['连接', connectionName(hit)],
+        ['积分', creditsText(hit)],
+      ]
+
+  return (
+    <div className="dshr-lastHit" ref={rootRef}>
+      <button
+        type="button"
+        className={`dshr-lastHit-btn${hit !== null && !hit.ok ? ' dshr-lastHit-fail' : ''}`}
+        aria-label="最近一次命中"
+        aria-expanded={open}
+        title={hit === null ? '暂无命中记录' : `${hit.model === '' ? hit.supplier : hit.model} · ${connectionName(hit)}`}
+        onClick={() => setOpen((v) => !v)}
+      >
+        {ICON}
+        <span className="dshr-lastHit-label">{hit === null ? '暂无' : modelShort(hit)}</span>
+      </button>
+      {open && (
+        <div className="dshr-lastHit-card">
+          <div className="dshr-lastHit-title">
+            <span className="dshr-lastHit-titleLabel">
+              {ICON}
+              <span>路由</span>
+            </span>
+            <span className="dshr-lastHit-titleValue" title={hit?.requested}>
+              {hit === null || hit.requested === '' ? '—' : hit.requested}
+            </span>
+          </div>
+          <div className="dshr-lastHit-titleRule" />
+          {rows.length === 0
+            ? <div className="dshr-lastHit-row"><span className="dshr-lastHit-key">暂无命中记录</span></div>
+            : rows.map(([k, v]) => (
+                <div key={k} className="dshr-lastHit-row">
+                  <span className="dshr-lastHit-key">{k}</span>
+                  <span className="dshr-lastHit-val">{v}</span>
+                </div>
+              ))}
+        </div>
+      )}
+    </div>
+  )
+}

package/src/client/StatsTab.tsx

@@ -333,9 +333,9 @@ function RecentTable({ rows }: { rows: RouterUsageRecord[] }): JSX.Element {
             <div className="dshr-recentRow dshr-rankHead">
               <span className="dshr-recentTime">时间</span>
               <span className="dshr-recentModel">模型</span>
-              <span className="dshr-recentSupplier">供应商</span>
-              <span className="dshr-rankNum">In / Out</span>
-              <span className="dshr-rankNum">耗时</span>
+              <span className="dshr-recentSupplier">连接</span>
+              <span className="dshr-recentTokens">In / Out</span>
+              <span className="dshr-recentDuration">耗时</span>
             </div>
             {rows.map((r, i) => (
               // 明细没有 id；同毫秒两条请求是可能的，索引用 ts+模型+序号兜底
@@ -347,13 +347,15 @@ function RecentTable({ rows }: { rows: RouterUsageRecord[] }): JSX.Element {
                 <span className="dshr-recentModel dshr-mono" title={`请求 ${r.requested}${r.error === undefined ? '' : ` · ${r.error}`}`}>
                   {r.model === '' ? r.requested : r.model}
                 </span>
-                <span className="dshr-recentSupplier">{r.supplier === '' ? '—' : r.supplier}</span>
-                <span className="dshr-rankNum">
+                <span className="dshr-recentSupplier" title={r.uid ?? ''}>
+                  {r.connection === undefined || r.connection === '' ? '—' : r.connection}
+                </span>
+                <span className="dshr-recentTokens">
                   <span className="dshr-tokenIn">{fmtShort(r.promptTokens)}{r.inputEstimated ? '~' : ''}</span>
                   {' / '}
                   <span className="dshr-tokenOut">{fmtShort(r.completionTokens)}{r.outputEstimated ? '~' : ''}</span>
                 </span>
-                <span className="dshr-rankNum dshr-muted">{fmtDuration(r.durationMs)}</span>
+                <span className="dshr-recentDuration dshr-muted">{fmtDuration(r.durationMs)}</span>
               </div>
             ))}
           </div>

package/src/client/SupplierDetail.tsx

@@ -106,7 +106,6 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
   const [modelQuery, setModelQuery] = useState('')
   const [fetchingModels, setFetchingModels] = useState(false)
   const [removeModelTarget, setRemoveModelTarget] = useState<string | null>(null)
-  const [poolStrategy, setPoolStrategy] = useState<'fallback' | 'round-robin'>('fallback')
   const [poolOrder, setPoolOrder] = useState<string[]>([])
   const [checkingIn, setCheckingIn] = useState(false)
   const [refreshing, setRefreshing] = useState(false)
@@ -146,16 +145,9 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
 
   const loadPoolConfig = useCallback(async (): Promise<void> => {
     try {
-      const [strategyRes, orderRes] = await Promise.all([
-        fetch(`${ROUTER_API_BASE}/suppliers/${supplier.id}/pool/strategy`, { cache: 'no-store' }),
-        fetch(`${ROUTER_API_BASE}/suppliers/${supplier.id}/pool/order`, { cache: 'no-store' }),
-      ])
-      const [strategyData, orderData] = await Promise.all([strategyRes.json(), orderRes.json()]) as [
-        { ok: boolean; strategy?: 'fallback' | 'round-robin' },
-        { ok: boolean; order?: string[] },
-      ]
+      const orderRes = await fetch(`${ROUTER_API_BASE}/suppliers/${supplier.id}/pool/order`, { cache: 'no-store' })
+      const orderData = await orderRes.json() as { ok: boolean; order?: string[] }
       if (mounted.current) {
-        if (strategyData.ok && strategyData.strategy) setPoolStrategy(strategyData.strategy)
         if (orderData.ok && Array.isArray(orderData.order)) setPoolOrder(orderData.order)
       }
     } catch {
@@ -535,17 +527,6 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
       const data = await response.json() as { ok: boolean; error?: string }
       if (data.ok) {
         setAlias(aliasDraft.trim())
-        // 同时保存连接池策略
-        try {
-          await fetch(`${ROUTER_API_BASE}/suppliers/${supplier.id}/pool/strategy`, {
-            method: 'POST',
-            headers: { 'Content-Type': 'application/json' },
-            body: JSON.stringify({ strategy: poolStrategy }),
-            cache: 'no-store',
-          })
-        } catch {
-          // 策略保存失败不阻断前缀保存
-        }
         setShowAlias(false)
       } else {
         setAliasError(data.error ?? '保存失败')
@@ -603,7 +584,6 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
             <h1 className="dshr-providerName">{supplier.name}</h1>
             <p className="dshr-providerCount">
               {supplierAccounts.length} 链接
-              {canPool && ` · ${poolStrategy === 'round-robin' ? '轮询' : '回退'}`}
               {canEdit && ` · 前缀 ${alias}`}
             </p>
           </div>
@@ -905,18 +885,6 @@ export function SupplierDetail({ supplier, accounts, statusLoading, onBack, onRe
                 onChange={(e) => setAliasDraft(e.target.value)}
               />
             </>
-            <>
-              <label className="dshr-fieldLabel">连接池策略</label>
-              <p className="dshr-muted">回退 = 按连接池顺序取第一个健康链接；轮询 = 按会话前缀粘住同一链接（前缀亲和，多会话不打架），拿不到会话信息时退回块轮转。</p>
-              <select
-                className="dshr-select dshr-input"
-                value={poolStrategy}
-                onChange={(e) => setPoolStrategy(e.target.value as 'fallback' | 'round-robin')}
-              >
-                <option value="fallback">回退</option>
-                <option value="round-robin">轮询</option>
-              </select>
-            </>
             {aliasError !== '' && <div className="dshr-alert"><strong>出错了</strong><span>{aliasError}</span></div>}
             <div className="dshr-modalActions">
               <button type="button" className="dshr-miniButton" onClick={() => setShowAlias(false)}>取消</button>

package/src/client/index.tsx

@@ -12,6 +12,8 @@ import { mountRouterWorkspace } from './workspace-mount.tsx'
 import { RouterSettingsSection } from './settings-section.tsx'
 import { registerSettingsNavIcon } from './settings-nav-icon.ts'
 import { rewriteRouterModelHint } from './model-hint-copy.ts'
+import { LastHitDock } from './LastHitDock.tsx'
+import { ROUTER_API_BASE } from '../shared.ts'
 import './router.css'
 
 /**
@@ -37,6 +39,42 @@ interface Ctx {
   effect: (fn: () => (() => void) | void, label?: string) => void
 }
 
+/**
+ * 挂载输入框底部的「最近命中」徽章：注册到官方 `conversation.composer.dock`
+ * （kind: list, scope: session —— 即宿主 composer 卡片底部操作行
+ * `.uV2eYG_dock` 里、原生上下文环旁边的位置）。
+ * scope 为 session 时宿主给组件注入 `sessionId`，据此按**当前会话**取命中。
+ *
+ * **仅宿主 >= 0.1.7 才挂**：composer.dock 这个座位在 0.1.5 也在，但渲染在
+ * InputBar 之后的独立块（位置不对），只有 0.1.7 才放进底部操作行。座位名相同
+ * 没法靠契约区分，故先问核心 `/router/api/health` 的 `lastHitDock` 支持位。
+ * @returns 清理函数；不支持或宿主无 slots 时为空操作
+ */
+function mountLastHitDock(ctx: Ctx, supported: boolean): () => void {
+  const slots = ctx.slots
+  if (slots === undefined || !supported) return () => {}
+  return slots.inject('conversation.composer.dock', () => slots.register({
+    name: 'conversation.composer.dock',
+    id: 'dsh-router-last-hit',
+    order: 10,
+  }, LastHitDock))
+}
+
+/**
+ * 问核心是否支持「最近命中」徽章（宿主 >= 0.1.7）。
+ * 网络/解析失败一律当**不支持**——宁可不显示，也不在 0.1.5 上摆错位置。
+ */
+async function fetchLastHitDockSupport(): Promise<boolean> {
+  try {
+    const res = await fetch(`${ROUTER_API_BASE}/health`)
+    if (!res.ok) return false
+    const body = (await res.json()) as { lastHitDock?: unknown }
+    return body.lastHitDock === true
+  } catch {
+    return false
+  }
+}
+
 /** 挂载「设置 → 路由」页；拿不到 slots 时返回 undefined 表示跳过。 */
 function mountSettingsSection(ctx: Ctx): (() => void) | undefined {
   const slots = ctx.slots
@@ -56,6 +94,13 @@ function mountSettingsSection(ctx: Ctx): (() => void) | undefined {
 }
 
 export function apply(ctx: Ctx): void {
+  // 「最近命中」徽章：走官方 conversation.composer.dock（scope: session → 组件
+  // props 注入 sessionId，按当前会话取命中）。**仅宿主 >= 0.1.7 才挂**——
+  // composer.dock 在 0.1.5 渲染位置不对，先问核心拿支持位，避免摆错位置。
+  // 查询是异步的，拿到结果（无论成败）再决定注册与否。
+  void fetchLastHitDockSupport().then((supported) => {
+    ctx.effect(() => mountLastHitDock(ctx, supported), 'dsh-router: last-hit dock')
+  })
   const disposeSettings = mountSettingsSection(ctx)
   if (disposeSettings === undefined) {
     // 老宿主（无 slots）：回退到侧边栏入口 + 中心栏面板

package/src/client/last-hit-store.ts

@@ -0,0 +1,89 @@
+/**
+ * 「最近命中」的会话级数据源。
+ *
+ * 为什么要有这层：徽章组件可能因宿主重渲染而卸载/重建，但**轮询不该跟着重建**
+ * （每个会话一个轮询器，多会话各自独立；组件只订阅结果）。这里做两件事：
+ *   - 按 sessionId 维护「最近一次命中」的最新值 + 订阅者集合；
+ *   - 每个会话一个定时器，只在有订阅者时开、无订阅者时停。
+ *
+ * 数据源：核心 `/router/api/last-hit?session=`（轻端点，不打 status）。
+ */
+
+const DIGEST_API = '/router/api/last-hit'
+/** 刷新间隔：命中信息跟着请求走，轮询取一个不打扰的频率。 */
+const POLL_MS = 3000
+
+/** 一次命中的快照（后端 `/last-hit` 的 `hit` 字段，只声明用到的）。 */
+export interface LastHit {
+  supplier: string
+  model: string
+  requested: string
+  uid: string
+  account?: string
+  credits?: number
+  ok: boolean
+}
+
+interface Entry {
+  value: LastHit | null
+  listeners: Set<(v: LastHit | null) => void>
+  timer: number | null
+}
+
+const entries = new Map<string, Entry>()
+
+function entryOf(key: string): Entry {
+  let e = entries.get(key)
+  if (e === undefined) {
+    e = { value: null, listeners: new Set(), timer: null }
+    entries.set(key, e)
+  }
+  return e
+}
+
+function emit(e: Entry): void {
+  for (const fn of e.listeners) fn(e.value)
+}
+
+async function refresh(key: string): Promise<void> {
+  const e = entryOf(key)
+  try {
+    // key 为空（宿主未注入 sessionId）时不带 session 参数 → 后端回退全局最近。
+    const qs = key === '' ? '' : `?session=${encodeURIComponent(key)}`
+    const res = await fetch(`${DIGEST_API}${qs}`, { cache: 'no-store' })
+    const data = await res.json() as { ok: boolean; hit?: LastHit | null }
+    const next = data.ok && data.hit ? data.hit : null
+    e.value = next
+  } catch {
+    // 网络抖动不该清空徽章（保留上次值）
+  }
+  emit(e)
+}
+
+/** 读该会话当前的最近命中（同步快照）。 */
+export function getLastHit(sessionId?: string): LastHit | null {
+  return entryOf(sessionId ?? '').value
+}
+
+/**
+ * 订阅该会话的最近命中。首次订阅即启动轮询，最后一个退订时停。
+ * @param sessionId 宿主会话身份（可能为 undefined，此时键为空串 = 全局）
+ * @param listener 值变化回调
+ * @returns 退订函数
+ */
+export function subscribeLastHit(sessionId: string | undefined, listener: (v: LastHit | null) => void): () => void {
+  const key = sessionId ?? ''
+  const e = entryOf(key)
+  e.listeners.add(listener)
+  if (e.timer === null) {
+    void refresh(key)
+    e.timer = window.setInterval(() => void refresh(key), POLL_MS)
+  }
+  return () => {
+    e.listeners.delete(listener)
+    if (e.listeners.size === 0 && e.timer !== null) {
+      window.clearInterval(e.timer)
+      e.timer = null
+    }
+  }
+}

package/src/client/model-hint-copy.test.ts

@@ -10,8 +10,8 @@ import assert from 'node:assert/strict'
 import { routerHintRewrite, ROUTER_MODEL_HINT_COPY } from './model-hint-copy.ts'
 
 test('认出宿主提示（中/英两种文案 + 命名空间指纹）', () => {
-  const zh = '其余字段在 settings.yaml 中，请直接编辑对应段。 (llm-dsh-router)'
-  const en = 'Other fields live in settings.yaml; edit that section directly. (llm-dsh-router)'
+  const zh = '其余字段在 settings.yaml 中，请直接编辑对应段。 (dsh-router)'
+  const en = 'Other fields live in settings.yaml; edit that section directly. (dsh-router)'
   assert.equal(routerHintRewrite(zh), ROUTER_MODEL_HINT_COPY)
   assert.equal(routerHintRewrite(en), ROUTER_MODEL_HINT_COPY)
 })
@@ -21,6 +21,11 @@ test('别的 provider 的同类提示不动（指纹只属于 Router）', () =>
   assert.equal(routerHintRewrite(deepseek), undefined)
 })
 
+test('旧命名空间指纹不再认领 —— 0.1.7 起宿主渲染的是行 id', () => {
+  const legacy = '其余字段在 settings.yaml 中，请直接编辑对应段。 (llm-dsh-router)'
+  assert.equal(routerHintRewrite(legacy), undefined)
+})
+
 test('已是目标文案时早退 —— 观察器不自激', () => {
   assert.equal(routerHintRewrite(ROUTER_MODEL_HINT_COPY), undefined)
 })

package/src/client/model-hint-copy.ts

@@ -3,7 +3,7 @@
  *
  * 为什么不能直接改源头：Router 的卡片走宿主的 "unknown" 布局（宿主只认得
  * llm-deepseek / llm-pi-ai 两套表单），那句
- *   「其余字段在 settings.yaml 中，请直接编辑对应段。 (llm-dsh-router)」
+ *   「其余字段在 settings.yaml 中，请直接编辑对应段。 (dsh-router)」
  * 属于宿主 `settings.models` 的 locale 字典，而字典注册对同一个 (ns, locale)
  * 只允许一个占位者（重复注册直接抛），插件覆写不了，契约也没给可覆写字段。
  * 所以沿用本插件既有的认领手法（同 settings-nav-icon.ts）：按文案指纹认出宿主
@@ -16,7 +16,7 @@
  */
 
 /** 指纹：语言无关（不受中英文切换影响），且只出现在 Router 卡片上。 */
-const FINGERPRINT = '(llm-dsh-router)'
+const FINGERPRINT = '(dsh-router)'
 
 /** 正确说法：对齐 README「组合即模型」。 */
 export const ROUTER_MODEL_HINT_COPY = '组合即模型 · 建好的组合会自动出现在 DSH 模型目录中，选中组合名即可直接使用。'