dsh-galatea 0.4.8 → 0.5.0

package/README.md

@@ -13,7 +13,7 @@
 | 块 | 状态 |
 |---|---|
 | 能被 DSH 装起来 | ✅ 实测通过（dsh 0.2.2-rc.3） |
-| 发布到 npm | ✅ 0.4.8（GitHub Actions 自动发，不需要 token） |
+| 发布到 npm | ✅ 0.5.0（GitHub Actions 自动发，不需要 token） |
 | 记忆：读写 Markdown | ✅ 15 条测试 |
 | 记忆：注入索引 | ✅ **已核实内容真的进了上下文**（不是在会话日志里看到「接上了没告警」） |
 | 记忆：`remember` / `recall` | ✅ 23 条测试 |
@@ -203,6 +203,23 @@
 （同理，日志里那句「有素材，这次没掷中」和「记忆里一条都没有」是两件事。
   前者什么都别做，后者去记一条。）
 
+### 它想说的话，劈成两半
+
+每次「该说了」，账本里存两样东西：
+
+```
+15:32　说了　—　太久没开口，这次强制说一句
+　　　本来想说：11 月 14 日 ·「土豆硬是咖喱放早了」
+```
+
+- **say（A）**：能直接说给用户听的那一句。只有日期和标题，**原样引用**。
+- **prompt（B）**：交给下一轮模型的一段指令 ——「这是你自己记下的一件事……要说的话，就围绕它」。它**不是给用户看的文本**。
+
+为什么劈成两半：语气那一半才可能编。事实那一半是结构生成的，
+抄错了随时能对回原条目；而编出来的句子，你没法指出它错在哪 —— 它每一句都像真的。
+
+所以 A 由结构保证，B 只负责怎么说。两样都进账本，能并排看。
+
 ## 四条教训：粒度、上限、旧数据、清理的对象
 
 ### 一 · 天粒度和秒粒度不能比较
@@ -305,7 +322,7 @@ $DSH_HOME/galatea/heartbeat-state.json                      # 心跳状态账本
 ## 本地开发
 
 ```bash
-npm test          # 110 条，不依赖 DSH，纯 node
+npm test          # 116 条，不依赖 DSH，纯 node
 ```
 
 装了之后验证它真的加载了，只看一个东西：
@@ -326,7 +343,7 @@ dsh plugin add dsh-galatea
 或者在 profile 的 `package.json` 里手写：
 
 ```json
-"dependencies": { "dsh-galatea": "0.4.8" }
+"dependencies": { "dsh-galatea": "0.5.0" }
 ```
 
 **版本号钉死，不要写 `^`。** 同一个版本号指向两个不同的包，以后就说不清你装的是哪一份。

package/lib/beat.js

@@ -14,7 +14,7 @@
  *   空话比不说更糟，它消耗的是「它真的在」那点信用。
  */
 import { pickTarget } from './target.js';
-import { pickMaterial, materialPrompt } from './material.js';
+import { pickMaterial, materialPrompt, entryLine } from './material.js';
 import { decide, DEFAULTS } from './heartbeat.js';
 
 /**
@@ -83,6 +83,10 @@ export function planBeat(input) {
     speak: decision.speak,
     reason: decision.reason,
     sessionId: target.sessionId,
+    // A：能直接说给用户听的那一句。只有事实（日期 + 标题），可核对。
+    say: decision.speak ? entryLine(material.entry) : null,
+    // B：交给**下一轮的模型** —— 它读这段，决定怎么说。
+    // 注意 prompt 不是给用户看的文本，两者别混。
     prompt: decision.speak ? materialPrompt(material.entry) : null,
     switched: target.switched,
     previous: target.previous,
@@ -96,6 +100,7 @@ export function planBeat(input) {
       speak: false,
       reason,
       sessionId: extra.sessionId ?? null,
+      say: null,
       prompt: null,
       switched: extra.switched,
       previous: extra.previous,

package/lib/heartbeat-runner.js

@@ -84,6 +84,11 @@ export function commitDecision(state, decision, now = new Date(), opts = {}) {
     speak: decision.speak,
     reason: decision.reason,
     detail: decision.detail,
+    // A：本来要说给用户听的那一句。只有事实（日期 + 标题），可核对。
+    say: decision.say ?? null,
+    // B：交给**下一轮模型**的那段指令 —— 不是给用户看的文本。
+    // 两样都存，才能并排看「它想说什么」和「它打算怎么说」。
+    prompt: decision.prompt ?? null,
   };
   const next = {
     ...state,

package/lib/journal.js

@@ -70,12 +70,15 @@ export function renderJournal(state, opts = {}) {
     // 早退会把 streak 吞掉，而那正是沉默和坏了唯一的分界。
     lines.push('心跳还没有记录过。它至少跑过一次之后，这里才会有东西。');
   } else {
-    lines.push(
-      ...ds
-        .slice(-limit)
-        .reverse()
-        .map((d) => `${clockOf(d.at)}　${d.speak ? '说了' : '没说'}　—　${explain(d.reason)}`),
-    );
+    // 每条决定下面多一行「本来想说什么」。
+    //
+    // say（A）是**事实**：哪天记的、标题是什么，原样引用。
+    // 不印出来，「说了 / 没说」就只是一句判决 ——
+    // 用户看不到它到底想说什么，那和空账本没区别。
+    for (const d of ds.slice(-limit).reverse()) {
+      lines.push(`${clockOf(d.at)}　${d.speak ? '说了' : '没说'}　—　${explain(d.reason)}`);
+      if (d.say) lines.push(`　　　本来想说：${d.say}`);
+    }
   }
 
   // 账本满了要说一声。

package/lib/material.js

@@ -80,3 +80,35 @@ export function materialPrompt(entry) {
     '要说的话，就围绕它。不要复述标题，也不要念稿。',
   ].join('\n');
 }
+
+/**
+ * 日期写成「11 月 14 日」。
+ *
+ * 同时吃 `2026-11-14`（文件名里那种）和完整的 ISO 时刻（mtime 那种）——
+ * 两种在系统里都真实存在，只认一种，另一种就会渲染成半句话。认不出就原样返回，不编。
+ */
+export function shortDate(value) {
+  const s = String(value ?? '');
+  const m = /^(\d{4})-(\d{2})-(\d{2})/.exec(s);
+  if (!m) return s;
+  return `${Number(m[2])} 月 ${Number(m[3])} 日`;
+}
+
+/**
+ * **A：可以原样说给用户听的那一句。**
+ *
+ * 只有事实，没有语气。日期和标题都原样引用，一个字不改。
+ *
+ * 为什么把「说什么」劈成 A 和 B 两半：
+ *
+ *   语气那一半才可能编。事实这一半是结构生成的 —— 抄错了随时能对回原条目，
+ *   而编出来的句子，你没法指出它错在哪（它每一句都像真的）。
+ *
+ *   所以：A 由结构保证，B（materialPrompt，交给下一轮的模型）只负责怎么说。
+ *   两者都进账本，能并排看。
+ */
+export function entryLine(entry) {
+  if (!entry) return null;
+  // 优先用文件名里的天（人读着舒服）；没有就退回 mtime 的 ISO 时刻。
+  return `${shortDate(entry.date ?? entry.at)} ·「${entry.title}」`;
+}

package/package.json

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