DSH 网页批注 0.2.2

这是一次必需的迁移，不是可选的升级：本包在启用期间替换官方 Browser、Chat 与 Layout 三个提供方，
而这三份提供方是从 Harness 源码派生重建的 —— 包里内嵌的是上游代码，不是薄薄的插件。
所以当宿主升到 0.2.1-alpha.2 时，旧包会被版本守卫明确拒绝（而不是装上后静默崩溃）：

dsh-web-annotator@0.2.1 与 DSH 0.2.1-alpha.2 不兼容（要求 … 0.2.0-rc.2 …）

本版把三个提供方重新对齐到 0.2.1-alpha.2，并更新 peerDependencies 与 engines。

• Browser 那半几乎没动：补丁涉及的 11 个 Browser 文件上游一处未改，补丁可直接应用 ——
  点选、框选、批注浮层、截图标注的行为与上一版相同。
• Chat 那半按上游重构重做：上游把消息流从 conversation.view 拆出独立的
  conversation.chat.flow（ChatNodeList 随之移入新文件 ChatFlow.tsx）。我们那条
  “识别用户正文并允许替换呈现”的链因此挂到新的 chat.flow 上，ChatView.tsx 与上游
  新版零差异 —— 是迁移，不是硬塞。
• cordis 随之升到 4.0.5-alpha.1（上游新基线的 peer 要求）。
• 文档、脚本、CI 与发布链里的目标版本全部对齐 0.2.1-alpha.2；
  宿主基线 commit 由 639ed01… 换成 d743267…。

验证：真实宿主（0.2.1-alpha.2 + 打包产物）26 项 Browser 检查通过、0 个页面错误；
存储回归 4 项通过；三个提供方的窄范围类型检查全过；补丁按精确基线校验通过（26 个文件）。

⚠️ 本版仍未验证：原生 Desktop、真实模型、兼容矩阵 —— 与 0.2.1 相同的边界，没有因为迁移而改变。

下载 dsh-web-annotator-0.2.2.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.1-alpha.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：7eb32ff21b195f6094f26f04624e6b4eca73c2d10a9181875dc26c9e6033f752

源码 ZIP dsh-web-annotator-source-0.2.2.zip 与验证记录对应标签 v0.2.2（提交 36faae1d2b1e01e039401f092904fcb2bc9dccda）；安装插件请选择 .tgz。本版是 0.2.2 稳定版。已验证到什么程度、哪些边界仍未验证，见 验证说明 —— 不要把未验证当已验证。

DSH 网页批注 0.2.1

插件行为没有变化，界面与 0.2.0 完全相同；本版只为把 README 修对。

• 截图全部换新。旧图停在 2026-10-04，早于输入框入口改成透明按钮，
  所以文档里展示的是用户已经拿不到的界面；其中一张还带着已退休的产品名与一条失败提示
  （那是验收脚本故意中断提交留下的横幅，适合当证据、不适合当宣传图）。
  新图按当前版本重截，并逐张裁到对应段落讲的那块区域 —— 整窗截图缩进文档栏后看不清。
• 排版：顶部加一句话定位与安装命令；“三步走”（选 → 写 → 发）逐张配图；
  “它能做什么”由七条长句改为表格。
• 修掉一个由换图引入的问题：npm 把相对路径的图重写成
  raw.githubusercontent.com/<repo>/HEAD/...，取的是仓库 HEAD 而不是包内副本，
  所以删掉「已发布 README 仍引用的文件名」会让线上页面出现破图。文件名已沿用，教训记进
  AGENTS.md 的「活跃坑」。

下载 dsh-web-annotator-0.2.1.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.0-rc.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：82f2a29f24d040162fbc5f6aa85e974617c8542c61e0dd3d8165cdcc2152c9c7

源码 ZIP dsh-web-annotator-source-0.2.1.zip 与验证记录对应标签 v0.2.1（提交 8def24e9690cbde65f0b1d05004f2ff0f25d31c0）；安装插件请选择 .tgz。本版是 0.2.1 稳定版。已验证到什么程度、哪些边界仍未验证，见 验证说明 —— 不要把未验证当已验证。

