dsh-router-core 0.3.19 → 0.3.20

package/src/client/ExtTab.tsx

@@ -10,6 +10,7 @@
  */
 import { useEffect, useRef, useState } from 'react'
 import { ROUTER_API_BASE, type RouterExtItem, type RouterExtResponse } from '../shared.ts'
+import { ExtDetail } from './ExtDetail.tsx'
 
 function Icon({ d, size = 18 }: { d: string; size?: number }): JSX.Element {
   return (
@@ -28,6 +29,7 @@ export function ExtTab(): JSX.Element {
   const [items, setItems] = useState<RouterExtItem[]>([])
   const [loaded, setLoaded] = useState(false)
   const [error, setError] = useState('')
+  const [selectedId, setSelectedId] = useState<string | null>(null)
   const mounted = useRef(true)
 
   useEffect(() => {
@@ -79,6 +81,12 @@ export function ExtTab(): JSX.Element {
     }
   }
 
+  // 打开详情视图：用 live item（否则详情里的开关状态不会随列表更新）。
+  const selected = selectedId !== null ? items.find((i) => i.id === selectedId) ?? null : null
+  if (selected !== null) {
+    return <ExtDetail item={selected} onBack={() => setSelectedId(null)} onToggle={toggle} />
+  }
+
   return (
     <div className="dshr-tabBody">
       {error !== '' && (
@@ -92,51 +100,43 @@ export function ExtTab(): JSX.Element {
           <span className="dshr-keyEmptyIcon"><Icon d={I.puzzle} size={30} /></span>
           <p className="dshr-keyEmptyTitle">暂无扩展</p>
           <p className="dshr-keyEmptyDesc">
-            安装扩展插件(如 <code>dsh-router-ext-rtk</code>)后,这里会出现开关
+            安装扩展插件(如 <code>dsh-router-ext-watch</code>)后,这里会出现开关
           </p>
         </div>
       ) : (
-        items.map(item => {
-          const notReady = item.ready === false
-          return (
-            <section key={item.id} className="dshr-card">
-              <div className="dshr-cardHead">
-                <span className="dshr-cardIcon"><Icon d={I.bolt} /></span>
-                <div className="dshr-cardTitle">{item.name}</div>
-                {/* 开关放标题行最右端:.dshr-cardAction 是现成的
-                    margin-left:auto(EndpointTab 的「创建 Key」就靠它),复用不新增。
-                    不可用时禁开——禁了就无从开启成功。 */}
-                <button
-                  type="button"
-                  className={`dshr-toggle dshr-cardAction ${item.enabled ? 'dshr-toggle-on' : ''}`}
-                  role="switch"
-                  aria-checked={!!item.enabled}
-                  disabled={notReady && !item.enabled}
-                  onClick={() => void toggle(item, !item.enabled)}
-                  title={notReady && !item.enabled
-                    ? '当前不可用,无法开启'
-                    : item.enabled ? `关闭 ${item.name}` : `开启 ${item.name}`}
-                >
-                  <span className="dshr-toggleKnob" />
-                </button>
-              </div>
+        <div className="dshr-supplierGrid">
+          {items.map(item => {
+            const notReady = item.ready === false
+            return (
+              <section key={item.id} className="dshr-supplierCard" onClick={() => setSelectedId(item.id)}>
+                <div className="dshr-supplierRow">
+                  {item.icon !== undefined ? (
+                    <img
+                      className="dshr-supplierIcon dshr-extLogo"
+                      src={item.icon}
+                      alt=""
+                      onError={(e) => { e.currentTarget.style.display = 'none' }}
+                    />
+                  ) : (
+                    <span className="dshr-supplierIcon"><Icon d={I.bolt} size={24} /></span>
+                  )}
+                  <div className="dshr-supplierName">{item.name}</div>
+                </div>
 
-              {/* 内容区：说明 + 未就绪红字（左对齐、与卡片图标对齐） */}
-              <div className="dshr-extBody">
-                {item.description !== undefined && item.description !== '' && (
-                  <div className="dshr-muted">{item.description}</div>
-                )}
                 {notReady && (
-                  <div className="dshr-ext-error">
-                    {item.detail !== undefined && item.detail !== ''
-                      ? item.detail
-                      : '未就绪,无法开启'}
+                  <div className="dshr-extCardError">
+                    {item.detail !== undefined && item.detail !== '' ? item.detail : '未就绪'}
                   </div>
                 )}
-              </div>
-            </section>
-          )
-        })
+
+                <div className="dshr-supplierMeta">
+                  <span className="dshr-muted">{item.enabled ? '已启用' : '未启用'}</span>
+                  <span className="dshr-chevron">›</span>
+                </div>
+              </section>
+            )
+          })}
+        </div>
       )}
     </div>
   )

package/src/client/router.css

@@ -923,6 +923,34 @@ html[data-dsh-router-active]:not([data-dsh-taskboard-active]):not([data-dsh-ssh-
   margin-top: 4px;
 }
 
+/* watch 进程行动作区（复制 PID / kill 命令，只读） */
+.dshr-procOps {
+  display: inline-flex;
+  align-items: center;
+  justify-content: flex-end;
+  gap: 4px;
+  white-space: nowrap;
+}
+
+/* 扩展供应商式小卡片：未就绪红字（描述只在详情页，卡片不放） */
+.dshr-extCardError {
+  color: var(--rs-danger);
+  font-size: 11px;
+}
+
+/* 扩展卡 logo（如 rtk 白底 logo）：黑底 + 内边距,白色 logo 在黑底上显形 */
+.dshr-extLogo {
+  background: #000;
+  padding: 3px;
+  box-sizing: border-box;
+  object-fit: contain;
+}
+
+/* 扩展详情头部右侧的开关（顶到标题行右边，同供应商详情的编辑按钮位） */
+.dshr-extDetailToggle {
+  margin-left: auto;
+}
+
 /* 扩展卡片内容区：文字左对齐，左侧留白与标题行的图标位对齐 */
 .dshr-extBody {
   padding: 10px 14px 12px 48px;

package/src/ext/contract.ts

@@ -25,6 +25,7 @@
  *     file IO —— 落盘位置由核心锚定（不跟 cwd 跑），读写经核心，插件无状态。
  */
 import type { Context } from '@deepseek-ai/cordis'
+import type { IncomingMessage, ServerResponse } from 'node:http'
 
 /** 扩展器唯一 id（注册键）。 */
 export type ExtId = string
@@ -53,8 +54,16 @@ export interface RouterExt {
   readonly name: string
   /** 面板副标题说明。 */
   readonly description?: string
+  /** 卡片/详情图标的 logo URL（可选；缺省用默认图标）。 */
+  readonly icon?: string
   /** 当前运行时状态（ready + 不就绪时的说明）。 */
   getState(): ExtState
+  /**
+   * 通用扩展 API 点（可选）：核心把 `/router/api/ext/{id}/{subpath}` 兜底路由派发进来，
+   * 由扩展器自己裁决/处理（如 watch 的 `processes`/`kill`）。返回 true 表示已处理；
+   * false / 未实现 → 核心回 404。这样扩展的执行面逻辑进插件，核心只加一条通用转发。
+   */
+  api?(subpath: string, req: IncomingMessage, res: ServerResponse): boolean | Promise<boolean>
   /** 卸载清理（表删除时由 dsh-router 调用，可选）。 */
   dispose?(): void
 }
@@ -64,6 +73,8 @@ export interface ExtInfo {
   id: string
   name: string
   description?: string
+  /** 卡片/详情图标 logo URL（可选）。 */
+  icon?: string
   /** 核心持久化的开关（默认关）。 */
   enabled: boolean
   /** 插件报的运行时就绪状态。 */

package/src/index.ts

@@ -525,6 +525,7 @@ export function apply(rawContext: unknown): void {
           id: e.id,
           name: e.name ?? e.id,
           ...(e.description !== undefined ? { description: e.description } : {}),
+          ...(e.icon !== undefined ? { icon: e.icon } : {}),
           enabled: extStore.isEnabled(e.id),
           ready: st?.ready === true,
           ...(st?.detail !== undefined ? { detail: st.detail } : {}),
@@ -534,6 +535,34 @@ export function apply(rawContext: unknown): void {
     writeJson(res, 200, { ok: true, enhancers: list })
   })
 
+  // ---- 扩展通用 API 转发：/router/api/ext/{id}/{subpath} → 该扩展器的 api() ----
+  // watch 这类自定义扩展用它暴露自己的面板接口（如 processes）。分开的 exact 路由
+  // `/ext`（上方）管开关列表；这里必须是 **prefix** 路由兜子路径（`route()` 是 exact,
+  // 匹配不了 `/ext/watch/processes`——用 exact 会造成 404 空 body → 前端 res.json() 崩）。
+  // 核心不知道子路径长什么样——是否处理、怎么处理全由扩展器自己裁决（执行面），核心只转发。
+  const extDispatch = ctx.webServer.register({
+    kind: 'prefix',
+    path: `${ROUTER_API_BASE}/ext/`,
+    handler: async (req, res) => {
+      const pathname = new URL(req.url ?? '/', 'http://localhost').pathname
+      const mount = `${ROUTER_API_BASE}/ext/`
+      const rest = pathname.startsWith(mount) ? pathname.slice(mount.length) : ''
+      const slash = rest.indexOf('/')
+      const extId = slash < 0 ? rest : rest.slice(0, slash)
+      const subpath = slash < 0 ? '' : rest.slice(slash + 1)
+      if (extId === '') {
+        writeJson(res, 404, { ok: false, error: 'extension not found' })
+        return
+      }
+      const ext = (exts[extId] as RouterExt | undefined)
+      if (ext !== undefined && typeof ext.api === 'function' && (await ext.api(subpath, req, res))) {
+        return // 扩展器已处理并写出响应
+      }
+      writeJson(res, 404, { ok: false, error: 'extension api not found' })
+    },
+  })
+  disposers.push(extDispatch)
+
   // ---- 概览看板：用量统计 ----
 
   /** 解析并校验周期参数（不接受任意字符串）。 */

package/src/shared.ts

@@ -143,6 +143,8 @@ export interface RouterExtItem {
   id: string
   name: string
   description?: string
+  /** 卡片/详情图标 logo URL（可选）。 */
+  icon?: string
   /** 是否启用改写（面板开关）。 */
   enabled?: boolean
   /** 运行时是否就绪（如 RTK 二进制是否可用）。 */
@@ -158,6 +160,25 @@ export interface RouterExtResponse {
   enhancers?: RouterExtItem[]
 }
 
+/** 一行 watch 进程（`/router/api/ext/watch/processes`）。 */
+export interface RouterWatchProcess {
+  pid: number
+  ppid: number
+  /** %cpu 快照 */ cpu: number
+  /** %mem 快照 */ mem: number
+  command: string
+  /** 命中的已记录 agent 命令。 */
+  match: string
+  recordedAt: number
+}
+
+/** `/router/api/ext/{id}/processes` response。 */
+export interface RouterWatchResponse {
+  ok: boolean
+  error?: string
+  processes?: RouterWatchProcess[]
+}
+
 /** 供应商模型（含启用状态）。 */
 export interface RouterSupplierModel {
   id: string

package/src/suppliers/opencode/plugin.test.ts

@@ -0,0 +1,176 @@
+/**
+ * opencode(Zen 免费档)握手契约测试 —— 锁住 2026-09-22 实测的那组硬门。
+ *
+ * 为什么值得固化：这四条**都不是可选优化，缺一即 403**
+ * `FreeTierError: OpenCode's free tier can only be used from within OpenCode`。
+ * 它们全是「看不出来」的那种约定——代码删掉一行 headers、或把 UA 改回
+ * `opencode`，单测本该立刻变红，否则下次只能在真机对话里发现整个供应商死了。
+ *
+ * 实测依据（2026-09-22，逐项消融验证）：
+ *   - UA 必须带版本且 ≥1.18：裸 `opencode`→403；`opencode/1.17.x`→426；1.18.0 起 200
+ *   - 必须同时有 `x-opencode-session`/`x-opencode-request`，且形状是
+ *     `ses_<12hex><14base62>` / `msg_<同形状>`——格式错也 403
+ *   - tools 里必须**同时**有 bash 和 read，只给一个也 403
+ *   - 非流式（`stream:false`）即使三样齐全也 403 → 必须恒发 stream:true
+ *
+ * 用 node --test 跑（Node 原生剥 TS 类型）：
+ *   node --test src/suppliers/opencode/plugin.test.ts
+ */
+import test from 'node:test'
+import assert from 'node:assert/strict'
+import factory from './plugin.ts'
+import { SupplierConfigStore } from '../../supplier-config.ts'
+import type { CredentialStore } from '../../credential-store.ts'
+import type { SupplierEnv, SupplierModule } from '../contract.ts'
+import type { ChatRequest } from '../../router/types.ts'
+
+/** 上游认的 session/request id 形状：前缀 + 12 位小写 hex + 14 位 base62。 */
+const SES_RE = /^ses_[0-9a-f]{12}[0-9A-Za-z]{14}$/
+const MSG_RE = /^msg_[0-9a-f]{12}[0-9A-Za-z]{14}$/
+
+interface Captured {
+  url: string
+  headers: Record<string, string>
+  body: Record<string, unknown>
+}
+
+/** 打桩 globalThis.fetch，接住一次请求（上游返回空 SSE 流即可）。 */
+function stubFetch(): { captured: Captured[]; restore: () => void } {
+  const captured: Captured[] = []
+  const real = globalThis.fetch
+  globalThis.fetch = (async (url: string, init?: { headers?: Record<string, string>; body?: string }) => {
+    captured.push({
+      url: String(url),
+      headers: init?.headers ?? {},
+      body: init?.body !== undefined ? (JSON.parse(init.body) as Record<string, unknown>) : {},
+    })
+    return new Response(new ReadableStream<Uint8Array>({ start: (c) => c.close() }), { status: 200 })
+  }) as unknown as typeof fetch
+  return { captured, restore: () => { globalThis.fetch = real } }
+}
+
+/** 造一个最小 env（store 空文件路径 = 纯内存，credentials 用不着的空壳）。 */
+function makePlugin(): SupplierModule {
+  const store = new SupplierConfigStore('')
+  const env: SupplierEnv = {
+    dataDir: '/tmp',
+    log: () => {},
+    store,
+    credentials: {} as CredentialStore,
+  }
+  return factory(env)
+}
+
+function request(over: Partial<ChatRequest> = {}): ChatRequest {
+  return {
+    model: 'big-pickle',
+    stream: true,
+    rawBody: JSON.stringify({ model: 'big-pickle', messages: [{ role: 'user', content: 'hi' }] }),
+    ...over,
+  }
+}
+
+test('chatOnce 必须带版本化 UA + 合法形状的 session/request 头', async () => {
+  const stub = stubFetch()
+  try {
+    const r = await makePlugin().chatOnce('', 'auto', request())
+    assert.equal(r.ok, true, '握手齐全时应当成功')
+    const h = stub.captured[0]!.headers
+
+    // UA 必须带版本号（裸 'opencode' 会被上游按非 CLI 拒掉）
+    assert.match(h['User-Agent'] ?? '', /^opencode\/\d+\.\d+/, 'UA 必须带 opencode/ 版本号')
+
+    // session/request 形状不对上游是**拒绝**而不是忽略 —— 形状必须严格
+    assert.match(h['x-opencode-session'] ?? '', SES_RE, 'x-opencode-session 形状不对会被 403')
+    assert.match(h['x-opencode-request'] ?? '', MSG_RE, 'x-opencode-request 形状不对会被 403')
+  } finally {
+    stub.restore()
+  }
+})
+
+test('请求体恒为流式，且 tools 同时含 bash 与 read', async () => {
+  const stub = stubFetch()
+  try {
+    // 调用方明确要非流式 —— 上游免费档对非流式一律 403，插件必须翻成流式
+    await makePlugin().chatOnce('', 'auto', request({ stream: false }))
+    const body = stub.captured[0]!.body
+    assert.equal(body.stream, true, '免费档只支持流式，非流式必须翻成 stream:true')
+
+    const names = (body.tools as Array<{ function?: { name?: string } }>).map((t) => t.function?.name)
+    assert.ok(names.includes('bash'), 'tools 缺 bash 会被 403')
+    assert.ok(names.includes('read'), 'tools 缺 read 会被 403')
+  } finally {
+    stub.restore()
+  }
+})
+
+test('调用方自带的同名工具不被占位工具覆盖（bash/read 只补缺）', async () => {
+  const stub = stubFetch()
+  try {
+    const realBash = {
+      type: 'function',
+      function: { name: 'bash', description: 'REAL BASH', parameters: { type: 'object', properties: { command: { type: 'string' } } } },
+    }
+    await makePlugin().chatOnce('', 'auto', request({
+      rawBody: JSON.stringify({ model: 'big-pickle', messages: [], stream: true, tools: [realBash] }),
+    }))
+    const tools = stub.captured[0]!.body.tools as Array<{ function: { name: string; description?: string } }>
+
+    const bash = tools.filter((t) => t.function.name === 'bash')
+    assert.equal(bash.length, 1, 'bash 不能被注入成两条（否则真实工具签名被挤掉）')
+    assert.equal(bash[0]!.function.description, 'REAL BASH', '调用方自己的定义必须原样保留')
+
+    // read 缺失 → 补上；bash 已有 → 不重复
+    assert.ok(tools.some((t) => t.function.name === 'read'), '缺的 read 要补上')
+  } finally {
+    stub.restore()
+  }
+})
+
+test("effort='off' 必须删字段而不是下发（上游没有这个值，会 400）", async () => {
+  const stub = stubFetch()
+  try {
+    // 关键：rawBody 里**本来就带** reasoning_effort/reasoning_summary。
+    // 不种这两个字段的话，「删」与「什么都不做」结果一样，闸门形同虚设
+    // （实测过：把 else-if 的 'off' 分支去掉，测试照样全绿）。
+    await makePlugin().chatOnce('', 'off', request({
+      rawBody: JSON.stringify({
+        model: 'big-pickle',
+        messages: [],
+        stream: true,
+        reasoning_effort: 'high',
+        reasoning_summary: 'auto',
+      }),
+    }))
+    const body = stub.captured[0]!.body
+    assert.equal('reasoning_effort' in body, false, "off 要删字段：上游收到 'off' 直接 400 invalid_request_error")
+    assert.equal('reasoning_summary' in body, false, 'reasoning_summary 一并删掉')
+  } finally {
+    stub.restore()
+  }
+})
+
+test("effort='auto' 不动调用方自己的 reasoning_effort（不误删）", async () => {
+  const stub = stubFetch()
+  try {
+    await makePlugin().chatOnce('', 'auto', request({
+      rawBody: JSON.stringify({ model: 'big-pickle', messages: [], stream: true, reasoning_effort: 'high' }),
+    }))
+    const body = stub.captured[0]!.body
+    assert.equal(body.reasoning_effort, 'high', 'auto = 不显式下发，调用方原值必须留着')
+  } finally {
+    stub.restore()
+  }
+})
+
+test('非 free 模型报 no_such_model（不记账、不冷号）', async () => {
+  const stub = stubFetch()
+  try {
+    const r = await makePlugin().chatOnce('', 'auto', request({ model: 'gpt-5.5' }))
+    assert.equal(r.ok, false)
+    assert.equal(r.ok === false ? r.state : '', 'no_such_model', '模型不属于本供应商 → 核心换供应商而不是冷号')
+    assert.equal(stub.captured.length, 0, '不属于自己的模型不该打上游')
+  } finally {
+    stub.restore()
+  }
+})