dsh-stall-guard 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -5,6 +5,31 @@
 格式参考 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，
 版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.1.2] - 2026-10-21
+
+### 修复
+
+- **点气泡会打开面板**：0.1.1 里气泡的点击改成了「关闭提示」（`acknowledge`），
+  但这个改动晚于 0.1.1 的发布，所以 npm 上那版仍是旧的。本版包含该修复。
+  现在点气泡 = 关掉通知，点鱼图标 = 打开设置。
+
+## [0.1.1] - 2026-10-21
+
+### 新增
+
+- **气泡文字可关闭**：`supervisor.bubble`。关掉后图标仍会跳动提示有异常，但不显示文字。
+  旧配置文件没有这个键，默认显示气泡。
+
+### 修复
+
+- **点气泡打不开面板**：气泡原先在 `<button>` 内部且 `pointer-events:none`，
+  点击会穿透到背后的标题栏（表现为点出「下载 Session 日志」菜单）。
+  现在气泡是按钮的兄弟元素，有自己的点击与键盘激活。
+- **气泡被挤成竖排**：宽度依赖内容，在窄的标题栏槽里被压成每行 3–4 字。
+  改为固定 200px（视口更窄时收窄），最多 4 行后截断。
+- **过时提示文案**：`scenesHint` 仍写着「能自己决定要不要用模型写提示」，
+  但模型功能已删除。改为只描述超时。
+
 ## [0.1.0] - 2026-10-20
 
 首个版本。核心用途：**下载卡住时自动掐掉，并把换源提示写给智能体看**。

package/README.md

@@ -128,8 +128,12 @@ $env:DSH_PROFILE   # 桌面版一般是 desktop
 
 ### 显示开关
 
-面板里「显示监督员」一勾即关，**关掉后守卫照常工作**（下载一样会被掐断、提示一样会写进工具结果），
-只是不再画那个形象。右下角会留一个 14px 的半透明小点，点它随时能打开面板重新打开。
+| 开关 | 作用 |
+|---|---|
+| 显示监督员 | 关掉后不再画形象，但**守卫照常工作**。右下角留一个半透明小点，点它开回面板 |
+| 卡顿时显示文字气泡 | 关掉仍会**跳动**提示有异常，但不显示那句文字 |
+
+点图标或点气泡都能打开面板。
 
 ### 图标外观（仅本浏览器）
 
@@ -258,7 +262,7 @@ $env:DSH_PROFILE   # 桌面版一般是 desktop
 ## 开发
 
 ```bash
-node --test test/*.test.mjs        # 144 个用例
+node --test test/*.test.mjs        # 182 个用例
 ```
 
 ## 许可

package/client.js