DSH 网页批注 0.2.0

把 0.2.0-alpha 系列收成一个稳定版：在 Harness 原有 Browser 里点选或框选网页元素、
就地评论或提问，再把标记截图或 DOM 定位资料发给当前会话。发布通道按版本号推导，
本版因此自动进 GitHub 的 Latest 与 npm 的 latest（见 发布链路）。

已验证：真实宿主（Harness 0.2.0-rc.2 + 打包产物）26 项 Browser 检查通过、
0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致；npm 与 Release 是同一份字节。
本机 web profile 也装过并确认界面正确。

⚠️ 仍未验证的边界（不要把本版当成这些也已验过）：

• 原生 Desktop：只验到 Web composition；Electron 截图边界由 Web 测试替代。
• 真实模型：验收用的是官方 replay 适配器，不是真实模型。
• 兼容矩阵：明确支持的 Harness / 浏览器 / 页面组合还没定。
  本版精确支持 Harness 内核 0.2.0-rc.2，其他版本未验。

逐项边界见 验证说明。

下载 dsh-web-annotator-0.2.0.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.0-rc.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：94bd50f0434d8f07af95c3d1156733eef768dc4e79434e84693918c8e23a8eef

源码 ZIP dsh-web-annotator-source-0.2.0.zip 与验证记录对应标签 v0.2.0（提交 708fc6480bc7887e5ebc0c32b33ceac8b5f83d07）；安装插件请选择 .tgz。本版是 0.2.0 稳定版。已验证到什么程度、哪些边界仍未验证，见 验证说明 —— 不要把未验证当已验证。

DSH 网页批注 0.2.0-alpha.13

• 发布链不再把 --prerelease 与 --tag alpha 写死在 workflow 里，改由版本号推导：
  带预发布段的版本 → GitHub 的 Pre-release + npm 的预览 dist-tag（alpha…）；
  稳定版 → Latest + latest。判断放在可测的 releaseChannel() 里。
  原先写死时，给稳定版打标签会发出一个「标着预发布、npm 上仍留在旧 alpha」的版本，
  而日志里看不出任何异常。
• Release 正文不再把稳定版称作“预览版”：措辞跟着通道走。
• 插件代码与宿主提供方没有变化，界面行为与 alpha.12 相同。

下载 dsh-web-annotator-0.2.0-alpha.13.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.0-rc.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：88e8989d3c41eb87955c3445d60fec687418b879adebf3eca7525cf67bf2e4d8

源码 ZIP dsh-web-annotator-source-0.2.0-alpha.13.zip 与验证记录对应标签 v0.2.0-alpha.13（提交 2e2c1e77e207012a3326a87eae0f27993a1a7a64）；安装插件请选择 .tgz。本版仍是 0.2.0-alpha.13 预览版，不代表已被市场收录。

DSH 网页批注 0.2.0-alpha.12

• 发布链路新增 npm 一路：推 v* 标签后，Release 建完再由 Trusted Publishing（OIDC）
  把同一份产物发到 npm 的 alpha dist-tag，仓库里不存 token（id-token: write + --provenance）。
  它排在建 Release 之后：npm 那半失败时用户仍拿得到安装包，也排除了「npm 有、GitHub 没有」。
• 本版是这条路径的第一次真实运行，兼作 npm Trusted Publisher 连接的激活发布 ——
  新建的连接有 2 天激活期，过期后连字段都不可改。
• 文档补上这轮踩到的三处，都写在 发布链路 与 AGENTS.md
  的「活跃坑」：本机 npm 指向镜像时登录/发布报 Public registration is not allowed；
  Trusted Publisher 的 Allowed actions 默认不含直接发布（漏勾则 CI 全绿而 npm 上没有新版本）；
  发布成功后头几分钟 npm install 会因传播延迟报 ETARGET，那不是失败。
