dsh-vscode-mode 0.16.0 → 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/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/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/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 }
 }