@michengai/dsh-btw 0.1.24 → 1.0.0

package/CHANGELOG.md

@@ -1,5 +1,10 @@
 # Changelog
 
+## [1.0.0] - 2026-10-17
+
+- Supported hosts are now DeepSeek Harness `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`, and `0.2.1-rc.2`. Hosts before `0.2.0`, and `0.2.1` alphas, are rejected by the version gate, and the plugin will not load or run. Installed configuration and main-conversation records are kept. If you still use a `0.1.x` host, install plugin `0.1.24` instead of `@latest`.
+- `0.2.1-rc.1` and later use `startActivation`. `0.2.0-rc.1` and `0.2.0-rc.2` still use `subagents.start`.
+
 ## [0.1.24] - 2026-10-15
 
 - Side questions are no longer offered in a subagent session. Typing `/btw` there explains that you should return to the main session, instead of leaving a dialog that cannot be closed (#7).

package/CHANGELOG.zh-CN.md

@@ -1,5 +1,10 @@
 # 更新日志
 
+## [1.0.0] - 2026-10-17
+
+- 支持的宿主改为 DeepSeek Harness `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`、`0.2.1-rc.2`。`0.2.0` 之前的宿主，以及 `0.2.1` 的 alpha 会被版本门拒绝，插件不会加载、不会运行。已安装配置和主会话记录仍保留。仍在使用 `0.1.x` 的，请安装插件 `0.1.24`，不要装 `@latest`。
+- `0.2.1-rc.1` 起使用 `startActivation`。`0.2.0-rc.1` 与 `0.2.0-rc.2` 仍使用 `subagents.start`。
+
 ## [0.1.24] - 2026-10-15
 
 - 子代理会话不再提供旁问。在那里输入 `/btw` 会提示返回主会话使用，而不是留下关不掉的弹窗 (#7)。

package/README.md

@@ -16,7 +16,7 @@
 
 </div>
 
-> DSH BTW is a community-maintained DeepSeek Harness plugin, not an official DeepSeek AI product. Type `/btw your question` in the current conversation to get a context-aware answer in an independent bubble without interrupting the main task. Supports DSH Web and desktop apps that include DSH Web.
+> DSH BTW is a community-maintained DeepSeek Harness plugin, not an official DeepSeek AI product. Type `/btw your question` in the current conversation to get a context-aware answer in an independent bubble without interrupting the main task. Supports DSH Web and desktop apps that include DSH Web. From `1.0.0`, hosts outside the supported list are rejected by the version gate and the plugin will not run; installed configuration and main-conversation records are kept.
 
 ## Features
 
@@ -68,7 +68,8 @@ For a desktop workbench, download [DSH Codex Desktop](https://github.com/Micheng
 ## Prerequisites
 
 - An installed copy of DeepSeek Harness.
-- Host peers accept exactly `0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-alpha.2 || 0.2.1-alpha.3`.
+- Plugin `1.0.0` is tested with DeepSeek Harness `0.2.0-rc.1`, `0.2.0-rc.2`, `0.2.1-rc.1`, and `0.2.1-rc.2`.
+- Hosts before `0.2.0`, and `0.2.1` alphas, are no longer supported. The version gate rejects them, and the plugin will not load or run. Installed configuration and main-conversation records are kept. If you still use a `0.1.x` host, install plugin `0.1.24` instead of `@latest`.
 - Node.js 22+ and `dsh` available in your terminal.
 
 ## Installation
@@ -96,6 +97,8 @@ dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://regist
 
 Install or update after current tasks finish, as desktop apps may reload automatically. If the change has not taken effect, use the desktop app's reload action or restart the `dsh web` service. Refreshing the browser alone is not enough.
 
+Installing `@latest` on a host before `0.2.0`, or on a `0.2.1` alpha, is rejected by the version gate, and the plugin will not run. On `0.1.x`, install `0.1.24` instead. Rejection does not delete existing configuration or main-conversation records.
+
 ## Usage
 
 ### Ask about selected text
@@ -108,7 +111,7 @@ Select text within a single conversation message, choose **Ask BTW** from the co
 - **Add to conversation** appends a quote to the existing draft without sending. After insertion, focus returns to the composer; insertion is blocked while a message is being submitted. Right-click keeps the browser's native menu.
 - Keyboard selection is supported inside focused message elements: release Shift to focus the toolbar. Browsers without the Popover API use a fixed-position fallback, which may be clipped by the host layout.
 - Coexists with `dsh-better-sidebar`: BTW handles conversation text only; file previews and editors retain the sidebar plugin's own **Add to conversation** action without a duplicate toolbar.
-- This entry uses host DOM markers and has been verified in DSH `0.1.5-rc.2` with Edge, including the selection toolbar, draft insertion, question form, and a real-model answer. Unrecognized layouts keep their normal context menu; `/btw` remains available.
+- This entry uses host DOM markers. Unrecognized layouts keep their normal context menu; `/btw` remains available.
 
 ### Command entry
 
@@ -160,9 +163,7 @@ npm run check
 
 `npm run check` runs type checking, tests, and a build.
 
-Development and builds target `0.2.0-rc.2`. `npm run test:compat` builds with that baseline and runs the test suite on each of the eight isolated host versions, using a test model adapter. DOM component tests do not replace live-browser acceptance.
-
-Previous manual end-to-end acceptance with Edge and a live DeepSeek model passed on `0.1.5-rc.1`: side questions, attachment rejection, copying, collapse/expand, cancellation, and continued parent-session operation. This is not part of `npm run test:compat`. The selection toolbar, draft insertion, sidebar coexistence, and real-model side answers were subsequently checked on `0.1.5-rc.2`; the full end-to-end suite remains pending on that version and the older three versions.
+Development and builds target `0.2.1-rc.2`. `npm run test:compat` builds with that baseline and runs the test suite on each of the four isolated host versions, using a test model adapter. DOM component tests do not replace live-browser acceptance.
 
 GitHub and npm both include a ready-to-run `lib`; after changing source, run `npm run build` before committing.
 

package/README.zh-CN.md

@@ -16,7 +16,7 @@
 
 </div>
 
-> DSH BTW 是社区维护的 DeepSeek Harness 插件，并非 DeepSeek AI 官方产品。在当前会话中输入 `/btw 问题`，即可基于已有上下文获得独立气泡回答，不打断主任务。支持 DSH Web 及集成 DSH Web 的桌面应用。
+> DSH BTW 是社区维护的 DeepSeek Harness 插件，并非 DeepSeek AI 官方产品。在当前会话中输入 `/btw 问题`，即可基于已有上下文获得独立气泡回答，不打断主任务。支持 DSH Web 及集成 DSH Web 的桌面应用。`1.0.0` 起，不在支持列表中的宿主会被版本门拒绝，插件不会运行；已安装配置和主会话记录仍保留。
 
 ## 功能概览
 
@@ -68,7 +68,8 @@
 ## 前置条件
 
 - 已安装 DeepSeek Harness。
-- 宿主 peer 依赖精确声明为 `0.1.2-rc.1 || 0.1.5-rc.1 || 0.1.5-rc.2 || 0.1.5-rc.3 || 0.1.7-rc.1 || 0.1.7-rc.2 || 0.2.0-rc.1 || 0.2.0-rc.2 || 0.2.1-alpha.2 || 0.2.1-alpha.3`。
+- `1.0.0` 已验证兼容 DeepSeek Harness `0.2.0-rc.1`、`0.2.0-rc.2`、`0.2.1-rc.1`、`0.2.1-rc.2`。
+- 不再支持 `0.2.0` 之前的宿主，也不支持 `0.2.1` 的 alpha。这些宿主会被版本门拒绝，插件不会加载、不会运行。已安装配置和主会话记录仍保留。仍在使用 `0.1.x` 的，请安装插件 `0.1.24`，不要装 `@latest`。
 - Node.js 22+，可在终端执行 `dsh`。
 
 ## 安装
@@ -96,6 +97,8 @@ dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://regist
 
 请在当前任务结束后安装或更新，桌面应用可能自动重载。若未生效，使用桌面应用的“重新加载”，或重启 `dsh web` 服务；仅刷新浏览器不够。
 
+`0.2.0` 之前的宿主，以及 `0.2.1` alpha，安装 `@latest` 会被版本门拒绝，插件不会运行。`0.1.x` 请改装 `0.1.24`。拒绝不会删除已有配置或主会话记录。
+
 ## 使用
 
 ### 划词旁问
@@ -108,7 +111,7 @@ dsh plugin --profile web add @michengai/dsh-btw@latest --registry=https://regist
 - 横条还提供「添加到对话」，将引用追加到已有草稿并聚焦输入框，不自动发送；消息提交期间暂停添加。右键保留浏览器原有菜单。
 - 支持焦点位于正文元素内的键盘选区，释放 Shift 后聚焦横条。不支持 Popover API 的浏览器使用 fixed 浮层降级，可能受到宿主布局裁切。
 - 与 `dsh-better-sidebar` 分区域处理：BTW 仅处理会话正文，文件预览与编辑器保留侧边栏插件原有「添加到对话」选项，不重复弹出工具条。
-- 新入口依赖宿主正文 DOM 标记，已在 DSH `0.1.5-rc.2` + Edge 验证正文划词横条、添加引用、提问及真实模型回答；无法识别的布局保留原有右键行为，仍可使用 `/btw`。
+- 新入口依赖宿主正文 DOM 标记。无法识别的布局保留原有右键行为，仍可使用 `/btw`。
 
 ### 命令旁问
 
@@ -159,9 +162,7 @@ npm run check
 
 `npm run check` 执行类型检查、测试和构建。
 
-开发与构建基线为 `0.2.0-rc.2`。`npm run test:compat` 用该基线编译，再在八个隔离宿主版本中分别运行测试集，模型使用测试适配器。DOM 组件测试不替代真实浏览器验收。
-
-此前在 `0.1.5-rc.1` 上完成真实 Edge 与 DeepSeek 模型的手工端到端验收，旁问、附件拒绝、复制、折叠/展开、取消和父会话继续均通过。这不属于 `npm run test:compat`；随后在 `0.1.5-rc.2` 验证了划词横条、添加引用、侧边栏共存及真实模型旁问回答；该版本与旧三版的完整端到端用例仍未全部验收。
+开发与构建基线为 `0.2.1-rc.2`。`npm run test:compat` 用该基线编译，再在四个隔离宿主版本中分别运行测试集，模型使用测试适配器。DOM 组件测试不替代真实浏览器验收。
 
 GitHub 与 npm 都包含可直接运行的 `lib`；改了源码后，提交前运行 `npm run build`。