dsh-session-superagent 0.8.12 → 0.8.14

package/CHANGELOG.md

@@ -2,6 +2,91 @@
 
 格式参照 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/)，版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
 
+## [0.8.14] - 2026-11-02 —— 第四轮审核：1 条文档 + 3 条代码建议
+
+审核范围 0.8.9→0.8.13（上一轮门禁只覆盖到 0.8.8）。结论：代码侧无阻塞，文档有 1 处必须修。
+
+### 修复
+- **幽灵会话不退避**（真问题）：绑到「已删除会话」的 watcher 每次轮询都打一次 GitHub 且永不休止
+  （0.8.11 的分支直接 `return`，没走 `bumpFailure`）。现在会正常进入 30 分钟退避。
+- **删掉 `/client-hello` 路由**：客户端只在那里发过一次 fire-and-forget fetch，而 `note('apply')`
+  已经覆盖同一用途。路由 7 → 6，并加用例锁死路由集合（`/config`、`/client-hello` 都不该回来）。
+
+### 文档
+- HANDOFF 版本号 0.8.11 → 0.8.14；README / MAINTENANCE / HANDOFF 的测试数 77 → 80。
+
+### 未采纳（附理由）
+- **goal 文本里的 `【主理鱼】` 内联**：已压平换行（实测伪造抬头不会独占一行），
+  且 goal 只能由面板或本地 POST 写入，风险低；强行改写用户文本得不偿失。
+- **`sync-profile --repair`**：断链（inode 不同）目前只警告。已在 HANDOFF 写明「新增文件后必须跑」，
+  留作后续（改起来简单，但此刻没有证据表明它造成过事故）。
+
+### 其他
+- `scripts/smoke-observe.mjs` 加 `gh auth status` 预检：没登录时明确 SKIP 并退出 0，
+  不再把「凭证/网络问题」混报成逻辑失败（第四轮审核的建议）。
+
+### 测试
+- 合计 **80 例**（新增路由集合用例）。
+
+## [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 都没这个标签）
+```
+
+### 发布与真机验证
+- 已发 `dsh-session-superagent@0.8.13`。
+- **`watch_ack` 第一次在真仓库上验证**：给 `MYCF711/dsh-GOkifu-compact#2` 打上 `主理鱼:已处理`——
+  GitHub **接受中文 + 冒号**的标签名（此前审核把它列为"未验证"）；重复 ack 幂等不报错；
+  验证完已把 issue 标签与仓库标签定义都撤掉，不留痕迹。
+
+### 测试
+- 合计 **79 例**。
+
+### 进程内冒烟（补证：这两个修复到底生效没有）
+`pnpm run smoke:observe`（`scripts/smoke-observe.mjs`）—— 独立进程、独立状态目录、
+捕获 `setInterval` 手动驱动，会真的读 GitHub 只读 API：
+
+```
+OK   观模式仍未唤醒            （followups = 0）
+OK   filteredLog 已落盘        （4 条）
+OK   过滤原因可读              （"不在标签白名单: ai-fix"）
+OK   /state 能读到过滤记录
+OK   空轮询清掉了过期的 lastDeferred
+
+== 场景 B：真唤醒 + 隔离 worktree ==
+OK   唤醒了一次                        （followups = 1）
+OK   消息带【主理鱼】抬头
+OK   消息带条目编号                     （#2 #4 #3 #1，真 GitHub 数据）
+OK   消息带本条目主理目标               （「把 widget 的 issue 都处理完」）
+OK   消息带隔离路径
+OK   worktree 真的建了                  （.dsh-zhuli/MYCF711-dsh-GOkifu-compact-smoke-se-…）
+OK   .dsh-zhuli 下正好一个副本
+```
+
+消息实样（真数据）：
+
+```
+【主理鱼】MYCF711/dsh-GOkifu-compact 有 4 条新动态：
+#2 [open] docs/bench：给「351 tokens」和「失败保留 8/8」补一条可复跑的复现命令 — @MYCF711 (issue) …
+#4 [closed] 【联调】v0.1.0 唤醒链路验证 — @MYCF711 (issue) …
+【隔离工作区】…\.dsh-zhuli\MYCF711-dsh-GOkifu-compact-smoke-se-…
+本条目主理目标：把 widget 的 issue 都处理完
+```
+
 ## [0.8.12] - 2026-11-02 —— 体验打磨四条
 
 ### 改了什么
