feat: 改寫為 Node.js，新增動漫角色建人格、劇場模式與記憶固化條件
腳本全面從 Python 改寫為 Node.js（ESM，只用內建模組，無 npm 依賴）： scripts/persona-lib.mjs（核心）、scripts/persona.mjs（CLI）、hooks/*.mjs（六個 hook）、scripts/selftest.mjs（68 項自我測試，全綠）。 新增： - persona-anime skill：用「動漫作品＋角色名」建立人格，先上網蒐集至少三個獨立 來源的公開設定，映射成 OpenClaw 的 IDENTITY 五欄位與 SOUL 四段落，再固化成 canon 基礎記憶（每則帶來源 URL）＋原作人際關係圖＋依角色型別的情緒基線； 必寫 roleplay-frame 界線記憶（非官方、非本人）。 - 劇場模式：invite 後只顯示人格對話（`名字：內容`）。UserPromptSubmit hook 每輪 注入強制規則、Stop hook 完全靜音，CLI 新增 --quiet 與 room script（乾淨對話稿）。 leave 後沒客人自動關閉，也可用 room theater --on/--off 手動切換。 - 短期→長期記憶的成文轉入條件 R1–R6（promotionCandidates）與 candidates 子指令， hook 在達標時提醒固化；長期記憶新增 canon 型別與 rules 欄位。 - 人格改為「由使用者呼叫才載入」：SessionStart hook 只列出可用人格，不自動附身。 其他：版本號改回 0.0.1；README／AGENTS.md 同步更新。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5
@@ -5,7 +5,7 @@ description: 整理人格的記憶系統：把短期記憶固化為長期記憶
|
||||
|
||||
# 🧠 persona-memory — 記憶固化與心智圖維護
|
||||
|
||||
**CLI**：`python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py"`（帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||||
必須已 exclusive 載入該人格（guest 不能做這件事）。
|
||||
|
||||
---
|
||||
@@ -22,20 +22,40 @@ description: 整理人格的記憶系統：把短期記憶固化為長期記憶
|
||||
| 思維導圖 | `mindmap/threads/*.mmd` | 單一話題的推理鏈（短期，會收掉） |
|
||||
| inbox | `memory/inbox/room-*.jsonl` | guest 期間（sub agent）留下的見聞，待消化 |
|
||||
|
||||
## 短期 → 長期的轉入條件（成文規則，由 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`，同時更新人際關係圖 |
|
||||
| **R6** | 短期記憶 ≥ 40 筆（容量壓力） | 依顯著度排序清出空間，低於 40 的直接淘汰 |
|
||||
|
||||
規則以外的東西**就讓它被遺忘**——遺忘是功能，不是缺陷。
|
||||
`Stop` hook 與每次 `remember` 都會在達標時提醒你來跑這個 skill。
|
||||
|
||||
## 步驟
|
||||
|
||||
### 1. 盤點
|
||||
|
||||
```bash
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" recall --session <PERSONA_SESSION> --query "<主題或空字串>" --limit 10
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" mindmap list --session <PERSONA_SESSION>
|
||||
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`（自己的人格目錄可讀）看全部待處理項目。
|
||||
需要看全部原始項目時再直接讀 `memory/short-term.jsonl`（自己的人格目錄可讀）。
|
||||
|
||||
### 2. 分群 → 決定要固化什麼
|
||||
### 2. 逐一判斷候選
|
||||
|
||||
把短期記憶依 `topics` 分群，逐群判斷：
|
||||
`candidates` 給的每組都附了觸發規則、依據筆數與建議的 `type`／`salience`。再用這張表微調：
|
||||
|
||||
| 判準 | 動作 |
|
||||
| --- | --- |
|
||||
@@ -50,17 +70,20 @@ python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" mindmap list --session <PERSO
|
||||
### 3. 固化（一則一檔）
|
||||
|
||||
```bash
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" consolidate \
|
||||
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" \
|
||||
--body "使用者討厭早上的會議，說「腦子還沒開機」。約會議請排 14:00 之後。
|
||||
**依據：** 3/12、4/2、7/28 三次提到。
|
||||
**還不確定：** 是否只針對需要動腦的會議。"
|
||||
```
|
||||
|
||||
`--forget 40` 可在固化後順手淘汰顯著度 < 40 的短期記憶。
|
||||
內文請寫「依據」與「還不確定」，讓下次的自己知道這則有多可靠。
|
||||
- `--rules` 記下是哪條條件把它送上來的（之後回頭檢討記憶品質很有用）。
|
||||
- `--forget 40` 可在固化後順手淘汰顯著度 < 40 的短期記憶（R6 容量壓力時特別有用）。
|
||||
- 內文請寫「依據」與「還不確定」，讓下次的自己知道這則有多可靠。
|
||||
- `--type canon` 保留給原作設定（由 `/jsc-persona:persona-anime` 匯入），對話中得到的新資訊不要寫成 `canon`。
|
||||
|
||||
### 4. 更新心智圖（長期語意結構）
|
||||
|
||||
@@ -94,15 +117,15 @@ mindmap
|
||||
讀 `memory/inbox/room-*.jsonl`，把值得留的轉成短期或長期記憶，然後刪掉該 inbox 檔：
|
||||
|
||||
```bash
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" remember \
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" remember \
|
||||
--session <PERSONA_SESSION> --role persona --text "<以我自己的角度重述>" --topics "..." --salience 55
|
||||
```
|
||||
|
||||
### 7. 收尾
|
||||
|
||||
```bash
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" prune --session <PERSONA_SESSION>
|
||||
python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" reindex --session <PERSONA_SESSION>
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" prune --session <PERSONA_SESSION>
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" reindex --session <PERSONA_SESSION>
|
||||
```
|
||||
|
||||
回報：固化幾則、淘汰幾筆、心智圖新增哪些概念、還有哪些 thread 待驗證，
|
||||
@@ -115,5 +138,6 @@ python3 "${CLAUDE_PLUGIN_ROOT}/scripts/persona.py" reindex --session <PERSONA_SE
|
||||
- 遺忘是功能，不是缺陷：短期記憶超過 240 筆 / 14 天自動裁剪。
|
||||
- 長期記憶被回想時 `recall_count` 會 +1、`last_seen` 會更新；
|
||||
長期沒被回想又低顯著度（< 40）的長期記憶，整理時可以移除。
|
||||
- **不可遺忘**：`boundary`（界線）、`promise`（承諾）、以及 salience ≥ 80 的記憶。
|
||||
- **不可遺忘**：`boundary`（界線）、`promise`（承諾）、`canon`（原作設定）、以及 salience ≥ 80 的記憶。
|
||||
- 固化完再跑一次 `candidates`：應該要清空（或只剩你刻意不處理的）。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
Reference in New Issue
Block a user