dsh-vscode-mode 0.11.0 → 0.13.0

package/src/shared/keybindings.ts

@@ -5,6 +5,8 @@
  * `|` 连接多个候选（任一命中即触发），如 `Alt+ArrowLeft|Ctrl+Alt+-`。
  * 约束：本模块被 host 与 client 两半共用，**禁止 import client 侧模块**（React/浏览器 API）。
  * 与 client/ui/commandCatalog 的一致性由 tests/commands.test.ts 断言兜底。
+ * 官方机制（2026-10）：SHORTCUT_PROFILES 描述各命令在官方 ctx.shortcuts 的 profile 默认键位
+ * （由 client 注册官方服务时使用）；chordToBinding/bindingToChord 负责插件弦与官方绑定互转。
  * 作者 ddj 2026年08月26号 / 2026年09月10号
  */
 
@@ -66,3 +68,257 @@ export function normalizeKeybindings(raw: unknown): Record<string, string> {
   }
   return out
 }
+
+//#region 官方 shortcuts 机制映射层（纯数据/纯函数，禁 import client 侧与官方包）
+
+/** 官方 shortcuts 服务的修饰符标记（'primary' = 桌面端按平台展开为 Ctrl/Cmd，web 同语义）。 */
+export type OfficialModifier = 'primary' | 'control' | 'alt' | 'shift' | 'meta'
+
+/** 官方绑定形状（物理 code + 修饰符；与 @deepseek-ai/dsh-client-shortcuts 绑定契约同构，鸭子类型）。 */
+export interface OfficialBinding {
+  code: string
+  modifiers: OfficialModifier[]
+  secondCode?: string
+}
+
+/** 官方 profile 键（desktop|web × macos|windows|linux）。 */
+export type ShortcutProfileKey =
+  | 'desktop:macos' | 'desktop:windows' | 'desktop:linux'
+  | 'web:macos' | 'web:windows' | 'web:linux'
+
+/** 命令 id → 各 profile 官方默认键位（缺 profile = 该端不绑定）。 */
+export type ShortcutProfiles = Partial<Record<ShortcutProfileKey, OfficialBinding>>
+
+/** 显示主键 → 官方物理 code 对照（官方 code 白名单：Key[A-Z]|Digit[0-9]|F1-24|具名键）。 */
+const DISPLAY_KEY_TO_CODE: Record<string, string> = {
+  '-': 'Minus', '=': 'Equal', '[': 'BracketLeft', ']': 'BracketRight',
+  ';': 'Semicolon', "'": 'Quote', ',': 'Comma', '.': 'Period',
+  '/': 'Slash', '\\': 'Backslash', '`': 'Backquote',
+  Enter: 'Enter', Tab: 'Tab', Backspace: 'Backspace', Delete: 'Delete',
+  Escape: 'Escape', Space: 'Space',
+  ArrowUp: 'ArrowUp', ArrowDown: 'ArrowDown', ArrowLeft: 'ArrowLeft', ArrowRight: 'ArrowRight',
+}
+
+/** 官方具名 code（非 Key/Digit/F 前缀且可回显的部分）。 */
+const NAMED_CODES = ['Enter', 'Tab', 'Backspace', 'Delete', 'Escape', 'Space',
+  'ArrowUp', 'ArrowDown', 'ArrowLeft', 'ArrowRight'] as const
+
+/** 官方 code → 显示主键（符号键反向对照）。 */
+const CODE_TO_DISPLAY_KEY: Record<string, string> = {
+  Minus: '-', Equal: '=', BracketLeft: '[', BracketRight: ']',
+  Semicolon: ';', Quote: "'", Comma: ',', Period: '.',
+  Slash: '/', Backslash: '\\', Backquote: '`',
+}
+
+/** 显示主键 → 官方 code（PageUp/PageDown/Home/End/Insert 等官方不支持 → null）。 */
+function keyToCode(key: string): string | null {
+  if (Object.hasOwn(DISPLAY_KEY_TO_CODE, key)) return DISPLAY_KEY_TO_CODE[key]
+  if (key.length === 1 && key >= 'a' && key <= 'z') return 'Key' + key.toUpperCase()
+  if (key.length === 1 && key >= 'A' && key <= 'Z') return 'Key' + key
+  if (key.length === 1 && key >= '0' && key <= '9') return 'Digit' + key
+  if (/^F([1-9]|1[0-9]|2[0-4])$/u.test(key)) return key
+  return null
+}
+
+/** 官方 code → 显示主键（不可回显 → null）。 */
+function codeToKey(code: string): string | null {
+  if (Object.hasOwn(CODE_TO_DISPLAY_KEY, code)) return CODE_TO_DISPLAY_KEY[code]
+  if (/^Key[A-Z]$/u.test(code)) return code.slice(3)
+  if (/^Digit[0-9]$/u.test(code)) return code.slice(5)
+  if (/^F([1-9]|1[0-9]|2[0-4])$/u.test(code)) return code
+  if ((NAMED_CODES as readonly string[]).includes(code)) return code
+  return null
+}
+
+/** 插件弦的修饰符 token → 官方修饰符（Ctrl 与 Cmd 同为 primary，与 matchEvent 的互认语义一致）。 */
+const CHORD_MODIFIER_TOKENS: Record<string, OfficialModifier> = {
+  ctrl: 'primary', control: 'primary', cmd: 'primary', meta: 'primary',
+  shift: 'shift', alt: 'alt',
+}
+
+/**
+ * 插件键位弦（单候选）→ 官方绑定。
+ * 不可表示的主键（PageUp/PageDown/Home/End/Insert 等）返回 null，调用方跳过。
+ * @author ddj 2026年10月
+ * @param chord 键位弦（如 `Ctrl+Alt+-` / `F9` / `Alt+ArrowLeft`）
+ * @returns 官方绑定或 null
+ */
+export function chordToBinding(chord: string): OfficialBinding | null {
+  const parts = String(chord ?? '').split('+').map((part) => part.trim()).filter(Boolean)
+  if (!parts.length) return null
+  const modifiers = new Set<OfficialModifier>()
+  let key = ''
+  for (const part of parts) {
+    const modifier = CHORD_MODIFIER_TOKENS[part.toLowerCase()]
+    if (modifier) {
+      modifiers.add(modifier)
+      continue
+    }
+    if (key) return null
+    key = part
+  }
+  if (!key) return null
+  if (key === ' ') key = 'Space'
+  else if (key.length === 1 && key >= 'a' && key <= 'z') key = key.toUpperCase()
+  const code = keyToCode(key)
+  return code === null ? null : { code, modifiers: [...modifiers] }
+}
+
+/**
+ * 官方绑定 → 可读键位弦，保留规范化后的 Control/Meta 物理区别。
+ * 官方目录展示优先使用官方 keys；此函数仅作为缺少展示字段时的回落。
+ * @author ddj 2026年09月28号
+ * @param binding 官方绑定
+ * @returns 插件弦（不可表示 → null）
+ */
+export function bindingToChord(binding: OfficialBinding): string | null {
+  if (!binding || typeof binding !== 'object') return null
+  const key = codeToKey(binding.code)
+  if (key === null) return null
+  let suffix = ''
+  if (binding.secondCode !== undefined) {
+    const secondKey = codeToKey(binding.secondCode)
+    if (secondKey === null) return null
+    suffix = '+' + secondKey
+  }
+  const parts: string[] = []
+  if (binding.modifiers.includes('primary') || binding.modifiers.includes('control')) parts.push('Ctrl')
+  if (binding.modifiers.includes('meta')) parts.push('Meta')
+  if (binding.modifiers.includes('shift')) parts.push('Shift')
+  if (binding.modifiers.includes('alt')) parts.push('Alt')
+  return [...parts, key + suffix].join('+')
+}
+
+/** 官方绑定字面量构造（表格可读性辅助）。 */
+function bind(code: string, modifiers: OfficialModifier[]): OfficialBinding {
+  return { code, modifiers }
+}
+
+/**
+ * 命令 id → 官方 profile 默认键位（与 KEYBINDING_DEFAULTS 一一对应；client 注册官方服务的数据源）。
+ * 取值约束（对齐官方 bindingIssue/isWebBindingAllowed 校验，错报会在注册时抛错）：
+ * - desktop:macos/windows：官方不做保留校验，用 VS Code 同款 chord；
+ * - desktop:linux / web:linux：Arrow*、裸 F 键、全 Shift、Ctrl+V/C/X/Z/Y/Q/H/A、Meta 均为保留键 → 不声明；
+ * - web:macos/windows：单修饰符组合不在白名单 → 用 primary+alt / primary+shift 变体（官方 ui-layout 同款）；
+ * - Ctrl+PageDown/PageUp 候选废弃（官方 code 白名单无 PageUp/PageDown）；
+ * - edrv.toggleSidebar 留空：Ctrl+B 与官方 sidebar.left.toggle（Mod+B）冲突，注册会抛错且冲突键互相阻断。
+ * @author ddj 2026年10月
+ */
+export const SHORTCUT_PROFILES: Record<string, ShortcutProfiles> = {
+  'edrv.toggleSidebar': {},
+  'edrv.save': {
+    'desktop:macos': bind('KeyS', ['primary']),
+    'desktop:windows': bind('KeyS', ['primary']),
+    'desktop:linux': bind('KeyS', ['primary']),
+  },
+  // 官方 workspace.files 已占用桌面 primary+P 和 Web primary+alt+P；插件 QuickOpen 使用非冲突组合。
+  'edrv.quickOpen': {
+    'desktop:macos': bind('KeyP', ['primary', 'alt']),
+    'desktop:windows': bind('KeyP', ['primary', 'alt']),
+    'desktop:linux': bind('KeyP', ['primary', 'alt']),
+    'web:macos': bind('KeyP', ['primary', 'alt', 'shift']),
+    'web:windows': bind('KeyP', ['primary', 'alt', 'shift']),
+  },
+  // 官方 session.fork 占用两种 Web primary+shift+F；加 Alt 避开联合目录冲突。
+  'edrv.searchInFiles': {
+    'desktop:macos': bind('KeyF', ['primary', 'shift']),
+    'desktop:windows': bind('KeyF', ['primary', 'shift']),
+    'desktop:linux': bind('KeyF', ['primary', 'shift']),
+    'web:macos': bind('KeyF', ['primary', 'alt', 'shift']),
+    'web:windows': bind('KeyF', ['primary', 'alt', 'shift']),
+  },
+  // Ctrl+Shift+V（primary+KeyV）在 linux 为保留键（官方 bindingIssue 不豁免 shift），desktop:linux 不声明
+  'edrv.toggleMarkdownPreview': {
+    'desktop:macos': bind('KeyV', ['primary', 'shift']),
+    'desktop:windows': bind('KeyV', ['primary', 'shift']),
+    'web:macos': bind('KeyV', ['primary', 'shift']),
+    'web:windows': bind('KeyV', ['primary', 'shift']),
+  },
+  // 导航历史：主候选 Alt+Arrow 在 linux/web 为保留或白名单外；web 取第二候选（Ctrl+Alt+- / Ctrl+Shift+-）
+  'edrv.navigateBack': {
+    'desktop:macos': bind('ArrowLeft', ['alt']),
+    'desktop:windows': bind('ArrowLeft', ['alt']),
+    'web:macos': bind('Minus', ['primary', 'alt']),
+    'web:windows': bind('Minus', ['primary', 'alt']),
+  },
+  'edrv.navigateForward': {
+    'desktop:macos': bind('ArrowRight', ['alt']),
+    'desktop:windows': bind('ArrowRight', ['alt']),
+    'web:macos': bind('Minus', ['primary', 'shift']),
+    'web:windows': bind('Minus', ['primary', 'shift']),
+  },
+  // 页签循环：Ctrl+PageDown/PageUp 候选官方不可表示，仅保留 Ctrl+Alt+Arrow 主候选
+  'edrv.nextTab': {
+    'desktop:macos': bind('ArrowRight', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowRight', ['primary', 'alt']),
+    'web:macos': bind('ArrowRight', ['primary', 'alt']),
+    'web:windows': bind('ArrowRight', ['primary', 'alt']),
+  },
+  'edrv.prevTab': {
+    'desktop:macos': bind('ArrowLeft', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowLeft', ['primary', 'alt']),
+    'web:macos': bind('ArrowLeft', ['primary', 'alt']),
+    'web:windows': bind('ArrowLeft', ['primary', 'alt']),
+  },
+  'edrv.goToLine': {
+    'desktop:macos': bind('KeyG', ['primary']),
+    'desktop:windows': bind('KeyG', ['primary']),
+    'desktop:linux': bind('KeyG', ['primary']),
+  },
+  'edrv.showCommands': {
+    'desktop:macos': bind('KeyP', ['primary', 'shift']),
+    'desktop:windows': bind('KeyP', ['primary', 'shift']),
+    'desktop:linux': bind('KeyP', ['primary', 'shift']),
+    'web:macos': bind('KeyP', ['primary', 'shift']),
+    'web:windows': bind('KeyP', ['primary', 'shift']),
+  },
+  'edrv.nextEditorRow': {
+    'desktop:macos': bind('ArrowDown', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowDown', ['primary', 'alt']),
+    'web:macos': bind('ArrowDown', ['primary', 'alt']),
+    'web:windows': bind('ArrowDown', ['primary', 'alt']),
+  },
+  'edrv.prevEditorRow': {
+    'desktop:macos': bind('ArrowUp', ['primary', 'alt']),
+    'desktop:windows': bind('ArrowUp', ['primary', 'alt']),
+    'web:macos': bind('ArrowUp', ['primary', 'alt']),
+    'web:windows': bind('ArrowUp', ['primary', 'alt']),
+  },
+  'edrv.addSelectionRef': {
+    'desktop:macos': bind('KeyU', ['primary']),
+    'desktop:windows': bind('KeyU', ['primary']),
+    'desktop:linux': bind('KeyU', ['primary']),
+  },
+  'edrv.closeTab': {
+    'desktop:macos': bind('F4', ['primary']),
+    'desktop:windows': bind('F4', ['primary']),
+    'desktop:linux': bind('F4', ['primary']),
+  },
+  // 调试 F 键：linux 判 modifier-required（裸 F/全 Shift），仅 desktop:macos/windows
+  'edrv.debugToggleBreakpoint': {
+    'desktop:macos': bind('F9', []),
+    'desktop:windows': bind('F9', []),
+  },
+  'edrv.debugStartContinue': {
+    'desktop:macos': bind('F5', []),
+    'desktop:windows': bind('F5', []),
+  },
+  'edrv.debugStepOver': {
+    'desktop:macos': bind('F10', []),
+    'desktop:windows': bind('F10', []),
+  },
+  'edrv.debugStepInto': {
+    'desktop:macos': bind('F11', []),
+    'desktop:windows': bind('F11', []),
+  },
+  'edrv.debugStepOut': {
+    'desktop:macos': bind('F11', ['shift']),
+    'desktop:windows': bind('F11', ['shift']),
+  },
+  'edrv.debugStop': {
+    'desktop:macos': bind('F5', ['shift']),
+    'desktop:windows': bind('F5', ['shift']),
+  },
+}
+
+//#endregion

package/src/shared/mcp.ts

@@ -1,7 +1,7 @@
 /** dsh-vscode-mode MCP 管理共享数据契约。作者 ddj 2026年08月22号 */
 
 export type MpcTransport = 'stdio' | 'streamable-http'
-export type MpcStatus = 'connected' | 'connecting' | 'error' | 'disabled'
+export type MpcStatus = 'connected' | 'connecting' | 'error' | 'disabled' | 'configured' | 'unverified'
 
 export interface MpcTool {
   name: string
@@ -18,6 +18,7 @@ export interface MpcConfig {
   url?: string
   headers?: Record<string, string>
   toolCallTimeoutMs?: number
+  maxInstructionBytes?: number
   failOnStartupError?: boolean
   reconnect?: Record<string, unknown>
 }
@@ -29,6 +30,8 @@ export interface MpcServer {
   transport: MpcTransport
   config: MpcConfig
   status: MpcStatus
+  /** Mounted official plugin fibers, not verified live connections. */
+  instanceCount?: number
   toolCount: number
   tools: MpcTool[]
   error?: string

package/src/shared/rpc.ts

@@ -22,6 +22,7 @@ import type { AiConfigPatch, AiConfigView, AiDirectoryView, AiInlineRequest, AiI
 import type { SvnAction, SvnAiPlan, SvnChangeEntry, SvnConflictArtifact, SvnDiffRevResult, SvnIgnoreItem, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry, SvnUpdatePoll, SvnUpdateResult, SvnUpdateState } from './svn.js'
 import type { DapAction, DapAdapterInfo, DapBreakpointAck, DapBreakpointInput, DapConfigSnippet, DapConfigSource, DapDebugConfig, DapFrameView, DapPhase, DapPollResult, DapProcessInfo, DapScopeView, DapVariableView } from './dap.js'
 import { DAP_ACTIONS } from './dap.js'
+import { appUrl } from './appUrl.js'
 import type { LoggerLevel } from './logger.js'
 
 /** webServer 精确路由。 */
@@ -133,7 +134,7 @@ export async function readBinaryPreview(
  */
 async function tryBinaryRead(args: RpcRequestMap['edrv.readBinary']): Promise<PreviewRead | null> {
   try {
-    const res = await fetch(RPC_PATH, {
+    const res = await fetch(appUrl(RPC_PATH), {
       method: 'POST',
       headers: { 'content-type': 'application/json' },
       body: JSON.stringify({ method: 'edrv.readBinary', args }),
@@ -382,7 +383,8 @@ export interface RpcRequestMap {
   'edrv.unity.install': { path: string }
   'edrv.externalStat': { path: string }
   'edrv.external.handoff': { paths: string[]; line?: number; column?: number }
-  'edrv.external.pending': {}
+  'edrv.external.pending': { clientId: string; busy?: boolean }
+  'edrv.external.ack': { token: string; clientId: string; leaseId: string; success: boolean; error?: string }
   'edrv.external.pendingState': { token: string; take?: boolean }
   'vscode.devFormGet': {}
   'vscode.devFormSet': { enabled: boolean; path?: string }
@@ -535,8 +537,9 @@ export interface RpcOkMap {
   'edrv.unity.install': { project: UnityProjectEntry }
   'edrv.externalStat': { kind: 'file' | 'directory' | 'missing' }
   'edrv.external.handoff': { clients: number; token: string }
-  'edrv.external.pending': { open: { paths: string[]; line?: number; column?: number } | null }
-  'edrv.external.pendingState': { delivered: boolean }
+  'edrv.external.pending': { open: { paths: string[]; line?: number; column?: number; token: string; leaseId: string } | null }
+  'edrv.external.ack': { accepted: boolean }
+  'edrv.external.pendingState': { delivered: boolean; completed?: boolean; error?: string }
   'vscode.devFormGet': { devForm: DevFormInfo }
   'vscode.devFormSet': { devForm: DevFormInfo; restart: boolean }
   'compat': { report: CompatReport }

package/src/shared/rules.ts

@@ -4,7 +4,10 @@
  * 作者 ddj 2026年09月03号
  */
 
-/** 规则作用域：用户规则（~/.dsh/rules）或项目规则（<工作区>/.dsh/rules）。 */
+/** 用户规则来源：当前 DSH_HOME 或系统用户目录的旧版 .dsh。 */
+export type UserRuleOrigin = 'current' | 'legacy'
+
+/** 规则作用域：用户规则（DSH_HOME/rules + ~/.dsh/rules）或项目规则（<工作区>/.dsh/rules）。 */
 export type RuleScope = 'user' | 'project'
 
 /** 规则生效类型（由 frontmatter 推导）：总是 / 自动（globs 命中时）/ 手动（仅索引）。 */
@@ -13,6 +16,8 @@ export type RuleType = 'always' | 'auto' | 'manual'
 /** 一条 .mdc 规则的元信息（列表行展示 + 注入语义所需的最小集）。 */
 export interface RuleInfo {
   scope: RuleScope
+  /** 用户规则的实际来源；项目规则不设置。 */
+  origin?: UserRuleOrigin
   /** 文件名（含 .mdc 后缀，不含路径）。 */
   file: string
   /** 绝对路径（host 解析，供展示与按需读取）。 */
@@ -48,6 +53,8 @@ export interface RuleSaveInput {
   scope: RuleScope
   /** project 必填：目标工作区绝对路径（须为 DSH 已注册 workspace）。 */
   workspacePath?: string
+  /** 缺省 current；仅用户规则可指定 legacy。 */
+  origin?: UserRuleOrigin
   file: string
   content: string
 }
@@ -56,5 +63,6 @@ export interface RuleSaveInput {
 export interface RuleRefInput {
   scope: RuleScope
   workspacePath?: string
+  origin?: UserRuleOrigin
   file: string
 }

package/src/shared/svn.ts

@@ -799,18 +799,15 @@ export function ignoreItemsOf(paths: readonly string[]): SvnIgnoreItem[] {
   return [...byDir.entries()].map(([dir, names]) => ({ dir, names }))
 }
 
-/** 深度分析投递口地址（host RPC 本地免鉴权；agent 用 shell 直接 POST）。 */
-const AGENT_SUBMIT_URL = 'http://127.0.0.1:3080/edrv/rpc'
-
 /**
  * 会话 agent 深度分析任务文本（混合通道 02-deep-session-prompt 修正版）。
  * 在**独立新会话**草稿箱填入后由用户发送；agent 自跑只读 `svn status` 取清单
  * （prompt 定长瘦身，不随变更数膨胀），借 codegraph/读文件/sub agent 深度分析，
- * 产出方案经免鉴权 RPC `svn.aiPlanSubmit` 投递回面板收件箱——确认与执行仍全部
+ * 产出方案经当前会话的 svn_plan_submit 工具投递回面板收件箱，确认与执行仍全部
  * 走面板（agent 禁写、只读放行）。
- * @author ddj 2026年09月23号
+ * @author ddj 2026年09月28号
  * @param wcRoot 工作副本根（取数指引内嵌）
- * @param sessionId 会话 id（投递命令内嵌；host 按它解析工作副本）
+ * @param sessionId 分析会话 id（仅作说明，不参与工具授权）
  * @returns 任务文本（定长 ~1KB：取数指引/分析要求/投递命令/硬约束）
  */
 export function buildAgentPrompt(wcRoot: string, sessionId: string): string {
@@ -838,8 +835,9 @@ export function buildAgentPrompt(wcRoot: string, sessionId: string): string {
     '3. 组名用简短英文、不以 - 开头；',
     '4. 只使用 `svn status` 实际返回的路径，绝不虚构或改写路径。',
     '',
-    '分析完成后，用 shell 执行下面的命令把方案投递回面板（把 <PLAN_JSON> 替换为方案 JSON）：',
-    'Invoke-RestMethod -Uri ' + AGENT_SUBMIT_URL + ' -Method Post -ContentType \'application/json\' -Body (@{ method = \'svn.aiPlanSubmit\'; args = @{ sessionId = \'' + sessionId + '\'; plan = <PLAN_JSON> } } | ConvertTo-Json -Depth 8)',
+    '分析完成后，调用 svn_plan_submit 工具，把方案 JSON 作为 plan 参数投递回面板。',
+    '工具只接收 { "plan": <PLAN_JSON> }，自动使用当前执行会话；不要传入其他 sessionId。',
+    '当前分析会话：' + sessionId + '。工具仅保存待审方案，不执行方案中的文件操作。',
     '',
     '投递成功会返回 { ok, accepted, dropped }；随后我会在面板弹窗中确认执行，你无需再做任何操作。',
   ].join('\n')

package/src/svnPlanTool.ts

@@ -0,0 +1,51 @@
+/** Session-bound SVN analysis result delivery. @author ddj 2026年09月28号 */
+import { loadHostModule } from './hostImport.js'
+import type { Ctx } from './store.js'
+import type { RpcHandler, RpcResult } from './shared/rpc.js'
+
+interface PlanArgs { plan: unknown }
+interface PlanExec { agent?: { session?: { id?: string } }; signal?: AbortSignal }
+type Submit = RpcHandler<'svn.aiPlanSubmit'>
+
+/**
+ * Build a result-only tool that derives ownership from the executing session.
+ * It cannot revert, commit, ignore, or select another session.
+ * @author ddj 2026年09月28号
+ * @param submit Existing validated plan inbox handler.
+ * @returns Definition options for the running Host's defineTool API.
+ */
+export function planToolOptions(submit: Submit) {
+  /** @author ddj 2026年09月28号 @param args Model plan. @param exec Owning execution context. @returns Validated inbox result. */
+  async function execute(args: PlanArgs, exec: PlanExec): Promise<RpcResult<'svn.aiPlanSubmit'>> {
+    const sessionId = exec.agent?.session?.id
+    if (!sessionId) return { ok: false, error: 'SVN 方案投递需要所属会话' }
+    if (exec.signal?.aborted) return { ok: false, error: 'SVN 方案投递已取消' }
+    return submit({ sessionId, plan: args.plan })
+  }
+  /** @author ddj 2026年09月28号 @param _args Request. @param result Inbox result. @returns Model-visible result. */
+  function render(_args: PlanArgs, result: RpcResult<'svn.aiPlanSubmit'>) {
+    return [{ type: 'text', text: JSON.stringify(result) }]
+  }
+  return {
+    name: 'svn_plan_submit',
+    description: 'Submit an SVN change-analysis plan to the current workspace review inbox. This only records the proposal; the user must confirm changes in VSCodeMode. It does not modify or commit files.',
+    parameters: { plan: { type: 'json', required: true, description: 'Analysis proposal with groups, reverts and ignores arrays, using paths from the current SVN working-copy status.' } },
+    output: { schema: { type: 'json' }, render },
+    isConcurrencySafe: false,
+    execute,
+  }
+}
+
+/**
+ * Register the SVN submission tool using the running Host API and lifecycle owner.
+ * @author ddj 2026年09月28号
+ * @param ctx Host plugin context owning the registration.
+ * @param submit Validated SVN inbox handler.
+ */
+export async function installPlanTool(ctx: Ctx, submit: Submit): Promise<void> {
+  const module = await loadHostModule('@deepseek-ai/dsh-tools') as { defineTool: (options: unknown) => unknown }
+  const definition = module.defineTool(planToolOptions(submit))
+  /** @author ddj 2026年09月28号 @returns Registration disposer owned by this plugin. */
+  function install(): () => void { return ctx.get('tools').register(definition) }
+  ctx.effect(install, 'vscode-mode:svn-plan-submit')
+}

package/src/unityBridge.ts

@@ -7,10 +7,14 @@
  * package.json name 不是本包 → 拒绝覆盖。纯路径构造与项目特征判定可单测。
  * 作者 ddj 2026-09-07
  */
-import { cp, mkdir, readFile, readdir, rm, writeFile } from 'node:fs/promises'
+import { cp, mkdir, readFile, readdir, rm, writeFile, rename } from 'node:fs/promises'
 import { basename, dirname, join, sep } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { dshHome, PLUGIN_ID } from './paths.js'
+import { randomUUID } from 'node:crypto'
+import { ensureOpenBridge } from './openBridge.js'
+import { checkOpenPath } from './openInbox.js'
+import type { Ctx } from './store.js'
 import { UNITY_PACKAGE_NAME } from './shared/integration.js'
 import type { UnityListPayload, UnityProjectEntry } from './shared/integration.js'
 
@@ -21,6 +25,8 @@ const PROJECTS_FILE = 'unity-projects.json'
 /** 包源目录相对插件包根的位置。 */
 const UNITY_DIR_NAME = 'unity'
 
+export interface UnityBridgeOpts { ctx: Ctx; baseUrl: string }
+
 /**
  * 包源目录（随插件包分发的 unity/com.dsh.editor 绝对路径）。
  * @author ddj 2026年09月07号
@@ -192,15 +198,17 @@ export async function unityRemove(rawPath: string, home = dshHome()): Promise<vo
  * @param moduleUrl 模块 URL（测试注入）
  * @returns 安装后项目状态
  */
-export async function unityInstall(rawPath: string, moduleUrl: string = import.meta.url): Promise<UnityProjectEntry> {
+export async function unityInstall(rawPath: string, moduleUrl: string = import.meta.url, bridge?: UnityBridgeOpts): Promise<UnityProjectEntry> {
   const root = normalizeUnityRoot(rawPath)
   const source = unitySourceDir(moduleUrl)
   const target = unityTargetOf(root)
   await validateInstallTarget(root, source, target)
+  const bridgeConfigPath = bridge ? await ensureOpenBridge(bridge.ctx, bridge.baseUrl) : undefined
   await rm(target, { recursive: true, force: true })
   await mkdir(join(target, '..'), { recursive: true })
   await cp(source, target, { recursive: true })
-  return unityEntryOf(root, moduleUrl)
+  if (bridgeConfigPath) await writeUnityHint(root, bridgeConfigPath)
+  return { ...(await unityEntryOf(root, moduleUrl)), bridgeConfigPath }
 }
 
 /**
@@ -232,3 +240,18 @@ async function validateInstallTarget(root: string, source: string, target: strin
   } catch { /* 解析失败按未知包处理 */ }
   if (name !== UNITY_PACKAGE_NAME) throw new Error('目标目录已存在且不是 DSH 包，拒绝覆盖：' + target)
 }
+
+/** @private @author ddj 2026年09月28号
+ * Bind a project's machine-local configuration to its selected profile bridge.
+ * @param root Validated Unity project root.
+ * @param configPath Absolute profile bridge INI path.
+ */
+async function writeUnityHint(root: string, configPath: string): Promise<void> {
+  const dir = join(root, 'UserSettings')
+  await mkdir(dir, { recursive: true })
+  await checkOpenPath(dir)
+  const target = join(dir, 'dsh-editor.ini')
+  const temporary = target + '.' + randomUUID() + '.tmp'
+  await writeFile(temporary, '[dsh]\nconfig=' + configPath + '\n', { flag: 'wx', mode: 0o600 })
+  try { await rename(temporary, target) } finally { await rm(temporary, { force: true }) }
+}