v0.10.0 — 文档侧边栏与阅读体验更新

v0.10.0 — 文档侧边栏与阅读体验更新

预览面板现在可以在宽屏与对话并排停靠。会话头部的回形针打开工作区文档，面板
右上 × 关闭；未保存修改仍先确认，关闭后焦点返回入口。

相对 npm 上一版 v0.7.2，本次发布包含：

• 文档侧边栏：宽屏预留独立空间，窄屏和全屏时覆盖展开；保留宽度记忆，
  原生导航和工具详情继续可用，关闭及卸载恢复宿主布局。
• UI 与排版：统一导航字体、间距和原生图标，完善浅/深主题与键盘焦点；
  正文沿用 Harness 的 Markdown 字号、行距与段落节奏。
• 查找文档：按名称搜索整个工作区，包括未展开目录；新增当前回合产出、
  最近阅读和继续阅读入口，明确区分空结果、不完整结果与失败。
• 阅读连续性：重新打开恢复阅读位置，记忆面板及导航偏好；按打开意图安排
  文档与导航空间，保留手动选择。
• 编辑可靠性：关闭、换文档及切回预览统一经过未保存守卫；保存反馈和冲突
  处理更清晰，过期请求不会覆盖后续文档。

兼容固定的 DeepSeek Harness 0.1.2-rc.1 基线。

dsh plugin --profile web add @benz-ai-x/dsh-md-preview@0.10.0

验证：pnpm verify 通过 123 项基线检查、290 项测试、类型检查和构建检查。
同一发布 tarball 在干净 profile 完成安装、普通包名导入、启动、资源服务和移除
验证；启动图 47 → 46，资源 HTTP 200 → 404，SIGTERM 退出码均为 0。

侧边栏适配依赖固定基线的布局结构，升级 Harness 需复验；用户上传的文档附件
仍不支持预览。顶栏对齐等下一轮优化及主题/缩放的剩余视觉验收继续在 #36、#37
跟踪。验证证据见 发布验证。

v0.7.2 — 会话头部「工作区文档」入口:右侧面板直接开浏览脸

0.7.1 之后的补丁:会话 header 动作区(Session 日志右侧)新增 📂「工作区文档」按钮——点开即把右侧预览面板直接开到浏览脸(工作区树先进门),点树中任意文件换文档脸读它。预览目标带可选 face;浏览脸空目标不触发 read(无多余 RPC)。

• 会话无关:无需先产出 Markdown,任何会话都能从 header 打开工作区文档
• 复用现有面板的 rail/大纲/编辑/保存/筛选全部能力
• 宿主 header.actions 槽直注册,无布局探测、无 overlay 边缘自造

测试 154/154 全绿;verify 全链 EXIT 0;packed 冒烟(bundle 内嵌 v0.7.2 + dock.browse);npm latest=0.7.2。

安装

dsh plugin --profile <name> add @benz-ai-x/dsh-md-preview

v0.7.1 — Wave 1+2:大纲高亮/树图标/筛选/侧栏 rail/分段控件/编辑反馈/键映射

