dsh-quick-toc 0.6.1 → 0.6.3

package/CHANGELOG.en.md

@@ -2,6 +2,24 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.6.3] - 2026-09-15
+
+### Fixed
+- **The configuration card's expand/collapse chevron did not match the host's arrows**: it was a text character (⌄), thinner than the host's 14×14 SVG chevron icon, and the glyph's ink is not centred inside its 20px line box — the rotation turned around the box centre, so the glyph swung aside instead of flipping in place. It is now the host's own 14×14 SVG chevron (an inline SVG whose path is byte-identical to the icon the host uses, with the class on the `<svg>` itself — the same structure as the host's plugin card), so expanding and collapsing flip it around the icon's own centre.
+
+## [0.6.2] - 2026-09-15
+
+### Added
+- **A vertical position for the collapsed handle**: the card gains a "Handle position" row — a **0%–100% slider in 1% steps** that decides where the edge handle sits vertically once the panel is collapsed: `0%` at the bottom, `100%` at the top, and `50%` (the previously fixed centred spot) by default. The handle follows that height on whichever edge the panel is docked to.
+
+### Changed
+- **Writing a default value back means "not customized"**: as soon as a card field is back at its default (a slider returned to the default step, a switch returned to its default state, the level set back to the default selection), the entry leaves the document's user layer — the "customized" badge and that field's "Reset" go with it, exactly as if it had never been changed. 0.6.1 and earlier pinned the default into the settings document and kept the badge.
+
+### Fixed
+- **A panel size could fail to reach storage**: the size write is debounced by 0.4s, and the "already published" record was advanced the moment a write was scheduled — so a second adjustment inside that window (dragging the height, dragging the top bar, toggling a level or the fuzzy switch) cancelled the pending write while the record already counted it as published, and that size was never written again. Measured: drag the width 200 → 150 and then drag the height, and the stored width stayed 200 — the next load brought the panel back 200px wide. The record now advances only when the write really happens, and a cancelled write is issued again on the next pass.
+- **A narrow or short panel's size was stored in vain**: the limits used when reading a size back disagreed with the drag limits — dragging allows 120px wide and 60px high, but anything under 180px wide / 160px high was discarded as invalid on the next load, dropping the panel back to the default width. Both sides now share the same floors (120px / 60px).
+- **The first height drag jumped while the height was "auto"**: the drag started from a fixed 400px guess, so a panel that was in fact taller or shorter jumped to a wrong height on the very first move. It now starts from the panel's measured height (the visual height after the panel scale — the unit that gets stored), falling back to 400px only when nothing can be measured.
+
 ## [0.6.1] - 2026-09-15
 
 ### Added

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.6.3] - 2026-09-15
+
+### 修复
+- **配置卡片的展开/收起箭头与宿主界面的箭头不一致**：箭头原先是一个文本字符（⌄），比宿主 14×14 的 SVG 箭头图标更细；而且字符的墨迹在 20px 行盒里并不居中，旋转绕的是盒子中心，转起来字符就被甩向一旁，看起来不像绕自身翻转。现在换成与宿主一致的 14×14 SVG 箭头图标（内联 SVG，路径与宿主所用图标逐字节一致，类名直接挂在 `<svg>` 上——与宿主插件卡片相同的做法），展开/收起时绕图标自身中心原地翻转。
+
+## [0.6.2] - 2026-09-15
+
+### 新增
+- **收起把手的垂直位置**：设置卡片里新增「把手位置」——**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.6.1] - 2026-09-15
 
 ### 新增

package/README.en.md

@@ -10,7 +10,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 - **Whole-session coverage** — turns the conversation window has not loaded are listed too (tagged `未加载` / "Not loaded", with previews); clicking one loads that turn and jumps to it
 - **Failures are reported** — a turn with no reply at all (request timeout, upstream error) shows `请求失败` / "Request failed" plus the host's error text, and clicking it jumps to that error in the conversation
 - **Bilingual** — the interface language can follow the host, or be forced to Chinese or English; Chinese stamps use `昨天` / `前天`, English reads yesterday as the word (`yesterday`) and carries the `YY-MM-DD HH:MM` date for anything older
-- **A plugin-configuration card** — a "Conversation Outline" card under Settings → Plugins → Plugin configuration: the language, the default docked edge, the panel-scale slider, the heading levels shown, fuzzy search, hover previews and the diagnostic switch; changed fields are marked "customized" and can be reset individually, and the card and the panel stay in sync
+- **A plugin-configuration card** — a "Conversation Outline" card under Settings → Plugins → Plugin configuration: the language, the default docked edge, the heading levels shown, where the collapsed handle sits, fuzzy search, hover previews and the diagnostic switch; changed fields are marked "customized" and can be reset individually (returning a field to its default drops the mark), and the card and the panel stay in sync
 - **Turn stamps carry the day** — yesterday reads `昨天 15:04`, the day before `前天 15:04`, anything older `25-09-11 15:04`, so times never blur together in a session spanning days (with the interface in English every stamp older than today carries a `YY-MM-DD` date instead)
 - **Row subtitles** — under each heading, the first sentence of that section, so identically-titled headings can be told apart
 - **Hover previews** — hovering a heading row shows the section's opening, the turn time and the heading path
@@ -22,7 +22,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 - **Auto-follow** — the turn being read lights up in a closed blue box while you scroll the conversation; the outline follows on its own
 - **Jumping** — click a heading to jump to its position in the conversation, with the scroll animation handed to the browser's own smooth scrolling (advanced on the wall clock, so it takes the same time on a 60 Hz and a 240 Hz panel); when the host re-pages and moves the target mid-flight the jump re-aims, and when the host's own scrolling cancels the animation it is issued again, so a cross-page jump never stops halfway; a browser that carries the call out at once gets a frame-by-frame glide drawn by the plugin instead
 - **Back to the newest row** — after paging far up, a floating button in the list's lower-right corner returns to the newest entry in one click (it appears when the list is not at its bottom and disappears once it is)
