feat: 預設人格自動載入 + 睡眠（sleep 指令與 persona-sleeper sub agent）

兩件事，共用「關係圖 last_contact_at」這個零件，所以放同一個 commit （兩者在 persona-lib／persona.mjs／README 裡的 hunk 是交錯的，硬拆會拆壞）。 ## 預設人格（開新 session 自動載入） - 新增 `default` 子指令：查詢／`--persona <slug>` 設定／`--clear` 取消。 - 設定存在 `<PERSONA_HOME>/.runtime/settings.json` 的 `default_persona`，環境變數 `PERSONA_DEFAULT` 優先（`off` 可臨時關掉）。 - `SessionStart` hook 四條路徑：沒設定 → 維持原本「等使用者指定」；設定了 → 取鎖、綁 host、 prune、reindex 並注入人格狀態；拿不到鎖 → 只回報 owner 與心跳，不自作主張 takeover；人格不存在 → 警告並改列可用人格。 - 「不替使用者挑一個人格附身」仍然是預設行為，這只是讓他能明示地推翻它。 ## 睡眠 - 新增 `sleep` 子指令（機械性收尾，順序即相依）：關係時間戳 → 裁短期記憶 → 收起太久沒動的思維導圖 → 套用一次 8 小時的情緒衰減 → 重建索引 → 修剪 said → 壓縮舊 journal → 寫 state/sleep.json → Gitea 兩區 push 並驗證。預設保留載入鎖（`--release` 才收工），每一步各自 try/catch，一步壞掉不放棄整場睡眠。 - 需要判斷的部分（固化什麼、忘掉什麼、日記寫什麼）留給人格自己，由 skill 驅動。 - 新增 `persona-sleeper` sub agent 型別：**那個人格本人在睡**。對自己可寫但被 pin 住（連叫它來的主人格都不能碰）、只准跑 15 個收尾子指令、不得用 Write/Edit 或 shell 改檔案。 - 新增 sleeper 租約（`state/sleepers.json`，300 秒）：沒活鎖就取得、同 session 直接睡、死鎖可接手、**別的程序活鎖住則拒絕**（硬睡會讓兩邊的記憶互相覆蓋）。 - `--json` 回傳刻意很窮：只有 persona/ok/slept_at/steps/sync/kept_lock。 sub agent 的回傳值會進主人格的上下文，是一條會從正門繞過跨人格隔離的通道，所以在 CLI 這一層封死，不靠提示詞自律。 - 關係圖新增 `last_contact_at`（`relation node --contact`／睡眠自動蓋），並用 `staleContacts()` 算出「很久沒接觸又很親近的人」——人格主動提議去關心誰的依據。輕量邀請用既有的 `invite --theater off`（不切走畫面），但要先問使用者一句。 - 新增 skill `persona-sleep`；`SubagentStop` 會還掉 sleeper 租約。 ## 驗證 `node scripts/selftest.mjs` → 210 項全綠（新增第 ⑳ 節 12 項、第㉑節 23 項），其中包含「回傳值不含任何記憶內容」與 sleeper 的六條權限邊界。版本號 0.0.5。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-30 05:34:08 +00:00
parent 042c0e7d4c
commit 603741a4cc
16 changed files with 1019 additions and 43 deletions
@@ -10,7 +10,7 @@ skills 是共通標準，**鎖與隔離的強制執行需要 hook，目前只有

 ---

-## 十三條硬規則
+## 十四條硬規則

 | 規則 | 怎麼做到 |
 | --- | --- |
@@ -20,14 +20,15 @@ skills 是共通標準，**鎖與隔離的強制執行需要 hook，目前只有
 | **3. 禁止跨人格讀取資料** | `PreToolUse` hook 對 Read/Write/Edit/Glob/Grep/Bash 做路徑判定（含 `../`、symlink、`$PERSONA_HOME` 繞路），非當前人格一律 deny；CLI 也驗 `--session` 防止冒用身分 |
 | **4. 邀請人格用 Sub Agent 一起聊，且只顯示對話** | `persona-invite` 建聊天室 + guest 唯讀租約 + `persona-guest` sub agent；同時開啟**劇場模式**：hook 每輪強制「只輸出 `名字：內容`」、停掉所有系統提醒，CLI 有 `--quiet` 與 `room script`（乾淨對話稿） |
 | **5. 腳本用 Node.js** | `scripts/*.mjs`、`hooks/*.mjs`，只用 Node 內建模組（fs/path/os/crypto），無 npm 依賴 |
