文件追踪 lhh010/dsh-file-trace

@dsh-external/dsh-file-trace

兼容 DSH dsh-v0.1.2-alpha.1 ~ dsh-v0.2.1-alpha.1（当前 v0.3.26 声明支持 dsh-v0.2.0-rc.2；版本对照见下方表格与 compatibility.json） DSH Web UI 文件追踪插件：像 Codex / Claude Code 一样记录并查看模型读取、写入、编辑的每一个文件。会话标题栏工具区出现「文件追踪」按钮（带操作数徽标），点击打开浮动窗口，按文件分组列出全部操作，点选任意操作查看带行号的内容或逐行 diff。零核心改动，纯浏览器 half 插件。

你的 DSH 版本决定装哪个插件版本（装错会崩：常见症状 useConversation is not a function）

- DSH 0.1.2-alpha.1 ~ 0.2.1-alpha.1：装新版（下方默认命令，当前 #v0.3.28；各 DSH 版本对应的插件 tag 见版本对应表）
- 更旧的 DSH（0.1.1-rc.2 及以前）：无可用版本

安装（profile 模式）

安装方式（v0.3.28 起自动挂载）：本包自 v0.3.28 起自带 cordis.patch.yml 并声明 dsh.bundle.patch——dsh plugin --profile web add 安装后自动注册 profile 层并挂载，不再需要手写 insert 配置行（固定旧 tag 的部署仍需）。GUI 注意：插件页「添加插件」只接受注册表包名或本地目录路径；name@github:owner/repo#tag 是 pnpm 别名规格（CLI 专用），粘进 GUI 会报 ERR_PNPM_INVALID_PACKAGE_NAME——GUI 请克隆后用本地目录路径，或等 npm 发布后用包名。

方式一：git 依赖固定 tag（公开镜像，推荐；也可用 github:lhh010/dsh-file-trace）
dsh plugin --profile web add '@dsh-external/dsh-file-trace@github:lhh010/dsh-file-trace#v0.3.28'

方式二：本地 link（开发；克隆的仓库构建产物已入库，改源码后需 pnpm run build）
git clone https://github.com/lhh010/dsh-file-trace.git
cd dsh-file-trace && pnpm install
dsh plugin --profile web add link:/path/to/dsh-file-trace

配置行（$DSH_HOME/profiles/web/cordis.patch.yml，热重载，无需重启）：

- insert:
- id: dsh-file-trace
name: '@dsh-external/dsh-file-trace'

安装提示：pnpm 11 首次安装可能拦截 node-pty 等构建脚本——在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all 放行后重跑安装命令；装完硬刷新浏览器（Ctrl/Cmd+Shift+R）。

智能版本门控更新提示 / DSH-gated update chip

更新浮标会结合当前运行的 DSH 版本（宿主端从 dsh 安装清单读取）与仓库根的 compatibility.json（版本→支持的 DSH 列表，精确匹配）判定提示形态：

- 最新版支持当前 DSH → 正常「新版本 vX 可用，点击更新」；
- 最新版需要更高 DSH、但存在支持当前 DSH 的中间新版 → 提示更新到中间版，并注明「另有 vX 需更高 DSH」；
- 最新版需要更高 DSH、且当前 DSH 无任何可用新版 → 琥珀色信息条：「新版本 vX 支持更高 DSH 版本，当前 DSH vY 暂不可用」，不提供直接升级。

兼容数据拉取失败或无该版本条目时，自动回退为旧的普通升级提示（离线安全）。发版时需同步维护 compatibility.json（与版本表/变更记录同一步骤新增一行）。

提示词安装（让 DSH 自己装）

把下面这段提示词发给任意一个 DSH 会话，模型会替你完成安装：