• 插件代码与宿主提供方没有变化，界面行为与 alpha.11 相同。

下载 dsh-web-annotator-0.2.0-alpha.12.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.0-rc.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：c5a26ef88681866aa4caac20ccf1dcc65702b8f952d7cfbb0dbce25f0fb4df10

源码 ZIP dsh-web-annotator-source-0.2.0-alpha.12.zip 与验证记录对应标签 v0.2.0-alpha.12（提交 8010d6df465f712a7ad6eb71b3ce1ddf4c294997）；安装插件请选择 .tgz。本版仍是 0.2.0-alpha.12 预览版，不代表已被市场收录。

DSH 网页批注 0.2.0-alpha.11

• 输入框左侧的“批注网页”不再是一块恒有灰底的实心按钮。它原先借用了 variant="toolbar"
  —— 那是给 Browser 标签页工具栏准备的实心样式，放在输入框这一排会显得像被选中/按下，
  与旁边同样透明的“工作区内修改”不一致。现在改用 ghost：平时透明，悬停才显色。
• Browser 工具栏里的同一个按钮保持实心不变：那里与“刷新”同处一个工具栏表面，实心是对的。
  两处从此各用各的变体，不再共用。
• 只动 Client 半端。宿主提供方、补丁与存储格式都没变，因此这一版不影响已有草稿。

下载 dsh-web-annotator-0.2.0-alpha.11.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.0-rc.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：dea0a790b645654cef8a151e5231866ac9ec697d78a0fc4362ba6326e95ab464

源码 ZIP dsh-web-annotator-source-0.2.0-alpha.11.zip 与验证记录对应标签 v0.2.0-alpha.11（提交 21994fa5a7243d8bf4cabfae1d8a6e94f4368da7）；安装插件请选择 .tgz。本版仍是 0.2.0-alpha.11 预览版，不代表已被市场收录。

DSH 网页批注 0.2.0-alpha.10

• 本插件发出的批注消息不再平铺正文，改为默认显示“N 条注释”：展开后逐条给出序号、目标元素
  （最近候选元素的标签与文本，缺候选时回落到“框选区域”／“页面位置”）和你的评论或提问。
  定位资料仍是独立的折叠，默认收起。
• 图片模式与混合模式的附件在 Client 半端重画：在宿主截图之上叠加与附图序号一致的蓝底白字徽标，
  并补齐所选范围的蓝框；拿不到 canvas 或重画失败时保留宿主截图，证据不因绘制失败而丢失。
• 新增 annotation-thumbnail.ts（目标标签、徽标锚点、重画）与 tests/annotation-message.test.ts。
  序号只用于呈现：请求正文、screenshotIndex 与识别逻辑都不变，历史消息照旧折叠。
• 0.2.0-alpha.9 的改动一并随本版发布：那一版打好了包却从未发布过 Release，
  留着就会出现一个用户下不到的版本号。条目见下，不另发。

下载 dsh-web-annotator-0.2.0-alpha.10.tgz，在 DSH 插件管理页选择该本地包，再正常退出并重开 Desktop。一个包内含 Browser、Chat 与 Layout 扩展，用户不需要编译；卸载整个 bundle 并重启可恢复官方提供方。精确支持 Harness 内核 0.2.0-rc.2。

本版在发布链路里重新走了一遍门禁、真实 Chromium 存储回归与打包产物验收：26 项 Browser 检查通过，0 个页面错误；交付的 tgz 与验收时安装的运行时逐字节一致。

安装包 SHA-256：1d74fbd0f71f8f3ad0c67e9639f5dc35ed25c3bba6658c47126d5c1712537fa9

源码 ZIP dsh-web-annotator-source-0.2.0-alpha.10.zip 与验证记录对应标签 v0.2.0-alpha.10（提交 f14f24b75275f8d0e9127d2172b93403cd449572）；安装插件请选择 .tgz。本版仍是 0.2.0-alpha.10 预览版，不代表已被市场收录。

