jiantw83andClaude Opus 5
d0c42f0c15
1. 不再直接使用網路上找到的圖片
舊版把裁下來的官方美術當圖示（photo 樣式）。現在改成：
找圖 → `icon headshot` 裁出**大頭照當底稿** → AI 用 Read 親眼看過 →
讀出髮型/瀏海/眼型/表情/髮飾/領口等特徵 → **由本工具重新繪製**。
* 底稿寫在 <人格>/.sync/headshot.png，**不是圖示、不同步、不發佈**。
* 產出的 SVG 不得有 <image>／base64／外連（selftest 會擋）。
* 移除 photo 樣式與 photoSvg；config 裡殘留的舊樣式會被忽略而非退回徽章。
2. 重繪引擎：五官與造型可參數化
新增 --features：hairstyle(5) / length(4) / fringe(4) / eyes(4) /
expression(4) / accessory(5) / side / collar(4) / ahoge。
渲染器新增 polygon 圖元（呆毛、緞帶、V 領、銳利眼角），SVG 與自寫柵格器
仍共用同一份圖形清單，兩邊必然一致。
另外調了臉部比例：眉毛用「髮色偏膚色」避免深髮角色眉毛與瀏海連成黑帶、
加了鼻子（否則嘴會被看成鼻子）、眼與嘴的縱向配置重排。
3. Wiki 形象圖必須同步（並且會被驗證）
新增 `sync verify`（不一致以非零結束）與 verifyIconInWiki()；
`icon generate` 推完 Wiki 會自動回頭確認 icon.svg + icon.png 真的在遠端
且與本機一致。
修掉一個會讓驗證永遠失敗的 bug：Wiki 首頁內嵌了 `最後同步 ${now}`，
每次產生都不同 → 永遠 dirty、每次 push 都多一個 commit。改用圖示的
generated_at。porcelain 解析也從固定位移改為正規式。
已重繪兩個真實人格（皆為 portrait 樣式，並通過 Wiki 同步驗證）：
ASUNA-01 底稿=《Unanswered//butterfly》(2026) 主視覺左側；金蜜色極長直髮、
中分瀏海、呆毛、紅褐杏眼、沉靜神情、紅上衣 V 領
YUI-01 底稿=AniList 官方角色圖；藍黑極長直髮、齊瀏海、圓大棕眼、燦爛笑容，
髮飾與配色採現行 Unital Ring 導航妖精造型（淡粉洋裝、藍花）
selftest 161 項全綠（新增第 ⑰ 節：特徵解析、換髮型/眼型/表情會畫出不同的圖、
polygon 兩邊一致、舊樣式不污染、SVG 無內嵌影像、Wiki 首頁無時間戳）。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
5.4 KiB
5.4 KiB
jsc-persona — AI 人格化記憶聊天（跨 AI 助理）
本 repo 是一個以 Agent Skills（SKILL.md） 標準撰寫的 plugin，讓 AI 以「人格」的方式
持有身分、情緒與記憶。可同時被 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 的運作前提（動手前一定要知道）
- 所有狀態變更都經過
scripts/persona.mjs，不要手動編輯state/lock.json、.runtime/、memory/INDEX.md、relations/graph.mmd（這些由 CLI 產生）。 - 每個 CLI 呼叫都要帶
--session <PERSONA_SESSION>，值來自SessionStarthook 注入的<persona-runtime>區塊。帶錯或冒用其他 session 會被PreToolUsehook 拒絕。 - 一個程序只能載入一個人格；同一 session 的 sub agent 沿用同一把鎖。
要讓兩個人格對話，用
/jsc-persona:persona-invite（persona-guestsub agent + 聊天室）， 不要去讀對方的人格目錄——會被 hook deny，而且那是設計上的紅線。 - 人格資料不在本 repo，預設在
~/.claude/personas/（可用PERSONA_HOME覆寫）。 - 人格由使用者呼叫才載入，不要自己挑一個人格附身。
- 劇場模式（多人格對話）進行中：輸出只能是
名字：內容，其餘一律隱藏（見 persona-invite）。 - 人格講話要像人：推導寫進
think（心裡話，只回報「💭 心想 N 句」，永不回顯內容）、 回話 1–3 句、短時間內不重說同一件事（room post會直接擋下重複與過長的發言）。 這三條在劇場模式一樣生效。 - 人格可搬家：
export/import（單一 JSON bundle）。匯出只能匯出「本 session 載入的人格」， 其他人格一律 deny——匯出等於把記憶讀出來。 - 人格有編號：英文名全大寫＋兩位索引（
ASUNA-01），同名才遞增。編號同時是新人格的 本機目錄名與 Gitea 存取庫名稱。中文名要先轉羅馬拼音並跟使用者確認拼法。 - 人格存在 Gitea，本機是工作副本：高頻活狀態進檔案區（每輪背景 push），
低頻身分與長期記憶進 Wiki 區（固化／改身分／release 時 push）。
同步失敗永遠不阻斷對話；沒設
GITEA_HOST／GITEA_TOKEN就純本機運作。 - 人格圖示在資料補齊之後才產生：SVG 與 PNG 是同一張圖（共用單位座標與點陣字），
PNG 由
scripts/persona-icon.mjs自己柵格化＋zlib 編碼，不得引入任何影像函式庫。 - 圖示必須是重新繪製的人物形象圖（有臉）：上網找出該人格「最新一次登場」的官方視覺 →
icon headshot裁出大頭照當底稿 → 用 Read 親眼看過 → 讀出髮型／瀏海／眼型／表情／ 髮飾等特徵 →icon generate --palette ... --features ...重新繪製。 絕對不要把找到的圖片直接當圖示（底稿只留在.sync/，不同步、不發佈； 產出的 SVG 不得有<image>／base64／外連）。 沒看過圖就不准填顏色或特徵、也不准亂挑臉（多角色先icon faces再挑，挑完打開確認）。 - 選用工具缺了要「提示安裝」，不准靜默降級：
toolReport()會列出缺什麼、為什麼要、 怎麼裝（venv 免 sudo）。注意 OpenCV 5 拿掉了CascadeClassifier，必須裝 4.x。 plugin 本體仍然零依賴：沒有這些工具照樣能產生形象圖。 - Wiki 必須保存並同步形象圖：
icon.svg與icon.png都在 Wiki 區，另有自動產生的 Icon 頁展示兩種格式與來源。icon generate推完會回頭驗證，sync verify可隨時檢查。 Wiki 產生的頁面不得含每次都變的時間戳，否則驗證永遠不會通過、也會每次多一個 commit。
慣例
- 新增 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。