dsh-galatea 0.4.5 → 0.4.6

package/README.md

@@ -13,7 +13,7 @@
 | 块 | 状态 |
 |---|---|
 | 能被 DSH 装起来 | ✅ 实测通过（dsh 0.2.2-rc.3） |
-| 发布到 npm | ✅ 0.4.5（GitHub Actions 自动发，不需要 token） |
+| 发布到 npm | ✅ 0.4.6（GitHub Actions 自动发，不需要 token） |
 | 记忆：读写 Markdown | ✅ 15 条测试 |
 | 记忆：注入索引 | ✅ **已核实内容真的进了上下文**（不是在会话日志里看到「接上了没告警」） |
 | 记忆：`remember` / `recall` | ✅ 23 条测试 |
@@ -187,6 +187,45 @@
 关着（0）也照常装定时器 —— 否则用户从 0 改成 5 的时候没人去装，又回到同一个坑。
 代价是每分钟空醒一次，读一个数字比大小。
 
+## 三条教训：粒度、上限、旧数据
+
+### 一 · 天粒度和秒粒度不能比较
+
+条目文件名里只有日期（`2026-11-15-土豆.md`），而心跳要回答的是
+「这条是写下之后才说的，还是说过了」。两边一个按天、一个按秒：
+
+```
+toMs('2026-11-15')  = 2026-11-15T00:00:00Z   ← 当天零点
+lastSpokeAt         = 2026-11-15T09:45:59Z   ← 真的时刻
+```
+
+于是**当天说过一次话之后，当天再写的任何东西都判成「早于上次开口」**，
+永远轮不到。用户会觉得「我刚记的事它怎么完全不提」——
+而这和「设计上就该沉默」长得一模一样，所以它能活到 0.4.5。
+
+现在 `listEntries` 会带上 `at`（文件 mtime），素材层优先用它；
+读不到 mtime 时退回日期（宁可粗略，也不编一个时刻）。
+`date` 保留不变——注入里给人看的就是它，人不需要秒。
+
+### 二 · 账本满了要说
+
+`decisions` 上限 50 条，满了滚动覆盖最旧的，所以**总数永远是 50**：
+看起来像停了，其实一直在写。
+
+原来那句「想确认它在动，看账本有没有新记录就够了」，在满 50 之后就不成立了。
+现在满了会明说一句。
+
+**假信号比没有信号更坏**——没有信号至少会让人去别处找。
+
+### 三 · 旧数据会跟着版本一起进来
+
+0.4.5 修掉 `quietStreak` 的累加条件之后，**旧账本里那个数还是旧的**。
+0.4.3 每跳都 +1，可能已经攒到几十；0.4.5 的第一次真实判定就直接撞下限保护。
+
+这里不改代码，因为分不清「真的几十轮没说话」和「旧 bug 累出来的」。
+它也不会一直错下去：下一次真的开口就归零。
+但它提醒一件事：**修「某个计数器的累加条件」时，旧值也是新逻辑的输入。**
+
 ## 一次教训：模块边界
 
 0.3.0 / 0.3.5 / 0.3.6 连着三次，坏的地方都在**两个文件交接处**：
@@ -223,7 +262,7 @@ $DSH_HOME/galatea/heartbeat-state.json                      # 心跳状态账本
 ## 本地开发
 
 ```bash
-npm test          # 101 条，不依赖 DSH，纯 node
+npm test          # 107 条，不依赖 DSH，纯 node
 ```
 
 装了之后验证它真的加载了，只看一个东西：
@@ -244,7 +283,7 @@ dsh plugin add dsh-galatea
 或者在 profile 的 `package.json` 里手写：
 
 ```json
-"dependencies": { "dsh-galatea": "0.4.5" }
+"dependencies": { "dsh-galatea": "0.4.6" }
 ```
 
 **版本号钉死，不要写 `^`。** 同一个版本号指向两个不同的包，以后就说不清你装的是哪一份。

package/lib/heartbeat-runner.js

@@ -18,6 +18,16 @@ export function stateFile() {
   return join(dataRoot(), 'heartbeat-state.json');
 }
 