-- **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; position and size are remembered per browser (top offset, width and height are adjusted by dragging only)
+- **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
 - **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
@@ -34,7 +34,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.6.x** (latest, 0.6.1) | 0.1.5-rc.1, 0.1.5-rc.2 |
+| **0.6.x** (latest, 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 |
 | 0.3.x (0.3.3) | 0.1.5-rc.1 |
@@ -42,7 +42,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.6.1 was tested on **0.1.5-rc.2** (the host half's settings-namespace registration, the configuration card, the jump animation and the panel scale were all measured); on **0.1.5-rc.1** the plugin's loading and client-module delivery were tested for real (the host boots, and the `dsh-quick-toc/client.js` rev in its boot graph is byte-identical to this repository's `lib/client.js`). 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 — 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); nothing in 0.6.1 relies on a new host interface (the scale is CSS inside the panel, the slider lives in the plugin's own card, and the jump uses the container's `scrollTo`), 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` has a floor of **0.1.5-rc.1** (`>=`): from that release on, the plugin uses the host's session-scoped slot injection. 0.6.3 was tested on **0.1.5-rc.2** (this release's only change is the configuration card's expand/collapse chevron, which was compared byte-for-byte against the host's own chevron icon and verified to flip around the icon's own centre in a real browser; 0.6.2 already measured a dragged size reaching storage and coming back after a reload, and the collapsed handle's position; 0.6.1 already measured the host half's settings-namespace registration, the configuration card, the jump animation and the panel scale); on **0.1.5-rc.1** the plugin's loading and client-module delivery were tested for real (the host boots, and the `dsh-quick-toc/client.js` rev in its boot graph is byte-identical to this repository's `lib/client.js`). 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 — 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); nothing in 0.6.3 relies on a new host interface (the chevron is an inline SVG inside the plugin's own card), 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`.
 
 ## Install
 
@@ -77,7 +77,7 @@ After installing, restart DSH and open the Web UI. The panel starts collapsed; c
 - **Loading older turns**: scroll up inside the outline (it both expands the index and loads older conversation)
 - **Back to the newest row**: after paging far up, click the floating button in the list's lower-right corner
 - **Reading position**: scroll the conversation and the turn you are reading is boxed in blue; the outline follows
-- **Settings**: expand the "Conversation Outline" card under **Settings → Plugins → Plugin configuration** for the language, the default docked edge, the panel scale (a 50%–200% slider in 5% steps), the heading levels shown and the fuzzy / hover / diagnostic switches; changed fields can be reset individually. The card and the panel are live in both directions, with no reload needed, and the preferences follow the DSH settings document
+- **Settings**: expand the "Conversation Outline" card under **Settings → Plugins → Plugin configuration** for the language, the default docked edge, the panel scale (a 50%–200% slider in 5% steps), where the collapsed handle sits (a 0%–100% slider in 1% steps: 0% at the bottom, 100% at the top, 50% centred by default), the heading levels shown and the fuzzy / hover / diagnostic switches; changed fields can be reset individually (returning one to its default drops the mark). The card and the panel are live in both directions, with no reload needed, and the preferences follow the DSH settings document
 
 ## Diagnostics
 
@@ -98,7 +98,7 @@ 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, 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`. On a non-loopback page DSH marks settings read-only, so the six 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 (`ctx.settingsScope.bind({ namespace: "dsh-quick-toc" })` — language, docked edge, levels, scale, handle 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 eight 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).
 - 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.
 - 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
 

package/README.md

@@ -10,7 +10,7 @@
 - **覆盖整段会话** —— 未加载进对话窗口的回合也在列表里（带「未加载」标记与预览）；点击即加载该回合并跳过去
 - **失败回合的报错** —— 请求超时 / 上游报错这类没有回复的回合显示 `请求失败` 与报错原文，点击跳到对话中的报错位置
 - **中英双语** —— 界面语言可设为跟随宿主、中文或 English；中文时间戳用 `昨天` / `前天`，英文昨天用 `yesterday`、更早用 `YY-MM-DD HH:MM` 日期
-- **插件配置卡片** —— 设置 → 插件 → 插件配置里的「对话大纲」卡片：语言、默认停靠边缘、面板缩放滑块、显示的标题层级、模糊搜索、悬停预览与诊断开关；改过的字段标「已自定义」并可单独重置，卡片与面板实时同步
+- **插件配置卡片** —— 设置 → 插件 → 插件配置里的「对话大纲」卡片：语言、默认停靠边缘、显示的标题层级、收起把手的位置、模糊搜索、悬停预览与诊断开关；改过的字段标「已自定义」并可单独重置（改回默认值时标记自动消失），卡片与面板实时同步
 - **回合时间带日期** —— 昨天 `昨天 15:04`、前天 `前天 15:04`、更早 `25-09-11 15:04`，跨天的会话里时间不再重影
 - **标题行副标题** —— 每行标题下方显示该节正文的第一句，同名标题一眼可辨
 - **悬停预览** —— 悬停标题行显示该节开头、回合时间与层级路径
@@ -22,7 +22,7 @@
 - **自动跟随** —— 滚动对话时正在阅读的回合自动点亮（封闭蓝框），大纲自动跟随
 - **跳转** —— 点击标题跳到对话中该标题的位置，滚动动画交给浏览器自己的平滑滚动（按真实时间推进，60Hz 与 240Hz 屏幕上时长一致）；飞行中目标被宿主翻页挪动时会重新瞄准、动画被宿主滚动打断时会重新发起，跨页远跳不会半途停下；若某个浏览器把平滑滚动直接执行成瞬移，插件改为自己逐帧绘制。面板与对话双向定位
 - **回到底部** —— 往上翻远之后，列表右下角的浮动按钮一步回到最新一条（不在底部时出现、到底后消失）
-- **可停靠、可缩放** —— 拖顶部横条移动，◀ / ▶ 切换左右停靠，拖边缘调宽高（尺寸没有上限，最窄可到 120px），收起后成为边缘把手；位置与尺寸按浏览器记住（顶边距、宽度、高度只通过拖拽调整）
+- **可停靠、可缩放** —— 拖顶部横条移动，◀ / ▶ 切换左右停靠，拖边缘调宽高（尺寸没有上限，最窄可到 120px），收起后成为边缘把手（停在什么高度由设置里的「把手位置」决定）；位置与尺寸按浏览器记住（顶边距、宽度、高度只通过拖拽调整）
 - **面板缩放** —— 设置里的滑块把**内容**（文字、图标、按钮及其间距）在 50%–200% 之间按 5% 一档缩放，**面板本身的尺寸不变**；拖动滑块时只移动读数，松手才写入设置。面板变窄时顶栏四颗按钮保持一行：先挤掉中间的空白，挤满后整行可横向滚动（在顶栏上滚滚轮即可），此时顶部的灰色拖拽横条渐隐消失
 - **分页** —— 默认显示最近的若干组，向上滚动既展开索引也加载更早的对话
 - **边界提示** —— 滚到最早或最新再继续滚动时，面板底部短暂提示
@@ -34,7 +34,7 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.6.x**（最新，0.6.1） | 0.1.5-rc.1、0.1.5-rc.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 |
 | 0.3.x（0.3.3） | 0.1.5-rc.1 |
@@ -42,7 +42,7 @@
 
 每个大版本只列该系列最新的一个补丁版本（新功能引入的缺陷都在其后的补丁里修掉了，所以同一个大版本内直接用最新补丁即可；旧补丁仍可继续用，插件不破坏既有接口）。
 
-`engines.dsh` 下限为 **0.1.5-rc.1**（`>=`，该版本起插件改用会话级槽位注入的宿主接口）。0.6.1 在 **0.1.5-rc.2** 上实测通过（宿主半的设置命名空间注册、配置卡片、跳转动画与面板缩放均实测）；**0.1.5-rc.1** 上实测了插件加载与客户端模块下发（宿主启动正常、boot graph 中 `dsh-quick-toc/client.js` 的 rev 与本仓库 `lib/client.js` 逐字节一致），它依赖的宿主接口——`turnOutline` 投影、会话级槽位的 `useProjection`、客户端 `sessions` 服务与 `loadThrough` 跳转加载器（0.5.0 起）、失败回合所用的 `turn-error` 节点（0.5.1 起）、以及 0.6.0 新增的宿主 `settings` 服务（`installSection`）、客户端 `settingsScope` 与 `settings.plugin.item` 配置卡片槽位——在 0.1.5-rc.1 与 0.1.5-rc.2 的安装包中逐个核对存在（这些宿主包的代码在两版之间逐字节相同，`dsh-client-ui-chat` 仅差一条与本插件无关的 CSS 声明）；0.6.1 的新功能都不依赖新的宿主接口（缩放是面板内的 CSS，滑块在插件自己的卡片里，跳转用容器的 `scrollTo`），因此两版都声明兼容。更早或更新的 DSH 版本未经验证，不作声明；在更早的 DSH 上可安装的最新插件版本是 **0.3.2**。安装或更新时，DSH 市场会依据 `package.json` 中的 `engines.dsh`、`dsh.compatibility.dshReleases` 与 `peerDependencies` 做宿主兼容预检。
+`engines.dsh` 下限为 **0.1.5-rc.1**（`>=`，该版本起插件改用会话级槽位注入的宿主接口）。0.6.3 在 **0.1.5-rc.2** 上实测通过（本轮改动只有配置卡片的展开/收起箭头，已在真实浏览器里与宿主的同款图标逐字节比对、并验证展开/收起时绕图标自身中心翻转；0.6.2 已实测面板尺寸的落盘与刷新后的读回、收起把手的位置；0.6.1 已实测宿主半的设置命名空间注册、配置卡片、跳转动画与面板缩放）；**0.1.5-rc.1** 上实测了插件加载与客户端模块下发（宿主启动正常、boot graph 中 `dsh-quick-toc/client.js` 的 rev 与本仓库 `lib/client.js` 逐字节一致），它依赖的宿主接口——`turnOutline` 投影、会话级槽位的 `useProjection`、客户端 `sessions` 服务与 `loadThrough` 跳转加载器（0.5.0 起）、失败回合所用的 `turn-error` 节点（0.5.1 起）、以及 0.6.0 新增的宿主 `settings` 服务（`installSection`）、客户端 `settingsScope` 与 `settings.plugin.item` 配置卡片槽位——在 0.1.5-rc.1 与 0.1.5-rc.2 的安装包中逐个核对存在（这些宿主包的代码在两版之间逐字节相同，`dsh-client-ui-chat` 仅差一条与本插件无关的 CSS 声明）；0.6.3 的改动都不依赖新的宿主接口（箭头是插件自己卡片里的内联 SVG），因此两版都声明兼容。更早或更新的 DSH 版本未经验证，不作声明；在更早的 DSH 上可安装的最新插件版本是 **0.3.2**。安装或更新时，DSH 市场会依据 `package.json` 中的 `engines.dsh`、`dsh.compatibility.dshReleases` 与 `peerDependencies` 做宿主兼容预检。
 
 ## 安装
 
@@ -77,7 +77,7 @@ dsh plugin --profile web add <插件目录路径>
 - **加载更早**：在大纲中向上滚动（既展开索引，也加载更早的对话）
 - **回到底部**：翻远了之后点列表右下角的浮动按钮回到最新一条
 - **阅读位置**：滚动对话，正在阅读的回合会以蓝框标出；大纲会自动跟随
-- **设置**：在 **设置 → 插件 → 插件配置** 里展开「对话大纲」卡片，可改语言、默认停靠边缘、面板缩放（50%–200% 滑块，5% 一档）、显示的标题层级与模糊/悬停/诊断开关；改过的字段可单独重置。卡片与面板实时同步，不需要刷新；偏好保存在 DSH 的设置里，跟随配置走
+- **设置**：在 **设置 → 插件 → 插件配置** 里展开「对话大纲」卡片，可改语言、默认停靠边缘、面板缩放（50%–200% 滑块，5% 一档）、收起把手的位置（0%–100% 滑块，1% 一档；0% 在最下、100% 在最上，默认 50% 居中）、显示的标题层级与模糊/悬停/诊断开关；改过的字段可单独重置（改回默认值时标记自动消失）。卡片与面板实时同步，不需要刷新；偏好保存在 DSH 的设置里，跟随配置走
 
 ## 诊断
 
@@ -98,7 +98,7 @@ 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 统一读出：宿主设置文档（`ctx.settingsScope.bind({ namespace: "dsh-quick-toc" })`，语言/停靠边/层级/缩放/把手位置/模糊/悬停/诊断八项，回环页面上是权威层）与 `localStorage`（镜像 + 顶边距/宽度/高度三项的正式存储——它们描述"这一块屏幕"，按浏览器保存）。写入按字段路由：宿主字段走 `scope.mutate`（本地同步折叠、宿主应答后对账），其余写 `localStorage`；写入的值若正好是该字段的默认值，则改为把用户层里的这一项删掉（等同于"未自定义"）。非回环页面 DSH 将设置标记为只读，此时这八项偏好退回本地镜像，行为与 0.5.x 一致；0.5.x 留下的本地值会在宿主层首次应答时导入一次（仅当用户层为空）。
 - 插件配置卡片注册进 `settings.plugin.item` 槽（`key` 为插件命名空间；该槽按宿主实际提供的命名空间派发，宿主半未加载时卡片自然不出现，面板不受影响）；卡片与面板共享上面那个 store，因此两边实时互通。
 - 修改 `lib/client.js` 后刷新页面即可看到变化（客户端模块按内容哈希发版，DSH 的客户端 HMR 也会推送重载）；改 `lib/index.js`（宿主半）需重启 DSH
 

package/lib/client.js

@@ -77,6 +77,8 @@ window.__ModuleLoader__.load({
         "settings.levels": "显示的标题层级",
         "settings.zoom": "面板缩放",
         "settings.zoom.tip": "文字、图标与按钮按比例缩放，面板本身的尺寸不变",
+        "settings.handle": "把手位置",
+        "settings.handle.tip": "收起面板后，边缘把手在对话区里的上下位置（0% 最下、100% 最上）",
         "settings.on": "开启",
         "settings.off": "关闭",
         "settings.fuzzy": "模糊搜索",
@@ -139,6 +141,8 @@ window.__ModuleLoader__.load({
         "settings.levels": "Heading levels shown",
         "settings.zoom": "Panel scale",
         "settings.zoom.tip": "Scales the text, icons and buttons; the panel's own size is unchanged",
+        "settings.handle": "Handle position",
+        "settings.handle.tip": "Where the collapsed-panel handle sits vertically (0% bottom, 100% top of the conversation area)",
         "settings.on": "On",
         "settings.off": "Off",
         "settings.fuzzy": "Fuzzy search",
@@ -205,13 +209,13 @@ window.__ModuleLoader__.load({
     // purpose — they describe THIS screen, not the account.
     var NAMESPACE = "dsh-quick-toc";
     // Fields backed by the Host settings document; everything else is localStorage.
-    var HOST_FIELDS = { dock: 1, lang: 1, levels: 1, zoom: 1, fuzzy: 1, hover: 1, debug: 1 };
+    var HOST_FIELDS = { dock: 1, lang: 1, levels: 1, zoom: 1, handle: 1, fuzzy: 1, hover: 1, debug: 1 };
     // The schema defaults (mirrored here for the card's per-field reset and for the
     // one-time import of a 0.5.x install's stored values).
     var DEFAULTS = {
       dock: "left", y: 0, w: 0, h: 0,
       levels: [1, 2, 3, 4, 5, 6],
-      zoom: 1,
+      zoom: 1, handle: 0.5,
       fuzzy: false, hover: true, lang: "auto", debug: false
     };
     var PREF_KEYS = {
@@ -221,11 +225,21 @@ window.__ModuleLoader__.load({
       h: "dsh-quick-toc.panelH.v1",
       levels: "dsh-quick-toc.levels.v1",
       zoom: "dsh-quick-toc.zoom.v1",
+      handle: "dsh-quick-toc.handle.v1",
       fuzzy: "dsh-quick-toc.fuzzy.v1",
       hover: "dsh-quick-toc.hover.v1",
       lang: "dsh-quick-toc.lang.v1",
       debug: "dsh-quick-toc.debug"
     };
+    // Writing a field's schema default through the card IS its reset — a value that
+    // equals the default carries no customization, so it must not pin an entry (and
+    // the "customized" badge with it) into the user layer.
+    var isDefaultValue = function (key, value) {
+      var d = DEFAULTS[key];
+      if (typeof value === "number" && typeof d === "number") return Math.round(value * 100) === Math.round(d * 100);
+      if (Array.isArray(value) || Array.isArray(d)) return JSON.stringify(value) === JSON.stringify(d);
+      return value === d;
+    };
     // Legacy keys from the renamed plugin (dsh-dagang -> dsh-contents -> dsh-quick-toc).
     var PREF_LEGACY = {
       dock: ["dsh-contents.dock.v2", "dsh-dagang.dock.v2"],
@@ -280,14 +294,19 @@ window.__ModuleLoader__.load({
         var hRaw = read(PREF_KEYS.h);
         var langRaw = read(PREF_KEYS.lang);
         var zoomRaw = read(PREF_KEYS.zoom); // NB: absent (null) means 1 — Number(null) is 0!
+        var handleRaw = read(PREF_KEYS.handle); // absent (null) means 0.5 — same trap
+        var clampRatio = function (raw, fallback) {
+          return raw !== null && isFinite(Number(raw)) ? Math.min(1, Math.max(0, Math.round(Number(raw) * 100) / 100)) : fallback;
+        };
         return {
           dock: dockRaw === "right" ? "right" : "left",
           // 0 means "the panel's own default" (see PANEL_WIDTH / auto height)
           y: yRaw !== null && isFinite(Number(yRaw)) ? Number(yRaw) : 0,
-          w: wRaw !== null && isFinite(Number(wRaw)) && Number(wRaw) >= 180 ? Number(wRaw) : 0,
-          h: hRaw !== null && isFinite(Number(hRaw)) && Number(hRaw) >= 160 ? Number(hRaw) : 0,
+          w: wRaw !== null && isFinite(Number(wRaw)) && Number(wRaw) >= 120 ? Number(wRaw) : 0,
+          h: hRaw !== null && isFinite(Number(hRaw)) && Number(hRaw) >= 60 ? Number(hRaw) : 0,
           levels: parseLevels(rawLevels) || LEVELS_ALL.slice(),
-          zoom: zoomRaw !== null && isFinite(Number(zoomRaw)) ? Math.min(2, Math.max(0.5, Math.round(Number(zoomRaw) * 100) / 100)) : 1,
+          zoom: clampRatio(zoomRaw, 1),
+          handle: clampRatio(handleRaw, 0.5),
           fuzzy: read(PREF_KEYS.fuzzy) === "1",
           // absent means "on": the hover card predates this switch
           hover: read(PREF_KEYS.hover) !== "0",
@@ -303,6 +322,7 @@ window.__ModuleLoader__.load({
           h: function (v) { return String(v); },
           levels: function (v) { return JSON.stringify(v); },
           zoom: function (v) { return String(v); },
+          handle: function (v) { return String(v); },
           fuzzy: function (v) { return v ? "1" : "0"; },
           hover: function (v) { return v ? "1" : "0"; },
           lang: function (v) { return v; },
@@ -326,11 +346,13 @@ window.__ModuleLoader__.load({
         var v = snap.value;
         var levels = parseLevelList(v.levels);
         var zoomNum = Number(v.zoom);
+        var handleNum = Number(v.handle);
         return {
           dock: v.dock === "right" ? "right" : "left",
           lang: v.lang === "zh" || v.lang === "en" ? v.lang : "auto",
           levels: levels || LEVELS_ALL.slice(),
           zoom: isFinite(zoomNum) ? Math.min(2, Math.max(0.5, Math.round(zoomNum * 100) / 100)) : 1,
+          handle: isFinite(handleNum) ? Math.min(1, Math.max(0, Math.round(handleNum * 100) / 100)) : 0.5,
           fuzzy: v.fuzzy === true,
           hover: v.hover !== false,
           debug: v.debug === true
@@ -342,7 +364,7 @@ window.__ModuleLoader__.load({
         if (!over) return local;
         return {
           dock: over.dock, y: local.y, w: local.w, h: local.h,
-          levels: over.levels, zoom: over.zoom, fuzzy: over.fuzzy, hover: over.hover,
+          levels: over.levels, zoom: over.zoom, handle: over.handle, fuzzy: over.fuzzy, hover: over.hover,
           lang: over.lang, debug: over.debug
         };
       };
@@ -370,6 +392,23 @@ window.__ModuleLoader__.load({
         var user = snap.user && typeof snap.user === "object" ? Object.assign({}, snap.user) : {}; delete user[field];
         return Object.assign({}, snap, { value: value, user: user });
       };
+      // Remove one field's entry from the host document's user layer (the mirror is
+      // the caller's business). Used by the card's per-field reset — and by `set`,
+      // for a write whose value IS the schema default.
+      var unsetHostEntry = function (field) {
+        if (!(HOST_FIELDS[field] && hostScope && hostSnap && hostSnap.writable === true)) return;
+        hostSnap = foldUnset(hostSnap, field);
+        var settle = function () {
+          if (!hostScope) return;
+          hostSnap = hostScope.getSnapshot();
+          store.version++;
+          notify();
+        };
+        try {
+          var p = hostScope.unset(field);
+          if (p && typeof p.then === "function") p.then(settle, settle);
+        } catch (e) { settle(); }
+      };
       var sendHost = function (ops) {
         if (!ops.length || !hostScope || !hostSnap || hostSnap.writable !== true) return;
         hostSnap = foldOps(hostSnap, ops);
@@ -400,6 +439,7 @@ window.__ModuleLoader__.load({
         if (local.lang !== DEFAULTS.lang) ops.push({ op: "set", path: ["lang"], value: local.lang });
         if (JSON.stringify(local.levels) !== JSON.stringify(DEFAULTS.levels)) ops.push({ op: "set", path: ["levels"], value: local.levels.slice() });
         if (local.zoom !== DEFAULTS.zoom) ops.push({ op: "set", path: ["zoom"], value: local.zoom });
+        if (local.handle !== DEFAULTS.handle) ops.push({ op: "set", path: ["handle"], value: local.handle });
         if (local.fuzzy !== DEFAULTS.fuzzy) ops.push({ op: "set", path: ["fuzzy"], value: local.fuzzy });
         if (local.hover !== DEFAULTS.hover) ops.push({ op: "set", path: ["hover"], value: local.hover });
         if (local.debug !== DEFAULTS.debug) ops.push({ op: "set", path: ["debug"], value: local.debug });
@@ -427,13 +467,20 @@ window.__ModuleLoader__.load({
             } else if (next[key] !== current[key]) changed = true;
           }
           if (!changed) return current;
+          // A host-field write whose value IS the schema default is a reset, not a
+          // customization: the entry leaves the user layer (the "customized" badge
+          // goes with it) instead of pinning the default into the document.
+          var resets = [];
           var ops = [];
           for (var k in patch) {
             if (!hasOwn(patch, k)) continue;
-            if (HOST_FIELDS[k]) ops.push({ op: "set", path: [k], value: patch[k] });
+            if (!HOST_FIELDS[k]) continue;
+            if (isDefaultValue(k, patch[k])) { resets.push(k); continue; }
+            ops.push({ op: "set", path: [k], value: patch[k] });
           }
           sendHost(ops);
           write(patch); // the localStorage mirror (and the local-only y/w/h)
+          for (var r = 0; r < resets.length; r++) unsetHostEntry(resets[r]);
           store.version++;
           notify();
           return store.get();
@@ -449,19 +496,7 @@ window.__ModuleLoader__.load({
           var mirror = {};
           mirror[field] = field === "levels" ? DEFAULTS.levels.slice() : DEFAULTS[field];
           write(mirror);
-          if (HOST_FIELDS[field] && hostScope && hostSnap && hostSnap.writable === true) {
-            hostSnap = foldUnset(hostSnap, field);
-            var settle = function () {
-              if (!hostScope) return;
-              hostSnap = hostScope.getSnapshot();
-              store.version++;
-              notify();
-            };
-            try {
-              var p = hostScope.unset(field);
-              if (p && typeof p.then === "function") p.then(settle, settle);
-            } catch (e) { settle(); }
-          }
+          unsetHostEntry(field);
           store.version++;
           notify();
           return store.get();
@@ -1395,6 +1430,7 @@ window.__ModuleLoader__.load({
       var visibleCount = _s9[0];
       var setVisibleCount = _s9[1];
       var listRef = react.useRef(null);
+      var panelRootRef = react.useRef(null); // the panel box itself (for its live height)
       var didInitScroll = react.useRef(false);
       var outlineTouchRef = react.useRef(0); // last time the user touched the outline
       var lastScrollTopRef = react.useRef(0);
@@ -1630,6 +1666,15 @@ window.__ModuleLoader__.load({
       }, [prefs]);
       // ...and publish the panel's own changes back, debounced: a drag fires on every
       // pointer move and the Settings section does not need that resolution.
+      //
+      // The record of what has been published advances only when the write actually
+      // happens. This effect re-runs on EVERY change and its cleanup cancels the
+      // pending timer, so a second adjustment inside the 400ms window replaces the
+      // first one's patch; an eagerly advanced record would leave the cancelled field
+      // looking published, the next pass would find nothing to publish, and the value
+      // just dragged would never reach storage (measured in Edge: drag the width
+      // 200 -> 150, drag the height 250ms later — the stored width stayed 200 and the
+      // next load brought the panel back 50px wider than it was left).
       react.useEffect(function () {
         var seen = sent.current;
         var nextLevels = levels.join(",");
@@ -1645,13 +1690,15 @@ window.__ModuleLoader__.load({
         // next pass — including the one the store's own notification triggers — finds
         // nothing left to publish and the debounced write cannot bounce back
         var has = function (key) { return Object.prototype.hasOwnProperty.call(patch, key); };
-        if (has("dock")) seen.dock = patch.dock;
-        if (has("y")) seen.y = patch.y;
-        if (has("w")) seen.w = patch.w;
-        if (has("h")) seen.h = patch.h;
-        if (has("levels")) seen.levels = nextLevels;
-        if (has("fuzzy")) seen.fuzzy = patch.fuzzy;
-        var timer = setTimeout(function () { prefsStore.set(patch); }, 400);
+        var timer = setTimeout(function () {
+          if (has("dock")) seen.dock = patch.dock;
+          if (has("y")) seen.y = patch.y;
+          if (has("w")) seen.w = patch.w;
+          if (has("h")) seen.h = patch.h;
+          if (has("levels")) seen.levels = nextLevels;
+          if (has("fuzzy")) seen.fuzzy = patch.fuzzy;
+          prefsStore.set(patch);
+        }, 400);
         return function () { clearTimeout(timer); };
       }, [dock, panelY, panelW, panelH, levels, fuzzy]);
 
@@ -1847,6 +1894,19 @@ window.__ModuleLoader__.load({
       // No upper bound and only a keep-it-usable floor: the reader decides how small
       // the panel gets. The drags only move the live state; the preference effect
       // persists the settled value (debounced), so there is exactly one writer.
+      // A panel whose height is still "auto" (never dragged) starts from its REAL
+      // height: the old fixed 400px guess made the panel jump on the first pointer
+      // move. getBoundingClientRect reports the visual (post-zoom) height, which is
+      // the same unit panelH is stored in.
+      var dragStartH = function () {
+        if (panelH > 0) return panelH;
+        var el = panelRootRef.current;
+        if (el && el.getBoundingClientRect) {
+          var h = el.getBoundingClientRect().height;
+          if (h > 0) return h;
+        }
+        return 400; // nothing measurable yet: a sane starting point
+      };
       var onResizeWDown = function (e) {
         e.preventDefault();
         e.stopPropagation();
@@ -1868,7 +1928,7 @@ window.__ModuleLoader__.load({
         e.stopPropagation();
         if (e.button !== 0) return;
         var startY = e.clientY;
-        var startH = panelH > 0 ? panelH : 400;
+        var startH = dragStartH();
         var move = function (ev) {
           setPanelH(Math.max(60, startH + (ev.clientY - startY)));
         };
@@ -1886,7 +1946,7 @@ window.__ModuleLoader__.load({
         var startX = e.clientX;
         var startY = e.clientY;
         var startW = panelW;
-        var startH = panelH > 0 ? panelH : 400;
+        var startH = dragStartH();
         var move = function (ev) {
           setPanelW(Math.max(120, startW + (ev.clientX - startX)));
           setPanelH(Math.max(60, startH + (ev.clientY - startY)));
@@ -2480,6 +2540,11 @@ window.__ModuleLoader__.load({
       }
       var vMaxH = viewport ? Math.max(200, viewport.height - 28) : "72vh";
       var baseTopPx = (viewport ? viewport.top + 14 : window.innerHeight * 0.12) + panelY;
+      // the collapsed handle's vertical position (a 0..1 ratio of the conversation
+      // area — 0 pins the handle to the BOTTOM, 1 to the top; 0.5 = centred, which is
+      // exactly the previous fixed position)
+      var handlePos = isFinite(Number(prefs.handle)) ? Math.min(1, Math.max(0, Number(prefs.handle))) : 0.5;
+      var handleFromTop = 1 - handlePos; // the setting counts from the bottom up
 
       // ---- panel top drag bar ----
       var onHandleDown = function (e) {
@@ -2891,6 +2956,7 @@ window.__ModuleLoader__.load({
       var panelOpacity = open && chatViewActive ? (hovered ? 1 : 0.72) : 0;
 
       var panelEl = react_jsx_runtime.jsx("div", {
+        ref: panelRootRef,
         style: {
           position: "fixed",
           top: zLen(baseTopPx),
@@ -3537,7 +3603,11 @@ window.__ModuleLoader__.load({
           justifyContent: "center",
           cursor: "pointer",
           zIndex: Z_BASE,
-          top: (viewport ? viewport.top + viewport.height / 2 - 46 : "50%"),
+          // the ratio counts from the BOTTOM (0% = bottom, 100% = top) — at 0.5 this
+          // is the same centred spot the handle always had
+          top: (viewport
+            ? viewport.top + (viewport.height - 92) * handleFromTop
+            : (window.innerHeight - 92) * handleFromTop) + "px",
           transform: handleShown ? "translateX(0)" : (dockRight ? "translateX(16px)" : "translateX(-16px)"),
           opacity: chatViewActive ? 1 : 0,
           pointerEvents: chatViewActive ? "auto" : "none",
@@ -4154,32 +4224,34 @@ window.__ModuleLoader__.load({
         return seg([["on", T("settings.on")], ["off", T("settings.off")]], on ? "on" : "off",
           function (v) { onToggle(v === "on"); });
       };
-      // Scale slider, 50%..200% in 5% notches — the same control shape as the fonttune
-      // card's slider. Dragging only moves a LOCAL value: the settings document is
-      // written once the pointer is released (a per-notch rewrite would recompute the
-      // panel mid-drag), and the local value stays on screen until the host confirms it,
-      // so the readout never bounces back to the old number for a frame.
-      var _sZoomDrag = react.useState(null);
-      var zoomDrag = _sZoomDrag[0];
-      var setZoomDrag = _sZoomDrag[1];
-      var zoomAwaiting = react.useRef(null);
-      var commitZoom = function (pct) {
-        zoomAwaiting.current = pct;
-        commit({ zoom: pct / 100 });
+      // Percentage sliders (the panel scale and the handle position) — the same
+      // control shape as the fonttune card's slider. Dragging only moves a LOCAL
+      // value: the settings document is written once the pointer is released (a
+      // per-notch rewrite would recompute the panel mid-drag), and the local value
+      // stays on screen until the host confirms it, so the readout never bounces back
+      // to the old number for a frame. One drag/confirm ledger serves both sliders.
+      var _sSliderDrag = react.useState(null); // { field, value } or null
+      var sliderDrag = _sSliderDrag[0];
+      var setSliderDrag = _sSliderDrag[1];
+      var sliderAwaiting = react.useRef({});
+      var commitSlider = function (field, pct) {
+        sliderAwaiting.current[field] = pct;
+        commit(field === "zoom" ? { zoom: pct / 100 } : { handle: pct / 100 });
       };
       react.useEffect(function () {
-        if (zoomAwaiting.current === null) { setZoomDrag(null); return; }
-        if (Math.round(prefs.zoom * 100) === zoomAwaiting.current) {
-          zoomAwaiting.current = null;
-          setZoomDrag(null);
-        }
-      }, [prefs.zoom]);
+        var a = sliderAwaiting.current;
+        var settled = false;
+        if (a.zoom !== undefined && Math.round(prefs.zoom * 100) === a.zoom) { delete a.zoom; settled = true; }
+        if (a.handle !== undefined && Math.round(prefs.handle * 100) === a.handle) { delete a.handle; settled = true; }
+        if (settled) setSliderDrag(null);
+      }, [prefs.zoom, prefs.handle]);
       react.useEffect(function () {
-        if (zoomDrag === null) return undefined;
+        if (sliderDrag === null) return undefined;
         var release = function () {
           // one release per drag: a late pointerup must not rewrite the same value
-          if (zoomAwaiting.current !== null) return;
-          commitZoom(zoomDrag);
+          var f = sliderDrag.field;
+          if (sliderAwaiting.current[f] !== undefined) return;
+          commitSlider(f, sliderDrag.value);
         };
         window.addEventListener("pointerup", release, true);
         window.addEventListener("touchend", release, true);
@@ -4187,38 +4259,42 @@ window.__ModuleLoader__.load({
           window.removeEventListener("pointerup", release, true);
           window.removeEventListener("touchend", release, true);
         };
-      }, [zoomDrag]);
-      var zoomPct = (zoomDrag === null ? Math.round(prefs.zoom * 100) : zoomDrag);
-      var zoomControl = react_jsx_runtime.jsxs("div", {
-        children: [
-          react_jsx_runtime.jsxs("div", {
-            className: "dqt-sliderRow",
-            children: [
-              react_jsx_runtime.jsx("input", {
-                type: "range",
-                className: "dqt-slider",
-                min: 50,
-                max: 200,
-                step: 5,
-                value: zoomPct,
-                disabled: !writable,
-                "aria-label": T("settings.zoom"),
-                onChange: function (e) { setZoomDrag(Number(e.target.value)); },
-                onKeyUp: function () { if (zoomDrag !== null) commitZoom(zoomDrag); },
-                onBlur: function () { if (zoomDrag !== null) commitZoom(zoomDrag); }
-              }),
-              react_jsx_runtime.jsx("span", { className: "dqt-sliderValue", children: zoomPct + "%" })
-            ]
-          }),
-          react_jsx_runtime.jsxs("div", {
-            className: "dqt-sliderScale",
-            children: [
-              react_jsx_runtime.jsx("span", { children: "50%" }),
-              react_jsx_runtime.jsx("span", { children: "200%" })
-            ]
-          })
-        ]
-      });
+      }, [sliderDrag]);
+      var sliderCtl = function (field, label, min, max, step, pct) {
+        var value = (sliderDrag && sliderDrag.field === field) ? sliderDrag.value : pct;
+        return react_jsx_runtime.jsxs("div", {
+          children: [
+            react_jsx_runtime.jsxs("div", {
+              className: "dqt-sliderRow",
+              children: [
+                react_jsx_runtime.jsx("input", {
+                  type: "range",
+                  className: "dqt-slider",
+                  min: min,
+                  max: max,
+                  step: step,
+                  value: value,
+                  disabled: !writable,
+                  "aria-label": T(label),
+                  onChange: function (e) { setSliderDrag({ field: field, value: Number(e.target.value) }); },
+                  onKeyUp: function () { if (sliderDrag && sliderDrag.field === field) commitSlider(field, sliderDrag.value); },
+                  onBlur: function () { if (sliderDrag && sliderDrag.field === field) commitSlider(field, sliderDrag.value); }
+                }),
+                react_jsx_runtime.jsx("span", { className: "dqt-sliderValue", children: value + "%" })
+              ]
+            }),
+            react_jsx_runtime.jsxs("div", {
+              className: "dqt-sliderScale",
+              children: [
+                react_jsx_runtime.jsx("span", { children: min + "%" }),
+                react_jsx_runtime.jsx("span", { children: max + "%" })
+              ]
+            })
+          ]
+        });
+      };
+      var zoomControl = sliderCtl("zoom", "settings.zoom", 50, 200, 5, Math.round(prefs.zoom * 100));
+      var handleControl = sliderCtl("handle", "settings.handle", 0, 100, 1, Math.round(prefs.handle * 100));
       var field = function (key, label, hint, control, inline, last) {
         var overridden = Object.prototype.hasOwnProperty.call(user, key);
         var reset = overridden ? react_jsx_runtime.jsx("button", {
@@ -4279,6 +4355,7 @@ window.__ModuleLoader__.load({
             function (v) { commit({ dock: v }); }), true),
         field("levels", T("settings.levels"), "", levelsControl(true), true),
         field("zoom", T("settings.zoom"), T("settings.zoom.tip"), zoomControl, false),
+        field("handle", T("settings.handle"), T("settings.handle.tip"), handleControl, false),
         field("fuzzy", T("settings.fuzzy"), "", onoff(prefs.fuzzy, function (v) { commit({ fuzzy: v }); }), true),
         field("hover", T("settings.hover"), "", onoff(prefs.hover, function (v) { commit({ hover: v }); }), true),
         field("debug", T("settings.debug"), T("settings.debug.tip"), onoff(prefs.debug, function (v) { commit({ debug: v }); }), true, true)
@@ -4296,7 +4373,24 @@ window.__ModuleLoader__.load({
                 react_jsx_runtime.jsx("span", { className: "dqt-pname", children: T("panel.title") }),
                 react_jsx_runtime.jsx("span", { className: "dqt-pdesc", children: T("settings.desc") })
               ] }),
-              react_jsx_runtime.jsx("span", { className: "dqt-pchev" + (open ? " dqt-pchevOpen" : ""), "aria-hidden": "true", children: "⌄" })
+              // The host's own chevron (IconChevronDownOutline14): a filled 14x14 glyph.
+              // A text arrowhead ("⌄") sat in a 20px line box, so its ink hung off the
+              // box centre — rotating it swung the glyph sideways instead of turning it
+              // in place — and at text weight it never matched the host's other icons.
+              // The class goes on the <svg> itself, exactly as the host's PluginCard does,
+              // so `transform:rotate(180deg)` turns around the icon's own centre.
+              react_jsx_runtime.jsx("svg", {
+                className: "dqt-pchev" + (open ? " dqt-pchevOpen" : ""),
+                width: 14,
+                height: 14,
+                viewBox: "0 0 14 14",
+                fill: "none",
+                "aria-hidden": "true",
+                children: react_jsx_runtime.jsx("path", {
+                  d: "M11.8486 5.5L11.4238 5.92383L8.69727 8.65137C8.44157 8.90706 8.21562 9.13382 8.01172 9.29785C7.79912 9.46883 7.55595 9.61756 7.25 9.66602C7.08435 9.69222 6.91565 9.69222 6.75 9.66602C6.44405 9.61756 6.20088 9.46883 5.98828 9.29785C5.78438 9.13382 5.55843 8.90706 5.30273 8.65137L2.57617 5.92383L2.15137 5.5L3 4.65137L3.42383 5.07617L6.15137 7.80273C6.42595 8.07732 6.59876 8.24849 6.74023 8.3623C6.87291 8.46904 6.92272 8.47813 6.9375 8.48047C6.97895 8.48703 7.02105 8.48703 7.0625 8.48047C7.07728 8.47813 7.12709 8.46904 7.25977 8.3623C7.40124 8.24849 7.57405 8.07732 7.84863 7.80273L10.5762 5.07617L11 4.65137L11.8486 5.5Z",
+                  fill: "currentColor"
+                })
+              })
             ]
           }),
           open ? react_jsx_runtime.jsx("div", {

package/lib/index.js

@@ -41,6 +41,12 @@ export const Config = z.object({
     .max(2)
     .default(1)
     .description("Scale factor for the panel's content (text, icons, buttons) from 50% to 200%; the panel's own size is unchanged"),
+  handle: z
+    .number()
+    .min(0)
+    .max(1)
+    .default(0.5)
+    .description("Vertical position of the collapsed-panel handle: 0 = bottom, 1 = top of the conversation area"),
   fuzzy: z
     .boolean()
     .default(false)

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.6.1",
-  "description": "Conversation TOC for DeepSeek Harness (DSH): turn-grouped Markdown outline covering the whole session (unloaded turns included), title/full-text search with an optional fuzzy switch, hover previews, in-chat match highlighting, heading-level filter, reading-position auto-follow, a 50%-200% panel-scale slider, a Chinese/English interface and a plugin-configuration card",
+  "version": "0.6.3",
+  "description": "Conversation TOC for DeepSeek Harness (DSH): a turn-grouped Markdown outline of the whole session, title/full-text search, hover previews, in-chat highlighting, a level filter, reading-position follow, a Chinese/English interface and a settings card.",
   "type": "module",
   "main": "lib/index.js",
   "files": [