dsh-vscode-mode 0.15.9 → 0.17.0

package/src/client/ui/EditorView.ts

@@ -19,6 +19,7 @@ import { useOpenReceipt } from '../useOpenReceipt.js'
 import { acceptsLoad, receiptErrorFor, receiptPath, receiptReadyFor, receiptTabPath } from '../receiptState.js'
 import { bindPanelCommand } from '../panelCommands.js'
 import { dbg, isDebug, rpc } from '../rpc.js'
+import { refreshFeed, subscribeErrors, subscribeRecords } from '../state/recordsFeed.js'
 import { emitFileChanged, emitRefresh } from '../events.js'
 import { langOf, loadMonaco, snippetLanguageOf } from '../monaco/loader.js'
 import { bindEditActions, runEditAction } from '../monaco/editActions.js'
@@ -870,38 +871,43 @@ export function EditorView(props) {
     return true
   }
 
-  const refreshRecords = (skipStale) => {
-    if (!sessionId) return
+  /**
+   * 把共享订阅拿到的记录落进组件状态（内容一致时保持引用不变，避免整树重渲染）。
+   * @private @author ddj 2026年10月19号
+   * @param list 差异记录数组
+   */
+  const applyRecords = (list) => {
     // #region debug log
     const trace = isDebug()
-    const start = trace ? performance.now() : 0
+    const compareStart = trace ? performance.now() : 0
     // #endregion
-    rpc('edrv.list', { sessionId, ...(skipStale ? { skipStale: true } : {}) }).then((res) => {
+    const map = {}
+    for (const r of list) {
+      if (r.archived === true) continue
+      map[r.callId] = r
+    }
+    setRecords((prev) => {
+      const equal = sameRecords(prev, map)
       // #region debug log
-      const received = trace ? performance.now() : 0
-      // #endregion
-      if (!res || !res.ok || !Array.isArray(res.records)) return
-      const map = {}
-      for (const r of res.records) {
-        if (r.archived === true) continue
-        map[r.callId] = r
+      if (trace) {
+        try {
+          const compareMs = performance.now() - compareStart
+          if (compareMs > 20) dbg(sessionId, `[DEBUG diffList] count=${list.length} compareMs=${compareMs.toFixed(1)} changed=${!equal}`)
+        } catch (e) { /* 诊断不可影响轮询 */ }
       }
-      setRecords((prev) => {
-        // #region debug log
-        const compareStart = trace ? performance.now() : 0
-        // #endregion
-        const equal = sameRecords(prev, map)
-        // #region debug log
-        if (trace) {
-          try {
-            const compareMs = performance.now() - compareStart
-            if (compareMs > 20 || received - start > 100) dbg(sessionId, `[DEBUG diffList] count=${res.records.length} skipStale=${skipStale === true} rpcMs=${(received - start).toFixed(1)} compareMs=${compareMs.toFixed(1)} changed=${!equal}`)
-          } catch (e) { /* 诊断不可影响轮询 */ }
-        }
-        // #endregion
-        return equal ? prev : map
-      })
-    }).catch((e) => setError('list异常:' + String(e)))
+      // #endregion
+      return equal ? prev : map
+    })
+  }
+
+  /**
+   * 主动刷新一次差异记录（走会话级共享通道，同会话多消费方共享一次 RPC）。
+   * @private @author ddj 2026年10月19号
+   * @param skipStale 是否跳过过期判定
+   */
+  const refreshRecords = (skipStale) => {
+    if (!sessionId) return
+    void refreshFeed(sessionId, skipStale === true)
   }
 
   /**
@@ -1185,14 +1191,13 @@ export function EditorView(props) {
     })
   }
 
-  // 挂载轮询 + 事件订阅
+  // 挂载：接入会话级共享订阅（单定时器由 recordsFeed 持有，本组件不再自建 interval）
   React.useEffect(() => {
-    if (!sessionId) return
+    if (!sessionId) return undefined
+    const offRecords = subscribeRecords(sessionId, applyRecords)
+    const offErrors = subscribeErrors(sessionId, (message) => setError('list异常:' + message))
     refreshRecords()
-    const t = setInterval(refreshRecords, 5000)
-    const onRefresh = () => refreshRecords()
-    window.addEventListener('edrv:refresh', onRefresh)
-    return () => { clearInterval(t); window.removeEventListener('edrv:refresh', onRefresh) }
+    return () => { offRecords(); offErrors() }
   }, [sessionId])
 
   /**

package/src/client/ui/PerfSizeBadge.ts

@@ -1,12 +1,14 @@
 // @ts-nocheck
 /**
  * dsh-vscode-mode client — PerfSizeBadge：对话 header 会话体积指示器。
- * 5s 轮询当前会话持久化体积（host 仅 stat，近零成本），≥1MB 显示、超阈值变色，
+ * 定时器复用 state/recordsFeed.ts 的会话级心跳（单会话只保留 1 个定时器），
+ * 轮询当前会话持久化体积（host 仅 stat，近零成本），≥1MB 显示、超阈值变色，
  * 引导"一次任务一个短会话"：会话过大时建议 /compact 或新开会话。
  * 作者 ddj 2026-09-02
  */
 import React from 'react'
 import { rpc } from '../rpc.js'
+import { subscribeTick } from '../state/recordsFeed.js'
 
 /** 软阈值：≥ 此值琥珀色（默认 2MB）。 */
 const SOFT = 2 * 1024 * 1024
@@ -38,10 +40,11 @@ export function PerfSizeBadge(props) {
   }, [sessionId, sessions])
 
   React.useEffect(() => {
+    if (!sessionId) return undefined
     load()
-    const t = setInterval(load, 5000)
-    return () => { clearInterval(t) }
-  }, [load])
+    // 共享心跳：recordsFeed 每周期回调一次，避免本组件再自建 setInterval。
+    return subscribeTick(sessionId, load)
+  }, [load, sessionId])
 
   if (!size || size < SHOW_MIN) return null
   const label = size >= 1024 * 1024 ? (size / (1024 * 1024)).toFixed(1) + 'MB' : Math.round(size / 1024) + 'KB'

