dsh-select-quote 0.3.5 → 0.3.7

package/README.md

@@ -38,9 +38,9 @@ dsh web --patch "$PWD/dev.patch.yml"
 
 ## 用法
 
-1. 在对话区选中一段文本，点「添加到任务」
-2. 在弹出的评论框里写一句想说的话（可留空，只划不评），`⌘/Ctrl + Enter` 确认
-3. 输入框上方出现批注卡片：悬停展开列表，可逐条编辑、删除或一键清空，点条目跳回正文对应文字
+1. 在对话区选中一段文本，点「添加到任务」——到这一步批注就已经保存，输入框上方同步出现摘要卡片
+2. 想补充的话在弹出的评论框里写一句，点「添加评论」或 `⌘/Ctrl + Enter`；不写就直接点空白处或「暂不评论」，批注同样保留
+3. 悬停摘要卡片展开列表，可逐条编辑、删除或一键清空，点条目跳回正文对应文字
 4. 正常打字发送，批注随消息一起交给模型，卡片随之消失
 5. 模型回答里引用某条批注的位置显示为可点击 chip
 
@@ -48,10 +48,19 @@ dsh web --patch "$PWD/dev.patch.yml"
 
 界面语言由 dsh 决定，插件不再自己判断浏览器语言。在 **设置 → 通用 → 语言** 里切换。
 
+## 插件页展示
+
+插件管理页与设置项里的标题、描述、图标来自包自带的资源，宿主读取它们时**不会激活插件**：
+
+- `locale/*.json` 的 `meta.title` / `meta.description`（`en.json` 是发现入口，其余语言文件与它同目录同名）
+- `icon.svg`（SVG / PNG / JPEG / WebP，≤256 KiB，必须在包内）
+
+标题按当前语言取，取不到回退 `package.json` 的 `name` / `description`；图标缺失时用面板的默认插画。要加一种语言，往 `locale/` 放一个同名 JSON 即可，`pnpm run check` 会按宿主的规则逐条校验（语言 id 文件名、字段非空、图标类型与体积、`exports` 与 `files` 覆盖、`npm pack` 实际清单）。
+
 
 ## 已知限制
 
-- **待发批注按会话持久化**：刷新页面、重启客户端后回到原会话，未发送的批注会原样回来（和草稿同一套机制）；保留最近 20 个会话、7 天。发送即清除，切换会话跟着切，hero 里换工作区等于换会话，批注不跟着搬。
+- **待发批注按会话持久化**：刷新页面、重启客户端后回到原会话，未发送的批注会原样回来（与草稿同在 localStorage，键各自独立）；保留最近 20 个会话、7 天。发送即清除，切换会话跟着切，hero 里换工作区等于换会话，批注不跟着搬。
 - **占用了用户气泡的渲染**：本插件以最低优先级替换内置 `user` 节点。其它插件若替换同一个键（例如 `dsh-easyrewrite` 用 `-1`），会被本插件屏蔽。
 - **卡片宽度有限**：输入框内每条摘要最宽约为输入框的 1/4，超长标题走省略号。
 - **划词只在对话区生效**：不介入编辑器、终端等面板。
@@ -60,7 +69,9 @@ dsh web --patch "$PWD/dev.patch.yml"
 
 **升级 dsh 之后功能不对？** 先 `pnpm run check`；产物没问题就对照 [`docs/internals.md`](docs/internals.md) 的「依赖的产品内部约定」逐条复核，那里列了所有产品内部名。
 
-**划词没有工具条？** 确认选区在对话区而不是编辑器里；刷新页面（样式与观察者是幂等注入的）；宿主 boot 日志里应出现 `dsh-select-quote`。
+**划词没有工具条？** 确认选区在对话区而不是编辑器里；刷新页面（样式与观察者是幂等注入的）；宿主 boot 日志里应出现 `dsh-select-quote`。工具条挂在对话滚动区里，随正文一起滚动，滚到顶部会像正文一样滑进 header 下面；选中行完全滚出视口后收起，滚回去重新出现。
+
+**点空白处批注会丢吗？** 不会。点「添加到任务」时批注已经保存，空白点击只关闭评论框；已经写了一半的评论会一并保存到那条批注上。
 
 **输入框里出现了协议原文？** 发送前的注入没生效，一般是 composer 结构变了——检查 `[data-composer-card]` 是否还在。
 
@@ -80,7 +91,7 @@ pnpm run watch     # 增量重建
 
 依赖用 pnpm 管理（锁文件 `pnpm-lock.yaml`）；构建产物 `lib/` 随源码一起提交，运行时直接读它。
 
-`pnpm run verify` 无头执行产物，断言 8 项贡献都注册上，并检查三份词典的键与 `{placeholder}` 在每种语言里都齐备（复数消息必须有 `.other` 兜底）。
+`pnpm run verify` 无头执行产物，断言 8 项贡献都注册上，并检查三份词典的键与 `{placeholder}` 在每种语言里都齐备（复数消息必须有 `.other` 兜底），外加插件页展示元信息（locale + icon）按宿主的读取规则解析、并核对 `npm pack` 的实际发货清单。
 
 ### 热更新到桌面客户端
 

package/icon.svg

@@ -0,0 +1,9 @@
+<svg width="36" height="36" viewBox="0 0 36 36" fill="none" xmlns="http://www.w3.org/2000/svg">
+<path d="M25 25H23C22.3705 25 21.7777 25.2964 21.4 25.8L20.5 27C20.5 27 19.2503 29 18 29C16.7497 29 15.5 27 15.5 27L14.6 25.8C14.2223 25.2964 13.6295 25 13 25H11C9.96813 24.9974 8.86434 24.4622 8.13596 23.7313C7.40758 23.0004 6.99902 22.0103 7 20.9784V11C6.99935 9.96834 7.40805 8.87567 8.13639 8.14504C8.86474 7.4144 9.96834 7.00259 11 7H25C26.0317 7.0026 27.1353 7.41441 27.8636 8.14504C28.592 8.87568 29.0007 9.96835 29 11V20.9784C29.001 22.0103 28.5924 23.0004 27.864 23.7313C27.1357 24.4622 26.0319 24.9974 25 25ZM21.3317 15.0265H19.7047C19.4286 15.0265 19.2047 14.8026 19.2047 14.5265V13.018C19.2047 12.3909 18.6681 11.8824 18.0043 11.8824C17.3405 11.8824 16.8026 12.3909 16.8026 13.018V14.5265C16.8026 14.8026 16.5788 15.0265 16.3026 15.0265H14.6756C14.0131 15.0265 13.474 15.5338 13.474 16.1609C13.474 16.788 14.0118 17.2965 14.6756 17.2965H16.3026C16.5788 17.2965 16.8026 17.5204 16.8026 17.7965V19.3049C16.8026 19.9308 17.3405 20.4394 18.0043 20.4394C18.6681 20.4394 19.2059 19.9308 19.2059 19.3049V17.7965C19.2059 17.5204 19.4298 17.2965 19.7059 17.2965H21.3329C21.9967 17.2965 22.5346 16.788 22.5346 16.1609C22.5346 15.5338 21.9967 15.0265 21.3317 15.0265Z" fill="url(#paint0_linear_7_8)"/>
+<defs>
+<linearGradient id="paint0_linear_7_8" x1="29" y1="3.5" x2="14" y2="32" gradientUnits="userSpaceOnUse">
+<stop stop-color="#B2FFDA"/>
+<stop offset="1" stop-color="#0099FF"/>
+</linearGradient>
+</defs>
+</svg>