dsh-quick-toc 0.7.1 → 0.7.3

package/CHANGELOG.md

@@ -2,230 +2,240 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.7.3] - 2026-09-23
+
+### 变更
+- **兼容 DSH 0.1.5-rc.3 与 0.1.7-alpha.2**：两个新版本上逐项实测通过（面板与幕布、点行跳转与翻历史、标题/全文/跨会话三档检索、跨会话命中切换会话、设置卡片与设置文档的读写），代码无需改动；兼容声明与 README 兼容表已随之更新。
+- 文档里对两条宿主线的实现说明补齐：设置服务与配置卡片槽位各写清 rc 线与 alpha 线两套（此前只写了 rc 线那一套）。
+
+## [0.7.2] - 2026-09-22
+
+### 新增
+- **幕布缩放**：设置卡片新增「幕布缩放」滑块（50%–200%、每档 5%），把幕布里的文字、图标与按钮按比例缩放，幕布本身的尺寸不变；与「面板缩放」互相独立。幕布内容的默认大小比改动前小一档——滑块的 100% 即改动前的 90%。
+- **支持 DSH 0.1.7-alpha.1**：同一份安装包在 0.1.5-rc.x 与 0.1.7-alpha.x 上都能用（设置接口、配置卡片槽位与会话切换各按宿主实际提供的那一套走），0.1.5-rc.2 与 0.1.7-alpha.1 上都实测通过。
+
 ## [0.7.1] - 2026-09-19
 
 ### 新增
-- **「回到我滚到的位置」浮动按钮**：大纲不在底部时，列表右下角本来就有一枚「回到底部」；现在右上角多了一枚方向朝上的同款圆钮，带你回到**离开这个界面时正在看的那一行**。位置在**关闭的那一刻**记录，停靠面板与幕布**各记各的**，互不覆盖；重新打开时按钮才亮出，点它回到那一行**原来的位置**——若它当初被视口上沿裁掉了一截（列表停在底部时就是如此），就还它那一截，而不是硬顶到最上面。用过一次、或者自己滚回同一处，按钮就渐隐并忘掉这次记录，直到下一次关闭再记。它按列表在界面里的实际起点定位，所以停靠面板的把手条与标题栏、幕布自己的工具条都压不住它，并且跟着幕布放大到 34px。
+- **「回到我滚到的位置」浮动按钮**：关闭面板或幕布时记录列表顶部的那一行，再次打开时在右上角显示向上的按钮，可回到该行原来的位置。两个界面分别记录；使用一次或自行滚回该处后按钮消失，直到下次关闭重新记录。
 
 ### 变更
-- **打开面板与幕布时都落在「正在阅读的那一行」**：此前只有幕布这么做，面板只是显示列表上次停在哪，两个界面会不一致。现在同一条规则：当前正在阅读的那一轮对齐到列表顶部、瞬时完成；读的就在最新几轮时列表已经到底，那一行自然停在底部，不需要任何钳制。
-- **面板的展开/收起动画改用 `transform`**：原先同时过渡 `left`（布局属性，每帧都要重排整个面板）与 `clip-path`，长会话里成百上千行大纲时主线程跟不上合成器，于是收起会变成「一条线扫过、扫过的内容消失」，而不是面板滑走。现在盒子常驻停在收起位、展开态是叠上去的位移，视觉几何完全不变，动画不再随列表规模变慢。
-- **顶部图标的几何校准**：幕布钮从竖长方形改成 12×9 的横矩形（两轴都居中），箭头由朝上改为朝下、尾端压在矩形上边上；层级筛选的三根线加粗到 2.2；「只看提问」的对话泡轮廓同样加粗到 2.2，并略微放大、整体下移一点（泡体是视觉主体、尾巴挂在左下发散，几何居中反而读作重心在上）；✕ 与放大镜去掉原先 1px 的平移补偿，改为把几何画在正中——平移在其它尺寸下会差半个像素。
-- 设置卡片里「记住阅读位置」「自动加载历史」两行不再带说明文字。
+- **打开面板或幕布时，正在阅读的那一行落在列表顶部**（原先只有幕布如此，面板显示上次停留的位置）。
+- **面板的收起/展开改为位移过渡**，不再逐帧重排整个面板，长会话中的收起动画不再变形。
+- **顶部图标的几何与线宽调整**：幕布钮改为横矩形、箭头朝下；层级筛选与「只看提问」的线条加粗；✕ 与放大镜不再用平移微调位置。
+- 设置卡片中「记住阅读位置」「自动加载历史」两行不再显示说明文字。
 
 ### 修复
-- **大纲翻历史「一直追不上」**：翻到未加载区域之后，自动加载仍按 50 条一页、每 130ms 一页地爬，深空档里读者已经翻到了，页面却还没铺完。现在分两条路：视野里已经出现「未加载」占位行时，直接按该回合的 seq 一次翻页到位，并往更早的方向多带 8 行余量；只是接近预取带时才一页一页拉。同一处还修掉一个误判——宿主的「加载更早」按钮在加载期间是 disabled，插件把「正在加载」读成了「已到最早」，于是几百轮之前就弹出「已经是最早的消息」。
-- **加载时视野被推走，以及「关掉自动加载也会回弹」**：占位行加载后变高，它下面的内容被整体推下去。补偿原先跑在 `requestAnimationFrame` 里（比 DOM 变更晚 1–2 帧，看到的就是「跳一下再弹回来」），而且只补自己发起的加载，宿主自己翻页时完全没有补偿。现在补偿放进布局 effect（与 DOM 变更同一帧、浏览器绘制之前）、锚点取视野里**第一个真实行**（占位行正是要长高的那一批，锚在它们下面才等于让新内容在视野上方长出去），并给列表加 `overflow-anchor: none`——浏览器自带的滚动锚定也会为同一次增长改 `scrollTop`，与我们的补偿叠加会把内容向上顶出去。
-- **「用一会儿卡一下 / 开越久越慢」**：自动跟随每次都对会话里**每一条**消息读一次 `getBoundingClientRect`，几千条 × 每秒十几次，工作量随会话长度增长。现在缓存节点列表，只在容器或首尾键变化时重扫；面板收起时把扫描间隔也放宽。
-- **自动加载把中间的对话往上抬**：翻页前会把对话区从贴底的吸附区里抬出 26px（0.5.1 为了防止宿主把刚从大纲翻进来的历史重新钉回底部），但它每翻一页都动一次，读者只在大纲里操作却看到中间的对话动了。宿主侧改用大纲自己的静默窗来判断，这段抬升整个删除。
-- **一次上滚会连拉好几页**：预取判据原先量的是「已加载 / 未加载边界那一组」，而那一组按定义就贴在视口顶边，条件恒成立。现在从视野里最近的一个占位行起量，并加迟滞。
-- **幕布展开时列表先停在偏上的位置、再被跟随拉到底；向上跳转落点不准；打开时会从上面滚下来**：跟随把「正在阅读的那一行」**居中**，读最新回合时「居中」要求的位置超过列表末端，所以总差半个视口；`revealGroupInOutline` 用的是 `scrollIntoView({ block: "nearest" })`，只滚最小距离（落点随机）、而且带一段动画。现在统一成一条规则——**那一行对齐到列表顶部、瞬时完成**。
-- **顶部液滴按下去还留一点厚度、停一拍才突然消失**：下压终点是 `scaleY(0.12)`，17px 的穹顶压到底仍剩约 2px 摆在分割线上；而把手要等 220ms 才被摘掉、淡出又刻意延后 0.2s，那 2px 就静止不动地停了一拍，然后整块消失。现在两端都是 `scaleY(0)`——压到底即沉进分割线，冒出来也从 0 起。
+- **自动加载速度较慢**：视野中出现未加载的占位行时改为一次加载到位，只在接近预取范围时逐页加载；并修正把「正在加载」判断为「已经是最早的消息」的误报。
+- **加载历史记录时向上滚动被拉回**：高度补偿改为与内容变化同帧完成，锚点取视野中第一个已加载的行，宿主自身翻页时同样补偿。
+- **使用一段时间后出现卡顿**：自动跟随不再对会话中的每条消息逐个测量高度。
+- **自动加载历史时中间的对话向上移动**：翻页前不再抬升对话区。
+- **一次向上滚动会连续加载多页**：预取判断改为从视野中最近的占位行起算，并加入迟滞。
+- **幕布展开时列表先停在偏上的位置、向上跳转的落点不准、打开时先自上而下滚动**：统一为「正在阅读的那一行对齐列表顶部、瞬时完成」。
+- **顶部液滴下压到底后仍留有一线厚度，随后整体消失**：改为压到底即完全没入分割线。
 
 ## [0.7.0] - 2026-09-19
 
 ### 新增