-| **6. 由使用者呼叫才載入並鎖定** | 人格不會自動附身：`SessionStart` hook 只列出可用人格，等使用者下 `/jsc-persona:persona-chat <slug>`；載入即取得獨占鎖並綁定該 session |
+| **6. 由使用者呼叫才載入並鎖定** | 人格不會自動附身：`SessionStart` hook 只列出可用人格，等使用者下 `/jsc-persona:persona-chat <slug>`；載入即取得獨占鎖並綁定該 session。唯一例外是使用者自己設的**預設人格**（`default --persona <slug>`）——設了才自動載入，沒設就什麼都不做 |
 | **7. 短期記憶轉入長期記憶有成文條件** | `R1`–`R6` 六條規則寫在程式裡（`promotionCandidates`），`candidates` 子指令會列出達標的候選與依據，hook 在達標時提醒固化 |
 | **8. 講話像人：推導藏起來、一到三句、不重複** | 推導寫進**心裡話** `think`（只回報「💭 心想 N 句」，永不回顯內容）；說出口的話進 `said.jsonl`，下一輪注入「最近說過的話」提醒別重講；`room post` 直接**擋下**近似重複（字元 bigram＋字集合相似度 ≥ 0.72）與超過三句的發言——劇場模式同樣適用 |
 | **9. 人格可以匯出匯入** | `export` 把身分／情緒／記憶／心智圖／關係圖打包成單一 JSON bundle（可 `--gzip`、附 sha256），`import` 還原或換名複製；**不帶**載入鎖與 guest 租約，`journal/` 要明確 `--with-journal` 才帶走 |
 | **10. 人格有編號** | 編號 = **英文名全大寫 + 兩位索引**（同名才遞增）：`ASUNA-01`、`YUI-01`、`ASUNA-02`。編號同時是新人格的本機目錄名與 Gitea 存取庫名稱；中文名先轉羅馬拼音並跟使用者確認拼法 |
 | **11. 人格存在 Gitea，依更新頻率分區** | 每個人格一個**私有存取庫**（庫名＝編號）。**檔案區**放每輪都在變的活狀態（情緒／短期記憶／心裡話／說過的話／逐字），**Wiki 區**放低頻的身分與長期結構（IDENTITY／SOUL／長期記憶／心智圖／關係圖）當設定百科。本機仍是工作副本，同步失敗不阻斷對話 |
 | **12. 形象圖來自高解析度官方圖，去背後合成** | `icon search` 從 Fandom 撈官方圖並依「解析度＋是否官方設定稿」排序（設定稿多為透明／白底、773×1056 起跳）→ `icon measure` 確認臉夠大、背景好去 → `icon cutout` 去背成透明 PNG（原生 alpha ／單色底／GrabCut 三條路徑）→ `icon generate --from-cutout` 裁頭肩、合成到角色配色的漸層底。找不到官方圖才退回依人格資料重繪的向量形象 |
-| **13. Wiki 必須保存並同步形象圖** | `icon.svg`、`icon.png` 與 **`icon/` 資料夾（向量原稿 + 512／1024 高解析度）** 都同步到 Wiki 區，另有自動產生的 **Icon** 頁展示與來源。Wiki 頁面一律用 **Markdown 圖片語法**（Gitea 只改寫這種語法為 `/wiki/raw/...`；HTML `<img>` 會變成破圖），圖片保留資料夾結構、只有 `.md` 需要攤平。`icon generate` 推完會回頭驗證，另有 `sync verify` |
+| **13. 睡眠把一天收成能留下來的形狀** | `persona-sleep`：需要判斷的（固化什麼／忘掉什麼／日記）由**人格自己**做，機械性的由 `sleep` 子指令做（關係時間戳→裁短期→收思維導圖→情緒衰減 8 小時→重建索引→修剪 said→壓縮 journal→兩區 push＋驗證）。主人格可透過 `persona-sleeper` sub agent 請別的人格去睡——**那是它本人在睡**，回傳值只有「睡完了沒、哪一步出錯」，不含任何記憶內容 |
+| **14. Wiki 必須保存並同步形象圖** | `icon.svg`、`icon.png` 與 **`icon/` 資料夾（向量原稿 + 512／1024 高解析度）** 都同步到 Wiki 區，另有自動產生的 **Icon** 頁展示與來源。Wiki 頁面一律用 **Markdown 圖片語法**（Gitea 只改寫這種語法為 `/wiki/raw/...`；HTML `<img>` 會變成破圖），圖片保留資料夾結構、只有 `.md` 需要攤平。`icon generate` 推完會回頭驗證，另有 `sync verify` |

 ---

