v0.9.0 — 重回 Better Sidebar，汇总源码编辑与批注卡片升级

本次发布重新接入 The Better Sidebar，并集中发布上次公开版本 v0.6.1 之后的源码编辑、保存保护、排版和批注卡片改进。

v0.9.0：重新接入 The Better Sidebar

• 通过 ctx.betterSidebar.registerFileViewer 注册 Markdown 预览器，接管 .md / .markdown；优先级 20，高于内置 Markdown 预览器。
• 移除直接注册原生 Sidebar tab 和标题 slot 的实现，由 Better Sidebar 负责文件路由与面板承载。
• 保留预览／源码切换、源码保存、块级和选区批注、批注清单及写入会话输入框草稿功能。
• 适配文件预览器的会话、路径与组件卸载生命周期；每 3 秒检查文件版本，遇到外部修改时保护未保存草稿。
• 注册通过 ctx.effect 自动清理，客户端通过 inject 等待 Better Sidebar 服务。

累计变更：v0.7.0–v0.8.1

以下为期间迭代的主要变化，现统一包含在 v0.9.0 安装包中。v0.7.0 的独立运行方式仅为历史演进，v0.9.0 已恢复依赖 Better Sidebar。

版本	主要变化
v0.7.0	重构文件读取、源码编辑、版本条件保存、工具栏和独立设置；同会话同文件共享草稿、版本与批注，不同会话隔离；增加 2 MiB 文件上限和外部修改冲突保护。当时采用的原生 Sidebar 独立接入方式已在本版替换。
v0.7.1	补齐 remote 服务依赖，修复打开 Markdown 时的 cannot get property "remote" without inject；增加实际文件读取的集成回归测试。
v0.7.2	正文、列表项和引用两端对齐，末行自然排版；支持长文本换行，修正列表正文右边界。
v0.8.0	批注改为右侧卡片，支持类型、原文引用、复制、写入草稿、编辑和删除；按原文位置排列并自动避让，窄视图支持横向滚动。
v0.8.1	从原文或精确选区绘制虚线至对应批注卡片；悬停或聚焦时加粗引导线，随侧栏宽度和卡片高度变化自动重算。

兼容与升级

• DSH：0.1.5-rc.1+；本次实际验收版本为 0.1.5-rc.2。
• The Better Sidebar：>=0.19.1 <0.20.0；本次实际验收版本为 0.19.1。
• Better Sidebar 声明为 optional peer，以避免安装重复实例；但批注预览功能需要其服务，未安装或禁用时不会激活。
• 从 v0.6.1 或旧 alpha 环境升级，先确认宿主及 Better Sidebar 版本满足上述范围。
• 升级前保存源码，并将需要保留的批注导出为 JSON。草稿和批注只保存在本次插件运行期内；当前不支持批注 JSON 导入。

安装 / 更新

下载本 Release 附件 dsh-md-annotator-0.9.0.tgz，放入 DSH Web profile 的 vendor 目录，然后执行：

dsh plugin --profile web add file:vendor/dsh-md-annotator-0.9.0.tgz

随后重启 dsh web，并在浏览器中硬刷新（Cmd/Ctrl+Shift+R）。

SHA-256：

56bae7e37bf48874f58ae1be2adee4acbf5408e5b5fd8d59bdb227fe8d8e8861  dsh-md-annotator-0.9.0.tgz

验证与边界

• smoke、unit、integration、host 测试通过。
• 浏览器回归覆盖批注卡片排序与避让、窄栏布局、选区批注、编辑删除、写入草稿、模式切换、外部修改冲突保护及卸载清理。
• 已在实际 DSH 0.1.5-rc.2 + Better Sidebar 0.19.1 环境验证 Markdown 接管、预览、源码编辑和测试文件保存落盘。
• 写入会话草稿不会自动发送；源码保存采用版本条件，冲突时不会自动覆盖外部修改。
• 单文件上限 2 MiB，Markdown 解析仍为 CommonMark 子集，不提供完整 GFM 或富文本编辑。