-- **全屏「幕布」大纲**：对话顶边「对话 / 轨迹 / 上下文」标签条里嵌了一枚液滴把手（静止半透明、悬停变实，底边压在标签条下沿的分割线上），点它，大纲以整幅宽度从标签条下面落下来——高度取对话区剩余的 82%（240px 起、最多 760px），上沿贴齐标签条、下沿圆角，没有遮罩也不压暗底下的对话，收起后最新一条消息与输入区仍够得着。收起方式：点任意条目、按 Esc、或点右上角的 ✕；面板标题栏右侧的「幕布」圆钮是另一个入口。**幕布不是第二份列表**——它就是把面板本体搬进这个容器，所以滚动翻页、搜索结果、悬停预览、键盘光标、阅读位置全是一套，从面板切过去不会丢状态。
-- **幕布里的宽版排版**：一行三段——最左 `H1–H6` 层级徽标、中间是更大的标题、右侧小字是该节正文的开头；层级筛选在幕布上铺成一行。点放大镜，搜索栏从右侧推进来（360px），大纲列随之向左让位，搜索结果落在右栏。
-- **每行末尾的「跳到本节末尾」按钮**：指针停在标题行 / 组头 / 搜索结果 / 幕布条目上时，该行右端渐显一枚圆形按钮（常驻挂载、只切透明度，不占位也不重排），点它跳到这一节内容的结束处——标题行落到下一个同级或更高级标题之前；组头落到整轮对话的最末尾（模型最后一条回复的底部）。所有悬停加深框都在距行右缘 32px 处收住，与圆形按钮恒定留 8px，长标题也不会和它贴在一起。
-- **跨会话检索**：搜索范围按钮变成三档：标题 → 全文 → 会话。第三档用宿主的会话全文索引搜**其他会话**的消息正文（只搜正文，模糊开关对它不生效；宿主一次最多返回 20 条），点结果直接切到那个会话，并用同一个关键词继续在本会话内查找。只列当前打得开的会话——已归档、子会话、不在会话列表里的会被略过，并在下方如实报出略过条数；宿主没开启全文索引时直接说明，不会静默失败。
-- **记住每会话阅读位置**（设置卡片里默认开）：重新打开一个会话回到上次读到的那一轮；位置只存在这台浏览器里，且半小时内读过才恢复（更久以前就直接开在最新处）。记录带 seq，所以那一轮即使已经不在对话窗口里也会自动翻页加载过去；确实翻不回来（宿主说没有更早的历史）就静默丢弃这条记录，不弹任何提示。
-- **键盘导航**：↑/↓ 在大纲里移动一枚可见的键盘光标（inset 描边 + 淡填充，与「正在阅读」的蓝框刻意区分），Enter 激活当前行（跳转 / 加载未加载回合 / 切会话），Home / End 到首尾，Esc 收起面板（搜索框里的 Esc 先关搜索）。点过面板任意位置（输入框除外）之后就能直接按 ↑/↓，不必先 Tab 进来；光标位置通过屏幕阅读器播报。
-- **只看提问**：标题栏的语音气泡按钮把大纲折起来，每轮只留时间与你的提问首行，在一堆长回复里找自己说过什么更快；切换是渐隐渐显，进入后层级筛选禁用（那时没有标题行），退出即恢复原来的层级选择。
+- **全屏「幕布」大纲**：对话顶边的标签条中嵌入一枚液滴把手，点击后大纲以整幅宽度从标签条下方展开，高度取对话区的剩余部分、下沿圆角，不遮挡也不压暗下方的对话。点击任意条目、按 Esc 或点右上角 ✕ 收起；面板标题栏的「幕布」圆钮是另一个入口。它是把面板本体搬入容器，因此翻页、搜索、悬停预览、键盘光标与阅读位置都是同一套。
+- **幕布中的宽版排版**：一行三段——层级徽标、更大的标题、该节正文的开头；层级筛选排成一行。点击放大镜，搜索栏从右侧展开。
+- **每行末尾的「跳到本节末尾」按钮**：指针停在标题行、组头或搜索结果上时，右端显示圆钮，点击跳到该节的结束位置（标题行停在下一个同级或更高级标题之前，组头停在整轮对话的末尾）。
+- **跨会话检索**：搜索范围增加第三档「会话」，用宿主的全文索引搜索其他会话的正文（只搜正文，一次最多 20 条），点击结果切换到该会话并继续查找。无法打开的会话会被略过并报出条数，宿主未开启索引时直接说明。
+- **记住每会话阅读位置**（默认开启）：重新打开会话时回到上次读到的那一轮；记录带 seq，该轮不在对话窗口中时也会自动加载。位置只保存在本机，超过半小时不再恢复。
+- **键盘导航**：↑/↓ 在大纲中移动光标，Enter 激活当前行，Home / End 到首尾，Esc 收起面板；点击面板任意位置后即可使用，不必先 Tab 进入。
+- **只看提问**：标题栏的语音气泡按钮把大纲折叠为每轮的时间与提问首行；切换为渐隐渐显，开启时层级筛选不可用。
 
 ### 变更
-- **收起后的边缘把手改成「收进边里」**：点击展开时把手先淡出、面板随后滑进来（不再同时动）；点击收起时把手被边线裁切着滑回边里，不再是凭空消失。
+- **收起后的边缘把手改为沿边线滑入**：展开时把手先淡出、面板随后滑入；收起时把手沿边线滑回并被裁切。
 
 ### 修复
-- **不再压住其他插件的浮层**：面板与把手原先用一个扁平的 `z-index: 500` 把自己抬到几乎所有东西之上，实测会盖住社区插件自己的弹层（例如上下文插件的卡片在 200）。现在改为钻进应用层叠序里唯一空着的一段——边缘把手 12、停靠面板 14、幕布 16、悬停预览卡 18：仍在对话内容之上（也必须在转写宽度把手 8 之上，否则那把 40px 宽的透明抓取列会在面板边缘把指针抢走），但在所有「自称浮层」的宿主组件与插件之下（布局浮层 20、better-sidebar 25、cordis 30、宿主弹层 100 起）。
+- **面板不再覆盖其他插件的浮层**：层级改为插入应用层叠序中的空档（把手 12、面板 14、幕布 16、悬停预览 18），仍在对话内容之上，但在宿主与其他插件的浮层之下。
 
 ## [0.6.3] - 2026-09-15
 
 ### 修复
-- **配置卡片的展开/收起箭头与宿主界面的箭头不一致**：箭头原先是一个文本字符（⌄），比宿主 14×14 的 SVG 箭头图标更细；而且字符的墨迹在 20px 行盒里并不居中，旋转绕的是盒子中心，转起来字符就被甩向一旁，看起来不像绕自身翻转。现在换成与宿主一致的 14×14 SVG 箭头图标（内联 SVG，路径与宿主所用图标逐字节一致，类名直接挂在 `<svg>` 上——与宿主插件卡片相同的做法），展开/收起时绕图标自身中心原地翻转。
+- **配置卡片的展开箭头与宿主不一致**：原先使用文本字符 `⌄`，比宿主的 14×14 图标更细，旋转时位置偏移；现改为与宿主相同的内联 SVG 箭头，绕自身中心翻转。
 
 ## [0.6.2] - 2026-09-15
 
 ### 新增
-- **收起把手的垂直位置**：设置卡片里新增「把手位置」——**0%–100%、每档 1%** 的滑块，决定面板收起后那枚边缘把手停在对话区的什么高度：`0%` 在最下、`100%` 在最上，默认 `50%`（就是原先固定的居中位置）。无论面板停在哪一侧，把手都按这个高度贴边。
+- **收起把手的垂直位置**：设置卡片新增滑块（0%–100%、每档 1%），决定面板收起后把手在对话区中的高度：0% 在最下、100% 在最上，默认 50%。
 
 ### 变更
-- **写回默认值等于「未自定义」**：卡片里的字段一旦回到它的默认值（滑块拖回默认档、开关拨回默认状态、层级选回默认集合），该项就从设置的用户层移除——「已自定义」标记与「重置」随之消失，等同于从未改过。0.6.1 及更早版本会把默认值也写进设置文档，并且一直标着「已自定义」。
+- **写入默认值等于「未自定义」**：卡片中的字段回到默认值后会从设置的用户层移除，「已自定义」与「重置」标记随之消失。
 
 ### 修复
-- **面板尺寸可能不落盘**：尺寸写入有 0.4 秒去抖，而"已发布"的台账在发起写入的那一刻就被推进——拖动后在 0.4 秒内再动一次（拖高度、拖顶栏、切层级或模糊开关等），前一次的待写会被取消，台账却已经记成发布过，于是那个尺寸再也不会写入。实测：宽度 200 → 150 之后再拖高度，存下来的宽度仍是 200，刷新后面板回到 200。现在台账只在真正写入时推进，被取消的那次会在下一轮重新发出。
-- **宽度或高度偏小的面板存了也白存**：读回尺寸的下限与拖动下限不一致——拖动允许宽度到 120px、高度到 60px，但下次打开时低于 180px 宽 / 160px 高的值会被当作无效丢弃，面板回到默认宽度。现在两侧下限一致（120px / 60px）。
-- **高度为「自动」时第一次拖高度会跳**：拖拽起点原先按固定的 400px 估算，面板实际更高或更矮时，第一次移动就跳到错误的高度。现在起点取面板的实测高度（缩放后的视觉高度，与存储同一个单位），量不到才退回 400px。
+- **面板尺寸有时无法保存**：尺寸写入有 0.4 秒去抖，而台账在发起写入时即被标记——拖动后 0.4 秒内再次调整会取消前一次的写入，该尺寸此后不再保存。现在台账只在真正写入时标记。
+- **偏小的面板尺寸无法保存**：读回的下限（180×160）与拖动的下限（120×60）不一致，现统一为 120×60。
+- **高度为「自动」时第一次拖动会使面板跳动**：拖拽起点改为面板的实测高度。
 
 ## [0.6.1] - 2026-09-15
 
 ### 新增
-- **面板缩放滑块**：设置卡片里新增「面板缩放」——**50%–200%、每档 5%** 的滑块（与字体增强插件的滑块同一形制），把面板**内容**（文字、图标、按钮及其间距）等比放大或缩小。缩放**不改变面板本身的尺寸**：拖出来的宽高在 50% 与 200% 下完全一致，放大只是让内容更大、屏幕上一屏看到的行更少。拖动滑块只移动读数，**松手才写入设置**（避免每个档位都重写设置文档）；宿主未确认前读数保持为拖动后的值，不会闪回旧数字。
-- **窄面板的顶栏**：面板变得很窄时，四颗按钮保持一行——中间的空白先让位，挤满后整行变成可横向滚动（在顶栏上滚滚轮即可找到后面的按钮），此时顶部的灰色拖拽横条渐隐消失。
+- **面板缩放滑块**：设置卡片新增「面板缩放」（50%–200%、每档 5%），把面板内容等比缩放，面板本身的尺寸不变。拖动时只更新读数，松手后写入设置。
+- **窄面板的顶栏**：面板变窄时四颗按钮保持在一行——先压缩中间的空白，挤满后整行可横向滚动，顶部灰色拖拽条随之渐隐。
 
 ### 变更