帮我安装 dsh-file-trace 插件（DSH 文件追踪：记录并查看模型读写编辑的文件与 diff），步骤：
1. 执行 dsh plugin --profile web add '@dsh-external/dsh-file-trace@github:lhh010/dsh-file-trace#v0.3.12'（首次可能被 pnpm 11 拦截 node-pty 构建脚本而失败）
2. 在 ~/.dsh/profiles/web 下执行 pnpm approve-builds --all（放行构建脚本）
3. 再执行一次第 1 步的安装命令
4. 完成后在 ~/.dsh/profiles/web/cordis.patch.yml 追加 - insert 插件行（id: dsh-file-trace，name: '@dsh-external/dsh-file-trace'），并提醒我硬刷新浏览器（Ctrl/Cmd+Shift+R）遇到报错先查 https://github.com/lhh010/dsh-file-trace README 的已知限制。

功能

- 操作记录：提取模型对文件的读取 / 写入 / 编辑，含执行中、出错标记、时间与载荷大小（递归覆盖 run_code 等宿主工具的子调用）。
- 读取视图：显示被读取文件的真实内容与真实行号（剥掉 DSH 读工具响应外壳）。
- Markdown 阅读模式 + Mermaid：.md / .markdown / .mdx 文件的操作视图头部出现「阅读 / 原文」切换按钮（读取 / 写入 / 编辑三种操作都有）；阅读模式按 Obsidian 风格渲染完整文档——多级标题、表格（含对齐）、分割线、加粗/斜体/加粗斜体、删除线、高亮 ==、行内代码、代码块、引用、有序/无序列表与任务清单、链接、[[Wiki 链接]]；图片按 URL 渲染，本地路径图片与非图片附件统一显示为带文件名的文件徽标；YAML frontmatter 显示为代码块。编辑操作优先用窗口内已知的前置内容重建变更后的完整文档。
- Mermaid 图渲染（懒加载 + 安全清洗 + 缩放）：阅读模式下 mermaid 围栏按需从宿主 /dsh-file-trace/resources 懒加载 mermaid chunk（单文件打包）渲染成图；securityLevel: strict + htmlLabels: false 之上再经零依赖 SVG 白名单清洗（剥离 foreignObject/script/事件属性/全部链接）才注入 DOM；点击图打开全屏缩放（滚轮缩放/拖拽平移/±0 键盘/双击遮罩或 Esc 关闭）；加载失败或离线时自动回退为原样代码块。
- 数学公式渲染（KaTeX，懒加载）：阅读模式下 $$...$$ 块公式与 $...$ 行内公式按需从宿主 /dsh-file-trace/resources 懒加载 katex chunk（单文件打包，CSS 与全部字体 base64 内联，一次加载覆盖全文档）真正排版——上下标、分式、根号、希腊字母、\mathrm/\sqrt/\times/\quad 等均正常渲染；throwOnError: false 使单条公式语法错误只红字标注该条，不影响其余内容；chunk 加载失败或离线时自动回退为原文文本（v0.3.13 及以前的行为），只降级不崩溃。
- 出错统一展示：读取 / 写入 / 编辑失败的操作点开即显示结果里的真实错误文本（红色错误块），不再渲染伪造 diff。
- 语法高亮：按扩展名识别常见语言（C/C++、Java、C#、JS/TS（含 mjs/cjs/mts/cts）、Python、Go、Rust、cmd/batch、PowerShell、JSON/JSONC/JSON5/YAML/TOML/INI、SQL、CSS/SCSS/Less、HTML/XML/SVG/Vue、GraphQL、LaTeX/TeX（TeXstudio 风格初步渲染：命令/数学/注释/结构高亮）等），读取视图与 diff 行的关键字 / 字符串 / 数字 / 类型 / 函数 / 注释 / 预处理指令分别着色；修改行的行内变更底色与着色叠加。
- 写入视图：新文件写入显示为全量新增（每行绿色 +）；覆盖修改时按真实差异做 del/add。
- 编辑视图（hunk 上下文折叠）：用窗口内更早的写入/读取内容重建完整文件，保留变更点 ±3 行上下文；未变化区域≥3 行才折叠成「… N 行」（≤2 行直接显示），点击展开/收起。
- 长行折叠：单行超过 120 字符自动折叠为省略号，点击展开/收起。
- 终端风格 diff：等宽字体、行号 gutter、删除红 / 新增绿 / 修改蓝 的字体色（背景仅为对应色调弱化，保证可读）。
- Ctrl+滚轮调字号：历史操作列表区与文件内容区（diff/读取视图）字号独立调节（Ctrl + 鼠标滚轮，各自持久化到 localStorage）；限制 9–28px，达到边界时弹提示「已达最小/最大字号 N px」。
- 浮动窗口（可拖拽 / 可调大小 / 右侧吸附）：拖动标题栏移动位置，拖左缘/底缘调整宽高（位置与尺寸持久化到 localStorage）；拖到屏幕右缘释放自动吸附为全高右侧栏，主对话区同步右移避让不重叠，再拖标题栏即脱离；底部 diff 区上方另有把手调整列表与 diff 的分配。
- 兼容自诊断：apply 时探测所需客户端 API，不满足时不崩溃，而是渲染修复指引横幅；组件渲染出错时同样显示修复提示。

