dsh-sidenote 0.4.5 → 0.5.0

package/README.md

@@ -50,8 +50,12 @@ dsh plugin --profile web add dsh-sidenote
 ## 划选注释——把「这句有问题」变成模型的上下文
 
 - 划选 assistant 回复 → 浮层 → 注解编辑器，右缘编号角标锚定原文；
-- 注释是受控对象（可预览、可逐条移除），**草稿零污染**——发送瞬间才序列化为模型可读的结构化协议块；
-- 发送后气泡收成「批注 ×N」标签留痕；刷新不丢。
+- 添加到主对话或侧边聊天都保存为同一类受控注释，使用同一套 chip 预览、逐条移除及批量清空；引用和注解全文保留，**草稿零污染**，可只发送引用；
+- 新建注解点击编辑器外部或按 Enter 保存，Esc 明确取消；主→侧先等待选定 Tab 的真实子会话，等待期间可按 Esc 取消，失败则保留注解并提示重试；
+- 通过宿主原生输入机发送，保留 `@` 引用、图片附件和队列/steer 仲裁；目标会话出现持久消息或真实队列记录后，这一批注释才标为已发送，气泡收成「批注 ×N」留痕；
+- 保存的注释按目标会话隔离；存储不可用时提示仅保存在内存。发送失败保留注释与正文，提交期间新增或修改的注释留给下一条消息。
+- 侧边 assistant 正文也支持局部划选、多段落、列表与代码引用，入口只向所在侧聊添加；继承历史同样归当前子会话。流式、跨消息、思考和控件不作为引用。角标与高亮跟随来源消息并裁剪到其可见区域；原文折叠时注释仍在 chip 中。
+- 已保存注释刷新后保留。宿主恢复原生 tab 时重新绑定原子会话；未恢复侧栏时，可用 `/side` 中的“重开”恢复原子会话及注释。新建 fork 使用自己的独立注释列表。
 
 | 划选浮层 | 注解编辑器 |
 |---|---|
@@ -73,14 +77,11 @@ dsh plugin --profile web add dsh-sidenote
 
 ## 兼容性
 
-| DSH | dsh-better-sidebar | 行为 |
-|---|---|---|
-| ≥ 0.1.5-rc.1 | 任意（无需安装） | **直连 DSH 原生右侧边栏** |
-| ≤ 0.1.2-rc.x | ≤ 0.18.x（必需） | legacy 布局承载 |
+维护范围按精确组合列在[兼容与维护政策](docs/compatibility.md)：0.1.7 当前维护，0.1.5 延长维护，0.1.1/0.1.2 的三组旧路径冻结且保留必需验收，0.2.0-rc.2 已通过精确准入并纳入当前维护。未列组合不作已验证承诺；安装引擎范围不代表其中所有版本均兼容。
 
-宿主面缺席时插件按能力降级（不崩页面）；与 dsh-better-sidebar 天然共存（各自注册、互不依赖）。
+诊断默认关闭。排障时在 **设置 → 通用设置 → dsh-sidenote 诊断模式** 手动开启，顶栏才会出现“兼容诊断”，可查看、重查或导出当前接入状态。选择仅保存在当前浏览器、当前 DSH 地址，刷新后保留；无法本地保存时只在当前页生效。关闭诊断不影响能力检测、输入恢复或失败时的内容保留，也不修改宿主的全局开发者开关。服务尚未就绪不等于不兼容；无法读取的宿主版本显示未知。报告手动下载，不包含用户正文、凭证或本机路径。
 
-**单实例语义（直连腿）**：受宿主「page kind 每 pane 单实例」规则约束——同一会话同时只开一个侧边聊天（再次打开/新建 = 聚焦既有 tab；关闭后可经 /side 重开恢复原会话）。多开诉求可用原生侧栏的分栏（每 pane 一个），多实例将随宿主 `multiple` 能力（0.1.6）恢复。
+原生右栏无需 BS；旧版依赖表中的 BS 组合。原生 page kind 每 pane 一个，分栏可容纳多个 pane；普通入口聚焦既有 tab，关闭后 `/side` 重开原 child。其他 BS 共存或未来 `multiple` 能力需单独验收。
 
 ## 设计要点
 
@@ -93,37 +94,15 @@ dsh plugin --profile web add dsh-sidenote
 | 命令 | 说明 |
 |---|---|
 | `pnpm typecheck` | tsc --noEmit |
-| `pnpm test` | vitest 单测（222 例） |
+| `pnpm test` | vitest 单测（先运行 build） |
 | `pnpm build` | 类型声明 + tsdown（host ESM + client CJS bundle，纯度门） |
-| `pnpm test:mount` | 挂载冒烟：真实 `dsh web` + 伪造会话日志 + Playwright 十条 journey lane（`BS_VERSION`/`DSH_CMD` 切版本矩阵） |
+| `pnpm test:mount` | 真实 `dsh web` + 种子会话 + Playwright 挂载与交互验收（`BS_VERSION`/`DSH_CMD` 切版本矩阵） |
 
-问题与建议欢迎 [Issue](https://github.com/g-yixuan/dsh-sidenote/issues)。
+## 参与贡献
 
-## 发版
+欢迎报告问题、提出需求、协助复现、改进文档和提交代码。请从 [Issue 入口](https://github.com/g-yixuan/dsh-sidenote/issues/new/choose) 或[贡献指南](CONTRIBUTING.md)开始；中文和 English 都可以。
 
-发布走 [npm Trusted Publishing](https://docs.npmjs.com/trusted-publishers)（OIDC）：**不需要 npm token，不需要 OTP，本地不需要登录 npm**。`.github/workflows/release.yml` 拿 GitHub Actions 的 OIDC 身份直接换发布权限，并附 SLSA provenance。
-
-> **触发条件是「发布一个 GitHub Release」，不是推 tag。**
-> 只 `git push --tags` 不会发布任何东西——tag 会静静躺在那里。
-
-```bash
-# 1. 改 package.json 的 version，提交
-git commit -am "release: vX.Y.Z——<摘要>"
-
-# 2. 打 tag 并推送（这一步还没有发布）
-git tag vX.Y.Z && git push origin main --tags
-
-# 3. 创建 GitHub Release —— 这一步才真正触发发布
-gh release create vX.Y.Z --title "vX.Y.Z — <标题>" --notes-file <notes.md>
-```
-
-workflow 随后自动跑 build → typecheck → test → `pnpm publish --provenance`，并校验 tag 与 `package.json` 版本一致（不一致直接失败）。
-
-几个已知的坑：
-
-- **registry 有复制延迟**：workflow 显示 `✅ Published` 后，`npm view` 仍可能有 1–5 分钟看到旧版本（Fastly `max-age=300`）。以 workflow 日志为准，不要据此判断失败而重试。
-- **别去折腾 npm token**：npm 正在[系统性废止 bypass-2FA 的 granular token](https://github.blog/changelog/2026-07-31-restricting-npm-bypass-2fa-granular-access-tokens/)。本仓库不依赖任何 token，发布失败请先看 workflow 日志，而不是 token 配置。
-- **CI 的 `plugin-mount` lane 失败不阻塞发版**：那是独立 workflow，Release 流程只跑单测，不跑 e2e。
+维护者见[仓库维护](docs/maintaining.md)和[发布指南](docs/releasing.md)。
 
 ## License