dsh-vscode-mode 0.7.0 → 0.9.0

package/locale/en.json

@@ -0,0 +1,4 @@
+{
+  "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

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

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "dsh-vscode-mode",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "DSH 上的类 VSCode 编码体验：Monaco 编辑器（文件页签/QuickOpen/状态栏，可驻 DSH 0.1.5+ 官方右侧 Sidebar 与对话同屏）+ 命令栏（Ctrl+Shift+P）与可扩展指令系统 + VS Code 兼容代码片段（.code-snippets 全局/项目，IntelliSense 展开）+ Agent 编辑差异审查（整文件差异/采纳/拒绝/归档/回滚）+ SVN 集成（侧栏变更面板/日志弹窗/并排差异）+ 语言服务器（LSP）智能（跳转定义/引用/hover/大纲 + VSIX 扩展市场安装），状态持久化到工作区旁车",
+  "icon": "assets/icon.svg",
   "keywords": [
     "dsh",
     "dsh-plugin",
@@ -35,6 +36,7 @@
   "files": [
     "lib",
     "assets",
+    "locale",
     "skills",
     "src",
     "unity",
@@ -42,6 +44,7 @@
   ],
   "license": "MIT",
   "dependencies": {
+    "@deepseek-ai/schemastery": "~3.18.4",
     "@vscode/ripgrep": "^1.18.0"
   },
   "peerDependencies": {
@@ -51,7 +54,6 @@
     "@deepseek-ai/dsh-client-ui-primitives": ">=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
     "@deepseek-ai/dsh-llm": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
     "@deepseek-ai/dsh-tools": ">=0.0.1-rc.1 <0.1.0 || >=0.1.0-rc.1 <0.2.0-0 || >=0.1.1-0 <0.2.0-0 || >=0.1.2-0 <0.2.0-0 || >=0.1.3-0 <0.2.0-0 || >=0.1.4-0 <0.2.0-0 || >=0.1.5-0 <0.2.0-0 || >=0.1.6-0 <0.2.0-0",
-    "@deepseek-ai/schemastery": ">=3.18.0 <4",
     "cordis": ">=4.0.0-rc <5",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",

package/src/ai/inline.ts

@@ -42,7 +42,7 @@ export function resetAiDirCache(): void {
  * @param ctx DSH 上下文
  * @returns llm 运行时或 null
  */
-function llmOf(ctx: Ctx): LlmRuntimeLike | null {
+export function llmOf(ctx: Ctx): LlmRuntimeLike | null {
   try {
     const llm = ctx.get('llm') as LlmRuntimeLike | undefined
     return llm && typeof llm.stream === 'function' ? llm : null
@@ -58,7 +58,7 @@ function llmOf(ctx: Ctx): LlmRuntimeLike | null {
  * @param cfg AI 配置
  * @returns 路由（provider/model）；不可路由返回 null
  */
-async function routeOf(llm: LlmRuntimeLike, cfg: AiConfigView): Promise<{ provider: string; model: string } | null> {
+export async function routeOf(llm: LlmRuntimeLike, cfg: AiConfigView): Promise<{ provider: string; model: string } | null> {
   if (cfg.provider && cfg.model) return { provider: cfg.provider, model: cfg.model }
   const providers = llm.listProviders()
   if (!providers.length) return null
@@ -68,6 +68,23 @@ async function routeOf(llm: LlmRuntimeLike, cfg: AiConfigView): Promise<{ provid
   return { provider, model: models[0].id }
 }
 
+/**
+ * AI 任务模型路由（非补全场景如 AI 智能整理）：任务配置优先，空则回落补全配置链。
+ * 回落序：taskProvider/taskModel 双非空直用 → routeOf（补全配置 → 自动首个）；
+ * effort 同序：taskEffort 非空用之，否则 cfg.effort（空串 = 不携带）。
+ * @author ddj 2026年09月23号
+ * @param llm llm 运行时
+ * @param cfg AI 配置（含可选任务模型字段）
+ * @returns 路由（provider/model/effort）；不可路由返回 null
+ */
+export async function taskRouteOf(llm: LlmRuntimeLike, cfg: AiConfigView): Promise<{ provider: string; model: string; effort: string } | null> {
+  const effort = cfg.taskEffort || cfg.effort || ''
+  if (cfg.taskProvider && cfg.taskModel) return { provider: cfg.taskProvider, model: cfg.taskModel, effort }
+  const base = await routeOf(llm, cfg)
+  if (!base) return null
+  return { ...base, effort }
+}
+
 /**
  * 单次 AI 内联补全。
  * @author ddj

package/src/ai/svnTriage.ts

@@ -0,0 +1,150 @@
+/**
+ * dsh-vscode-mode host — AI 智能整理分析模块（11-ai-changelist-triage）。
+ * 一次性非会话调用：prompt 构造（变更清单 + 可选 diff）→ ctx.llm.stream 流式汇聚
+ * （只收 text-delta）→ JSON 解析。llm 复用 inline.ts 的 llmOf；模型路由走独立
+ * 「AI 任务模型」配置（taskRouteOf，空则回落补全配置，与内联补全互不干扰）。
+ * 产出的原始 JSON 交给 shared 的 normalizeAiPlan 以真实变更清单白名单归一。
+ * 作者 ddj 2026年09月23号
+ */
+import type { Ctx } from '../store.js'
+import type { SvnChangeEntry } from '../shared/svn.js'
+import { AI_PLAN_TIMEOUT_MS } from '../shared/svn.js'
+import type { AiConfigView } from '../shared/ai.js'
+import type { LlmRuntimeLike, StreamChunk } from './llmTypes.js'
+import { llmOf, taskRouteOf } from './inline.js'
+
+/** 方案生成最大输出 token（三段 JSON 上限；再大是幻觉温床）。 */
+export const AI_PLAN_MAX_TOKENS = 8192
+
+/** 系统指令：输出唯一 JSON + 三段判据 + 硬约束（不虚构路径/一路径一类）。 */
+export const AI_PLAN_SYSTEM = [
+  '你是 SVN 变更整理助手。根据给出的工作副本变更清单（可能附 diff），产出整理方案，',
+  '输出唯一 JSON 对象，除 JSON 外不得输出任何文本（不要围栏、不要解释）：',
+  '{',
+  '  "groups": [{ "name": "英文短名", "paths": ["路径1"], "reason": "分组理由" }],',
+  '  "reverts": [{ "path": "路径", "reason": "还原理由" }],',
+  '  "ignores": [{ "path": "路径", "reason": "忽略理由" }]',
+  '}',
+  '规则：',
+  '1. 只可使用清单中出现的路径，绝不虚构或改写路径。',
+  '2. 每个路径至多归入一段（groups/reverts/ignores 互斥），拿不准的路径三段都不列。',
+  '3. groups：按功能主题把待提交改动分入 changelist 组；name 用简短英文（不以 - 开头），',
+  '   同一主题合并为一组，组数尽量少。',
+  '4. reverts：仅针对受版本控制的改动建议还原——行尾/空白噪音、误改、试验性改动等。',
+  '5. ignores：仅针对未版本化的条目建议忽略——构建产物、缓存、日志、临时文件等生成物。',
+  '6. reason 用简短中文一句话说明判定依据。',
+].join('\n')
+
+/**
+ * 构造分析用户段：变更清单行（status | path | changelist）+ 可选 diff 上下文。
+ * @author ddj 2026年09月23号
+ * @param entries 变更清单（调用方已按 AI_PLAN_PATHS_CAP 截断）
+ * @param diffText diff 文本（null = paths-only 降级）
+ * @param truncated 清单是否已截断（prompt 注明，防 AI 误以为是全集）
+ * @returns 用户消息文本
+ */
+export function buildAiPrompt(entries: readonly SvnChangeEntry[], diffText: string | null, truncated = false): string {
+  const lines = entries.map((entry) =>
+    entry.status + ' | ' + entry.path + (entry.changelist ? ' | ' + entry.changelist : ''))
+  const head = truncated
+    ? '变更清单（已截断，仅分析所列条目；status | path | changelist）：'
+    : '变更清单（status | path | changelist）：'
+  let text = head + '\n' + lines.join('\n')
+  if (diffText) text += '\n\n变更 diff（unified，0 上下文行）：\n' + diffText
+  else text += '\n\n（无 diff 上下文，仅按路径与状态判断）'
+  return text
+}
+
+/**
+ * 解析 AI 输出 JSON：剥 ``` 围栏 → 取首个 `{` 至末个 `}` → JSON.parse。
+ * 失败抛带原文摘要的错误（调用方整体报错零执行，不静默降级）。
+ * @author ddj 2026年09月23号
+ * @param text 模型输出原文
+ * @returns 解析出的对象（形状由 normalizeAiPlan 容错）
+ */
+export function parseAiPlanJson(text: string): unknown {
+  const raw = String(text ?? '')
+  const start = raw.indexOf('{')
+  const end = raw.lastIndexOf('}')
+  if (start < 0 || end <= start) {
+    throw new Error('AI 输出不含 JSON 对象：' + raw.slice(0, 200))
+  }
+  const body = raw.slice(start, end + 1)
+  try {
+    return JSON.parse(body)
+  } catch (error) {
+    throw new Error('AI 输出无法解析为 JSON：' + String(error) + '（原文摘要：' + body.slice(0, 200) + '）')
+  }
+}
+
+/** AI 分析结果（raw 交 normalizeAiPlan 归一；失败以抛错方式上抛）。 */
+export interface SvnTriageResult {
+  /** 解析出的原始方案对象。 */
+  raw: unknown
+  /** 实际使用的 provider/model（诊断与 UI 展示）。 */
+  model: string
+}
+
+/**
+ * 一次 AI 智能整理分析（一次性非会话流式调用）。
+ * llm 缺失/不可路由/流失败/解析失败一律抛错，由 handler 转 `{ok:false, error}`（零执行）。
+ * @author ddj 2026年09月23号
+ * @param ctx DSH 上下文（取 llm）
+ * @param cfg AI 配置（任务模型路由优先，回落补全配置）
+ * @param prompt 用户段（buildAiPrompt 产物）
+ * @returns 原始方案对象与模型标识
+ */
+export async function svnAiPlanOf(ctx: Ctx, cfg: AiConfigView, prompt: string): Promise<SvnTriageResult> {
+  const llm: LlmRuntimeLike | null = llmOf(ctx)
+  if (!llm) throw new Error('llm 服务不可用（请检查 DSH 模型配置）')
+  const route = await taskRouteOf(llm, cfg)
+  if (!route) throw new Error('未找到可用模型（请检查 DSH 模型配置）')
+  const controller = new AbortController()
+  // 超时标志：与普通流失败区分（超时给可操作提示——降档/换快模型），不与适配器报错混文案
+  let timedOut = false
+  const timer = setTimeout(() => { timedOut = true; controller.abort(new Error('timeout')) }, AI_PLAN_TIMEOUT_MS)
+  try {
+    const stream = llm.stream({
+      provider: route.provider,
+      model: route.model,
+      ...(route.effort ? { reasoningEffort: route.effort } : {}),
+      messages: [
+        {
+          role: 'user',
+          content: [{ type: 'text', text: prompt }],
+          source: { kind: 'user' },
+        } as never,
+      ],
+      system: AI_PLAN_SYSTEM,
+      temperature: 0.2,
+      maxTokens: AI_PLAN_MAX_TOKENS,
+      // 不传 stop：llm-pi-ai 等适配器不支持该选项（UNSUPPORTED_OPTION 直接 error finish）
+      signal: controller.signal,
+    })
+    let text = ''
+    let failNote = ''
+    for await (const chunk of stream) {
+      const c = chunk as StreamChunk
+      if (c.type === 'text-delta') {
+        text += c.text
+      } else if (c.type === 'finish') {
+        // 适配器失败走 finish(error/aborted) 而非抛异常（inline 同款口径）
+        const kind = (c.reason as { kind?: string })?.kind
+        if (kind === 'error' || kind === 'aborted') {
+          const failure = (c.reason as { failure?: { code?: string; message?: string } }).failure
+          failNote = '模型流失败 ' + (failure?.code ?? kind) + ': ' + (failure?.message ?? '模型调用失败')
+        }
+        break
+      }
+    }
+    if (failNote) throw new Error(failNote)
+    return { raw: parseAiPlanJson(text), model: route.provider + '/' + route.model }
+  } catch (error) {
+    if (timedOut) {
+      throw new Error('AI 分析超时（' + Math.round(AI_PLAN_TIMEOUT_MS / 1000) + 's）：可在设置页调低任务模型思考强度或换更快模型')
+    }
+    throw error
+  } finally {
+    clearTimeout(timer)
+  }
+}

package/src/capture.ts

@@ -1,18 +1,42 @@
 /**
- * dsh-vscode-mode host — 捕获层：监听 tools/result，把 edit/write 差异落成审查记录。
- * 迁移自原 src/index.ts 的 tools/result 处理，语义不改。
- * 作者 ddj 2026-08-20
+ * dsh-vscode-mode host — 捕获层：监听 tools/result，把 edit/write/remote_ssh_write
+ * 差异落成审查记录。
+ * 迁移自原 src/index.ts 的 tools/result 处理；2026-09-23（issue #7）增补
+ * remote_ssh_write：远端工作区会话里 agent 直写远端的全量覆写——before 取本地
+ * 镜像快照、after 取参数 content，捕获后把同一内容**写穿**回镜像（node:fs 直写，
+ * 刻意不走 ctx.fs，避开 dsh-remote-ssh 写桥的重复推送与补丁次序问题），使镜像 =
+ * 远端最新内容，读/stale/决策口径与远端一致。
+ * 作者 ddj 2026-08-20（2026-09-23 扩展 remote_ssh_write 捕获）
  */
+import { mkdir, readFile, stat, writeFile } from 'node:fs/promises'
+import { dirname } from 'node:path'
 import type { DiffRecord, Hunk } from './shared/types.js'
 import { annotateHunks, fingerprint } from './shared/diff.js'
 import type { Ctx, Session } from './store.js'
-import { loadBucket, saveBucket } from './store.js'
+import { READ_CAP, loadBucket, saveBucket } from './store.js'
 import { fileMaxBatch, prune } from './model.js'
 import type { Registry } from './registry.js'
 import { cwdOf } from './registry.js'
+import { findRemoteWs, mirrorTargetOf } from './remoteWorkspace.js'
 import { invalidateIndex } from './treeIndex.js'
 import { log } from './log.js'
 
+/** 捕获所需的工具执行最小形状（DSH ToolExecution 的结构子集）。 */
+interface CaptureExec {
+  name?: unknown
+  callId?: unknown
+}
+
+/** 捕获所需的工具结果最小形状（tools/result 的结构子集）。 */
+interface CaptureResult {
+  isError?: unknown
+  value?: { path?: unknown; before?: unknown; after?: unknown } | null
+  meta?: { diffs?: unknown }
+}
+
+/** 镜像文件读取状态（区分真实缺失、过大/非文件与真实内容）。 */
+type MirrorState = { kind: 'content'; content: string } | { kind: 'missing' } | { kind: 'unreadable' }
+
 /** 校验并提取工具 result meta 中的文件 hunk。 */
 function validHunks(raw: unknown): Hunk[] {
   if (!Array.isArray(raw)) return []
@@ -40,9 +64,193 @@ function fallbackHunks(toolName: string, args: Record<string, unknown>, before:
   return []
 }
 
+// --region 记录构造
+
+/**
+ * 是否为纳入审查的编辑类工具（本地 edit/write + 远端 remote_ssh_write）。
+ * @author ddj 2026年09月23号
+ * @param name 工具名
+ * @returns 纳入审查返回 true
+ */
+function isCapturable(name: unknown): boolean {
+  return name === 'edit' || name === 'write' || name === 'remote_ssh_write'
+}
+
+/**
+ * 本地 edit/write 执行结果 → 审查记录（原 captureToolResult 主体语义不变）。
+ * @author ddj 2026年09月23号
+ * @param exec 工具执行描述
+ * @param args 工具参数
+ * @param result 工具执行结果
+ * @returns 记录；hunk 为空或缺 callId 返回 null
+ */
+function buildLocalRecord(exec: CaptureExec, args: Record<string, unknown>, result: CaptureResult): DiffRecord | null {
+  const value = result.value
+  const path = value && typeof value.path === 'string' ? value.path : args.file_path
+  if (typeof path !== 'string' || !path) return null
+  const before = value && typeof value.before === 'string' ? value.before : null
+  const after = value && typeof value.after === 'string' ? value.after : (typeof args.content === 'string' ? args.content : null)
+  const create = exec.name === 'write' && !!value && value.before === null
+  const callHunk = exec.name === 'edit' && typeof args.old_string === 'string' && typeof args.new_string === 'string'
+    ? { oldText: args.old_string, newText: args.new_string }
+    : null
+  const metaHunks = validHunks(result.meta?.diffs)
+  const rawHunks = metaHunks.length ? metaHunks : fallbackHunks(String(exec.name), args, before, after, create)
+  const hunks = annotateHunks(rawHunks, before, after)
+  if (!hunks.length || typeof exec.callId !== 'string') return null
+  return {
+    callId: exec.callId,
+    toolName: exec.name === 'write' ? 'write' : 'edit',
+    path,
+    before,
+    after,
+    baseFingerprint: fingerprint(before),
+    afterFingerprint: fingerprint(after),
+    legacy: false,
+    conflict: false,
+    create,
+    callHunk,
+    hunks,
+    decisions: { call: 'pending', perHunk: hunks.map(() => 'pending') },
+    note: create ? '新建文件：全部拒绝将删除该文件' : before === null ? '未捕获修改前内容（大文件）' : null,
+    superseded: false,
+    archived: false,
+    batch: 0,
+    at: new Date().toISOString(),
+  }
+}
+
+/**
+ * 读取镜像文件当前内容（node:fs 直读；缺失 → missing，非文件/过大/读失败 → unreadable）。
+ * @author ddj 2026年09月23号
+ * @param absPath 镜像内绝对路径
+ * @returns 读取状态
+ */
+async function readMirrorState(absPath: string): Promise<MirrorState> {
+  let info: Awaited<ReturnType<typeof stat>>
+  try {
+    info = await stat(absPath)
+  } catch {
+    return { kind: 'missing' }
+  }
+  if (!info.isFile()) return { kind: 'unreadable' }
+  if ((info.size ?? 0) > READ_CAP) return { kind: 'unreadable' }
+  try {
+    return { kind: 'content', content: await readFile(absPath, 'utf8') }
+  } catch {
+    return { kind: 'unreadable' }
+  }
+}
+
+/**
+ * 把远端写入内容写穿回本地镜像（node:fs 直写 + mkdir -p 父目录）。
+ * 刻意不用 ctx.fs：避免触发 dsh-remote-ssh 写桥把相同内容再推回远端。
+ * @author ddj 2026年09月23号
+ * @param absPath 镜像内绝对路径
+ * @param content 远端写入后的完整内容
+ * @returns 成功返回 null；失败返回错误文案（不抛）
+ */
+async function syncMirrorFile(absPath: string, content: string): Promise<string | null> {
+  try {
+    await mkdir(dirname(absPath), { recursive: true })
+    await writeFile(absPath, content, 'utf8')
+    return null
+  } catch (error) {
+    return String(error)
+  }
+}
+
+/**
+ * 远端记录的 note 组装（新建/未捕获 before/镜像外路径/写穿失败可叠加）。
+ * @author ddj 2026年09月23号
+ * @param create 镜像中目标不存在（远端新建）
+ * @param before 镜像快照内容（null = 未捕获）
+ * @param mirrorAbs 可映射的镜像绝对路径（null = 路径不在镜像内）
+ * @param syncErr 写穿失败原因（null = 成功）
+ * @returns note 文本；无需提示返回 null
+ */
+function remoteNoteOf(create: boolean, before: string | null, mirrorAbs: string | null, syncErr: string | null): string | null {
+  const notes: string[] = []
+  if (!mirrorAbs) {
+    notes.push('远端路径不在工作区镜像内（仅记录，无法本地审查）')
+  } else if (create) {
+    notes.push('新建文件：全部拒绝将删除该文件')
+  } else if (before === null) {
+    notes.push('未捕获修改前内容（大文件）')
+  }
+  if (syncErr) notes.push('远端内容写回镜像失败（记录仍已保存）：' + syncErr)
+  return notes.length ? notes.join('；') : null
+}
+
+/**
+ * remote_ssh_write 执行 → 审查记录（含镜像写穿，issue #7）。
+ * 非远程工作区、参数不合法或内容无变化返回 null（不产生记录）。
+ * @author ddj 2026年09月23号
+ * @param cwd 会话工作区（远程会话即镜像根）
+ * @param exec 工具执行描述
+ * @param args 工具参数（path 相对远端工作区目录，或绝对/`~` 形态）
+ * @returns 记录；不满足捕获条件返回 null
+ */
+async function buildRemoteRecord(cwd: string, exec: CaptureExec, args: Record<string, unknown>): Promise<DiffRecord | null> {
+  const ws = findRemoteWs(cwd)
+  if (!ws) return null
+  const argPath = typeof args.path === 'string' ? args.path : ''
+  const after = typeof args.content === 'string' ? args.content : null
+  if (!argPath || after === null || typeof exec.callId !== 'string') return null
+  const mirrorAbs = mirrorTargetOf(argPath, ws)
+  const state = mirrorAbs ? await readMirrorState(mirrorAbs) : ({ kind: 'unreadable' } as const)
+  const before = state.kind === 'content' ? state.content : null
+  const create = state.kind === 'missing'
+  if (before !== null && before === after) return null
+  // 内容无差异已 return；走到这里必须写穿，使镜像与远端一致（失败经 note 降级）
+  const syncErr = mirrorAbs ? await syncMirrorFile(mirrorAbs, after) : null
+  const hunks = annotateHunks([{ oldText: before, newText: after }], before, after)
+  return {
+    callId: exec.callId,
+    toolName: 'remote_ssh_write',
+    path: mirrorAbs ?? argPath,
+    before,
+    after,
+    baseFingerprint: fingerprint(before),
+    afterFingerprint: fingerprint(after),
+    legacy: false,
+    conflict: false,
+    create,
+    callHunk: null,
+    hunks,
+    decisions: { call: 'pending', perHunk: hunks.map(() => 'pending') },
+    note: remoteNoteOf(create, before, mirrorAbs, syncErr),
+    superseded: false,
+    archived: false,
+    batch: 0,
+    at: new Date().toISOString(),
+  }
+}
+// --endregion
+
+/**
+ * 记录入桶：按工作区分桶（缺失先加载）、按文件递增批次、裁剪、落盘。
+ * @author ddj 2026年09月23号
+ * @param ctx DSH 上下文
+ * @param registry 工作区记录桶注册表
+ * @param session 会话
+ * @param cwd 会话工作区
+ * @param record 待入桶记录
+ */
+async function persistRecord(ctx: Ctx, registry: Registry, session: Session, cwd: string, record: DiffRecord): Promise<void> {
+  let bucket = registry.get(cwd)
+  if (!bucket) { bucket = await loadBucket(ctx, cwd); registry.set(cwd, bucket) }
+  record.batch = fileMaxBatch(bucket, record.path) + 1
+  bucket.set(record.callId, record)
+  // 同一文件的多次 edit/write 都保留为独立记录，便于逐条审查。
+  // 旧实现按文件 batch 自动归档 prior，会导致界面看起来每个文件只剩一条差异。
+  prune(bucket)
+  await saveBucket(ctx, cwd, bucket, session)
+}
+
 /**
- * 捕获一次工具执行结果（tools/result）：edit/write 成功时构造记录、
- * 递增文件批次、融合归档被后续修改取代的旧差异、落盘。
+ * 捕获一次工具执行结果（tools/result）：edit/write/remote_ssh_write 成功时
+ * 构造记录、递增文件批次、落盘；远端写入额外做镜像写穿（issue #7）。
  * @author ddj 2026年08月20号
  * @param ctx DSH 上下文
  * @param registry 工作区记录桶注册表
@@ -52,55 +260,21 @@ function fallbackHunks(toolName: string, args: Record<string, unknown>, before:
 // eslint-disable-next-line @typescript-eslint/no-explicit-any
 export async function captureToolResult(ctx: Ctx, registry: Registry, exec: any, result: any): Promise<void> {
   const session: Session | undefined = exec?.agent?.session
-  if (!session || (exec?.name !== 'edit' && exec?.name !== 'write')) return
-  if (result?.isError || !result?.value) return
+  if (!session || !isCapturable(exec?.name)) return
+  if (result?.isError) return
+  // remote_ssh_write 只依赖参数与 isError（其 result.value 形状不受本插件约束）
+  if (exec.name !== 'remote_ssh_write' && !result?.value) return
   try {
     const cwd = cwdOf(session)
     if (!cwd) return
-    const value = result.value
-    const args = (exec.arguments || {}) as Record<string, unknown>
-    const path = typeof value.path === 'string' ? value.path : args.file_path
-    if (typeof path !== 'string' || !path) return
-    const before = typeof value.before === 'string' ? value.before : null
-    const after = typeof value.after === 'string' ? value.after : (typeof args.content === 'string' ? args.content : null)
-    const create = exec.name === 'write' && value.before === null
-    const callHunk = exec.name === 'edit' && typeof args.old_string === 'string' && typeof args.new_string === 'string'
-      ? { oldText: args.old_string, newText: args.new_string }
-      : null
-    const metaHunks = validHunks(result.meta?.diffs)
-    const rawHunks = metaHunks.length ? metaHunks : fallbackHunks(exec.name, args, before, after, create)
-    const hunks = annotateHunks(rawHunks, before, after)
-    if (!hunks.length || typeof exec.callId !== 'string') return
-    const record: DiffRecord = {
-      callId: exec.callId,
-      toolName: exec.name,
-      path,
-      before,
-      after,
-      baseFingerprint: fingerprint(before),
-      afterFingerprint: fingerprint(after),
-      legacy: false,
-      conflict: false,
-      create,
-      callHunk,
-      hunks,
-      decisions: { call: 'pending', perHunk: hunks.map(() => 'pending') },
-      note: create ? '新建文件：全部拒绝将删除该文件' : before === null ? '未捕获修改前内容（大文件）' : null,
-      superseded: false,
-      archived: false,
-      batch: 0,
-      at: new Date().toISOString(),
-    }
-    let bucket = registry.get(cwd)
-    if (!bucket) { bucket = await loadBucket(ctx, cwd); registry.set(cwd, bucket) }
-    record.batch = fileMaxBatch(bucket, path) + 1
-    bucket.set(exec.callId, record)
-    // 同一文件的多次 edit/write 都保留为独立记录，便于逐条审查。
-    // 旧实现按文件 batch 自动归档 prior，会导致界面看起来每个文件只剩一条差异。
-    prune(bucket)
-    await saveBucket(ctx, cwd, bucket, session)
+    const args = ((exec.arguments || {}) as Record<string, unknown>)
+    const record = exec.name === 'remote_ssh_write'
+      ? await buildRemoteRecord(cwd, exec as CaptureExec, args)
+      : buildLocalRecord(exec as CaptureExec, args, result as CaptureResult)
+    if (!record) return
+    await persistRecord(ctx, registry, session, cwd, record)
     // agent 写盘后目录树可能变化（新建/删除文件/目录）：父目录+祖先进失效，后台自愈。
-    invalidateIndex(ctx, cwd, path)
+    invalidateIndex(ctx, cwd, record.path)
   } catch (error) {
     log.error('capture failed: ' + String(error))
   }