dsh-selfnote 0.13.1 → 0.13.2

package/README.md

@@ -252,6 +252,29 @@ DSH 的会话文件是**逐条追写**的 zstd 序列（一次写入 = 一个 fr
 - **采纳 / 退役都要人点**：出现次数再多也不会自动采纳；退役的事实不会因为新候选出现就自己复活。
 - **留痕**：每次改状态记下时间、从哪改的（`via: settings`）、前后状态（`history`），事后可查。
 
+### 候选为空时，怎么知道它到底有没有在听
+
+`GET /api/selfnote/capture` 是这块的诊断口（要带 `x-selfnote` 头，值见 `~/.dsh/selfnote/auth-token`）：
+
+```json
+{
+  "since": "2026-11-04T07:31:02.114Z",
+  "events": 160,
+  "types": { "user/message": 12, "job/registered": 40, "turn/ended": 108 },
+  "reasons": { "written": 1, "no-candidate": 11, "not-user-authored": 148 },
+  "candidates": 1,
+  "written": 1,
+  "lastType": "turn/ended",
+  "trace": [{ "at": "…", "sid": "session-", "type": "user/message", "seq": 91, "reason": "no-candidate" }]
+}
+```
+
+- `types` 是事件类型直方图：`user/message` 在涨，说明**你的话真的进来了**；不涨才是链路断了。
+- `reasons` 是每一条的最后落点：`written` 写出了候选、`no-candidate` 过了人审但没命中触发词、`not-user-authored` 不是人打的、`no-session` 没有会话 id、`error` 采集抛错。
+- `trace` 保留最近 40 条，带时间、会话前缀、seq 和落点。
+
+候选区空着有两种情况，这里能分开：**没在听**（`types` 里没有 `user/message`）和**在听但没话可采**（`no-candidate` 在涨）。这两个计数是 0.13.2 才补的 —— 上一版有两个计数器声明了从来没人加一，读出来永远 0，排查时反而把结论带偏。
+
 ## 注入预算
 
 每回合五段，合计 800 字（自述占最大一份）：

package/lib/index.js

@@ -81,16 +81,62 @@ export const name = 'selfnote'
 /** 声明式依赖：systemPrompt 注入，tools 写入，webServer 提供设置页 API。 */
 export const inject = ['systemPrompt', 'tools', 'webServer']
 
-/** 自动采集的现场计数器：只用于排查「事件到底有没有到」，不参与业务。 */
+/**
+ * 自动采集的现场情况：只用于排查「事件到底有没有到、卡在哪一步」，不参与业务。
+ *
+ * 以前这里有两个 userAuthored / noSeq 计数器，声明了从来没人加一，读出来永远是 0 ——
+ * 排查时反而误导（看起来像「消息一条都没进来」）。现在换成两条真账：
+ * types（按事件类型计数）与 reasons（按落点计数），外加最近若干条轨迹。
+ */
+const CAPTURE_TRACE_MAX = 40
+
 const captureDebug = {
+  since: null,
   events: 0,
-  userAuthored: 0,
-  noSeq: 0,
+  types: {},
+  reasons: {},
   candidates: 0,
   written: 0,
   lastType: null,
   lastKeys: null,
   lastError: null,
+  trace: [],
+}
+
+function bumpCounter(bucket, key) {
+  if (typeof key !== 'string' || key === '') return
+  bucket[key] = (bucket[key] ?? 0) + 1
+}
+
+/** 事件一进来先记账：类型直方图 + 最近几条。返回类型，供后面的落点记录复用。 */
+function noteCaptureEvent(sessionId, event) {
+  captureDebug.events += 1
+  const type = typeof event?.type === 'string' && event.type !== '' ? event.type : 'unknown'
+  bumpCounter(captureDebug.types, type)
+  captureDebug.lastType = event?.type ?? null
+  captureDebug.lastKeys = event !== null && typeof event === 'object' ? Object.keys(event).slice(0, 12) : null
+  uploadTrace({
+    at: new Date().toISOString(),
+    sid: typeof sessionId === 'string' ? sessionId.slice(0, 8) : '',
+    type,
+    seq: Number.isSafeInteger(event?.seq) ? event.seq : null,
+    reason: null,
+  })
+  return type
+}
+
+/** 这一轮采集最后落在哪：写进去了 / 没候选 / 不是人说的 / 没 seq …… */
+function noteCaptureOutcome(reason) {
+  bumpCounter(captureDebug.reasons, reason)
+  const last = captureDebug.trace[captureDebug.trace.length - 1]
+  if (last !== undefined) last.reason = reason
+}
+
+function uploadTrace(entry) {
+  captureDebug.trace.push(entry)
+  if (captureDebug.trace.length > CAPTURE_TRACE_MAX) {
+    captureDebug.trace.splice(0, captureDebug.trace.length - CAPTURE_TRACE_MAX)
+  }
 }
 
 const API_PREFIX = '/api/selfnote'