工作原理

- 数据完全来自会话 Chat 视图快照（views.get('chat').legacy 的 tool-result 节点与 runningCalls），每次渲染纯派生，无自建状态、无监听器，刷新/翻页自动对齐当前窗口。
- diff 为行级 LCS；del-run + add-run 重叠对标记为 mod（修改）。
- 注册进 conversation.session.header.utilities（session 作用域 list 槽位，经 ctx.slots.inject）。

版本兼容

| 插件版本 | DSH 版本 | 说明 |
| v0.3.33（默认） | 与上一版相同 | 声明支持 dsh-v0.2.1-rc.1（0.2.1 系首个候选版，整合 alpha.1–5 全部插件面变更；升级实机验证：web profile --dump-config 全插件行加载零错误；运行时只读探测 file-trace mermaid/katex 路由 200、better-sidebar fence 活；宿主保留 webStartup 服务、无 alpha.5 之外的插件面破坏性变更；零适配改动）；双 bundle node --check 通过 |
| v0.3.32 | 与上一版相同 | 声明支持 dsh-v0.2.1-alpha.5（升级实机验证：web profile --dump-config 全插件行加载零错误；运行时只读探测 file-trace mermaid/katex 路由 200、better-sidebar fence 活；宿主保留 webStartup 服务、无插件面破坏性变更——新增的 conversation.input.model.label Slot 为并列新增键，与本插件既有注入面（conversation.input.for / conversation.input.dock 等）无冲突；零适配改动）；双 bundle node --check 通过 |
| v0.3.31 | 与上一版相同 | 声明支持 dsh-v0.2.1-alpha.4（升级实机验证：web profile --dump-config 全插件行加载零错误；宿主保留 webStartup 服务、无插件面破坏性变更——新引入的 engines.dsh 兼容判定仅对声明者生效，本插件未声明故沿用原有规则；六插件零适配改动）；双 bundle node --check 通过 |
| v0.3.30 | 与上一版相同 | 声明支持 dsh-v0.2.1-alpha.3（升级实机验证：web profile --dump-config 全插件行加载零错误；运行时只读探测 file-trace mermaid/katex 路由 200、better-sidebar fence 活；宿主保留 webStartup 服务，六插件零适配改动）；双 bundle node --check 通过 |
| v0.3.29 | 与上一版相同 | Markdown 阅读模式渲染内联 SVG 与 折叠块：文档里直接书写的 标记（可带 <?xml?> 声明、可嵌在 下）经 DOMParser 校验后以 blob 真实渲染（图像上下文禁脚本、SMIL 动画照常，与 .svg 文件预览同一安全通道）；非法 XML 降级为源码块，不会无声裂图； 渲染为原生可折叠块（summary + 递归内层块）。GitHub 风格图表嵌入自此可见；typecheck/125 单测/构建全绿 |
| v0.3.28 | 与上一版相同 | 自带 bundle 声明：补齐 cordis.patch.yml 并声明 dsh.bundle.patch——dsh plugin --profile web add 装完自动注册并挂载 profile 层，不再需要手写 insert 行（社区反馈「GUI 安装后不生效」的根因）；双 bundle node --check 通过 |
| v0.3.27 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2 | 声明支持 dsh-v0.2.1-alpha.2（升级实机验证：web profile --dump-config 全插件行加载、peer 校验零错误，宿主启动监听正常，零适配改动）；双 bundle node --check 通过 |
| v0.3.26 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1 | 声明支持 dsh-v0.2.1-alpha.1（升级实机验证：web 宿主七插件挂载激活正常，零适配改动）；typecheck/115 单测/构建全绿 |
| v0.3.25 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 | 流式输出下的性能修复：① 按节点身份缓存操作提取（稳定 tool-result 只 parse/拼接一次，不再每个流式 delta 全窗口重算）；② 会话订阅传元素身份 eq——无新文件操作的流式文本期间完全跳过重渲染；③ 拖动/缩放手势改为 pointermove 直写 DOM、松手才提交 state（渲染风暴下拖动依然跟手）；并修复拖动后 localStorage 持久化保存旧位置的预存 bug。typecheck/115 单测/构建全绿，实机验证手势中途位置精确跟随 + 持久化正确 |
| v0.3.24 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 | better-sidebar 侧栏 Tab 双挂载：检测到 ctx.betterSidebar 服务时把追踪面板注册为原生侧栏 Tab（dsh-file-trace:trace，嵌入布局静态铺满面板，数据走 uiSession 会话绑定、与头部触发同源）；未安装 better-sidebar 时自动跳过、保持原浮动窗（optional peer，无新增必装依赖）；typecheck/114 单测/构建全绿，实机 web 验证（Tab 文件列表 + 逐行 diff + 双挂载并存） |
| v0.3.23 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 | 声明支持 dsh-v0.2.0-rc.2（升级实机验证：六插件挂载激活正常，零适配改动）；typecheck/113 单测/构建全绿 |
| v0.3.22 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1 | 声明支持 dsh-v0.2.0-rc.1（升级实机验证：六插件挂载激活正常，零适配改动）；typecheck/113 单测/构建全绿 |
| v0.3.21 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1、0.1.7-rc.2 | 声明支持 dsh-v0.1.7-rc.2（npm 升级实机验证：六插件挂载激活正常，零适配改动）；typecheck/113 单测/构建全绿 |
| v0.3.20 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1 | 交付文件阅读/原文切换：v0.3.18 起交付（present）的 markdown 文件只显示渲染结果、无法查看源码——现接入头部「阅读/原文」切换（交付文件默认渲染、可切带行号原文），并修复渲染分支顺序（阅读模式分支此前会以空内容抢占交付面板）；typecheck/113 单测/构建全绿 |
| v0.3.19 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1 | 修复交付文件路径解析：present 交付的相对路径此前按宿主进程 CWD 解析（报「无法读取该文件」）；现 asset 路由支持 ?session= 参数，经 sessions.get(id).header.cwd 按会话工作区解析（与官方侧边栏同一基准；客户端经 uiSession.current 同步主视图会话 id；初版误用 sessions.scope 已修正——scope 返回 AgentContext 不含 header）；实机验证交付文档完整渲染；typecheck/113 单测/构建全绿 |
| v0.3.18 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1 | 交付文件内容直显：present 类交付（代码写入、无内联内容的文件）不再显示「变更前的内容不在当前窗口，显示为全新增」——改为经宿主 asset 路由读取当前盘上内容完整渲染（.md 走 Markdown 阅读模式含图片/公式/代码高亮，其它文本带行号）；asset 路由新增 md/markdown/txt/json/csv/log 文本类型。typecheck/113 单测/构建全绿 |
| v0.3.17 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-rc.1 | 修复 present 工具调用无记录：0.1.7 起「Write polished document / Present submission」类交付（present 工具，files[] 多文件参数）不在文件追踪白名单，操作被静默忽略；现按 files[].path 逐文件展开为写入记录（含多文件交付与非法参数容错）；typecheck/113 单测/构建全绿 |
| v0.3.16 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.7-alpha.2、0.1.7-rc.1 | 声明支持 dsh-v0.1.7-rc.1（舰队扫检零错误零崩溃，零适配改动） |
| v0.3.15 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.6-alpha.2、0.1.7-alpha.1、0.1.7-alpha.2 | 新增 DSH 版本门控更新提示（舰队统一功能）；声明支持 dsh-v0.1.7-alpha.2；typecheck/112 单测/构建全绿，舰队扫检零错误 |
| v0.3.14 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.6-alpha.1 | 数学公式渲染：Markdown 阅读模式 $$/$ 公式经懒加载 katex chunk（单文件，字体 base64 内联）真正排版，失败回退原文；typecheck/105 单测/构建全绿，chunk 路由实机 200 验证；宿主重启后新 client 生效 |
| v0.3.13 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.6-alpha.1 | 声明支持 dsh-v0.1.6-alpha.1（npm 已发布，钉版本实机验证；client 插件面零代码差异，typecheck/105 单测全绿，热挂载实机验证） |
| v0.3.12 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.5-rc.2 | Markdown 阅读窗格加入 Ctrl+滚轮字号缩放：md 正文/代码块/表格/文件徽章字号接入面板字号变量（此前 md 正文硬编码 13.5px 不随缩放），Ctrl+滚轮在 md 窗格内正确归入面板字号组（此前误缩文件列表）；typecheck/105 单测/构建全绿，热挂载即时生效，无需重启宿主 |
| v0.3.11 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.5-rc.2 | 声明支持 0.1.5-rc.1~rc.2（npm 已发布，钉版本实机验证；rc.1 为 0.1.5 系列首个候选版本，client 插件面零代码差异；typecheck/build/105 单测全绿，热挂载实机验证） |
| v0.3.10 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.5-alpha.2 | 声明支持 0.1.5-alpha.2（npm 已发布，钉版本实机验证；alpha.2 改动为 Sidebar 文档预览、模型文件交付、minimal 默认工具调整与 fs-ext 安装修复，client 插件面零代码差异；typecheck/build/105 单测全绿，启动清单确认加载） |
| v0.3.9 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 ~ 0.1.5-alpha.1 | 声明支持 0.1.5-alpha.1（npm 已发布，钉版本实机验证；0.1.5 改动在会话格式 V3 / ctx.agent 移除 / 宿主 bundle 服务路由 /plugins/??，client 插件面零代码差异；typecheck/build/105 单测全绿，启动清单确认加载） |
| v0.3.8 | 与 v0.3.7 相同 | SVG 渲染预览：.svg 操作预览头部新增「渲染/原文」切换——渲染源三级链（host asset 路由磁盘原始字节 → 会话 payload 经 DOMParser 校验后的 blob → 沙箱 iframe 兜底，禁脚本、SMIL 动画照常）；markdown 阅读模式内嵌本地 .svg 从文件 chip 升级为真实渲染；payload XML 非法时显示明确错误提示而非无声裂图 |
| v0.3.7 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1、0.1.3-alpha.2 | 修复：文档以 --- 分界线开头且后方另有分界线时，标题与正文被误吞为 YAML frontmatter 渲染成代码块（client 渲染器修复，与 DSH 版本无关） |
| v0.3.6 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1、0.1.3-alpha.2 | 声明支持 0.1.3-alpha.2（npm 已发布，钉版本实机验证；alpha.2 改动全在 pi-ai/Web 顶栏/子代理消息/host 面，client 插件面零代码差异；typecheck/build/单测全绿） |
| v0.3.4 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 | PDF 渲染预览：.pdf 操作（读 / 写 / 编辑）预览头部可切换「渲染/原文」——文件字节经宿主 asset 路由流入显式 application/pdf Blob，浏览器原生 PDF 查看器内嵌打开；仅绝对路径可渲染（相对路径无法定位会话工作区） |
| v0.3.3 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 | HTML 渲染预览：.html/.htm/.xhtml 操作预览头部可切换「渲染/原文」——沙箱 iframe（allow-scripts、禁同源）渲染（脱敏后）文档——动画/交互可运行但不透明源隔离；相对路径资源不解析（安全取舍，详见已知限制） |
| v0.3.2| dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1、0.1.3-alpha.1 | 声明支持 0.1.3-alpha.1（npm 未发布，源码宿主实机验证；0.1.3 破坏性变更集中在 host/session 侧，client 插件面零代码差异；typecheck/build/96 单测全绿） |
| v0.3.1 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1 | 文档更新：明确脱敏层定位——展示层便利（截图 / 分享场景），非安全边界，会话日志保留原始内容 |
| v0.3.0 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1 | 敏感内容脱敏层：敏感路径整文件遮罩（.env/secret/credential/token/api-key/私钥等）+ 普通文件按内容形态遮罩（api_key:/Bearer /sk-/AKIA/ghp_/PEM 头等），diff/阅读视图/Markdown 模式/错误文本统一生效；默认开启，面板工具栏一键开关（localStorage 记忆）；仅影响显示，不改会话日志 |
| v0.2.9 | dsh-v0.1.2-alpha.1 ~ alpha.5、rc.1 | 声明支持 rc.1（alpha.5→rc.1 为纯版本号提交，零代码差异；实机 rc.1 验证通过） |
| v0.2.8 | dsh-v0.1.2-alpha.1 ~ alpha.5 | LaTeX/TeX 语法高亮（TeXstudio 风格初步渲染：命令→macro、数学→string、注释→灰、{}&^_#→structure、200+ 关键字） |
| v0.2.7 | dsh-v0.1.2-alpha.1 ~ alpha.5 | 声明支持 alpha.5（typecheck/build 全绿；alpha.5 为纯 bug 修复，无 API 变更） |
| v0.2.6 | dsh-v0.1.2-alpha.1 ~ alpha.4 | 声明支持 alpha.4（typecheck/build/79 单测全绿） |
| v0.2.5 | dsh-v0.1.2-alpha.1 ~ alpha.3 | 更新提示词补「按 DSH 版本选 tag」路由说明与排查指引 |
| v0.2.4 | dsh-v0.1.2-alpha.1 ~ alpha.3 | Mermaid 渲染安全加固（htmlLabels:false + SVG 白名单清洗）+ 点击全屏缩放/拖拽 |
| v0.2.3 | dsh-v0.1.2-alpha.1 ~ alpha.3 | Mermaid 懒加载渲染（失败回退代码块）；新增宿主 chunk 资源路由 |
| v0.2.2 | dsh-v0.1.2-alpha.1 ~ alpha.3 | 高亮扩充（mjs/cjs/mts/cts、CSS/SCSS/Less、HTML/XML/SVG/Vue、GraphQL、JSONC/JSON5）+ Ctrl+滚轮分区调字号（9–28px，边界提示） |
| v0.2.0 | dsh-v0.1.2-alpha.1 ~ alpha.3 | Markdown 阅读模式（Obsidian 风格渲染，读/写/编辑均可切换） |
| v0.1.8 | dsh-v0.1.2-alpha.1 ~ alpha.3 | 更新端点鉴权（x-dsh-plugin-update 头 + 同源校验）与 hostChanged 检测 |
| v0.1.7 | dsh-v0.1.2-alpha.1 | 语法高亮（含跨行块注释）；出错统一展示真实错误文本；折叠展开对齐修复；版本号随 tag |
| v0.1.6 | dsh-v0.1.2-alpha.1 | 版本检查走宿主同源端点；滚动位置记忆 |
| v0.1.4 | dsh-v0.1.2-alpha.1 | 自动版本检查 + 点击更新 |
| v0.1.3 | dsh-v0.1.2-alpha.1 | 右缘吸附为右侧栏 + 主对话避让；typecheck、20 个单测、构建全绿 |
| v0.1.2 | dsh-v0.1.2-alpha.1 | 浮动窗口化（拖拽/调宽高/持久化） |
| v0.1.1 | dsh-v0.1.2-alpha.1 | hunk 折叠阈值 ≥3 行；读取出错红色展示；渲染错误边界 |
| v0.1.0 | dsh-v0.1.2-alpha.1 | 首个版本；源码构建安装，不发布 npm |

