dsh-web-annotator 0.2.0-alpha.13 → 0.2.1

package/CHANGELOG.md

@@ -1,5 +1,39 @@
 # Changelog
 
+## 0.2.1 — 文档与截图重做
+
+**插件行为没有变化**，界面与 0.2.0 完全相同；本版只为把 README 修对。
+
+- **截图全部换新**。旧图停在 2026-10-04，早于输入框入口改成透明按钮，
+  所以文档里展示的是用户已经拿不到的界面；其中一张还带着已退休的产品名与一条失败提示
+  （那是验收脚本故意中断提交留下的横幅，适合当证据、不适合当宣传图）。
+  新图按当前版本重截，并逐张裁到对应段落讲的那块区域 —— 整窗截图缩进文档栏后看不清。
+- **排版**：顶部加一句话定位与安装命令；“三步走”（选 → 写 → 发）逐张配图；
+  “它能做什么”由七条长句改为表格。
+- 修掉一个由换图引入的问题：npm 把相对路径的图重写成
+  `raw.githubusercontent.com/<repo>/HEAD/...`，取的是**仓库 HEAD** 而不是包内副本，
+  所以删掉「已发布 README 仍引用的文件名」会让线上页面出现破图。文件名已沿用，教训记进
+  [AGENTS.md](AGENTS.md) 的「活跃坑」。
+
+## 0.2.0 — 第一个稳定版
+
+把 `0.2.0-alpha` 系列收成一个稳定版：在 Harness 原有 Browser 里点选或框选网页元素、
+就地评论或提问，再把标记截图或 DOM 定位资料发给当前会话。发布通道按版本号推导，
+本版因此自动进 GitHub 的 Latest 与 npm 的 `latest`（见 [发布链路](docs/publishing.md)）。
+
+**已验证**：真实宿主（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**，其他版本未验。
+
+逐项边界见 [验证说明](docs/verification.md)。
+
 ## 0.2.0-alpha.13 — 发布通道按版本号推导
 
 - 发布链不再把 `--prerelease` 与 `--tag alpha` 写死在 workflow 里，改由版本号推导：

package/README.md

@@ -1,6 +1,7 @@
 # DSH Web Annotator · 网页批注与提问
 