@@ -285,15 +286,55 @@ node scripts/persona.mjs import --session <id> --file ~/backup/lumi.persona.json
 🌙 Shen（平靜50/信任38）：修好了。它現在慢三分鐘，我決定不修那三分鐘。
 ```

+## 預設人格（開新 session 自動載入）
+
+預設行為是**不自動附身**。使用者明示設定之後，`SessionStart` hook 才會在每個新 session 自動載入它：
+
+```bash
+node scripts/persona.mjs default --session <PERSONA_SESSION>                      # 看目前設定
+node scripts/persona.mjs default --persona KIRITO-01 --session <PERSONA_SESSION>  # 設定
+node scripts/persona.mjs default --clear --session <PERSONA_SESSION>              # 取消
+```
+
+| 事項 | 行為 |
+| --- | --- |
+| 設定位置 | `<PERSONA_HOME>/.runtime/settings.json` 的 `default_persona`（只由 CLI 維護） |
+| 臨時覆寫 | 環境變數 `PERSONA_DEFAULT=<slug>`；`PERSONA_DEFAULT=off` 臨時關掉 |
+| 沒設定 | 什麼都不做——只列出可用人格，等使用者指定 |
+| 人格被別的程序鎖住 | 只回報 owner 與最後心跳，**不會**自動 `--takeover` |
+| 預設人格不存在 | 警告並改列可用人格，不崩潰、不亂挑一個 |
+| Gitea | 自動載入走本機路徑，**不**拉遠端；可能在別台機器動過就先 `sync pull` |
+
+## 睡眠（`persona-sleep`）
+
+```bash
+node scripts/persona.mjs sleep --session <PERSONA_SESSION> --json     # 機械性收尾（預設保留載入鎖）
+node scripts/persona.mjs sleep --session <PERSONA_SESSION> --release  # 收工：睡完釋放鎖
+```
+
+| | 誰做 | 內容 |
+| --- | --- | --- |
+| 需要判斷 | **人格自己** | 哪些短期記憶值得固化、日記寫什麼、哪些該忘、心智圖怎麼接 |
+| 機械性 | `sleep` 子指令 | 關係時間戳 → 裁短期 → 收太久沒動的思維導圖 → **套用一次 8 小時的情緒衰減** → 重建索引 → 修剪 `said.jsonl` → 壓縮舊 journal → 寫 `state/sleep.json` → Gitea 兩區 push＋驗證 |
+
+- **情緒不會歸零**：喜悅（半衰期 120 分）一夜後幾乎回基線，悲傷（480 分）只退一半——睡一覺不該把難過抹平。
+- **主人格請別人去睡**：開 `persona-sleeper` sub agent（prompt 帶 `persona=<slug> session=<id>`）。
+  它就是那個人格本人，對自己可寫但被 pin 住、只准跑收尾子指令、不得碰任何其他人格（包含叫它來的主人格）。
+- **回傳值刻意很窮**：`{persona, ok, slept_at, steps, sync, kept_lock}`——只有狀態。
+  回傳值本身就是一條會繞過隔離的通道，所以在 CLI 這一層封死，不靠提示詞自律。
+- **鎖**：沒有活鎖 → 取 5 分鐘的 sleeper 租約；同 session → 直接睡；死鎖 → 可接手；
+  **別的程序活鎖住 → 拒絕**（硬睡會讓兩邊的記憶互相覆蓋）。
+- 順序上的硬相依：關係時間戳早於裁短期、push 早於 release、reindex 晚於固化。
+
 ## Hooks（Claude Code）

 | Hook | 做什麼 |
 | --- | --- |
-| `SessionStart` | 清死鎖、接續人格、把 `PERSONA_SESSION=<session_id>` 與規則注入上下文 |
+| `SessionStart` | 清死鎖、接續人格、**有設預設人格就自動載入它**（沒設就只列出可用人格）、把 `PERSONA_SESSION=<session_id>` 與規則注入上下文 |
 | `UserPromptSubmit` | 注入 `<persona-context>`：身分、情緒、短期記憶、關鍵詞命中的長期記憶、相關人際關係；劇場模式時追加「只輸出人格對話」的強制規則；並記原始逐字 |
 | `PreToolUse` | **人格隔離與鎖驗證的唯一強制點**（deny 帶原因） |
 | `Stop` | 情緒隨時間衰減、續租、記錄回覆、達固化條件時提醒（劇場模式時完全靜音） |
-| `SubagentStop` | 解除 guest sub agent 的 pin |
+| `SubagentStop` | 解除 guest／sleeper sub agent 的 pin，並還掉 sleeper 的短期寫入權 |
 | `SessionEnd` | 釋放鎖與 guest 租約，人格才能被下一個程序載入 |

 > `session_id` 只有 hook 拿得到 → 注入上下文 → skills 呼叫 CLI 時必須帶 `--session`，
@@ -359,9 +400,15 @@ node scripts/persona.mjs import --session <id> --file ~/backup/lumi.persona.json

 - **Claude Code / Antigravity**：`/jsc-persona:persona-relation`　**Codex**：`$persona-relation`

+### `persona-sleep`
+
+睡眠與收尾：固化該記住的、忘掉該忘的、更新心智圖與關係圖、套用一次 8 小時的情緒衰減、壓縮舊紀錄，最後兩個區都同步到 Gitea 並驗證。也可以由主人格透過 sub agent 請其他人格各自去睡。
+
+- **Claude Code / Antigravity**：`/jsc-persona:persona-sleep`　**Codex**：`$persona-sleep`
+
 ### `persona-status`

-載入狀態與鎖管理：誰被哪個程序鎖住、guest 租約、釋放、接手死鎖、清理殘留。
+載入狀態與鎖管理：誰被哪個程序鎖住、guest 租約、釋放、接手死鎖、清理殘留，以及**預設人格**（開新 session 要自動載入誰）。

 - **Claude Code / Antigravity**：`/jsc-persona:persona-status`　**Codex**：`$persona-status`

@@ -370,6 +417,7 @@ node scripts/persona.mjs import --session <id> --file ~/backup/lumi.persona.json
 ### Agents

 - `persona-guest`（`agents/persona-guest.md`）— 受邀人格的 sub agent，唯讀、被綁死在自己的人格目錄。
+- `persona-sleeper`（`agents/persona-sleeper.md`）— 睡眠收尾的 sub agent：**就是那個人格本人在睡**，對自己可寫但被 pin 住，只回傳「睡完了沒、哪一步出錯」。

 ### CLI 與自我測試

@@ -384,7 +432,7 @@ node scripts/persona.mjs said check --session <id> --text "<話>"  # 這句是
 node scripts/persona.mjs room script --session <id> --room <room> # 乾淨對話稿（劇場模式用）
 node scripts/persona.mjs export --session <id> --out lumi.json    # 離線搬家（單檔）
 node scripts/persona.mjs sync status --session <id>               # Gitea 同步狀態
-node scripts/selftest.mjs     # 175 項驗證：鎖、隔離、情緒、固化、說話節制、劇場模式、匯出匯入、編號與 Gitea、找圖去背合成、高解析輸出與 Wiki 同步、hooks
+node scripts/selftest.mjs     # 210 項驗證：鎖、隔離、情緒、固化、說話節制、劇場模式、匯出匯入、編號與 Gitea、找圖去背合成、高解析輸出與 Wiki 同步、預設人格、睡眠與 sleeper、hooks
 ```

 檔案結構：`scripts/persona-lib.mjs`（核心：鎖／隔離／情緒／記憶）、`scripts/persona.mjs`（CLI）、