Files
persona/AGENTS.md
T
jiantw83andClaude Opus 5 5b52dd18c2 feat(voice): 注入層與 CLI 訊息改成人話;越害羞話越少、心裡話越多(v0.0.8 同批)
三層照建議只做兩層半:注入層與 CLI 訊息重寫,文件只順句子、不動規格
(數字、參數名、指令名、判斷條件一個沒改——那些精確的詞就是能力本身)。

一、越害羞的人話越少、心裡話越多(`speechBudget()`)
  這不是新加一條規矩,是同一件事的兩面:**說出口的那句常常正好在迴避心裡那句**,
  落差本身才是那個角色。所以句數上限與心裡話下限綁在同一個羞恥度上:

    羞恥度 ≥ 75 → 最多 2 句、心裡話至少 2 句,且**先寫完再開口**
                  台詞不可以是心裡話的摘要(心裡「我一直在等你問」→ 出口不能是「我有在等你問」)
    50–74       → 3 句、心裡話至少 1 句
    ≤ 49        → 3 句、想到什麼就講,不用先在心裡繞一圈

  `room post` 改用 `speechBudget(speaker).sentences`,不再是固定三句;
  被擋下時會講明「這個人格話比別人少」。

二、注入層改成人話
  原本是規格書腔(「**講完就算了**——不要解釋自己剛講的話」),現在像有人在旁邊提醒:
  「講完就停,不要回頭解釋自己剛講的話,也不要幫自己收尾。」
  黑名單從列舉詞條改成講清楚**為什麼**不像人(「先發一句免費的認可,對方要的是回答」)。
  機械會擋的規則壓成最後一行括號——保留全部關鍵詞,但不再稀釋前面的重點。

三、CLI 訊息改成人話(20 條)
  「⚠ 這段有 4 句,超過 3 句上限 → 砍到重點」→「講太多了,4 句。這裡最多 3 句——挑最想說的那一兩句就好」
  「幾乎只給自己加分——這種偏差要自己看得見」→「幾乎都在給自己加分。delta 是你自己挑的,這種偏差沒人會替你抓」

四、測試
  314 項全過(新增 4 項)。既有 6 條斷言原本釘在字面上,措辭一改就紅——
  改成釘意思(「最多」「講過」「講完就停」)而不是釘整句,這種脆弱本來就該修。

版本:與 PR #11 同一批,維持 0.0.8。

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-07-31 05:52:13 +00:00

11 KiB
Raw Blame History

jsc-persona — AI 人格化記憶聊天(跨 AI 助理)