@@ -189,7 +189,7 @@ window.__ModuleLoader__.load({
       autoSwitch: 'Auto-switch fetch/search on timeout',
       sectionPresets: 'Preset text (sent to the agent)',
       sectionScenes: 'Each feature, configured separately',
-      scenesHint: 'Turn one off without affecting the others. Each has its own timeout and its own choice about the supervisor model.',
+      scenesHint: 'Turn one off without affecting the others. Each has its own timeout.',
       sceneSeconds: 'Timeout (s)',
       presetsHint: 'Write the exact text the agent reads when a stall is reported. Placeholders are filled in automatically; an empty box uses the built-in wording.',
       presetSceneDownload: 'Download',
@@ -207,6 +207,9 @@ window.__ModuleLoader__.load({
       sectionSupervisor: 'Supervisor',
       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 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',
@@ -279,7 +282,7 @@ window.__ModuleLoader__.load({
       discardNo: '\u7ee7\u7eed\u7f16\u8f91',
       sectionPresets: '\u9884\u8bbe\u6587\u5b57\uff08\u53d1\u7ed9\u667a\u80fd\u4f53\uff09',
       sectionScenes: '\u6bcf\u4e2a\u529f\u80fd\u72ec\u7acb\u914d\u7f6e',
-      scenesHint: '\u5173\u6389\u4e00\u4e2a\u4e0d\u5f71\u54cd\u5176\u5b83\u3002\u6bcf\u4e2a\u7c7b\u578b\u6709\u81ea\u5df1\u7684\u8d85\u65f6\uff0c\u4e5f\u80fd\u81ea\u5df1\u51b3\u5b9a\u8981\u4e0d\u8981\u7528\u6a21\u578b\u5199\u63d0\u793a\u3002',
+      scenesHint: '\u5173\u6389\u4e00\u4e2a\u4e0d\u5f71\u54cd\u5176\u5b83\u3002\u6bcf\u4e2a\u7c7b\u578b\u6709\u81ea\u5df1\u7684\u8d85\u65f6\u3002',
       sceneSeconds: '\u8d85\u65f6\uff08\u79d2\uff09',
       presetsHint: '\u76f4\u63a5\u5199\u4f60\u8981\u53d1\u7ed9\u667a\u80fd\u4f53\u7684\u6587\u5b57\uff0c\u5360\u4f4d\u7b26\u4f1a\u81ea\u52a8\u66ff\u6362\uff1b\u7a7a\u7740 = \u7528\u5185\u7f6e\u6587\u6848\u3002',
       presetSceneDownload: '\u4e0b\u8f7d',
@@ -296,6 +299,9 @@ window.__ModuleLoader__.load({
       downloadSeconds: '\u4e0b\u8f7d\u8d85\u65f6\uff08\u79d2\uff09',
       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\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',
@@ -496,6 +502,7 @@ window.__ModuleLoader__.load({
         presets: normalizePresets(body.presets),
         supervisor: {
           show: sup.show !== false,
+          bubble: sup.bubble !== false,
           display: pick(sup.display, DISPLAYS, 'avatar'),
         },
       };
@@ -858,6 +865,7 @@ window.__ModuleLoader__.load({
         },
         supervisor: {
           show: source.supervisor.show !== false,
+          bubble: source.supervisor.bubble !== false,
           display: source.supervisor.display,
         },
       };
@@ -905,6 +913,7 @@ window.__ModuleLoader__.load({
         },
         supervisor: {
           show: draft.supervisor.show !== false,
+          bubble: draft.supervisor.bubble !== false,
           display: pick(draft.supervisor.display, DISPLAYS, 'avatar'),
         },
       };
@@ -920,7 +929,7 @@ window.__ModuleLoader__.load({
      */
     const CSS = [
       /* ---- supervisor seat ---- */
-      '.dsg-seat{position:relative;display:inline-flex;flex:none;align-items:center;justify-content:center;pointer-events:auto}',
+      '.dsg-seat{position:relative;display:inline-flex;flex:none;align-items:center;justify-content:center;pointer-events:auto;overflow:visible}',
       '.dsg-orb{box-sizing:border-box;display:inline-flex;position:relative;align-items:center;justify-content:center;margin:0;padding:0;border:none;background:transparent;font-family:inherit;cursor:pointer;overflow:visible;border-radius:var(--dsw-radius-sm,6px);pointer-events:auto}',
       '.dsg-orb:focus-visible{outline:2px solid var(--dsw-alias-brand-primary,#4d6bfe);outline-offset:2px}',
       '.dsg-orb[data-display="dot"]{width:22px;height:22px}',
@@ -937,11 +946,14 @@ window.__ModuleLoader__.load({
       '.dsg-orb[data-mode="idle"] .dsg-avatar{opacity:.72;animation:none}',
       '.dsg-orb[data-mode="watching"] .dsg-avatar{animation:dsg-sway 3.2s ease-in-out infinite}',
       '.dsg-orb[data-mode="alert"] .dsg-avatar{animation:dsg-bounce-big .85s ease-in-out infinite}',
-      '.dsg-bubble{position:absolute;right:0;bottom:calc(100% + 7px);z-index:5;box-sizing:border-box;max-width:230px;min-width:64px;padding:4px 8px;border:1px solid var(--dsw-alias-border-l1,var(--dsh-border,rgba(255,255,255,.12)));border-radius:var(--dsw-radius-sm,8px);background:var(--dsw-alias-bg-overlay,var(--dsh-surface,rgba(20,22,28,.96)));box-shadow:var(--dsw-elevation-soft,0 4px 18px rgba(0,0,0,.2));color:var(--dsw-alias-label-primary,var(--dsh-text-primary,#e6e6e6));font-size:11px;line-height:15px;text-align:left;white-space:normal;word-break:break-word;pointer-events:none;animation:dsg-bubble-in .16s ease-out both}',
+      '.dsg-bubble{position:absolute;right:0;bottom:calc(100% + 7px);z-index:5;box-sizing:border-box;width:200px;max-width:calc(100vw - 40px);padding:4px 8px;border:1px solid var(--dsw-alias-border-l1,var(--dsh-border,rgba(255,255,255,.12)));border-radius:var(--dsw-radius-sm,8px);background:var(--dsw-alias-bg-overlay,var(--dsh-surface,rgba(20,22,28,.96)));box-shadow:var(--dsw-elevation-soft,0 4px 18px rgba(0,0,0,.2));color:var(--dsw-alias-label-primary,var(--dsh-text-primary,#e6e6e6));font-size:11px;line-height:15px;text-align:left;white-space:normal;overflow-wrap:break-word;word-break:normal;max-height:120px;overflow:hidden;pointer-events:auto;cursor:pointer;animation:dsg-bubble-in .16s ease-out both}',
       /* The header sits at the very top of the frame, so a bubble above the head
        * would be clipped by the viewport; the seat measures once and flips it
        * below when there is no room. */
       '.dsg-bubble[data-place="below"]{bottom:auto;top:calc(100% + 7px)}',
+      '.dsg-bubble:hover{border-color:var(--dsw-alias-brand-primary,#4d6bfe)}',
+      /* 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-head{display:flex;align-items:center;gap:8px;flex-wrap:wrap;flex:0 0 auto;padding-bottom:8px}',
@@ -1207,7 +1219,8 @@ window.__ModuleLoader__.load({
       const mode = snapshot.state === null ? 'idle' : snapshot.state.supervisor.mode;
       const display = config === null ? 'avatar' : config.supervisor.display;
       const message = snapshot.state === null ? '' : snapshot.state.supervisor.message;
-      const showBubble = !supervisorOff && display === 'avatar' && mode === 'alert' && message !== '';
+      const bubbleOn = config === null ? true : config.supervisor.bubble !== false;
+      const showBubble = !supervisorOff && bubbleOn && display === 'avatar' && mode === 'alert' && message !== '';
 
       /* The seat can live in the top bar or float anywhere; a bubble above the head
        * would be cut off by the viewport when it sits near the top, so measure once
@@ -1297,14 +1310,34 @@ window.__ModuleLoader__.load({
           display === 'dot' ? h('span', { className: 'dsg-dot' }) : null,
           display === 'icon' ? h(ShieldGlyph, { size: Math.round(size * 0.64) }) : null,
           display === 'avatar' ? h(WhaleGlyph, { size: Math.round(size * 0.82), mode }) : null,
-          showBubble
-            ? h('span', {
-              className: 'dsg-bubble',
-              'data-place': bubbleBelow ? 'below' : 'above',
-              role: 'status',
-            }, message)
-            : null,
         ),
+        /* The bubble is a SIBLING of the button, not a child: interactive content inside a
+         * button is invalid and browsers route its clicks unpredictably, and content painted
+         * outside the button box is not part of its hit area. */
+        showBubble
+          ? h('span', {
+            className: 'dsg-bubble',
+            'data-place': bubbleBelow ? 'below' : 'above',
+            role: 'button',
+            tabIndex: 0,
+            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();
+              event.preventDefault();
+              void store.acknowledge();
+            },
+            onKeyDown: (event) => {
+              if (event.key === 'Enter' || event.key === ' ') {
+                event.preventDefault();
+                event.stopPropagation();
+                void store.acknowledge();
+              }
+            },
+          }, message)
+          : null,
       );
     }
 
@@ -1701,6 +1734,18 @@ window.__ModuleLoader__.load({
             h('span', null, t('showSupervisor')),
           ),
           h('p', { className: 'dsg-status' }, t('showSupervisorHint')),
+          h('label', { className: 'dsg-check' },
+            h('input', {
+              type: 'checkbox',
+              checked: draft.supervisor.bubble !== false,
+              onChange: (event) => {
+                const checked = event.target.checked;
+                edit((next) => { next.supervisor = Object.assign({}, next.supervisor, { bubble: checked }); });
+              },
+            }),
+            h('span', null, t('showBubble')),
+          ),
+          h('p', { className: 'dsg-status' }, t('showBubbleHint')),
           h('div', { className: 'dsg-label' }, t('displayLabel')),
           h('div', { className: 'dsg-choices' },
             DISPLAYS.map((value) => h('label', {

package/lib/config.js

@@ -48,6 +48,11 @@ export function defaults() {
     supervisor: {
       /** Whether the supervisor is drawn at all. Off still serves the API and the panel. */
       show: true,
+      /**
+       * Whether the alert bubble shows its sentence. Off keeps the animation only, so a
+       * user who finds the text intrusive still sees that something is wrong.
+       */
+      bubble: true,
       display: DEFAULT_DISPLAY,
     },
   };
@@ -113,6 +118,7 @@ export function validateConfig(raw) {
   const rawSupervisor = input.supervisor && typeof input.supervisor === 'object' ? input.supervisor : {};
 
   const show = rawSupervisor.show === undefined ? base.supervisor.show : Boolean(rawSupervisor.show);
+  const bubble = rawSupervisor.bubble === undefined ? base.supervisor.bubble : Boolean(rawSupervisor.bubble);
 
   let display = base.supervisor.display;
   if (rawSupervisor.display !== undefined) {
@@ -142,6 +148,7 @@ export function validateConfig(raw) {
       presets: presetResult.presets,
       supervisor: {
         show,
+        bubble,
         display,
       },
     },

package/package.json

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