-- **跳转动画改回浏览器自己的平滑滚动**：动画交给容器的 `scrollTo({behavior:"smooth"})`（按真实时间推进，因此在 60Hz 与 240Hz 屏幕上时长一致，且带有最后的减速滑停）。保留三层护栏：起跳前先脱离 DSH 的贴底吸附区；飞行中目标的实时偏移若变化超过 40px 就重新瞄准一次（宿主翻页会挪动目标）；动画被宿主的补偿滚动打断（超过 400ms 且位移不足 1px）时重新发起。只有浏览器把该调用直接执行成瞬移时，才退回插件逐帧绘制（自绘同样按毫秒计时、先快后慢）。
-- **面板尺寸取消上下限**：宽度原先被限制在 180–560px、高度下限 160px。现在只保留「还能拖回来」的 120px 宽 / 60px 高地板，放大缩小都由读者决定。
-- **面板缩放只作用于内容**（见上）：缩放因子作用在面板内部，面板自身的宽高、位置、折叠裁剪与其折叠动画都不受影响。
+- **跳转动画改为浏览器自身的平滑滚动**（按真实时间推进，60Hz 与 240Hz 屏幕上时长一致）；目标在滚动过程中移位或动画被打断时会重新瞄准，仅当浏览器把该调用执行为瞬移时才改用逐帧绘制。
+- **面板尺寸取消上下限**：只保留仍能拖回的 120px 宽 / 60px 高下限。
 
 ### 修复
-- **长距离跳转在 240Hz 屏幕上等同瞬移**：0.6.0 的逐帧动画按**帧数**计时（22–46 帧），在 240Hz 面板上 46 帧只有约 190ms（实测 5078px 用了 188ms，约 4 倍过快），看起来像瞬移或匀速一闪；60Hz 下同样的帧数是约 770ms，因此离线测试与无头浏览器都测不出这个问题。现在动画按真实时间推进，与刷新率无关。
-- **拖动面板尺寸后会被拽回原尺寸**：面板把「自己的改动传出」和「采纳外部改动」记在同一份台账里。拖动期间只要发生一次设置写入或宿主快照刷新，就会拿**尚未落盘的旧值**把面板拽回原尺寸，并且正在等待的落盘会被取消——拖动等于白做。现在两条路径分开记账：只采纳既不同于面板当前状态、也不是自己刚发出的值；尺寸与位置不再从设置里回读（它们只有面板自己会写，回读只可能拿到旧副本）。
+- **长距离跳转在 240Hz 屏幕上过快**：原动画按帧数计时，240Hz 下仅约 190ms。现在按真实时间推进，与刷新率无关。
+- **拖动面板尺寸后会自动回到原尺寸**：面板把「传出改动」与「采纳外部改动」记录在同一份台账中，拖动期间一旦有设置写入，就会用尚未保存的旧值把面板拉回。现在两条路径分开记录。
 
 ## [0.6.0] - 2026-09-14
 
 ### 新增
-- **界面中英双语**：新增语言设置——`跟随宿主`（默认，用 DSH 当前的语言）、`中文`、`English`。界面文字全部走字符串表，英文缺失时回退中文。中文的时间戳保留 `昨天` / `前天`，英文的昨天用 `yesterday`、前天及更早一律用 `YY-MM-DD HH:MM` 的日期形式（不用 "2 days ago" 这类相对词）。
-- **插件配置卡片**：在 **设置 → 插件 → 插件配置** 里新增「对话大纲」卡片（与 DSH 自带的可配置插件同一处），集中管理：语言、默认停靠边缘（默认左侧）、显示的标题层级、模糊搜索、悬停预览卡片、控制台诊断日志开关。被改动过的字段会标「已自定义」，并带单独的「重置」（回到默认值）。
-- **面板与卡片实时互通**：两边读写同一份偏好。在面板里拖动或切换开关，卡片随即显示新值；在卡片里改动，面板当次渲染就生效，不需要刷新页面。
-- **偏好存入 DSH 设置**：上述偏好不再只存在浏览器里，而是写入 DSH 的宿主设置文档（跟随配置），插件为此新增了宿主半（注册 `dsh-quick-toc` 设置命名空间，带取值范围校验）。浏览器本地仍保留一份镜像：在不允许写设置的页面上（DSH 对非回环页面如此处理），面板继续按本地镜像工作，行为与 0.5.x 一致。0.5.x 留下的本地值会在宿主层第一次应答时自动导入一次（仅当用户层还是空的时候，不会覆盖已配置的值）。
+- **界面中英双语**：语言设置可选 `跟随宿主`（默认）、`中文`、`English`；中文时间戳保留「昨天 / 前天」，英文使用 `yesterday` 与日期形式。
+- **插件配置卡片**：**设置 → 插件 → 插件配置** 中的「对话大纲」卡片集中管理语言、默认停靠边缘、显示的标题层级、模糊搜索、悬停预览与诊断开关；改动过的字段标有「已自定义」并支持单独重置。
+- **面板与卡片实时同步**：两者读写同一份偏好，任一侧改动后另一侧立即生效，无需刷新。
+- **偏好保存到 DSH 设置**：偏好写入宿主设置文档（跟随配置），浏览器本地保留一份镜像供无法写入设置的页面使用；0.5.x 的本地值在宿主层首次应答时导入一次。
 
 ### 变更
-- **长距离跳转恢复动画**：0.5.1 为修"点击大纲跳转半途落地"让长跳直接定位，0.6.0 把动画找回来：滚动过程由插件**逐帧绘制**（ease-in-out，时长随距离约 0.37–0.77 秒），不依赖浏览器的「平滑滚动」——部分环境会把它直接执行成瞬移，自绘保证任何设置下都有滚动过程。每帧重瞄目标实时位置（宿主翻页改变偏移也会跟随），落点后短暂复检（约 0.6 秒），所以跨页远跳不会半途停下。
-- **面板变大后大纲自动填满**：打开面板或向下拉高时，若最新一页比列表视口矮（最新一组下方留白），窗口自动长大直到内容填满高度或全部回合都已显示。
-- **「正在阅读」蓝框的渐显渐隐加长到 0.4 秒**（透明度、蓝色填充与描边同步过渡，吸顶组头的蓝色层同步），换组时的颜色变化更明显、更柔和。
-- **顶边距、宽度、高度移出设置**：这三项描述的是"这一块屏幕"，改为只能拖拽调整，继续按浏览器保存；设置卡片不再提供数字输入。
-- **偏好的读写收敛到一处**：面板不再在每次指针移动时直接写 `localStorage`，而是把变化合并后短延迟落盘；拖动过程中的实时位置仍由面板自己的状态负责。位置与尺寸的键名不变（`panelY.v1` / `panelW.v1` / `panelH.v1`），其余键转为宿主设置的镜像（键名不变，作回退层）。
-- **诊断开关进入设置卡片**：可以在卡片里点选，而且打开后当下就会打印一行挂载诊断，不再需要手动改 `localStorage` 再刷新。
+- **长距离跳转恢复动画**：由插件逐帧绘制（按时长而非帧数），每帧重新瞄准目标、落点后短暂复检，跨页远跳不再半途停止。
+- **面板拉高后大纲自动填满**，最新一组下方不再留白。
+- **「正在阅读」蓝框的渐显渐隐时间加长到 0.4 秒**。
+- **顶边距、宽度、高度移出设置**，改为只能拖拽调整。
+- **偏好写入合并**：不再在指针移动时反复写入存储，改为合并后延迟写入；诊断开关进入设置卡片，打开后立即打印。
 
 ### 修复
-- **面板在部分会话上崩溃（React #310）**：面板的 hook 调用数量在两次渲染之间可能不一致——`useChat` 缺失时的兜底返回、以及"这轮对话还没有任何可显示的回合"时的提前返回，都发生在部分 hook 之后，于是这些 hook 在下一次渲染被补上时 React 抛 `Rendered more hooks than during the previous render`，面板连同它所在的槽位一起消失（0.5.0 / 0.5.1 均存在）。现在面板拆成"不调用任何 hook 的外层守卫 + 内层组件"，任何一次渲染的 hook 数量都相同。
+- **面板在部分会话中崩溃（React #310）**：渲染路径上的 hook 数量不一致，面板连同槽位一起消失。现在拆分为不调用 hook 的外层守卫与内层组件。
 
 ## [0.5.1] - 2026-09-13
 
 ### 新增
-- **「回到底部」浮动按钮**：大纲列表右下角的圆形按钮。列表不在底部时渐显，滚到底后渐隐；点击把大纲滚回最新一条（近距离平滑滚动，长距离即时到位）。
-- **回合时间带日期**：组头、搜索结果行与悬停卡片里的时间不再只有 `HH:MM`——昨天显示 `昨天 15:04`，前天显示 `前天 15:04`，更早显示 `25-09-11 15:04`（年份取后两位；按自然日判定，不是按 24 小时差）。
-- **失败回合的报错**：请求超时、上游报错这类没有产出任何回复的回合，现在在组头下方显示一行 `请求失败` 与宿主提供的报错原文；点击跳到对话中该报错的位置，报错原文同样能被全文搜索命中（结果行带「请求失败」标记）。
+- **「回到底部」浮动按钮**：列表不在底部时显示，点击回到最新一条，到底后隐藏。
+- **回合时间带日期**：昨天、前天分别显示「昨天 / 前天 + 时间」，更早显示 `YY-MM-DD HH:MM`（按自然日判定）。
+- **失败回合的报错**：请求超时、上游报错等回合在组头下显示 `请求失败` 与报错原文，点击跳到该位置，报错原文也可被搜索命中。
 
 ### 变更
-- **标题栏改为一边两个按钮**：左侧「层级筛选 + 停靠切换」，右侧「搜索 + 收起」，中间留白把两组顶到两端；并去掉左侧的三条杠装饰标识。
-- **层级筛选弹层改为左对齐按钮**（此前在按钮右侧对齐）。
-- **挂载诊断日志默认静默**：控制台不再打印 `[dsh-quick-toc] panel mounted …`。需要排查时先执行 `localStorage.setItem("dsh-quick-toc.debug", "1")` 再刷新即可看到该行（`turnOutline` 与跳转加载器的分阶段状态），正常使用不再有噪音。
-- **长距离跳转改为即时定位**：跨越很长历史的跳转不再"滚到一半停下"（近距离仍是平滑滚动），落地后还有约 0.6 秒的校验，用于纠正内容高度在飞行途中变化的情况。
+- **标题栏改为一边两个按钮**（左：层级筛选、停靠切换；右：搜索、收起），并移除左侧的三条杠。
+- **层级筛选弹层改为左对齐按钮**。
+- **挂载诊断日志默认静默**，需要时把 `dsh-quick-toc.debug` 设为 `1` 后刷新。
+- **长距离跳转改为即时定位**，落地后进行短暂校验。
 
 ### 修复