本 repo 是一個以 Agent SkillsSKILL.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 的運作前提(動手前一定要知道)

  1. 所有狀態變更都經過 scripts/persona.mjs,不要手動編輯 state/lock.json.runtime/memory/INDEX.mdrelations/graph.mmd(這些由 CLI 產生)。
  2. 每個 CLI 呼叫都要帶 --session <PERSONA_SESSION>,值來自 SessionStart hook 注入的 <persona-runtime> 區塊。帶錯或冒用其他 session 會被 PreToolUse hook 拒絕。
  3. 一個程序只能載入一個人格;同一 session 的 sub agent 沿用同一把鎖。 要讓兩個人格對話,用 /jsc-persona:persona-invitepersona-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()):越害羞的人話越少、心裡話越多, 而且說出口的那句常常在迴避心裡那句——台詞不可以是心裡話的摘要。 再加四條講話的樣子:短句(一句 MAX_SENTENCE_CHARS=45 字內)、日常用詞多講看得見的東西(人、動作、物件、當下的場面)而不是概念,以及不要解釋自己的話 (「我的意思是」「換句話說」這類開頭由 speechLint 擋下,said check 也會一起檢)。 最後一條是情緒要改變句子的形狀EMOTION_TELLS 給十二情緒各自的破口 (焦慮→斷句與疊字、羞愧→鬧彆扭嘴硬、憤怒→短句與退回全名、悲傷→只回一個詞), emotionTells() 每輪挑主導情緒裡強度 ≥ 40 的前兩種注入。演出來、不要用旁白說明, 一輪最多露一個破口。這些在劇場模式一樣生效。 再加一層不說 AI 才會說的話SPEECH_BLACKLIST 收罐頭同理心(「這個我懂」)、頒獎開場、 交差句、預告、說教腔、假坦白開場、罐頭收尾、立場真空、無來源權威、用旁白演情緒, 加上避險疊加、CN_WORDS(中國用語)、半形標點、emoji/破折號/排版殘留與 「不是 A 而是 B」的密度——全部由 speechLint() 機械擋下(模式借自 speak-human-twMIT)。 誤殺防護:speechBody() 會先拿掉引號與 code提及不算使用;「老實說」只擋開場。 最後是這一層的義務:講自己的過去要有出處——「我以前⋯」只能講 recall 查得到的轉折, speechLintlevel: "hint"(不擋,但要人去驗),沒有紀錄就是編造自己的過去。 8b. 情緒先行、會飽和、偏差看得見:每輪注入之前先用 readUserEmotion() 讀對方那句話 (十二類加權詞表、否定會擋掉命中、引號與 code 內不比對、標點只放大既有訊號), 回的是訊號不是判定——人格讀到的不一樣就以人格為準;RESPONSE_STANCE 給的是 「怎麼接」的動作不是罐頭句。每輪的偵測與 delta 記進 state/felt.jsonl feltTrend() 用近重遠輕的加權算走向。applyEmotion() 加了飽和 headroom^EMOTION_SATURATION_K,往 baseline 回不壓)與單輪預算 EMOTION_TURN_BUDGET=60),因為 delta 是人格自己挑的、只會往舒服的方向倒; emotion --audit 把這個偏差印出來。 8c. 性別只給一個預設值,不是套在個性上的係數IDENTITY.mdGender 欄位 (女性/男性/非二元/未指定,建立時要問不要猜)唯一的作用是給羞恥敏感度一個預設 623850)。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_HOSTGITEA_TOKEN 就純本機運作。
  12. 人格圖示在資料補齊之後才產生:SVG 與 PNG 是同一張圖(共用單位座標與點陣字), PNG 由 scripts/persona-icon.mjs 自己柵格化+zlib 編碼,不得引入任何影像函式庫
  13. 形象圖優先用「高解析度官方圖去背」icon searchicon measureicon cutouticon generate --from-cutout。找圖時優先官方設定稿Full BodyCharacter Design Avatar):解析度高,而且多半是透明底或白底,去背幾乎免費。挑的那張要對得上該人格 「最新一次登場」的形態(同一個角色有很多套造型)。 每一步都要用 Read 打開確認:去背有沒有殘留、構圖對不對。 找不到可用官方圖才退回 --features 的向量重繪。
  14. 選用工具缺了要「提示安裝」,不准靜默降級toolReport() 會列出缺什麼、為什麼要、 怎麼裝(venv 免 sudo)。注意 OpenCV 5 拿掉了 CascadeClassifier,必須裝 4.x。 plugin 本體仍然零依賴:沒有這些工具照樣能產生形象圖。
  15. Wiki 必須保存並同步形象圖icon.svgicon.pngicon/(向量原稿 + 512/1024) 都在 Wiki 區,另有自動產生的 Icon 頁。icon generate 推完會回頭驗證 sync verify 可隨時檢查。兩個容易踩的坑:
    • Wiki 頁面只能用 Markdown 圖片語法 ![](icon.png)——Gitea 只改寫這種語法為 /wiki/raw/...HTML <img src="icon.png"> 不會被改寫,瀏覽器會解析成 /wiki/icon.png 而變成破圖(看起來就像「沒有同步」)。
    • Wiki 產生的頁面不得含每次都變的時間戳,否則驗證永遠不會通過、也會每次多一個 commit。
    • 攤平只對 .md 做(頁面必須在根層);圖片等附件保留資料夾結構,/wiki/raw/<資料夾>/<檔> 讀得到。
  16. 語氣診療是第三方,不是人格persona-therapist 不取鎖、不附身、也不寫任何人格資料 (基線可用 relation showemotion 唯讀取得,bond × 親近度 → 語氣層 的權威表在 persona-lib.mjsTONE_TABLE)。診斷結果不自動寫回記憶或關係圖,使用者明確要求才寫。 出現自傷、暴力或長期受控的訊號時,停掉語氣分析改為安全優先(1925/113/1101980), 不幫任何一方把威脅或話術講得好聽;也不下病名、不對不在場的人做遠距診斷。

慣例

  • 新增 skill 一律放在 skills/<name>/<name> 使用小寫與連字號。
  • description 要寫清楚觸發條件(何時用、何時不用),這是跨助理自動載入的唯一依據。
  • 腳本一律 Node.js.mjs, ESM,只用內建模組(fs/path/os/crypto);hook 必須在任何環境都能跑,不得引入 npm 依賴。
  • 所有面向使用者的輸出使用繁體中文(台灣用語)、UTF-8 無 BOM、不得出現亂碼。
  • 改動鎖或隔離邏輯(scripts/persona-lib.mjsguardDecideacquireLockpromotionCandidates exportBundleimportBundle)後,必須node scripts/selftest.mjs 且全綠,並為新規則補一條測試。
  • 改動重複判定門檻(similarityREPEAT_THRESHOLD)後,要用 selftest ⑪ 的對照案例確認 「換句話說同一件事」被擋、「只換關鍵詞」放行。
  • 改動同步分區(persona-gitea.mjsAREAS)後,selftest ⑬ 的「不重不漏」檢查必須維持全綠: 人格產生的每個檔案都要恰好屬於一區,否則同步會默默漏掉資料。
  • selftest 自己會設 PERSONA_GITEA=off絕對不要讓測試碰到真的 Gitea。