- 面向 dsh-v0.1.2-alpha.1（GitHub tag，源码构建安装）。
- 该版本客户端的破坏性重构（dsh-client-runtime 移除、Conversation 视图化）已在插件内完成适配，并带自诊断横幅兜底。

使用说明

1. 会话标题栏右侧工具区点击「文件追踪」。
2. 窗口按文件分组列出操作（最新在前）；点某个操作（.md 文件可点「阅读」切换渲染视图，再点「原文」切回）：
- 读取 → 带行号的文件内容（出错为红色错误块）；
- 写入 → 全量新增（绿 +）或真实 del/add；
- 编辑 → 变更点 ±3 行上下文 + 上下「… N 行」折叠。
3. 长行（>120 字符）点击展开/收起；「… N 行」点击展开/再次收起。
4. 拖标题栏移动窗口；拖到屏幕右缘松手即吸附为右侧栏（主对话自动避让），再拖即脱离；拖左缘/底缘调宽高。
5. Esc 或按钮关闭窗口。

已知限制

- 只覆盖当前加载窗口内的操作，并与 Chat 视图一致；翻页加载后自动补全。
- 编辑的「完整文件上下文」依赖窗口内更早的同一文件写入/读取内容；若无，则仅显示模型提供的 old_string/new_string 片段。
- 行级 diff + 行内字符级高亮；语法高亮为轻量正则分词（无语法树），多行块注释状态按行序推导、跨行正确着色，复杂构造可能不完全精确。
- 脱敏层定位（非安全边界）：脱敏只作用于本插件的渲染层，目的是截图 / 分享 diff 给他人时的便利保护；它不是安全边界——原始内容仍完整保留在会话日志中，任何能读取会话文件的插件或工具都能看到未脱敏内容。需要真正保护密钥时应在源头（凭据管理、文件权限）处理。
- HTML 渲染预览的安全取舍：iframe 沙箱三档可手动切换（渲染时面板头有一键循环按钮）：受限（无脚本）/脚本（allow-scripts，不透明源）/宽松（另加 allow="autoplay; fullscreen" 权限策略）。默认 脚本；宽松 允许音频自动播放等权限，但仍是不透明源————页面动画与交互逻辑可运行（页面自己的回退/错误处理也能生效），且运行在不透明源里：拿不到 DSH 宿主页面的 DOM/存储/Cookie，无法发起同源请求。srcDoc 无基准 URL，相对路径的资源（图片/CSS/fetch 同目录文件）不解析（绝对 http(s) 可访问）——依赖本地伴生文件的页面会走自身回退逻辑。渲染输入经过脱敏层（与其它视图一致），但渲染的是模型读到的文档内容本身——不要把渲染视图当作「可信 HTML」的执行环境。
- 脱敏 × mermaid 已知边界：Markdown 阅读模式下，若 mermaid 图的无引号节点标签里含被脱敏的密钥（遮罩产物 [REDACTED] 自带嵌套方括号），该图会因语法破坏而渲染失败、回退显示源码（信息不泄漏，仅图不可看）。规避方法：节点标签一律加引号（A["文本"] 写作 A["含密钥的文本"] 形式即可安全遮罩）；关闭脱敏开关亦可恢复渲染。会话日志始终保留原始字节，仅影响显示。
- 中英文 README 一致性记录见 README.i18n.yaml。