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>

.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc-persona",
-  "version": "0.0.5",
+  "version": "0.1.1",
   "description": "AI 人格化記憶聊天 plugin：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）。於 Claude Code 以 /jsc-persona: 前綴呼叫。",
   "skills": "./skills",
   "author": {

plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "jsc-persona",
-  "version": "0.0.5",
+  "version": "0.1.1",
   "description": "AI 人格化記憶聊天 plugin：OpenClaw 相同的人格描述 + 十二情緒 + 語意分析 + 短期/長期記憶 + 心智圖 + 人際關係圖。於 Antigravity 以 /jsc-persona: 前綴呼叫。",
   "skills": "./skills/"
 }

scripts/persona-gitea.mjs

@@ -258,6 +258,29 @@ function gitOrThrow(args, cwd, what) {
   return res;
 }
 
+// 這些 clone 只有本 CLI 會動，而且每個 git 都是同步跑完才回來，所以一個超過
+// STALE_LOCK_SECONDS 還在的 index.lock 一定是上一次跑到一半被砍掉留下的殘骸。
+// 不自己清的話整區會一直失敗，而 sleeper 被隔離 hook 擋著、連自己的鎖都刪不掉。
+const STALE_LOCK_SECONDS = 30;
+
+export function clearStaleIndexLock(dir) {
+  const lock = path.join(dir, ".git", "index.lock");
+  let stat;
+  try {
+    stat = fs.statSync(lock);
+  } catch {
+    return null;
+  }
+  const ageSeconds = (Date.now() - stat.mtimeMs) / 1000;
+  if (ageSeconds < STALE_LOCK_SECONDS) return null;
+  try {
+    fs.rmSync(lock);
+  } catch (err) {
+    return { cleared: false, ageSeconds, reason: String(err.message || err) };
+  }
+  return { cleared: true, ageSeconds };
+}
+
 /** 確保 `<persona>/.sync/<area>/` 是該區的 clone；空存取庫也能處理。 */
 export function ensureClone(slug, area, url) {
   const dir = syncDir(slug, area);
@@ -546,6 +569,7 @@ export async function pushArea(slug, area, { message = "", code = null, owner =
     pl.writeText(path.join(dir, "Icon.md"), wikiIconPage(slug, theCode));
   }
   const staged = stageArea(slug, area, dir);
+  clearStaleIndexLock(dir);
   gitOrThrow(["add", "-A"], dir, "git add");
   const dirty = git(["diff", "--cached", "--quiet"], dir);
   if (dirty.ok) {
@@ -567,6 +591,7 @@ export async function pushArea(slug, area, { message = "", code = null, owner =
         pl.writeText(path.join(dir, "Home.md"), wikiHome(slug, theCode));
         pl.writeText(path.join(dir, "Icon.md"), wikiIconPage(slug, theCode));
       }
+      clearStaleIndexLock(dir);
       git(["add", "-A"], dir);
       if (!git(["diff", "--cached", "--quiet"], dir).ok) {
         git(["commit", "-q", "-m", `${message || "sync"}（與遠端合併後重推）`], dir);
@@ -596,6 +621,7 @@ export async function pullArea(slug, area, { code = null, owner = null, force =
   const { host } = giteaEnv();
   const dir = ensureClone(slug, area, repoUrl(host, theOwner, theCode, area));
   stageArea(slug, area, dir); // 先把本機現況放進 clone，才看得出本機動過什麼
+  clearStaleIndexLock(dir);
   const localChanged = new Set(
     git(["status", "--porcelain"], dir)
       .stdout.split("\n")

scripts/persona.mjs

@@ -159,6 +159,13 @@ function requireMember(slug, sessionId, asGuest = false) {
   if (!slug) die("未指定人格，且本 session 沒有載入人格。");
   if (!pl.personaExists(slug)) die(`人格 \`${slug}\` 不存在。`);
   const data = pl.loadSession(sessionId);
+  // sleeper 讀自己的資料：`requireOwner` 早就放它寫了，讀反而被擋在外面——
+  // 少了這個分支，它就得在看不到 brief／recall 的情況下決定要固化什麼。
+  if (CURRENT_FLAGS["as-sleeper"]) {
+    if (asGuest) die("`--as-sleeper` 與 `--as-guest` 不能一起用（那是兩種不同的身分）。");
+    sleeperAccess(slug, sessionId, str(CURRENT_FLAGS["agent-id"]));
+    return [data, "sleeper"];
+  }
   if (data.host === slug) {
     if (asGuest) die(`\`${slug}\` 是本 session 的 host 人格，不需要也不得使用 \`--as-guest\`。`);
     pl.heartbeatLock(slug, sessionId);

skills/persona-relation/SKILL.md

@@ -13,12 +13,54 @@ description: 維護人格的人際關係圖：新增或更新人物/人格/群
 
 ## 資料模型
 
-節點：`id`／`name`／`kind`（`human` `persona` `group` `pet` `org`）／
+節點：`id`／`name`／`kind`（`human` `persona` `group` `pet` `org`）／`bond`（跟我什麼關係）／
-`closeness` 親近度 0–100／`trust` 信任度 0–100／`note`／`tags`
+`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>` 每輪會依你提到的人自動附上相關節點摘要。
 
 ## 輸出

skills/persona-sleep/SKILL.md

@@ -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 無亂碼。

skills/persona-sync/SKILL.md

@@ -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 擋下。