完整代码变更：v0.6.1…v0.9.0

v0.6.1 — 适配 dsh 0.1.2-alpha.4

适配 dsh harness 0.1.2-alpha.4。经逐触点核验（loader factory 形态、inject 三服务、registerFileViewer 契约、sessions.scope / conversation.input 写回链路、/sidebar/api/fs.write 路由），功能层面零代码改动即兼容，本版仅纠正代码内过时注释。

Changed

• 纠正 scripts/bundle.mjs 头注释与生成产物头部注释中的分发方式描述：dsh 0.1.2-alpha.4 起 client bundle 改为 combo URL（/plugins/??<id>/client.js,…&rev=<hash>）分发，裸路径 /plugins/dsh-md-annotator/client.js 404 属预期设计（仅作 source-map 回退名保留）。

安装

dsh plugin --profile web add file:./dsh-md-annotator-0.6.1.tgz

安装包校验

SHA-256: c4ccc608373a40afaabd66f0a5e53fe08fc1d338e2f0c3154628137047c01afd

v0.6.0 — Markdown 预览与源码编辑

更新内容

• 新增 Markdown 源码编辑模式：可在侧边栏预览/源码之间切换，支持 Cmd/Ctrl+S 与宿主保存按钮写回原 Markdown 文件。
• 复用 better-sidebar 的 toolbar: host 协议，不新增第二个 Markdown viewer，避免与已有编辑插件冲突。

安装包校验

SHA-256: 7e389c52e9ec65f6864b766fe39e586c67d5df80fa94fdd26cf7cfc18c9fff08

v0.3.4 — 底部批注栏可收起

本版包含 v0.3.3 + v0.3.4

v0.3.4

• 底部栏手柄改为抽屉惯例：展开显示 ﹀（点一下往下收），收起只显示 ︿（点一下往上开）。
• 去掉 ✍，收起状态也不再显示批注条数。

v0.3.3

• 底部批注操作栏可手动收起/展开，默认展开；开合状态按「会话 + 文件」记忆。
• 收起后「发送全部批注到对话框」不可见，避免误发。

安装

cp dsh-md-annotator-0.3.4.tgz ~/.dsh/profiles/web/vendor/
dsh plugin --profile web add file:vendor/dsh-md-annotator-0.3.4.tgz
# 重启 dsh web 并硬刷新浏览器

依赖：DSH web profile + 已挂载 dsh-better-sidebar。完整版本历史见 CHANGELOG.md。

v0.3.2 — 批注入口互斥与发送后自动清空

本版包含 v0.3.1 + v0.3.2 两项改进

v0.3.2

• 「发送后自动清空批注」默认改为开启：发送即交付，写入对话框草稿后自动清空本文件批注；修复多轮批注工作流中上一轮批注被一并发送的问题。需要跨轮累积批注时可在设置页（侧边栏「设置 → 侧边卡片」）关闭该开关。

v0.3.1

• 批注入口互斥：选中文字后（鼠标仍停留在块内）或批注编辑器打开期间，块级 hover「＋批注」按钮自动隐藏，同一时刻只保留一个明确入口，消除两个「＋」按钮同屏冲突。
• 选区批注视觉区分：选区批注条目增加琥珀色左边框（与"已批注块"视觉语言统一），配合引用行，与块级批注一眼区分。

安装

# 下载本页附件 dsh-md-annotator-0.3.2.tgz 后：
cp dsh-md-annotator-0.3.2.tgz ~/.dsh/profiles/web/vendor/
dsh plugin --profile web add file:vendor/dsh-md-annotator-0.3.2.tgz
# 重启 dsh web 并硬刷新浏览器

依赖：DSH web profile + 已挂载 dsh-better-sidebar。完整版本历史见 CHANGELOG.md。