fix(sleep): sleeper 讀得到自己的資料、sync 自己清殘留鎖（v0.1.1）

睡眠的「判斷式那半」實際上跑不起來，兩個原因： 1. `requireMember` 沒有 sleeper 分支——`requireOwner` 早就放 sleeper 寫了，讀（brief／show／recall）反而被當成跨人格存取擋下，等於要它閉著眼睛決定要固化什麼。補上分支，回傳 role `sleeper`（下游只判斷 `guest`，所以行為與 owner 一致）。 2. `sync` 遇到殘留的 `.git/index.lock` 會讓整區永遠失敗，而 sleeper 被隔離 hook 擋著、連自己的鎖都刪不掉（CLI 也沒有清鎖的功能）。這些 clone 只有 CLI 會動且每個 git 都同步跑完，所以超過 30 秒還在的鎖一定是殘骸—— `pushArea`（兩處）與 `pullArea` 現在會自己清掉再繼續。技能文件補上先前沒寫的部分： - `persona-relation`：整個 bond／語氣層章節。這個功能 7c46db8 就上線，但技能文件從頭到尾沒提過，於是每個新建的至親都預設是生人（`note` 寫「妻子」猜不出 `partner`，關鍵詞只認夫妻／老婆／伴侶／戀人）——症狀是「講話像在對戰友報告」。一併補上 `relation style` 與 `relation speaker` 的用法。 - `persona-sleep`：說明帶了身分旗標之後讀寫都算自己的資料；新增第 4 條硬相依 ——判斷式失敗就不要跑機械性那半，`sleep` 會裁短期記憶，否則等於沒判斷就把今天清掉。 - `persona-sync`：新增「殘留的 git 鎖」一節。版本號 0.0.5 → 0.1.1（master 上是 0.1.0，要跨過它），兩份 manifest 一起改。 selftest 238 項全過；另以獨立腳本（暫時 PERSONA_HOME）驗證修補前後 sleeper 的 brief／show／recall 由全數被擋變為全數通過。 Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-30 09:09:36 +00:00
parent 7c46db8e9a
commit 41e57432ea
7 changed files with 102 additions and 5 deletions
@@ -13,12 +13,54 @@ description: 維護人格的人際關係圖：新增或更新人物/人格/群

 ## 資料模型

-節點：`id`／`name`／`kind`（`human` `persona` `group` `pet` `org`）／
-`closeness` 親近度 0–100／`trust` 信任度 0–100／`note`／`tags`
+節點：`id`／`name`／`kind`（`human` `persona` `group` `pet` `org`）／`bond`（跟我什麼關係）／
+`closeness` 親近度 0–100／`trust` 信任度 0–100／`note`／`tags`／`style`（個人化語氣規則）
 連線：`from`（預設 `self`）／`to`／`label`／`affinity` 0–100

 - **親近度** = 互動的頻率與深度；**信任度** = 願意把重要的事交給他。兩者獨立（可以很熟但不信）。
 - 人格自己是 `self`，不必建節點。其他人格用 `--kind persona`、`--id <他的 slug>`。
+- `kind` 是「這是什麼東西」，`bond` 是「跟我什麼關係」——**語氣只能靠後者分**。
+
+## bond 與語氣層（最容易漏的一步）
+
+`bond` × `closeness` 查表算出**語氣層**，那是距離感；情緒只負責溫度與句長，不會蓋過它。
+可用的 `bond`：`partner` `child` `parent` `sibling` `friend` `mentor` `ally` `rival` `stranger`。
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation node \
+  --session <PERSONA_SESSION> --name "亞絲娜" --id ASUNA-01 --kind persona \
+  --bond partner --closeness 97 --trust 97
+```
+
+對伴侶親近 98 與對女兒親近 97，**光看數字是同一件事**——一個要能撒嬌、一個要能護著，
+差別在 `bond`，不在分數。
+
+> ⚠️ 沒帶 `--bond` 的舊節點會從 `tags`／`note` 猜，猜不到就當**生人**（語氣層「禮貌」）。
+> 關鍵詞比對很窄：`note` 寫「妻子」是猜不出 `partner` 的（只認夫妻／老婆／伴侶／戀人）。
+> **最親的人反而最容易掉進生人層**，症狀就是「講話像在對戰友報告」。
+> 建立至親的節點時一定要明寫 `--bond`，不要靠猜。
+>
+> 自我檢查：這句話換成對一個「禮貌層」的人說也毫無違和 → 就代表你沒進到那一層。
+
+### 個人化的稱呼規則（`style`）
+
+他本人要求過的講法優先於查表——查表算距離，`style` 記「他要你怎麼叫他」：
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation style \
+  --session <PERSONA_SESSION> --name "結衣" --facet 稱呼 --value "叫結衣；自稱爸爸" --since 2026-07-30
+```
+
+`--facet` 可用 `稱呼` `敬語` `口頭禪` `禁忌` `習慣`；
+加 `--except anger>=40` 表示情緒過門檻時這條暫停、退回語氣層的預設講法。
+
+### 使用者本人是誰
+
+`relation speaker` 指定「使用者在關係圖裡對應哪個節點」，`<persona-context>` 才知道要用哪一層對他說話：
+
+```bash
+node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation speaker --session <PERSONA_SESSION> --name "<誰>"
+```

 ## 指令