-- **失败或中止的回合被误标成「未加载」**：这类回合没有模型回复，既没有时间也没有标题，被当成尚未加载的回合重新列了一遍。现在"该回合的用户消息已加载"本身就是已加载的依据，失败回合另加报错行；被用户中止的回合按普通无标题回合显示。
-- **从大纲往上翻加载更早消息时，对话区会被弹回最新一条**，越翻越回到底部：宿主在"这次滚动不是读者发起、且它仍认为读者停在底部"时会强制滚回底部，而从大纲触发的翻页恰好命中该条件。现在点击宿主的「加载更早」之前会先把对话区抬离贴底区，翻页保持原位。
-- **无标题回合的组头与其它组头格式不一致**：它此前被整体放大（12px / 600 / 正文色），与常规组头并列时像另一种条目。现在所有组头共用同一套样式（11px、次要色、同一行盒），无标题回合只是"组头下面没有行"。
+- **失败或中止的回合被误标为「未加载」**：现在这些回合按已加载处理，失败回合额外显示报错行。
+- **从大纲向上加载更早消息时，对话区会回到最新一条**：翻页前先把对话区移出贴底区域。
+- **无标题回合的组头格式与其他组头不一致**：现在共用同一套样式。
 
 ## [0.5.0] - 2026-09-12
 
 ### 新增
-- **全量回合索引**：接入宿主的 `turnOutline` 投影后，大纲覆盖**整段会话**的回合，包括分页窗口尚未加载进来的那些。未加载的回合显示为带「未加载」标记的条目，附宿主提供的提问/回答预览（宿主侧上限 50 / 120 字），点击即通过宿主的回合跳转加载器把该回合翻页加载进来再滚过去。宿主没有该投影时退化为只列已加载的回合。
-- **标题行副标题**：每个标题下方显示该节正文的第一句（跳过空行、围栏代码块、表格线与纯项目符号），同名标题一眼可辨。
-- **悬停预览**：悬停标题行或结果行约 0.26 秒后弹出预览卡片，显示标题、回合时间、层级路径与该节开头（最多 260 字）；面板停靠右侧时卡片弹在左侧；移开鼠标渐隐。
-- **搜索归一化（常开）**：大小写、全角/半角、连续空白差异视为同一个匹配，命中高亮落在原文的真实字符上。
-- **「模糊」开关**：搜索框右侧、与「标题/全文」并排的独立开关。开启后允许关键字中间夹少量其他文字（子序列匹配，跨度有上限），开关状态会被记住。
-- **未加载的回合也能被搜到**：「全文」范围同时搜索未加载回合的预览文本，命中行的点击同样是"先加载、再定位并高亮"。
-- **边界提示**：搜索结果下方提示「向上滚动可加载更早的消息」，往上一滚即消失；大纲态滚到第一条、或已在最后一条仍继续下滚时，面板底部浮出「已经是最早的消息」/「已经到底了」，渐显、停留约 2.6 秒后渐隐。
-
-### 变更
-- **自动跟随更跟手**：去掉跟随路径上的人为延时、大纲改为瞬时定位（不再用平滑动画追赶）、高亮过渡由 0.3 秒缩到 0.15 秒。跟随也不再依赖"挂载时抓到的那一个滚动容器"——改为在 document 捕获阶段监听并在每次运行时重新查询容器，另加低频轮询兜底，程序化跳转（原生回合轨道）之后也能继续跟随。
-- **正在阅读的回合改用封闭的蓝色框**标记（浅蓝填充 + 四周描边 + 左侧强调条），出现与消失都是渐显渐隐；其余回合不再压到很暗（0.6 → 0.85），面板静止透明度 0.45 → 0.72，整体可读性提升。
-- **无标题回合的时间行**提升为正文级字号与字重（12px / 600 / 正文色），不再是一行灰色小注；有标题与无标题的回合在成为"正在阅读"时外观一致。
-- 界面激活态配色收敛到单一色源：搜索按钮、层级筛选按钮（含收回动画期间）、「标题/全文」、「模糊」开关、层级芯片、搜索结果当前行统一使用同一个浅蓝。
-- 往上翻大纲时对宿主的「加载更早」点击加了 900ms 节流（连续滚动不会反复触发分页）；大纲态"滚动既展开索引、也加载更早的对话"这一行为与 0.4.x 保持一致。
-- 所有界面文案收敛到一张字符串表，为后续中英双语做准备（0.5.0 的界面文字仍是中文）。
+- **全量回合索引**：接入宿主投影后大纲覆盖整段会话，未加载的回合带「未加载」标记与宿主提供的预览，点击后加载该回合并滚动过去。
+- **标题行副标题**：每个标题下方显示该节正文的第一句，便于区分同名标题。
+- **悬停预览**：指针停在标题行约 0.26 秒后显示预览卡片（标题、时间、层级路径、该节开头）；面板停靠右侧时显示在左侧。
+- **搜索归一化（常开）**：大小写、全角半角与空白差异视为同一个匹配。
+- **「模糊」开关**：允许关键字中间夹少量其他文字，状态会被记住。
+- **未加载的回合也可被搜索到**：全文范围同时搜索这些回合的预览文本。
+- **边界提示**：搜索结果下方提示可加载更早的消息；滚动到最早或最后仍继续滚动时，面板底部显示提示，停留约 2.6 秒。
+
+### 变更
+- **自动跟随更及时**：移除人为延时、改为瞬时定位、缩短高亮过渡；跟随不再依赖挂载时获取的滚动容器，改为在 document 捕获阶段监听并在每次运行时重新查询。
+- **正在阅读的回合改用封闭蓝框**标记，其余回合的暗度减弱，面板静止透明度提高到 0.72。
+- 无标题回合的时间行提升为正文级字号与字重。
+- 界面激活态配色统一到单一色源。
+- 向上滚动时的「加载更早」加入节流，避免连续触发分页。
+- 界面文案统一到一张字符串表，为后续双语做准备。
 
 ### 修复
-- 用对话右侧的原生回合轨道（刻度条）跳转之后，大纲不再自动跟随、正在阅读的回合也不再点亮：跟随的滚动监听绑在**挂载时抓到的那个滚动容器**上，而跳转重新分页时该容器会被替换，监听器留在被丢弃的节点上，从此收不到任何滚动事件。现在改为在 document 捕获阶段监听，并在每次运行时重新查询当前容器。
-- 没有 Markdown 标题的回合无法成为"正在阅读"的回合（不点亮、不跟随）：跟随用的"节点 → 回合"映射只登记了带标题的消息，无标题回合的节点一个都没登记。现在该回合的所有节点（用户消息与每条模型回复）都会登记。
+- **用对话右侧的回合轨道跳转后，大纲不再跟随、也不再点亮**（滚动监听绑定在被替换的容器上）：改为在 document 捕获阶段监听并重新查询容器。
+- **没有 Markdown 标题的回合不会被标记为「正在阅读」**（映射只登记了带标题的消息）：现在该回合的所有节点都会登记。
 
 ## [0.4.0] - 2026-09-11
 
 ### 新增
-- **搜索结果列表**：有搜索词时大纲切换为结果列表，逐条列出命中（标题关键字高亮、层级路径、回合时间、重复次数，全文模式附上下文片段）。列表按时间排列、**最新的命中在底部**，开始搜索时自动定位到最新命中，向上滚回看更早的命中；点击任一行会把该命中设为当前命中——和回车逐处跳同一条路径，会在对话里高亮并滚过去；`n/N` 回车逐处跳保留
-- **组头吸顶**：滚动大纲时，当前所在回合的组头固定在面板顶部，并与上方工具条紧贴
-- **层级筛选行可收起**：标题栏放大镜左边的 **层级** 按钮收起/展开 `1`–`6` 那一行（选择会记住；收起后筛选设置仍然生效）
-- **位置面包屑**：面板顶部显示你正在读的章节路径，点击可跳到该标题。判定规则是"视口中线之上最深的标题"（画面里占得最多的那一节）；跳转落点也在中线之上，所以点完后面包屑显示的仍是同一个标题
-- **标题层级筛选**：面板顶部 `1`–`6` 芯片是各自独立的开关，可任意组合（例如只留 H1 与 H3、关掉中间的 H2），选择会记住；把最后一个亮着的层级也关掉时自动恢复显示全部六级
+- **搜索结果列表**：有搜索词时大纲切换为结果列表（标题高亮、层级路径、回合时间、重复次数，全文模式附片段），最新的命中在底部，点击任一行即设为当前命中并在对话中高亮滚动；`n/N` 回车逐处跳保留
+- **组头吸顶**：当前回合的组头固定在面板顶部
+- **层级筛选行可收起**：标题栏的「层级」按钮收起/展开 `1`–`6` 那一行
+- **位置面包屑**：面板顶部显示正在阅读的章节路径，点击跳到该标题
+- **标题层级筛选**：`1`–`6` 芯片各自独立，可任意组合；全部关闭时恢复显示六级
 
 ### 变更
-- **性能**：标题解析与文本提取改为按节点缓存——流式更新只重算真正变化的节点，不再每次重算整段历史；缓存会清理已离开会话的节点，保持有界
-- 回合组头（时间那一行）点击改为跳到**该回合模型回答的开头**（原来跳到用户消息位置）
-- **兼容性**：在 DSH **0.1.5-rc.1 与 0.1.5-rc.2** 上验证并声明兼容（`engines.dsh` 下限仍为 `>=0.1.5-rc.1`）。两版的宿主接口一致——会话级槽位 `conversation.input.overlay`、`dsh-client-ui-chat` 的 `useChat` hook 与客户端模块 seed 表都经实测核对相同。
-- `countOccurrences` 增加空查询守卫（空查询会让 `indexOf` 原地打转导致死循环；现有调用点都有守卫，此举为加固）
+- **性能**：标题解析与文本提取按节点缓存，流式更新只重算真正变化的节点
+- 组头（时间行）点击改为跳到该回合模型回答的开头
+- 声明兼容 DSH `0.1.5-rc.1` 与 `0.1.5-rc.2`
+- `countOccurrences` 增加空查询守卫
 
 ### 修复