+/**
+ * 账本最多留几条。
+ *
+ * 满了就滚动覆盖最旧的一条 —— **这件事必须让看账本的人知道**。
+ * 否则「账本里多了几条」这个判据在满 50 之后就不成立了：
+ * 总数永远是 50，看起来像停了，其实一直在写。
+ * （这是外面的人真机跑了 40 分钟才发现的。）
+ */
+export const MAX_DECISIONS = 50;
+
 export const EMPTY_STATE = {
   /**
    * 上一次**真正走到判定**的时刻。minGap 用的就是它。
@@ -78,7 +88,7 @@ export function commitDecision(state, decision, now = new Date(), opts = {}) {
   const next = {
     ...state,
     lastTickAt: at,
-    decisions: [...(state.decisions ?? []), entry].slice(-(opts.keepDecisions ?? 50)),
+    decisions: [...(state.decisions ?? []), entry].slice(-(opts.keepDecisions ?? MAX_DECISIONS)),
   };
   // 「被 minGap / 安静时段 / 冷却挡住」的那一跳，只是时钟走了一格，
   // 不说明有过一次「说不说」的机会 —— 所以下面两样都不该动，理由各一条：

package/lib/journal.js

@@ -12,6 +12,7 @@
  * 不发明数据，不评价好坏，不排序打分——账本里记了什么就说什么。
  */
 import { DEFAULTS } from './heartbeat.js';
+import { MAX_DECISIONS } from './heartbeat-runner.js';
 
 /** reason → 一句人话。门控那七种 + 三种"更早就断了"的，一种都不许漏。 */
 export const REASON_TEXT = {
@@ -70,6 +71,19 @@ export function renderJournal(state, opts = {}) {
     );
   }
 
+  // 账本满了要说一声。
+  //
+  // 「看它有没有新记录」这个判据，在满 50 条之后就不成立了：
+  // 总数恒为 50，看起来像停了，其实一直在写。
+  // 不说的话，这就是个假信号——而假信号比没有信号更坏。
+  const maxDecisions = Number(opts.maxDecisions ?? MAX_DECISIONS);
+  if (Number.isFinite(maxDecisions) && ds.length >= maxDecisions) {
+    if (lines.length > 0) lines.push('');
+    lines.push(
+      `（账本记满 ${maxDecisions} 条了，再来一条就挤掉最旧的一条 —— 条数不会再涨，看时间戳。）`,
+    );
+  }
+
   // 连续没开口的次数：这是「沉默」和「坏了」唯一能分开的地方
   const streak = Number(state?.quietStreak ?? 0);
   if (streak > 0) {

package/lib/store.js

@@ -14,7 +14,7 @@
  * 需要的时候再去翻。翻的人知道自己翻的是什么。
  */
 
-import { readdirSync, readFileSync, mkdirSync, writeFileSync, existsSync } from 'node:fs';
+import { readdirSync, readFileSync, mkdirSync, writeFileSync, existsSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { homedir } from 'node:os';
 
@@ -51,9 +51,11 @@ export function listEntries() {
   for (const name of readdirSync(dir)) {
     const m = ID_RE.exec(name);
     if (!m) continue;
+    const p = join(dir, name);
     let title = '';
+    let at = null;
     try {
-      const raw = readFileSync(join(dir, name), 'utf8');
+      const raw = readFileSync(p, 'utf8');
       // 第一个非空行；如果是 `# 标题` 就去掉井号
       for (const line of raw.split(/\r?\n/)) {
         const t = line.trim();
@@ -61,10 +63,20 @@ export function listEntries() {
         title = t.replace(/^#+\s*/, '');
         break;
       }
+      // 写入时刻（mtime）。**这一行是必需的，不是锦上添花。**
+      //
+      // 文件名里的日期只有天粒度，而心跳比较的是「这条什么时候写的」和
+      // 「上次开口是什么时候」——一个天、一个秒。同一天里说过一次话之后，
+      // 当天再写的任何东西，toMs('2026-11-15') 都是当天零点，一律早于
+      // lastSpokeAt，于是全被判成「已经说过了」，那条记忆永远轮不到。
+      //
+      // 这个 bug 的表现和「设计上就该沉默」一模一样，所以它能活到现在。
+      at = statSync(p).mtime.toISOString();
     } catch {
       title = '（读不到）';
+      // at 留 null：素材层会退回去用 date 比。宁可粗略，也不编一个时刻出来。
     }
-    out.push({ id: name.slice(0, -3), date: m[1], slug: m[2], title });
+    out.push({ id: name.slice(0, -3), date: m[1], slug: m[2], title, at });
   }
   out.sort((a, b) => (a.id < b.id ? 1 : a.id > b.id ? -1 : 0));
   return out;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-galatea",
-  "version": "0.4.5",
+  "version": "0.4.6",
   "description": "Galatea — memory, heartbeat and continuity for DeepSeek Harness agents.",
   "repository": {
     "type": "git",