dsh-vscode-mode 0.16.0 → 0.18.0

package/locale/en.json

@@ -1,4 +1,6 @@
 {
-  "title": "VSCodeMode",
-  "description": "VSCode-like coding on DSH: Monaco editor with tabs and QuickOpen, command palette, agent edit review, SVN integration, and LSP smartness."
+  "meta": {
+    "title": "VSCodeMode",
+    "description": "VSCode-like coding on DSH: Monaco editor with tabs and QuickOpen, command palette, agent edit review, SVN integration, and LSP smartness."
+  }
 }

package/locale/zh.json

@@ -1,4 +1,6 @@
 {
-  "title": "VSCodeMode",
-  "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（页签/QuickOpen/状态栏）、命令栏、Agent 编辑差异审查、SVN 集成与 LSP 智能。"
+  "meta": {
+    "title": "VSCodeMode",
+    "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（页签/QuickOpen/状态栏）、命令栏、Agent 编辑差异审查、SVN 集成与 LSP 智能。"
+  }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.16.0",
+  "version": "0.18.0",
   "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": [
@@ -29,7 +29,8 @@
   },
   "type": "module",
   "engines": {
-    "node": "^22.19.0 || >=24.0.0"
+    "node": "^22.19.0 || >=24.0.0",
+    "dsh": ">=0.1.0-rc.1 <0.3.0-0"
   },
   "packageManager": "pnpm@11.3.0",
   "main": "./lib/index.js",
@@ -90,6 +91,7 @@
   "exports": {
     ".": "./lib/index.js",
     "./client": "./lib/client.js",
+    "./locale/*.json": "./locale/*.json",
     "./package.json": "./package.json"
   },
   "dsh": {

package/skills/dsh-vscodemode-mcp/SKILL.md

@@ -14,8 +14,8 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 |---|---|---|
 | 持久配置 | profile loader 树 | 已注册 workspace 根目录的 `.mcp.json` |
 | 生效范围 | profile 内所有工作区 | cwd 匹配该 workspace 的 agent |
-| 运行方式 | 原有全局 loader entry | `agent.ctx.plugin(officialMcp, config)` |
-| 连接实例 | 每个启用的全局 entry 一份 | 每个活动 agent、每个启用服务一份 |
+| 运行方式 | 原有全局 loader entry | 私有连接 scope + 会话授权代理，复用官方 MCP 插件 |
+| 连接实例 | 每个启用的全局 entry 一份 | 默认逐 agent 隔离；显式选择 workspace 后工作区复用 |
 | 没有活动 agent | 仍可运行 | 仅保存配置，`configured`、`instanceCount: 0` |
 | 团队共享 | 否 | `.mcp.json` 可以随仓库共享 |
 
@@ -25,7 +25,9 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 设置 → VSCodeMode → MCP 管理，包含「我的 MCP」「项目 MCP」「MCP 市场」（占位）。项目服务在所选项目内管理。
 
-保存项目服务会写入 `.mcp.json` 并更新匹配的活动 agent；没有活动 agent 时保存为待挂载配置。启用不会凭空创建会话。每个新 agent 的串行 `agent/created` 监听会读取最新配置并等待其官方插件启动；插件装配时也会接入已经存在的 agent。
+保存项目服务会写入 `.mcp.json` 并更新匹配 agent 的能力目录与惰性资源入口。新建会话只等待配置准备和轻量入口，不等待任何项目 MCP 握手；默认 `on-demand`，未使用不启动。显式 `background` 后台预热也不阻塞创建。同一 Host 最多两个冷启动；同代次初始化 single-flight。配置写操作仍串行保护，但连接准备不占有跨会话全局锁。
+
+AI 先调用全局发现入口 `discover_project_mcp {action:"list"}`，仅返回执行 agent 工作区内的安全目录；需要时 `{action:"connect",serverName:"..."}` 连接并返回真实 schema。入口从工具执行上下文取 agent，不接受 sessionId、路径、命令、URL 或凭据。真实工具依然走官方审批、guard 和结果投影；Native 在下一次请求获得工具，PTC 必须结束当前程序后新建程序刷新 SDK，禁止 eval 或通用透传绕过权限。资源工具可通过所属工作区的惰性 provider 按需连接。
 
 禁用、删除、配置变更、刷新重连及 agent/插件卸载都会释放相应 fiber 和连接。仅刷新未变化的项目列表不会重复连接。主机代码更新需要重启 DSH 才能加载新实现。
 
@@ -33,6 +35,14 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 表单 stdio 参数采用 JSON `string[]` 或每行一个完整参数，不按空格/引号做 shell 拆分；含空参数或内嵌换行使用 JSON。HTTP 请求头每行 `key=value`，保留值内的等号，拒绝非法/重复（忽略大小写）键。失败保存保持表单，忙时禁止重复动作。
 
+### 会话列表状态
+
+官方 `sidebar.session.row.leading` 插槽在会话标题前显示 16px 加载或异常图标；平稳完成不常驻绿色成功标。官方运行中、待审批、新消息状态优先覆盖 leading，归档行不展示 leading；`sidebar.session.row.hover` 悬浮详情仍可查看。
+
+详情只描述 VSCodeMode 管理的**项目 MCP**：待使用（不转圈）、读取配置、等待启动名额、加载插件模块、等待服务插件启动、复用已有连接、释放旧实例、完成或异常，展示完成数、耗时与安全错误摘要。共享显示会话本次等待，不将连接年龄冒充本次等待。超过 10 秒仅提示耗时较长，不判定失败。完成文案为「初始化完成，连接健康未验证」。无活跃 agent 文案为「当前无活跃 MCP 实例」，不是成功；不包含全局或 preset MCP。
+
+所有可见行共用一份 `mcp.sessionSnapshot` 订阅，在文档可见且有消费者时按 2.5 秒间隔查询；请求 10 秒截止、不重叠，隐藏/退订/卸载取消，过期响应丢弃。错误保留上次快照并标过期。查询只读内存，**不读配置、不 reconcile、不激活/保留历史会话、不建立连接**；旧 Host 或缺少插槽时安全降级。错误详情不返回 env、headers、完整配置或凭据 URL，仅返回安全类别提示，原始诊断看 Host 日志。
+
 ## 3. 项目配置
 
 `.mcp.json` 示例：
@@ -58,6 +68,8 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 - stdio：`command` 必填；可填 `args`、`cwd`、`env`。未指定 `cwd` 时，以项目根作为进程工作目录。
 - HTTP：`url` 必须以 `http://` 或 `https://` 开头，可填 `headers`。
 - 高级参数：`toolCallTimeoutMs`、`failOnStartupError`、`maxInstructionBytes`、`reconnect`。
+- 项目扩展 `vscodeMode: { startup: "on-demand" | "background", sharing: "agent" | "workspace", startupTimeoutMs: 60000 }` 与官方传输配置分离，不透传；默认 on-demand + agent，旧文件不批量改写。初始化预算接受 1000–300000 整数，不是业务调用超时。全局配置不接受项目扩展。
+- workspace 共享必须显式确认服务适合共享内部状态；不会自动给 CodeGraph 开启。池键含工作区、有效配置和策略，凭据只做内存摘要身份。共享调用默认串行，最后租约释放保温 60 秒；agent 模式立即释放。禁用/删除/刷新/配置变化先失效与撤销再关闭，关闭未确认则阻止替代。超时显示释放阶段，失败冷却 5 秒后允许显式重试，不无限自动重试。
 - `disabled: true` 保持配置但不创建连接；保存表单会恢复启用。重启和 reconcile 都尊重 `disabled`。
 - 保存保留文档顶层、其他服务器及当前服务器的未知字段和未编辑高级参数；切换传输方式会移除旧传输专属字段。
 - `env` / `headers` 在返回值中使用 `••••••` 脱敏。原键的未修改掩码保存时恢复真实值；新键只有掩码而没有原值时会拒绝保存，需填写凭据。
@@ -85,12 +97,14 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 |---|---|---|
 | `mcp.list` | `{}` | `servers` |
 | `mcp.snapshot` | `{}` | `servers`, `projects`（只读运行快照） |
+| `mcp.sessionSnapshot` | `{}` | `sessions`, `sampledAt`（按 sessionId 区分的活跃初始化状态，只读内存） |
 | `mcp.save` | `{ config }` | `server` |
 | `mcp.remove` | `{ id }` | 无 |
 | `mcp.toggle` | `{ id, enabled }` | `server` |
 | `mcp.refresh` | `{ id }` | `server` |
 | `mcp.projects` | `{}` | `projects` |
-| `mcp.projectSave` | `{ workspacePath, serverName, config }` | `project` |
+| `mcp.projectSave` | `{ workspacePath, serverName, config, policy? }` | `project` |
+| `mcp.projectConnect` | `{ sessionId, workspacePath, serverName }` | `project`（仅已活跃匹配会话，不激活历史会话） |
 | `mcp.projectRemove` | `{ workspacePath, serverName }` | `project` |
 | `mcp.projectToggle` | `{ workspacePath, serverName, enabled }` | `project` |
 | `mcp.projectRefresh` | `{ workspacePath, serverName }` | `project` |
@@ -109,7 +123,7 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 ## 6. 工具、资源和指令隔离
 
-官方 0.1.7-rc.2 的 MCP Config 没有关闭资源/指令的开关；官方注册随 `scopeOf(ctx)` 归属。因此项目连接必须直接在 `agent.ctx` 挂载，不能全局连接后只隐藏工具。
+官方 0.1.7-rc.2 的 MCP Config 没有关闭资源/指令的开关；官方注册随 `scopeOf(ctx)` 归属。因此连接在独立 scope 中隔离 tools、mcpResources、systemPrompt，捕获注册后再给合法 agent 提供代理，绝不将原始项目注册暴露全局。创建私有 scope 后先等待 backing fiber 初始激活完成再 provide，防止依赖服务丢失；真实官方模块测试覆盖此边界。
 
 子 agent 会继承父 scope；跨 cwd 子会话还有三层处理：
 
@@ -126,7 +140,7 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 | 状态/现象 | 含义与处理 |
 |---|---|
-| `configured` | 中性色；配置已保存，没有已挂载实例，打开匹配工作区会话后挂载 |
+| `configured` | 中性色；配置已保存，尚无连接实例，首次发现/资源访问或显式手动连接才启动（background 策略除外） |
 | `disabled` | 配置已停用，不建立项目连接 |
 | `connecting` | 官方插件还在等待启动完成；检查命令、cwd、URL 和握手 |
 | `unverified` | 中性色；fiber 已激活，但官方没有公开连接状态证据，不能宣称已连接；右侧绿色开关只表示启用 |
@@ -140,7 +154,10 @@ whenToUse: 用户要求新增、修改、启停或排查 VSCodeMode MCP 配置
 
 ## 8. 维护位置与验证
 
-- `src/mcpRuntime.ts`：agent → fibers 台账、官方插件加载、串行创建、迁移与卸载。
+- `src/mcpRuntime.ts`：会话租约/能力台账、官方模块加载、非阻塞接入、迁移与卸载。
+- `src/mcpPool.ts`：独立连接、single-flight、并发名额、取消/超时/保温和代次围栏。
+- `src/mcpBridge.ts`：私有服务隔离、真实工具代理、动态列表和撤销。
+- `src/mcpDiscover.ts`：统一发现入口与按 scope 输出的能力目录。
 - `src/mcpProject.ts`：源配置读取、保留字段、命名检查及 reconcile。
 - `src/mcpIsolation.ts`：继承工具限制、资源执行 guard、指令和资源列表覆盖。
 - `src/mcp.ts`：全局 loader CRUD、脱敏与诚实状态。

package/src/capture.ts

@@ -16,7 +16,7 @@ import type { Ctx, Session } from './store.js'
 import { READ_CAP, archiveCanceled, loadBucket, saveBucket } from './store.js'
 import { fileMaxBatch, prune } from './model.js'
 import type { Registry } from './registry.js'
-import { cwdOf } from './registry.js'
+import { cwdOfSession } from './registry.js'
 import { findRemoteWs, mirrorTargetOf } from './remoteWorkspace.js'
 import { invalidateIndex } from './treeIndex.js'
 import { log } from './log.js'
@@ -275,7 +275,7 @@ export async function captureToolResult(ctx: Ctx, registry: Registry, exec: any,
   // remote_ssh_write 只依赖参数与 isError（其 result.value 形状不受本插件约束）
   if (exec.name !== 'remote_ssh_write' && !result?.value) return
   try {
-    const cwd = cwdOf(session)
+    const cwd = cwdOfSession(ctx, session)
     if (!cwd) return
     const args = ((exec.arguments || {}) as Record<string, unknown>)
     const record = exec.name === 'remote_ssh_write'

package/src/client/compat.ts

@@ -172,7 +172,8 @@ export interface SlotSpec {
   name: string
   id: string
   order?: number
-  label?: string
+  /** 文案：字符串或 thunk；thunk 在每次读取时重算，语言切换后无需重注册。 */
+  label?: string | (() => string)
   inject?: (sessionId: string) => object
 }
 

package/src/client/index.ts

@@ -20,6 +20,9 @@ import { DiffBadge } from './ui/DiffBadge.js'
 import { PerfSizeBadge } from './ui/PerfSizeBadge.js'
 import { ConversationDiffDock } from './ui/ConversationDiffDock.js'
 import { McpSettings } from './ui/McpSettings.js'
+import { mcpSessionState } from './mcpSessionState.js'
+import { McpSessionIcon, McpSessionDetail, type McpRowProps } from './ui/McpSessionStatus.js'
+import { PluginDetailSection } from './ui/PluginDetailSection.js'
 import { rpc } from './rpc.js'
 import { loadMonaco } from './monaco/loader.js'
 import { observeScheme, schemeOfSnapshot } from './monaco/theme.js'
@@ -60,6 +63,7 @@ import { SHORTCUT_PROFILES, defaultKeybindings, normalizeKeybindings } from '../
 import { sidebarMinApply } from './sidebarMin.js'
 import { editorLimitApply } from './editorLimit.js'
 import { log } from './log.js'
+import { installLocale } from './localeClient.js'
 import { setupLsp, setSession, disposeLsp } from './monaco/lsp/index.js'
 import { disposeSnippets } from './snippets/provider.js'
 import { disposeLaunchJson } from './dap/launchSnippetProvider.js'
@@ -123,6 +127,10 @@ function setupCommands(ctx: any): CommandBridge {
 export async function apply(ctx: any): Promise<void> {
   const schedule = (fn: () => void, ms: number) => ctx.timeout(fn, ms)
 
+  // UI 壳层文案：注册本插件词典到官方 locale 服务（旧版无该服务时直读中文词典）。
+  // slot label / 编辑 Tab 标题一律写成 thunk，让语言切换后无需重注册即可刷新。
+  const t = installLocale(ctx)
+
   /**
    * 无门控上报界面状态镜像事件（绕过客户端 edrv.debug 开关，直接落 host 诊断日志）。
    * 开关关闭时 dbg 直接 return，「重启后没恢复」这类问题会在客户端侧彻底无痕，故另开一条通路。
@@ -506,7 +514,7 @@ export async function apply(ctx: any): Promise<void> {
       name: 'conversation.view',
       id: 'edrv-editor',
       order: 5,
-      label: '文件编辑',
+      label: () => t('slot.fileEditor'),
       inject: (sessionId: string) => ({ sessionId }),
     }, (props: unknown) => React.createElement(EditorView, Object.assign({}, props, { layout: 'tab', sideHint: SIDEBAR_INSTALL_CMD, schedule, addToConversation, sidebarPanels, outlineSources, fileMenuItems, fileOpeners: registry, sessions })))
   }
@@ -530,9 +538,10 @@ export async function apply(ctx: any): Promise<void> {
       service: official.service,
       slots: ctx.slots,
       renderTab: officialRenderTab,
+      title: () => t('slot.fileEditor'),
       guide: {
-        title: () => OFFICIAL_TAB_TITLE,
-        description: () => 'Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）',
+        title: () => t('guide.title'),
+        description: () => t('guide.description'),
       },
     })
     if (outcome === null) {
@@ -627,21 +636,33 @@ export async function apply(ctx: any): Promise<void> {
   }
   retrySideService()
 
+  // Root row slots receive only sessionId: no sessions.scope()/activation for historical rows.
+  ctx.effect(() => {
+    const store = mcpSessionState()
+    /** @author ddj 2026年10月20号 @param props Official root row identity. @returns Leading marker with shared polling. */
+    const renderIcon = (props: unknown) => React.createElement(McpSessionIcon, { ...(props as McpRowProps), store })
+    /** @author ddj 2026年10月20号 @param props Official hover identity. @returns Project-only initialization details. */
+    const renderDetail = (props: unknown) => React.createElement(McpSessionDetail, { ...(props as McpRowProps), store })
+    const leading = registerSlotSafely(ctx, { name: 'sidebar.session.row.leading', id: 'edrv-mcp-status', order: 20 }, renderIcon)
+    const hover = registerSlotSafely(ctx, { name: 'sidebar.session.row.hover', id: 'edrv-mcp-detail', order: 20 }, renderDetail)
+    return () => { leading?.(); hover?.(); store.dispose() }
+  }, 'vscode-mode: session MCP status')
+
   // 对话输入框上方差异 dock：普通对话显示单文案按钮，文件编辑页由 EditorView 隐藏
   registerSlotSafely(ctx, {
     name: 'conversation.input.dock',
     id: 'edrv-diff-dock',
     order: 30,
-    label: '差异',
+    label: () => t('slot.diff'),
     inject: (sessionId: string) => ({ sessionId }),
   }, (props: unknown) => React.createElement(ConversationDiffDock, Object.assign({}, props)))
 
   // header 差异角标：仅当前工作区存在差异时渲染
-  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-diff-badge', order: 90, label: '差异' },
+  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-diff-badge', order: 90, label: () => t('slot.diff') },
     (props: unknown) => React.createElement(DiffBadge, Object.assign({}, props)))
 
   // header 会话体积指示器：当前会话持久化体积，超阈值提示新开会话（性能优化）
-  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-perf-size', order: 89, label: '会话体积' },
+  registerSlotSafely(ctx, { name: 'conversation.session.header.utilities', id: 'edrv-perf-size', order: 89, label: () => t('slot.sessionSize') },
     (props: unknown) => React.createElement(PerfSizeBadge, Object.assign({}, props, { sessions })))
 
   // 设置页中的 VSCodeMode 专属页签，MCP 管理作为该页签的内部子 Tab。
@@ -649,15 +670,24 @@ export async function apply(ctx: any): Promise<void> {
     name: 'settings.section',
     id: 'vscode-mode',
     order: 30,
-    label: 'VSCodeMode',
+    label: () => t('slot.settings'),
   }, () => React.createElement(SettingsContext.Provider, { value: bridge.scope() }, React.createElement(McpSettings, {
     openerRegistry: registry,
+    getMcpSession: () => readSessionScope(ctx).sessionId,
     compatSummary,
     // 快捷键统一走 DSH 官方配置：通用页只提供「打开官方快捷键配置」入口。
     // 服务运行时探测（自愈）：旧版 DSH 无该服务时按钮给出手动打开方式。
     getShortcuts: () => detectShortcuts(ctx),
   })))
 
+  // 官方插件管理器详情页的只读状态段（DSH 0.2.1 新增扩展位）：非本插件页返回 null。
+  // 该 slot 在旧版 DSH 不存在，slots.inject 会一直等待（不报错），故无需版本判断。
+  registerSlotSafely(ctx, {
+    name: 'plugins.detail.section',
+    id: 'edrv-plugin-status',
+    order: 40,
+  }, (props: unknown) => React.createElement(PluginDetailSection, Object.assign({}, props)))
+
   // 卸载收尾（G4，DSH 0.1.6-alpha.2 起支持运行时卸载/重载）：
   // 注销挂在存活的 window.monaco 上的全部 Monaco provider 并复位模块状态。
   // 不做会导致重载后重复注册（补全/跳转/hover 各翻倍）与陈旧开关残留。

package/src/client/localeClient.ts

@@ -0,0 +1,97 @@
+/**
+ * dsh-vscode-mode client — UI 壳层文案的 locale 接入。
+ * 此前 `locale` 写在 inject 里却零调用，界面文案全为硬编码中文；
+ * 这里只覆盖壳层（slot label、编辑 Tab 标题、侧栏引导），编辑器内部大段文案不动。
+ * 所有对外函数都对 locale 服务做可选探测：旧版 DSH 无该服务时回落中文词典。
+ * 作者 ddj 2026年10月19号
+ */
+
+/** locale 命名空间（与包名一致，避免与其他插件串词条）。 */
+export const LOCALE_NS = 'dsh-vscode-mode'
+
+/** 支持的语言；zh 为缺省回退语言。 */
+export const LOCALE_FALLBACK = 'zh'
+
+/** 壳层文案词典（键名即 slot label / Tab 标题的稳定标识）。 */
+export const LOCALE_DICTS: Record<string, Record<string, string>> = {
+  zh: {
+    'slot.fileEditor': '文件编辑',
+    'slot.diff': '差异',
+    'slot.sessionSize': '会话体积',
+    'slot.settings': 'VSCodeMode',
+    'guide.title': '文件编辑',
+    'guide.description': 'Monaco 文件编辑器：对话与编辑同屏（差异审查/跳转/大纲）',
+  },
+  en: {
+    'slot.fileEditor': 'File editor',
+    'slot.diff': 'Diff',
+    'slot.sessionSize': 'Session size',
+    'slot.settings': 'VSCodeMode',
+    'guide.title': 'File editor',
+    'guide.description': 'Monaco file editor: chat and editing side by side (diff review, jump, outline)',
+  },
+}
+
+/** locale 服务的最小结构面（结构性探测，不 import 官方类型）。 */
+export interface LocaleLike {
+  register?: (ns: string, dicts: Record<string, Record<string, string>>) => unknown
+  bind?: (ns: string) => (key: string) => string
+}
+
+/** 翻译函数：键 → 当前语言文案（找不到时回落中文，再回落键本身）。 */
+export type Translate = (key: string) => string
+
+/**
+ * 取词条：先当前语言、再中文、最后键本身。
+ * @author ddj 2026年10月19号
+ * @param lang 语言 id
+ * @param key 词条键
+ * @returns 文案
+ */
+function lookup(lang: string, key: string): string {
+  return LOCALE_DICTS[lang]?.[key] ?? LOCALE_DICTS[LOCALE_FALLBACK]?.[key] ?? key
+}
+
+/**
+ * 生成不依赖 locale 服务的直读翻译函数（服务缺失/注册失败时使用）。
+ * @author ddj 2026年10月19号
+ * @param lang 语言 id
+ * @returns 翻译函数
+ */
+export function directTranslate(lang: string = LOCALE_FALLBACK): Translate {
+  return (key: string) => lookup(lang, key)
+}
+
+/**
+ * 注册本插件词典并返回翻译函数。
+ * 服务缺失、重复注册或 bind 抛错都不影响插件其余部分：一律回落直读词典。
+ * @author ddj 2026年10月19号
+ * @param ctx DSH 客户端上下文
+ * @returns 翻译函数（读取时才解析当前语言，可直接放进 slot label thunk）
+ */
+export function installLocale(ctx: { get: (name: string) => unknown }): Translate {
+  let service: LocaleLike | undefined
+  try {
+    service = ctx.get('locale') as LocaleLike | undefined
+  } catch {
+    // 服务缺失或探测抛错：后续一律按未命中处理。
+  }
+
+  // 注册失败（例如同名 ns 已被占）不应连带废掉 bind，故两段各自 try。
+  try {
+    if (service && typeof service.register === 'function') service.register(LOCALE_NS, LOCALE_DICTS)
+  } catch {
+    // 词典未注册成功：仍尝试 bind，最后还有直读词典兜底。
+  }
+
+  try {
+    if (service && typeof service.bind === 'function') {
+      const bound = service.bind(LOCALE_NS)
+      if (typeof bound === 'function') return (key: string) => bound(key)
+    }
+  } catch {
+    // bind 异常按未命中处理。
+  }
+
+  return directTranslate()
+}

package/src/client/mcpSessionState.ts

@@ -0,0 +1,108 @@
+/** Shared, read-only sidebar MCP polling. @author ddj 2026年10月20号 */
+import { rpc } from './rpc.js'
+import type { McpSessionStatus } from '../shared/mcp.js'
+
+export interface SessionMcpView { status?: McpSessionStatus; stale: boolean }
+type Snapshot = { sessions: McpSessionStatus[]; sampledAt: number }
+type FetchStatus = (signal: AbortSignal) => Promise<Snapshot>
+const unavailable: SessionMcpView = { stale: true }
+const inactive: SessionMcpView = { stale: false }
+
+/** One poller for all mounted row/hover consumers; never retains or activates sessions. */
+export class McpSessionState {
+  private views = new Map<string, SessionMcpView>()
+  private listeners = new Map<string, Set<() => void>>()
+  private timer?: ReturnType<typeof setTimeout>
+  private request?: AbortController
+  private epoch = 0
+  private stale = true
+  private disposed = false
+
+  /** @public @author ddj 2026年10月20号 @param fetchStatus Authenticated read-only query. @param page Visibility boundary, omitted for server tests. */
+  constructor(private readonly fetchStatus: FetchStatus, private readonly page?: Document) {}
+
+  /** @public @author ddj 2026年10月20号 @param sessionId Row identity. @returns Stable view until the next observation. */
+  get(sessionId: string): SessionMcpView { return this.views.get(sessionId) ?? (this.stale ? unavailable : inactive) }
+
+  /** @public @author ddj 2026年10月20号 @param sessionId Row identity. @param listener React invalidation. @returns Idempotent unsubscribe; the last consumer stops polling. */
+  subscribe(sessionId: string, listener: () => void): () => void {
+    if (this.disposed) return () => undefined
+    const first = this.listeners.size === 0
+    const listeners = this.listeners.get(sessionId) ?? new Set()
+    listeners.add(listener)
+    this.listeners.set(sessionId, listeners)
+    if (first) {
+      this.page?.addEventListener('visibilitychange', this.visibility)
+      void this.poll()
+    }
+    return () => {
+      listeners.delete(listener)
+      if (listeners.size === 0) this.listeners.delete(sessionId)
+      if (this.listeners.size === 0) this.pause()
+    }
+  }
+
+  /** @private @author ddj 2026年10月20号 Stops pending work when hidden; resuming never accepts an old response. */
+  private visibility = (): void => {
+    if (this.page?.hidden) this.invalidate()
+    else void this.poll()
+  }
+
+  /** @private @author ddj 2026年10月20号 Invalidates responses without allowing overlapping transport requests. */
+  private invalidate(): void {
+    this.epoch += 1
+    clearTimeout(this.timer)
+    this.timer = undefined
+    this.request?.abort()
+    this.publish(undefined)
+  }
+
+  /** @private @author ddj 2026年10月20号 Cleans listener lifetime as well as timers. */
+  private pause(): void {
+    this.page?.removeEventListener('visibilitychange', this.visibility)
+    this.invalidate()
+  }
+
+  /** @public @author ddj 2026年10月20号 Permanently disposes HMR-owned polling. */
+  dispose(): void { this.disposed = true; this.pause(); this.listeners.clear(); this.views.clear() }
+
+  /** @private @author ddj 2026年10月20号 @param snapshot Fresh ledger, or undefined to mark all previous observations stale. */
+  private publish(snapshot?: Snapshot): void {
+    this.stale = snapshot === undefined
+    if (snapshot) this.views = new Map(snapshot.sessions.map((status) => [status.sessionId, { status, stale: false }]))
+    else for (const [id, view] of this.views) this.views.set(id, { ...view, stale: true })
+    for (const listeners of this.listeners.values()) for (const listener of listeners) listener()
+  }
+
+  /** @private @author ddj 2026年10月20号 Queries once, with a 10-second deadline and a 2.5-second gap after settlement. */
+  private async poll(): Promise<void> {
+    if (this.disposed || this.request || !this.listeners.size || this.page?.hidden) return
+    const request = new AbortController()
+    const epoch = this.epoch
+    this.request = request
+    /** @author ddj 2026年10月20号 Marks overdue responses unusable even if a transport ignores cancellation. */
+    const expire = (): void => { request.abort(); if (epoch === this.epoch) this.publish(undefined) }
+    const deadline = setTimeout(expire, 10000)
+    try {
+      const snapshot = await this.fetchStatus(request.signal)
+      if (epoch === this.epoch && !request.signal.aborted) this.publish(snapshot)
+    } catch {
+      if (epoch === this.epoch) this.publish(undefined)
+    } finally {
+      clearTimeout(deadline)
+      this.request = undefined
+      if (!this.disposed && this.listeners.size && !this.page?.hidden) this.timer = setTimeout(() => { void this.poll() }, 2500)
+    }
+  }
+}
+
+/** @public @author ddj 2026年10月20号 @returns Browser-owned singleton per plugin apply; legacy Hosts fail safely as stale. */
+export function mcpSessionState(): McpSessionState {
+  /** @author ddj 2026年10月20号 @param signal Fetch lifetime. @returns Current in-memory host ledger. @throws RPC errors. */
+  const fetchStatus = async (signal: AbortSignal): Promise<Snapshot> => {
+    const result = await rpc('mcp.sessionSnapshot', {}, signal)
+    if (!result.ok) throw new Error('MCP 状态暂不可用')
+    return result
+  }
+  return new McpSessionState(fetchStatus, document)
+}

package/src/client/monaco/lsp/providers.ts

@@ -5,7 +5,8 @@
  * 交互层：edrv.goToDefinition（F12）/ edrv.findReferences（Shift+F12 / 右键）均走 Monaco 原生命令；
  * Ctrl+点击使用处交给原生；Lua 表枚举字段声明处改为打开引用 Peek，
  * 数据经 host 的 LSP RPC 提供（registerEditorOpener 接管 edrv:// 点击跳转）。
- * 作者 ddj 2026-08-27 / 2026-09-11
+ * 定义结果返回前预热目标 model，避免 hover 定义链接预览抛 "Model not found"。
+ * 作者 ddj 2026-08-27 / 2026-09-11 / 2026-10-20
  */
 import {
   pathOfModel, syncDoc, closeDoc, findDefinition, findReferences,
@@ -19,6 +20,7 @@ import {
   LSP_COMPLETION_KIND_NAMES, LSP_INSERT_TEXT_FORMAT_SNIPPET,
 } from '../../../shared/lsp.js'
 import { luaKeywordsAt, luaTypesAt, mergeKeywords } from './keywords.js'
+import { warmModelFor } from '../../state/modelWarmer.js'
 
 const LSP_LANGS = ['lua', 'csharp']
 
@@ -79,6 +81,31 @@ export function navTargetOf(selectionOrPosition) {
   return endColumn === undefined ? { line, column, endLine } : { line, column, endLine, endColumn }
 }
 
+/**
+ * 预热定义目标文件的 Monaco model（供 Ctrl+hover 定义链接预览使用）。
+ *
+ * 为什么需要：Monaco 的 GotoDefinitionAtPositionEditorContribution 在渲染定义链接预览时，
+ * 对目标 uri 调 `createModelReference` 后**只挂 then、没有 catch**；本插件的定义目标是
+ * 自造的 `edrv://` uri，目标文件若从未打开过就没有已注册 model，`createModelReference`
+ * 会 reject("Model not found") 变成未捕获的 promise 异常（弹到 Console）。
+ * 本 vendored Monaco 也没有 `registerTextModelContentProvider` 可惰性喂内容，故只能提前建模型。
+ *
+ * 只预热单一定义：多定义分支（`locations.length > 1`）Monaco 走列表、不调
+ * `createModelReference`，没必要读盘。预热纯属增强，任何异常都在此吞掉，
+ * 不得让跳转查询失败（F12 与 Ctrl+点击不依赖模型是否已建）。
+ * @author ddj 2026年10月20号
+ * @param locations findDefinition 的客户端结果（含 edrv uri）
+ */
+async function prewarmDefinitionTarget(locations) {
+  if (!Array.isArray(locations) || locations.length !== 1) return
+  try {
+    const target = lspUriToAbs(locations[0]?.uri)
+    if (target) await warmModelFor(target)
+  } catch (error) {
+    /* 预热失败静默降级：等价于本次 hover 不显示预览 */
+  }
+}
+
 /** 注册全部 Monaco LSP provider 与文档跟踪（幂等）。 */
 export function registerLspProviders(monaco) {
   if (registered) return
@@ -151,10 +178,12 @@ export function registerLspProviders(monaco) {
       },
     }),
     monaco.languages.registerDefinitionProvider(LSP_LANGS, {
-      provideDefinition: (model, position, token) => {
+      provideDefinition: async (model, position, token) => {
         const path = pathOfModel(model)
         if (!path) return []
-        return findDefinition(path, model.getValue(), position)
+        const locations = await findDefinition(path, model.getValue(), position)
+        await prewarmDefinitionTarget(locations)
+        return locations
       },
     }),
     monaco.languages.registerReferenceProvider(LSP_LANGS, {

package/src/client/officialSidebar.ts

@@ -286,8 +286,11 @@ export function installOfficial(options: {
   slots: SlotsLike
   renderTab: unknown
   guide: { title: () => string; description: () => string }
+  /** Tab 标题 thunk（缺省用内置中文常量；传入后由调用方按当前语言解析）。 */
+  title?: () => string
 }): (() => void) | null {
   const { tabs, service, slots, renderTab, guide } = options
+  const titleOf = typeof options.title === 'function' ? options.title : () => OFFICIAL_TAB_TITLE
   const open = (path: string | null, focusDiff: boolean): boolean => {
     try {
       // 官方语义：打开即展开侧栏；seat 未挂载（无会话画面）时抛错，降级其他打开器
@@ -305,7 +308,7 @@ export function installOfficial(options: {
       id: OFFICIAL_TAB_ID,
       kind: OFFICIAL_TAB_KIND,
       priority: 'extension',
-      title: () => OFFICIAL_TAB_TITLE,
+      title: () => titleOf(),
       guide: [{ order: 20, title: guide.title, description: guide.description }],
     })
   } catch (error) {