0.6.0 以来全部整包发布(spec #9/#10,票 #11-#18 + 用户反馈迭代)。注:npm 上本版 0.7.1 即包含以下全部内容。

Wave 1 快赢

• 大纲当前节高亮(查看脸滚动反推 / 编辑脸光标行,双向)
• 树文件类型图标细分;头部脏点、版本入 tooltip(底部页脚常驻)、快捷键标注
• 查找面板中文化、n/m 计数、换肤

Wave 2 结构

• 侧栏 rail(≥640px):文件树+大纲常驻左侧(「文件|大纲」记忆选择、右缘拖宽 120–320),<640 回退换脸/弹层;Mod-Shift-O/E、Esc
• 预览|编辑 分段控件:脏草稿切回/树开文件走「放弃/继续」守卫
• 编辑反馈:状态栏(Ln/Col/字数/常驻已保存时间)+ 撤销/重做
• Mod-B/I/K 排版键 + ? / Mod-/ 键位帮助;内联 HTML 一次性预警;树筛选(命中高亮/整枝保留)
• 布局:body 转 flex row,文档成真实滚动容器

工作区文档入口(用户反馈驱动)

• 会话 header 末尾 📂「工作区文档」按钮 → 右侧面板直接开浏览脸(树先进门),点文件换文档脸;预览目标带可选 face,空目标不触发 read

质量

测试 116→154 全绿;verify 全链 EXIT 0;双轴审查修复闭环;真实浏览器走查(含真实键盘 Mod-B/Z)。

安装

dsh plugin --profile <name> add @benz-ai-x/dsh-md-preview

v0.6.0 — 大纲导航 · 树刷新 · 编辑器查找 · mermaid 图表

新增(0.6.0 功能四连)

• 大纲导航:面板头部弹层列出文档 ATX 标题;查看脸按出现序数定位并滚动到渲染标题,编辑脸跳转光标到源行
• 工作区树刷新:重进浏览脸静默重验所有展开目录 + 树工具栏手动刷新按钮;新列表到达前保留现列表,刷新失败不变更任何内容
• 编辑器查找:CodeMirror search panel(Mod-F + 编辑脸头部按钮)
• Mermaid 图表增强:渲染后接管 ```mermaid 围栏——源码围栏与渲染块做对齐校验,横幅保留(复制仍得源码)、代码隐藏、SVG 就位;任何失败回退纯代码块 + 一行说明;securityLevel: strict
  • 体积影响:client bundle 426 kB → 3.89 MB minified(gzip ~1.1 MB);mermaid 惰性求值,仅当文档含图时付出解析成本

基线对齐(原 0.5.0 内容,随本版一并发布)

• DSH 基线 0.1.2-alpha.3 → 0.1.2-rc.1(305 commits 漂移审查,零 API 破坏,纯版本对齐;peer/devDeps 精确 pin)

自 0.4.0 的其它变化

• git 直装支持:自包含 prepare 构建(#8)
• README 双语拆分(README.md / README.zh.md)+ 三种安装形态文档
• pack.mjs 打包/发布跳过生命周期脚本(prepare stdout 不再污染 --json 契约)

安装

dsh plugin --profile <name> add @benz-ai-x/dsh-md-preview

测试 116 项;发布链:verify → packed 冒烟 → npm publish → registry 验货 → web profile 升级验证,全部通过。

v0.4.0 — 工作区浏览

新增:工作区浏览

预览面板新增「工作区」入口,进入会话工作区的目录树浏览脸(spec #1,tickets #2–#6,PR #7):

• 目录树 —— 懒展开(caret 打开目录才拉取子层),加载中/空目录/失败三态;文件夹优先排序;24px 行高、20px 缩进、长名省略号 + 悬停全名;folder/file 图标配对 + 通用回退。
• 单击即预览 —— markdown 走富渲染,纯文本(.txt,可配置 previewExtensions)等宽展示,其它类型给明确的「不支持预览」提示(编辑仍限 markdown 白名单)。
• 双向连通 —— 当前文档在树中 aria-current 高亮;从 chip/消息动作打开的文档自动定位(Obsidian 式祖先展开);折叠加载中的父目录继承选中;展开集跨脸保持。
• 面包屑 + 键盘 —— 面板头部路径面包屑;树采用资源管理器键盘模型(单 Tab 停靠、roving tabindex、↑↓/→/←/Home/End/Enter)。
• Host mdPreview/list —— 复用工作区权威链(中段抽出 resolveContainedTarget,read/write/list 共享),目录目标合法,条目工作区相对;失败码全部复用现有九个。

修复与内部

• 双轴审查(标准/规格)5 项发现全部修复:不支持类型专属文案、跨会话树重置、死样式、声明倒置、CONTEXT.md 补词。
• 测试 101 项;previewExtensions 进 Config schema;UX 依据见 docs/research/workspace-browser-ux.md。

安装/升级:dsh plugin --profile <name> add @benz-ai-x/dsh-md-preview@^0.4.0(npm latest)