package/src/client/ui/PluginDetailSection.ts

@@ -0,0 +1,82 @@
+// @ts-nocheck
+/**
+ * dsh-vscode-mode client — 官方插件管理器详情页的只读状态段。
+ * 挂在 DSH 0.2.1 新增的 `plugins.detail.section`（list / root）扩展位上，
+ * 只在「本插件自己」的详情页渲染，其余插件页返回 null。
+ * 作者 ddj 2026年10月19号
+ */
+import React from 'react'
+import { rpc } from '../rpc.js'
+
+/** 本插件标识（与 package.json name / bundle 行 id 一致）。 */
+export const SELF_ID = 'dsh-vscode-mode'
+
+/**
+ * 判断详情页 subject 是否指向本插件。
+ * 官方有两种形状：官方内置项 `{kind:'item', id}`、安装包 `{kind:'bundle', pkg:{name}}`。
+ * @author ddj 2026年10月19号
+ * @param subject 详情页主题
+ * @returns 是否为本插件
+ */
+export function isSelfSubject(subject) {
+  if (!subject || typeof subject !== 'object') return false
+  if (subject.kind === 'item') return subject.id === SELF_ID
+  if (subject.kind === 'bundle') return subject.pkg?.name === SELF_ID
+  return false
+}
+
+/**
+ * 把适配项列表压成「正常 / 未生效」计数文案。
+ * @author ddj 2026年10月19号
+ * @param list 适配项数组
+ * @returns 计数文案
+ */
+function countText(list) {
+  const items = Array.isArray(list) ? list : []
+  const ok = items.filter((item) => item?.active === true).length
+  return ok + ' / ' + items.length + ' 项生效'
+}
+
+/**
+ * 插件详情页的只读状态段。
+ * @author ddj 2026年10月19号
+ * @param props DSH 注入的 { subject }
+ * @returns 状态段元素或 null（非本插件页）
+ */
+export function PluginDetailSection(props) {
+  const subject = props?.subject
+  const isSelf = isSelfSubject(subject)
+  const [report, setReport] = React.useState(null)
+
+  React.useEffect(() => {
+    if (!isSelf) return undefined
+    let alive = true
+    rpc('compat', {}).then((result) => {
+      if (!alive || !result || !result.ok) return
+      setReport(result.report ?? null)
+    }).catch(() => { /* 状态段属锦上添花，取不到就不显示 */ })
+    return () => { alive = false }
+  }, [isSelf])
+
+  if (!isSelf) return null
+
+  const row = (name, note) => React.createElement('div', { key: name, className: 'vsm-compat-item ok' },
+    React.createElement('span', { className: 'vsm-compat-name' }, name),
+    React.createElement('span', { className: 'vsm-compat-note' }, note),
+  )
+
+  const versionText = report?.dshVersion ? 'DSH ' + report.dshVersion : '未探测到 DSH 版本'
+  const pluginText = report?.pluginVersion ? '插件 ' + report.pluginVersion : '插件版本未上报'
+  const warnCount = Array.isArray(report?.warnings) ? report.warnings.length : 0
+
+  return React.createElement('section', { className: 'vsm-panel', 'data-edrv-plugin-status': '1' },
+    React.createElement('h3', { className: 'vsm-panel-title' }, 'VSCodeMode 运行状态'),
+    React.createElement('div', { className: 'vsm-panel-body' },
+      row('版本', versionText + ' · ' + pluginText),
+      row('版本适配', countText(report?.adapters)),
+      row('外部插件与服务', countText(report?.external)),
+      row('护栏', countText(report?.guards)),
+      row('兼容性警告', warnCount ? warnCount + ' 条（设置页「兼容性」可查看详情）' : '未检测到'),
+    ),
+  )
+}