-- 大纲首次载入内容时没有自动定位到最新回合：该副作用的依赖数组写在 `groups` 声明之前，渲染时读到的永远是 `0`，导致副作用只在挂载时执行一次。已把副作用移到 `groups` 之后并直接依赖 `groups.length`。
-- 拖动顶部横条调整面板垂直位置后，记录的仍是**拖动前**的位置（写入的是拖动开始时闭包里的旧值），刷新后面板跳回原位。现在写入拖动结束时的实际位置。
-- 同一段文本里同一关键字出现多次时，对话内高亮只包住**该文本节点里的第一处**：第二处既不染色，也无法被标成"当前命中"，于是跳到第二处时找不到当前标记，退化成"只滚动、没有高亮"。现在每个文本节点内的所有出现都会依次包住，对话内命中序号与 `n/N` 完全对齐。
-- ``` 围栏代码块里的 `# 注释` / `## 示例` 会被当成标题混进大纲（既没有可跳转的目标，又会让它后面那些真标题的序号错位、跳到错误位置）。现在解析标题时会跳过围栏代码块（支持 ``` 与 ~~~、带 info string 的开栏、更长的闭栏、最多 3 空格缩进）。
+- **首次载入没有定位到最新回合**：副作用的依赖写在声明之前，只执行了一次
+- **拖动顶部横条后记录的位置是拖动前的**，刷新后面板回到原位
+- **同一文本节点中的第二处命中不被高亮**，跳转到该处时只滚动、不高亮
+- **围栏代码块中的 `#` 行被当作标题**，使其后真标题的序号错位
 
 ## [0.4.1] - 2026-09-12
 
 ### 变更
-- **层级筛选改为弹出选择**：标题栏新增圆形图标按钮（三条递减横线，悬停反馈与放大镜一致），点击后从**按钮中心**放大弹出 H1–H6 选择层（靠右、带外阴影），收回时缩回按钮并渐隐，不再单独占一行；选择芯片标注 H1–H6，选中态配色与搜索的"标题 / 全文"切换一致
-- 移除面板顶部的"当前位置"面包屑行（0.4.0 新增，使用中显得多余）
+- **层级筛选改为弹出选择**：标题栏新增圆形按钮，点击后从按钮中心弹出 H1–H6 选择层，收回时缩回并渐隐，不再单独占一行
+- 移除面板顶部的位置面包屑行（0.4.0 新增）
 
 ## [0.3.3] - 2026-09-10
 
 ### 新增
-- 中间列切到其他视图（轨迹、上下文、插件视图）时，大纲面板与收起后的边缘把手会渐隐，切回对话视图时渐显。检测为轻量轮询（120ms）；无法判断当前视图时按"可见"处理。
+- 中间列切换到其他视图时，大纲面板与边缘把手渐隐，切回对话视图时渐显
 
 ### 变更
-- 兼容性只声明 DSH `0.1.5-rc.1`（`engines.dsh`、`dsh.compatibility.dshReleases` 与 `peerDependencies`），即本插件验证过的版本。
-- README 更新：功能列表与「使用」章节补齐搜索、搜索范围切换、对话内高亮与回合跳转；兼容表列出最近两个版本各自支持的 DSH 版本。
-- GitHub Release 的描述默认取中文 CHANGELOG 段落，英文段落折叠在其下方可展开；CHANGELOG 拆分为 `CHANGELOG.md`（中文，默认）与 `CHANGELOG.en.md`（英文）。
+- 兼容性只声明 DSH `0.1.5-rc.1`
+- README 补充搜索与跳转相关说明；兼容表列出最近两个版本各自支持的 DSH 版本
+- CHANGELOG 拆分为中英两份；Release 描述默认取中文段，英文段折叠在下方
 
 ## [0.3.2] - 2026-09-08
 
 ### 变更
-- 文档整理：README 的兼容表与功能列表更新，npm 包描述补充了关键字搜索与对话内高亮。
+- 文档整理：README 的兼容表与功能列表更新，npm 描述补充关键字搜索与对话内高亮
 
 ## [0.3.1] - 2026-09-08
 
 ### 修复
-- 面板与收起把手不再浮在 DSH 弹层之上：基础 z-index 改为 500（高于应用弹出层 z100 与对话宽度手柄 z8，低于 DSH 弹层 z1000），打开设置时设置面板会盖住大纲。
-- 圆形控件在 DSH 0.1.5-rc.1 上恢复为正圆：主题对所有元素应用了 `corner-shape: superellipse(1.5)`，会把 `border-radius: 50%` 变成方圆角；图标按钮、搜索范围切换、顶部拖条与边缘把手现声明 `corner-shape: round`。
+- 面板与收起把手不再浮在 DSH 弹层之上（z-index 改为 500）
+- 圆形控件在 DSH 0.1.5-rc.1 上恢复为正圆：该主题的 `corner-shape` 会把 50% 圆角变为方圆角
 
 ### 变更
-- 兼容声明加入 DSH `0.1.5-rc.1`（当时 `engines.dsh` 仍为 `>=0.1.2-rc.1`）。
+- 兼容声明加入 DSH `0.1.5-rc.1`
 
 ## [0.3.0] - 2026-08-24
 
 ### 修复
-- 适配当时的目标版本 DSH 0.1.2-rc.1：已被移除的 `@deepseek-ai/dsh-client-runtime` 不再导致插件加载失败（externals drift），运行时 hook 改为由会话作用域槽位的 props 注入。
-- 对话数据访问由 `useSession(s => s.chat.*)` 改为会话作用域的 `useChat`（`ChatSnapshot.order` + `nodes`，由 `dsh-client-ui-chat` 贡献）；节点形状未变（`kind: user/assistant-step`、`location.turn`、`data.blocks`），因此分组、搜索、高亮与跳转逻辑未受影响。
-- 面板挂载改到会话作用域的 `conversation.input.overlay` 槽：该版本中会话级 hook 只到达已声明的会话槽，而 root 作用域 `shell.overlay` 里的 `SessionProvider` 绑定的是无 sessionId 的 root binding，导致子槽始终空渲染。面板本体仍以 `position: fixed` 自绘浮层，挂载槽只作为 hook 来源。
+- 适配 DSH 0.1.2-rc.1：不再因 `dsh-client-runtime` 被移除而加载失败，运行时 hook 改由会话作用域槽位的 props 注入
+- 对话数据访问由 `useSession` 改为会话作用域的 `useChat`
+- 面板挂载改到会话作用域的 `conversation.input.overlay` 槽，解决子槽始终空渲染
 
 ### 变更
-- `dsh.client.inject` 改为列出 `dsh-client-ui-chat` / `dsh-client-ui-conversation` / `dsh-client-ui-layout`，替代已移除的运行时包。
-- 从客户端 inject 列表中移除未使用的 `sessions` 服务。
+- `dsh.client.inject` 改为列出 `dsh-client-ui-chat` / `-conversation` / `-layout`，替代已移除的运行时包
+- 从客户端 inject 列表移除未使用的 `sessions` 服务
 
 ### 新增
-- 版本守卫：`dsh.compatibility.dshReleases` 与 `engines.dsh` 声明（供 dshmarket 安装时做宿主兼容预检），并以 peerDependencies 约束相关 DSH 包版本；`chat` hook 不可用时，面板以控制台警告优雅降级。
+- 版本守卫：声明 `dsh.compatibility.dshReleases` 与 `engines.dsh` 供市场做安装前兼容预检，并以 peerDependencies 约束相关 DSH 包；`chat` hook 不可用时优雅降级
 
 ## [0.2.2] - 2026-08-24
 
 ### 新增
-- 关键字搜索：标题栏放大镜打开搜索框，回车逐处跳转（`n/N` 计数），Esc 或再次点击放大镜关闭
+- 关键字搜索：放大镜打开搜索框，回车逐处跳转（`n/N` 计数），Esc 或再次点击放大镜关闭
 - 搜索范围切换：仅标题，或同时搜索用户消息与 AI 回复正文
 - 对话内高亮：命中的关键字在对话中高亮，当前命中单独标亮并滚动到视口中上部
 - 同一条消息内的多次命中都计入 `n/N`
-- 无标题的回合也有独立的时间条目；所有组头在时间旁显示该回合首行预览（点击跳转）
+- 无标题的回合也有独立的时间条目；所有组头显示该回合首行预览
 
 ### 变更
-- 两种停靠的面板收起动画统一：由 clip-path 在侧栏/屏幕边缘裁切（移除阴影，避免裁切残影）
+- 两种停靠的面板收起动画统一（沿侧栏/屏幕边缘裁切，移除阴影）
 - 非激活的大纲组降到 0.6 不透明度
 
 ## [0.1.1] - 2026-08-17
 
 ### 变更
-- 发布流程额外上传稳定命名的 tarball（`dsh-quick-toc.tgz`），使 `/releases/latest/download/` 始终解析到最新版本
+- 发布流程额外上传稳定命名的 tarball（`dsh-quick-toc.tgz`），让 `/releases/latest/download/` 始终指向最新版本
 
 ## [0.1.0] - 2026-08-17
 
 ### 新增
 - 按回合分组的大纲：每条用户消息与其后续 AI 回复为一组，组头显示该组的结束时间