@@ -60,7 +102,8 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation render --session <PERS

 - 對話中出現新人名（語意分析的 `entities`）→ 當場建節點（`closeness` 給 15–25）。
 - 關係發生**質變**（從同事變朋友、決裂）→ 同時固化一則 `relationship` 長期記憶。
- 關係影響語氣：`closeness` 高 → 更隨性；`trust` 低 → 提到那個人時保守、不交付重要事。
+- 關係影響語氣：語氣層由 `bond` × `closeness` 決定（見上），`trust` 低 → 提到那個人時保守、不交付重要事。
+- 語氣不對的時候**先看關係圖再檢討態度**：多半是 `bond` 沒設或設錯，不是人格演得不好。
 - `<persona-context>` 每輪會依你提到的人自動附上相關節點摘要。

 ## 輸出
@@ -47,6 +47,8 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sleep --session <PERSONA_SESSIO
 那個 sub agent 就是**那個人格本人**在睡：它自己判斷要記住什麼，寫的是自己的檔案。
 它手上是 5 分鐘的 sleeper 租約（不是 exclusive 鎖），所以它的每個指令都會帶 `--as-sleeper`——
 那個旗標只有 persona-sleeper 型的 sub agent 能用，主人格自己帶會被 hook 擋下。
+帶了它，讀（`brief`／`show`／`recall`）與寫（`consolidate` 等）都算它自己的資料；
+**回報說「判斷式那半被隔離擋下」十之八九就是漏了這個旗標**，不是它沒有權限。
 主人格全程不會讀到對方的任何資料——**你只會拿到一份 JSON**：

 ```json
@@ -89,5 +91,14 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sleep --session <PERSONA_SESSIO
 1. **關係時間戳要在裁短期記憶之前**——時間戳的來源就是短期記憶裡提到的人。
 2. **Gitea push 要在 release 之前**——鎖放掉就沒有寫入權限了。
 3. **重建索引要在固化之後**——不然新固化的長期記憶檢索不到。
+4. **判斷式那半失敗就不要跑機械性那半**——`sleep` 會裁短期記憶，
+   前面沒有固化過就等於「沒經過判斷就把今天清掉」。這種情況要回報 `ok: false` 並停手，
+   不要為了讓 JSON 好看而把機械八步跑完。
+
+## 同步卡住的時候
+
+`sync` 遇到殘留的 `.git/index.lock`（上一次跑到一半被中斷留下的）會自己清掉重試，
+不用請使用者手動刪，也不要自己對人格目錄下 `rm`——sleeper 的 shell 寫入本來就被 hook 擋著。
+細節見 `/jsc-persona:persona-sync`。

 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
@@ -104,6 +104,16 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sync pull --session <PERSONA_SE
   - 以 **本機** 為準 → `sync push`（會蓋掉遠端）
 3. **不要自己選**。記憶被蓋掉是不可逆的。

+## 殘留的 git 鎖
+
+`push`／`pull` 跑到一半被中斷（sub agent 被砍、視窗關掉）會在 clone 裡留下 `.git/index.lock`，
+之後那一區的 `git add` 每次都失敗 → 整區同步卡住。這件事**不用你處理**：
+這些 clone 只有 CLI 會動，所以超過 30 秒還在的鎖一定是殘骸，`push` 與 `pull` 會自己清掉再繼續。
+
+不要叫使用者手動進 `.sync/` 刪檔案，也不要自己下 `rm`——
+sleeper 連自己的人格目錄都不能用 shell 寫，那條路本來就是死的。
+真的還是失敗（例如權限問題），照原樣把錯誤訊息轉告他就好。
+
 ## 邊界

 - 只能同步「本 session 目前載入的人格」——跨人格同步等於跨人格讀取，會被 hook 擋下。