plugins/persona
2
0
Fork 0
Code Pull Requests Activity
Files
e59d0a471be9477089a3054a79e235bcffb32d18
persona/skills/persona-transfer/SKILL.md
T
jiantw83andClaude Opus 5 2b4b49d478 feat(gitea): clone —— 從 Gitea 匯入一個本機還沒有的人格 
底層本來就走得通（`pullArea` 的 restore 會把本機缺少的檔案全部補進來），
擋住的是上層的雞生蛋：`sync` 先走 `requireOwner`，而 `requireOwner` 第一件事
就是「本機沒有這個人格就 die」。本機沒有它 → load 不了它 → sync pull 被擋 →
永遠拉不回來。所以照 `import` 的模式另開一個只驗 session、不驗 host 的入口。

* `clone --code <編號>`：兩區都拉回來（Wiki 區給身分與長期記憶，檔案區給活狀態），
  然後補上 `pullArea` 不管的那幾件事——驗 IDENTITY.md（`validateBundle` 明文的
  人格最低要件，Gitea 這條路上原本不存在）、補寫 config.code／來歷、
  `rebuildIndex()`、`renderRelations()`。拉回來不成人格就中止並清掉半成品。
* `clone`（不帶 --code）：列出遠端有哪些人格、哪些本機還沒有。
  整個 codebase 原本沒有任何「列出 owner 底下的存取庫」的呼叫，新增
  `listRemotePersonas()`：分頁打 `GET /user/repos`（他人／組織走 `/users/<owner>/repos`），
  用編號格式過濾——存取庫名稱就是人格編號，所以那份清單就是遠端的人格清單。
* 本機已有同名人格時**預設不覆蓋**；`--force` 才蓋（沿用 `import` 的兩道保護：
  不得覆寫別人、不得覆寫正被其他程序載入的人格），`--persona` 可並存兩份。
* 加進 `OWNER_EXEMPT_SUBCOMMANDS`，否則已載入其他人格時會被 hook deny。
* 編號衝突：`nextCode()` 只掃本機，換機器會重複發號。新增
  `nextCodeAcrossMachines()`，發號前先問遠端已經用掉哪些編號；Gitea 連不上
  就退回本機答案並在輸出明講「只對過本機」。`create` 與 `code assign/next` 都改用它。
* 順手修正 `ensureRepo` 的建庫路由：`me` 取自 `resolveOwner()`，而它在有
  `PERSONA_GITEA_OWNER` 時只會把那個值原封不動還回來，於是組織永遠走成
  `/user/repos`（建到 token 本人底下）。改用不受該環境變數影響的 `giteaLogin()`。

測試：selftest 新增第 ㉒ 區，用 file:// 的裸倉庫當「假的 Gitea」跑完整往返
（推兩區 → 刪掉本機人格 → clone 回來 → 驗身分／長期記憶／活狀態／索引／關係圖），
並涵蓋前兩個修正（子資料夾與非 ASCII 檔名真的進了存取庫、push 覆蓋遠端的回報
與 Stop hook 只吵一次）。345 → 373 項全過。

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

4.6 KiB
Raw Blame History

name, description
name description
persona-transfer 匯出與匯入人格：把一個人格（身分、靈魂、十二情緒、短期與長期記憶、心智圖、思維導圖、人際關係圖）打包成單一 bundle 檔，或從 bundle 還原／複製成新人格。當使用者說要備份人格、把人格搬到另一台機器或另一個 AI 助理、把人格分享給別人、從檔案還原人格、複製一份人格來做實驗、或問「這個人格能不能帶走」時觸發。不適用於：建立全新人格（用 persona-create 或 persona-anime）、載入既有人格聊天（用 persona-chat）、整理記憶（用 persona-memory）。

📦 persona-transfer — 人格搬家（匯出／匯入）

CLI：node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs"（一律帶 --session <PERSONA_SESSION>）

bundle 是單一 JSON 檔（可 gzip），不依賴任何外部工具，複製到隨身碟、貼進 git、 傳給另一台機器都可以。

只是要在另一台機器接續同一個人格、而且兩邊都連得到 Gitea 的話，不必經過檔案： 用 /jsc-persona:persona-sync 的 clone --code <編號> 直接從存取庫拉一份回來。 這裡的 bundle 是給離線、換助理、或想留一份快照的情境。

bundle 帶走什麼、不帶什麼

帶走 不帶
IDENTITY.md / SOUL.md / AGENTS.md / USER.md state/lock.json、state/guests.json（載入鎖與 guest 租約屬於「那台機器的那個程序」）
state/config.json、state/emotion.json（十二情緒的 levels／baseline／半衰期） journal/（原始逐字稿：量大且最私密，要帶請明確加 --with-journal）
state/inner.jsonl（心裡話）、state/said.jsonl（說過的話） 任何其他人格的資料——一個 bundle 只有一個人格
memory/（短期、長期一則一檔、INDEX、inbox）
mindmap/（心智圖與思維導圖）、relations/（關係圖）

檔案裡有 checksum（sha256），匯入時會驗；對不上就是被改過或損毀。

匯出

只能匯出「本 session 目前載入的那個人格」——這是隔離規則的一部分， 不然匯出就成了把別人的記憶讀出來的後門。所以要先載入它：

# 1) 先載入（若還沒載入）
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" load --persona <slug> --session <PERSONA_SESSION>

# 2) 匯出
node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" export \
  --session <PERSONA_SESSION> --out ~/persona-backup/<slug>.persona.json

選項：

  • --with-journal：連逐字稿一起帶（會大很多，而且很私密——要先問使用者）。
  • --gzip：輸出 .json.gz（大人格建議加；匯入會自動辨識）。
  • --force：覆寫已存在的輸出檔。
  • 不給 --out 就寫到現在的工作目錄，檔名 <slug>-<時間戳>.persona.json。

不要把 bundle 寫進人格倉庫裡（~/.claude/personas/）——hook 會擋，而且那裡是人格的家，不是備份區。

匯入

node "${CLAUDE_PLUGIN_ROOT}/scripts/persona.mjs" import \
  --session <PERSONA_SESSION> --file ~/persona-backup/<slug>.persona.json
情況 做法
這台機器還沒有這個人格 直接匯入，slug 沿用 bundle 內的名字
想同時保留兩份（原版 + 實驗版） --persona <新 slug> 換名匯入；config.json 會記下它來自誰
要用匯入的資料覆蓋既有人格 --force——這會蓋掉現有記憶與情緒，先問過使用者；且該人格不能正被其他程序載入
匯入後想馬上聊 加 --load（本 session 沒有載入別的人格時才會生效）

checksum 對不上會被擋下；要硬吃得加 --force，並主動告訴使用者這份檔案可能被改過。

跟使用者互動的原則

  1. 匯出前確認範圍：要不要帶 journal/（逐字稿）。預設不帶。
  2. 匯出後回報實際路徑與大小，還有帶了幾則長期記憶——他要拿去搬家，得知道搬了什麼。
  3. 匯入前先 list，看目標 slug 是否已存在：存在就給他「換名匯入 / 覆寫」兩個選擇， 不要自己決定 --force。
  4. 匯入後告訴他 /jsc-persona:persona-chat <slug> 就能開始聊。

邊界

  • 一次一個人格。要搬多個就跑多次（每次都要先 release 再 load 下一個）。
  • bundle 內的相對路徑會被驗證，../ 之類的逃逸路徑一律拒收。
  • 匯入不會帶進鎖：新機器上的人格是空閒的，等使用者自己載入。
  • 所有面向使用者的輸出使用繁體中文（台灣用語）、UTF-8 無亂碼。
View Git Blame Copy Permalink