dsh-session-superagent 0.8.11 → 0.8.13

package/CHANGELOG.md

@@ -2,6 +2,49 @@
 
 格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.13] - 2026-11-02 —— 真机跑「只观察」闭环，抓出两个真 bug
+
+拿真仓库（MYCF711/dsh-GOkifu-compact，3 个真 issue）跑 observe 模式验证，抓到：
+
+### 修复
+- **`filteredLog` 从没落过盘**：`filteredLog` 不在 `POLL_RESULT_FIELDS` 白名单里，
+  内存里写得好好的，`persistEntry` 一过滤就没了 → 面板「最近被过滤」永远是空的。
+  现在进白名单，并补了守门用例。
+- **空轮询不清理 `lastDeferred`**：把过滤器改严之后一条都不该唤醒，但面板仍显示上一轮的
+  「仅观察：本轮本会唤醒 4 条（#4 #2 #3 #1）」——那是过期信息。现在 `fresh.length === 0` 时清空。
+
+### 真机证据（修复前）
+```
+observe: true
+lastDeferred: 仅观察：本轮本会唤醒 4 条（#4 #2 #3 #1）
+history: [{"numbers":[4,2,3,1],"ok":false,"reason":"observe"}]
+filteredLog: []        ← 改成 labels:["ai-fix"] 后仍为空（3 个 issue 都没这个标签）
+```
+
+### 测试
+- 合计 **79 例**。
+
+## [0.8.12] - 2026-11-02 —— 体验打磨四条
+
+### 改了什么
+- **Toast 改成官方单条语义**：移植来的 `.dt-toast` 是 `position:fixed` 顶部居中、自带淡出动画，
+  同时挂多条会**重叠成一团**。现在同一时刻只显示最新一条，停留时长用官方的 `--dt-toast-hold` 控制，
+  错误态保留淡红底 + `role=status` / `aria-live=polite`。
+- **页签焦点跟随**：方向键/Home/End 切页后，焦点跟到新页签 —— 之前旧页签变 `tabIndex=-1`、
+  新页签变 0，但焦点留在原地，键盘用户会「掉出」tablist。
+- **删掉 `/session-superagent/config`**：它和 `/state` 重复，是未鉴权的 GET，而且上一轮
+  `ReferenceError: gh is not defined` 就出在它身上。现在路由从 8 条减到 7 条，测试改为断言它已下线。
+
+### 发布与验证
+- 已发 `dsh-session-superagent@0.8.12`（registry 确认 `latest=0.8.12`）。
+- **从 registry 真装一遍验证**（不是只看 `npm pack`）：
+  `npm i dsh-session-superagent@0.8.12` → `import(...)/lib/index.js` → `apply()` 成功、
+  路由 **7** 条（`/config` 确实没了）、`node --check client.js` 通过。
+- 新增守门：`lib/` 里每个相对 import 必须能解析到真实文件（发布前挡住 `body.js` 那类事故）。
+
+### 测试
+- 合计 **78 例**（`/config` 用例改为「路由表里不应再有它」+ 相对 import 守门）。
+
 ## [0.8.11] - 2026-11-02 —— 真机验证隔离执行 + watch_doctor
 
 ### 验证（这轮真的在跑起来的宿主上做的）
@@ -26,6 +69,12 @@
   结果是 `lastError="会话已不在：请删除或重建这条主理鱼"`、`lastWorktree=null`、**没有** `.dsh-zhuli` 目录
   （修复前会先建一个永远用不上的 worktree）。
 
+### 发布
+- **已发布到 npm**：`dsh-session-superagent@0.8.11`（`npm view` 确认，tarball 220.6 kB / 13 文件）。
+- 顺手把 `latest` 指向 0.8.11，并把 npm 自动生成的 `0.0.0-stage` 占位版标为弃用
+  （否则 `npm i dsh-session-superagent` 会装到那个空占位）。
+- GitHub Release：https://github.com/MYCF711/dsh-session-superagent/releases/tag/v0.8.11
+
 ### 测试
 - 合计 **77 例**（本修复属运行时守卫，靠真机 E2E 验证）。
 

package/README.md

