dsh-stall-guard 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -5,6 +5,28 @@
 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.1.3] - 2026-10-21
+
+### 修复
+
+- **拖动图标会带动上方状态栏**：浮动态原先仍渲染在标题栏槽位里，那个槽位是正常文档流
+  中的 flex 项，`position:fixed` 在那里无效，图标移动时会把整行撑动。
+  现在浮动态改由 `shell.overlay` 渲染（真正脱离所有列与滚动容器），标题栏在浮动时
+  渲染空。这样图标可以像贴纸一样拖到任意位置，不影响任何其他元素。
+- **调整大小时看不到实时预览**：设置面板原先从 `top:56px` 开始展开，正好压住标题栏
+  上的图标，所以拖滑块时看不到尺寸变化。面板改为从标题栏下方开始（`top:118px`）。
+- 浮动态的层级提到面板之上（`z-index:75`），即使图标被拖到面板范围内也仍然可见可拖。
+- 拖动位置改从 store 读取而不是每帧读 localStorage，避免高频拖动时状态竞争、
+  丢中间位置。
+
+## [0.1.2] - 2026-10-21
+
+### 修复
+
+- **点气泡会打开面板**：0.1.1 里气泡的点击改成了「关闭提示」（`acknowledge`），
+  但这个改动晚于 0.1.1 的发布，所以 npm 上那版仍是旧的。本版包含该修复。
+  现在点气泡 = 关掉通知，点鱼图标 = 打开设置。
+
 ## [0.1.1] - 2026-10-21
 
 ### 新增

package/client.js