@@ -13,8 +98,15 @@
 - **删掉 `/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` 那类事故）。
+
 ### 测试
-- 合计 **77 例**（`/config` 用例改为「路由表里不应再有它」）。
+- 合计 **78 例**（`/config` 用例改为「路由表里不应再有它」+ 相对 import 守门）。
 
 ## [0.8.11] - 2026-11-02 —— 真机验证隔离执行 + watch_doctor
 

package/README.md

@@ -1,7 +1,7 @@
 # dsh-session-superagent
 
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
-[![Version](https://img.shields.io/badge/version-0.8.12-green.svg)](https://github.com/MYCF711/dsh-session-superagent/releases)
+[![Version](https://img.shields.io/badge/version-0.8.14-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)
 

package/client.js

@@ -14,7 +14,7 @@ window.__ModuleLoader__.load({
     const { useCallback, useEffect, useRef, useState } = React
 
     // 客户端版本探针：每次模块加载写一次，用来确认浏览器里跑的是哪一版
-    const CLIENT_VERSION = '0.8.12'
+    const CLIENT_VERSION = '0.8.14'
     const BASE = '/session-superagent'
     const ENDPOINT = BASE + '/state'
     const POLL_MS = 5000
@@ -974,7 +974,6 @@ window.__ModuleLoader__.load({
       apply(ctx) {
         try { noteOnce('client-version', CLIENT_VERSION) } catch {}
         try { note('apply', 'start') } catch {}
-        try { fetch(BASE + '/client-hello').catch(() => {}) } catch {}
 
         // ① the 主理鱼 tab in the centre-column view ring
         ctx.effect(() => {

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) {
@@ -466,8 +470,10 @@ async function pollOnce(ctx, entry, baseMs) {
   // 会话忙就别开隔离区了：白建一个没人用的 worktree
   const liveAgent = ctx.agents && typeof ctx.agents.get === 'function' ? ctx.agents.get(entry.sessionId) : undefined
   if (!liveAgent) {
-    // 会话已经不在了（被删/换机器）：别开隔离区，也别假装在盯
+    // 会话已经不在了（被删/换机器）：别开隔离区，也别假装在盯。
+    // 必须走 bumpFailure —— 否则这条会每 intervalSec 打一次 GitHub，永不退避（第四轮审核指出）。
     entry.lastError = '会话已不在：请删除或重建这条主理鱼'
+    bumpFailure(entry, baseMs)
     return
   }
   const gate = decideWake(liveAgent && liveAgent.status)
@@ -622,11 +628,6 @@ export function apply(ctx) {
           }))
         },
       }))
-      routes.push(httpServer.register({
-        kind: 'exact',
-        path: '/session-superagent/client-hello',
-        handler: (req, res) => { record('hello', String(req.url)); res.statusCode = 204; res.end() },
-      }))
       routes.push(httpServer.register({
         kind: 'exact',
         path: '/session-superagent/client-note',

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.12",
+  "version": "0.8.14",
   "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",
@@ -30,7 +30,8 @@
     "test": "node --test",
     "check": "node --test",
     "preview:orbit": "node scripts/preview-orbit.mjs",
-    "sync:profile": "node scripts/sync-profile.mjs"
+    "sync:profile": "node scripts/sync-profile.mjs",
+    "smoke:observe": "node scripts/smoke-observe.mjs"
   },
   "keywords": [
     "dsh",