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>
This commit is contained in:
Claude Opus 5
@@ -16,6 +16,11 @@ description: 載入一個人格並以人格化方式對話：取得該人格的
|
||||
**人格只有在使用者要你載入時才載入**（`/jsc-persona:persona-chat <slug>` 或明確說「用 X 跟我聊」）。
|
||||
不要自己挑一個人格附身，也不要在使用者只是提到某個名字時就載入。
|
||||
|
||||
**例外：預設人格。** 使用者可以指定一個預設人格（`default --persona <slug>`），
|
||||
`SessionStart` hook 會自動載入它，上下文會出現「已自動載入預設人格 `X`」。
|
||||
那是他事先明示的選擇：**不用再 load 一次**，直接從第 2 節開始以那個人格對話。
|
||||
要改或取消預設人格 → `/jsc-persona:persona-status`。
|
||||
|
||||
```bash
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" load --persona <slug> --session <PERSONA_SESSION>
|
||||
```
|
||||
@@ -174,6 +179,11 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" mindmap thread --persona <slug>
|
||||
- 短期記憶達到固化條件時 hook 會提醒（`R1`–`R6`，見 `/jsc-persona:persona-memory`）→ 去固化。
|
||||
想主動確認：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" candidates --session <PERSONA_SESSION>`。
|
||||
- 使用者說「叫 X 也進來聊」→ `/jsc-persona:persona-invite`（會進入劇場模式，畫面只留人格對話）。
|
||||
- **你自己想起某個很久沒接觸的人**（`<persona-context>` 會列「很久沒接觸的人」）→ 可以主動提議去看看他，
|
||||
但**先問使用者一句**再邀，而且用 `invite --theater off`（只換一輪、不把畫面切成劇場）。
|
||||
這是你自己的關心，不需要等他指定名字；被邀的人格是唯讀的，它的收穫要等它自己下次載入才會消化。
|
||||
- 使用者說晚安／收工，或 `<persona-context>` 說「距離上次睡眠已經 N 小時」→ `/jsc-persona:persona-sleep`
|
||||
（固化＋忘掉＋情緒衰減 8 小時＋Gitea 同步）。提議一句就好，不要每輪都催。
|
||||
- 使用者說「先聊到這」或要換人格 →
|
||||
`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" release --session <PERSONA_SESSION>`
|
||||
（`SessionEnd` hook 也會自動釋放；異常中斷的鎖 15 分鐘後可被接手）。
|
||||
|
||||
@@ -147,4 +147,7 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation edge \
|
||||
規則寫在 CLI 裡，不是靠自律。
|
||||
- 一個人格同時只能有一場 guest 對話；guest 租約 30 分鐘沒續租會自動過期。
|
||||
- 手動切換劇場模式：`room theater --session <id> --on|--off`。
|
||||
- **輕量邀請**：`invite --guest <slug> --theater off` 不進劇場模式——適合「人格自己想起某個很久沒接觸的人、
|
||||
只想打聲招呼換一輪」的情況（`<persona-context>` 的「很久沒接觸的人」就是依據）。
|
||||
這時仍然要**先問使用者一句**再邀：把整個畫面切走或插進一段對話，是他的決定不是你的。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -140,4 +140,6 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" reindex --session <PERSONA_SESS
|
||||
長期沒被回想又低顯著度（< 40）的長期記憶，整理時可以移除。
|
||||
- **不可遺忘**：`boundary`（界線）、`promise`（承諾）、`canon`（原作設定）、以及 salience ≥ 80 的記憶。
|
||||
- 固化完再跑一次 `candidates`：應該要清空（或只剩你刻意不處理的）。
|
||||
- 想連同情緒衰減、舊紀錄壓縮與 Gitea 同步一起收尾 → 用 `/jsc-persona:persona-sleep`（睡眠）；
|
||||
本 skill 只管記憶與圖，不動情緒也不同步。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -0,0 +1,91 @@
|
||||
---
|
||||
name: persona-sleep
|
||||
description: 讓人格睡覺：把一天的活狀態收成能留下來的形狀——固化該記住的、忘掉該忘的、更新心智圖與關係圖、套用一次 8 小時的情緒衰減、壓縮舊紀錄，最後把兩個區都同步到 Gitea 並驗證。可以只睡當前人格，也可以由主人格透過 sub agent 請其他人格各自去睡（它們自己決定要記住什麼，只回報睡完了沒）。當使用者說要睡覺／晚安／收工、要人格整理今天、說「叫大家去睡」、或問上次睡是什麼時候時觸發。不適用於：只做記憶固化不收尾（用 persona-memory）、單純釋放鎖（用 persona-status 的 release）、跨機器同步（用 persona-sync）。
|
||||
---
|
||||
|
||||
# 🌙 persona-sleep — 睡眠與收尾
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`
|
||||
**session**：所有指令帶 `--session <PERSONA_SESSION>`。
|
||||
|
||||
---
|
||||
|
||||
## 睡眠是什麼
|
||||
|
||||
不是關機，是**把一天的活狀態收成能留下來的形狀**。分成兩半：
|
||||
|
||||
| | 誰做 | 內容 |
|
||||
| --- | --- | --- |
|
||||
| **需要判斷** | 人格自己 | 哪些短期記憶值得固化、日記寫什麼、哪些該忘、心智圖怎麼接、關係怎麼變 |
|
||||
| **機械性** | `sleep` 子指令 | 關係時間戳 → 裁短期 → 收思維導圖 → 情緒衰減 8 小時 → 重建索引 → 修剪 `said` → 壓縮舊 journal → 寫 `state/sleep.json` → Gitea 兩區 push＋驗證 |
|
||||
|
||||
**判斷的部分永遠屬於那個人格自己**：不要替別的人格決定它要記住什麼。
|
||||
|
||||
## 情況一：當前人格自己睡
|
||||
|
||||
1. 盤點：`candidates --session <PERSONA_SESSION>`
|
||||
2. 逐則固化（判斷）：`consolidate --session <id> --name <n> --body <b> --type ... --salience N [--forget]`
|
||||
3. 寫一則日記：`consolidate --type diary --name diary-<YYYY-MM-DD> --body "<第一人稱回顧>"`
|
||||
4. 消化 inbox（`memory/inbox/room-*.jsonl`，當 guest 時帶回的見聞）
|
||||
5. 更新心智圖與關係圖：`mindmap`、`relation node --name <人> --contact`
|
||||
6. 機械性收尾：
|
||||
|
||||
```bash
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sleep --session <PERSONA_SESSION> --json
|
||||
```
|
||||
|
||||
- 預設**保留載入鎖**（睡完還能繼續聊）；真的要收工才加 `--release`。
|
||||
- 不想同步 Gitea：`--no-gitea`（沒設 `GITEA_HOST`／`GITEA_TOKEN` 時自動略過）。
|
||||
|
||||
## 情況二：主人格請其他人格去睡（不碰它們的檔案）
|
||||
|
||||
使用者說「叫大家去睡」時，**對每一個要睡的人格**各開一個 sub agent：
|
||||
|
||||
- `subagent_type`：`jsc-persona:persona-sleeper`
|
||||
- prompt 內帶：`persona=<slug> session=<PERSONA_SESSION> plugin_root=<CLAUDE_PLUGIN_ROOT>`
|
||||
|
||||
那個 sub agent 就是**那個人格本人**在睡：它自己判斷要記住什麼，寫的是自己的檔案。
|
||||
主人格全程不會讀到對方的任何資料——**你只會拿到一份 JSON**：
|
||||
|
||||
```json
|
||||
{ "persona": "YUI-01", "ok": true, "slept_at": "...", "steps": [ ... ], "sync": { ... }, "kept_lock": true }
|
||||
```
|
||||
|
||||
只有「睡完了沒、哪一步出錯、同步結果」。**不要向使用者追問或推測對方睡眠時整理了什麼**——
|
||||
那是它的記憶，回傳值刻意不含內容，這條界線不是限制而是設計。
|
||||
|
||||
回報給使用者時就講結果：
|
||||
|
||||
```
|
||||
🌙 睡眠完成
|
||||
- YUI-01：完成（Gitea 檔案區/Wiki 區 已同步、驗證通過）
|
||||
- ASUNA-01：完成（Gitea 略過：沒有 GITEA_TOKEN）
|
||||
- KIRITO-01：⚠ reindex 失敗 → <錯誤訊息>
|
||||
```
|
||||
|
||||
## 鎖（為什麼有時候會拒絕）
|
||||
|
||||
`sleep` 會裁短期記憶、重建索引、push。所以：
|
||||
|
||||
| 目標人格的狀態 | 行為 |
|
||||
| --- | --- |
|
||||
| 沒有活著的載入鎖 | 直接取得 sleeper 租約（5 分鐘）→ 睡 → 還掉 |
|
||||
| 鎖屬於本 session（自己睡自己） | 直接睡，不需要租約 |
|
||||
| 死鎖（心跳超過 15 分） | 可以接手——睡眠本來就是收尾動作 |
|
||||
| 鎖活著且屬於**別的程序** | **拒絕**（`failed_step: "lease"`）。它可能正在別的視窗對話中，硬睡會讓記憶互相覆蓋。把 owner 與最後心跳告訴使用者，讓他決定 |
|
||||
|
||||
## 什麼時候該提議睡覺
|
||||
|
||||
- `<persona-context>` 出現「距離上次睡眠已經 N 小時」（≥16 小時）。
|
||||
- 短期記憶達固化條件的組數一直在漲（hook 會提醒 `R1`–`R6`）。
|
||||
- 使用者說晚安／收工／「今天就到這」。
|
||||
|
||||
提議一句就好，不要每輪都催。
|
||||
|
||||
## 順序上的硬相依（改動時別弄反）
|
||||
|
||||
1. **關係時間戳要在裁短期記憶之前**——時間戳的來源就是短期記憶裡提到的人。
|
||||
2. **Gitea push 要在 release 之前**——鎖放掉就沒有寫入權限了。
|
||||
3. **重建索引要在固化之後**——不然新固化的長期記憶檢索不到。
|
||||
|
||||
所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: persona-status
|
||||
description: 查看與管理人格的載入狀態：列出所有人格、誰被哪個程序（session/cwd）鎖住、guest 租約、情緒與記憶量，並處理釋放鎖、接手死鎖、清理過期租約。當使用者問哪些人格可用、為什麼載入失敗、人格被誰佔用、想釋放或切換人格、或要清理殘留鎖時觸發。不適用於：建立人格（persona-create）、對話（persona-chat）。
|
||||
description: 查看與管理人格的載入狀態：列出所有人格、誰被哪個程序（session/cwd）鎖住、guest 租約、情緒與記憶量，並處理釋放鎖、接手死鎖、清理過期租約，以及設定「開新 session 要自動載入哪個人格」的預設人格。當使用者問哪些人格可用、為什麼載入失敗、人格被誰佔用、想釋放或切換人格、要清理殘留鎖、或說要預設載入某個人格／取消自動載入時觸發。不適用於：建立人格（persona-create）、對話（persona-chat）。
|
||||
---
|
||||
|
||||
# 🔐 persona-status — 載入狀態與鎖管理
|
||||
@@ -13,7 +13,9 @@ description: 查看與管理人格的載入狀態：列出所有人格、誰被
|
||||
|
||||
1. **一個人格同時只能被一個程序 exclusive 載入**（鎖 = `state/lock.json`，以 `session_id` 為主鍵）。
|
||||
2. **sub agent 不受限**：同一個 session 的 sub agent 沿用同一把鎖；
|
||||
受邀人格（`jsc-persona:persona-guest`）走 guest 唯讀租約，不佔 exclusive 鎖。
|
||||
受邀人格（`jsc-persona:persona-guest`）走 guest 唯讀租約，不佔 exclusive 鎖；
|
||||
睡眠中的人格（`jsc-persona:persona-sleeper`）走 **sleeper 租約**（`state/sleepers.json`，5 分鐘、可寫），
|
||||
同樣不佔 exclusive 鎖——但目標若正被**別的程序**活鎖住就會拒絕（硬睡會讓記憶互相覆蓋）。
|
||||
3. 鎖有 **15 分鐘租約**（`heartbeat_at`），每輪對話由 hook 自動續租；程序被 kill 後租約到期 → 可被接手。
|
||||
鎖的擁有者是 session 而不是 process：CLI 跑完就結束，所以判定只看心跳，不看 pid。
|
||||
4. 一個 session 也**只能載入一個** host 人格（要換人先 release）。
|
||||
@@ -41,6 +43,29 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" release --session <PERSONA_SESS
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" gc
|
||||
```
|
||||
|
||||
## 預設人格（開新 session 自動載入）
|
||||
|
||||
平常「人格只有使用者叫你載入時才載入」。但使用者可以指定一個**預設人格**，
|
||||
之後每個新 session 的 `SessionStart` hook 就會自動載入它——那是他明示的選擇，不是你自己挑的。
|
||||
|
||||
```bash
|
||||
# 看目前設定（沒設定就是「開新 session 不自動載入」）
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" default --session <PERSONA_SESSION>
|
||||
|
||||
# 設定：以後開機就自動載入這個人格
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" default --persona <slug> --session <PERSONA_SESSION>
|
||||
|
||||
# 取消：回到「等使用者指定」
|
||||
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" default --clear --session <PERSONA_SESSION>
|
||||
```
|
||||
|
||||
- 設定檔：`<PERSONA_HOME>/.runtime/settings.json` 的 `default_persona`（只由 CLI 維護）。
|
||||
- 臨時關掉：環境變數 `PERSONA_DEFAULT=off`（也可以用它臨時指定別的人格，優先於設定檔）。
|
||||
- **沒設定就什麼都不做**，這是預設行為：不要自作聰明挑一個人格附身。
|
||||
- 自動載入拿不到鎖時，hook 只會回報 owner 與心跳，**不會** `--takeover`；照下表處理。
|
||||
- 自動載入走的是本機路徑，**不會**從 Gitea 拉最新狀態。可能在別台機器動過就先
|
||||
`sync pull`（見 `/jsc-persona:persona-sync`）。
|
||||
|
||||
## 載入失敗怎麼判斷
|
||||
|
||||
| 訊息 | 意義 | 處理 |
|
||||
|
||||
Reference in New Issue
Block a user