@@ -208,7 +208,8 @@ window.__ModuleLoader__.load({
       showSupervisor: 'Show the supervisor',
       showSupervisorHint: 'Off hides the figure but keeps the guard running; a small tab stays in the corner so you can switch it back.',
       showBubble: 'Show the text bubble on a stall',
-      showBubbleHint: 'Off keeps the bouncing animation but hides the sentence. Click the figure or the bubble to open settings.',
+      showBubbleHint: 'Off keeps the bouncing animation but hides the sentence. Click the bubble to dismiss it; click the figure for settings.',
+      dismissBubble: 'Dismiss this notice',
       supervisorHiddenHint: 'Supervisor hidden — click to open settings',
       appearanceLabel: 'Icon appearance (this browser only)',
       iconSize: 'Size',
@@ -299,7 +300,8 @@ window.__ModuleLoader__.load({
       showSupervisor: '\u663e\u793a\u76d1\u7763\u5458',
       showSupervisorHint: '\u5173\u6389\u540e\u4e0d\u518d\u663e\u793a\u5f62\u8c61\uff0c\u4f46\u5b88\u536b\u4ecd\u5728\u8fd0\u884c\uff1b\u53f3\u4e0b\u89d2\u4f1a\u7559\u4e00\u4e2a\u5c0f\u70b9\uff0c\u70b9\u5b83\u53ef\u4ee5\u518d\u6253\u5f00\u3002',
       showBubble: '\u5361\u987f\u65f6\u663e\u793a\u6587\u5b57\u6c14\u6ce1',
-      showBubbleHint: '\u5173\u6389\u4ecd\u4f1a\u8df3\u52a8\uff0c\u4f46\u4e0d\u663e\u793a\u6587\u5b57\u3002\u70b9\u56fe\u6807\u6216\u6c14\u6ce1\u90fd\u80fd\u6253\u5f00\u8bbe\u7f6e\u3002',
+      showBubbleHint: '\u5173\u6389\u4ecd\u4f1a\u8df3\u52a8\uff0c\u4f46\u4e0d\u663e\u793a\u6587\u5b57\u3002\u70b9\u6c14\u6ce1\u53ef\u4ee5\u5173\u6389\u5b83\uff1b\u70b9\u56fe\u6807\u6253\u5f00\u8bbe\u7f6e\u3002',
+      dismissBubble: '\u5173\u6389\u8fd9\u6761\u63d0\u793a',
       supervisorHiddenHint: '\u76d1\u7763\u5458\u5df2\u9690\u85cf \u2014 \u70b9\u51fb\u6253\u5f00\u8bbe\u7f6e',
       appearanceLabel: '\u56fe\u6807\u5916\u89c2\uff08\u4ec5\u672c\u6d4f\u89c8\u5668\uff09',
       iconSize: '\u5927\u5c0f',
@@ -953,7 +955,7 @@ window.__ModuleLoader__.load({
       /* Hidden state: the bubble is not rendered at all, so there is nothing to dim. */
 
       /* ---- overlay panel ---- */
-      '.dsg-panel{position:fixed;top:56px;right:14px;left:auto;z-index:70;box-sizing:border-box;width:min(430px,calc(100vw - 40px));max-height:min(74vh,660px);overflow:hidden;pointer-events:auto;display:flex;flex-direction:column;gap:0;padding:12px;border:1px solid var(--dsw-alias-border-l1,var(--dsh-border,rgba(255,255,255,.12)));border-radius:var(--dsw-radius-panel,12px);background:var(--dsw-alias-bg-overlay,var(--dsh-surface,rgba(20,22,28,.96)));box-shadow:var(--dsw-elevation-soft,0 8px 28px rgba(0,0,0,.22));color:var(--dsw-alias-label-primary,var(--dsh-text-primary,#e6e6e6));font:inherit;font-size:12px;line-height:18px}',
+      '.dsg-panel{position:fixed;top:118px;right:14px;left:auto;z-index:70;box-sizing:border-box;width:min(430px,calc(100vw - 40px));max-height:min(74vh,660px);overflow:hidden;pointer-events:auto;display:flex;flex-direction:column;gap:0;padding:12px;border:1px solid var(--dsw-alias-border-l1,var(--dsh-border,rgba(255,255,255,.12)));border-radius:var(--dsw-radius-panel,12px);background:var(--dsw-alias-bg-overlay,var(--dsh-surface,rgba(20,22,28,.96)));box-shadow:var(--dsw-elevation-soft,0 8px 28px rgba(0,0,0,.22));color:var(--dsw-alias-label-primary,var(--dsh-text-primary,#e6e6e6));font:inherit;font-size:12px;line-height:18px}',
       '.dsg-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap;flex:0 0 auto;padding-bottom:8px}',
       /* The title bar holds Save and Close now, so the title must not push them out. */
       '.dsg-title{flex:0 1 auto;min-width:0;margin:0;font-size:13px;font-weight:600;white-space:nowrap;overflow:hidden;text-overflow:ellipsis}',
@@ -1038,7 +1040,7 @@ window.__ModuleLoader__.load({
       '.dsg-offTab{display:block;width:100%;height:100%;border-radius:50%}',
       '.dsg-orb[data-floating="yes"]{box-shadow:0 2px 10px rgba(0,0,0,.28);background:var(--dsw-alias-bg-overlay,var(--dsh-surface,rgba(20,22,28,.9)));border:1px solid var(--dsw-alias-border-l1,var(--dsh-border,rgba(255,255,255,.12)))}',
       '.dsg-orb[data-dragging="yes"]{transition:none!important;cursor:grabbing}',
-      '.dsg-seat[data-floating="yes"]{position:fixed}',
+      '.dsg-seat[data-floating="yes"]{position:fixed;z-index:75}',
       /* Only visible while the supervisor is hidden: a 14px grab handle in the corner. */
       '.dsg-restoreTab{position:fixed;right:10px;bottom:10px;z-index:67;width:14px;height:14px;padding:0;border:1px solid var(--dsw-alias-border-l1,var(--dsh-border,rgba(255,255,255,.2)));border-radius:50%;background:var(--dsw-alias-label-tertiary,var(--dsh-text-muted,#8b93a7));opacity:.4;cursor:pointer;transition:opacity .15s ease,transform .15s ease}',
       '.dsg-restoreTab:hover,.dsg-restoreTab:focus-visible{opacity:1;transform:scale(1.35);background:var(--dsw-alias-brand-primary,var(--dsh-accent,#4d6bfe))}',
@@ -1236,7 +1238,8 @@ window.__ModuleLoader__.load({
 
       /* Float placement: drag moves the control, and the position is clamped into the
        * viewport on release so a window resize cannot strand it off-screen. */
-      const floating = appearance.place === 'float';
+      // The overlay seat forces the floating posture; the header seat reads the setting.
+      const floating = props.forcePlace === 'float' || appearance.place === 'float';
       const startDrag = useCallback((event) => {
         if (!floating) return;
         if (event.button !== undefined && event.button !== 0) return;
@@ -1252,7 +1255,9 @@ window.__ModuleLoader__.load({
           setDragging(true);
           const nextX = Math.max(0, Math.min(window.innerWidth - rect.width, moveEvent.clientX - offsetX));
           const nextY = Math.max(0, Math.min(window.innerHeight - rect.height, moveEvent.clientY - offsetY));
-          store.setAppearance({ ...readAppearance(), x: Math.round(nextX), y: Math.round(nextY) });
+          // Read from the store, not localStorage: a per-frame disk read would race with
+          // the in-memory value and drop intermediate positions.
+          store.setAppearance({ ...store.getAppearance(), x: Math.round(nextX), y: Math.round(nextY) });
         };
         const onUp = () => {
           window.removeEventListener('pointermove', onMove);
@@ -1265,10 +1270,10 @@ window.__ModuleLoader__.load({
         event.preventDefault();
       }, [floating]);
 
-      // Hidden: the header renders nothing. A restore tab is drawn by the overlay seat
-      // instead, because the header does not exist in a blank session and the user would
-      // otherwise have no way back in.
-      if (supervisorOff) return null;
+      // Hidden, or drawn by the overlay because it floats: the header renders nothing in
+      // both cases. A floating figure inside the header's flow would push the header row
+      // around as it moved, which is exactly the bug this split fixes.
+      if (supervisorOff || floating) return null;
 
       const label = t('supervisor') + ' — ' + t(MODE_KEY[mode]);
       const size = appearance.size;
@@ -1318,16 +1323,20 @@ window.__ModuleLoader__.load({
             'data-place': bubbleBelow ? 'below' : 'above',
             role: 'button',
             tabIndex: 0,
-            title: t('openPanel'),
+            title: t('dismissBubble'),
+            'aria-label': t('dismissBubble'),
+            /* Pressing the notice dismisses it; it does not navigate. Opening the settings
+             * panel stays on the figure, so the two affordances cannot be confused. */
             onClick: (event) => {
               event.stopPropagation();
-              store.activate();
+              event.preventDefault();
+              void store.acknowledge();
             },
             onKeyDown: (event) => {
               if (event.key === 'Enter' || event.key === ' ') {
                 event.preventDefault();
                 event.stopPropagation();
-                store.activate();
+                void store.acknowledge();
               }
             },
           }, message)
@@ -1335,6 +1344,22 @@ window.__ModuleLoader__.load({
       );
     }
 
+    /**
+     * The floating posture, rendered in the frame-wide overlay.
+     *
+     * `shell.overlay` is outside every column and scroll container, so an absolutely
+     * positioned figure there cannot affect the header's layout. The component is shared
+     * with the header seat; only the posture differs.
+     */
+    function FloatingSeat(props) {
+      const t = useTranslate(props);
+      const snapshot = useStore();
+      useEffect(() => store.start(), []);
+      if (snapshot.config === null) return null;
+      if (snapshot.config.supervisor.show === false) return null;
+      return h(SupervisorSeat, { t, forcePlace: 'float' });
+    }
+
     /* ------------------------------------------------------------ the panel */
 
     function StatValue(props) {
@@ -1973,6 +1998,15 @@ window.__ModuleLoader__.load({
           inject: () => ({}),
         }, PanelSeat));
 
+        // The floating posture lives in the overlay so it cannot disturb the header row.
+        ctx.slots.inject('shell.overlay', () => ctx.slots.register({
+          name: 'shell.overlay',
+          id: 'stall-guard-floating',
+          order: 69,
+          locale: NS,
+          inject: () => ({}),
+        }, FloatingSeat));
+
         // The way back when the supervisor is hidden.
         ctx.slots.inject('shell.overlay', () => ctx.slots.register({
           name: 'shell.overlay',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-stall-guard",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "DSH 卡顿守卫：下载类命令（git clone / pnpm install / pip / curl）超时后自动中止，并把「换个下载源重试」的提示写进工具结果给智能体看，解决 GitHub 在国内网络不稳导致智能体一直干等的问题。另可按工具类型自定义超时秒数，并附一个只在卡顿时唤醒的 DeepSeek 监督员。",
   "keywords": [
     "dsh",