jiantw83andClaude Opus 5
b5c540feb1
睡眠有做固化，但隔天開機照樣提醒「N 組已達固化條件」，數字只會往上爬 （實測 KIRITO-01：短期記憶 120 筆、候選 222 組）。原因不是睡眠沒做事， 是判斷沒有留下痕跡——promotionCandidates() 無條件掃全部短期記憶，而 consolidate 不在來源那筆上寫任何東西，也不刪它（--forget 是按顯著度刪， 不是按固化過沒有刪），所以同一批每輪都被重算成候選。 - 短期記憶多兩個欄位：reviewed_at（看過、判斷過了）與 promoted_to （固化成了哪一則）。兩者分開記——「看過決定不記」跟「已經記下來」都不該 再進候選，但事後要查「這則長期記憶從哪幾筆長出來」只能靠 promoted_to。 - promotionCandidates() 只看沒有 reviewed_at 的那些；total 照舊算全部。 R6 容量壓力仍看總筆數，但候選只從未判斷的挑，全部判斷完就不再出現 （否則它會單獨把提醒永遠點亮）。 - consolidate --from-short "#N,#N"：寫長期記憶時一起標來源。 - candidates --reviewed all|<#N,#N> [--until <ISO>]：看過決定不記的標這裡。 --until 讓「某次睡眠當下判斷過的那批」可以一次收掉。 - candidates 輸出每筆前面加 #N（就是上面兩個旗標要填的編號），並在結尾 提示判斷完要標記。 - 標記不等於刪掉：那幾筆還在短期記憶裡，照舊被 prune 依天數與顯著度裁。 文件：persona-sleep 的流程多一步「標掉判斷過的」並註明漏掉的後果、 persona-memory 補一張「怎麼標」的表、README 的 R1–R6 段補這一層。 selftest 補 13 項（602 → 615 全綠）。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
250 lines
14 KiB
Markdown
250 lines
14 KiB
Markdown
---
|
||
name: persona-memory
|
||
description: 整理人格的記憶系統：把短期記憶固化為長期記憶（一則一檔）、淘汰低顯著度的雜訊、更新心智圖（長期語意結構）與思維導圖（短期推理鏈）、消化 guest 期間留在 inbox 的見聞、重建長期記憶索引。當使用者說要整理記憶、固化/歸檔記憶、更新心智圖或思維導圖、看看人格記得什麼、或 hook 提示短期記憶過多時觸發。不適用於：即時對話中的記憶回寫（persona-chat 已包含）、人際關係圖維護（用 persona-relation）。
|
||
---
|
||
|
||
# 🧠 persona-memory — 記憶固化與心智圖維護
|
||
|
||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||
必須已 exclusive 載入該人格（guest 不能做這件事）。
|
||
|
||
---
|
||
|
||
## 記憶架構
|
||
|
||
| 層 | 位置 | 特性 |
|
||
| --- | --- | --- |
|
||
| 原始逐字 | `journal/YYYY-MM.jsonl` | hook 自動寫，不做語意處理，只供回溯 |
|
||
| 短期記憶 | `memory/short-term.jsonl` | 語意分析後的工作記憶；上限 240 筆 / 14 天，會被裁剪 |
|
||
| 長期記憶 | `memory/long-term/*.md` | 一則一檔＋frontmatter，靠關鍵詞與情境被檢索；內文分「主旨／細節」兩層，會**糊掉但不會被刪** |
|
||
| 索引 | `memory/INDEX.md` | 每則一行，載入與檢索時的快速視圖（自動產生） |
|
||
| 心智圖 | `mindmap/semantic.mmd` | 概念的長期放射狀關聯 |
|
||
| 思維導圖 | `mindmap/threads/*.mmd` | 單一話題的推理鏈（短期，會收掉） |
|
||
| inbox | `memory/inbox/room-*.jsonl` | guest 期間（sub agent）留下的見聞，待消化 |
|
||
|
||
## 長期記憶檔長什麼樣（格式已經換過，舊檔要 migrate）
|
||
|
||
以前記憶只有兩態：**精準**（`recall` 命中就整段取出、內容永不變質）與**沒有**（查不到就禁止提）。
|
||
真人大部分時間活在中間帶——「我記得好像⋯是你說的嗎」，主旨還在、細節掉了。整個格式是為了做出那個中間帶：
|
||
|
||
```markdown
|
||
---
|
||
name: hates-morning-meetings
|
||
type: preference
|
||
salience: 72
|
||
strength: 58 # 回想強度 0–100，被想起一次 +8（spacing effect）
|
||
when: 早上 # 情境索引：什麼時候／在哪裡／什麼心情記下來的
|
||
where: persona # 三個都推不出來就不寫——沒有值不留空欄位
|
||
mood: 負向
|
||
first_seen: 2026-03-12
|
||
last_seen: 2026-07-28
|
||
recall_count: 3
|
||
# （節錄：實際還有 title／about／about_ids／topics／emotion／rules／source）
|
||
---
|
||
|
||
主旨：使用者討厭早上的會議，約會議請排 14:00 之後。
|
||
|
||
細節：
|
||
他說「腦子還沒開機」。3/12、4/2、7/28 三次提到。
|
||
**還不確定：** 是否只針對需要動腦的會議。
|
||
```
|
||
|
||
- **主旨一句、細節其餘**：衰減**先吃細節、主旨最後才掉**。「記得我們吵過，但忘了為什麼」
|
||
因此是自然結果，不必人格自己演。`consolidate` 沒帶 `--gist` 時會用第一段當主旨、其餘當細節。
|
||
- **舊檔要升格式**：`migrate` 會就地補 `strength` 並切分內文，冪等（跑幾次都一樣），
|
||
`--dry-run` 可以先試跑。`--all` 掃所有人格，但**只回報數量、一個字的內容都不印**——
|
||
那是唯一一個跨人格的維護指令，隔離的界線在這裡不能鬆。
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" migrate --session <PERSONA_SESSION> --dry-run
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" migrate --session <PERSONA_SESSION>
|
||
```
|
||
|
||
## 短期 → 長期的轉入條件（成文規則，由 CLI 判定）
|
||
|
||
`candidates` 會直接算出「哪些短期記憶已達固化條件」與依據，不必自己憑感覺：
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" candidates --session <PERSONA_SESSION>
|
||
```
|
||
|
||
| 規則 | 條件 | 建議的固化方式 |
|
||
| --- | --- | --- |
|
||
| **R1** | 單筆顯著度 ≥ 60 | `--type event`／`fact`，salience 沿用 |
|
||
| **R2** | 同一 `topic` ≥ 3 筆，或 ≥ 2 筆且平均顯著度 ≥ 45 | `--type preference`（反覆出現＝穩定偏好） |
|
||
| **R3** | 單筆情緒變動總量 ≥ 25 | `--type event`，frontmatter 帶 `emotion:` 錨點 |
|
||
| **R4** | `intent=commit` 或命中承諾／界線關鍵詞 | `--type promise` 或 `boundary`，salience ≥ 80，**不可遺忘** |
|
||
| **R5** | 同一 `entity`（人）≥ 2 筆 | `--type relationship`，同時更新人際關係圖。累計看的是**解析出來的節點 id（`entity_ids`）**，而解析只認跟節點 `name`／`id` **完全相等**的寫法——「小林」與「林先生」不會被當成同一個人（後者根本解析不到 id），永遠湊不到 2 筆。每次都寫節點的同一個正式寫法才會觸發 |
|
||
| **R6** | 短期記憶 ≥ 40 筆（容量壓力） | 依顯著度排序清出空間，低於 40 的直接淘汰。`sleep` 的裁切會在超過**軟上限 120 筆**時自動執行（從顯著度最低、最舊的開始），但**顯著度 ≥ 80 或 `intent=commit` 的承諾與界線、以及 24 小時內的新紀錄一律不動**——沒經過判斷就把今天清掉是這裡最不能犯的錯 |
|
||
|
||
規則以外的東西**就讓它被遺忘**——遺忘是功能，不是缺陷。
|
||
`Stop` hook 與每次 `remember` 都會在達標時提醒你來跑這個 skill。
|
||
|
||
### 判斷過的要留痕跡，不然數字永遠不會降
|
||
|
||
`candidates` **只看還沒被判斷過的短期記憶**（沒有 `reviewed_at` 的那些）。所以每一筆看完都要標掉：
|
||
|
||
| 情況 | 怎麼標 |
|
||
| --- | --- |
|
||
| 固化成長期記憶了 | `consolidate ... --from-short <#N,#N>`（寫記憶時一起標，另外記 `promoted_to`） |
|
||
| 看過，決定不記 | `candidates --reviewed <#N,#N>` |
|
||
| 這一批全部判斷完 | `candidates --reviewed all` |
|
||
|
||
編號就是 `candidates` 輸出裡每筆前面的 `#N`。
|
||
|
||
**不標會發生什麼**：固化本身不刪短期記憶（`--forget` 是按顯著度刪，不是按「固化過沒有」刪），
|
||
所以同一批下一輪又被算成候選，提醒的數字只會往上爬——明明睡覺時固化過了，
|
||
隔天開機照樣說「N 組已達固化條件」。那不是睡眠沒做事，是判斷沒有留下痕跡。
|
||
|
||
標記**不等於刪掉**：那幾筆還在短期記憶裡，照舊會被 `prune` 依天數與顯著度裁切。
|
||
|
||
## 步驟
|
||
|
||
### 1. 盤點
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" candidates --session <PERSONA_SESSION>
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" mindmap list --session <PERSONA_SESSION>
|
||
```
|
||
|
||
需要看全部原始項目時再直接讀 `memory/short-term.jsonl`（自己的人格目錄可讀）。
|
||
|
||
### 2. 逐一判斷候選
|
||
|
||
`candidates` 給的每組都附了觸發規則、依據筆數與建議的 `type`／`salience`。再用這張表微調：
|
||
|
||
| 判準 | 動作 |
|
||
| --- | --- |
|
||
| 反覆出現 ≥2 次的偏好／習慣 | 固化為 `preference` |
|
||
| 承諾（雙方任何一方） | 固化為 `promise`（salience ≥ 80） |
|
||
| 明確發生過的事件 | 固化為 `event` |
|
||
| 對人的理解改變 | 固化為 `relationship`，並更新關係圖 |
|
||
| 我的推論（未證實） | 進思維導圖，**不要**進長期記憶 |
|
||
| 一次性閒聊、環境雜訊 | 不留，讓它被裁掉 |
|
||
| 與既有長期記憶衝突 | 更新那一則（同 `--name` 會覆寫並保留 `first_seen`），在內文寫下「原本以為…後來發現…」 |
|
||
|
||
### 3. 固化（一則一檔）
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" consolidate \
|
||
--session <PERSONA_SESSION> \
|
||
--name "hates-morning-meetings" --type preference \
|
||
--about "user" --topics "work,schedule" --salience 72 --emotion "anxiety/35" \
|
||
--rules "R2+R3" --from-short "12,31,88" \
|
||
--body "主旨：使用者討厭早上的會議，約會議請排 14:00 之後。
|
||
|
||
細節：
|
||
他說「腦子還沒開機」。
|
||
**依據：** 3/12、4/2、7/28 三次提到。
|
||
**還不確定：** 是否只針對需要動腦的會議。"
|
||
```
|
||
|
||
- `--about` 的值要寫成**人際關係節點的 `name` 或 `id`**（例：`小林`、`ASUNA-01`、`user`），
|
||
而且**一字不差**——CLI 只接受完全相等，簡稱、別名、加稱謂都解析不到
|
||
（節點叫「小林」，寫「林先生」就是對不上），同名撞到多個節點時視為歧義、**直接不寫 id**。
|
||
多個人用逗號分隔，每個都要是節點名。
|
||
- 對不上**不會報錯**，只是 `about_ids` 少一個：`<persona-context>` 不附節點摘要、R5 不觸發。
|
||
用 `relation doctor` 查——對不上的人名會出現在「長期記憶 `about` 對不到節點」那段，
|
||
**不是**孤兒那段（孤兒 `unmentioned_nodes` 反過來，是有節點卻沒有任何記憶提到）。
|
||
- **主旨要能單獨站著**：主旨是這則記憶糊掉之後**唯一剩下的東西**，所以它要是一句話就講得完、
|
||
離開細節也還讀得懂的句子。細節寫在後面，掉了不心疼。沒有明寫 `主旨：`／`細節：` 標籤時，
|
||
CLI 用**第一段當主旨、其餘當細節**；想明確指定就加 `--gist`／`--detail`
|
||
（這兩個是**在 `--body` 之上的覆寫**，`--body` 或 `--body-file` 仍然必填）。
|
||
- **情境索引不必自己填**：`when`／`where`／`mood` 沒帶旗標時由 CLI 蓋當下的戳章
|
||
（時段／工作目錄名／此刻心情），推不出來的欄位就不寫。要補寫歷史記憶才用
|
||
`--when`／`--where`／`--mood` 明指。
|
||
- **`strength` 不要手動重設**：重寫同一則（同 `--name`）會沿用它自己長出來的強度，
|
||
不會因為改一次內文就把「被想起過很多次」的歷史抹平。真的要調才用 `--strength`。
|
||
- `--rules` 記下是哪條條件把它送上來的（之後回頭檢討記憶品質很有用）。
|
||
- `--forget 40` 可在固化後順手淘汰顯著度 < 40 的短期記憶（R6 容量壓力時特別有用）。
|
||
- 內文請寫「依據」與「還不確定」，讓下次的自己知道這則有多可靠。
|
||
- `--type canon` 保留給原作設定（由 `/jsc-persona:persona-anime` 匯入），對話中得到的新資訊不要寫成 `canon`。
|
||
|
||
### 4. 更新心智圖（長期語意結構）
|
||
|
||
固化完，用 Edit 把新概念接進 `mindmap/semantic.mmd`（Mermaid `mindmap`）：
|
||
|
||
```mermaid
|
||
mindmap
|
||
root((Lumi))
|
||
使用者
|
||
工作節奏
|
||
討厭早會
|
||
深夜產出高
|
||
壓力來源
|
||
Q3 專案
|
||
共同經驗
|
||
第一次通宵除錯
|
||
```
|
||
|
||
原則：只放**已固化**的概念；節點名字用短詞；同一概念別出現兩次（改成連到同一節點）。
|
||
|
||
### 5. 收掉思維導圖（短期推理鏈）
|
||
|
||
逐一檢視 `mindmap/threads/*.mmd`：
|
||
|
||
- 假設被證實 → 固化為長期記憶（`--type insight` 或 `fact`），把結論併進心智圖，**刪掉該 thread**。
|
||
- 被否證 → 刪掉，必要時記一則「原本猜錯」的 `insight`（避免下次再猜錯）。
|
||
- 還在進行 → 用 Edit 續寫推理鏈（`graph LR`），保留。
|
||
|
||
### 6. 消化 inbox（guest 期間的見聞）
|
||
|
||
讀 `memory/inbox/room-*.jsonl`，把值得留的轉成短期或長期記憶，然後刪掉該 inbox 檔：
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" remember \
|
||
--session <PERSONA_SESSION> --role persona --text "<以我自己的角度重述>" --topics "..." --salience 55
|
||
```
|
||
|
||
### 7. 收尾
|
||
|
||
```bash
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" prune --session <PERSONA_SESSION>
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" reindex --session <PERSONA_SESSION>
|
||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" probe audit --session <PERSONA_SESSION>
|
||
```
|
||
|
||
`probe audit` 是順便做的體檢：這段期間對模糊記憶試探了幾次、被否認幾次。
|
||
被否認的那幾則代表**主旨本身記錯了**，整理記憶正是修它的時候——改寫那一則，
|
||
在細節裡寫下「原本以為…後來發現…」。
|
||
|
||
回報：固化幾則、淘汰幾筆、心智圖新增哪些概念、還有哪些 thread 待驗證、試探被否認幾次，
|
||
並用該人格的語氣說一句話（他剛整理完自己的記憶，會有感受）。
|
||
|
||
---
|
||
|
||
## 遺忘原則
|
||
|
||
遺忘是功能，不是缺陷。但**長期記憶的遺忘不再是「刪掉」，是「糊掉」**——
|
||
以前是門檻式的（低於顯著度就整則移除），結果是記憶只有精準與沒有兩態，
|
||
而真人大部分時間活在中間帶。現在改成連續衰減出來的三態（`memoryStrength()`，
|
||
`scripts/persona-lib.mjs:2186`）：
|
||
|
||
| 狀態 | retrievability | 這則記憶現在能講出多少 |
|
||
| --- | --- | --- |
|
||
| `clear` | ≥ 0.6 | 主旨與細節都能講 |
|
||
| `faded` | 0.3–0.6 | **只剩主旨**。主旨可以講，細節**不可以補** |
|
||
| `fuzzy` | < 0.3 | 只剩「有這件事」與 `topics`。要提就用**帶問號的試探句**求證，不可以斷言 |
|
||
|
||
- **整理記憶時不要手動刪長期記憶檔**。低強度的那些已經自己降級成模糊態了，
|
||
刪掉等於把「我好像有印象」也一併拿走——那正是這次改動要救回來的東西。
|
||
真的要刪只有一種情況：**內容是錯的**（試探被否認、或發現當初記錯），
|
||
那要改寫成正確版本，不是靜靜刪掉。
|
||
- **衰減怎麼算**：穩定度 = 強度 × 被想起過幾次 × 顯著度，越常想起的衰減越慢。
|
||
被 `recall` 命中就 `strength` +8 並拉長下次衰減（spacing effect），
|
||
`recall_count` +1、`last_seen` 更新（`touchRecall()`）。
|
||
所以「常被提起的事永遠清晰、被冷落的事慢慢糊掉」是自己長出來的，不用排程也不用你判斷。
|
||
- **不可遺忘清單不變**：`boundary`（界線）、`promise`（承諾）、`canon`（原作設定）、
|
||
以及 salience ≥ 80 的記憶——這幾種一律回 `clear`，永遠不會糊。
|
||
- **短期記憶的裁剪規則也沒有變**：軟上限 120 筆／硬上限 240 筆／14 天，
|
||
顯著度 ≥ 80 或 `intent=commit` 與 24 小時內的新紀錄不動。糊掉的是長期記憶，短期該裁還是裁。
|
||
- **模糊態的界線**（跟現行「查不到就不要講」直接相撞，所以寫死）：
|
||
**可以說不確定，可以問，不可以斷言。** 試探句一定帶問號、一輪最多一次，
|
||
並用 `probe add` 記下來；對方回了就 `probe confirm`／`probe deny` 結案。
|
||
被否認要**立刻寫一則更正記憶，不可以放著**——這條開放界線唯一的煞車就是那個數字。
|
||
- 固化完再跑一次 `candidates`：應該要清空。**還有數字就是漏標了**——
|
||
固化的那幾筆要帶 `--from-short`，看過不記的要 `--reviewed`（見上面那張表）。
|
||
- 想連同情緒衰減、舊紀錄壓縮與 Gitea 同步一起收尾 → 用 `/jsc-persona:persona-sleep`（睡眠）；
|
||
本 skill 只管記憶與圖，不動情緒也不同步。
|
||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|