-在 Harness 原有 Browser 标签页里，点击或框选网页，然后就地添加评论、向当前 Agent 提问。
+在 DeepSeek Harness **原有的 Browser 标签页**里点选或框选网页，就地写评论、向当前 Agent 提问，
+再把标记截图或 DOM 定位资料发给当前会话。
 
 [![Package checks](https://github.com/cslkkl/dsh-web-annotator/actions/workflows/ci.yml/badge.svg)](https://github.com/cslkkl/dsh-web-annotator/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
@@ -9,28 +10,44 @@
 
 **简体中文** · [English](README_en.md)
 
-![真实 Harness Browser 中的框选批注](docs/images/annotation-region.png)
+![在 Harness Browser 中框选页面并就地评论](docs/images/annotation-browser.png)
+
+```sh
+# 装这一个包，然后正常退出并重开 Desktop
+dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotator-<版本>.tgz
+```
+
+包内已有运行产物，不需要编译，也不需要放行构建脚本。完整说明见[安装](#安装)。
+
+## 三步走
+
+**1 · 选** —— 点元素、点空白位置，或拖动框选矩形区域。
+
+![点选元素或框选区域](docs/images/annotation-element.png)
+
+**2 · 写** —— 在选区旁写评论或提问；展开同一张卡片可看标签、颜色、字体，也能直接改。
+
+![展开属性卡片，调整颜色字体间距](docs/images/annotation-expanded.png)
+
+**3 · 发** —— 勾选要发的批注，选发送方式，预览后发到当前会话；聊天里收成“N 条注释”。
+
+![聊天里收成“N 条注释”](docs/images/annotation-message.png)
 
 ## 它能做什么
 
-- **就地批注**：点选元素、点击空白位置，或拖动框选矩形区域，在选区旁写评论或提问。
-- **边看边改属性**：展开同一张属性卡片调整颜色、字体、间距，改动随批注交给 Agent，保存前不改写网页。
-- **临时操作网页**：按住空格键与网页交互，松开回到批注；输入框里的空格照常打字。
-- **带图或带定位资料发送**：截图会用蓝框或蓝圈标出所选位置，并叠加与附图一致的序号徽标；
-  没有截图时可只发坐标与 DOM 证据，也可两者一起发。
-- **聊天里一眼看清**：本插件发出的批注消息只显示“N 条注释”，展开后逐条给出序号、目标元素与
-  你的评论／提问；完整定位资料仍在同一个折叠里。
-- **多条管理**：保存后可编辑、逐条勾选、分批发送；失败保留，成功只移除本次发出去的。
-- **草稿不丢**：按会话与完整 URL 存进 IndexedDB；发送失败或保存失败都不会清空内容。
-
-**0.2.0-alpha 是预览版，精确支持 Harness 0.2.0-rc.2。**
-一个预构建安装包同时包含插件和 Browser、Chat、Layout 扩展，安装后正常重启 Desktop 即可使用。
-扩展尚未合入官方 Harness；npm 尚未发布，插件市场尚未收录。
-每个版本的安装包与验证记录由[发布链路](.github/workflows/release.yml)在标签上构建并附到 Release。
+| 能力                 | 说明                                                                              |
+| -------------------- | --------------------------------------------------------------------------------- |
+| **就地批注**         | 点选元素、点击空白位置或拖动框选，在选区旁写评论或提问                            |
+| **边看边改属性**     | 展开同一张卡片调颜色、字体、间距，改动随批注交给 Agent，保存前不改写网页          |
+| **临时操作网页**     | 按住空格与网页交互，松开回到批注；输入框里的空格照常打字                          |
+| **带图或带定位资料** | 截图用蓝框或蓝圈标出所选位置，并叠加与附图一致的序号徽标；也可只发坐标与 DOM 证据 |
+| **聊天里一眼看清**   | 批注消息默认只显示“N 条注释”，展开后逐条给出序号、目标元素与你的评论／提问        |
+| **多条管理**         | 保存后可编辑、逐条勾选、分批发送；失败保留，成功只移除本次发出去的                |
+| **草稿不丢**         | 按会话与完整 URL 存进 IndexedDB；发送或保存失败都不会清空内容                     |
 
 ## 安装
 
-从 [预览 Release](https://github.com/cslkkl/dsh-web-annotator/releases) 下载最新 `dsh-web-annotator-*.tgz`，
+从 [Releases](https://github.com/cslkkl/dsh-web-annotator/releases) 下载最新 `dsh-web-annotator-*.tgz`，
 在 DSH 插件管理页选择该本地包，或使用官方 CLI：
 
 ```sh
@@ -38,18 +55,20 @@ dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotat
 ```
 
 只装这一个包，然后正常退出并重开 Desktop。使用其他 Profile 时替换 `desktop`。
-包内已有运行产物，不需要用户编译或放行构建脚本。
 
 该 bundle 在启用期间**替换官方 Browser、Chat 和 Layout 提供方**。
 请先确认 Harness 内核是 **0.2.0-rc.2**，不要在其他版本或另一套同类提供方上混装。
 卸载整个 bundle 会撤销这些替换，重启后恢复官方提供方。
 
 旧本地预览用户先移除 `dsh-layout-care` 和 `dsh-layout-care-browser-preview` 再安装新包。
-已有批注会自动迁移。详见 [安装和市场发布](docs/distribution.md)。
+已有批注会自动迁移。详见[安装和市场发布](docs/distribution.md)。
 
 ## 使用方式
 
 1. 在当前会话点击“批注网页”，打开 Harness 原有的 Browser。
+
+   ![输入框里的“批注网页”入口](docs/images/annotation-entry.png)
+
 2. 输入网页地址，点击工具栏中“刷新”左边的“批注网页”。
 3. 点击元素或空白位置，或者拖动鼠标框选区域，在选区旁输入内容。
 4. 浮层默认只有选项图标、输入区和圆形 ✓。点左侧图标展开属性卡片，查看标签、颜色、字体等，
@@ -58,13 +77,13 @@ dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotat
 5. 需要操作网页时按住空格键，松开回到批注。
 6. 保存后可编辑文字，勾选本次要发送的批注，再选择发送方式，预览后发送到当前会话。
 
-![实际展开的属性卡片](docs/images/annotation-expanded.png)
-
 图片通过 Harness 的正式图片附件流程发送。图片模式只发批注正文、网页 URL 和对应截图；
 详细模式保留坐标与 DOM 证据，但聊天默认只显示“N 条注释”，点击展开逐条卡片（序号、目标元素、
 评论或提问），再点“查看定位资料”展开完整请求；附件截图上的序号与卡片序号一致。
 模型能否直接识别图片取决于当前模型的图片能力。
 
+![图片模式的发送预览](docs/images/annotation-image.png)
+
 ## 当前支持范围
 
 | 能力                                           | 状态                                     |
@@ -79,7 +98,7 @@ dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotat
 | 其他远程页面                                   | 逐个页面分别验收；Web 仍受跨源与嵌入限制 |
 | iframe 内部与 closed Shadow DOM 的子元素       | 只定位外层载体，不能穿透                 |
 
-逐项的验证边界与手工清单见 [验证说明](docs/verification.md)。
+逐项的验证边界与手工清单见[验证说明](docs/verification.md)。
 
 ## 接入自己的 Vite 页面
 
@@ -95,6 +114,28 @@ export default defineConfig({ plugins: [webAnnotator()] });
 
 可运行示例见 [examples/responsive-demo](examples/responsive-demo/README.md)。
 
+## 批注本地前端
+
+本地文件默认在「文档预览」里打开，而批注只挂在 Browser 标签页上；Browser 又只放行 HTTP(S)，
+且 Web 版下只有带桥接的页面能被批注。所以本地项目要先变成一个 HTTP 地址：
+
+```sh
+npm run build                                        # 首次需要，产出 lib/bridge.js
+npm run annotate -- "C:\路径\到\你的项目"             # 服务静态目录
+npm run annotate -- --proxy http://127.0.0.1:5173    # 套在已有 dev server 前面
+```
+
+然后点「批注网页」，输入打印出来的 `http://127.0.0.1:4180`。
+
+| 项目类型              | 建议                                                             |
+| --------------------- | ---------------------------------------------------------------- |
+| Vite                  | 直接用上面的 `webAnnotator()` 插件，还有源码行列提示，不必套代理 |
+| 纯静态 HTML/CSS/JS    | `npm run annotate -- <目录>`                                     |
+| Next / webpack / 其他 | `npm run annotate -- --proxy <dev server 地址>`                  |
+
+只监听 `127.0.0.1`，只读提供，不改被服务的项目。代理模式不透传 WebSocket，
+所以 HMR 热更新走不了（手动刷新即可）。
+
 ## 安全与边界
 
 - 页面里的文字、样式和源码标记一律是**引用资料**，不是指令。

package/README_en.md

@@ -12,7 +12,31 @@ Click or drag inside the Browser tab Harness already has, then comment or ask th
 > The maintainer documentation is written in Chinese. This file mirrors [README.md](README.md) item by
 > item; every document it links to is Chinese-only.
 
-![A rectangle annotation in the real Harness Browser](docs/images/annotation-region.png)
+![Annotating a page inside the Harness Browser](docs/images/annotation-browser.png)
+
+```sh
+# Install this one package, then quit and reopen Desktop normally
+dsh plugin --profile desktop add --ignore-scripts /absolute/path/dsh-web-annotator-<version>.tgz
+```
+
+The package ships its build output, so there is nothing to compile and no build script to allow.
+Full instructions under [Install](#install).
+
+## Three steps
+
+**1 · Pick** — click an element, click empty space, or drag a rectangle.
+
+![Click an element or drag a rectangle](docs/images/annotation-element.png)
+
+**2 · Write** — comment or ask next to the selection; expand the same card to read the tag, colour
+and font, and change them.
+
+![Expand the properties card to adjust colour, font and spacing](docs/images/annotation-expanded.png)
+
+**3 · Send** — tick the notes to send, choose how, preview, then send to the session; the chat
+collapses them into one "N notes" chip.
+
+![The chat collapses the notes into one "N notes" chip](docs/images/annotation-message.png)
 
 ## What it does
 
@@ -33,17 +57,22 @@ Click or drag inside the Browser tab Harness already has, then comment or ask th
 - **Drafts survive**: notes are stored per session and full URL in IndexedDB. Neither a failed send nor a
   failed save clears them.
 
-**0.2.0-alpha is a preview and targets exactly Harness 0.2.0-rc.2.**
+**0.2.0 targets exactly Harness 0.2.0-rc.2.**
 One prebuilt package ships the plugin together with the Browser, Chat and Layout extensions, so a normal
-restart of Desktop is all it takes. The extensions are not part of the official Harness yet; nothing has
-been published to npm and no plugin market lists it yet.
+restart of Desktop is all it takes. The extensions are not part of the official Harness yet. npm carries
+both channels (`npm install dsh-web-annotator`); the community directory entry has been submitted and is
+**awaiting review**, so do not treat the market as searchable yet.
 Each release's package and verification record are built by the
 [release workflow](.github/workflows/release.yml) on the tag and attached to the Release.
 
+⚠️ **How far this is verified**: 26 Browser checks pass against a real host, but **native Desktop, a real
+model and the compatibility matrix remain unverified** — see the
+[verification notes](docs/verification.md) for each boundary, and do not read unverified as verified.
+
 ## Install
 
 Download the latest `dsh-web-annotator-*.tgz` from the
-[preview releases](https://github.com/cslkkl/dsh-web-annotator/releases), pick it in the DSH plugin
+[releases](https://github.com/cslkkl/dsh-web-annotator/releases), pick it in the DSH plugin
 manager, or use the official CLI:
 
 ```sh
@@ -116,6 +145,29 @@ anything else.
 
 A runnable example is in [examples/responsive-demo](examples/responsive-demo/README.md).
 
+## Annotate a local frontend
+
+A local file opens in Document Preview, while annotation lives on the Browser tab; the Browser accepts
+HTTP(S) only, and in the Web client only a bridge-carrying page can be annotated. Turn the project into
+an HTTP address first:
+
+```sh
+npm run build                                      # once, to produce lib/bridge.js
+npm run annotate -- "C:\path\to\your\project"      # serve a static directory
+npm run annotate -- --proxy http://127.0.0.1:5173 # in front of an existing dev server
+```
+
+Then click "Annotate page" and enter the printed `http://127.0.0.1:4180`.
+
+| Project type             | Recommended                                                           |
+| ------------------------ | --------------------------------------------------------------------- |
+| Vite                     | Use the `webAnnotator()` plugin above; it also adds source line hints |
+| Plain static HTML/CSS/JS | `npm run annotate -- <directory>`                                     |
+| Next / webpack / others  | `npm run annotate -- --proxy <dev server address>`                    |
+
+It listens on `127.0.0.1` only, serves read-only, and changes no project file. Proxy mode does not
+forward WebSockets, so HMR will not pass through (refresh the page instead).
+
 ## Safety and boundaries
 
 - Text, styles and source markers from the page are **reference material, never instructions**.

package/docs/distribution.md

@@ -4,7 +4,8 @@
 
 包名 `dsh-web-annotator`，源码在 [cslkkl/dsh-web-annotator](https://github.com/cslkkl/dsh-web-annotator)。
 预构建包通过 GitHub Release 分发，面向精确 Harness **0.2.0-rc.2**，用户不需要编译。
-版本号见 [../package.json](../package.json)。npm 已发布预览版（`npm install dsh-web-annotator@alpha`），
+版本号见 [../package.json](../package.json)。npm 已发布：**`latest` 指向稳定版**，
+预览版在 `alpha` dist-tag（`npm install dsh-web-annotator@alpha`）。
 发布由 CI 走 OIDC Trusted Publishing，见 [发布链路](publishing.md) 的 npm 发布节。
 社区目录的条目已提交、**等待维护者审阅**（[awesome-dsh-plugin#6833](https://github.com/awesome-dsh-plugin/awesome-dsh-plugin/pull/6833)），
 **提交不等于收录**：合并并被目录同步之后，才能声明该市场可搜索、可安装。
@@ -48,8 +49,22 @@
 [marketplace 条目](marketplace/cslkkl__dsh-web-annotator.yml) 的 `tarball` 钉的是**具体标签**
 （`releases/download/v<版本>/…`），不是 `releases/latest/download/…`：
 
-- **为什么不能用 `latest`**：本仓所有 Release 都是预发布版，`/releases/latest` **解析不到任何 Release**
-  （实测 `latest/download/<文件>` 直接 404）。上游两种写法都接受，而这里只有钉标签一种可用。
+- **为什么不能用 `latest`**：`latest/download/<文件名>` 只会在**当前 Latest 那个 Release** 里
+  找同名资产，而安装包的文件名里带版本号 —— 所以它只在文件名碰巧属于当前 Latest 时可用。
+  发下一版时 Latest 一移动，旧文件名就 404：
+
+  ```
+  Latest = v0.2.0 时的资产名：
+    dsh-web-annotator-0.2.0.tgz          ← 滚动链接能找到
+    dsh-web-annotator-source-0.2.0.zip
+    dsh-web-annotator-verification-0.2.0.json
+  换成 v0.2.1 之后，上面这些名字全部 404。
+  ```
+
+  也就是说滚动链接不会「一劳永逸」，只会在发下一版时**静默 404**。
+  （判据是 `gh api repos/<owner>/<repo>/releases/latest --jq '.assets[].name'` ——
+  不依赖网络实测，只看资产清单就能判定。）
+
 - **代价**：钉标签意味着**每发一版都要同步改这一行**，否则市场指向的是旧包。
   上游的每日探测会在 URL 404 时把 tarball 从站点上摘掉（不会报错，只是静默回落成源码安装），
   所以这行漏改不会有红信号 —— 判据是发版后手跑一次

package/docs/marketplace/cslkkl__dsh-web-annotator.yml

@@ -1,7 +1,7 @@
 url: https://github.com/cslkkl/dsh-web-annotator
 name: cslkkl/dsh-web-annotator
 category: browser
-tarball: https://github.com/cslkkl/dsh-web-annotator/releases/download/v0.2.0-alpha.13/dsh-web-annotator-0.2.0-alpha.13.tgz
+tarball: https://github.com/cslkkl/dsh-web-annotator/releases/download/v0.2.1/dsh-web-annotator-0.2.1.tgz
 description:
   en: 'Annotate pages inside the existing Harness Browser: click or drag to select, comment or ask, then send marked screenshots or DOM location details to the current session. While enabled it replaces the official Browser, Chat and Layout providers; targets Harness 0.2.0-rc.2.'
   zh: '在 Harness 原有 Browser 内批注网页：点选或框选后就地评论、提问，可把标记截图或 DOM 定位资料发给当前会话；启用期间替换官方 Browser、Chat 与 Layout 提供方，精确支持 Harness 0.2.0-rc.2。'

package/docs/verification.md

@@ -89,6 +89,49 @@ npm run verify:delivery
 
 明细落在本地未入库的 `integration/*.json`；这里只留可复述的结论。
 
+### 0.2.0（2026-10-12）
+
+第一个稳定版。改动只有版本号与文档：发布通道按版本号推导，所以本版自动进 GitHub 的 **Latest**
+与 npm 的 **`latest`**（不需要改 workflow —— 那正是上一版改动的目的）。
+
+| 项目                      | 结果                                                         |
+| ------------------------- | ------------------------------------------------------------ |
+| 发布链                    | 通过；通道判断为 `prerelease=false / npmTag=latest`          |
+| `npm run test:acceptance` | **26 项 Browser 检查通过**，0 个页面错误                     |
+| npm ↔ Release 字节一致    | 由同一次 CI 构建与验收，逐字节相同                           |
+| GitHub 的 Latest          | 本版之后 `/releases/latest` 才第一次能解析（此前全是预发布） |
+
+⚠️ **本版不声称下面三项已验证** —— 它们正是"稳定版"这个词最容易被误读的地方，逐项写清：
+
+| 边界         | 状态                                                                 |
+| ------------ | -------------------------------------------------------------------- |
+| 原生 Desktop | **未验证**；只验到 Web composition，Electron 截图边界由 Web 测试替代 |
+| 真实模型     | **未验证**；验收用官方 replay 适配器                                 |
+| 兼容矩阵     | **未定**；精确支持 Harness 0.2.0-rc.2，其他版本未验                  |
+
+### 0.2.0-alpha.13（2026-10-12）
+
+本轮把**发布通道改成按版本号推导**：带预发布段的版本 → GitHub 的 Pre-release + npm 的预览
+dist-tag；稳定版 → Latest + `latest`。判断在可测的 `releaseChannel()` 里，判据见
+[tests/release-notes.test.ts](../tests/release-notes.test.ts)。
+
+原先两处写死在 workflow 里（`--prerelease` 与 `--tag alpha`），后果是**给稳定版打标签会发出
+一个「标着预发布、npm 上仍留在旧 alpha」的版本，而日志里看不出任何异常** —— 这类判断必须可测，
+所以它从 YAML 搬进了脚本。
+
+| 项目                      | 结果                                                                                     |
+| ------------------------- | ---------------------------------------------------------------------------------------- |
+| 发布链                    | 通过；注解 `published 0.2.0-alpha.13 to npm under the alpha dist-tag`                    |
+| `npm run test:acceptance` | **26 项 Browser 检查通过**，0 个页面错误（本机也跑了一遍，同样 26 项）                   |
+| **通道按版本号生效**      | Release `prerelease=true`、npm `alpha` 指向 alpha.13，而 `latest` **未被抢**（仍在旧版） |
+| npm ↔ Release 字节一致    | `18e02e6a…`（两处 SHA-1 相同）                                                           |
+
+⚠️ **第一次运行在验收步骤失败，第二次通过，其间没有改任何代码。** 失败原因是浏览器控制台
+报了一个 `404`，而 Chrome 的那条消息**不带 URL**，所以当时无法判断是哪个资源。这暴露的是
+**诊断缺陷**而不是产品缺陷：现在脚本会记录 4xx/5xx 响应的 URL，断言消息会把它带出来，
+`report.json` 里也留一份 `failedResponses`（通过时也留，好让"断言之后才到达的偶发 404"有痕迹）。
+判定仍是 `errors` 必须为空 —— 只加证据，不放宽标准。
+
 ### 0.2.0-alpha.12（2026-10-12）
 
 本轮**不改插件代码**（界面行为与 alpha.11 相同），改的是发布链路：新增 npm 一路，

package/lib/host/bundle.json

@@ -1,6 +1,6 @@
 {
   "packageName": "dsh-web-annotator",
-  "packageVersion": "0.2.0-alpha.13",
+  "packageVersion": "0.2.1",
   "targetHarness": "0.2.0-rc.2",
   "upstreamCommit": "639ed015397290b3745d163aafe02ffee4aa3f84",
   "patchSha256": "b8701aa99139478e2b17a78a3d75bc22d2bce9d6c6952d1f2551271d7211a63f",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-web-annotator",
-  "version": "0.2.0-alpha.13",
+  "version": "0.2.1",
   "description": "Click or drag to annotate pages in the existing DeepSeek Harness Browser and ask the current agent.",
   "license": "MIT",
   "type": "module",
@@ -62,6 +62,7 @@
     "check:doc-paths": "node scripts/check-doc-paths.mjs",
     "verify:artifacts": "node scripts/verify-artifacts.mjs",
     "demo": "vite --config examples/responsive-demo/vite.config.ts",
+    "annotate": "node scripts/annotate-serve.mjs",
     "test:browser": "node scripts/annotation-acceptance.mjs",
     "test:harness": "node scripts/harness-replay-test.mjs",
     "test:acceptance": "node scripts/annotation-acceptance.mjs",

package/screenshots.json

@@ -1,7 +1,9 @@
 [
-  "docs/images/annotation-region.png",
+  "docs/images/annotation-browser.png",
+  "docs/images/annotation-element.png",
+  "docs/images/annotation-entry.png",
   "docs/images/annotation-expanded.png",
-  "docs/images/annotation-expanded-dark.png",
   "docs/images/annotation-image.png",
-  "docs/images/annotation-message.png"
+  "docs/images/annotation-message.png",
+  "docs/images/annotation-region.png"
 ]