dsh-quick-toc 0.10.0 → 0.10.1

package/CHANGELOG.en.md

@@ -2,6 +2,17 @@
 
 All notable changes to **dsh-quick-toc** are documented here. Chinese version: [CHANGELOG.md](CHANGELOG.md).
 
+## [0.10.1] - 2026-10-21
+
+### Fixed
+- **Collapsing and expanding used to land on different spots**: the place the panel came to rest and the place it reappeared from differed slightly; both now sit on the same line.
+- **A narrow window left a strip of the panel behind**: on a narrow window the collapsed panel kept a visible edge; it now clears away completely.
+- **The collapsed handle did not line up with the panel's edge**: the handle sat a little to one side of the panel edge; the two now share a line.
+- **On the right dock the outer shadow arrived before the content**: while expanding, the halo around the panel showed before the content underneath it; both are now clipped together, and the halo settles once the slide is done.
+
+### Changed
+- **A panel wider than the space available now narrows instead**: when the window cannot hold the width that was chosen, the panel narrows sideways and stays against the conversation area's edge rather than being pushed away from it; a wider window brings the chosen width back.
+
 ## [0.10.0] - 2026-10-19
 
 ### Added

package/CHANGELOG.md

@@ -2,6 +2,17 @@
 
 **dsh-quick-toc** 的重要变更都记录在这里。英文版见 [CHANGELOG.en.md](CHANGELOG.en.md)。
 
+## [0.10.1] - 2026-10-21
+
+### 修复
+- **收起与展开的落点不一致**：收起后停下的位置与再次展开时出现的位置略有偏差，现在两者落在同一条线上。
+- **窄窗口下收起后残留一条面板**：窗口较窄时，面板收起后仍会留下一条边，现在完全收起。
+- **收起后的把手与面板边缘未对齐**：收起时把手比面板边缘偏一点，现在两者对齐。
+- **右停靠展开时外框先于内容出现**：展开过程中，面板外圈的阴影会先于内容出现；现在阴影与内容一起裁切，展开完成后再自然铺开。
+
+### 变更
+- **面板宽度超出可用空间时改为收窄**：窗口放不下设定的宽度时，面板会横向收窄并继续贴着对话区边缘，不再被推离边缘；窗口变宽后恢复设定的宽度。
+
 ## [0.10.0] - 2026-10-19
 
 ### 新增

package/README.en.md

@@ -2,7 +2,7 @@
 
 > **English** | [中文](README.md)
 
-A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH): it turns the Markdown headings (H1–H6) of AI replies into a navigable outline — the same list as a side panel or as a full-width curtain — grouped by conversation turn and covering the whole session (including turns that are not loaded yet), with title/prompts/full-text/cross-session search, hover previews, several ways to jump (a heading, a turn header, the end of a section), and a reading position that both follows and is remembered.
+A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) (DSH): it turns the Markdown headings (H1–H6) of AI replies into a navigable outline — the same list as a side panel or as a full-width curtain — grouped by conversation turn and covering the whole session (including turns that are not loaded yet), with title/prompts/full-text/cross-session search, hover previews, a right-click menu for jumping and copying, bookmarks with a bookmarks-only view, six theme colours and a translucent material, and a reading position that both follows and is remembered.
 
 ## Features
 