-- 自动跟随高亮：对话视口内可见的回合在大纲中点亮（可同时多组）；大纲自动加载并滚动，使其保持可见
-- 平滑跳转：点击标题平滑滚动到对话中该标题的位置（带少量顶部偏移）
-- 左右停靠（拖顶部横条移动）、从边缘/角部调整大小、收起为边缘把手（点击展开）
-- 滚动条随停靠方向（停靠左侧时在左，停靠右侧时在右）
-- 分页渲染：默认显示最新的若干组；在大纲中滚到顶部加载更早的组
-- 自动「加载更早」：大纲到达顶部且已全部加载时，会点击对话自身的「加载更多」按钮
-- 组头时间跳转：点击组的时间标签跳到该回合开头
+- 自动跟随高亮：对话视口内的回合在大纲中点亮，大纲自动滚动保持可见
+- 平滑跳转：点击标题平滑滚动到对话中该标题的位置
+- 左右停靠、拖拽调整大小、收起为边缘把手
+- 滚动条随停靠方向（停靠左侧时在左，右侧时在右）
+- 分页渲染：默认显示最新的若干组，向上滚动加载更早的组
+- 自动「加载更早」：大纲到达顶部且已全部加载时，会点击对话自身的加载按钮
+- 组头时间跳转：点击时间标签跳到该回合开头
 - Markdown 感知标题：剥离 `**加粗**`、`*斜体*`、`` `代码` ``、`[链接](url)`、`~~删除线~~`
 - 面板状态持久化（停靠边、位置、尺寸），并从旧键名自动迁移
 - 对话无标题时自动隐藏；支持亮/暗主题

package/README.en.md