@@ -2209,12 +2255,14 @@ export function apply(ctx, config) {
   /* ---- 自动采集（P1-B）：只发现，不确认 ---- */
   // session/event 是 fire-and-forget：这里绝不能把异常抛回宿主，也不能阻塞对话
   if (typeof ctx?.on === 'function') {
+    captureDebug.since = new Date().toISOString()
     const offCapture = ctx.on('session/event', (session, event) => {
-      captureDebug.events += 1
-      captureDebug.lastType = event?.type ?? null
-      captureDebug.lastKeys = event !== null && typeof event === 'object' ? Object.keys(event).slice(0, 12) : null
+      const type = noteCaptureEvent(session?.id, event)
       const sessionId = session?.id
-      if (typeof sessionId !== 'string' || sessionId === '') return
+      if (typeof sessionId !== 'string' || sessionId === '') {
+        noteCaptureOutcome('no-session')
+        return
+      }
       // 压缩发生了就记一笔：下一轮把这个会话用过的记忆再贴一遍
       noteCompaction(session, event)
       // 同一会话按到达顺序串行，避免 seq=11 先完成把游标推到 11、把 seq=10 挤掉
@@ -2229,17 +2277,20 @@ export function apply(ctx, config) {
       )
         .then((result) => {
           captureDebug.candidates += result?.plan?.created?.length ?? 0
-          if (result?.handled === true) {
+          const written = result?.handled === true
+          if (written) {
             captureDebug.written += 1
             const plan = result.plan ?? {}
             ctx.logger?.info?.(
               `selfnote: 采集到 ${plan.created?.length ?? 0} 条候选（合并 ${plan.merged?.length ?? 0}，冲突 ${plan.conflicts?.length ?? 0}）`,
             )
           }
+          noteCaptureOutcome(written ? 'written' : String(result?.reason ?? type + ':unknown'))
         })
         .catch((error) => {
           // 采集坏掉不许影响对话
           captureDebug.lastError = String(error?.message ?? error)
+          noteCaptureOutcome('error')
           ctx.logger?.warn?.('selfnote: 自动采集失败 ' + String(error?.message ?? error))
         })
     })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-selfnote",
-  "version": "0.13.1",
+  "version": "0.13.2",
   "type": "module",
   "description": "Self-narrative memory for DeepSeek Harness: the model writes notes to itself, which persist across sessions and are injected back. | 人格库：模型写给自己看的话，跨会话保留并每回合注入。",
   "keywords": [
@@ -27,7 +27,7 @@
     "assets"
   ],
   "scripts": {
-    "test": "node tests/smoke.mjs && node tests/memory.mjs && node tests/roles.mjs && node tests/heat.mjs && node tests/fair.mjs && node tests/facts-tx.mjs && node tests/crash-write.mjs && node tests/capture.mjs && node tests/capture-p1b.mjs && node tests/index.mjs && node tests/incremental.mjs && node tests/profile.mjs && node tests/warm.mjs && node tests/transfer.mjs && node tests/api.mjs && node tests/client-state.mjs && node tests/client.mjs",
+    "test": "node tests/smoke.mjs && node tests/memory.mjs && node tests/roles.mjs && node tests/heat.mjs && node tests/fair.mjs && node tests/capture-debug.mjs && node tests/facts-tx.mjs && node tests/crash-write.mjs && node tests/capture.mjs && node tests/capture-p1b.mjs && node tests/index.mjs && node tests/incremental.mjs && node tests/profile.mjs && node tests/warm.mjs && node tests/transfer.mjs && node tests/api.mjs && node tests/client-state.mjs && node tests/client.mjs",
     "test:accept": "node tests/acceptance-runtime.mjs"
   },
   "engines": {