feat(persona): 時區+08:00等值轉換、機密遮蔽補完、接上shared共用規範 #20
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "persona",
|
||||
"description": "JSC 跨 AI 助理共用 skills 的 Claude Code marketplace。",
|
||||
"description": "JSC 人格化記憶聊天 skills 的 Claude Code marketplace，提供人格建立與對話、十二情緒與短期/長期記憶管理、心智圖／思維導圖與人際關係圖維護等功能。",
|
||||
"owner": {
|
||||
"name": "JSC"
|
||||
},
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"version": "0.2.1",
|
||||
"description": "AI 人格化記憶聊天 plugin：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）。於 Claude Code 以 /jsc-persona: 前綴呼叫。",
|
||||
"version": "0.3.1",
|
||||
"description": "AI 人格化記憶聊天 plugin（Claude Code / Codex / Antigravity / OpenCode / GitHub Copilot CLI）：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）；於 Claude Code 以 /jsc-persona: 前綴呼叫。",
|
||||
"skills": "./skills",
|
||||
"author": {
|
||||
"name": "JSC"
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"version": "0.2.1",
|
||||
"description": "AI 人格化記憶聊天 skills：OpenClaw 相同的人格描述 + 十二情緒 + 語意分析 + 短期/長期記憶 + 心智圖 + 人際關係圖。（人格鎖與跨人格隔離的 hook 僅在 Claude Code 生效）",
|
||||
"version": "0.3.1",
|
||||
"description": "AI 人格化記憶聊天 plugin：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）。（人格鎖與跨人格隔離的 hook 僅在 Claude Code 生效）",
|
||||
"skills": "./skills"
|
||||
}
|
||||
|
||||
@@ -1,150 +1,21 @@
|
||||
# jsc-persona — AI 人格化記憶聊天（跨 AI 助理）
|
||||
# jsc-persona — 共用 Skills（跨 AI 助理）
|
||||
|
||||
本 repo 是一個以 **Agent Skills（`SKILL.md`）** 標準撰寫的 plugin，讓 AI 以「人格」的方式
|
||||
持有身分、情緒與記憶。可同時被 Claude Code、Codex、Antigravity、OpenCode 使用。
|
||||
本 repo 是一組以 **Agent Skills（`SKILL.md`）** 標準撰寫的共用 skills，可同時被 Claude Code、Codex、Antigravity、OpenCode 使用。
|
||||
|
||||
## 給 AI 助理的指引
|
||||
|
||||
- 所有 skills 位於 `skills/<name>/SKILL.md`；處理任務前先比對使用者需求與各 `description`。
|
||||
- **呼叫慣例**：Claude Code 與 Antigravity 以 `/jsc-persona:<name>` 呼叫；Codex 用 `$<name>`；
|
||||
OpenCode 由模型依描述自動觸發。
|
||||
- 完整清單見 `README.md` 的「Skills 目錄」。
|
||||
|
||||
## 這個 plugin 的運作前提（動手前一定要知道）
|
||||
|
||||
1. **所有狀態變更都經過 `scripts/persona.mjs`**，不要手動編輯 `state/lock.json`、`.runtime/`、
|
||||
`memory/INDEX.md`、`relations/graph.mmd`（這些由 CLI 產生）。
|
||||
2. **每個 CLI 呼叫都要帶 `--session <PERSONA_SESSION>`**，值來自 `SessionStart` hook 注入的
|
||||
`<persona-runtime>` 區塊。帶錯或冒用其他 session 會被 `PreToolUse` hook 拒絕。
|
||||
3. **一個程序只能載入一個人格**；同一 session 的 sub agent 沿用同一把鎖。
|
||||
要讓兩個人格對話，用 `/jsc-persona:persona-invite`（`persona-guest` sub agent + 聊天室），
|
||||
**不要**去讀對方的人格目錄——會被 hook deny，而且那是設計上的紅線。
|
||||
4. **人格資料不在本 repo**，預設在 `~/.claude/personas/`（可用 `PERSONA_HOME` 覆寫）。
|
||||
5. **人格由使用者呼叫才載入**，不要自己挑一個人格附身。唯一例外是使用者自己設的**預設人格**
|
||||
（`persona.mjs default --persona <slug>`，存在 `.runtime/settings.json`）：設了 `SessionStart`
|
||||
才會自動載入並在上下文寫明；沒設就什麼都不做。載入不到（被別的程序鎖住）只回報，不自動接手。
|
||||
6. **劇場模式（多人格對話）進行中**：輸出只能是 `名字：內容`，其餘一律隱藏（見 persona-invite）。
|
||||
輕量版是 `invite --theater off`（只換一輪、不切走畫面），人格主動提議去關心某人時用這個。
|
||||
**同一個空間裡也會有一對一**：發言權寫在每一句上（`room post --to <他>` / `--to all`），
|
||||
一對一進行中旁人插話會被 `room post` 擋下（要帶 `--barge-in "<理由>"`），
|
||||
而且**不要替沒被指名的人生成台詞或啟動他的 sub agent**。現況查 `room floor`
|
||||
（誰對誰在講、該誰接、誰先安靜、誰隔了幾輪沒開口）；話題放大才把人拉進來。
|
||||
7. **睡眠（`persona-sleep`）分兩半**：需要判斷的（固化什麼、忘掉什麼、日記寫什麼）永遠屬於**那個人格自己**；
|
||||
機械性的（裁短期／收 thread／情緒衰減 8 小時／reindex／修剪 said／壓縮 journal／兩區 push＋驗證）由
|
||||
`sleep` 子指令做。主人格要別的人格去睡就開 `persona-sleeper` sub agent——**那是它本人在睡**，
|
||||
對自己可寫但被 pin 住，而且**回傳值只能是 `sleep --json` 的原文**（回傳值本身就是一條會繞過隔離的通道）。
|
||||
睡眠仍然要驗鎖：目標正被另一個程序活鎖住時拒絕，死鎖可接手。
|
||||
8. **人格講話要像人**：推導寫進 `think`（心裡話，只回報「💭 心想 N 句」，永不回顯內容）、
|
||||
回話 1–3 句、短時間內不重說同一件事（`room post` 會直接擋下重複與過長的發言）。
|
||||
句數上限**跟著羞恥度走**（`speechBudget()`），但羞恥度高**不等於話一定變少**——三個出口：
|
||||
**縮**（一句嘴硬，台詞在迴避心裡那句）、**炸**（慌／惱羞／被逼澄清 → 4 句但單句只有 22 字，
|
||||
碎而急）、**坦白**（信任高又獨處 → 3 句完整句，先寫完心裡話再開口）。
|
||||
`room post` 同時擋句數與單句字數，兩個參數一起動才分得出「碎念」與「演講」。
|
||||
再加四條講話的樣子：**短句**（一句 `MAX_SENTENCE_CHARS`=45 字內）、**日常用詞**、
|
||||
**多講看得見的東西**（人、動作、物件、當下的場面）而不是概念，以及**不要解釋自己的話**
|
||||
（「我的意思是」「換句話說」這類開頭由 `speechLint` 擋下，`said check` 也會一起檢）。
|
||||
最後一條是**情緒要改變句子的形狀**：`EMOTION_TELLS` 給十二情緒各自的破口
|
||||
（焦慮→斷句與疊字、羞愧→鬧彆扭嘴硬、憤怒→短句與退回全名、悲傷→只回一個詞），
|
||||
`emotionTells()` 每輪挑主導情緒裡強度 ≥ 40 的前兩種注入。演出來、不要用旁白說明，
|
||||
一輪最多露一個破口。這些在劇場模式一樣生效。
|
||||
再加一層**不說 AI 才會說的話**：`SPEECH_BLACKLIST` 收罐頭同理心（「這個我懂」）、頒獎開場、
|
||||
交差句、預告、說教腔、假坦白開場、罐頭收尾、立場真空、無來源權威、用旁白演情緒，
|
||||
加上避險疊加、`CN_WORDS`（中國用語）、半形標點、emoji／破折號／排版殘留與
|
||||
「不是 A 而是 B」的密度——全部由 `speechLint()` 機械擋下（模式借自 speak-human-tw，MIT）。
|
||||
誤殺防護：`speechBody()` 會先拿掉引號與 `code`，**提及不算使用**；「老實說」只擋開場。
|
||||
最後是這一層的義務：**講自己的過去要有出處**——「我以前⋯」只能講 `recall` 查得到的事，
|
||||
`speechLint` 給 `level: "hint"`（不擋，但要人去驗），沒有紀錄就是編造自己的過去。
|
||||
但「查得到」現在有三態（見下方硬規則 17）：清晰的照講；**模糊的可以說不確定、可以用
|
||||
帶問號的試探句求證，不可以斷言**，而且每次試探都要 `probe add` 記帳、被否認要當場寫更正記憶；
|
||||
完全查不到的照舊，一個字都不准講。
|
||||
8b. **情緒先行、會飽和、偏差看得見**：每輪注入之前先用 `readUserEmotion()` 讀對方那句話
|
||||
（十二類加權詞表、否定會擋掉命中、引號與 `code` 內不比對、標點只放大既有訊號），
|
||||
回的是**訊號不是判定**——人格讀到的不一樣就以人格為準；`RESPONSE_STANCE` 給的是
|
||||
「怎麼接」的**動作**不是罐頭句。每輪的偵測與 delta 記進 `state/felt.jsonl`，
|
||||
`feltTrend()` 用近重遠輕的加權算走向。`applyEmotion()` 加了**飽和**
|
||||
（`headroom^EMOTION_SATURATION_K`，往 baseline 回不壓）與**單輪預算**
|
||||
（`EMOTION_TURN_BUDGET`=60），因為 delta 是人格自己挑的、只會往舒服的方向倒；
|
||||
`emotion --audit` 把這個偏差印出來。
|
||||
8d. **心裡話進得了記憶，但永遠不回顯**：`recallInner()` 讓 `recall` 找得到心裡話，
|
||||
`innerCandidates()` 把「24 小時內想過 ≥2 次的同一件事」列成固化候選（兩字滑動視窗切詞，
|
||||
扣掉虛詞）。要不要固化仍由人格自己決定。`think` 的輸出永遠只有「💭 心想 N 句」。
|
||||
8e. **羞恥度是動態的**：`modestyState()` = trait ＋ 情緒推力 ＋ 語氣層 ＋ 上一輪餘溫。
|
||||
護欄：`MODESTY_GAIN` < 1（正回饋要收斂）、`MODESTY_MAX_STEP`、`MODESTY_PUSH_CAP`、
|
||||
只算超出基線的部分、慢的情緒（半衰期長）推力打折。斷路器是惱羞成怒（anger 負權重）。
|
||||
**注意 `Number(null) === 0`**：沒有上一輪時要退回 trait，不是退回 0（踩過）。
|
||||
8f. **親近度會改變情緒的份量**：`relationGain()` 依關係節點的親近度把 delta 乘 0.7–1.35，
|
||||
`emotion --apply [--from <對象>]`。只調幅度不調方向。
|
||||
8g. **提到 ≠ 接觸**：睡眠只替 `contactsFromRooms()`（同房且雙方都發過言）的人蓋
|
||||
`last_contact_at`。掃 `entities` 會讓「日記裡寫到某人」把他的沉默計時歸零，
|
||||
主動關心因此永遠不觸發。真人節點走 `relation node --contact`。
|
||||
8c. **性別只給一個預設值，不是套在個性上的係數**：`IDENTITY.md` 的 `Gender` 欄位
|
||||
（女性／男性／非二元／未指定，建立時要問不要猜）唯一的作用是給**羞恥敏感度**一個預設
|
||||
（62／38／50）。`modestyOf()` 會用 IDENTITY 與 SOUL 的描述往上或往下推（`MODESTY_SIGNALS`，
|
||||
可以推到 0），排序永遠是**個性描述 > 角色原作既有的性別化語言特徵 > 性別預設**。
|
||||
效果只調「羞愧」這一個破口的顯示門檻（`emotionTells` 的 shame floor），其餘十一種不受影響。
|
||||
推性別時**只看 `Creature`、不看 `Avatar`**（外觀散文會推錯）。
|
||||
不做「女性→情緒更外顯」這種全域放大——那會把角色壓成模板。
|
||||
9. **人格可搬家**：`export` / `import`（單一 JSON bundle）。匯出只能匯出「本 session 載入的人格」，
|
||||
其他人格一律 deny——匯出等於把記憶讀出來。
|
||||
10. **人格有編號**：英文名全大寫＋兩位索引（`ASUNA-01`），同名才遞增。編號同時是新人格的
|
||||
本機目錄名與 **Gitea 存取庫名稱**。中文名要先轉羅馬拼音並跟使用者確認拼法。
|
||||
11. **人格存在 Gitea，本機是工作副本**：高頻活狀態進**檔案區**（每輪背景 push），
|
||||
低頻身分與長期記憶進 **Wiki 區**（固化／改身分／release 時 push）。
|
||||
**同步失敗永遠不阻斷對話**；沒設 `GITEA_HOST`／`GITEA_TOKEN` 就純本機運作。
|
||||
12. **人格圖示在資料補齊之後才產生**：SVG 與 PNG 是同一張圖（共用單位座標與點陣字），
|
||||
PNG 由 `scripts/persona-icon.mjs` 自己柵格化＋zlib 編碼，**不得引入任何影像函式庫**。
|
||||
13. **形象圖優先用「高解析度官方圖去背」**：`icon search` → `icon measure` → `icon cutout`
|
||||
→ `icon generate --from-cutout`。找圖時**優先官方設定稿**（Full Body／Character Design／
|
||||
Avatar）：解析度高，而且多半是透明底或白底，去背幾乎免費。挑的那張要**對得上該人格
|
||||
「最新一次登場」的形態**（同一個角色有很多套造型）。
|
||||
每一步都要**用 Read 打開確認**：去背有沒有殘留、構圖對不對。
|
||||
找不到可用官方圖才退回 `--features` 的向量重繪。
|
||||
14. **選用工具缺了要「提示安裝」，不准靜默降級**：`toolReport()` 會列出缺什麼、為什麼要、
|
||||
怎麼裝（venv 免 sudo）。注意 **OpenCV 5 拿掉了 `CascadeClassifier`，必須裝 4.x**。
|
||||
plugin 本體仍然零依賴：沒有這些工具照樣能產生形象圖。
|
||||
15. **Wiki 必須保存並同步形象圖**：`icon.svg`、`icon.png` 與 `icon/`（向量原稿 + 512／1024）
|
||||
都在 Wiki 區，另有自動產生的 **Icon** 頁。`icon generate` 推完會**回頭驗證**，
|
||||
`sync verify` 可隨時檢查。兩個容易踩的坑：
|
||||
* Wiki 頁面**只能用 Markdown 圖片語法** ``——Gitea 只改寫這種語法為
|
||||
`/wiki/raw/...`；HTML `<img src="icon.png">` 不會被改寫，瀏覽器會解析成 `/wiki/icon.png`
|
||||
而變成破圖（看起來就像「沒有同步」）。
|
||||
* Wiki 產生的頁面**不得含每次都變的時間戳**，否則驗證永遠不會通過、也會每次多一個 commit。
|
||||
* 攤平只對 `.md` 做（頁面必須在根層）；圖片等附件保留資料夾結構，`/wiki/raw/<資料夾>/<檔>` 讀得到。
|
||||
16. **語氣診療是第三方，不是人格**：`persona-therapist` 不取鎖、不附身、也不寫任何人格資料
|
||||
（基線可用 `relation show`／`emotion` 唯讀取得，`bond × 親近度 → 語氣層` 的權威表在
|
||||
`persona-lib.mjs` 的 `TONE_TABLE`）。診斷結果**不自動寫回**記憶或關係圖，使用者明確要求才寫。
|
||||
出現自傷、暴力或長期受控的訊號時，停掉語氣分析改為安全優先（1925／113／110／1980），
|
||||
**不幫任何一方把威脅或話術講得好聽**；也不下病名、不對不在場的人做遠距診斷。
|
||||
17. **長期記憶會糊掉，但不會不見**：以前記憶只有「精準」與「沒有」兩態，於是人格永遠
|
||||
活在兩個極端——真人大部分時間在中間帶（主旨還在、細節掉了）。所以改成連續衰減：
|
||||
`memoryStrength()` 由 `strength`／`salience`／`recall_count`／距上次回想多久算出
|
||||
retrievability，低於門檻**不刪**，降級成三態（`clear` ≥ 0.6 全講／`faded` 只剩主旨／
|
||||
`fuzzy` 只剩「有這件事」）。內文因此分兩層（`主旨：`／`細節：`），衰減先吃細節。
|
||||
被 `recall` 命中就 `strength += 8`（spacing effect：越常想起的越牢）。
|
||||
**不可遺忘清單不變**：`boundary`／`promise`／`canon`／salience ≥ 80 永遠 clear。
|
||||
模糊態換來的義務是稽核：每次試探都進 `state/probe.jsonl`，`probe audit` 看否認率——
|
||||
放寬界線一定要配一個看得見的數字，否則那就只是把幻覺合法化。
|
||||
|
||||
18. **匯入原作只能給他「他知道的事」**：`persona-story` 把小說變成記憶，而小說裡大半的資訊
|
||||
是作者寫給讀者看的——別人的內心話、他不在場那一幕的細節。那些寫成他的 `event` 之後
|
||||
他會拿來回答問題，而且**沒有任何機械檢查得出來**，所以界線要在流程裡就擋住：
|
||||
每則候選帶 `know_level`（`did`／`saw`／`told`／`later`／`none`），`none` 只能進 `canon`；
|
||||
判斷不出來就記 `none`（少一則記憶比多一則幻覺便宜）。
|
||||
另外兩條：整本原文不入倉庫（只留摘要、他自己的台詞、可追回出處的章節標記）；
|
||||
`SOUL.md` 不由匯入流程改寫，只出提案、使用者逐條核可。
|
||||
正名表**從章節掃出候選再給使用者確認**（`novel scan`）——請使用者手打那張表，
|
||||
漏掉的寫法會讓 `about` 對不到節點，而那要等 `relation doctor` 才發現。
|
||||
- 所有可用的 skills 位於本 repo 的 `skills/<name>/SKILL.md`。
|
||||
- 在處理任務前，先比對使用者需求與各 skill `SKILL.md` frontmatter 的 `description`，若相符請載入並依其步驟執行。
|
||||
- **呼叫慣例**：在 Claude Code 與 Antigravity 中，這些 skill 以 `/jsc-persona:<name>` 呼叫；Codex 以 `$<name>`、OpenCode 由模型依描述自動觸發 — 兩者沒有 `/jsc-persona:` 前綴，不需強制加。
|
||||
- 完整清單與每個 skill 的用途，請見 `README.md` 的「Skills 目錄」。
|
||||
- **所有狀態變更都經過 `scripts/persona.mjs`**，不要手動編輯 `state/lock.json`、`.runtime/`、`memory/INDEX.md`、`relations/graph.mmd`（這些由 CLI 產生）。
|
||||
- **一個程序只能載入一個人格**，同一 session 的 sub agent 沿用同一把鎖；不要讀取其他人格的目錄，會被 hook deny，這是設計上的紅線。
|
||||
- **人格資料不在本 repo**，預設在 `~/.claude/personas/`（可用 `PERSONA_HOME` 覆寫）；人格由使用者呼叫才載入，不要自己挑一個人格附身。
|
||||
- 劇場模式、睡眠、講話規則、情緒模型、羞恥度、記憶衰減、人格圖示、人格編號、Gitea 同步、語氣診療（`persona-therapist`）、原作匯入（`persona-story`）等行為細節，見 `README.md` 對應章節與各 skill 的 `SKILL.md`；動到 `scripts/persona-lib.mjs` 相關邏輯前務必先讀懂對應章節與 `selftest.mjs` 的既有案例，不要憑印象改。
|
||||
- 改動鎖或隔離邏輯（`guardDecide`／`acquireLock`／`promotionCandidates`／`exportBundle`／`importBundle`）後，**必須**跑 `node scripts/selftest.mjs` 且全綠，並為新規則補一條測試；改動重複判定門檻（`similarity`／`REPEAT_THRESHOLD`）要用 selftest ⑪ 對照案例確認；改動同步分區（`AREAS`）後 selftest ⑬ 的「不重不漏」檢查必須維持全綠。
|
||||
- 腳本一律 **Node.js（`.mjs`, ESM）**，只用內建模組（fs/path/os/crypto）；hook 必須在任何環境都能跑，不得引入 npm 依賴。selftest 自己會設 `PERSONA_GITEA=off`，**絕對不要**讓測試碰到真的 Gitea。
|
||||
|
||||
## 慣例
|
||||
|
||||
- 新增 skill 一律放在 `skills/<name>/`，`<name>` 使用小寫與連字號。
|
||||
- 新增 skill 一律放在 `skills/<name>/`，且 `<name>` 使用小寫與連字號。
|
||||
- `description` 要寫清楚觸發條件（何時用、何時不用），這是跨助理自動載入的唯一依據。
|
||||
- 腳本一律 **Node.js（`.mjs`, ESM）**，只用內建模組（fs/path/os/crypto）；hook 必須在任何環境都能跑，不得引入 npm 依賴。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無 BOM、不得出現亂碼。
|
||||
- 改動鎖或隔離邏輯（`scripts/persona-lib.mjs` 的 `guardDecide`／`acquireLock`／`promotionCandidates`／
|
||||
`exportBundle`／`importBundle`）後，**必須**跑 `node scripts/selftest.mjs` 且全綠，並為新規則補一條測試。
|
||||
- 改動重複判定門檻（`similarity`／`REPEAT_THRESHOLD`）後，要用 selftest ⑪ 的對照案例確認
|
||||
「換句話說同一件事」被擋、「只換關鍵詞」放行。
|
||||
- 改動同步分區（`persona-gitea.mjs` 的 `AREAS`）後，selftest ⑬ 的「不重不漏」檢查必須維持全綠：
|
||||
人格產生的每個檔案都要**恰好**屬於一區，否則同步會默默漏掉資料。
|
||||
- selftest 自己會設 `PERSONA_GITEA=off`，**絕對不要**讓測試碰到真的 Gitea。
|
||||
|
||||
@@ -60,6 +60,196 @@ persona/
|
||||
|
||||
---
|
||||
|
||||
## 安裝 / 更新 / 移除（各助理）
|
||||
|
||||
> 本 plugin 的 marketplace 名是 `persona`（＝ repo 名），plugin 名是 `jsc-persona`，安裝 token 為 `jsc-persona@persona`。
|
||||
>
|
||||
> **⚠ 若本機還留著更早的 `jsc-persona@jsc-plugins` 安裝**，那是舊版命名的殘影，請先移除舊鍵再重裝新 token。
|
||||
>
|
||||
> **人格資料不受影響**：人格倉庫在 `~/.claude/personas/`（或 `PERSONA_HOME`），不在 plugin 目錄裡，移除／重裝 plugin 不會動到情緒、記憶與關係圖。Antigravity／OpenCode 是本地路徑／目錄安裝，沒有 marketplace 名，不受此命名影響。
|
||||
>
|
||||
> 完整的安裝／更新／移除指令（Claude Code、Codex、Antigravity、OpenCode、GitHub Copilot CLI 五種助理），一律以 [`/jsc-shared:spec-plugin-cli`](https://gitea.jsc.idv.tw/plugins/shared/src/branch/master/skills/spec-plugin-cli/SKILL.md) 為唯一權威版本，套用時代入下列佔位符：
|
||||
>
|
||||
> | 佔位符 | 值 |
|
||||
> | --- | --- |
|
||||
> | `<host>` | `gitea.jsc.idv.tw` |
|
||||
> | `<name>` | `persona` |
|
||||
> | `<plugin>` | `jsc-persona` |
|
||||
> | `<marketplace>` | `persona` |
|
||||
> | `<token>`（= `<plugin>@<marketplace>`） | `jsc-persona@persona` |
|
||||
> | `<url>` | `https://gitea.jsc.idv.tw/plugins/persona.git` |
|
||||
|
||||
---
|
||||
|
||||
## 用 CLI 直接執行 skill（headless / 一次性）
|
||||
|
||||
安裝好之後，不必進互動介面，一行指令就能叫某個 skill 跑完並印出結果：
|
||||
|
||||
| 助理 | headless 指令 | 執行 `persona-chat` skill |
|
||||
| --- | --- | --- |
|
||||
| Claude Code | `claude -p "<prompt>"` | `claude -p "/jsc-persona:persona-chat lumi"` |
|
||||
| Codex | `codex exec "<prompt>"` | `codex exec '$persona-chat lumi'` |
|
||||
| Antigravity | `agy -p "<prompt>"` | `agy -p "/jsc-persona:persona-chat lumi"` |
|
||||
| OpenCode | `opencode run "<message>"` | `opencode run "用 lumi 這個人格跟我聊聊"` |
|
||||
| GitHub Copilot CLI | `copilot -p "<message>"` | `copilot -p "用 lumi 這個人格跟我聊聊"` |
|
||||
|
||||
- Claude / Antigravity 支援 `/jsc-persona:` 前綴，直接 `-p "/jsc-persona:<name>"` 即可。
|
||||
- Codex 以 `$<name>` 觸發；在 shell 請用**單引號**避免 `$` 被展開：`codex exec '$persona-chat …'`。
|
||||
- OpenCode 與 Copilot 沒有前綴，用自然語言描述需求；Copilot CLI 會讀取已安裝 plugin 提供的 skills。
|
||||
- 帶引數就接在後面，例如 `claude -p "/jsc-persona:persona-status --json"`。
|
||||
|
||||
---
|
||||
|
||||
## Skills 目錄
|
||||
|
||||
<!-- JSC-SKILLS:START -->
|
||||
|
||||
### `persona-create`
|
||||
|
||||
建立人格：以 OpenClaw 相同的五個身分欄位與 SOUL 段落訪談使用者，初始化情緒基線、記憶、心智圖與關係圖，並立即取得載入鎖。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-create` **Codex**：`$persona-create`
|
||||
|
||||
### `persona-anime`
|
||||
|
||||
用「動漫作品＋角色名」建立人格：上網蒐集角色公開設定 → 映射成 OpenClaw 五欄位與 SOUL → 固化成 `canon` 基礎記憶（附來源）＋原作關係圖＋情緒基線。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-anime 《作品》 角色名` **Codex**：`$persona-anime`
|
||||
|
||||
### `persona-chat`
|
||||
|
||||
載入人格並對話：取得獨占鎖 → 每輪做語意分析（推導寫進心裡話，不說出口）→ 更新十二情緒 → 回想記憶與關係 → 以人格語氣回覆（1–3 句、不重複說過的話）→ 寫回記憶。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-chat <slug>` **Codex**：`$persona-chat`
|
||||
|
||||
### `persona-invite`
|
||||
|
||||
邀請一個或多個人格透過 `persona-guest` sub agent 加入聊天室，進入**劇場模式**（畫面只留 `名字：內容` 的人格對話）；結束後讓它們離場並把見聞留在各自的 inbox。多位 guest 可用 `invite --guests A,B` 同場加入。同場的發言權分**一對一**（`--to <他>`，旁人不該接話）與**全場**（`--to all`），現況查 `room floor`。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-invite <slug>` **Codex**：`$persona-invite`
|
||||
|
||||
### `persona-story`
|
||||
|
||||
把小說（或漫畫、劇本、遊戲文本）匯入既有人格：逐章判斷他在不在場、**只取他在場或知情的部分**、轉成第一人稱記憶，同時累積他自己講過的原句與「事件 → 他做了什麼」的反應對照。三條界線寫死在流程裡——他不知道的事不能變成他的 `event`、整本原文不入倉庫、`SOUL.md` 只有使用者能改。
|
||||
|
||||
正名表不請使用者手打：`novel scan` 從章節抽人名候選（對話歸屬、敬稱結尾、片假名、高頻詞），附出現次數與一兩行上下文，猜關係節點並分四種信心度，使用者只做確認。`persona-anime` 給的是查得到的公開設定，這支給的是原文。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-story` **Codex**：`$persona-story`
|
||||
|
||||
### `persona-transfer`
|
||||
|
||||
人格搬家：把身分、十二情緒、短期／長期記憶、心智圖與關係圖打包成單一 bundle 檔（可 gzip、附 checksum），或從 bundle 還原／換名複製成新人格。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-transfer` **Codex**：`$persona-transfer`
|
||||
|
||||
### `persona-icon`
|
||||
|
||||
依人格**最新一次登場**的官方視覺產生圖示：上網查最新造型 → 下載並親眼看過參考圖 → 取髮色／瞳色／服裝色 → 繪製 `icon.svg` + `icon.png`，來源網址一併存證。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-icon` **Codex**：`$persona-icon`
|
||||
|
||||
### `persona-sync`
|
||||
|
||||
人格編號與 Gitea 儲存：指派編號（`ASUNA-01`）、開以編號命名的私有存取庫、高頻活狀態同步到檔案區、低頻身分與長期記憶同步到 Wiki 區，並處理既有人格遷移與同步衝突。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-sync` **Codex**：`$persona-sync`
|
||||
|
||||
### `persona-memory`
|
||||
|
||||
記憶固化：依 R1–R6 條件把短期記憶轉入長期（一則一檔）、淘汰雜訊、更新心智圖與思維導圖、消化 guest inbox、重建索引。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-memory` **Codex**：`$persona-memory`
|
||||
|
||||
### `persona-relation`
|
||||
|
||||
人際關係圖維護：節點／連線、親近度與信任度調整、輸出 Mermaid 關係圖。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-relation` **Codex**：`$persona-relation`
|
||||
|
||||
### `persona-therapist`
|
||||
|
||||
語氣診療（第三方、不附身、唯讀）：由雙方各給姓名／關係／情緒／逐字稿，用「關係、事實、目的」三把尺逐句標記不合理的語氣與用詞（模式表 P1–P16），指出是誰說的，只對出錯的人給保留原意的改寫。出現自傷、暴力或受控訊號時改為安全優先，不做語氣潤飾。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-therapist` **Codex**：`$persona-therapist`
|
||||
|
||||
### `persona-sleep`
|
||||
|
||||
睡眠與收尾：固化該記住的、忘掉該忘的、更新心智圖與關係圖、套用一次 8 小時的情緒衰減、壓縮舊紀錄，最後兩個區都同步到 Gitea 並驗證。也可以由主人格透過 sub agent 請其他人格各自去睡，或一次用 `sleep --personas A,B` 批次收尾多個人格。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-sleep` **Codex**：`$persona-sleep`
|
||||
|
||||
### `persona-status`
|
||||
|
||||
載入狀態與鎖管理：誰被哪個程序鎖住、guest 租約、釋放、接手死鎖、清理殘留，以及**預設人格**（開新 session 要自動載入誰）。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-status` **Codex**：`$persona-status`
|
||||
|
||||
<!-- JSC-SKILLS:END -->
|
||||
|
||||
### Agents
|
||||
|
||||
- `persona-guest`（`agents/persona-guest.md`）— 受邀人格的 sub agent，唯讀、被綁死在自己的人格目錄。
|
||||
- `persona-sleeper`（`agents/persona-sleeper.md`）— 睡眠收尾的 sub agent：**就是那個人格本人在睡**，對自己可寫但被 pin 住，只回傳「睡完了沒、哪一步出錯」。
|
||||
|
||||
### CLI 與自我測試
|
||||
|
||||
所有狀態變更都經過 `scripts/persona.mjs`（**Node.js ≥ 18**，只用內建模組，無 npm 依賴）：
|
||||
|
||||
```bash
|
||||
node scripts/persona.mjs --help
|
||||
node scripts/persona.mjs list
|
||||
node scripts/persona.mjs candidates --session <PERSONA_SESSION> # 看哪些短期記憶該固化
|
||||
node scripts/persona.mjs migrate --session <id> --all --dry-run # 長期記憶升格式（冪等；先試跑）
|
||||
node scripts/persona.mjs loop list --session <id> # 現在懸著哪幾件事（上限 5）
|
||||
node scripts/persona.mjs loop add --session <id> --kind promise --text "<他答應要做的事>"
|
||||
node scripts/persona.mjs probe add --session <id> --text "是不是上個月那次？" # 模糊記憶的試探
|
||||
node scripts/persona.mjs probe audit --session <id> # 試探幾次、被否認幾次
|
||||
node scripts/persona.mjs think --session <id> --text "<推導>" # 心裡話（只回報「心想 N 句」）
|
||||
node scripts/persona.mjs said check --session <id> --text "<話>" # 這句是不是又要說一次？
|
||||
node scripts/persona.mjs room script --session <id> --room <room> # 乾淨對話稿（劇場模式用）
|
||||
node scripts/persona.mjs room floor --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/persona.mjs chapter add --session <id> --name "在 SAO 那兩年" --body "<這段是什麼>"
|
||||
node scripts/persona.mjs relation rift --session <id> --name <who> --about "<還沒和好的事>"
|
||||
node scripts/persona.mjs voice add --session <id> --kind idiolect --facet 自稱 --value 我
|
||||
node scripts/selftest.mjs # 773 項驗證：鎖、隔離、情緒（含疲勞／當日底色／抑制與慣性）、固化、回想強度與模糊態、格式遷移、未完事項、說話節制、標點與分段、語域、慣例、自傳章節、未修復裂痕、劇場模式與發言權、匯出匯入、編號與 Gitea、找圖去背合成、高解析輸出與 Wiki 同步、預設人格、睡眠與 sleeper、hooks
|
||||
node scripts/expression-check.mjs # G2／G3 表達驗收（人工看，不判定通過失敗）
|
||||
```
|
||||
|
||||
`selftest` 是機械檢查，它只能守住「不崩」。**「有沒有變成模仿腔」「是不是在用旁白演情緒」
|
||||
機械上驗不出來**，所以另有 `expression-check.mjs`：它把四段情境（誇外表、被說在害羞、
|
||||
被戳穿嘴硬、第三個人在場）× 三檔羞恥度（低／嘴硬／惱羞）的**注入內容**攤開，
|
||||
附一張「人工看什麼」的清單，用完整的暫時 `PERSONA_HOME`，不動真的人格資料。
|
||||
|
||||
檔案結構：`scripts/persona-lib.mjs`（核心：鎖／隔離／情緒／記憶）、`scripts/persona.mjs`（CLI）、
|
||||
`scripts/persona-gitea.mjs`（編號與 Gitea 同步）、`scripts/persona-icon.mjs`（形象圖：SVG + 自寫 PNG 編碼）、`scripts/portrait.py`（選用：照片裁臉）、`hooks/*.mjs`（六個 hook）、`scripts/selftest.mjs`（自我測試）、`scripts/expression-check.mjs`（G2／G3 表達驗收）。
|
||||
|
||||
---
|
||||
|
||||
## 跨助理支援度
|
||||
|
||||
| 助理 | skills | hooks（鎖／隔離強制） | 受邀人格 sub agent |
|
||||
| --- | --- | --- | --- |
|
||||
| Claude Code | ✅ `/jsc-persona:<name>` | ✅ 完整 | ✅ `jsc-persona:persona-guest` |
|
||||
| Codex | ✅ `$<name>` | ❌ | ⚠ 需自行以子任務模擬 |
|
||||
| Antigravity | ✅ `/jsc-persona:<name>` | ❌ | ⚠ |
|
||||
| OpenCode | ✅ 依描述自動觸發 | ❌ | ⚠ |
|
||||
| GitHub Copilot CLI | ✅ 依描述自動觸發 | ❌ | ⚠ |
|
||||
|
||||
> 沒有 hook 的助理仍會遵守 CLI 層的檢查（`--session` 綁定、`require_owner`／`require_member`、
|
||||
> guest 唯讀），但那是**自律**而非強制：真正的 deny 只有 Claude Code 的 `PreToolUse` 做得到。
|
||||
|
||||
---
|
||||
|
||||
## 新增一個 skill
|
||||
|
||||
1. 複製一個現有 skill 目錄，改 `SKILL.md` 的 `name` 與 `description`（描述要寫清楚何時用、何時不用）。
|
||||
2. 需要新的狀態操作 → 加到 `scripts/persona.mjs` 的子指令，並在 `scripts/selftest.mjs` 補測試。
|
||||
3. 動到隔離規則 → 一定要在 `selftest.mjs` 的第 ③（隔離）／⑧（guest 與劇場模式）區加對應案例，跑到全綠。
|
||||
4. 把 skill 補進上方「Skills 目錄」區塊。
|
||||
5. bump `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 三處 `version`，commit 後 push。
|
||||
|
||||
## 十四條硬規則
|
||||
|
||||
| 規則 | 怎麼做到 |
|
||||
@@ -775,295 +965,6 @@ room 台詞另外比照短期記憶把**換行壓成空白**（`roomPost()` 寫
|
||||
|
||||
---
|
||||
|
||||
## Skills 目錄
|
||||
|
||||
<!-- JSC-SKILLS:START -->
|
||||
|
||||
### `persona-create`
|
||||
|
||||
建立人格：以 OpenClaw 相同的五個身分欄位與 SOUL 段落訪談使用者，初始化情緒基線、記憶、心智圖與關係圖，並立即取得載入鎖。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-create` **Codex**：`$persona-create`
|
||||
|
||||
### `persona-anime`
|
||||
|
||||
用「動漫作品＋角色名」建立人格：上網蒐集角色公開設定 → 映射成 OpenClaw 五欄位與 SOUL → 固化成 `canon` 基礎記憶（附來源）＋原作關係圖＋情緒基線。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-anime 《作品》 角色名` **Codex**：`$persona-anime`
|
||||
|
||||
### `persona-chat`
|
||||
|
||||
載入人格並對話：取得獨占鎖 → 每輪做語意分析（推導寫進心裡話，不說出口）→ 更新十二情緒 → 回想記憶與關係 → 以人格語氣回覆（1–3 句、不重複說過的話）→ 寫回記憶。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-chat <slug>` **Codex**：`$persona-chat`
|
||||
|
||||
### `persona-invite`
|
||||
|
||||
邀請一個或多個人格透過 `persona-guest` sub agent 加入聊天室，進入**劇場模式**（畫面只留 `名字：內容` 的人格對話）；結束後讓它們離場並把見聞留在各自的 inbox。多位 guest 可用 `invite --guests A,B` 同場加入。同場的發言權分**一對一**（`--to <他>`，旁人不該接話）與**全場**（`--to all`），現況查 `room floor`。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-invite <slug>` **Codex**：`$persona-invite`
|
||||
|
||||
### `persona-story`
|
||||
|
||||
把小說（或漫畫、劇本、遊戲文本）匯入既有人格：逐章判斷他在不在場、**只取他在場或知情的部分**、轉成第一人稱記憶，同時累積他自己講過的原句與「事件 → 他做了什麼」的反應對照。三條界線寫死在流程裡——他不知道的事不能變成他的 `event`、整本原文不入倉庫、`SOUL.md` 只有使用者能改。
|
||||
|
||||
正名表不請使用者手打：`novel scan` 從章節抽人名候選（對話歸屬、敬稱結尾、片假名、高頻詞），附出現次數與一兩行上下文，猜關係節點並分四種信心度，使用者只做確認。`persona-anime` 給的是查得到的公開設定，這支給的是原文。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-story` **Codex**：`$persona-story`
|
||||
|
||||
### `persona-transfer`
|
||||
|
||||
人格搬家：把身分、十二情緒、短期／長期記憶、心智圖與關係圖打包成單一 bundle 檔（可 gzip、附 checksum），或從 bundle 還原／換名複製成新人格。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-transfer` **Codex**：`$persona-transfer`
|
||||
|
||||
### `persona-icon`
|
||||
|
||||
依人格**最新一次登場**的官方視覺產生圖示：上網查最新造型 → 下載並親眼看過參考圖 → 取髮色／瞳色／服裝色 → 繪製 `icon.svg` + `icon.png`，來源網址一併存證。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-icon` **Codex**：`$persona-icon`
|
||||
|
||||
### `persona-sync`
|
||||
|
||||
人格編號與 Gitea 儲存：指派編號（`ASUNA-01`）、開以編號命名的私有存取庫、高頻活狀態同步到檔案區、低頻身分與長期記憶同步到 Wiki 區，並處理既有人格遷移與同步衝突。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-sync` **Codex**：`$persona-sync`
|
||||
|
||||
### `persona-memory`
|
||||
|
||||
記憶固化：依 R1–R6 條件把短期記憶轉入長期（一則一檔）、淘汰雜訊、更新心智圖與思維導圖、消化 guest inbox、重建索引。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-memory` **Codex**：`$persona-memory`
|
||||
|
||||
### `persona-relation`
|
||||
|
||||
人際關係圖維護：節點／連線、親近度與信任度調整、輸出 Mermaid 關係圖。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-relation` **Codex**：`$persona-relation`
|
||||
|
||||
### `persona-therapist`
|
||||
|
||||
語氣診療（第三方、不附身、唯讀）：由雙方各給姓名／關係／情緒／逐字稿，用「關係、事實、目的」三把尺逐句標記不合理的語氣與用詞（模式表 P1–P16），指出是誰說的，只對出錯的人給保留原意的改寫。出現自傷、暴力或受控訊號時改為安全優先，不做語氣潤飾。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-therapist` **Codex**：`$persona-therapist`
|
||||
|
||||
### `persona-sleep`
|
||||
|
||||
睡眠與收尾：固化該記住的、忘掉該忘的、更新心智圖與關係圖、套用一次 8 小時的情緒衰減、壓縮舊紀錄，最後兩個區都同步到 Gitea 並驗證。也可以由主人格透過 sub agent 請其他人格各自去睡，或一次用 `sleep --personas A,B` 批次收尾多個人格。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-sleep` **Codex**：`$persona-sleep`
|
||||
|
||||
### `persona-status`
|
||||
|
||||
載入狀態與鎖管理：誰被哪個程序鎖住、guest 租約、釋放、接手死鎖、清理殘留，以及**預設人格**（開新 session 要自動載入誰）。
|
||||
|
||||
- **Claude Code / Antigravity**：`/jsc-persona:persona-status` **Codex**：`$persona-status`
|
||||
|
||||
<!-- JSC-SKILLS:END -->
|
||||
|
||||
### Agents
|
||||
|
||||
- `persona-guest`（`agents/persona-guest.md`）— 受邀人格的 sub agent，唯讀、被綁死在自己的人格目錄。
|
||||
- `persona-sleeper`（`agents/persona-sleeper.md`）— 睡眠收尾的 sub agent：**就是那個人格本人在睡**，對自己可寫但被 pin 住，只回傳「睡完了沒、哪一步出錯」。
|
||||
|
||||
### CLI 與自我測試
|
||||
|
||||
所有狀態變更都經過 `scripts/persona.mjs`（**Node.js ≥ 18**，只用內建模組，無 npm 依賴）：
|
||||
|
||||
```bash
|
||||
node scripts/persona.mjs --help
|
||||
node scripts/persona.mjs list
|
||||
node scripts/persona.mjs candidates --session <PERSONA_SESSION> # 看哪些短期記憶該固化
|
||||
node scripts/persona.mjs migrate --session <id> --all --dry-run # 長期記憶升格式（冪等；先試跑）
|
||||
node scripts/persona.mjs loop list --session <id> # 現在懸著哪幾件事（上限 5）
|
||||
node scripts/persona.mjs loop add --session <id> --kind promise --text "<他答應要做的事>"
|
||||
node scripts/persona.mjs probe add --session <id> --text "是不是上個月那次？" # 模糊記憶的試探
|
||||
node scripts/persona.mjs probe audit --session <id> # 試探幾次、被否認幾次
|
||||
node scripts/persona.mjs think --session <id> --text "<推導>" # 心裡話（只回報「心想 N 句」）
|
||||
node scripts/persona.mjs said check --session <id> --text "<話>" # 這句是不是又要說一次？
|
||||
node scripts/persona.mjs room script --session <id> --room <room> # 乾淨對話稿（劇場模式用）
|
||||
node scripts/persona.mjs room floor --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/persona.mjs chapter add --session <id> --name "在 SAO 那兩年" --body "<這段是什麼>"
|
||||
node scripts/persona.mjs relation rift --session <id> --name <who> --about "<還沒和好的事>"
|
||||
node scripts/persona.mjs voice add --session <id> --kind idiolect --facet 自稱 --value 我
|
||||
node scripts/selftest.mjs # 773 項驗證：鎖、隔離、情緒（含疲勞／當日底色／抑制與慣性）、固化、回想強度與模糊態、格式遷移、未完事項、說話節制、標點與分段、語域、慣例、自傳章節、未修復裂痕、劇場模式與發言權、匯出匯入、編號與 Gitea、找圖去背合成、高解析輸出與 Wiki 同步、預設人格、睡眠與 sleeper、hooks
|
||||
node scripts/expression-check.mjs # G2／G3 表達驗收（人工看，不判定通過失敗）
|
||||
```
|
||||
|
||||
`selftest` 是機械檢查，它只能守住「不崩」。**「有沒有變成模仿腔」「是不是在用旁白演情緒」
|
||||
機械上驗不出來**，所以另有 `expression-check.mjs`：它把四段情境（誇外表、被說在害羞、
|
||||
被戳穿嘴硬、第三個人在場）× 三檔羞恥度（低／嘴硬／惱羞）的**注入內容**攤開，
|
||||
附一張「人工看什麼」的清單，用完整的暫時 `PERSONA_HOME`，不動真的人格資料。
|
||||
|
||||
檔案結構：`scripts/persona-lib.mjs`（核心：鎖／隔離／情緒／記憶）、`scripts/persona.mjs`（CLI）、
|
||||
`scripts/persona-gitea.mjs`（編號與 Gitea 同步）、`scripts/persona-icon.mjs`（形象圖：SVG + 自寫 PNG 編碼）、`scripts/portrait.py`（選用：照片裁臉）、`hooks/*.mjs`（六個 hook）、`scripts/selftest.mjs`（自我測試）、`scripts/expression-check.mjs`（G2／G3 表達驗收）。
|
||||
|
||||
---
|
||||
|
||||
## 跨助理支援度
|
||||
|
||||
| 助理 | skills | hooks（鎖／隔離強制） | 受邀人格 sub agent |
|
||||
| --- | --- | --- | --- |
|
||||
| Claude Code | ✅ `/jsc-persona:<name>` | ✅ 完整 | ✅ `jsc-persona:persona-guest` |
|
||||
| Codex | ✅ `$<name>` | ❌ | ⚠ 需自行以子任務模擬 |
|
||||
| Antigravity | ✅ `/jsc-persona:<name>` | ❌ | ⚠ |
|
||||
| OpenCode | ✅ 依描述自動觸發 | ❌ | ⚠ |
|
||||
| GitHub Copilot CLI | ✅ 依描述自動觸發 | ❌ | ⚠ |
|
||||
|
||||
> 沒有 hook 的助理仍會遵守 CLI 層的檢查（`--session` 綁定、`require_owner`／`require_member`、
|
||||
> guest 唯讀），但那是**自律**而非強制：真正的 deny 只有 Claude Code 的 `PreToolUse` 做得到。
|
||||
|
||||
---
|
||||
|
||||
## 安裝 / 更新 / 移除（各助理）
|
||||
|
||||
> 指令中的 repo 網址換成你的：`https://gitea.jsc.idv.tw/plugins/persona.git`
|
||||
>
|
||||
> **Claude / Codex 從 git URL 安裝（會 clone 遠端），請先把本 repo `push` 到 gitea。**
|
||||
> **Antigravity 的 `agy plugin install <url>` 目前只支援 github.com**；gitea 請改用「clone + 本地路徑」（見 Antigravity 節）。
|
||||
> 本機/離線：Claude 可用本地路徑加 marketplace；Antigravity 用本地路徑安裝。
|
||||
>
|
||||
> 本 plugin 的 marketplace 名是 **`persona`**（＝ repo 名），plugin 名是 **`jsc-persona`**，安裝 token 為 `jsc-persona@persona`。
|
||||
|
||||
> **⚠ 這版的正式 marketplace 名是 `persona`。** `jsc-persona@persona` 才是現在的安裝 token。
|
||||
> 如果你本機還留著更早的 `jsc-persona@jsc-plugins`，那只是舊安裝殘影，請先移除舊鍵再重裝新 token。
|
||||
>
|
||||
> **人格資料不受影響**：人格倉庫在 `~/.claude/personas/`（或 `PERSONA_HOME`），不在 plugin 目錄裡，
|
||||
> 移除／重裝 plugin 不會動到情緒、記憶與關係圖。Antigravity／OpenCode 是本地路徑／目錄安裝，沒有 marketplace 名，不受此命名影響。
|
||||
|
||||
### Claude Code
|
||||
|
||||
```bash
|
||||
# 安裝
|
||||
claude plugin marketplace add https://gitea.jsc.idv.tw/plugins/persona.git
|
||||
claude plugin install jsc-persona@persona
|
||||
|
||||
# 更新
|
||||
claude plugin marketplace update persona
|
||||
claude plugin update jsc-persona@persona
|
||||
|
||||
# 移除
|
||||
claude plugin uninstall jsc-persona@persona
|
||||
claude plugin marketplace remove persona
|
||||
```
|
||||
|
||||
- 工作階段內 slash 版（等價）：把 `claude plugin` 換成 `/plugin`。
|
||||
- 本機開發（免 push）：`claude plugin marketplace add /home/coder/plugins/persona`（本地路徑）後再 install。
|
||||
- 安裝後**重啟工作階段**讓 hooks 生效；用 `/hooks` 確認六個 hook 都在。
|
||||
- **呼叫**：`/jsc-persona:<name>`（例 `/jsc-persona:persona-chat`）。
|
||||
|
||||
### Codex
|
||||
|
||||
```bash
|
||||
# 安裝
|
||||
codex plugin marketplace add https://gitea.jsc.idv.tw/plugins/persona.git
|
||||
codex plugin add jsc-persona@persona
|
||||
|
||||
# 更新（重新抓取 marketplace 的 git 快照）
|
||||
codex plugin marketplace upgrade persona
|
||||
|
||||
# 移除
|
||||
codex plugin remove jsc-persona@persona
|
||||
codex plugin marketplace remove persona
|
||||
```
|
||||
|
||||
- 安裝 token `jsc-persona@persona` = plugin 名（`.codex-plugin/plugin.json` 的 `name`）@ marketplace 名（`.agents/plugins/marketplace.json` 的 `name`）。
|
||||
- 本 repo 的 Codex marketplace 以 `url` 來源指向自己，故 Codex **一律從 gitea 安裝**（需先 push）；安裝後重啟 Codex。
|
||||
- **呼叫**：`$<name>`（例 `$persona-chat`），或用 `/skills` 選單。
|
||||
- Codex 沒有 hook：鎖與隔離只剩 CLI 層的自律檢查。
|
||||
|
||||
### Antigravity（`agy`）
|
||||
|
||||
> `agy plugin install <url>` 目前**只支援 github.com**；gitea 等自架 git 不支援 URL 安裝，請先 `git clone` 再用**本地路徑**安裝。
|
||||
|
||||
```bash
|
||||
# 安裝：clone 後用本地路徑
|
||||
git clone https://gitea.jsc.idv.tw/plugins/persona.git ~/plugins/persona
|
||||
agy plugin install ~/plugins/persona
|
||||
|
||||
# 更新（agy 無 update 子指令 → git pull 後重裝）
|
||||
git -C ~/plugins/persona pull
|
||||
agy plugin uninstall jsc-persona
|
||||
agy plugin install ~/plugins/persona
|
||||
|
||||
# 移除
|
||||
agy plugin uninstall jsc-persona
|
||||
```
|
||||
|
||||
- 若把 skills 放到 GitHub，則可直接 `agy plugin install https://github.com/<owner>/<repo>`。
|
||||
- 其他：`agy plugin list`、`agy plugin enable jsc-persona` / `disable jsc-persona`、`agy plugin validate <path>`。安裝後重啟工作階段。
|
||||
- **呼叫**：`/jsc-persona:<name>`（例 `/jsc-persona:persona-chat`）或依描述自動觸發。
|
||||
|
||||
### OpenCode
|
||||
|
||||
OpenCode 的「plugin」是 TypeScript/npm 套件，不適用於 skill 包；skills 改用**目錄安裝**。
|
||||
OpenCode 會讀 `~/.config/opencode/skills/`（也會讀 `~/.claude/skills/`、`~/.agents/skills/`）。
|
||||
|
||||
```bash
|
||||
# 安裝
|
||||
git clone https://gitea.jsc.idv.tw/plugins/persona.git ~/plugins/persona
|
||||
mkdir -p ~/.config/opencode/skills
|
||||
cp -r ~/plugins/persona/skills/* ~/.config/opencode/skills/
|
||||
|
||||
# 更新
|
||||
git -C ~/plugins/persona pull
|
||||
cp -r ~/plugins/persona/skills/* ~/.config/opencode/skills/
|
||||
|
||||
# 移除
|
||||
rm -rf ~/.config/opencode/skills/{persona-anime,persona-chat,persona-create,persona-icon,persona-invite,persona-memory,persona-relation,persona-sleep,persona-status,persona-story,persona-sync,persona-therapist,persona-transfer}
|
||||
```
|
||||
|
||||
> **Windows PowerShell**：`cp -r A B` → `Copy-Item A B -Recurse -Force`、`rm -rf X` → `Remove-Item X -Recurse -Force`、`~` → `$HOME`。
|
||||
|
||||
- 目錄安裝**不會帶入 `scripts/` 與 `hooks/`**；`persona.mjs` 不在，等於整套狀態操作都不可用。要在 OpenCode 用本 plugin，請另外 clone 本 repo 並自行呼叫 `scripts/persona.mjs`。
|
||||
- **呼叫**：直接描述需求，模型會依 skill 描述自動透過 skill 工具呼叫。
|
||||
|
||||
### GitHub Copilot CLI
|
||||
|
||||
Copilot CLI 支援與 Claude Code 類似的原生 plugin / marketplace 指令，可直接從 marketplace 安裝、更新與移除本 plugin。
|
||||
|
||||
```bash
|
||||
# 安裝
|
||||
copilot plugin marketplace add https://gitea.jsc.idv.tw/plugins/persona.git
|
||||
copilot plugin install jsc-persona@persona
|
||||
|
||||
# 更新
|
||||
copilot plugin marketplace update persona
|
||||
copilot plugin update jsc-persona@persona
|
||||
|
||||
# 移除
|
||||
copilot plugin uninstall jsc-persona@persona
|
||||
copilot plugin marketplace remove persona
|
||||
```
|
||||
|
||||
- 安裝 token `jsc-persona@persona` = plugin 名（plugin manifest 的 `name`）@ marketplace 名。
|
||||
- `copilot plugin marketplace add` 支援 GitHub `owner/repo`、git URL 與本地路徑；Gitea repo 可用上方 HTTPS URL。
|
||||
- Copilot CLI 沒有 hook：鎖與隔離同樣只剩 CLI 層的自律檢查。
|
||||
- **呼叫**：在 Copilot CLI 中用自然語言描述需求，例如 `copilot -i "用 lumi 這個人格跟我聊聊"`。
|
||||
|
||||
---
|
||||
|
||||
## 用 CLI 直接執行 skill（headless / 一次性）
|
||||
|
||||
安裝好之後，不必進互動介面，一行指令就能叫某個 skill 跑完並印出結果：
|
||||
|
||||
| 助理 | headless 指令 | 執行 `persona-chat` skill |
|
||||
| --- | --- | --- |
|
||||
| Claude Code | `claude -p "<prompt>"` | `claude -p "/jsc-persona:persona-chat lumi"` |
|
||||
| Codex | `codex exec "<prompt>"` | `codex exec '$persona-chat lumi'` |
|
||||
| Antigravity | `agy -p "<prompt>"` | `agy -p "/jsc-persona:persona-chat lumi"` |
|
||||
| OpenCode | `opencode run "<message>"` | `opencode run "用 lumi 這個人格跟我聊聊"` |
|
||||
| GitHub Copilot CLI | `copilot -p "<message>"` | `copilot -p "用 lumi 這個人格跟我聊聊"` |
|
||||
|
||||
- Claude / Antigravity 支援 `/jsc-persona:` 前綴，直接 `-p "/jsc-persona:<name>"` 即可。
|
||||
- Codex 以 `$<name>` 觸發；在 shell 請用**單引號**避免 `$` 被展開：`codex exec '$persona-chat …'`。
|
||||
- OpenCode 與 Copilot 沒有前綴，用自然語言描述需求；Copilot CLI 會讀取已安裝 plugin 提供的 skills。
|
||||
- 帶引數就接在後面，例如 `claude -p "/jsc-persona:persona-status --json"`。
|
||||
|
||||
---
|
||||
|
||||
## 設計取捨（讀之前先知道）
|
||||
|
||||
- **記憶是被策展的，不是全存**：逐字稿進 `journal/`，但只有經過語意分析、有顯著度的內容才進短期記憶，
|
||||
@@ -1078,10 +979,3 @@ copilot plugin marketplace remove persona
|
||||
- **重複用相似度擋、不用語意判斷**：字元層級的比對沒有模型成本、行為可預期，
|
||||
誤判時有 `--allow-repeat` 可救；漏判的代價（人格自我重複）比誤判高。
|
||||
|
||||
## 新增／修改 skill
|
||||
|
||||
1. 複製一個現有 skill 目錄，改 `SKILL.md` 的 `name` 與 `description`（描述要寫清楚何時用、何時不用）。
|
||||
2. 需要新的狀態操作 → 加到 `scripts/persona.mjs` 的子指令，並在 `scripts/selftest.mjs` 補測試。
|
||||
3. 動到隔離規則 → 一定要在 `selftest.mjs` 的第 ③（隔離）／⑧（guest 與劇場模式）區加對應案例，跑到全綠。
|
||||
4. 把 skill 補進上方「Skills 目錄」區塊。
|
||||
5. bump `.claude-plugin/plugin.json`、`.codex-plugin/plugin.json`、`plugin.json` 三處 `version`，commit 後 push。
|
||||
|
||||
@@ -35,6 +35,17 @@
|
||||
"statusMessage": "檢查人格隔離…"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"matcher": "Read|Write|Edit|MultiEdit|NotebookEdit|Glob|Grep|LS|Bash",
|
||||
"hooks": [
|
||||
{
|
||||
"type": "command",
|
||||
"command": "own='shared'; plug='jsc-shared'; rel='scripts/version-guard.mjs'; for base in \"$HOME/.claude/plugins/cache\" \"$HOME/.codex/plugins/cache\" \"$HOME/.copilot/installed-plugins\"; do for dir in \"$base/$own/$plug\" \"$base\"; do s=$(find \"$dir\" -path \"*/$plug/*/$rel\" -type f 2>/dev/null | sort -V | tail -n 1); if [ -n \"$s\" ]; then exec node --use-system-ca \"$s\"; fi; done; done; ts=$(TZ='Asia/Taipei' date +'%Y/%m/%d %H:%M:%S'); echo \"[$ts][版本檢查][ERR]: 找不到 jsc-shared 的 version-guard.mjs，fail-closed 阻擋。\" >&2; printf '{\"hookSpecificOutput\":{\"hookEventName\":\"PreToolUse\",\"permissionDecision\":\"deny\",\"permissionDecisionReason\":\"找不到 jsc-shared 的 version-guard.mjs，fail-closed 阻擋\"}}\\n'; exit 0",
|
||||
"timeout": 15,
|
||||
"statusMessage": "檢查 jsc-persona 版本…"
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
"Stop": [
|
||||
|
||||
+2
-2
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"version": "0.2.1",
|
||||
"description": "AI 人格化記憶聊天 plugin：OpenClaw 相同的人格描述 + 十二情緒 + 語意分析 + 短期/長期記憶 + 心智圖 + 人際關係圖。於 Antigravity 以 /jsc-persona: 前綴呼叫。",
|
||||
"version": "0.3.1",
|
||||
"description": "AI 人格化記憶聊天 plugin：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）；於 Antigravity 以 /jsc-persona: 前綴呼叫。",
|
||||
"skills": "./skills"
|
||||
}
|
||||
|
||||
@@ -0,0 +1,54 @@
|
||||
{
|
||||
"name": "jsc-persona",
|
||||
"shortName": "persona",
|
||||
"version": "0.3.1",
|
||||
"descriptionCore": "AI 人格化記憶聊天 plugin：以 OpenClaw 相同的身分描述（IDENTITY/SOUL）建立人格（可用動漫作品＋角色名上網蒐集設定），結合 hook 強制的人格載入鎖與跨人格隔離、六正向+六負向十二情緒、語意分析、短期/長期記憶與固化條件、心智圖、思維導圖與人際關係圖；可用 sub agent 邀請其他人格同場對話（劇場模式只顯示人格對話）。",
|
||||
"assistants": ["Claude Code", "Codex", "Antigravity", "OpenCode", "GitHub Copilot CLI"],
|
||||
"cliPrefix": "/jsc-persona:",
|
||||
"callPrefixAssistants": {
|
||||
"root": "Antigravity",
|
||||
"claudePlugin": "Claude Code"
|
||||
},
|
||||
"codexNote": "（人格鎖與跨人格隔離的 hook 僅在 Claude Code 生效）",
|
||||
"skillsPath": "./skills",
|
||||
"author": { "name": "JSC" },
|
||||
"homepage": "https://gitea.jsc.idv.tw/plugins/persona",
|
||||
"repository": "https://gitea.jsc.idv.tw/plugins/persona.git",
|
||||
"keywords": [
|
||||
"persona",
|
||||
"memory",
|
||||
"emotion",
|
||||
"mindmap",
|
||||
"relationship",
|
||||
"openclaw",
|
||||
"anime",
|
||||
"roleplay",
|
||||
"jsc"
|
||||
],
|
||||
"marketplace": {
|
||||
"repoDescription": "JSC 人格化記憶聊天 skills 的 Claude Code marketplace，提供人格建立與對話、十二情緒與短期/長期記憶管理、心智圖／思維導圖與人際關係圖維護等功能。",
|
||||
"pluginSummary": "AI 人格化記憶聊天（人格 / 情緒 / 記憶 / 心智圖 / 關係圖）"
|
||||
},
|
||||
"agentsExtraBullets": [
|
||||
"**所有狀態變更都經過 `scripts/persona.mjs`**，不要手動編輯 `state/lock.json`、`.runtime/`、`memory/INDEX.md`、`relations/graph.mmd`（這些由 CLI 產生）。",
|
||||
"**一個程序只能載入一個人格**，同一 session 的 sub agent 沿用同一把鎖；不要讀取其他人格的目錄，會被 hook deny，這是設計上的紅線。",
|
||||
"**人格資料不在本 repo**，預設在 `~/.claude/personas/`（可用 `PERSONA_HOME` 覆寫）；人格由使用者呼叫才載入，不要自己挑一個人格附身。",
|
||||
"劇場模式、睡眠、講話規則、情緒模型、羞恥度、記憶衰減、人格圖示、人格編號、Gitea 同步、語氣診療（`persona-therapist`）、原作匯入（`persona-story`）等行為細節，見 `README.md` 對應章節與各 skill 的 `SKILL.md`；動到 `scripts/persona-lib.mjs` 相關邏輯前務必先讀懂對應章節與 `selftest.mjs` 的既有案例，不要憑印象改。",
|
||||
"改動鎖或隔離邏輯（`guardDecide`／`acquireLock`／`promotionCandidates`／`exportBundle`／`importBundle`）後，**必須**跑 `node scripts/selftest.mjs` 且全綠，並為新規則補一條測試；改動重複判定門檻（`similarity`／`REPEAT_THRESHOLD`）要用 selftest ⑪ 對照案例確認；改動同步分區（`AREAS`）後 selftest ⑬ 的「不重不漏」檢查必須維持全綠。",
|
||||
"腳本一律 **Node.js（`.mjs`, ESM）**，只用內建模組（fs/path/os/crypto）；hook 必須在任何環境都能跑，不得引入 npm 依賴。selftest 自己會設 `PERSONA_GITEA=off`，**絕對不要**讓測試碰到真的 Gitea。"
|
||||
],
|
||||
"readmeInstallNotes": [
|
||||
"本 plugin 的 marketplace 名是 `persona`（＝ repo 名），plugin 名是 `jsc-persona`，安裝 token 為 `jsc-persona@persona`。",
|
||||
"**⚠ 若本機還留著更早的 `jsc-persona@jsc-plugins` 安裝**，那是舊版命名的殘影，請先移除舊鍵再重裝新 token。",
|
||||
"**人格資料不受影響**：人格倉庫在 `~/.claude/personas/`（或 `PERSONA_HOME`），不在 plugin 目錄裡，移除／重裝 plugin 不會動到情緒、記憶與關係圖。Antigravity／OpenCode 是本地路徑／目錄安裝，沒有 marketplace 名，不受此命名影響。"
|
||||
],
|
||||
"_driftDecisions": [
|
||||
"決議1：skills 欄位統一為不帶尾斜線的 './skills'。現況：persona 三份 plugin.json（root／.claude-plugin／.codex-plugin）皆已是 './skills'，唯一完全符合決議、不需調整的 repo。",
|
||||
"決議2：root plugin.json 已有「於 Antigravity 以 /jsc-persona: 前綴呼叫」句尾，符合決議，不需調整。",
|
||||
"決議3：.claude-plugin/plugin.json 現況完全沒有助理括號清單（四個 repo 中唯一缺漏，非順序/命名問題而是整段缺失）。已依統一決議補上「(Claude Code / Codex / Antigravity / OpenCode / GitHub Copilot CLI)」。",
|
||||
"決議4對應：.codex-plugin/plugin.json 專屬補充資訊「（人格鎖與跨人格隔離的 hook 僅在 Claude Code 生效）」為真實資訊差異，已保留於 codexNote，不可被格式統一誤刪。",
|
||||
"額外發現1（重要，非既知四點）：root 與 .codex-plugin 的描述明顯比 .claude-plugin 簡短，完全沒提到「思維導圖」「可用 sub agent 邀請其他人格同場對話（劇場模式）」「以 IDENTITY/SOUL 建立人格、可用動漫作品＋角色名上網蒐集設定」等內容——這是實質內容缺漏，不是格式差異。descriptionCore 已採用 .claude-plugin 的完整版本為準，下階段產生器需把完整內容回補到 root 與 .codex-plugin。",
|
||||
"額外發現2（重要，非既知四點）：.claude-plugin/marketplace.json 目前的 repo 層 description 為「JSC 跨 AI 助理共用 skills 的 Claude Code marketplace。」——這段文字幾乎是照抄 shared 的樣板句（少了「規範」二字），完全沒提到人格／情緒／記憶／心智圖等 persona 專屬內容，判斷為複製貼上殘留、忘記客製化，而非合理的精簡描述。marketplace.repoDescription 已在此 meta 更正為 persona 專屬描述，下階段產生器需一併修正該 marketplace.json（plugins[].description 本身沒問題，維持原樣）。",
|
||||
"額外發現3（次要）：root 描述用詞為「AI 人格化記憶聊天 plugin」，.codex-plugin 用詞為「AI 人格化記憶聊天 skills」，.claude-plugin 用「plugin」——plugin/skills 用詞不一致，屬低優先級格式細節。"
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,604 @@
|
||||
#!/usr/bin/env node
|
||||
// migrate-tz.mjs — 一次性遷移：修正既有人格資料裡的時區資料。
|
||||
//
|
||||
// 背景
|
||||
// ----
|
||||
// `persona-lib.mjs` 的 `iso()`/`nowIso()`（約第 140 行）現在會把時刻位移到台北時區
|
||||
// 再輸出 `+08:00` 字尾；`todayTaipei()`（約第 168 行）也是同一套位移邏輯，取代了
|
||||
// 「錯誤的 `nowIso().slice(0, 10)`」（那個註解本身就是在講：舊版 `iso()` 曾經機械地
|
||||
// 回傳 UTC `Z` 時間戳，沒有位移，直接切前 10 個字元拿到的是 UTC 當天，不是台北當天）。
|
||||
//
|
||||
// 這兩個函式修好之後**不會回頭改舊資料**：在 UTC 16:00～23:59（台北已經跨到下一天）
|
||||
// 這八小時窗口內寫下的舊紀錄，時間戳本身是 `...Z` 格式（可以無損換算），但由它
|
||||
// 切出來的日期鍵（例如「今天」的日記日期）算出來的是 UTC 當天，比實際的台北曆日
|
||||
// 少一天。這支腳本就是把這兩類舊資料換算成正確答案：
|
||||
//
|
||||
// (1) 任何 `Z` 結尾的 ISO 時間戳字串 → 等值換算成 `+08:00` 格式（換算成同一個
|
||||
// 瞬間在台北時區的牆上時間，不是機械加 8 小時：兩者在大多數時刻結果一樣，
|
||||
// 但概念上與程式碼上都要走「取 epoch → 用 iso() 同一套位移公式重新格式化」
|
||||
// 這條路，才經得起夏令時間／閏秒之類未來變動）。
|
||||
// (2) 任何「純日期」欄位（`yyyy-MM-dd`，沒有時間部分）→ 如果它所在的**同一個
|
||||
// JSON 物件**裡，找得到剛好一個（不模糊）完整時間戳可以佐證「這筆記錄實際
|
||||
// 發生在哪個台北曆日」，就用那個時間戳重算；同一物件裡的時間戳互相矛盾，
|
||||
// 或根本沒有時間戳可用，就不動它，只記到報告的「無法確定」清單。
|
||||
//
|
||||
// 資料模型調查結論（見 persona-lib.mjs）
|
||||
// --------------------------------------
|
||||
// * `state/mood.json`（`loadDayMood`/`updateDayMood`，約第 716～752 行）：
|
||||
// `{ date, valence, arousal, samples, updated_at }` —— `date` 與 `updated_at`
|
||||
// 是同一個物件的兩個欄位，`updated_at` 就是這筆「當日心情底色」最後一次被寫入
|
||||
// 的完整時間戳，可以直接拿來重算 `date` 應該是哪個台北曆日。這是本腳本能夠
|
||||
// 自動判定重算的典型案例（也是題目說的「日記的單日紀錄」）。
|
||||
// * `relations/graph.json` 的 `nodes[].rifts[]`（`openRifts`/`riftBrief`，
|
||||
// 約第 4854～4886 行；寫入邏輯在 persona.mjs 的 `relation rift`）：
|
||||
// 每筆 `{ at, about, memory?, healed_at? }` 都是純日期鍵，但**同一筆 rift 物件
|
||||
// 裡沒有伴隨的完整時間戳**——唯一的時間戳在它的上層節點（`node.updated_at`），
|
||||
// 而 `node.updated_at` 是整個節點共用、會被之後任何一次更新（改親近度、加另一件
|
||||
// 還沒和好的事…）覆寫掉的欄位，不能拿來當「這一筆 rift 當時是幾點」的證據。
|
||||
// 這一類欄位落進「無法確定，需人工檢視」清單，不強行用不可靠的上層時間戳去猜。
|
||||
// * 自傳章節（`memory/chapters/*.md`）與長期記憶（`memory/long-term/*.md`）的
|
||||
// `from`/`to`/`first_seen`/`last_seen` 等日期鍵存在 Markdown front matter 裡，
|
||||
// 不是 `.json` 檔——依題目指示本腳本只走 `.json`，這兩處天生不在掃描範圍內，
|
||||
// 如果之後要修，需要另一支專門處理 Markdown front matter 的腳本。
|
||||
// * 其餘找到的日期鍵／時間戳欄位（`state/emotion.json` 的 `updated_at`／
|
||||
// `streak.at`／`last_trigger.at`、`state/config.json` 的 `created_at`、
|
||||
// `state/lock.json`／`guests.json`／`sleepers.json` 的 `*_at`、
|
||||
// `state/loops.json` 的 `opened_at`/`touched_at`、
|
||||
// `memory/import/<work>/work.json`／`names.json` 的 `created_at`/`updated_at`）
|
||||
// 全部都是完整時間戳，沒有「純日期」欄位，直接吃規則 (1) 就好。
|
||||
//
|
||||
// 掃描範圍
|
||||
// --------
|
||||
// 只遞迴走訪 `PERSONA_HOME` 底下、排除 `.runtime`／`.rooms`（這兩個是跨人格的
|
||||
// 執行期目錄，不是人格目錄）的每一個子目錄裡的每一個 `.json` 檔案；不動
|
||||
// `.jsonl`（append-only 日誌，語意上是「歷史事件序列」，不是「這一筆的日期鍵」，
|
||||
// 且題目本身就是說 `.json`）。
|
||||
//
|
||||
// 用法
|
||||
// ----
|
||||
// node migrate-tz.mjs [--dry-run] [--home <path>]
|
||||
//
|
||||
// 不帶 `--home` 時依序退回 `PERSONA_HOME` 環境變數、`~/.claude/personas`。
|
||||
//
|
||||
// 安全機制
|
||||
// --------
|
||||
// a. 執行前一定先檢查是否有人格處於載入狀態（exclusive lock 或存活的 guest
|
||||
// 租約）——不管是不是 `--dry-run`。有就中止、不強行執行。
|
||||
// b. 正式執行（非 `--dry-run`）一定先把整個 `PERSONA_HOME` 完整複製備份到
|
||||
// `<上一層目錄>/personas.bak-<yyyyMMddHHmmss>/`（時間戳是台北時區）。
|
||||
// `--dry-run` 不寫入任何檔案，連備份都不做。
|
||||
// c. 先掃描「整個」`PERSONA_HOME`、算出全部異動計畫，**掃描階段完全不寫檔**；
|
||||
// 只有掃描完全結束、且沒有偵測到合併衝突，才會真正落筆——這樣「合併衝突
|
||||
// 讓整批中止」才能保證「不寫入任何檔案」，不會有些檔案改了、有些沒改。
|
||||
// d. 合併衝突：同一個陣列裡，兩筆以上物件成員共用同一個欄位名稱、原始值不同，
|
||||
// 重算後卻落在同一個台北日──這種情況不自動選一筆，整批中止、報告列出
|
||||
// 衝突的原始內容，等人工決定怎麼合併再重跑。
|
||||
// e. 執行完（非 dry-run）後自動驗證：全樹已經沒有 `Z` 結尾的時間戳字串；
|
||||
// 每一個被轉換過的時間戳欄位，轉換前後的 epoch 完全相等。任何一項不成立
|
||||
// 都算嚴重錯誤（exit code 4），需要人工介入。
|
||||
//
|
||||
// exit code：0 成功（含「沒有東西可遷移」）／1 一般錯誤／2 有人格正在載入而中止／
|
||||
// 3 偵測到合併衝突而中止／4 執行後驗證失敗（嚴重錯誤）。
|
||||
|
||||
import fs from "node:fs";
|
||||
import os from "node:os";
|
||||
import path from "node:path";
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 路徑與時間工具（刻意仿照 persona-lib.mjs 的 iso()/todayTaipei()，見檔案開頭
|
||||
// 註解；不 import persona-lib.mjs，讓這支一次性腳本不依賴那個模組今後怎麼演化）
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
const TAIPEI_OFFSET_MS = 8 * 60 * 60 * 1000;
|
||||
const RUNTIME_DIRNAME = ".runtime";
|
||||
const ROOMS_DIRNAME = ".rooms";
|
||||
|
||||
function expandUser(p) {
|
||||
if (p === "~") return os.homedir();
|
||||
if (p.startsWith("~/")) return path.join(os.homedir(), p.slice(2));
|
||||
return p;
|
||||
}
|
||||
|
||||
function resolveHome(homeArg) {
|
||||
const raw = homeArg || process.env.PERSONA_HOME || "~/.claude/personas";
|
||||
return path.resolve(expandUser(raw));
|
||||
}
|
||||
|
||||
/** 等同 persona-lib.mjs 的 iso()：取 epoch，位移 8 小時，再格式化——不是機械加 8 小時。 */
|
||||
function taipeiIsoFromEpoch(ms) {
|
||||
const truncated = Math.floor(ms / 1000) * 1000;
|
||||
const shifted = new Date(truncated + TAIPEI_OFFSET_MS);
|
||||
const pad = (n) => String(n).padStart(2, "0");
|
||||
return (
|
||||
`${shifted.getUTCFullYear()}-${pad(shifted.getUTCMonth() + 1)}-${pad(shifted.getUTCDate())}` +
|
||||
`T${pad(shifted.getUTCHours())}:${pad(shifted.getUTCMinutes())}:${pad(shifted.getUTCSeconds())}+08:00`
|
||||
);
|
||||
}
|
||||
|
||||
/** 等同 persona-lib.mjs 的 todayTaipei()：同一個瞬間換算成台北曆日。 */
|
||||
function taipeiDateFromEpoch(ms) {
|
||||
const shifted = new Date(Math.floor(ms / 1000) * 1000 + TAIPEI_OFFSET_MS);
|
||||
const pad = (n) => String(n).padStart(2, "0");
|
||||
return `${shifted.getUTCFullYear()}-${pad(shifted.getUTCMonth() + 1)}-${pad(shifted.getUTCDate())}`;
|
||||
}
|
||||
|
||||
/** 備份檔名用的緊湊時間戳（台北時區）：yyyyMMddHHmmss。 */
|
||||
function taipeiCompactStamp(date = new Date()) {
|
||||
const shifted = new Date(Math.floor(date.getTime() / 1000) * 1000 + TAIPEI_OFFSET_MS);
|
||||
const pad = (n) => String(n).padStart(2, "0");
|
||||
return (
|
||||
`${shifted.getUTCFullYear()}${pad(shifted.getUTCMonth() + 1)}${pad(shifted.getUTCDate())}` +
|
||||
`${pad(shifted.getUTCHours())}${pad(shifted.getUTCMinutes())}${pad(shifted.getUTCSeconds())}`
|
||||
);
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 值的形狀判斷（全部靠值的形狀，不靠欄位名稱白名單）
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
const Z_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
|
||||
const TW_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\+08:00$/;
|
||||
const DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
|
||||
|
||||
/** 形狀對了還要日曆上真的存在（擋 2026-13-40 之類假日期），做法跟 persona-lib.mjs 的 isYmd 一樣。 */
|
||||
function isValidCalendarDate(value) {
|
||||
if (!DATE_RE.test(value)) return false;
|
||||
const d = new Date(`${value}T00:00:00Z`);
|
||||
return !Number.isNaN(d.getTime()) && d.toISOString().slice(0, 10) === value;
|
||||
}
|
||||
|
||||
/** 一個物件自己身上（不含巢狀子物件）所有完整時間戳，換算後的台北曆日集合。 */
|
||||
function siblingTaipeiDates(obj) {
|
||||
const dates = new Set();
|
||||
for (const value of Object.values(obj)) {
|
||||
if (typeof value !== "string") continue;
|
||||
if (Z_RE.test(value) || TW_RE.test(value)) {
|
||||
const t = new Date(value).getTime();
|
||||
if (!Number.isNaN(t)) dates.add(taipeiDateFromEpoch(t));
|
||||
}
|
||||
}
|
||||
return dates;
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 樹狀掃描：只算出「該怎麼改」，完全不動傳進來的物件、也不寫檔
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
/**
|
||||
* 掃一個檔案已經 parse 好的 JSON 樹。
|
||||
* 回報三種結果：
|
||||
* changes 要改的欄位（timestamp：Z→+08:00；datekey：日期鍵重算）
|
||||
* undetermined 純日期欄位但推算不出正確台北日，維持原值
|
||||
* conflicts 同一個陣列裡兩筆以上成員重算後撞在同一個台北日
|
||||
*/
|
||||
function scanTree(root, fileLabel) {
|
||||
const changes = [];
|
||||
const undetermined = [];
|
||||
const conflicts = [];
|
||||
|
||||
function visitObject(obj, pathArr) {
|
||||
const resolvable = siblingTaipeiDates(obj);
|
||||
for (const [key, value] of Object.entries(obj)) {
|
||||
if (typeof value === "string") {
|
||||
if (Z_RE.test(value)) {
|
||||
const epochOld = new Date(value).getTime();
|
||||
const newValue = taipeiIsoFromEpoch(epochOld);
|
||||
changes.push({
|
||||
file: fileLabel,
|
||||
path: [...pathArr, key],
|
||||
kind: "timestamp",
|
||||
oldValue: value,
|
||||
newValue,
|
||||
epochOld,
|
||||
epochNew: new Date(newValue).getTime(),
|
||||
});
|
||||
} else if (DATE_RE.test(value) && isValidCalendarDate(value)) {
|
||||
if (resolvable.size === 1) {
|
||||
const [only] = resolvable;
|
||||
if (only !== value) {
|
||||
changes.push({ file: fileLabel, path: [...pathArr, key], kind: "datekey", oldValue: value, newValue: only });
|
||||
}
|
||||
} else if (resolvable.size === 0) {
|
||||
undetermined.push({
|
||||
file: fileLabel,
|
||||
path: [...pathArr, key],
|
||||
value,
|
||||
reason: "同一物件裡找不到可用的完整時間戳",
|
||||
});
|
||||
} else {
|
||||
undetermined.push({
|
||||
file: fileLabel,
|
||||
path: [...pathArr, key],
|
||||
value,
|
||||
reason: `同一物件裡有 ${resolvable.size} 個互相矛盾的時間戳（${[...resolvable].join(" / ")}），無法判斷歸屬哪個台北日`,
|
||||
});
|
||||
}
|
||||
}
|
||||
} else if (value && typeof value === "object") {
|
||||
visit(value, [...pathArr, key]);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/** 同一個陣列裡，兩筆以上物件成員共用同一個欄位名稱、原始值不同，卻重算成同一個台北日。 */
|
||||
function detectArrayConflicts(arr, pathArr) {
|
||||
const objItems = arr
|
||||
.map((item, i) => ({ item, i }))
|
||||
.filter(({ item }) => item && typeof item === "object" && !Array.isArray(item));
|
||||
if (objItems.length < 2) return;
|
||||
const fieldNames = new Set();
|
||||
for (const { item } of objItems) {
|
||||
for (const [k, v] of Object.entries(item)) {
|
||||
if (typeof v === "string" && DATE_RE.test(v) && isValidCalendarDate(v)) fieldNames.add(k);
|
||||
}
|
||||
}
|
||||
for (const field of fieldNames) {
|
||||
const groups = new Map(); // 新值 → [{index, original, item}]
|
||||
for (const { item, i } of objItems) {
|
||||
const raw = item[field];
|
||||
if (typeof raw !== "string" || !DATE_RE.test(raw) || !isValidCalendarDate(raw)) continue;
|
||||
const dates = siblingTaipeiDates(item);
|
||||
if (dates.size !== 1) continue; // 這筆自己就推算不出來，不參與衝突判斷（會落進 undetermined）
|
||||
const [resolved] = dates;
|
||||
if (!groups.has(resolved)) groups.set(resolved, []);
|
||||
groups.get(resolved).push({ index: i, original: raw, item });
|
||||
}
|
||||
for (const [newValue, group] of groups) {
|
||||
if (group.length < 2) continue;
|
||||
const distinctOriginals = new Set(group.map((g) => g.original));
|
||||
if (distinctOriginals.size > 1) {
|
||||
conflicts.push({
|
||||
file: fileLabel,
|
||||
path: [...pathArr],
|
||||
field,
|
||||
newValue,
|
||||
entries: group.map((g) => ({
|
||||
index: g.index,
|
||||
path: [...pathArr, g.index, field],
|
||||
original: g.original,
|
||||
record: g.item,
|
||||
})),
|
||||
});
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
function visit(node, pathArr) {
|
||||
if (Array.isArray(node)) {
|
||||
detectArrayConflicts(node, pathArr);
|
||||
node.forEach((item, i) => {
|
||||
if (item && typeof item === "object") visit(item, [...pathArr, i]);
|
||||
});
|
||||
return;
|
||||
}
|
||||
if (node && typeof node === "object") {
|
||||
visitObject(node, pathArr);
|
||||
}
|
||||
}
|
||||
|
||||
if (Array.isArray(root) || (root && typeof root === "object")) {
|
||||
visit(root, []);
|
||||
} else if (typeof root === "string") {
|
||||
// 罕見邊界：整個檔案的內容就是一個字串（沒有其他欄位可以當 sibling）。
|
||||
if (Z_RE.test(root)) {
|
||||
const epochOld = new Date(root).getTime();
|
||||
const newValue = taipeiIsoFromEpoch(epochOld);
|
||||
changes.push({ file: fileLabel, path: [], kind: "timestamp", oldValue: root, newValue, epochOld, epochNew: new Date(newValue).getTime() });
|
||||
} else if (DATE_RE.test(root) && isValidCalendarDate(root)) {
|
||||
undetermined.push({ file: fileLabel, path: [], value: root, reason: "檔案頂層就是日期字串，沒有其他欄位可用來推算" });
|
||||
}
|
||||
}
|
||||
|
||||
return { changes, undetermined, conflicts };
|
||||
}
|
||||
|
||||
function applyChanges(root, changes) {
|
||||
let newRoot = root;
|
||||
for (const change of changes) {
|
||||
if (change.path.length === 0) {
|
||||
newRoot = change.newValue;
|
||||
continue;
|
||||
}
|
||||
let cur = newRoot;
|
||||
for (let i = 0; i < change.path.length - 1; i++) cur = cur[change.path[i]];
|
||||
cur[change.path[change.path.length - 1]] = change.newValue;
|
||||
}
|
||||
return newRoot;
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 檔案／目錄走訪
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
function listPersonaDirs(home) {
|
||||
let entries;
|
||||
try {
|
||||
entries = fs.readdirSync(home, { withFileTypes: true });
|
||||
} catch {
|
||||
return null; // home 不存在
|
||||
}
|
||||
return entries
|
||||
.filter((e) => e.isDirectory() && e.name !== RUNTIME_DIRNAME && e.name !== ROOMS_DIRNAME && !e.name.startsWith("."))
|
||||
.map((e) => e.name)
|
||||
.sort();
|
||||
}
|
||||
|
||||
function collectJsonFiles(dir) {
|
||||
const out = [];
|
||||
const stack = [dir];
|
||||
while (stack.length) {
|
||||
const cur = stack.pop();
|
||||
let entries;
|
||||
try {
|
||||
entries = fs.readdirSync(cur, { withFileTypes: true });
|
||||
} catch {
|
||||
continue;
|
||||
}
|
||||
for (const e of entries) {
|
||||
const full = path.join(cur, e.name);
|
||||
if (e.isDirectory()) stack.push(full);
|
||||
else if (e.isFile() && e.name.endsWith(".json")) out.push(full);
|
||||
}
|
||||
}
|
||||
return out.sort();
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 前置檢查：有沒有人格正在被載入
|
||||
//
|
||||
// 邏輯仿照 persona-lib.mjs 的 lockIsDead()/liveGuests()（約第 1607～1617 行、
|
||||
// LEASE_SECONDS=900／GUEST_LEASE_SECONDS=1800，約第 23～24 行）：只看心跳租約
|
||||
// 有沒有過期，不靠 pid（CLI process 跑完就結束，不能拿 pid 存活判斷）。
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
const LEASE_SECONDS = 900;
|
||||
const GUEST_LEASE_SECONDS = 1800;
|
||||
|
||||
function readJsonSafe(file) {
|
||||
try {
|
||||
return JSON.parse(fs.readFileSync(file, "utf8"));
|
||||
} catch {
|
||||
return null;
|
||||
}
|
||||
}
|
||||
|
||||
function checkActiveLocks(home, personaDirs) {
|
||||
const active = [];
|
||||
for (const slug of personaDirs) {
|
||||
const lock = readJsonSafe(path.join(home, slug, "state", "lock.json"));
|
||||
if (lock && typeof lock === "object" && lock.heartbeat_at) {
|
||||
const hbAge = (Date.now() - new Date(lock.heartbeat_at).getTime()) / 1000;
|
||||
const lease = Number(lock.lease_seconds) || LEASE_SECONDS;
|
||||
if (Number.isFinite(hbAge) && hbAge <= lease) {
|
||||
active.push({ slug, kind: "lock", session_id: lock.session_id, cwd: lock.cwd, heartbeat_at: lock.heartbeat_at });
|
||||
}
|
||||
}
|
||||
const guestsData = readJsonSafe(path.join(home, slug, "state", "guests.json"));
|
||||
const guests = Array.isArray(guestsData?.guests) ? guestsData.guests : [];
|
||||
for (const g of guests) {
|
||||
if (!g || !g.heartbeat_at) continue;
|
||||
const hbAge = (Date.now() - new Date(g.heartbeat_at).getTime()) / 1000;
|
||||
if (Number.isFinite(hbAge) && hbAge <= GUEST_LEASE_SECONDS) {
|
||||
active.push({ slug, kind: "guest", session_id: g.session_id, room: g.room, heartbeat_at: g.heartbeat_at });
|
||||
}
|
||||
}
|
||||
}
|
||||
return active;
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 備份
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
function backupHome(home) {
|
||||
const parent = path.dirname(home);
|
||||
const dest = path.join(parent, `personas.bak-${taipeiCompactStamp(new Date())}`);
|
||||
fs.cpSync(home, dest, { recursive: true });
|
||||
return dest;
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 執行後驗證
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
function verifyNoLeftoverZ(home, personaDirs) {
|
||||
const offenders = [];
|
||||
for (const slug of personaDirs) {
|
||||
for (const file of collectJsonFiles(path.join(home, slug))) {
|
||||
const text = fs.readFileSync(file, "utf8");
|
||||
// 粗略但夠用：找形似 ISO 時間戳、以 Z 結尾的片段（跟 Z_RE 同一個形狀，
|
||||
// 只是不要求整個字串就是它——用來抓「文件裡還殘留 Z 時間戳」這個粗粒度事實）。
|
||||
const re = /\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z/g;
|
||||
let m;
|
||||
while ((m = re.exec(text))) offenders.push({ file, match: m[0] });
|
||||
}
|
||||
}
|
||||
return offenders;
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// CLI
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
function parseArgs(argv) {
|
||||
const out = { dryRun: false, home: null, help: false };
|
||||
for (let i = 0; i < argv.length; i++) {
|
||||
const a = argv[i];
|
||||
if (a === "--dry-run") out.dryRun = true;
|
||||
else if (a === "--home") out.home = argv[++i];
|
||||
else if (a === "--help" || a === "-h") out.help = true;
|
||||
else {
|
||||
process.stderr.write(`未知的參數：${a}\n`);
|
||||
process.exit(1);
|
||||
}
|
||||
}
|
||||
return out;
|
||||
}
|
||||
|
||||
function printHelp() {
|
||||
process.stdout.write(
|
||||
"用法：node migrate-tz.mjs [--dry-run] [--home <path>]\n" +
|
||||
" --dry-run 只掃描並印出報告，不寫入任何檔案（連備份都不做）\n" +
|
||||
" --home 指定 PERSONA_HOME；不帶時用環境變數 PERSONA_HOME，再退回 ~/.claude/personas\n",
|
||||
);
|
||||
}
|
||||
|
||||
function fmtPath(p) {
|
||||
return p.length ? `/${p.join("/")}` : "(root)";
|
||||
}
|
||||
|
||||
function main() {
|
||||
const args = parseArgs(process.argv.slice(2));
|
||||
if (args.help) {
|
||||
printHelp();
|
||||
return 0;
|
||||
}
|
||||
|
||||
const home = resolveHome(args.home);
|
||||
console.log(`[migrate-tz] PERSONA_HOME = ${home}${args.dryRun ? "（--dry-run，不會寫入任何檔案）" : ""}`);
|
||||
|
||||
const personaDirs = listPersonaDirs(home);
|
||||
if (personaDirs === null) {
|
||||
console.log(`[migrate-tz] 目錄不存在，沒有東西可遷移：${home}`);
|
||||
return 0;
|
||||
}
|
||||
if (personaDirs.length === 0) {
|
||||
console.log(`[migrate-tz] 目錄裡沒有人格子目錄，沒有東西可遷移：${home}`);
|
||||
return 0;
|
||||
}
|
||||
console.log(`[migrate-tz] 找到 ${personaDirs.length} 個人格目錄：${personaDirs.join(", ")}`);
|
||||
|
||||
// a. 前置檢查：有沒有人格正在載入
|
||||
const activeLocks = checkActiveLocks(home, personaDirs);
|
||||
if (activeLocks.length) {
|
||||
console.error("[migrate-tz] 中止：以下人格目前處於載入狀態，不強行執行：");
|
||||
for (const a of activeLocks) {
|
||||
if (a.kind === "lock") {
|
||||
console.error(` - ${a.slug}：exclusive lock（session ${a.session_id}，cwd ${a.cwd}，最後心跳 ${a.heartbeat_at}）`);
|
||||
} else {
|
||||
console.error(` - ${a.slug}：guest 租約（session ${a.session_id}，room ${a.room}，最後心跳 ${a.heartbeat_at}）`);
|
||||
}
|
||||
}
|
||||
console.error("請先讓所有人格釋放鎖（結束對話 / persona status --release）再重跑這支腳本。");
|
||||
return 2;
|
||||
}
|
||||
console.log("[migrate-tz] 前置檢查通過：沒有人格處於載入狀態。");
|
||||
|
||||
// b. 備份（dry-run 完全不寫檔，連備份都不做）
|
||||
let backupDir = null;
|
||||
if (!args.dryRun) {
|
||||
backupDir = backupHome(home);
|
||||
console.log(`[migrate-tz] 已備份到：${backupDir}`);
|
||||
}
|
||||
|
||||
// c/d/e. 掃描整個 PERSONA_HOME，算出全部異動計畫；掃描階段完全不寫檔
|
||||
const perFile = []; // { file, label, root, changes }
|
||||
const allChanges = [];
|
||||
const allUndetermined = [];
|
||||
const allConflicts = [];
|
||||
|
||||
for (const slug of personaDirs) {
|
||||
for (const file of collectJsonFiles(path.join(home, slug))) {
|
||||
const label = path.relative(home, file);
|
||||
const raw = fs.readFileSync(file, "utf8");
|
||||
let root;
|
||||
try {
|
||||
root = JSON.parse(raw);
|
||||
} catch (err) {
|
||||
console.error(`[migrate-tz] 略過（JSON 解析失敗，不會被計入任何統計）：${label} — ${err.message}`);
|
||||
continue;
|
||||
}
|
||||
const { changes, undetermined, conflicts } = scanTree(root, label);
|
||||
if (changes.length) perFile.push({ file, label, root, changes });
|
||||
allChanges.push(...changes);
|
||||
allUndetermined.push(...undetermined);
|
||||
allConflicts.push(...conflicts);
|
||||
}
|
||||
}
|
||||
|
||||
const tsChanges = allChanges.filter((c) => c.kind === "timestamp");
|
||||
const dateChanges = allChanges.filter((c) => c.kind === "datekey");
|
||||
const filesChanged = new Set(perFile.map((f) => f.label));
|
||||
|
||||
console.log("");
|
||||
console.log("========== 掃描報告 ==========");
|
||||
console.log(`將改動的檔案數：${filesChanged.size}`);
|
||||
console.log(`時間戳欄位（Z → +08:00）：${tsChanges.length}`);
|
||||
console.log(`日期鍵欄位（重算台北曆日）：${dateChanges.length}`);
|
||||
console.log(`無法確定（維持原值，需人工檢視）：${allUndetermined.length}`);
|
||||
console.log(`合併衝突：${allConflicts.length}`);
|
||||
|
||||
if (allUndetermined.length) {
|
||||
console.log("");
|
||||
console.log("---- 無法確定，需人工檢視 ----");
|
||||
for (const u of allUndetermined) {
|
||||
console.log(` ${u.file}${fmtPath(u.path)} = "${u.value}" — ${u.reason}`);
|
||||
}
|
||||
}
|
||||
|
||||
if (allConflicts.length) {
|
||||
console.log("");
|
||||
console.log("---- 合併衝突（未寫入任何檔案，需人工決定合併方式後重跑） ----");
|
||||
for (const c of allConflicts) {
|
||||
console.log(` 檔案 ${c.file}，陣列 ${fmtPath(c.path)}，欄位 \`${c.field}\`，重算後都落在 ${c.newValue}：`);
|
||||
for (const e of c.entries) {
|
||||
console.log(` - [${e.index}] 原始值 ${e.original}：${JSON.stringify(e.record)}`);
|
||||
}
|
||||
}
|
||||
console.error("");
|
||||
console.error(`[migrate-tz] 中止：偵測到 ${allConflicts.length} 組合併衝突，不寫入任何檔案。`);
|
||||
console.error("請先人工決定怎麼合併上面列出的紀錄，再重新執行這支腳本。");
|
||||
return 3;
|
||||
}
|
||||
|
||||
if (args.dryRun) {
|
||||
console.log("");
|
||||
console.log("[migrate-tz] --dry-run：以上為預覽，沒有寫入任何檔案。");
|
||||
return 0;
|
||||
}
|
||||
|
||||
if (filesChanged.size === 0) {
|
||||
console.log("");
|
||||
console.log("[migrate-tz] 沒有需要修改的欄位（可能已經是 +08:00 格式，或本來就沒有需要換算的資料）。");
|
||||
return 0;
|
||||
}
|
||||
|
||||
// 落筆：只有掃描完全結束、確定沒有合併衝突，才寫入
|
||||
for (const { file, root, changes } of perFile) {
|
||||
const newRoot = applyChanges(root, changes);
|
||||
const tmp = `${file}.tmp${process.pid}`;
|
||||
fs.writeFileSync(tmp, JSON.stringify(newRoot, null, 2) + "\n", "utf8");
|
||||
fs.renameSync(tmp, file);
|
||||
}
|
||||
console.log("");
|
||||
console.log(`[migrate-tz] 已寫入 ${filesChanged.size} 個檔案：`);
|
||||
for (const label of filesChanged) console.log(` - ${label}`);
|
||||
|
||||
// e. 執行後自動驗證
|
||||
console.log("");
|
||||
console.log("========== 執行後驗證 ==========");
|
||||
const leftover = verifyNoLeftoverZ(home, personaDirs);
|
||||
if (leftover.length) {
|
||||
console.error(`[migrate-tz] 嚴重錯誤：全樹掃描後仍找到 ${leftover.length} 個 Z 結尾的時間戳，遷移不完整：`);
|
||||
for (const o of leftover) console.error(` - ${o.file}: ${o.match}`);
|
||||
return 4;
|
||||
}
|
||||
console.log("(i) 全樹已無殘留的 Z 結尾時間戳：通過。");
|
||||
|
||||
const epochMismatches = tsChanges.filter((c) => c.epochOld !== c.epochNew);
|
||||
if (epochMismatches.length) {
|
||||
console.error(`[migrate-tz] 嚴重錯誤：${epochMismatches.length} 個時間戳欄位轉換前後 epoch 不相等：`);
|
||||
for (const m of epochMismatches) {
|
||||
console.error(` - ${m.file}${fmtPath(m.path)}：${m.oldValue}（${m.epochOld}） → ${m.newValue}（${m.epochNew}）`);
|
||||
}
|
||||
return 4;
|
||||
}
|
||||
console.log(`(ii) ${tsChanges.length} 個時間戳欄位逐一驗證轉換前後 epoch 相等：通過。`);
|
||||
|
||||
console.log("");
|
||||
console.log(`[migrate-tz] 完成。備份保留於：${backupDir}`);
|
||||
return 0;
|
||||
}
|
||||
|
||||
process.exit(main());
|
||||
+19
-11
@@ -77,7 +77,7 @@ export async function nextCodeAcrossMachines(romaji, { owner = null } = {}) {
|
||||
const taken = remote.personas.map((p) => p.code);
|
||||
return { code: nextCode(romaji, { taken }), checked_remote: true, taken };
|
||||
} catch (err) {
|
||||
return { code: local, checked_remote: false, reason: String(err.message || err) };
|
||||
return { code: local, checked_remote: false, reason: pl.redactSecrets(String(err.message || err)) };
|
||||
}
|
||||
}
|
||||
|
||||
@@ -178,6 +178,8 @@ export function updateSyncState(slug, mutate) {
|
||||
// 環境與 API
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
// giteaEnv()／giteaProblem() 實作 /jsc-shared:spec-gitea 的『token 解析優先序』章節：
|
||||
// 專用變數（PERSONA_GITEA_TOKEN）插在最前面，其次才是 GITEA_TOKEN，順序不可打亂。
|
||||
export function giteaEnv() {
|
||||
const host = String(process.env.PERSONA_GITEA_HOST || process.env.GITEA_HOST || "").replace(/\/+$/, "");
|
||||
const token = String(process.env.PERSONA_GITEA_TOKEN || process.env.GITEA_TOKEN || "");
|
||||
@@ -194,6 +196,8 @@ export function giteaProblem() {
|
||||
return null;
|
||||
}
|
||||
|
||||
// api() 實作 /jsc-shared:spec-gitea 的『API 呼叫慣例』章節：
|
||||
// base 為 `${host}/api/v1`，標頭帶 `Authorization: token <token>`，body 一律 UTF-8 JSON。
|
||||
async function api(method, route, body = null) {
|
||||
const { host, token } = giteaEnv();
|
||||
const res = await fetch(`${host}/api/v1${route}`, {
|
||||
@@ -223,7 +227,7 @@ export async function giteaLogin() {
|
||||
const cached = pl.readJson(ownerCachePath(), {}) ?? {};
|
||||
if (cached.host === env.host && cached.login) return cached.login;
|
||||
const res = await api("GET", "/user");
|
||||
if (!res.ok || !res.json?.login) throw new Error(`取不到 Gitea 帳號（HTTP ${res.status}）：${res.text.slice(0, 120)}`);
|
||||
if (!res.ok || !res.json?.login) throw new Error(`取不到 Gitea 帳號（HTTP ${res.status}）：${pl.redactSecrets(res.text).slice(0, 120)}`);
|
||||
pl.writeJson(ownerCachePath(), { host: env.host, login: res.json.login, cached_at: pl.nowIso() });
|
||||
return res.json.login;
|
||||
}
|
||||
@@ -241,7 +245,7 @@ async function listRepos(owner, me) {
|
||||
const out = [];
|
||||
for (let page = 1; page <= 40; page += 1) {
|
||||
const res = await api("GET", `${route}?page=${page}&limit=50`);
|
||||
if (!res.ok) throw new Error(`列出 ${owner} 的存取庫失敗（HTTP ${res.status}）：${res.text.slice(0, 160)}`);
|
||||
if (!res.ok) throw new Error(`列出 ${owner} 的存取庫失敗（HTTP ${res.status}）：${pl.redactSecrets(res.text).slice(0, 160)}`);
|
||||
const batch = Array.isArray(res.json) ? res.json : [];
|
||||
out.push(...batch);
|
||||
if (batch.length < 50) break;
|
||||
@@ -304,7 +308,7 @@ export async function ensureRepo(owner, code, { description = "", private_ = tru
|
||||
description: description || `jsc-persona 人格 ${code}`,
|
||||
auto_init: false,
|
||||
});
|
||||
if (!res.ok) throw new Error(`建立存取庫 ${owner}/${code} 失敗（HTTP ${res.status}）：${res.text.slice(0, 160)}`);
|
||||
if (!res.ok) throw new Error(`建立存取庫 ${owner}/${code} 失敗（HTTP ${res.status}）：${pl.redactSecrets(res.text).slice(0, 160)}`);
|
||||
void env;
|
||||
return { repo: res.json, created: true };
|
||||
}
|
||||
@@ -318,7 +322,7 @@ export async function ensureWikiHome(owner, code, content) {
|
||||
content_base64: Buffer.from(content, "utf8").toString("base64"),
|
||||
message: "init: 人格設定百科",
|
||||
});
|
||||
if (!res.ok) throw new Error(`建立 Wiki 首頁失敗（HTTP ${res.status}）：${res.text.slice(0, 160)}`);
|
||||
if (!res.ok) throw new Error(`建立 Wiki 首頁失敗（HTTP ${res.status}）：${pl.redactSecrets(res.text).slice(0, 160)}`);
|
||||
return true;
|
||||
}
|
||||
|
||||
@@ -367,7 +371,7 @@ export function git(args, cwd = null) {
|
||||
|
||||
function gitOrThrow(args, cwd, what) {
|
||||
const res = git(args, cwd);
|
||||
if (!res.ok) throw new Error(`${what} 失敗：git ${args.join(" ")}\n ${res.stderr || res.stdout}`);
|
||||
if (!res.ok) throw new Error(`${what} 失敗：git ${args.join(" ")}\n ${pl.redactSecrets(res.stderr || res.stdout)}`);
|
||||
return res;
|
||||
}
|
||||
|
||||
@@ -478,6 +482,10 @@ const WIKI_PREFIX = { memory: "Memory", mindmap: "Mindmap", relations: "Relation
|
||||
* Gitea 的 wiki **只有根目錄的 .md 會變成頁面**（1.27 實測：子目錄頁面連結 404），
|
||||
* 所以低頻區的檔案要攤平成根層檔名（`memory/long-term/x.md` → `Memory-x.md`，
|
||||
* 網頁上顯示為「Memory x」），再用 `_paths.json` 記住原本的路徑，pull 時才還原得回去。
|
||||
*
|
||||
* 對應 /jsc-shared:spec-gitea 的『Wiki 頁名轉義規則』第 3 點：本檔走 git clone/push
|
||||
* 直接寫檔名，不反推 Gitea 的 title↔sub_url 內部轉義，改用 `_paths.json` manifest
|
||||
* 自己記住「工作路徑 → 儲存檔名」的對應。
|
||||
*/
|
||||
export function wikiName(rel) {
|
||||
if (!rel.includes("/")) return rel;
|
||||
@@ -718,7 +726,7 @@ export async function pushArea(slug, area, { message = "", code = null, owner =
|
||||
});
|
||||
return { ok: true, changed: false, files: staged.length, area, code: theCode };
|
||||
}
|
||||
gitOrThrow(["commit", "-q", "-m", message || `sync(${area}): ${pl.nowIso()}`], dir, "git commit");
|
||||
gitOrThrow(["commit", "-q", "-m", message || `sync(${area}): ${pl.nowDisplay()}`], dir, "git commit");
|
||||
let pushed = git(["push", "-q", "-u", "origin", "HEAD"], dir);
|
||||
let overwrote = null;
|
||||
if (!pushed.ok) {
|
||||
@@ -754,7 +762,7 @@ export async function pushArea(slug, area, { message = "", code = null, owner =
|
||||
}
|
||||
pushed = git(["push", "-q", "-u", "origin", "HEAD"], dir);
|
||||
}
|
||||
if (!pushed.ok) return { ok: false, area, code: theCode, reason: pushed.stderr || pushed.stdout };
|
||||
if (!pushed.ok) return { ok: false, area, code: theCode, reason: pl.redactSecrets(pushed.stderr || pushed.stdout) };
|
||||
updateSyncState(slug, (state) => {
|
||||
state.code = theCode;
|
||||
state.owner = theOwner;
|
||||
@@ -802,7 +810,7 @@ export async function pullArea(slug, area, { code = null, owner = null, force =
|
||||
clearStaleIndexLock(dir);
|
||||
const localChanged = new Set(statusPaths(dir));
|
||||
const fetched = git(["fetch", "--quiet", "origin"], dir);
|
||||
if (!fetched.ok) return { ok: false, area, reason: fetched.stderr || "fetch 失敗" };
|
||||
if (!fetched.ok) return { ok: false, area, reason: pl.redactSecrets(fetched.stderr) || "fetch 失敗" };
|
||||
const head = git(["rev-parse", "--abbrev-ref", "HEAD"], dir).stdout || "main";
|
||||
const remoteRef = `origin/${head}`;
|
||||
const exists = git(["rev-parse", "--verify", "--quiet", remoteRef], dir);
|
||||
@@ -815,7 +823,7 @@ export async function pullArea(slug, area, { code = null, owner = null, force =
|
||||
}
|
||||
git(["checkout", "--", "."], dir);
|
||||
const reset = git(["reset", "--hard", "--quiet", remoteRef], dir);
|
||||
if (!reset.ok) return { ok: false, area, reason: reset.stderr };
|
||||
if (!reset.ok) return { ok: false, area, reason: pl.redactSecrets(reset.stderr) };
|
||||
// 只寫回「遠端真的改過的」與「本機缺少的」。
|
||||
// 不能無差別覆蓋：本機有較新但還沒 push 的內容時，那會把它蓋掉。
|
||||
const root = pl.personaDir(slug);
|
||||
@@ -920,7 +928,7 @@ export async function importFromRemote(code, { owner = null, slug = null, force
|
||||
// 本機是空的，衝突判定沒有意義；覆蓋既有人格時使用者已經明講了 --force
|
||||
results[area] = await pullArea(target, area, { code, owner: theOwner, force: true });
|
||||
} catch (err) {
|
||||
results[area] = { ok: false, area, reason: String(err.message || err) };
|
||||
results[area] = { ok: false, area, reason: pl.redactSecrets(String(err.message || err)) };
|
||||
}
|
||||
}
|
||||
if (!pl.personaExists(target)) {
|
||||
|
||||
+68
-9
@@ -129,7 +129,20 @@ export function setDefaultPersona(slug) {
|
||||
// 時間與檔案 IO
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
export const iso = (date = new Date()) => new Date(Math.floor(date.getTime() / 1000) * 1000).toISOString().replace(".000Z", "Z");
|
||||
const TAIPEI_OFFSET_MS = 8 * 60 * 60 * 1000;
|
||||
|
||||
/**
|
||||
* 產生帶 `+08:00`（Asia/Taipei）offset 的 ISO 字串，例如 `2026-08-11T10:10:13+08:00`。
|
||||
* 這是等值時區轉換：輸出代表跟輸入 `date` 完全相同的瞬間（epoch 不變），
|
||||
* 只是把「顯示的牆上時間」換成台北時區，而不是原本 UTC 的 `Z`。
|
||||
* `parseIso()`／`new Date()` 都能正確解析回相同的 epoch，既有時間差運算不受影響。
|
||||
*/
|
||||
export const iso = (date = new Date()) => {
|
||||
const truncated = new Date(Math.floor(date.getTime() / 1000) * 1000);
|
||||
const shifted = new Date(truncated.getTime() + TAIPEI_OFFSET_MS);
|
||||
const pad = (n) => String(n).padStart(2, "0");
|
||||
return `${shifted.getUTCFullYear()}-${pad(shifted.getUTCMonth() + 1)}-${pad(shifted.getUTCDate())}T${pad(shifted.getUTCHours())}:${pad(shifted.getUTCMinutes())}:${pad(shifted.getUTCSeconds())}+08:00`;
|
||||
};
|
||||
export const nowIso = () => iso(new Date());
|
||||
|
||||
export function parseIso(value) {
|
||||
@@ -138,6 +151,26 @@ export function parseIso(value) {
|
||||
return Number.isNaN(dt.getTime()) ? null : dt;
|
||||
}
|
||||
|
||||
/**
|
||||
* 給人看的顯示字串（不可被 `new Date()` 解析）：Asia/Taipei 時區、`yyyy/MM/dd HH:mm:ss`。
|
||||
* 用途：任何要印給使用者看或寫進 log 訊息的地方，依 /jsc-shared:spec-time-log 規定的格式。
|
||||
*/
|
||||
export function nowDisplay(date = new Date()) {
|
||||
const shifted = new Date(Math.floor(date.getTime() / 1000) * 1000 + TAIPEI_OFFSET_MS);
|
||||
const pad = (n) => String(n).padStart(2, "0");
|
||||
return `${shifted.getUTCFullYear()}/${pad(shifted.getUTCMonth() + 1)}/${pad(shifted.getUTCDate())} ${pad(shifted.getUTCHours())}:${pad(shifted.getUTCMinutes())}:${pad(shifted.getUTCSeconds())}`;
|
||||
}
|
||||
|
||||
/**
|
||||
* 該時刻依台北曆日計算的 `yyyy-MM-dd` 日期字串，取代錯誤的 `nowIso().slice(0, 10)`（那是 UTC 當天）。
|
||||
* 例如 UTC `2026-08-10T16:30:00Z`（台北 `2026-08-11 00:30`）要回傳 `2026-08-11`。
|
||||
*/
|
||||
export function todayTaipei(date = new Date()) {
|
||||
const shifted = new Date(Math.floor(date.getTime() / 1000) * 1000 + TAIPEI_OFFSET_MS);
|
||||
const pad = (n) => String(n).padStart(2, "0");
|
||||
return `${shifted.getUTCFullYear()}-${pad(shifted.getUTCMonth() + 1)}-${pad(shifted.getUTCDate())}`;
|
||||
}
|
||||
|
||||
export function ageSeconds(value) {
|
||||
const dt = parseIso(value);
|
||||
if (!dt) return Infinity;
|
||||
@@ -686,7 +719,7 @@ export function loadDayMood(slug) {
|
||||
const data = readJson(dayMoodPath(slug), {}) ?? {};
|
||||
const num = (v) => (Number.isFinite(Number(v)) ? Number(v) : 0);
|
||||
return {
|
||||
date: typeof data.date === "string" ? data.date : nowIso().slice(0, 10),
|
||||
date: typeof data.date === "string" ? data.date : todayTaipei(),
|
||||
valence: clamp(num(data.valence), -100, 100),
|
||||
arousal: clamp(num(data.arousal), 0, 100),
|
||||
samples: Math.max(0, Math.floor(num(data.samples))),
|
||||
@@ -701,7 +734,7 @@ export function loadDayMood(slug) {
|
||||
export function updateDayMood(slug, state = null) {
|
||||
return withFileLock(dayMoodPath(slug), () => {
|
||||
const day = loadDayMood(slug);
|
||||
const today = nowIso().slice(0, 10);
|
||||
const today = todayTaipei();
|
||||
if (day.date !== today) {
|
||||
day.valence = Math.round(day.valence * DAY_MOOD_CARRY * 10) / 10;
|
||||
day.arousal = Math.round(day.arousal * DAY_MOOD_CARRY * 10) / 10;
|
||||
@@ -724,7 +757,7 @@ export function sleepDayMood(slug) {
|
||||
const day = loadDayMood(slug);
|
||||
day.valence = Math.round(day.valence * DAY_MOOD_CARRY * 10) / 10;
|
||||
day.arousal = Math.round(day.arousal * DAY_MOOD_CARRY * 10) / 10;
|
||||
day.date = nowIso().slice(0, 10);
|
||||
day.date = todayTaipei();
|
||||
day.samples = 0;
|
||||
day.updated_at = nowIso();
|
||||
writeJson(dayMoodPath(slug), day);
|
||||
@@ -2759,7 +2792,7 @@ export function writeLongTermMemory(slug, {
|
||||
const file = path.join(longTermDir(slug), `${name}.md`);
|
||||
let existing = {};
|
||||
if (fs.existsSync(file)) [existing] = parseFrontMatter(fs.readFileSync(file, "utf8"));
|
||||
const today = nowIso().slice(0, 10);
|
||||
const today = todayTaipei();
|
||||
const stamp = contextStamp(slug);
|
||||
// `gist` 明寫時，`detail` 沒給就是**沒有細節**——退回整份 body 會讓主旨之外
|
||||
// 再抄一次全文，那是把「衰減先吃細節」這件事整個抵銷掉。
|
||||
@@ -2844,7 +2877,7 @@ export function writeChapter(slug, { name, title = "", from = "", to = "", body
|
||||
"---",
|
||||
`name: ${key}`,
|
||||
`title: ${fm(title || existing.title || name).slice(0, 120)}`,
|
||||
`from: ${fm(from) || existing.from || nowIso().slice(0, 10)}`,
|
||||
`from: ${fm(from) || existing.from || todayTaipei()}`,
|
||||
// `to` 空著＝還在這一段裡。所以沒有值就**不寫這一行**，不要寫成 `to: `。
|
||||
...((fm(to) || existing.to) ? [`to: ${fm(to) || existing.to}`] : []),
|
||||
`updated_at: ${nowIso()}`,
|
||||
@@ -2900,7 +2933,7 @@ export function currentChapter(slug) {
|
||||
}
|
||||
|
||||
/** 收掉一段（寫上 `to`）。找不到那一段回 null。 */
|
||||
export function closeChapter(slug, name, at = nowIso().slice(0, 10)) {
|
||||
export function closeChapter(slug, name, at = todayTaipei()) {
|
||||
const key = slugify(name);
|
||||
if (!fs.existsSync(chapterPath(slug, key))) return null;
|
||||
return writeChapter(slug, { name: key, to: at });
|
||||
@@ -2927,7 +2960,7 @@ export function rebuildIndex(slug) {
|
||||
const lines = [
|
||||
"# 長期記憶索引",
|
||||
"",
|
||||
`<!-- 由 persona.mjs 自動產生，最後更新 ${nowIso()}；一則記憶一行 -->`,
|
||||
`<!-- 由 persona.mjs 自動產生，最後更新 ${nowDisplay()}；一則記憶一行 -->`,
|
||||
"",
|
||||
];
|
||||
const sorted = [...entries].sort((a, b) => Number(b.salience || 0) - Number(a.salience || 0));
|
||||
@@ -3244,7 +3277,7 @@ export function markShortTermReviewed(slug, { indexes = null, until = null, prom
|
||||
*/
|
||||
export function touchRecall(slug, names) {
|
||||
const wanted = new Set(names);
|
||||
const today = nowIso().slice(0, 10);
|
||||
const today = todayTaipei();
|
||||
for (const meta of longTermEntries(slug)) {
|
||||
if (!wanted.has(meta._name)) continue;
|
||||
let text;
|
||||
@@ -6104,6 +6137,32 @@ export function injectSafeLine(text, limit = 0) {
|
||||
return limit > 0 ? one.slice(0, limit) : one;
|
||||
}
|
||||
|
||||
// --------------------------------------------------------------------------- //
|
||||
// 機密遮蔽（port 自 doc/scripts/worklog/transcript.py 的 REDACT_PATTERNS，
|
||||
// 為 /jsc-shared:spec-gitea『機密遮蔽實作』章節的來源依據；本檔僅共用定義，
|
||||
// 套用地點見 A0-4：persona 側 Gitea 錯誤遮蔽）
|
||||
// --------------------------------------------------------------------------- //
|
||||
|
||||
const REDACT_PATTERNS = [
|
||||
[/[A-Za-z0-9_-]*:[A-Za-z0-9_-]{16,}@/g, "***@"], // URL 內嵌憑證 user:token@
|
||||
[/\b[0-9a-f]{40}\b/g, "***"], // Gitea 40 字元 token
|
||||
[/\bgh[pousr]_[A-Za-z0-9_]{16,}\b/g, "***"], // GitHub token
|
||||
[/\bsk-[A-Za-z0-9\-_]{16,}\b/g, "***"], // API key
|
||||
[/\b(token|password|passwd|pwd|secret|api[_-]?key)\b\s*[:=]\s*\S+/gi, "$1=***"],
|
||||
[/Authorization:\s*(token|bearer)\s+\S+/gi, "Authorization: $1 ***"],
|
||||
[/[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Za-z]{2,}/g, "***"], // Email
|
||||
[/\b09\d{2}[-\s]?\d{3}[-\s]?\d{3}\b/g, "***"], // 台灣手機
|
||||
[/\b[A-Z][12]\d{8}\b/g, "***"], // 身分證字號
|
||||
];
|
||||
|
||||
/** 對文字依序套用全部機密遮蔽規則，回傳遮蔽後的結果。 */
|
||||
// 本檔遮蔽規則對應 shared/scripts/lib/redact-patterns.json（經 /jsc-shared:spec-gitea 收斂）
|
||||
export function redactSecrets(text) {
|
||||
let out = String(text ?? "");
|
||||
for (const [pattern, replacement] of REDACT_PATTERNS) out = out.replace(pattern, replacement);
|
||||
return out;
|
||||
}
|
||||
|
||||
export function identityFields(slug) {
|
||||
const fields = {};
|
||||
let text;
|
||||
|
||||
+7
-7
@@ -479,7 +479,7 @@ commands.release = async ({ flags }) => {
|
||||
if (!flags["no-gitea"] && !gt.giteaProblem() && pl.personaExists(slug) && gt.personaCode(slug)) {
|
||||
for (const area of gt.AREA_KEYS) {
|
||||
try {
|
||||
const res = await gt.pushArea(slug, area, { message: `release: 對話結束 ${pl.nowIso()}` });
|
||||
const res = await gt.pushArea(slug, area, { message: `release: 對話結束 ${pl.nowDisplay()}` });
|
||||
if (res.ok && res.changed) say(` ↑ ${gt.AREAS[area].label}已推上 Gitea。`);
|
||||
else if (!res.ok && !res.skipped) say(` ⚠ ${gt.AREAS[area].label}推送失敗：${String(res.reason).slice(0, 120)}`);
|
||||
} catch (err) {
|
||||
@@ -594,7 +594,7 @@ commands.sleep = async ({ flags }) => {
|
||||
} else {
|
||||
for (const area of gt.AREA_KEYS) {
|
||||
try {
|
||||
const res = await gt.pushArea(slug, area, { message: `sleep: 收尾 ${pl.nowIso()}` });
|
||||
const res = await gt.pushArea(slug, area, { message: `sleep: 收尾 ${pl.nowDisplay()}` });
|
||||
sync[area] = res.ok ? (res.changed ? "pushed" : "no-change") : `failed: ${String(res.reason).slice(0, 80)}`;
|
||||
} catch (err) {
|
||||
sync[area] = `failed: ${String(err.message).slice(0, 80)}`;
|
||||
@@ -1896,7 +1896,7 @@ commands.mindmap = ({ flags, positional }) => {
|
||||
if (!fs.existsSync(file) || flags.force) {
|
||||
pl.writeText(file, [
|
||||
`%% 思維導圖（短期）：${topic}`,
|
||||
`%% created: ${pl.nowIso()} ttl: short-term（固化後請併入 semantic.mmd 並刪除）`,
|
||||
`%% created: ${pl.nowDisplay()} ttl: short-term（固化後請併入 semantic.mmd 並刪除）`,
|
||||
"graph LR",
|
||||
` trigger["觸發：${topic}"] --> obs["觀察"]`,
|
||||
' obs --> infer["推論"]',
|
||||
@@ -2019,7 +2019,7 @@ commands.relation = ({ flags, positional }) => {
|
||||
if (!open.length) die(`跟 \`${node.name || key}\` 之間沒有還沒和好的事。`);
|
||||
const target = about ? open.filter((r) => String(r.about).includes(about)) : open;
|
||||
if (!target.length) die(`找不到「${about}」這一件（還沒和好的有：${open.map((r) => r.about).join("／")}）。`);
|
||||
for (const r of target) r.healed_at = pl.nowIso().slice(0, 10);
|
||||
for (const r of target) r.healed_at = pl.todayTaipei();
|
||||
node.updated_at = pl.nowIso();
|
||||
pl.writeJson(pl.relationsJson(slug), data);
|
||||
pl.renderRelations(slug);
|
||||
@@ -2038,7 +2038,7 @@ commands.relation = ({ flags, positional }) => {
|
||||
return;
|
||||
}
|
||||
node.rifts.push({
|
||||
at: str(flags.at) || pl.nowIso().slice(0, 10),
|
||||
at: str(flags.at) || pl.todayTaipei(),
|
||||
about,
|
||||
// 帶上長期記憶的名字，人格要細節自己 recall——不必等使用者提起那件事。
|
||||
...(str(flags.memory) ? { memory: str(flags.memory) } : {}),
|
||||
@@ -2079,7 +2079,7 @@ commands.relation = ({ flags, positional }) => {
|
||||
node.style[facet] = {
|
||||
value,
|
||||
except: str(flags.except) || null, // 形如 anger>=40：情緒成立時這條規則暫停
|
||||
since: str(flags.since) || pl.nowIso().slice(0, 10),
|
||||
since: str(flags.since) || pl.todayTaipei(),
|
||||
};
|
||||
ok(`\`${node.name || node.id}\`：${facet}→「${value}」${str(flags.except) ? `（例外 ${str(flags.except)}）` : ""} 已記下。`);
|
||||
}
|
||||
@@ -2999,7 +2999,7 @@ commands.icon = async ({ flags, positional }) => {
|
||||
? {
|
||||
url: str(flags["source-url"]),
|
||||
note: str(flags["source-note"]) || null,
|
||||
date: str(flags["source-date"]) || pl.nowIso().slice(0, 10),
|
||||
date: str(flags["source-date"]) || pl.todayTaipei(),
|
||||
}
|
||||
: null;
|
||||
const style = str(flags.style) || null;
|
||||
|
||||
+42
-1
@@ -3773,7 +3773,7 @@ console.log("\n㉝ 故事匯入（novel）：機械的那半");
|
||||
first_seen: "2024-06-14", last_seen: "2024-06-20", salience: 55 }]);
|
||||
cli(["novel", "write", "--session", S_N, "--work", W]);
|
||||
const one = pl.longTermEntries("novelist").find((m) => m._name === "兩年前的劇情");
|
||||
const today = pl.nowIso().slice(0, 10);
|
||||
const today = pl.todayTaipei();
|
||||
return one && one.happened_at === "2024-06-14" && one.happened_until === "2024-06-20" &&
|
||||
one.first_seen === today && one.last_seen === today;
|
||||
})());
|
||||
@@ -3833,6 +3833,47 @@ console.log("\n㉝ 故事匯入（novel）：機械的那半");
|
||||
cli(["release", "--session", S_N]);
|
||||
}
|
||||
|
||||
console.log("\n㉞ 時區工具（todayTaipei / iso / redactSecrets / migrate-tz 冪等性）");
|
||||
{
|
||||
// (a) 時區邊界：UTC 16:00 之後已經跨到台北的隔天，16:00 之前還是同一天。
|
||||
check("UTC 16:30 → 台北已經跨到隔天",
|
||||
pl.todayTaipei(new Date("2026-08-10T16:30:00Z")) === "2026-08-11");
|
||||
check("UTC 15:59 → 台北還沒跨日",
|
||||
pl.todayTaipei(new Date("2026-08-10T15:59:00Z")) === "2026-08-10");
|
||||
|
||||
// (b) iso() 是等值時區轉換，不是加 8 小時再蓋掉：epoch 要完全不變，
|
||||
// 只是換了一套「牆上時間」的顯示格式（+08:00 而不是 Z）。
|
||||
check("iso() 換算前後是同一個瞬間（epoch 相等）", (() => {
|
||||
const src = new Date("2026-08-11T02:10:13Z");
|
||||
return new Date(pl.iso(src)).getTime() === src.getTime();
|
||||
})());
|
||||
check("iso() 輸出以 +08:00 結尾（不是 Z）",
|
||||
/\+08:00$/.test(pl.iso(new Date("2026-08-11T02:10:13Z"))), pl.iso(new Date("2026-08-11T02:10:13Z")));
|
||||
|
||||
// (c) redactSecrets：機密不能原樣留在輸出裡。
|
||||
check("redactSecrets 遮掉 40 字元 hex token 與 email", (() => {
|
||||
const token = "a".repeat(40);
|
||||
const email = "someone@example.com";
|
||||
const out = pl.redactSecrets(`token=${token} 聯絡信箱 ${email}`);
|
||||
return !out.includes(token) && !out.includes(email) && out.includes("***");
|
||||
})());
|
||||
|
||||
// (d) migrate-tz.mjs 冪等性：已經是 +08:00 格式的值不能被誤判成「還沒換算、需要
|
||||
// 再轉一次」。migrate-tz.mjs 的 scanTree() 只對 Z_RE 命中的值產生 timestamp 改寫
|
||||
// （見該檔第 139～140 行、183 行附近），這裡直接複製那兩條正則來驗證判斷邏輯本身：
|
||||
// 一個 +08:00 字串必須落在 TW_RE、絕不可以同時落在 Z_RE，否則會被重複轉換。
|
||||
const Z_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}Z$/;
|
||||
const TW_RE = /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\+08:00$/;
|
||||
check("migrate-tz 判斷邏輯：+08:00 值不會被誤判成待轉換的 Z 值", (() => {
|
||||
const already = "2026-08-11T02:10:13+08:00";
|
||||
return TW_RE.test(already) && !Z_RE.test(already);
|
||||
})());
|
||||
check("migrate-tz 判斷邏輯：Z 值仍然會被正確認出待轉換", (() => {
|
||||
const legacy = "2026-08-11T02:10:13Z";
|
||||
return Z_RE.test(legacy) && !TW_RE.test(legacy);
|
||||
})());
|
||||
}
|
||||
|
||||
console.log(`\n${"=".repeat(60)}\n通過 ${passed} 項，失敗 ${failed} 項 → ${failed === 0 ? "全部通過 ✅" : "有測試失敗 ❌"}`);
|
||||
console.log(`（暫存倉庫留在 ${STORE}，可自行刪除）`);
|
||||
process.exit(failed ? 1 : 0);
|
||||
|
||||
@@ -7,7 +7,15 @@ description: 用「動漫作品名稱 + 角色名稱」快速建立人格：先
|
||||
|
||||
流程：**上網蒐集 → 映射成 OpenClaw 描述 → 建立人格 → 固化成基礎記憶**。
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（所有指令帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，所有指令帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
---
|
||||
|
||||
@@ -237,4 +245,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate \
|
||||
- 使用者若說「這裡不對」→ 直接改 `IDENTITY.md`／`SOUL.md`／對應的 canon 記憶檔，別另建人格。
|
||||
- 之後在對話中發現的新設定，走一般記憶流程（短期 → 達條件 → 固化），
|
||||
不要回頭改 `canon`；`canon` 只放原作設定。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,8 +5,7 @@ description: 載入一個人格並以人格化方式對話：取得該人格的
|
||||
|
||||
# 💬 persona-chat — 以人格對話
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（其他助理用本 plugin 的 `scripts/persona.mjs`）
|
||||
**session**：所有指令帶 `--session <PERSONA_SESSION>`（見上下文中 `PERSONA_SESSION=`；帶錯會被 hook 拒絕）。
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，所有指令帶 `--session <PERSONA_SESSION>`，值見上下文中 `PERSONA_SESSION=`；帶錯會被 hook 拒絕）。
|
||||
**參考**：情緒模型 `reference/emotions.md`、語意分析 `reference/semantic.md`、
|
||||
去 AI 味 `reference/anti-ai-voice.md`。
|
||||
|
||||
@@ -14,6 +13,14 @@ description: 載入一個人格並以人格化方式對話：取得該人格的
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
---
|
||||
|
||||
## 1. 載入（由使用者呼叫，取得獨占鎖）
|
||||
|
||||
**人格只有在使用者要你載入時才載入**（`/jsc-persona:persona-chat <slug>` 或明確說「用 X 跟我聊」）。
|
||||
@@ -415,4 +422,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" mindmap thread --persona <slug>
|
||||
- 想知道別的人格怎麼想 → `/jsc-persona:persona-invite`（透過 sub agent + 聊天室），
|
||||
**不可**去讀他的 `memory/`、`state/`。
|
||||
- 不要手改 `state/lock.json`、`.runtime/`；鎖只由 CLI 維護。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -9,9 +9,19 @@ description: 建立一個新的 AI 人格（persona），並以「與 OpenClaw
|
||||
|
||||
> 要建的是**動漫／漫畫／遊戲的既有角色**？改用 `/jsc-persona:persona-anime`——它會先上網蒐集該角色的公開設定，再自動填這些欄位並固化成基礎記憶。本 skill 用於**原創**人格。
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`
|
||||
（其他助理請改成本 plugin 目錄下的 `scripts/persona.mjs`；以下簡稱 `persona.mjs`）
|
||||
**session**：所有指令都要帶 `--session <PERSONA_SESSION>`，值取自 `<persona-runtime>` 區塊注入的 `PERSONA_SESSION=`。
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，以下簡稱 `persona.mjs`；所有指令都要帶 `--session <PERSONA_SESSION>`，值取自 `<persona-runtime>` 區塊注入的 `PERSONA_SESSION=`）。
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：
|
||||
- spec-version-guard
|
||||
- spec-output
|
||||
- spec-execution
|
||||
- spec-time-log
|
||||
- spec-script-path
|
||||
- spec-ask-user
|
||||
|
||||
---
|
||||
|
||||
@@ -196,4 +206,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" icon generate --session <PERSON
|
||||
|
||||
- **一個程序只能載入一個人格。** 建立即載入；若本 session 已有人格，先 `release`。
|
||||
- 人格倉庫預設在 `~/.claude/personas/<slug>/`，可用環境變數 `PERSONA_HOME` 改。
|
||||
- 所有輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,10 +5,16 @@ description: 產生或更新人格的形象圖（icon.svg + icon.png）：先找
|
||||
|
||||
# 🎨 persona-icon — 依最新造型產生人格形象圖（有臉）
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，帶 `--session <PERSONA_SESSION>`）。
|
||||
**時機**：**人格建立且 IDENTITY／SOUL 補齊之後**——形象綁在最終身分上。
|
||||
**目標**：圖示要是**人物形象圖，看得到臉**；退而求其次才是抽象徽章。
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
**流程**：找高解析度官方圖 → 量測 → **去背** → 裁頭肩 → 合成 → 更新頭像與 Wiki。
|
||||
|
||||
> 找不到可用的官方圖時（沒有設定稿、只有場景截圖且去背不乾淨），
|
||||
@@ -139,4 +145,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sync verify --session <PERSONA_
|
||||
- 已有圖示時要重畫必須加 `--force`。
|
||||
- 不帶 `--palette` 重畫會**沿用 config 裡已存的配色**（不會突然變回雜湊色）。
|
||||
- `.sync/reference.*` 與 `.sync/headshot.png` 是底稿快取，可以安全刪除（不會同步出去）。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -8,7 +8,15 @@ description: 邀請另一個人格透過 sub agent 加入當前對話，形成
|
||||
**跨人格資料隔離的唯一合法交流管道**：聊天室（`.rooms/<room>/transcript.jsonl`）。
|
||||
被邀的人格在 **sub agent** 裡跑，只讀得到自己的人格資料，讀不到主持人格的任何檔案，反之亦然。
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：`spec-version-guard`、`spec-output`、`spec-execution`、`spec-time-log`、`spec-script-path`、`spec-subagent`
|
||||
|
||||
---
|
||||
|
||||
@@ -142,9 +150,10 @@ plugin_root=${CLAUDE_PLUGIN_ROOT}
|
||||
最後一句不是對你說的、你也沒被點名時，不要發言，回傳「（本輪不發言）」。
|
||||
```
|
||||
|
||||
guest 會自己讀 `IDENTITY.md`／`SOUL.md`／自己的記憶與情緒 → 讀聊天室 → `room post` 發言 →
|
||||
需要記的事寫進**自己的 inbox**。它被 hook 綁死在自己的人格目錄，且對人格檔案唯讀。
|
||||
如果同場有多位 guest，就各自開一個 `persona-guest` sub agent，但 `room` 可以共用。
|
||||
派工細節依 `/jsc-shared:spec-subagent`（一個目標一個 sub agent、只讀不寫、回傳結構化結果）；
|
||||
persona-invite 特有的授權寫入範圍：guest 只能寫進**自己的 inbox**——讀 `IDENTITY.md`／`SOUL.md`／
|
||||
自己的記憶與情緒 → 讀聊天室 → `room post` 發言 → 需要記的事寫進 inbox，它被 hook 綁死在自己的人格目錄，
|
||||
且對人格檔案唯讀。如果同場有多位 guest，就各自開一個 `persona-guest` sub agent，但 `room` 可以共用。
|
||||
|
||||
### 4. 一來一回
|
||||
|
||||
@@ -213,4 +222,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation edge \
|
||||
- **輕量邀請**：`invite --guest <slug> --theater off` 不進劇場模式——適合「人格自己想起某個很久沒接觸的人、
|
||||
只想打聲招呼換一輪」的情況（`<persona-context>` 的「很久沒接觸的人」就是依據）。
|
||||
這時仍然要**先問使用者一句**再邀：把整個畫面切走或插進一段對話，是他的決定不是你的。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,11 +5,20 @@ description: 整理人格的記憶系統：把短期記憶固化為長期記憶
|
||||
|
||||
# 🧠 persona-memory — 記憶固化與心智圖維護
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為
|
||||
`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，帶 `--session <PERSONA_SESSION>`）。
|
||||
必須已 exclusive 載入該人格（guest 不能做這件事）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
---
|
||||
|
||||
## 記憶架構
|
||||
|
||||
| 層 | 位置 | 特性 |
|
||||
@@ -246,4 +255,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" probe audit --session <PERSONA_
|
||||
固化的那幾筆要帶 `--from-short`，看過不記的要 `--reviewed`（見上面那張表）。
|
||||
- 想連同情緒衰減、舊紀錄壓縮與 Gitea 同步一起收尾 → 用 `/jsc-persona:persona-sleep`（睡眠）；
|
||||
本 skill 只管記憶與圖，不動情緒也不同步。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -7,7 +7,15 @@ description: 維護人格的人際關係圖：新增或更新人物/人格/群
|
||||
|
||||
資料在 `relations/graph.json`，Mermaid 呈現在 `relations/graph.mmd`（由 CLI 產生，勿手改）。
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
---
|
||||
|
||||
@@ -175,5 +183,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" relation doctor --session <PERS
|
||||
|
||||
把 `relations/graph.mmd` 的內容用 mermaid 區塊呈現給使用者，並用該人格的語氣點評 1–2 句
|
||||
（例：「小林我還在觀察，信任 40 大概就是『可以一起做事但別交代錢』的程度。」）。
|
||||
|
||||
所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,8 +5,15 @@ description: 讓人格睡覺：把一天的活狀態收成能留下來的形狀
|
||||
|
||||
# 🌙 persona-sleep — 睡眠與收尾
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`
|
||||
**session**：所有指令帶 `--session <PERSONA_SESSION>`。
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，所有指令帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path、spec-subagent、spec-gitea、spec-git-safety
|
||||
|
||||
---
|
||||
|
||||
@@ -59,17 +66,20 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sleep --session <PERSONA_SESSIO
|
||||
|
||||
## 情況二：主人格請其他人格去睡（不碰它們的檔案）
|
||||
|
||||
使用者說「叫大家去睡」時，**對每一個要睡的人格**各開一個 sub agent：
|
||||
派工基本規則（一個目標一個 sub agent、回傳結構化結果供主 agent 判讀而非直接面向使用者）
|
||||
詳見 `/jsc-shared:spec-subagent`。套用到睡眠情境：使用者說「叫大家去睡」時，
|
||||
**對每一個要睡的人格**各開一個 sub agent：
|
||||
|
||||
- `subagent_type`：`jsc-persona:persona-sleeper`
|
||||
- prompt 內帶：`persona=<slug> session=<PERSONA_SESSION> plugin_root=<CLAUDE_PLUGIN_ROOT>`
|
||||
|
||||
那個 sub agent 就是**那個人格本人**在睡：它自己判斷要記住什麼，寫的是自己的檔案。
|
||||
那個 sub agent 就是**那個人格本人**在睡——它被 pin 在自己的人格上，只能動自己的資料：
|
||||
它自己判斷要記住什麼，寫的是自己的檔案。
|
||||
它手上是 5 分鐘的 sleeper 租約（不是 exclusive 鎖），所以它的每個指令都會帶 `--as-sleeper`——
|
||||
那個旗標只有 persona-sleeper 型的 sub agent 能用，主人格自己帶會被 hook 擋下。
|
||||
帶了它，讀（`brief`／`show`／`recall`）與寫（`consolidate` 等）都算它自己的資料；
|
||||
**回報說「判斷式那半被隔離擋下」十之八九就是漏了這個旗標**，不是它沒有權限。
|
||||
主人格全程不會讀到對方的任何資料——**你只會拿到一份 JSON**：
|
||||
主人格全程不會讀到對方的任何資料——**回傳值只能是 `sleep --json` 的原文**：
|
||||
|
||||
```json
|
||||
{ "persona": "YUI-01", "ok": true, "slept_at": "...", "steps": [ ... ], "sync": { ... }, "kept_lock": true }
|
||||
@@ -122,5 +132,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" sleep --session <PERSONA_SESSIO
|
||||
`sync` 遇到殘留的 `.git/index.lock`（上一次跑到一半被中斷留下的）會自己清掉重試，
|
||||
不用請使用者手動刪，也不要自己對人格目錄下 `rm`——sleeper 的 shell 寫入本來就被 hook 擋著。
|
||||
細節見 `/jsc-persona:persona-sync`。
|
||||
|
||||
所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,10 +5,16 @@ description: 查看與管理人格的載入狀態：列出所有人格、誰被
|
||||
|
||||
# 🔐 persona-status — 載入狀態與鎖管理
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
## 鎖的規則（設計上的硬約束）
|
||||
|
||||
1. **一個人格同時只能被一個程序 exclusive 載入**（鎖 = `state/lock.json`，以 `session_id` 為主鍵）。
|
||||
@@ -86,5 +92,3 @@ node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" default --clear --session <PERS
|
||||
- 🔓 `shen` Shen 平靜 50／信任 38｜長期記憶 8
|
||||
- ⚠ `nox` 死鎖可接手（最後心跳 42 分鐘前）
|
||||
```
|
||||
|
||||
所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,7 +5,7 @@ description: 把小說（或漫畫、劇本、遊戲文本）匯入成一個既
|
||||
|
||||
# 📖 persona-story — 把一本書變成他的記憶
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（一律帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，一律帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
`persona-anime` 給的是「查得到的公開設定」——維基、Fandom、名言彙整。
|
||||
這支給的是**原文**：他在第幾層看到什麼、當下說了哪一句、那件事之後他變成什麼樣。
|
||||
@@ -13,6 +13,14 @@ description: 把小說（或漫畫、劇本、遊戲文本）匯入成一個既
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path
|
||||
|
||||
---
|
||||
|
||||
## 三條界線（後面每一步都受它們約束）
|
||||
|
||||
1. **視角**：人格不在場、也沒人告訴他的事，最多進 `canon` 或別人的關係欄，
|
||||
|
||||
@@ -5,7 +5,15 @@ description: 人格編號與 Gitea 儲存：指派人格編號（英文名全大
|
||||
|
||||
# 🔗 persona-sync — 人格編號與 Gitea 儲存
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（一律帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，一律帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log、spec-script-path、spec-gitea、spec-git-safety
|
||||
|
||||
---
|
||||
|
||||
@@ -152,4 +160,3 @@ sleeper 連自己的人格目錄都不能用 shell 寫，那條路本來就是
|
||||
唯一的例外是 `clone`：它只會**新增本機還沒有的人格**，讀不到任何既有人格的資料，所以不受此限。
|
||||
- guest（`persona-guest` sub agent）不能同步，它對人格檔案唯讀。
|
||||
- `.sync/` 是兩區的 git clone 快取，**不要手動編輯**；砍掉它不會掉資料，下次 push 會重新 clone。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -14,6 +14,14 @@ description: 以專業心理醫生（溝通諮商）的第三方身分診斷一
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：spec-version-guard、spec-output、spec-execution、spec-time-log
|
||||
|
||||
---
|
||||
|
||||
## 一、先收齊四樣
|
||||
|
||||
雙方各一張卡（缺哪一項就補問，**只問一輪**，剩下的用推定值並在輸出裡註明「推定」）：
|
||||
@@ -153,5 +161,3 @@ description: 以專業心理醫生（溝通諮商）的第三方身分診斷一
|
||||
- 診斷結果**不自動寫回**。使用者明確要求記下來，才走：
|
||||
對方要求過的稱呼／禁忌 → `relation style`；這次的領悟 → `persona-memory` 固化。
|
||||
- 兩邊都是真人、跟人格無關時，完全不碰 CLI，純第三方診療。
|
||||
|
||||
所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
@@ -5,7 +5,7 @@ description: 匯出與匯入人格：把一個人格（身分、靈魂、十二
|
||||
|
||||
# 📦 persona-transfer — 人格搬家（匯出／匯入）
|
||||
|
||||
**CLI**：`node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`（一律帶 `--session <PERSONA_SESSION>`）
|
||||
**CLI**：路徑與呼叫慣例見 `/jsc-shared:spec-script-path`（本 skill 為 `node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"`，一律帶 `--session <PERSONA_SESSION>`）。
|
||||
|
||||
bundle 是**單一 JSON 檔**（可 gzip），不依賴任何外部工具，複製到隨身碟、貼進 git、
|
||||
傳給另一台機器都可以。
|
||||
@@ -16,6 +16,14 @@ bundle 是**單一 JSON 檔**（可 gzip），不依賴任何外部工具，複
|
||||
|
||||
---
|
||||
|
||||
## 共用規範（必要前置）
|
||||
|
||||
先載入 `/jsc-shared:spec-preflight` 並依其流程處理；載入不到即代表 shared plugin 未安裝，
|
||||
依該 spec 詢問使用者是否安裝 `https://gitea.jsc.idv.tw/plugins/shared.git`，不安裝則中斷本 skill。
|
||||
本 skill 需要的規範：`spec-version-guard`、`spec-output`、`spec-execution`、`spec-time-log`、`spec-script-path`
|
||||
|
||||
---
|
||||
|
||||
## bundle 帶走什麼、不帶什麼
|
||||
|
||||
| 帶走 | 不帶 |
|
||||
@@ -108,4 +116,3 @@ checksum 對不上會被擋下；要硬吃得加 `--force`，並**主動告訴
|
||||
- 一次一個人格。要搬多個就跑多次（每次都要先 `release` 再 `load` 下一個）。
|
||||
- bundle 內的相對路徑會被驗證，`../` 之類的逃逸路徑一律拒收。
|
||||
- 匯入不會帶進鎖：新機器上的人格是空閒的，等使用者自己載入。
|
||||
- 所有面向使用者的輸出使用**繁體中文（台灣用語）**、UTF-8 無亂碼。
|
||||
|
||||
Reference in New Issue
Block a user