package/src/dap/discovery.ts

@@ -4,7 +4,8 @@
  * ~/.vscode-server/extensions、插件扩展目录），读各扩展 package.json 的
  * contributes.debuggers[] 声明，解析为 DapAdapterDecl：
  * - program 按平台取 windows/linux/osx 覆盖，相对扩展根解析；
- * - runtime='node' → 由 node 跑 js 入口；无 runtime → program 即可执行（args 为清单声明）；
+ * - runtime='node' → 由 node 跑 js 入口；runtime='dotnet' → 由 dotnet 跑 dll 入口；
+ *   无 runtime → program 即可执行（args 为清单声明）；
  * - 同 type 多扩展并存 → 按「清单版本降序(numeric) → 路径升序」取唯一（与 LSP 候选口径一致）；
  * - 入口不存在 / runtime 不支持 → available=false + reason（如 DotRush 按需下载的 clrdbg，
  *   诚实标注不假成功，调用方据此在下拉置灰并提示原因）。
@@ -128,12 +129,13 @@ function declOf(extDir: string, entry: DebuggerEntry): DapAdapterDecl | null {
   const languages = stringsOf(entry.languages)
   const resolved = resolveProgram(extDir, entry)
   const runtime = typeof entry.runtime === 'string' && entry.runtime ? entry.runtime : undefined
-  const runtimeBad = runtime !== undefined && runtime !== 'node'
+  // node = 扩展 js 入口；dotnet = dotnet 承载的 dll（如 DotRush monodbg），provider 层解析 dotnet 路径
+  const runtimeBad = runtime !== undefined && runtime !== 'node' && runtime !== 'dotnet'
   const available = resolved.available && !runtimeBad
   const reason = !resolved.available
     ? resolved.reason
     : runtimeBad
-      ? '暂不支持运行时 "' + runtime + '"（仅支持 node 与原生可执行）'
+      ? '暂不支持运行时 "' + runtime + '"（仅支持 node、dotnet 与原生可执行）'
       : undefined
   return {
     type,

package/src/dap/provider.ts

@@ -2,12 +2,17 @@
  * dsh-vscode-mode host — 调试适配器规格解析：按调试类型从扩展清单声明（discovery）
  * 解析 spawn 规格，通用不限定语言：
  * - runtime='node' → node 跑 js 入口（emmylua 形态，等价旧 process.execPath 硬编码）；
+ * - runtime='dotnet' → dotnet 跑 dll 入口（DotRush monodbg 形态；按 dll runtimeconfig
+ *   要求的运行时大版本找满足的 dotnet，对齐 LSP 侧 dotrushLaunch 口径）；
  * - 无 runtime → program 即原生可执行（clrdbg/monodbg 形态，args 为清单声明如 --interpreter=vscode）；
  * - 其它 runtime 明确不支持（decl.available=false 带原因，不做假启动）。
  * 旧版仅探测 tangzx.emmylua 两型（attach/new），由清单驱动后自然覆盖并扩展到任意适配器。
  * 作者 ddj 2026年09月29号 / 2026年09月21号
  */
 import { debuggerDecls } from './discovery.js'
+import { dirname, join } from 'node:path'
+import { existsSync } from 'node:fs'
+import { dotnetWithRuntime, findDotnet, runtimeMajorOf } from '../lsp/providers.js'
 
 /** 适配器启动规格（spawn 参数）。 */
 export interface DapAdapterSpec {
@@ -42,8 +47,29 @@ export function resolveAdapterSpec(type: string, force = false, home?: string):
   if (decl.runtime === 'node') {
     return { ...base, command: process.execPath, args: [decl.program, ...decl.args] }
   }
+  if (decl.runtime === 'dotnet') {
+    const dotnet = dotnetLaunch(decl.extensionPath, decl.program)
+    if (!dotnet) return null
+    return { ...base, command: dotnet, args: [decl.program, ...decl.args] }
+  }
   if (!decl.runtime) {
     return { ...base, command: decl.program, args: [...decl.args] }
   }
   return null
 }
+
+/**
+ * 为 dotnet 型适配器找启动用 dotnet：优先扩展内置 SDK，其次满足 dll runtimeconfig
+ * 要求的运行时大版本，兜底任意 dotnet（对齐 LSP 侧 dotrushLaunch 口径）。
+ * @author ddj 2026年10月19号
+ * @param extensionPath 扩展根目录
+ * @param program 适配器 dll 绝对路径
+ * @returns dotnet 可执行路径；找不到满足条件的返回 null
+ */
+function dotnetLaunch(extensionPath: string, program: string): string | null {
+  const sdkDotnet = join(extensionPath, 'extension', 'Sdk', 'dotnet' + (process.platform === 'win32' ? '.exe' : ''))
+  if (existsSync(sdkDotnet)) return sdkDotnet
+  const major = runtimeMajorOf(dirname(program))
+  if (major !== null) return dotnetWithRuntime(major) ?? findDotnet()
+  return findDotnet()
+}

package/src/dshVersion.ts

@@ -84,14 +84,16 @@ export function inDshRange(version: DshVersion | null | undefined, range: DshRan
 
 /**
  * 版本线标签：报告与文档展示版本归属；不可解析返回 '未知'。
- * 逐线自新到旧匹配，先命中先返回；仅已静态审计的 0.2.0-rc.1/rc.2 精确标记。
- * @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号 / 2026年09月29号 / 2026年10月08号
+ * 逐线自新到旧匹配，先命中先返回；仅已静态审计的 0.2.0-rc.1/rc.2、0.2.1-rc.2 精确标记。
+ * @author ddj 2026年09月02号 / 2026年09月18号 / 2026年09月22号 / 2026年09月29号 / 2026年10月08号 / 2026年10月19号
  * @param input 版本串（如 '0.1.6-alpha.2'）
  * @returns 版本线标签
  */
 export function familyLabel(input: string): string {
   const version = parseDshVersion(input)
   if (!version) return '未知'
+  if (inDshRange(version, { from: '0.2.1-rc.2', to: '0.2.1-rc.2' })) return '0.2.1-rc.2（设置=profile Config；workingDirectory 投影跟随 cd；plugins.detail 扩展位；按能力探测）'
+  if (inDshRange(version, { from: '0.2.1-0', to: '0.2.1' })) return '0.2.1 线（rc.2 已逐版适配，其余按能力探测）'
   if (inDshRange(version, { from: '0.2.0-rc.2', to: '0.2.0-rc.2' })) return '0.2.0-rc.2（设置=profile Config；按能力探测）'
   if (inDshRange(version, { from: '0.2.0-rc.1', to: '0.2.0-rc.1' })) return '0.2.0-rc.1（设置=profile Config；按能力探测）'
   if (inDshRange(version, { from: '0.2.0-0' })) return '0.2.0 及更新（除 rc.1/rc.2 外未经逐版适配；按能力探测）'

package/src/fileVersions.ts

@@ -20,7 +20,7 @@
  */
 import type { FileVersionItem } from './shared/rpc.js'
 import type { Ctx } from './store.js'
-import { cwdOf, sessionOf } from './registry.js'
+import { cwdOfSession, sessionOf } from './registry.js'
 import { invalidateIndex } from './treeIndex.js'
 import { log } from './log.js'
 
@@ -150,7 +150,7 @@ export function createFileVersions(ctx: Ctx): FileVersions {
       .slice(0, MAX_PATHS)
     if (!fs || !paths.length) return { ok: true, items: [] }
     const session = sessionOf(ctx, args.sessionId)
-    const cwd = cwdOf(session)
+    const cwd = cwdOfSession(ctx, session)
     const items: FileVersionItem[] = []
     for (const path of paths) items.push(await observe(fs, cwd, path))
     return { ok: true, items }

package/src/lsp/providers.ts

@@ -398,8 +398,8 @@ export function resolveLuaProvider(manual?: { command?: string; path?: string },
 }
 
 /**
- * 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；Roslyn dll 需 dotnet；
- * DotRush 需满足其运行时的 dotnet；或 OmniSharp）。
+ * 解析 C# provider（优先级：手动 > 扩展源 > 自动发现；DotRush 优先——自带 sln 加载与
+ * 反编译跳转；Roslyn dll 需 dotnet，但无 C# Dev Kit 时不加载项目；或 OmniSharp）。
  * @author ddj 2026年08月27号
  * @param manual 手动配置
  * @param home DSH home（缺省真实；测试可注入临时目录）
@@ -416,9 +416,10 @@ export function resolveCSharpProvider(manual?: { command?: string; path?: string
     // SDK 环境注入：runtime-only 的 dotnet 会导致 MSBuild 求值/restore 退化
     const sdkRoot = findSdkRoot()
     const msbuildEnv = sdkRoot ? sdkEnvOf(sdkRoot) : undefined
-    if (discovered.roslynDll && discovered.dotnet) {
-      return { ...base, kind: 'discover', argv: [discovered.dotnet, discovered.roslynDll, '--stdio'], env: msbuildEnv, ready: true }
-    }
+    // DotRush 优先：其服务器从 cwd 自动发现 sln 并自行加载（restore/compile/索引），
+    // 元数据符号可跳转反编译源码（实测 GameObject.Find → _decompiled_/UnityEngine.GameObject.cs）。
+    // Roslyn（ms-dotnettools.csharp）依赖 C# Dev Kit 的 serviceBroker 加载 sln；
+    // 无 Dev Kit 时即使发 solution/open 也不加载项目，references 不跨文件、元数据 definition 全空（实测 2026-10-19）。
     let dotrushReason: string | null = null
     let provisionMajor: number | undefined
     if (discovered.dotrushDll) {
@@ -430,6 +431,9 @@ export function resolveCSharpProvider(manual?: { command?: string; path?: string
       dotrushReason = launch.reason
       provisionMajor = major ?? undefined
     }
+    if (discovered.roslynDll && discovered.dotnet) {
+      return { ...base, kind: 'discover', argv: [discovered.dotnet, discovered.roslynDll, '--stdio'], env: msbuildEnv, ready: true }
+    }
     if (discovered.omnisharpExe) {
       return { ...base, kind: 'discover', argv: [discovered.omnisharpExe, '--stdio'], ready: true }
     }

package/src/lsp/rpc.ts

@@ -7,7 +7,7 @@
  */
 import type { Ctx } from '../store.js'
 import { searchRoot } from '../search/ripgrep.js'
-import { sessionOf, cwdOf } from '../registry.js'
+import { cwdOfSession, sessionOf } from '../registry.js'
 import { resolveProviderSpec, langOfPath, configFromPlugin, mergeConfig, sanitizeLang, LSP_LANGUAGES, type LspConfig, type LspLangConfig } from './config.js'
 import { clearProviderCache, candidatesFor } from './providers.js'
 import { capCompletions } from './completionCap.js'
@@ -154,7 +154,7 @@ export function createLspRpc(deps: LspRpcDeps): { handlers: Partial<RpcHandlerMa
   const rootOf = async (sessionId: string | undefined): Promise<{ root: string; sessionId: string } | { err: string }> => {
     const session = sessionOf(ctx, sessionId)
     if (!session) return { err: SESSION_MISSING_ERROR }
-    const cwd = cwdOf(session)
+    const cwd = cwdOfSession(ctx, session)
     if (!cwd) return { err: SESSION_NO_WORKSPACE_ERROR }
     try {
       const root = await searchRoot(ctx, session)

package/src/lsp/server.ts

@@ -8,7 +8,8 @@ import { spawnServer, type Transport } from './transport.js'
 import { createLspClient, type LspClient } from './client.js'
 import { pathToFileUri, toWorkspacePath, isAbsolutePath, fileUriToPath } from './uri.js'
 import { deriveDefinitionFromLocations, deriveCrossFileDeclaration, isMisresolvedSameFileUsage } from './derive.js'
-import { readFile } from 'node:fs/promises'
+import { readFile, readdir } from 'node:fs/promises'
+import { join } from 'node:path'
 import type { LspProviderSpec } from './providers.js'
 import { LSP_SEMANTIC_TOKEN_MODIFIERS, LSP_SEMANTIC_TOKEN_TYPES } from '../shared/lsp.js'
 import type {
@@ -61,6 +62,26 @@ interface OpenDoc {
 const RESTARTABLE = true
 const MAX_DOC_VERSION = 2147483647
 
+/**
+ * 找工作区根目录下的第一个 .sln（字典序）。
+ *
+ * 背景：Roslyn LSP 启动后若收不到 solution/project 通知，会停留在「杂项文件」模式——
+ * 工作区内自有符号可解析，但 Unity 引擎程序集 / NuGet 包等元数据符号的
+ * definition/hover 一律返回空（实测 2026-10-16，GameObject.Find 全空）。
+ * 需在握手后发 Roslyn 专有 `solution/open` 通知加载项目上下文。
+ * @author ddj 2026年10月19号
+ * @param root 工作区根（绝对路径）
+ * @returns sln 绝对路径；根目录无 sln 返回 null
+ */
+async function findSolutionFile(root: string): Promise<string | null> {
+  try {
+    const names = (await readdir(root)).filter((name) => name.toLowerCase().endsWith('.sln')).sort()
+    return names[0] ? join(root, names[0]) : null
+  } catch {
+    return null
+  }
+}
+
 /**
  * 使用合法、递增的 Int32 文档版本；旧客户端的毫秒时间戳不能直发给 Roslyn。
  * @author ddj 2026年09月24号
@@ -320,6 +341,10 @@ export function createLspServer(spec: LspProviderSpec, root: string, languageId:
         // 对不认识的配置段按协议忽略，均安全
         if (languageId === 'csharp') {
           client.notify('workspace/didChangeConfiguration', { settings: { dotrush: { roslyn: {} } } })
+          // Roslyn 专有：加载解决方案后元数据符号（引擎/NuGet 程序集）才可跳转；
+          // 未知通知对其它 C# 服务器按协议安全忽略。无 sln 的纯脚本项目静默跳过。
+          const slnPath = await findSolutionFile(root)
+          if (slnPath) client.notify('solution/open', { solution: pathToFileUri(slnPath) })
         }
         capabilities = caps
         return true

package/src/mcpRuntime.ts

@@ -6,6 +6,7 @@ import { matchWorkspace } from './mcpIsolation.js'
 import { listProjects, projectEntryId, reconcileProject } from './mcpProject.js'
 import type { MpcConfig, MpcServer } from './shared/mcp.js'
 import type { Ctx } from './store.js'
+import { cwdOfSession } from './store.js'
 
 export type ProjectDef = { config: MpcConfig; enabled: boolean }
 type Instance = { fiber?: any; key: string; path: string; error?: string; stopping?: Promise<void> }
@@ -76,7 +77,7 @@ export class McpRuntime {
    */
   workspace(agent: any): string | undefined {
     const paths = (this.ctx.get('workspaceRegistry')?.list?.() ?? []).map((ws: { path: string }) => ws.path)
-    return matchWorkspace(agent?.session?.header?.cwd, paths)
+    return matchWorkspace(cwdOfSession(this.ctx, agent?.session) ?? undefined, paths)
   }
 
   /**

package/src/registry.ts

@@ -5,7 +5,7 @@
  */
 import type { DiffRecord } from './shared/types.js'
 import type { Ctx, Session } from './store.js'
-import { loadBucket } from './store.js'
+import { cwdOfSession, loadBucket } from './store.js'
 
 /** cwd → 记录桶（内存缓存；随会话销毁清理）。 */
 export type Registry = Map<string, Map<string, DiffRecord>>
@@ -19,7 +19,20 @@ export function sessionOf(ctx: Ctx, sessionId?: string): Session | undefined {
   return live.length === 1 ? live[0] : undefined
 }
 
-/** 会话工作区 cwd。 */
+/**
+ * 会话工作区 cwd（跟随会话内 cd；服务缺失时回落 header.cwd）。
+ * 定义在 store.ts 以避免 registry ↔ store 循环依赖，此处仅转出为会话助手入口。
+ * @author ddj 2026年10月19号
+ */
+export { cwdOfSession }
+
+/**
+ * 会话头部的原始 cwd（不跟随 cd）。仅用于会话销毁等无上下文场景：
+ * 此时投影可能已随会话卸载，读 header 才能保证拿到建会话时的目录。
+ * @author ddj 2026年10月19号
+ * @param session 目标会话
+ * @returns 绝对路径或 null
+ */
 export function cwdOf(session: Session | undefined): string | null {
   return session?.header?.cwd ?? null
 }

package/src/rpc.ts

@@ -25,7 +25,7 @@ import { archiveEntryFor, markDecision, recordResolved, reconstructOriginal } fr
 import { clearRevertState, listArchives, pageArchives, readArchives, revertState, setRevertState, startReverts } from './archiveDb.js'
 import { log } from './log.js'
 import type { Registry } from './registry.js'
-import { bucketOf, cwdOf, sessionOf } from './registry.js'
+import { bucketOf, cwdOfSession, sessionOf } from './registry.js'
 import type { SearchOrchestrator } from './search/orchestrator.js'
 import { newSearcher } from './search/orchestrator.js'
 import type { ContentSearcher } from './search/content.js'
@@ -100,7 +100,7 @@ async function requireSession(ctx: Ctx, sessionId: string | undefined): Promise<
 > {
   const session = sessionOf(ctx, sessionId)
   if (!session) return { err: SESSION_MISSING_ERROR }
-  const cwd = cwdOf(session)
+  const cwd = cwdOfSession(ctx, session)
   if (!cwd) return { err: SESSION_NO_WORKSPACE_ERROR }
   return { session, cwd }
 }

package/src/rules.ts

@@ -16,6 +16,7 @@ import { join, resolve } from 'node:path'
 import { dshHome } from './paths.js'
 import type { RuleInfo, RuleProject, RuleRefInput, RuleScope, RuleSaveInput, UserRuleOrigin } from './shared/rules.js'
 import type { Ctx } from './store.js'
+import { cwdOfSession } from './store.js'
 
 // --region 常量与目录定位
 /** 规则文件名白名单：字母数字开头，仅字母数字点横下划线，.mdc 后缀（天然拒绝路径分隔符）。 */
@@ -550,13 +551,17 @@ export function readUserRulesSync(dirs = userRuleDirs()): LoadedRule[] {
   return mergeUserRules(current, legacy, (rule) => rule.info.file)
 }
 
-/** 从装配上下文解析会话工作区 cwd（agent.id → sessions → header.cwd；缺链返回 null）。 */
+/**
+ * 从装配上下文解析会话工作区 cwd（agent.id → sessions → 当前目录；缺链返回 null）。
+ * @author ddj 2026年10月19号
+ * @param ctx DSH 上下文
+ * @param asm 装配上下文（含 agent.id）
+ * @returns 项目规则根的绝对路径或 null
+ */
 function cwdFromAssemble(ctx: Ctx, asm: { agent?: { id?: unknown } } | undefined): string | null {
   const id = asm?.agent?.id
   if (typeof id !== 'string' || !id) return null
-  const session = ctx.get('sessions')?.get?.(id)
-  const cwd = session?.header?.cwd
-  return typeof cwd === 'string' && cwd ? cwd : null
+  return cwdOfSession(ctx, ctx.get('sessions')?.get?.(id))
 }
 
 /**

package/src/search/fallback.ts

@@ -4,7 +4,7 @@
  * 作者 ddj 2026年08月24号
  */
 import type { Ctx, Session } from '../store.js'
-import { policyOf } from '../store.js'
+import { cwdOfSession, policyOf } from '../store.js'
 import { pathText, pathMatch, prepareQuery } from './query.js'
 import type { PreparedQuery, WorkspaceSearchInput, WorkspaceSearchProvider, WorkspaceSearchResult } from './types.js'
 
@@ -61,7 +61,7 @@ export async function searchFallback(input: WorkspaceSearchInput): Promise<Works
   const fs = input.ctx.get('fs') as SearchFs | undefined
   if (!fs) throw new Error('缺少 fs')
   const policy = policyOf(input.ctx, input.session)
-  const cwd = input.session?.header?.cwd
+  const cwd = cwdOfSession(input.ctx, input.session)
   const rootTarget = await fs.resolve(policy?.workspaceRoot ?? '.', cwd ? { cwd, signal: input.signal } : { signal: input.signal })
   const signal = input.signal ?? new AbortController().signal
   const files: string[] = []

package/src/search/ripgrep.ts

@@ -7,7 +7,7 @@ import { existsSync } from 'node:fs'
 import { join } from 'node:path'
 import { createRequire } from 'node:module'
 import type { Ctx, Session } from '../store.js'
-import { policyOf } from '../store.js'
+import { cwdOfSession, policyOf } from '../store.js'
 import { prepareQuery, pathText } from './query.js'
 import type { WorkspaceSearchInput, WorkspaceSearchProvider, WorkspaceSearchResult } from './types.js'
 
@@ -127,7 +127,7 @@ export async function searchRoot(ctx: Ctx, session: Session): Promise<string> {
   const fs = ctx.get('fs')
   if (!fs) throw new Error('缺少 fs')
   const policy = policyOf(ctx, session)
-  const cwd = session?.header?.cwd
+  const cwd = cwdOfSession(ctx, session)
   const rootTarget = await fs.resolve(policy?.workspaceRoot ?? '.', cwd ? { cwd } : {})
   return fs.processPath(rootTarget)
 }

package/src/store.ts

@@ -33,10 +33,35 @@ export function policyOf(ctx: Ctx, session: Session | undefined): any {
   return session ? svc.resolve({ session }) : svc.resolve()
 }
 
+/**
+ * 读取会话当前工作目录：优先 workingDirectory 投影（DSH 0.2.1 起支持会话内 cd），
+ * 服务缺失或投影未就绪时回落到 header.cwd（会话创建时的原始目录）。
+ * 服务一律可选探测：不得写入模块 inject，否则旧版 DSH 会停等一个不存在的服务。
+ * @author ddj 2026年10月19号
+ * @param ctx DSH 上下文（用于可选探测 workingDirectory 服务）
+ * @param session 目标会话
+ * @returns 绝对路径；无法确定时 null
+ */
+export function cwdOfSession(ctx: Ctx, session: Session | undefined): string | null {
+  const headerCwd = session?.header?.cwd
+  const fallback = typeof headerCwd === 'string' && headerCwd ? headerCwd : null
+  if (!session) return null
+
+  const service = ctx?.get?.('workingDirectory')
+  if (!service || typeof service.get !== 'function') return fallback
+  try {
+    const current = service.get(session)
+    return typeof current === 'string' && current ? current : fallback
+  } catch {
+    // 会话已销毁或投影缺失：回落原始目录，不让新能力变成新的故障点
+    return fallback
+  }
+}
+
 /** 按会话 cwd 解析目标路径。 */
 export async function resolveTarget(ctx: Ctx, session: Session | undefined, path: string): Promise<string> {
   const fs = ctx.get('fs')
-  const cwd = session?.header?.cwd
+  const cwd = cwdOfSession(ctx, session)
   return fs.resolve(path, cwd ? { cwd } : {})
 }
 

package/src/svn.ts

@@ -10,7 +10,7 @@ import { readdir, stat } from 'node:fs/promises'
 import { basename, dirname, isAbsolute, join, relative, resolve } from 'node:path'
 import { tmpdir } from 'node:os'
 import type { Ctx, Session } from './store.js'
-import { cwdOf, sessionOf } from './registry.js'
+import { cwdOfSession, sessionOf } from './registry.js'
 import type { SvnAction, SvnAiPlan, SvnChangeEntry, SvnConflictArtifact, SvnFeature, SvnIgnoreItem, SvnItemStatus, SvnLogEntry, SvnRemoteOutdatedEntry, SvnStatusPayload, SvnSumEntry } from './shared/svn.js'
 import { SESSION_MISSING_ERROR, SESSION_NO_WORKSPACE_ERROR } from './shared/rpc.js'
 import { AI_PLAN_DIFF_CAP, AI_PLAN_PATHS_CAP, BATCH_PATHS_CAP, FILE_SIZES_CAP, SVN_CLI_DEFAULT, TORTOISE_EXE, contentGuardOf, normalizeAiPlan, svnChangelistNameErrorOf, tortoiseLaunchArgv } from './shared/svn.js'
@@ -463,7 +463,7 @@ async function requireSvnSession(
 ): Promise<{ cwd: string } | { err: string }> {
   const session: Session | undefined = sessionOf(ctx, sessionId)
   if (!session) return { err: SESSION_MISSING_ERROR }
-  const cwd = cwdOf(session)
+  const cwd = cwdOfSession(ctx, session)
   if (!cwd) return { err: SESSION_NO_WORKSPACE_ERROR }
   return { cwd }
 }