DSH 网页批注 0.2.0-alpha.8

在 Harness 原有 Browser 中批注网页并向当前会话提问。本次修复草稿可靠性和实际操作问题，并按问题分别提交修复。

这是 0.2.0-alpha.8 预览版，精确支持 Harness 内核 0.2.0-rc.2。

• 截图和文字改用 IndexedDB 保存，自动迁移旧草稿，保存失败会提示
• 修复中文输入法确认时误保存、目标删除后确认按钮仍可点击
• 混合批注保留可用截图并准确对应附图，纯图片请求不再受未发送的 DOM 大小限制
• 保存后可编辑，支持逐条勾选分批发送；满队列提前拦截，长批注的小窗口属性区保持可操作

下载 dsh-web-annotator-0.2.0-alpha.8.tgz，通过 DSH 插件管理安装本地包，再正常退出并重开 Desktop。一个包包含 Browser、Chat、Layout 扩展，无需用户编译；卸载整个 bundle 并重启可恢复官方提供方。

验证通过：44 项单元及真实 Vite 检查、4 项实际 Chromium 存储回归、24 项打包后真实 Harness Web 验收、官方 CLI 单包安装及卸载后冷启动。Windows 与 Linux 自动检查均通过。图片验收使用正式附件持久化流程，Web 测试替代了 Electron 捕获边界。

此版本未重新进行原生 Desktop 或真实模型验收，仍作为预览发布。市场尚未收录。旧 alpha.7 无法读取新的 IndexedDB 草稿，降级前请先发送需要保留的批注。

安装包 SHA-256：bcc685a8e2af7fce701a3324599136abf1d9165e46e169dcaec9945fc8db23bf

源码 ZIP 与发布标签均对应 f8ee395；JSON 文件提供产物哈希和验收记录。安装插件请选择 .tgz。

DSH Web Annotator 0.2.0-alpha.7

DSH 网页批注：在 Harness 原有 Browser 中点选或拖动框选网页，就地添加评论、向当前会话提问。按住空格键可暂时操作网页，支持发送标记截图、详细定位资料或两者一起发送。

这是 0.2.0-alpha.7 预览版，精确支持 Harness 内核 0.2.0-rc.2。一个预构建包包含插件和 Browser、Chat、Layout 扩展，不需要用户编译。

下载 dsh-web-annotator-0.2.0-alpha.7.tgz，通过 DSH 插件管理安装该本地包，或使用：

dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotator-0.2.0-alpha.7.tgz

正常退出并重开 Desktop。使用其他 Profile 时替换 desktop。旧本地 Layout Care 预览用户先移除 dsh-layout-care 和 dsh-layout-care-browser-preview，再安装新包。

该 bundle 在启用期间替换官方 Browser、Chat、Layout 提供方，尚未合入官方 Harness。卸载整个 bundle 并重启会恢复官方提供方。不要在其他内核版本或另一个同类提供方上混装。

Windows 验证：42 项单元及真实 Vite 检查、18 项真实 Harness Web 验收、通过官方 CLI 的单包安装与卸载后冷启动。图片附件走正式持久化流程；Web 测试只替代 Electron 捕获边界。原生点选和截图预览此前在旧名 alpha.6 的实际 Desktop 中验证过，alpha.7 未重新进行原生 Desktop 验收。

真实模型识图、修改源码、其他宿主版本和插件市场安装尚未验收。此 Release 不代表已被市场收录；新版 Community Market 需要稳定 npm latest，不能把这个 alpha 版本当作稳定版安装。

安装包 SHA-256：cdb1aed2c241808e945aac2194e0a94c760f9043c25dda1c4437ab309f91488f。

附带的源码 ZIP 用于开发和审阅，插件安装请选择 .tgz。

公开仓库的 Windows 与 Linux 自动检查均通过。源码 ZIP 包含主分支 494bdda 的 Windows 临时路径测试修复；安装包的运行代码与已验收产物一致。