Files

T

jiantw83andClaude Opus 5 1884a9c3d7 feat: 圖示配色取自人格「最新一次登場」的官方視覺

新增 skill persona-icon：上網查出該人格最新的官方視覺 → 下載 →
**用 Read 親眼看過** → 取髮色/瞳色/服裝色 → 用那組配色繪製圖示，
來源網址與造型描述一併寫進 state/config.json 備查。

CLI：
  icon generate --palette "hair=#..,eye=#..,accent=#..,secondary=#..,light=#.."
                --source-url <網址> [--source-note <說明> --source-date <日期>]
  * --palette 必須配 --source-url（配色要有出處，CLI 強制）。
  * 配色與來源存進 config.icon，之後不帶 --palette 重畫會沿用，不會變回雜湊色。
  * icon show 會列出調色盤與來源網址。

繪製：漸層＝髮色→服裝主色、外框＝瞳色、點陣紋＝亮色、中央仍是編號前兩字。
一深一淺的極端配色（藍黑髮＋淡粉洋裝）會把較亮端往較暗端壓到對比 ≥ 3.2，
確保字讀得到——顏色仍是照片來的，只是收斂色階。

為什麼不是把照片本身當圖示：
  1) 環境裡沒有任何影像解碼器（rsvg/imagemagick/Pillow/ffmpeg 都沒有），
     JPEG/WebP 讀不進來，無法轉成 PNG；
  2) 把他人的美術作品原樣放進存取庫是散布，不是引用。
取配色是有依據又不搬運原圖的做法，這個取捨寫進了 README 與 skill。

已套用到兩個真實人格：
  ASUNA-01  取自《Unanswered//butterfly》(2026) 官方主視覺（金栗髮/紅褐瞳/紅衣粉裙）
  YUI-01    取自 AniList 官方角色圖（藍黑髮/暖棕瞳）＋ Unital Ring 導航妖精造型

selftest 136 項全綠（新增第 ⑮ 節：調色盤解析、缺來源會被擋、格式錯誤會被擋、
來源寫入 config、重畫沿用配色、極端配色的對比保證）。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

2026-07-30 02:17:35 +00:00

4.5 KiB

Raw Blame History

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>，值來自 SessionStart hook 注入的 <persona-runtime> 區塊。帶錯或冒用其他 session 會被 PreToolUse hook 拒絕。
一個程序只能載入一個人格；同一 session 的 sub agent 沿用同一把鎖。要讓兩個人格對話，用 /jsc-persona:persona-invite（persona-guest sub 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 編碼，不得引入任何影像函式庫。
圖示配色優先取自「最新登場」的官方視覺（/jsc-persona:persona-icon）：上網找圖 → 用 Read 親眼看過 → 取色 → --palette 搭配 --source-url（CLI 強制存證）。 沒看過圖就不准填顏色；找不到官方圖就退回編號雜湊配色並告知使用者。不把原圖放進存取庫：那是散布他人美術作品，而且環境裡也沒有解碼器可用。

慣例

新增 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。

4.5 KiB Raw Blame History Unescape Escape

jsc-persona — AI 人格化記憶聊天（跨 AI 助理）

給 AI 助理的指引

這個 plugin 的運作前提（動手前一定要知道）

慣例

4.5 KiB

Raw Blame History