@@ -31,6 +31,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 - **Back to where I left** — closing the panel or the curtain remembers the row that was at the top (each surface keeps its own, and neither overwrites the other); the next time that surface opens, a floating button in the list's upper-right corner returns that row to **where it sat**. It fades out — and forgets the record — once it is used, or as soon as you scroll back there yourself, until the next close. Under the same rule, opening the panel or the curtain puts the **row being read** at the top of the list (when that turn is one of the newest few the list is already at its end, so the row lands at the bottom)
 - **Dockable and resizable** — drag the top bar to move the panel, ◀ / ▶ to dock left or right, drag an edge to resize (no upper bound, down to 120px wide), and collapse it into an edge handle (its height is set by the card's "Handle position"); position and size are remembered per browser (top offset, width and height are adjusted by dragging only)
 - **Panel scale** — a slider in the settings card scales the **content** (text, icons, buttons and their spacing) from 50% to 200% in 5% steps while the **panel's own size stays exactly as dragged**; dragging only moves the readout, and the settings document is written once you let go. A narrow panel keeps its four header buttons on one line: the empty middle gives way first, then the whole row scrolls sideways (wheel over the header), and the grey grab bar fades out
+- **Curtain scale** — a second slider scales the **curtain's content** from 50% to 200% in 5% steps while the curtain's own size stays as it is; the panel scale and the curtain scale are independent of each other. The curtain's content starts one notch smaller than before (100% on the slider is 90% of the previous size), and only the outline inside the curtain is scaled — the conversation itself is untouched
 - **Paging** — the most recent groups show first; scrolling up both expands the index and loads older conversation
 - **Edge hints** — a brief hint at the bottom of the panel when you keep scrolling past the first or the last entry
 - **Markdown-aware** — inline markup in headings is stripped; `#` lines inside fenced code blocks are not headings
@@ -41,7 +42,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.7.x** (latest, 0.7.1) | 0.1.5-rc.1, 0.1.5-rc.2 |
+| **0.7.x** (latest, 0.7.3) | 0.1.5-rc.1, 0.1.5-rc.2, 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2 |
 | 0.6.x (0.6.3) | 0.1.5-rc.1, 0.1.5-rc.2 |
 | 0.5.x (0.5.1) | 0.1.5-rc.1, 0.1.5-rc.2 |
 | 0.4.x (0.4.1) | 0.1.5-rc.1, 0.1.5-rc.2 |
@@ -50,7 +51,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 Each major line lists only its newest patch (the defects a new feature introduces are fixed in the patches that follow, so within one major line the newest patch is the one to use; older patches keep working — the plugin does not break existing interfaces).
 
-`engines.dsh` has a floor of **0.1.5-rc.1** (`>=`): from that release on, the plugin uses the host's session-scoped slot injection. 0.7.1 was tested on **0.1.5-rc.2** (the "back to where I left" floating button, the leave positions the panel and the curtain record separately, the row being read landing at the top when a surface opens, and the absence of the button after closing at the bottom were each confirmed); 0.7.0 was tested on the same release (the full-width curtain and its droplet handle, the jump-to-section-end buttons, cross-session search, keyboard navigation, the questions-only view and the remembered reading position were each exercised in a real browser; the panel scale, a dragged size reaching storage and coming back, and the collapsed handle's position had been measured before that); on **0.1.5-rc.1** the plugin's loading and client-module delivery were tested for real (the host boots without errors, `--dump-config` carries the quick-toc entry, the combined client bundle URL lists `dsh-quick-toc/client.js`, and the bytes it serves contain this release's curtain handle, jump-to-section-end and reading-position markers). The host interfaces it relies on — the `turnOutline` projection, the session-scoped `useProjection`, the client `sessions` service and its `loadThrough` jump loader (since 0.5.0), the `turn-error` node used for failed turns (since 0.5.1), and the host `settings` service (`installSection`), the client `settingsScope` and the `settings.plugin.item` card slot added in 0.6.0, and the client `sessions.search` that 0.7.0's cross-session search calls — were checked one by one against the installed 0.1.5-rc.1 and 0.1.5-rc.2 bundles, whose code is byte-identical between the two releases (`dsh-client-ui-chat` differs by a single CSS declaration unrelated to this plugin, and the package that carries `search`, `dsh-api-session-controller`, is byte-identical down to the same limits: at most 20 hits per search, 240 code points per snippet), so both releases are claimed. Older or newer DSH versions are unverified and therefore not claimed; on an older DSH the newest usable plugin version is **0.3.2**. On install or update, the DSH market pre-flights host compatibility from `engines.dsh`, `dsh.compatibility.dshReleases` and `peerDependencies` in `package.json`.
+`engines.dsh` is declared as **`>=0.1.5-rc.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0`**, with the peer ranges shaped the same way (a prerelease must be given an explicit branch: node-semver admits one only when some comparator in the range sits on that version's exact `major.minor.patch` tuple and carries a prerelease tag of its own, so a plain `>=0.1.5-rc.1` never matches `0.1.7-alpha.1`). 0.7.3 was tested on **0.1.5-rc.3** and **0.1.7-alpha.2** (the panel and the curtain, row jumps and older-history loading, the title/full-text/cross-session searches, switching sessions from a cross-session hit, the configuration card and the host settings document's reads and writes were each exercised), and neither release needed a code change — checked offline as well: rc.3 differs from rc.2 only in each package's `package.json` version (plus two sidebar files), and alpha.2's changes sit in the session controller and the chat renderer while every interface and node shape this plugin uses is still there (`turnOutline`, `turn-error`, `useChat`, `data-chat-anchor-key`, `sessions.search`, `loadThrough`, `settings.*` and both card slots; the two extra `data-conversation-scroll` hits in alpha.2 are stylesheet text, not a second scroll container). 0.7.2 was tested on **0.1.5-rc.2** (the curtain scale was confirmed point by point: at three factors the curtain box keeps its width, height and position while only the content scales, both slider ends, the write-on-release behaviour and the default rendering were exercised, and the two scales were confirmed independent); 0.7.1 was tested on **0.1.5-rc.2** (the "back to where I left" floating button, the leave positions the panel and the curtain record separately, the row being read landing at the top when a surface opens, and the absence of the button after closing at the bottom were each confirmed); 0.7.0 was tested on the same release (the full-width curtain and its droplet handle, the jump-to-section-end buttons, cross-session search, keyboard navigation, the questions-only view and the remembered reading position were each exercised in a real browser; the panel scale, a dragged size reaching storage and coming back, and the collapsed handle's position had been measured before that); on **0.1.5-rc.1** the plugin's loading and client-module delivery were tested for real (the host boots without errors, `--dump-config` carries the quick-toc entry, the combined client bundle URL lists `dsh-quick-toc/client.js`, and the bytes it serves contain this release's curtain handle, jump-to-section-end and reading-position markers). The host interfaces it relies on — the `turnOutline` projection, the session-scoped `useProjection`, the client `sessions` service and its `loadThrough` jump loader (since 0.5.0), the `turn-error` node used for failed turns (since 0.5.1), and the host `settings` service (`installSection`), the client `settingsScope` and the `settings.plugin.item` card slot added in 0.6.0, and the client `sessions.search` that 0.7.0's cross-session search calls — were checked one by one against the installed 0.1.5-rc.1 and 0.1.5-rc.2 bundles, whose code is byte-identical between the two releases (`dsh-client-ui-chat` differs by a single CSS declaration unrelated to this plugin, and the package that carries `search`, `dsh-api-session-controller`, is byte-identical down to the same limits: at most 20 hits per search, 240 code points per snippet), so both releases are claimed. Older DSH versions are unverified and therefore not claimed; on an older DSH the newest usable plugin version is **0.3.2**. **0.1.7-alpha.1 passes too**, in a real instance inside an isolated `DSH_HOME`: the host boots without errors, and the panel and curtain, row jumps and older-history loading, the title/full-text/cross-session searches and switching sessions from a cross-session hit were each exercised in a real browser, with the settings document's reads and writes confirmed as well. To that end 0.7.2 speaks both host lines — on 0.1.5-rc.x it uses the host's `settings.installSection`, the client `settingsScope` and the `settings.plugin.item` card slot; on 0.1.7-alpha.x it uses `settings.configure`, the client `configForms` and the `plugins.bundle.config` card slot, and switches sessions through `uiWorkspace.openSession`. The plugin picks whichever exists at runtime, and **declares no settings service in `inject` at all** (declaring one a host does not provide parks the whole package, which on 0.1.7-alpha.1 stopped the entire web boot from finishing). On install or update, the market (dshmarket) reads `engines.dsh` (or `dsh.engines.dsh`) and the `@deepseek-ai/dsh-*` peer ranges present in the local install from the npm `latest` manifest, shows the host requirement a plugin declares on its card, and offers an optional filter that hides only entries confirmed to mismatch the running host; `dsh.compatibility.dshReleases` is this repository's own record, read by neither DSH nor the market.
 
 ## Install
 
@@ -112,9 +113,9 @@ A missing `turnOutline` means the host has no such projection, and the staged `j
 - The "unloaded turn" capability needs two host facilities: the `turnOutline` projection (the whole-session turn index, each entry carrying its `turn/start` seq) and the turn-jump loader (the client `sessions` service's `binding(sessionId).session.loadThrough(seq)`, reached through the client ctx's declaration-free `ctx.get("sessions")` lookup). Each degrades on its own: without the projection the outline lists loaded turns only, without the loader unloaded entries are shown but not jumped to, and nothing else in the panel is affected.
 - The failure row reads the host's `turn-error` conversation node (published when `turn/end` carries an `error` reason, with `message` and an optional `code`); on a host without that node the row is simply absent and nothing else changes.
 - Interface text lives in one string table at the top of `lib/client.js` (`DICTS`, one Chinese and one English copy) and the language setting picks between them: on `follow the host` the host's translate function (`ctx.locale.bind("dsh-quick-toc")`, fed by the same `DICTS` tables) is asked first and the built-in table is only the fallback. The two tables must stay key-aligned; the only Chinese-only entry is `time.beforeYesterday` (English carries the date for anything older than yesterday), while `time.yesterday` exists in both (`yesterday`).
-- Preferences sit in two layers behind one module-level store: the Host settings document (`ctx.settingsScope.bind({ namespace: "dsh-quick-toc" })` — language, docked edge, levels, scale, handle position, remembered reading position, fuzzy, hover and diagnostic; authoritative on a loopback page) and `localStorage` (the mirror, plus the real storage for top offset / width / height, which describe this screen and are saved per browser). Writes are routed per field: host fields go through `scope.mutate` (folded in locally, reconciled when the host answers), everything else goes to `localStorage`; a value that IS the field's default is written by removing that entry from the user layer instead (the same thing as "not customized"). On a non-loopback page DSH marks settings read-only, so those nine preferences fall back to the mirror and behave exactly as in 0.5.x; values left by a 0.5.x install are imported into the host layer once, the first time it answers (and only while the user layer is empty).
+- Preferences sit in two layers behind one module-level store: the Host settings document (language, docked edge, levels, scale, handle position, remembered reading position, fuzzy, hover and diagnostic; authoritative on a loopback page) and `localStorage` (the mirror, plus the real storage for top offset / width / height, which describe this screen and are saved per browser). **The host layer itself is one of two dialects, whichever the running host offers**: on 0.1.5-rc.x it is `ctx.settingsScope.bind({ namespace: "dsh-quick-toc" })` (addressed by namespace), while on 0.1.7-alpha.x it is `ctx.configForms.get(<profile entry id>)` (addressed by profile entry id, the client recognising its own entry by the schema the host serves). Both expose the same methods over the same snapshot fields, so the store stays one. Writes are routed per field: host fields go through `scope.mutate` (folded in locally, reconciled when the host answers), everything else goes to `localStorage`; a value that IS the field's default is written by removing that entry from the user layer instead (the same thing as "not customized"). On a non-loopback page DSH marks settings read-only, so those nine preferences fall back to the mirror and behave exactly as in 0.5.x; values left by a 0.5.x install are imported into the host layer once, the first time it answers (and only while the user layer is empty). Once the host has answered, that layer is authoritative — which is why a local key such as `localStorage['dsh-quick-toc.debug']` no longer takes effect on a loopback page: use the switch in the card.
 - The curtain and the docked panel **share one list DOM**: the curtain only moves the panel itself into a full-width container that drops from the lower edge of the tab strip (in curtain mode the panel swaps to a different geometry — relative positioning, 100% width and height, no panel scale), and that container stays mounted as a zero-size pass-through while the curtain is up, so opening or closing it never rebuilds the list or loses the scroll position. Cross-session search goes through the client `ctx.get("sessions")` service's `search(query, signal)` (the host's session full-text index, at most 20 hits per search); each session's reading position lives in this browser (`dsh-quick-toc.readPos.v1`, valid for half an hour).
-- The configuration card registers into the `settings.plugin.item` slot (keyed on the plugin's namespace; the slot is dispatched only for namespaces the Host actually serves, so a deployment without the host half simply shows no card and the panel is unaffected). The card and the panel share the store above, which is what makes the two live in both directions.
+- The configuration card is registered into one of two slots, whichever the running host offers: on 0.1.5-rc.x it is `settings.plugin.item` (keyed on the plugin's namespace; the slot is dispatched only for namespaces the Host actually serves, so a deployment without the host half simply shows no card and the panel is unaffected), and on 0.1.7-alpha.x it is `plugins.bundle.config` (keyed on the npm package name, so the card appears on that bundle's page in the sidebar's Plugins list). Both registrations happen only once a settings scope has bound, and the card and the panel share the store above, which is what makes the two live in both directions.
 - Changes to `lib/client.js` show up after a page refresh (client modules are served under a content hash and DSH's client HMR pushes reloads); changes to `lib/index.js` (the host half) need a DSH restart
 
 ## License

package/README.md

@@ -31,6 +31,7 @@
 - **回到我离开的位置** —— 关闭面板或幕布时记住列表顶部那一行（两者各记各的、互不覆盖），下次打开时列表右上角出现向上的浮动按钮，一步回到那一行的**原位置**；用过一次或自己滚回该处就渐隐并忘掉，直到下次关闭再记。同一规则下，打开面板或幕布时**正在阅读的那一行**会落在列表顶部（读的就在最新几轮时列表已经到底，那一行自然停在底部）
 - **可停靠、可缩放** —— 拖顶部横条移动，◀ / ▶ 切换左右停靠，拖边缘调宽高（尺寸没有上限，最窄可到 120px），收起后成为边缘把手（停在什么高度由设置里的「把手位置」决定）；位置与尺寸按浏览器记住（顶边距、宽度、高度只通过拖拽调整）
 - **面板缩放** —— 设置里的滑块把**内容**（文字、图标、按钮及其间距）在 50%–200% 之间按 5% 一档缩放，**面板本身的尺寸不变**；拖动滑块时只移动读数，松手才写入设置。面板变窄时顶栏四颗按钮保持一行：先挤掉中间的空白，挤满后整行可横向滚动（在顶栏上滚滚轮即可），此时顶部的灰色拖拽横条渐隐消失
+- **幕布缩放** —— 另一个滑块，把**幕布内容**在 50%–200% 之间按 5% 一档缩放，幕布本身的尺寸不变；与面板缩放各自独立、互不影响。幕布内容的默认大小比此前小一档（滑块的 100% 即此前的 90%），且只缩放幕布里的大纲，不改变对话本体
 - **分页** —— 默认显示最近的若干组，向上滚动既展开索引也加载更早的对话
 - **边界提示** —— 滚到最早或最新再继续滚动时，面板底部短暂提示
 - **Markdown 感知** —— 标题中的行内标记会被剥离；围栏代码块里的 `#` 行不算标题
@@ -41,7 +42,7 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.7.x**（最新，0.7.1） | 0.1.5-rc.1、0.1.5-rc.2 |
+| **0.7.x**（最新，0.7.3） | 0.1.5-rc.1、0.1.5-rc.2、0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2 |
 | 0.6.x（0.6.3） | 0.1.5-rc.1、0.1.5-rc.2 |
 | 0.5.x（0.5.1） | 0.1.5-rc.1、0.1.5-rc.2 |
 | 0.4.x（0.4.1） | 0.1.5-rc.1、0.1.5-rc.2 |
@@ -50,7 +51,7 @@
 
 每个大版本只列该系列最新的一个补丁版本（新功能引入的缺陷都在其后的补丁里修掉了，所以同一个大版本内直接用最新补丁即可；旧补丁仍可继续用，插件不破坏既有接口）。
 
-`engines.dsh` 下限为 **0.1.5-rc.1**（`>=`，该版本起插件改用会话级槽位注入的宿主接口）。0.7.1 在 **0.1.5-rc.2** 上实测通过（「回到我离开的位置」浮动按钮、面板与幕布分别记录的离开位置、打开时落在正在阅读的那一行、以及在底部关闭再打开不出按钮都逐项确认）；0.7.0 在同一版本上实测通过（全屏幕布与液滴把手、跳到本节末尾、跨会话检索、键盘导航、只看提问、记住阅读位置都在真实浏览器里逐项跑过；面板缩放、尺寸的落盘与读回、收起把手的位置等既有能力此前已实测）；**0.1.5-rc.1** 上实测了插件加载与客户端模块下发（宿主启动无报错、`--dump-config` 里有 quick-toc 条目、客户端组合包 URL 里列出 `dsh-quick-toc/client.js`，取回的下发内容包含本版新增的幕布把手、跳到本节末尾与阅读位置等标记），它依赖的宿主接口——`turnOutline` 投影、会话级槽位的 `useProjection`、客户端 `sessions` 服务与 `loadThrough` 跳转加载器（0.5.0 起）、失败回合所用的 `turn-error` 节点（0.5.1 起）、以及 0.6.0 新增的宿主 `settings` 服务（`installSection`）、客户端 `settingsScope` 与 `settings.plugin.item` 配置卡片槽位、以及 0.7.0 跨会话检索所用的客户端 `sessions.search`——在 0.1.5-rc.1 与 0.1.5-rc.2 的安装包中逐个核对存在（这些宿主包的代码在两版之间逐字节相同，`dsh-client-ui-chat` 仅差一条与本插件无关的 CSS 声明；`search` 所在的 `dsh-api-session-controller` 两版逐字节相同，含「一次最多 20 条、片段上限 240 字符」的同一套上限），因此两版都声明兼容。更早或更新的 DSH 版本未经验证，不作声明；在更早的 DSH 上可安装的最新插件版本是 **0.3.2**。安装或更新时，DSH 市场会依据 `package.json` 中的 `engines.dsh`、`dsh.compatibility.dshReleases` 与 `peerDependencies` 做宿主兼容预检。
+`engines.dsh` 声明为 **`>=0.1.5-rc.1 <0.1.7-0 || >=0.1.7-alpha.1 <0.2.0-0`**，peer 范围同形（预发布版本必须显式留分支：node-semver 只在一个范围的某个比较符与该版本落在同一个 `major.minor.patch` 元组、且自身带预发布标签时才放行它，所以写成 `>=0.1.5-rc.1` 是匹配不到 `0.1.7-alpha.1` 的）。0.7.3 在 **0.1.5-rc.3** 与 **0.1.7-alpha.2** 上实测通过（面板与幕布、点行跳转与翻历史、标题/全文/跨会话三档检索、跨会话命中切换会话、设置卡片与宿主设置文档的读写都逐项跑过），这两版不需要任何代码改动——离线核对：rc.3 相对 rc.2 只有各包 `package.json` 的版本号差异（外加侧边栏两个文件），alpha.2 的改动集中在会话控制器与聊天渲染，但插件依赖的接口与节点形状逐项核对后仍在（`turnOutline`、`turn-error`、`useChat`、`data-chat-anchor-key`、`sessions.search`、`loadThrough`、`settings.*` 与两张卡片槽位都在，`data-conversation-scroll` 在 alpha.2 里新增的两处命中是样式表文本、不是第二个滚动容器）。0.7.2 在 **0.1.5-rc.2** 上实测通过（幕布缩放逐项确认：三档因子下幕布盒子的宽高与位置不变、只有内容按比例缩放，50%–200% 两端、松手写入、以及默认值渲染都比对过；面板与幕布两套缩放各自独立）；0.7.1 在 **0.1.5-rc.2** 上实测通过（「回到我离开的位置」浮动按钮、面板与幕布分别记录的离开位置、打开时落在正在阅读的那一行、以及在底部关闭再打开不出按钮都逐项确认）；0.7.0 在同一版本上实测通过（全屏幕布与液滴把手、跳到本节末尾、跨会话检索、键盘导航、只看提问、记住阅读位置都在真实浏览器里逐项跑过；面板缩放、尺寸的落盘与读回、收起把手的位置等既有能力此前已实测）；**0.1.5-rc.1** 上实测了插件加载与客户端模块下发（宿主启动无报错、`--dump-config` 里有 quick-toc 条目、客户端组合包 URL 里列出 `dsh-quick-toc/client.js`，取回的下发内容包含本版新增的幕布把手、跳到本节末尾与阅读位置等标记），它依赖的宿主接口——`turnOutline` 投影、会话级槽位的 `useProjection`、客户端 `sessions` 服务与 `loadThrough` 跳转加载器（0.5.0 起）、失败回合所用的 `turn-error` 节点（0.5.1 起）、以及 0.6.0 新增的宿主 `settings` 服务（`installSection`）、客户端 `settingsScope` 与 `settings.plugin.item` 配置卡片槽位、以及 0.7.0 跨会话检索所用的客户端 `sessions.search`——在 0.1.5-rc.1 与 0.1.5-rc.2 的安装包中逐个核对存在（这些宿主包的代码在两版之间逐字节相同，`dsh-client-ui-chat` 仅差一条与本插件无关的 CSS 声明；`search` 所在的 `dsh-api-session-controller` 两版逐字节相同，含「一次最多 20 条、片段上限 240 字符」的同一套上限），因此两版都声明兼容。更早的 DSH 版本未经验证，不作声明；在更早的 DSH 上可安装的最新插件版本是 **0.3.2**。**0.1.7-alpha.1 上也实测通过**（隔离的 `DSH_HOME` 里跑真实实例）：宿主启动无报错、面板与幕布、点行跳转与翻历史、标题/全文/跨会话三档检索、跨会话命中切换会话，都在真实浏览器里逐项跑过，设置文档的读写也逐项确认。为此 0.7.2 同时支持两条宿主线——0.1.5-rc.x 上是宿主的 `settings.installSection` + 客户端 `settingsScope` + `settings.plugin.item` 卡片槽位，0.1.7-alpha.x 上换成 `settings.configure` + 客户端 `configForms` + `plugins.bundle.config` 卡片槽位、并用 `uiWorkspace.openSession` 切换会话；插件在运行时按服务是否存在二选一，且**不再把任一设置服务写进 `inject`**（声明一个宿主没有的服务会让整个包停在 pending，0.1.7-alpha.1 上这曾让整页 Web 起不来）。安装或更新时，市场（dshmarket）读取 npm 上 `latest` 版本的 `engines.dsh`（或 `dsh.engines.dsh`）与本机存在的 `@deepseek-ai/dsh-*` peer 范围，在卡片上显示该插件声明的宿主要求，并提供「只显示与当前宿主确认匹配的条目」这一可选过滤；`dsh.compatibility.dshReleases` 是本仓库自己的记录，DSH 与市场都不读取。
 
 ## 安装
 
@@ -112,9 +113,9 @@ dsh plugin --profile web add <插件目录路径>
 - 「未加载回合」能力依赖宿主的两样东西：`turnOutline` 投影（整段会话的回合索引，每条含 `turn/start` 的 seq）与会话跳转加载器（客户端 `sessions` 服务的 `binding(sessionId).session.loadThrough(seq)`，通过客户端 ctx 的 `ctx.get("sessions")` 免声明查找取得）。两者各自独立降级：没有投影时只列已加载回合，没有加载器时未加载条目只展示、不跳转，面板其余功能不受影响。
 - 失败回合的报错行读的是宿主的 `turn-error` 会话节点（宿主在 `turn/end` 的原因为 `error` 时发布，含 `message` 与可选的 `code`）；宿主不提供该节点时只是不显示这一行，其余功能不受影响。
 - 界面文字来自 `lib/client.js` 顶部的一张字符串表（`DICTS`，中英各一份），语言设置决定用哪一份：`跟随宿主` 时优先问宿主的翻译函数（`ctx.locale.bind("dsh-quick-toc")`，注册的表就来自 `DICTS`），拿不到才回退到内置表。中英两份表的键必须对齐（仅 `time.beforeYesterday`（前天）是中文独有——英文对更早的时间直接用日期；`time.yesterday` 两语言都有，英文作 `yesterday`）。
-- 偏好存储分两层，由一个模块级 store 统一读出：宿主设置文档（`ctx.settingsScope.bind({ namespace: "dsh-quick-toc" })`，语言/停靠边/层级/缩放/把手位置/记住阅读位置/模糊/悬停/诊断九项，回环页面上是权威层）与 `localStorage`（镜像 + 顶边距/宽度/高度三项的正式存储——它们描述"这一块屏幕"，按浏览器保存）。写入按字段路由：宿主字段走 `scope.mutate`（本地同步折叠、宿主应答后对账），其余写 `localStorage`；写入的值若正好是该字段的默认值，则改为把用户层里的这一项删掉（等同于"未自定义"）。非回环页面 DSH 将设置标记为只读，此时这九项偏好退回本地镜像，行为与 0.5.x 一致；0.5.x 留下的本地值会在宿主层首次应答时导入一次（仅当用户层为空）。
+- 偏好存储分两层，由一个模块级 store 统一读出：宿主设置文档（语言/停靠边/层级/缩放/把手位置/记住阅读位置/模糊/悬停/诊断九项，回环页面上是权威层）与 `localStorage`（镜像 + 顶边距/宽度/高度三项的正式存储——它们描述"这一块屏幕"，按浏览器保存）。**宿主那一层按运行中的宿主二选一**：0.1.5-rc.x 上是 `ctx.settingsScope.bind({ namespace: "dsh-quick-toc" })`（按命名空间寻址），0.1.7-alpha.x 上改成 `ctx.configForms.get(<profile entry id>)`（按 profile 条目 id 寻址，客户端按宿主实际服务的 schema 认出自己那一条）；两者暴露的方法与快照字段相同，所以 store 只有一套。写入按字段路由：宿主字段走 `scope.mutate`（本地同步折叠、宿主应答后对账），其余写 `localStorage`；写入的值若正好是该字段的默认值，则改为把用户层里的这一项删掉（等同于"未自定义"）。非回环页面 DSH 将设置标记为只读，此时这九项偏好退回本地镜像，行为与 0.5.x 一致；0.5.x 留下的本地值会在宿主层首次应答时导入一次（仅当用户层为空）。宿主应答之后宿主层就是权威层，因此 `localStorage['dsh-quick-toc.debug']` 这类本地键在回环页面上不再生效——诊断开关请用卡片里那一条。
 - 幕布与停靠面板**共用同一份列表 DOM**：幕布只是把面板本体搬进一个从标签条下沿落下的整宽容器（面板在幕布态换一套几何：相对定位、宽高 100%、不套用面板缩放），容器本身常驻挂载、收起时是一个 0×0 的直通盒，所以开关幕布不会重建列表、也不会丢掉滚动位置。跨会话检索走客户端 `ctx.get("sessions")` 的 `search(query, signal)`（走宿主的会话全文索引，一次最多 20 条）；每个会话的阅读位置存在浏览器本地（`dsh-quick-toc.readPos.v1`，半小时内有效）。
-- 插件配置卡片注册进 `settings.plugin.item` 槽（`key` 为插件命名空间；该槽按宿主实际提供的命名空间派发，宿主半未加载时卡片自然不出现，面板不受影响）；卡片与面板共享上面那个 store，因此两边实时互通。
+- 插件配置卡片也按宿主二选一注册：0.1.5-rc.x 上挂 `settings.plugin.item` 槽（`key` 为插件命名空间，该槽按宿主实际提供的命名空间派发，宿主半未加载时卡片自然不出现，面板不受影响）；0.1.7-alpha.x 上改挂 `plugins.bundle.config` 槽（`key` 为 npm 包名，卡片出现在侧边栏「插件」页该 bundle 的页面上）。两条注册都只在设置作用域绑定成功后才做，卡片与面板共享上面那个 store，因此两边实时互通。
 - 修改 `lib/client.js` 后刷新页面即可看到变化（客户端模块按内容哈希发版，DSH 的客户端 HMR 也会推送重载）；改 `lib/index.js`（宿主半）需重启 DSH
 
 ## License