dsh-vscode-mode 0.23.2 → 0.23.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.23.2",
+  "version": "0.23.3",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车，界面状态（页签/光标/侧栏/编辑 Tab/导航历史）镜像到 DSH home 跨重启恢复",
   "icon": "assets/icon.svg",
   "keywords": [

package/src/client/missingReview.ts

@@ -1,6 +1,30 @@
 import type { MissingReview } from '../shared/types.js'
 import { splitLines } from '../shared/diff.js'
 
+/** 缺失文件终态：文件已在磁盘删除，且没有可展示的整文件预览。 */
+export interface GoneState {
+  title: string
+  message: string
+  /** 该文件还有官方待审改动：Keep 可在差异栏结案，Undo 不可用。 */
+  official: boolean
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 把 missingReview 的失败归并成「文件已删除」终态。只有确认删除的拒绝码才是终态；
+ * 会话缺失、权限、文件重新出现等失败返回 null，调用方继续走通用加载失败（可重试、保留跨端提示）。
+ * @param failure RPC 失败结果（error 必填，code 可选）
+ * @returns 终态信息或 null
+ */
+export function goneStateOf(failure: { error?: unknown; code?: unknown } | null | undefined): GoneState | null {
+  const code = failure?.code
+  const official = code === 'official-covered'
+  if (!official && code !== 'official-decided' && code !== 'no-records' && code !== 'no-evidence' && code !== 'too-large') return null
+  const message = String(failure?.error ?? '文件已在磁盘删除').replace(/^Error:\s*/, '')
+  return { title: official ? '文件已在磁盘删除 · 有官方待审改动' : '文件已在磁盘删除', message, official }
+}
+
 /** @public @author ddj 2026年10月28号 @param review Frozen complete snapshot. @returns One whole-file deletion, including empty files; no invented current lines. */
 export function missingRegion(review: MissingReview) {
   return {

package/src/client/ui/EditorView.ts

@@ -62,7 +62,7 @@ import { applyOfficial, editorFont, registerThemes, themeNameOf } from '../monac
 import { createDiffRenderer } from '../monaco/diffRender.js'
 import { ST, callIdAttr, noopHunk, summarize } from '../state/records.js'
 import { diffRegions } from '../state/regions.js'
-import { missingBatch, missingRegion } from '../missingReview.js'
+import { goneStateOf, missingBatch, missingRegion } from '../missingReview.js'
 import { QuickOpen } from './QuickOpen.js'
 import { attachHorizontalWheel } from './horizontalWheel.js'
 import { CommandPalette } from './CommandPalette.js'
@@ -343,6 +343,11 @@ export function EditorView(props) {
   const aiStatusTimer = React.useRef(null)
   const [error, setError] = React.useState(null)
   const [loadError, setLoadError] = React.useState(null)
+  // 缺失文件的终态：{ path, sessionId, title, message, official }。
+  // 与 loadError 区分开——加载失败可以重试，磁盘删除是终态，不能一直卡在进度条 0%。
+  const [goneFile, setGoneFile] = React.useState(null)
+  const missingReadRef = React.useRef(new Map()) // path → 已重读次数（防 文件缺失↔重现 抖动死循环）
+  const goneNow = goneFile && goneFile.path === active && goneFile.sessionId === sessionId ? goneFile : null
   const [largeCandidate, setLargeCandidate] = React.useState(null)
   const [pagedFile, setPagedFile] = React.useState(null)
   const [pageChanged, setPageChanged] = React.useState(null)
@@ -1173,17 +1178,49 @@ export function EditorView(props) {
    * @param force 强制走 RPC（reloadFile 用，跳过 model 复用）
    * @param version 已知磁盘版本（缺省走 RPC 返回值）
    */
-  /** @private @author ddj 2026年10月28号 @param path Missing text file. @param sid Owning session. @param seq Loader generation. @sideEffects Loads deletion evidence without creating or saving the file. */
+  /**
+   * 把「文件已在磁盘删除」记成终态面板：不占进度条、不反复重试，并允许直接关闭页签。
+   * 只有确认删除的原因才走终态；会话/权限类失败仍回退通用加载失败，保留跨端提示。
+   * @private @author ddj 2026年10月31号
+   * @param path 目标文件
+   * @param sid 会话 id
+   * @param seq 加载序号（过期响应丢弃）
+   * @param failure 宿主拒绝原因（可带稳定 code）
+   */
+  function settleGone(path, sid, seq, failure) {
+    if (!loadCurrent(path, seq)) return
+    const error = failure && typeof failure === 'object' ? failure : { error: failure }
+    const gone = goneStateOf(error)
+      ?? (error.deleted === true ? { title: '文件已在磁盘删除', official: false, message: String(error.error ?? '') } : null)
+    if (!gone) { failLoad(path, sid, seq, String(error.error ?? error)); return }
+    stampLoad(path, sid, seq, gone.message)
+    setLoadError(null)
+    setError(null)
+    setGoneFile({ ...gone, path, sessionId: sid })
+    setStatus(gone.official ? '文件已删除 · 差异栏可 Keep 结案' : '文件已删除')
+  }
+
+  /** @private @author ddj 2026年10月28号 / 2026年10月31号 @param path Missing text file. @param sid Owning session. @param seq Loader generation. @sideEffects Loads deletion evidence without creating or saving the file. */
   async function loadMissing(path, sid, seq) {
     try {
       const result = await rpc('edrv.missingReview', { sessionId: sid, path })
       if (!loadCurrent(path, seq)) return
-      if (!result.ok) { failLoad(path, sid, seq, result.error); return }
-      if (!result.review) { loadContent(path, sid, true); return }
+      if (!result.ok) { settleGone(path, sid, seq, result); return }
+      if (!result.review) {
+        // 宿主观测到文件仍在磁盘（与读取时的 file-missing 竞态）：重读一次即可；
+        // 同一文件反复抖动时收尾为终态，绝不再递归重读。
+        const attempts = (missingReadRef.current.get(path) ?? 0) + 1
+        missingReadRef.current.set(path, attempts)
+        if (attempts <= 2) { loadContent(path, sid, true); return }
+        settleGone(path, sid, seq, { deleted: true, error: '文件状态在磁盘上反复变化，请稍后重试，或关闭该标签页' })
+        return
+      }
+      missingReadRef.current.delete(path)
       if (dirtyRef.current[path] || savingRef.current.has(path)) { failLoad(path, sid, seq, '文件已删除，但有未保存编辑；请先处理本地缓冲'); return }
       const preview = { ...result.review, sessionId: sid, keepId: crypto.randomUUID(), undoId: crypto.randomUUID() }
       missingRef.current.set(path, preview)
       setMissingPreview(preview)
+      setGoneFile(null)
       setContent('')
       setContentPath(path)
       setLoadError(null)
@@ -1198,6 +1235,7 @@ export function EditorView(props) {
     const seq = ++loadSeqRef.current
     setReceiptLoad({ path, cwd, sessionId: sid, sequence: seq, status: 'loading' })
     setLoadError(null)
+    setGoneFile(null)
     setLargeCandidate(null)
     setPagedFile(null)
     setPageChanged(null)
@@ -4668,6 +4706,25 @@ export function EditorView(props) {
     React.createElement('div', { className: 'edrv-loading-percent' }, Math.round(progress) + '%'),
     retry ? React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: retry }, '重试') : null)
 
+  /**
+   * 渲染缺失文件终态面板：说明 + 重试 + 关闭页签（不显示进度条，避免卡在 0%）。
+   * @private @author ddj 2026年10月31号
+   * @param gone 终态信息
+   * @param retry 重新读取回调
+   * @param close 关闭该标签页回调
+   * @returns 终态面板 React 元素
+   */
+  const goneBody = (gone, retry, close) => React.createElement('div', { className: 'edrv-empty edrv-loading', 'aria-live': 'polite', role: 'status' },
+    React.createElement('div', { className: 'edrv-loading-title' }, gone.title),
+    React.createElement('div', { style: { fontSize: 12, maxWidth: 460, lineHeight: 1.6 } }, gone.message),
+    gone.official
+      ? React.createElement('div', { style: { fontSize: 12, maxWidth: 460, lineHeight: 1.6, opacity: 0.8 } },
+        '待审改动在差异栏：Keep 保留删除结果并结案；Undo 需要该文件的原始内容，磁盘已删除时不可用。')
+      : null,
+    React.createElement('div', { style: { display: 'flex', gap: 8 } },
+      React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: retry }, '重试'),
+      React.createElement('button', { className: 'edrv-pill edrv-pill-ghost', onClick: close }, '关闭标签页')))
+
   let body
   if (activePlan) {
     const labels = PLAN_MD_LABELS
@@ -4696,6 +4753,12 @@ export function EditorView(props) {
     body = React.createElement('div', { className: 'edrv-empty' },
       React.createElement('div', null, '暂无打开的文件'),
       React.createElement('div', { style: { fontSize: 12 } }, '使用右上搜索框 (' + (chordOf('edrv.quickOpen') ?? 'Ctrl+P') + ') 打开工作区文件；' + (chordOf('edrv.showCommands') ?? 'Ctrl+Shift+P') + ' 打开命令栏；agent 修改文件后顶部会出现差异角标'))
+  } else if (goneNow) {
+    // 终态：文件已在磁盘删除且没有可用预览。不再显示 0% 进度条，也不无限重试。
+    body = goneBody(goneNow, () => {
+      missingReadRef.current.delete(goneNow.path)
+      loadContent(active, sessionId, true)
+    }, () => { void closeTab(goneNow.path) })
   } else if (content === null && loadError && isSessionMissingError(loadError)) {
     // 跨端会话缺失：终态提示而非加载失败卡死（会话仅在一端激活，本端 RPC 均被拒）
     body = React.createElement('div', { className: 'edrv-empty edrv-loading', 'aria-live': 'polite' },

package/src/missingReview.ts

@@ -2,9 +2,10 @@
 import { createHash, randomUUID } from 'node:crypto'
 import { resolve } from 'node:path'
 import type { DiffRecord, MissingReview } from './shared/types.js'
+import type { MissingRefusal } from './shared/rpc.js'
 import type { Ctx, Session } from './store.js'
 import { archiveRecords, policyOf, READ_CAP, resolveTargetIn, targetPathOf } from './store.js'
-import { hasOfficial } from './reviewDb.js'
+import { hasOfficial, officialPending } from './reviewDb.js'
 import { recordResolved } from './model.js'
 
 interface FrozenReview {
@@ -18,6 +19,32 @@ interface FrozenReview {
 const frozen = new Map<string, FrozenReview>()
 const locks = new Set<string>()
 
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 给缺失文件预览的可预期拒绝挂稳定错误码。客户端据此显示终态说明，
+ * 而不是把内部错误原文当「加载失败」反复重试；也不让上游把 SQLite 报错原文透给编辑器。
+ * @param code 稳定错误码（official-covered / no-records / no-evidence / too-large）
+ * @param message 可读原因
+ * @returns 带 code 的 Error
+ */
+export function refusal(code: MissingRefusal, message: string): Error {
+  return Object.assign(new Error(message), { code })
+}
+
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 从任意错误里取回缺失文件预览的稳定拒绝码；不是本模块抛出的错误一律返回 undefined。
+ * @param error 捕获到的错误
+ * @returns 稳定拒绝码或 undefined
+ */
+export function refusalCodeOf(error: unknown): MissingRefusal | undefined {
+  const code = (error as { code?: unknown } | null)?.code
+  return code === 'official-covered' || code === 'official-decided' || code === 'no-records'
+    || code === 'no-evidence' || code === 'too-large' ? code : undefined
+}
+
 /** @private @author ddj 2026年10月28号 @param target Resolved absolute path. @returns Platform file identity. */
 function fileKey(target: string): string {
   const normalized = resolve(target).replace(/\\/g, '/')
@@ -67,13 +94,25 @@ export async function missingReview(ctx: Ctx, session: Session, cwd: string, buc
   // 解析结果可能是不透明 FsTarget，凡按路径字符串使用的分支都必须先还原。
   const abs = targetPathOf(ctx, target)
   if (!abs) throw new Error('无法解析目标文件路径')
-  if (hasOfficial(cwd, path) || hasOfficial(cwd, abs)) throw new Error('该文件已有官方审查记录，请使用官方审查入口')
+  // 官方记录覆盖该文件时不再给整文件删除预览：删除内容只能用差异栏的 Keep 结案，
+  // 但必须带稳定错误码，客户端才能显示「已删除」终态而不是卡在加载失败。
+  if (hasOfficial(cwd, path) || hasOfficial(cwd, abs)) {
+    if (!officialPending(cwd, abs) && !officialPending(cwd, path)) {
+      throw refusal('official-decided', '该文件已在磁盘删除，官方审查记录均已处理：可直接关闭该标签页')
+    }
+    throw refusal('official-covered', '该文件已有官方审查记录（磁盘上已删除）：请在差异栏对该待审条目执行 Keep 结案；'
+      + '整文件删除预览只适用于待审历史记录')
+  }
   if (!await fileAbsent(ctx, cwd, abs)) throw new Error('文件已重新出现，请刷新')
   const records = await fileRecords(ctx, cwd, bucket, abs)
   const latest = records.at(-1)
-  if (!records.some((record) => !record.archived && !recordResolved(record))) throw new Error('没有待审历史记录')
-  if (!latest || typeof latest.after !== 'string') throw new Error('缺少可靠的完整历史快照，无法展示或恢复；不会用局部差异拼接文件')
-  if (Buffer.byteLength(latest.after, 'utf8') > READ_CAP) throw new Error('历史快照过大，无法整文件预览')
+  if (!records.some((record) => !record.archived && !recordResolved(record))) {
+    throw refusal('no-records', '磁盘上已没有该文件，且没有待审历史记录：可直接关闭该标签页')
+  }
+  if (!latest || typeof latest.after !== 'string') {
+    throw refusal('no-evidence', '磁盘上已没有该文件，且缺少可靠的完整历史快照，无法展示或恢复；不会用局部差异拼接文件')
+  }
+  if (Buffer.byteLength(latest.after, 'utf8') > READ_CAP) throw refusal('too-large', '磁盘上已没有该文件，且历史快照过大，无法整文件预览')
 
   for (const [token, item] of frozen) if (item.expires < Date.now()) frozen.delete(token)
   if (frozen.size >= 256) throw new Error('缺失文件预览过多，请稍后重试')

package/src/officialCapture.ts

@@ -184,6 +184,11 @@ export function installCapture(ctx: Ctx, onSnapshot?: (cwd: string, snapshot: Re
       log.warn('官方历史补采不可用：缺少 sessionQuery；后续实时事件仍会采集')
       return
     }
+    const source = ctx.get('workspaceChanges')
+    if (!source?.summary) {
+      log.warn('官方历史补采不可用：缺少 workspaceChanges；后续实时事件仍会采集')
+      return
+    }
     try {
       // Repair durable history independently: official summaries do not survive Host restart.
       // Each saved snapshot resolves against its own cwd, not the current session directory.
@@ -193,11 +198,17 @@ export function installCapture(ctx: Ctx, onSnapshot?: (cwd: string, snapshot: Re
       }
       // Semantic search omits structural events; only the raw metadata list contains workspace/changes.
       const events = await query.listEvents(session.id)
+      let expired = 0
       for (const event of events) {
         if (event.type !== 'workspace/changes' || event.seq < (session.inheritedEventCount ?? 0)) continue
+        // Official summaries live only in Host memory, so a restart makes every
+        // historical event unreadable. Probe before enqueue: queueing them records
+        // one durable gap per turn that can never be repaired or replayed.
+        if (!source.summary(session.id, event.seq)) { expired += 1; continue }
         const window = await query.readEvent({ sessionId: session.id, seq: event.seq })
         collector.enqueue(session, window.target)
       }
+      if (expired) log.info(`官方历史补采跳过 ${expired} 轮已失效事件：官方 summary 不跨宿主重启保留，实时事件照常采集`)
     } catch (error) { log.warn('官方历史补采失败：' + String(error)) }
   }
 }

package/src/reviewDb.ts

@@ -205,6 +205,29 @@ export function reviewPage(cwd: string, cursor = 0, history = false, path?: stri
 
 }
 
+/**
+ * @public
+ * @author ddj 2026年10月31号
+ * @description: 该文件是否还有未处理的官方待审改动。缺失文件预览据此区分「需要去差异栏 Keep 结案」
+ * 与「记录都已处理、可直接关闭标签页」，避免已结案的删除文件继续提示待审。
+ * @param cwd Migrated workspace
+ * @param path Host path of the file
+ * @returns 存在未决官方记录时为 true
+ */
+export function officialPending(cwd: string, path: string): boolean {
+  if (typeof path !== 'string') return false
+  const db = dbFor(cwd)
+  if (!db.prepare("SELECT 1 FROM sqlite_master WHERE name='review_files' AND type='table'").get()) return false
+  // Windows 盘符路径按「反斜杠折成正斜杠 + 折大小写」比较（与 hasOfficial 的 SQL 归一化等价）；
+  // 其余平台按身份精确比较，别把大小写不同的两个文件当成同一个。
+  if (path.length > 1 && path[1] === ':') {
+    const folded = path.split(String.fromCharCode(92)).join('/').toLowerCase()
+    return !!db.prepare("SELECT 1 FROM review_files WHERE current=1 AND decision='pending'"
+      + " AND lower(replace(identity,char(92),'/'))=? LIMIT 1").get(folded)
+  }
+  return !!db.prepare("SELECT 1 FROM review_files WHERE current=1 AND decision='pending' AND identity=? LIMIT 1").get(path)
+}
+
 /** @public @author ddj 2026年10月26号 @param cwd Migrated workspace. @param path Legacy write target. @returns Whether any official version owns the file, including decided history. */
 export function hasOfficial(cwd: string, path: string): boolean {
   // 防御：解析结果若被误当成路径传进来（不透明对象），按「无官方记录」处理，

package/src/reviewRpc.ts

@@ -1,6 +1,6 @@
 /** Session-scoped official review RPC. @author ddj 2026年10月26号 */
 import type { RpcHandlerMap } from './shared/rpc.js'
-import type { ReviewItem, ReviewPage } from './shared/review.js'
+import type { ReviewDetail, ReviewItem, ReviewPage } from './shared/review.js'
 import type { PendingPage } from './shared/pendingReview.js'
 import { decideReview, reviewDetail, reviewPage } from './reviewDb.js'
 import { undoReview } from './reviewUndo.js'
@@ -8,6 +8,7 @@ import { applyDecide, loadDetail, loadPage } from './pending/store.js'
 import { PENDING_PREFIX, mergedPage, pendingDetailOf, pendingItemOf, pendingSamePath } from './pendingCompat.js'
 import { bucketOf, resolveScope, sessionOf } from './registry.js'
 import type { Registry } from './registry.js'
+import { resolveTargetIn } from './store.js'
 import type { Ctx } from './store.js'
 import { log } from './log.js'
 
@@ -54,6 +55,35 @@ function batchSnapshot(cwd: string, pending: PendingPage): { ok: true; page: Rev
   }
 }
 
+/**
+ * @private
+ * @author ddj 2026年10月31号
+ * @description: 文件已在磁盘删除时修正官方记录的能力说明。Keep 只写审查库、仍可结案，
+ * Undo 需要读写源文件、必然不可用：把「缺少原始字节」这种误导性原因换成可执行说明。
+ * 只改文案与 undo 位，不参与判定写入。
+ * @param ctx Host 能力
+ * @param cwd 工作区
+ * @param detail 官方记录详情
+ * @param capability 已按冷/热端调整过的能力
+ * @returns 修正后的能力；无法确认删除时原样返回
+ */
+async function absenceCapability(ctx: Ctx, cwd: string, detail: ReviewDetail, capability: ReviewDetail['capability']): Promise<ReviewDetail['capability']> {
+  if (!capability.keep) return capability
+  // 记录本身就是删除（after=false）：Undo 要整文件内容，官方差异只有片段
+  if (detail.diff.kind === 'text' && !detail.diff.after) {
+    return { ...capability, undo: false, reason: '该记录删除了这个文件：Keep 按删除结案；Undo 需要完整文件内容，官方差异只有片段，不可用。' }
+  }
+
+  // 文件已被删除时，Undo 的失败原因是「文件不在」，不是「缺少原始字节」：先查磁盘再谈证据
+  const fs = ctx.get('fs')
+  if (!fs) return capability
+  try {
+    const target = await resolveTargetIn(ctx, cwd, detail.item.currentPath)
+    if (await fs.stat(target)) return capability
+  } catch { return capability }
+  return { ...capability, undo: false, reason: '文件已在磁盘删除：Keep 按删除结案；Undo 需要读写该文件，当前不可用。' }
+}
+
 /**
  * @public
  * @author ddj 2026年10月26号 / 2026年10月28号
@@ -176,7 +206,7 @@ export function reviewHandlers(ctx: Ctx, registry: Registry): Partial<RpcHandler
         return { ok: false, error: '官方审查记录不存在' }
       }
       // Keep 只写共享库，冷端放行；Undo 依赖会话证据与源文件写回，冷端关闭
-      const capability = liveCapabilityOf(detail.capability, scope.live, false)
+      const capability = await absenceCapability(ctx, cwd, detail, liveCapabilityOf(detail.capability, scope.live, false))
       log.debug(`[review] detail live=${scope.live ? 1 : 0} id=${args.id} found=1`
         + ` keep=${capability.keep ? 1 : 0} undo=${capability.undo ? 1 : 0}`)
       return { ok: true, detail: { ...detail, capability } }

package/src/rpc.ts

@@ -63,7 +63,7 @@ import { settingsDocPath } from './settingsDocPath.js'
 import { createTextPages } from './textPages.js'
 import { reviewHandlers } from './reviewRpc.js'
 import { pendingHandlers } from './pendingRpc.js'
-import { fileAbsent, missingReview, missingDecide, missingPath } from './missingReview.js'
+import { fileAbsent, missingReview, missingDecide, missingPath, refusalCodeOf } from './missingReview.js'
 import { pendingCovers } from './pendingCompat.js'
 
 /** Process-local cursor signer; reads must stay on the Host filesystem capability. */
@@ -733,7 +733,11 @@ export function buildHandlers(
         const bucket = await bucketOf(registry, ctx, sc.cwd)
         if (!await fileAbsent(ctx, sc.cwd, args.path)) return { ok: true, review: null }
         return { ok: true, review: await missingReview(ctx, sc.session, sc.cwd, bucket, args.path) }
-      } catch (error) { return { ok: false, error: String(error) } }
+      } catch (error) {
+        // 可预期的拒绝带稳定错误码：客户端据此显示「已删除」终态，而不是把错误原文当加载失败重试
+        const code = refusalCodeOf(error)
+        return { ok: false, error: String(error), ...(code ? { code } : {}) }
+      }
     },
     'edrv.missingDecide': async (args) => {
       const sc = await requireSession(ctx, args.sessionId)

package/src/shared/rpc.ts

@@ -736,10 +736,13 @@ export interface RpcOkMap {
   'edrv.uiState.set': object
 }
 
+/** 缺失文件预览的稳定拒绝码：客户端据此显示「已删除」终态，而不是把错误原文当加载失败重试。 */
+export type MissingRefusal = 'official-covered' | 'official-decided' | 'no-records' | 'no-evidence' | 'too-large'
+
 /** 统一响应：{ok:true, ...payload} 或 {ok:false, error}。 */
 export type RpcResult<M extends RpcMethod> =
   | ({ ok: true } & RpcOkMap[M])
-  | { ok: false; error: string; code?: 'file-too-large' | 'file-missing'; reason?: Extract<import('./textPages.js').TextPageResult, { ok: false }>['reason'] }
+  | { ok: false; error: string; code?: 'file-too-large' | 'file-missing' | MissingRefusal; reason?: Extract<import('./textPages.js').TextPageResult, { ok: false }>['reason'] }
 
 /** 每个方法的 handler 签名（host 分发表与 client 类型检查共用）。 */
 export type RpcHandler<M extends RpcMethod> = (