@@ -1,7 +1,8 @@
 # dsh-session-superagent
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.8.11-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
+[![Version](https://img.shields.io/badge/version-0.8.13-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
+[![npm](https://img.shields.io/npm/v/dsh-session-superagent.svg)](https://www.npmjs.com/package/dsh-session-superagent)
 [![dsh](https://img.shields.io/badge/DeepSeek%20Harness-plugin-orange.svg)](https://github.com/topics/dsh-plugin)
 
 > **一句话**：给一个 DSH 会话装上一条 **主理鱼**——
@@ -50,18 +51,17 @@ GitHub 有新动态 → watcher 轮询 → Agent.followup(消息) → 会话跑
 
 ## 安装
 
-```sh
-dsh plugin --profile <profile> add github:MYCF711/dsh-session-superagent
-```
-
-包会带 `cordis.patch.yml`（插入一个 tools-only 行），**不会**自动改你的 `bundles` 列表——那一步是操作者的动作。
+```bash
+# 方式一：npm（已发布）
+npm i dsh-session-superagent
 
-装完重启一次宿主，然后在任意会话里：
-
-```
-watch_start({ repo: "owner/name", intervalSec: 60 })
+# 方式二：从 GitHub 源码装（会跟踪 main）
+dsh plugin add https://github.com/MYCF711/dsh-session-superagent
 ```
 
+装进 profile 时是 `file:` 硬链接，改代码即改线上；**但新增文件不会被自动带过去**，
+加完文件要跑 `pnpm run sync:profile`（否则下次重启插件会整体不挂载，这坑踩过一次）。
+
 ## 一次真实运行长什么样
 
 1. `watch_start` 登记 watcher（状态存 `~/.dsh/state/session-superagent/watchers.json`）；

package/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
     const { useCallback, useEffect, useRef, useState } = React
 
     // 客户端版本探针：每次模块加载写一次，用来确认浏览器里跑的是哪一版
-    const CLIENT_VERSION = '0.8.11'
+    const CLIENT_VERSION = '0.8.13'
     const BASE = '/session-superagent'
     const ENDPOINT = BASE + '/state'
     const POLL_MS = 5000
@@ -125,6 +125,7 @@ window.__ModuleLoader__.load({
 
     /** 页级 tab 条：点当前页会再发一次 onChange（回调里可重置到根部）。 */
     function SegTabs({ items, value, onChange, label }) {
+      const buttons = useRef({})
       const walk = (event) => {
         if (items.length === 0) return
         const values = items.map((item) => item.value)
@@ -133,13 +134,19 @@ window.__ModuleLoader__.load({
         if (target === undefined) return
         event.preventDefault()
         const next = values[(target + values.length) % values.length]
-        if (next !== value) onChange(next)
+        if (next !== value) {
+          onChange(next)
+          // 焦点跟随：旧页签变成 tabIndex=-1 后，键盘用户会掉出 tablist
+          const nextButton = buttons.current[next]
+          if (nextButton && typeof nextButton.focus === 'function') nextButton.focus()
+        }
       }
       return h('div', {
         role: 'tablist', 'aria-label': label, className: 'dt-tabs', onKeyDown: walk,
         style: { gridTemplateColumns: 'repeat(' + items.length + ', minmax(0, 1fr))' },
       }, items.map((item) => h('button', {
         key: item.value, type: 'button', role: 'tab',
+        ref: (node) => { buttons.current[item.value] = node },
         'aria-selected': item.value === value,
         tabIndex: item.value === value ? 0 : -1,
         className: 'dt-tab',
@@ -593,26 +600,24 @@ window.__ModuleLoader__.load({
 
     /** 轻量 Toast：右下角堆叠，4 秒自动消失。 */
     function useToast() {
-      const [items, setItems] = useState([])
-      const timers = useRef([])
-      useEffect(() => () => { for (const timer of timers.current) clearTimeout(timer); timers.current = [] }, [])
+      // 官方 .dt-toast 是 position:fixed 顶部居中、且带自动淡出动画 —— 同时挂两条会重叠，
+      // 所以这里保持「同一时刻只有最新一条」，停留时长用官方的 --dt-toast-hold 控制。
+      const [item, setItem] = useState(null)
+      const timer = useRef(null)
+      useEffect(() => () => { if (timer.current) clearTimeout(timer.current) }, [])
       const notify = useCallback((text, tone = 'info') => {
-        const id = Math.random().toString(36).slice(2)
-        setItems((prev) => [...prev, { id, text, tone }])
-        const timer = setTimeout(() => {
-          // 用后即删：长会话里这个数组不能只增不减
-          timers.current = timers.current.filter((handle) => handle !== timer)
-          setItems((prev) => prev.filter((item) => item.id !== id))
-        }, 4000)
-        timers.current.push(timer)
+        if (timer.current) clearTimeout(timer.current)
+        setItem({ id: Math.random().toString(36).slice(2), text, tone })
+        timer.current = setTimeout(() => setItem(null), 4000)
       }, [])
-      // .dt-toast 自己就是 position:fixed（顶部居中），这里只做分组，不再加定位样式
-      const view = items.length === 0 ? null : h(React.Fragment, null,
-        items.map((item) => h('div', {
-          key: item.id,
-          className: cx('dt-toast', item.tone === 'error' && 'dt-danger'),
-          style: item.tone === 'error' ? { background: 'color-mix(in srgb, #f85149 14%, var(--dsw-alias-bg-layer-1, #fff))' } : undefined,
-        }, item.text)))
+      const view = item === null ? null : h('div', {
+        className: cx('dt-toast', item.tone === 'error' && 'dt-danger'),
+        role: 'status',
+        'aria-live': 'polite',
+        style: item.tone === 'error'
+          ? { '--dt-toast-hold': '3600ms', background: 'color-mix(in srgb, #f85149 14%, var(--dsw-alias-bg-layer-1, #fff))' }
+          : { '--dt-toast-hold': '3600ms' },
+      }, item.text)
       return [view, notify]
     }
 

package/lib/index.js

@@ -422,7 +422,11 @@ async function pollOnce(ctx, entry, baseMs) {
     const newestAbsorbed = newestUpdatedAt(absorbed)
     if (!entry.cursor || Date.parse(newestAbsorbed) > Date.parse(entry.cursor)) entry.cursor = newestAbsorbed
   }
-  if (fresh.length === 0) return
+  if (fresh.length === 0) {
+    // 这一轮没有新增：上一轮的说法（比如「仅观察：本会唤醒 4 条」）已经过期了
+    entry.lastDeferred = null
+    return
+  }
 
   // 仅观察模式（对标官方 observe）：照常判定，但只记录「本会唤醒哪几条」，不真唤醒
   if (entry.observe === true) {
@@ -663,25 +667,6 @@ export function apply(ctx) {
         res.end(JSON.stringify(body))
       }
 
-      // Operator-facing configuration: what is configured (never the values).
-      routes.push(httpServer.register({
-        kind: 'exact',
-        path: '/session-superagent/config',
-        handler: async (req, res) => {
-          if (req.method !== 'GET') return json(res, 405, { error: 'method not allowed' })
-          const state = readState()
-          const gh = await ghHealth()
-          json(res, 200, {
-            gh,
-            credentials: secretsSummary(),
-            watchers: Object.values(state.watchers || {}).map((w) => ({
-              repo: w.repo, sessionId: w.sessionId, intervalSec: w.intervalSec,
-              enabled: w.enabled !== false, goal: w.goal ?? '',
-            })),
-          })
-        },
-      }))
-
       // Create or update a watcher from the panel. The panel is session-scoped,
       // so it must send the session id it is bound to.
       routes.push(httpServer.register({

package/lib/watch.js

@@ -350,6 +350,8 @@ export const POLL_RESULT_FIELDS = [
   'lastPoll', 'lastError', 'nextAt', 'consecutiveFailures', 'seen', 'cursor', 'lastReported',
   'lastWake', 'lastWakeCount', 'lastBatch', 'lastAbsorbed', 'wakeTimes', 'lastDeferred',
   'history', 'lastWorktree', 'lastAcked', 'lastTrigger',
+  // 过滤记录也是轮询结果：漏了它面板上的「最近被过滤」永远是空的
+  'filteredLog',
 ]
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-session-superagent",
-  "version": "0.8.11",
+  "version": "0.8.13",
   "description": "Session-level superagent for DeepSeek Harness: watch a GitHub repository and wake a session when something needs doing. Credentials never reach the model.",
   "type": "module",
   "main": "lib/index.js",