@@ -44,7 +44,7 @@ A conversation TOC plugin for [DeepSeek Harness](https://github.com/deepseek-ai/
 
 | Plugin | Supported DSH |
 | --- | --- |
-| **0.10.x** (latest, 0.10.0) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, 0.2.0-rc.2, 0.2.1-alpha.1, 0.2.1-alpha.2, 0.2.1-alpha.3, 0.2.1-alpha.4, 0.2.1-alpha.5, 0.2.1-rc.1, 0.2.1-rc.2 |
+| **0.10.x** (latest, 0.10.1) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, 0.2.0-rc.2, 0.2.1-alpha.1, 0.2.1-alpha.2, 0.2.1-alpha.3, 0.2.1-alpha.4, 0.2.1-alpha.5, 0.2.1-rc.1, 0.2.1-rc.2 |
 | **0.9.x** (0.9.5) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, 0.2.0-rc.2, 0.2.1-alpha.1, 0.2.1-alpha.2, 0.2.1-alpha.3, 0.2.1-alpha.4, 0.2.1-alpha.5 |
 | 0.8.x (0.8.2) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, 0.2.0-rc.2 |
 | 0.7.x (0.7.14) | 0.1.5-rc.3, 0.1.7-alpha.1, 0.1.7-alpha.2, 0.1.7-rc.1, 0.1.7-rc.2, 0.2.0-rc.1, 0.2.0-rc.2 |

package/README.md

@@ -2,7 +2,7 @@
 
 > [English](README.en.md) | **中文**
 
-**DeepSeek Harness（DSH）对话大纲插件**：把 AI 回复中的 Markdown 标题（H1–H6）提取成可导航的大纲——侧边面板与全屏幕布两种大纲视图，按对话回合分组、覆盖整段会话（含尚未加载进窗口的回合），支持标题/提问/全文/跨会话四档检索、悬停预览、多种跳转（点标题、点组头、跳到本节末尾），阅读位置自动跟随并可记住。
+**DeepSeek Harness（DSH）对话大纲插件**：把 AI 回复中的 Markdown 标题（H1–H6）提取成可导航的大纲——侧边面板与全屏幕布两种视图，按对话回合分组、覆盖整段会话（含尚未加载进窗口的回合）。支持标题/提问/全文/跨会话四档检索、悬停预览、右键跳转与复制、书签与「只看书签」视图，六种主题色与半透明材质，阅读位置自动跟随并可记住。
 
 ## 功能
 
@@ -44,7 +44,7 @@
 
 | 插件版本 | 支持的 DSH 版本 |
 | --- | --- |
-| **0.10.x**（最新，0.10.0） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5、0.2.1-rc.1、0.2.1-rc.2 |
+| **0.10.x**（最新，0.10.1） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5、0.2.1-rc.1、0.2.1-rc.2 |
 | **0.9.x**（0.9.5） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2、0.2.1-alpha.1、0.2.1-alpha.2、0.2.1-alpha.3、0.2.1-alpha.4、0.2.1-alpha.5 |
 | 0.8.x（0.8.2） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 |
 | 0.7.x（0.7.14） | 0.1.5-rc.3、0.1.7-alpha.1、0.1.7-alpha.2、0.1.7-rc.1、0.1.7-rc.2、0.2.0-rc.1、0.2.0-rc.2 |

package/lib/client.js

@@ -3160,6 +3160,21 @@ window.__ModuleLoader__.load({
       var _sAside = react.useState(null);
       var panelAside = _sAside[0];
       var setPanelAside = _sAside[1];
+      // The outer halo may only relax to its full bleed once a slide has LANDED. Riding
+      // the same transition let the shadow reach past the panel's own (still clipped)
+      // edge during an expansion, which reads as a frame appearing before the surface.
+      // Declared up here with the other hooks so an early "nothing to show" return never
+      // changes the hook count.
+      var lastLineRef = react.useRef(null);
+      var _sShadowSettled = react.useState(true);
+      var shadowSettled = _sShadowSettled[0];
+      var setShadowSettled = _sShadowSettled[1];
+      var geoOpenNow = open && !panelAside;
+      react.useEffect(function () {
+        if (!geoOpenNow) { setShadowSettled(false); return undefined; }
+        var t = setTimeout(function () { setShadowSettled(true); }, 640);
+        return function () { clearTimeout(t); };
+      }, [geoOpenNow]);
       // The curtain hangs from just BELOW the centre column's view tabs (对话 / 轨迹 /
       // 上下文), not from the top of the scroll container: when those tabs live inside
       // that container, viewport.top sits above them and the curtain would cover them.
@@ -5421,18 +5436,33 @@ window.__ModuleLoader__.load({
       // (The collapsed panel is parked deliberately outside the area and is hidden
       // by its own clip, so only the open position is clamped.)
       var clampLeft = function (x) {
-        return Math.max(8, Math.min(Math.max(8, window.innerWidth - panelW - 8), x));
+        // clamp against the width the panel will actually be drawn at (geoW, below):
+        // the stored preference can exceed the window, and clamping to THAT put the
+        // open edge in the wrong place
+        return Math.max(8, Math.min(Math.max(8, window.innerWidth - geoW - 8), x));
       };
       // While the panel is being handed over to (or back from) the curtain it is
       // rendered at its COLLAPSED geometry, so the same transform/clip transition that
       // serves open/collapse also serves the handoff: no teleport, no flash.
       var geoOpen = open && !panelAside;
-      var anchorLeft = viewport ? viewport.left - panelW - 8 : -(panelW + 48);
+      // The panel is docked AT the area's edge. When the stored width cannot fit beside
+      // it, the WIDTH gives way for this render — never the position. Moving the open
+      // panel inwards (the old fallback, via clampLeft) both covered the sidebar and
+      // shortened the collapse below the panel's own width, so the tuck line stopped
+      // agreeing with the line the panel came back out of: the panel appeared to close
+      // to one place and reopen from another. The stored preference is untouched, so a
+      // wider window brings the chosen width back.
+      var geoW = Math.max(120, Math.min(panelW,
+        dockRight
+          ? (window.innerWidth - (viewport ? viewport.right + 48 : 60)) - 8
+          : window.innerWidth - (viewport ? viewport.left : 0) - 16));
+      // Parked against the area, one panel width further out.
+      var anchorLeft = viewport ? viewport.left - geoW - 8 : -(geoW + 48);
       var openLeft;
       if (dockRight) {
         // RIGHT dock: keep the panel's VISIBLE right edge pinned at the SAME
         // line when collapsed as when expanded (the expand edge is correct).
-        var openRight = window.innerWidth - (viewport ? viewport.right + 48 : 60) - panelW;
+        var openRight = window.innerWidth - (viewport ? viewport.right + 48 : 60) - geoW;
         openLeft = clampLeft(openRight);
       } else {
         // LEFT dock open (left dock is the confirmed-correct reference — untouched)
@@ -5455,15 +5485,35 @@ window.__ModuleLoader__.load({
         geoOpenRef.current = geoOpen;
         geoHoldRef.current = geoOpen ? 0 : Date.now() + COLLAPSE_HOLD_MS;
         geoSnapRef.current = geoOpen ? null : { anchorLeft: anchorLeft, openLeft: openLeft, dock: dock };
+        // remember the line it is going into, so the next expansion can come back out
+        // of exactly that line (see below)
+        if (!geoOpen) lastLineRef.current = { openLeft: openLeft, dock: dock, w: window.innerWidth, h: window.innerHeight };
       }
       var geoFrozen = geoSnapRef.current !== null && geoSnapRef.current.dock === dock
         && Date.now() < geoHoldRef.current;
       if (geoFrozen) {
         anchorLeft = geoSnapRef.current.anchorLeft;
         openLeft = geoSnapRef.current.openLeft;
+      } else {
+        // The host re-measures its area between the two legs (a slow beat), and a few
+        // pixels of drift there is what made the panel reopen slightly to the RIGHT of
+        // the place it had tucked into. While the drift is small the line it went into
+        // wins — over BOTH legs, so the tuck line and the open line are the same
+        // number. A larger difference means the reader really moved something (the
+        // sidebar, the window), and the fresh measurement wins instead.
+        var lastLine = lastLineRef.current;
+        if (lastLine && lastLine.dock === dock
+            && lastLine.w === window.innerWidth && lastLine.h === window.innerHeight
+            && Math.abs(lastLine.openLeft - openLeft) <= 24
+            && lastLine.openLeft !== openLeft) {
+          openLeft = lastLine.openLeft;
+          // travel becomes geoW + 16 again, so `anchorLeft + clip` (the tuck line)
+          // evaluates to this same line
+          anchorLeft = openLeft - geoW - 16;
+        }
       }
       var openOffset = openLeft - anchorLeft;
-      var parkedOffset = dockRight ? (openLeft + panelW) - anchorLeft : 0;
+      var parkedOffset = dockRight ? (openLeft + geoW) - anchorLeft : 0;
       var panelLeft = anchorLeft;
       var panelOffset = geoOpen ? openOffset : parkedOffset;
       var panelTransform = panelOffset === 0 ? "none" : "translateX(" + zLen(panelOffset) + ")";
@@ -6272,12 +6322,26 @@ window.__ModuleLoader__.load({
       // the wipe edge drift 24px through the slide); the shadow lives on the panel's
       // twin element instead.
       var panelClip = "inset(0 0 0 0px)";
+      // ONE line, and that is a geometric necessity rather than a taste: the visible
+      // edge of a clipped box can never be left of the box's own left edge, so the
+      // only way the tuck line and the open line can both sit somewhere is for the
+      // wipe to equal the travel. Any other value makes the edge sweep between two
+      // lines through the animation (pull it 8px back and the panel visibly slides
+      // 8px further left as it vanishes, then reappears from the open line instead).
+      //
+      // It can never be SHORTER than the box it hides either: `clampLeft` pulls the
+      // open position inwards when the window is narrow relative to the panel, which
+      // shortened the travel below the panel width and left a strip of the parked
+      // panel standing on the workspace (measured at 284px on a 13" screen). (The
+      // right dock needs no guard — its travel is one panel width by construction.)
+      // The halo twin reads the same number, so the two are clipped by one wipe.
+      var clipWipe = Math.max(travelPx, geoW + 2);
       if (!geoOpen) {
         if (dockRight) {
           // mirror of LEFT: clip the RIGHT side (panel flies right, shrinking from its right)
           panelClip = "inset(0 " + zLen(travelPx) + " 0 0)";
         } else {
-          panelClip = "inset(0 0 0 " + zLen(travelPx) + ")";
+          panelClip = "inset(0 0 0 " + zLen(clipWipe) + ")";
         }
       }
       // faded out entirely while another center-column view is active
@@ -7208,7 +7272,7 @@ window.__ModuleLoader__.load({
         position: "fixed",
         top: zLen(baseTopPx),
         left: zLen(panelLeft),
-        width: zLen(panelW),
+        width: zLen(geoW),
         maxHeight: zLen(vMaxH),
         height: panelH > 0 ? zLen(panelH) : undefined,
         zoom: zoom === 1 ? undefined : zoom,
@@ -7234,20 +7298,35 @@ window.__ModuleLoader__.load({
       // One halo on ALL four sides — evenly, corners included (a card lifted off
       // the conversation; no downward bias, or the top corners stay bare). Dark
       // scheme gets a WHITE one — the theme's own raised language.
-      // the wipe side's cut sits exactly on the seam the panel tucks behind: past
-      // that line there is nothing to see — panel or halo — the clip decides,
-      // never a fade
+      //
+      // SHADOW_REACH: how far the edge OPPOSITE the wipe is pulled in while the panel
+      // is parked, so the twin's halo cannot spill past the tuck line once the panel
+      // body has been clipped away.
+      // SHADOW_BLEED: how far all four sides bleed while the panel is at rest — the
+      // deepest reach of the halo (15px below with the offset, more at the corners).
       var SHADOW_REACH = 8;
       var SHADOW_BLEED = 24;
-      var shadowWipe = geoOpen ? 0 : travelPx;
+      // The WIPE side is the one the panel slides through. It is clipped by exactly the
+      // same wipe as the panel while anything is moving — zero reach, so the halo is
+      // never drawn where the panel itself is still hidden (any reach there reads as an
+      // outer frame arriving before the surface). The halo the reader wants lives on the
+      // OTHER three sides during the slide, and on this side only once the slide has
+      // LANDED, when it relaxes to the full bleed.
+      //
+      // The relaxation waits for `shadowSettled` (set by the timer in the hook block
+      // above) instead of riding the same transition: transitioning it together was
+      // what let the halo lead the panel's clipped edge.
+      var shadowDockSide = (geoOpen && shadowSettled)
+        ? -SHADOW_BLEED
+        : (geoOpen ? 0 : (dockRight ? travelPx : clipWipe));
       // Keep the four-sided halo while open. During a tuck, move the wipe edge
       // with the panel AND bring the opposite horizontal clip edge inward to meet
       // it at the parked position. Leaving that edge at -24px let the shadow twin
       // paint a visible strip after the panel body had been clipped away (wider on
       // the right dock, a thin sliver on the left dock).
       var shadowClip = dockRight
-        ? "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(shadowWipe - SHADOW_REACH) + " " + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : SHADOW_REACH) + ")"
-        : "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : -SHADOW_REACH) + " " + zLen(-SHADOW_BLEED) + " " + zLen(shadowWipe - SHADOW_REACH) + ")";
+        ? "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(shadowDockSide) + " " + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : SHADOW_REACH) + ")"
+        : "inset(" + zLen(-SHADOW_BLEED) + " " + zLen(geoOpen ? -SHADOW_BLEED : -SHADOW_REACH) + " " + zLen(-SHADOW_BLEED) + " " + zLen(shadowDockSide) + ")";
       // The panel's blur lives OUTSIDE the clipping wrapper (see the portal list):
       // inside it, any backdrop-filter promotes a layer in that subtree and the
       // panel drops beneath the conversation. As a body-level twin with the same
@@ -7313,6 +7392,10 @@ window.__ModuleLoader__.load({
       });
       var panelEl = react_jsx_runtime.jsx("div", {
         ref: panelRootRef,
+        // a marker for the reader's own console checks (and for support): the panel
+        // root used to have no attribute at all, so a lookup by class silently
+        // returned null and read as "the panel is gone"
+        "data-dqt-panel": "1",
         // the panel takes focus on any click inside it (except into a text field), so
         // ↑/↓/Enter/Esc keep working right after a mouse interaction instead of only
         // when the user tabs into the widget first
@@ -7614,8 +7697,17 @@ window.__ModuleLoader__.load({
       // below the threshold it slides back into the divider (its usual motion), while the
       // droplet above the conversation stays put as the way in
       var edgeShown = !open && handleShown && chatViewActive && !narrowWindow;
-      var edgeLineLeft = viewport ? viewport.left : 0;
-      var edgeLineRight = viewport ? viewport.right + 52 : 60;   // clear of the milestone rail
+      // The pill is 12px centred in the 26px box, so its edge sits 7px inside the box
+      // edge. Left dock: the panel opens at `area + 8`, so parking the box 1px out puts
+      // the pill's left edge exactly on the panel's own left edge — one line.
+      //
+      // Right dock: deliberately NOT aligned. The panel is held 48px clear of the
+      // area's right edge (the milestone rail lives there), so the pill — which hangs
+      // on that edge — is 11px inside the panel's right edge by construction. Pulling
+      // it out to meet the panel would push the pill into the rail, which is worse
+      // than two lines nobody sees at the same time.
+      var edgeLineLeft = (viewport ? viewport.left : 0) + 1;
+      var edgeLineRight = (viewport ? viewport.right + 52 : 60);   // clear of the milestone rail
       var edgeEl = (!open || !edgeGone) ? react_jsx_runtime.jsx("div", {
         style: {
           position: "fixed",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-quick-toc",
-  "version": "0.10.0",
+  "version": "0.10.1",
   "description": "Conversation TOC for DeepSeek Harness (DSH): a whole-session, turn-grouped Markdown outline with hover previews, heading-level preferences, a full-width curtain, jump-to-end buttons, title/prompts/full-text/cross-session search and a Chinese/English interface.",
   "icon": "./icon.svg",
   "type": "module",