Files

T

jiantw83andClaude Opus 5 603741a4cc 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

5.2 KiB

Raw Blame History

name, description

name	description
persona-status	查看與管理人格的載入狀態：列出所有人格、誰被哪個程序（session/cwd）鎖住、guest 租約、情緒與記憶量，並處理釋放鎖、接手死鎖、清理過期租約，以及設定「開新 session 要自動載入哪個人格」的預設人格。當使用者問哪些人格可用、為什麼載入失敗、人格被誰佔用、想釋放或切換人格、要清理殘留鎖、或說要預設載入某個人格／取消自動載入時觸發。不適用於：建立人格（persona-create）、對話（persona-chat）。

name

description

persona-status

查看與管理人格的載入狀態：列出所有人格、誰被哪個程序（session/cwd）鎖住、guest 租約、情緒與記憶量，並處理釋放鎖、接手死鎖、清理過期租約，以及設定「開新 session 要自動載入哪個人格」的預設人格。當使用者問哪些人格可用、為什麼載入失敗、人格被誰佔用、想釋放或切換人格、要清理殘留鎖、或說要預設載入某個人格／取消自動載入時觸發。不適用於：建立人格（persona-create）、對話（persona-chat）。

🔐 persona-status — 載入狀態與鎖管理

CLI：node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"

鎖的規則（設計上的硬約束）

一個人格同時只能被一個程序 exclusive 載入（鎖 = state/lock.json，以 session_id 為主鍵）。
sub agent 不受限：同一個 session 的 sub agent 沿用同一把鎖；受邀人格（jsc-persona:persona-guest）走 guest 唯讀租約，不佔 exclusive 鎖；睡眠中的人格（jsc-persona:persona-sleeper）走 sleeper 租約（state/sleepers.json，5 分鐘、可寫），同樣不佔 exclusive 鎖——但目標若正被別的程序活鎖住就會拒絕（硬睡會讓記憶互相覆蓋）。
鎖有 15 分鐘租約（heartbeat_at），每輪對話由 hook 自動續租；程序被 kill 後租約到期 → 可被接手。鎖的擁有者是 session 而不是 process：CLI 跑完就結束，所以判定只看心跳，不看 pid。
一個 session 也只能載入一個 host 人格（要換人先 release）。

常用指令

# 全部人格 + 編號 + 鎖狀態 + 記憶量（`⚠ 尚無編號` 表示還沒同步到 Gitea）
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" list

# 這個人格的編號與 Gitea 存取庫
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" code show --session <PERSONA_SESSION>
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sync status --session <PERSONA_SESSION>

# 單一人格的鎖細節（owner session/cwd/心跳、guest 名單、情緒）
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" status --persona <slug>

# 本 session 載入了什麼
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" status --session <PERSONA_SESSION>

# 釋放（含所有 guest 租約）
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" release --session <PERSONA_SESSION>

# 清理死鎖與過期 guest 租約
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" gc

預設人格（開新 session 自動載入）

平常「人格只有使用者叫你載入時才載入」。但使用者可以指定一個預設人格，之後每個新 session 的 SessionStart hook 就會自動載入它——那是他明示的選擇，不是你自己挑的。

# 看目前設定（沒設定就是「開新 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）。

載入失敗怎麼判斷

訊息	意義	處理
`已被另一個程序載入` + 心跳在 15 分鐘內	真的有人在用	不要 takeover。回報 owner 的 session/cwd 與最後心跳，請使用者決定
租約已過期（心跳超過 15 分）	程序異常結束	`load` 會自動接手並回報 `⚠ 這把鎖是接手來的`；請把這句話轉達使用者
想強行接手心跳還活著的鎖	兩邊會互相覆蓋記憶	只有使用者明確要求才加 `--takeover`，並先說明風險
`正以 guest 身分參與另一個 session`	它正在別人的聊天室裡當客人	請那邊先 `leave`，或等 30 分鐘租約過期
`本 session 已載入人格 X`	一程序一人格	先 `release` 再載入
`CLI 的 --session 與本 session 不符`	帶錯 session_id	用上下文 `<persona-runtime>` 裡的 `PERSONA_SESSION=` 值
`禁止跨人格操作` / `跨人格資料隔離`	想碰別的人格	改用 `/jsc-persona:persona-invite`

回報格式

人格倉庫：~/.claude/personas
- 🔒 `lumi`　Lumi（session 4f2a…, cwd ~/work，心跳 12 秒前）｜長期記憶 34｜短期 12
- 🔓 `shen`　Shen　平靜 50／信任 38｜長期記憶 8
- ⚠ `nox`　死鎖可接手（最後心跳 42 分鐘前）

所有面向使用者的輸出使用繁體中文（台灣用語）、UTF-8 無亂碼。

5.2 KiB Raw Blame History Unescape Escape