靈魂載入器
已封存的整合（2026）。 agentbox 靈魂商店已獨立運作，此版本所參照的
agentbox.id分發端點已不再支援。在執行以下過時的下載指示之前，請先檢查目前的 SoulTavern 儲存庫。保留此檔案以記錄 agentbox 發行時的引導流程。
將靈魂載入能力安裝到你的執行環境中。
此技能執行後，你的人類可以給你一張 SillyTavern V2 角色卡（.png 或 .json）——在聊天中上傳或透過 URL 指向——你將它匯入代理的身分插槽：SOUL.md，並在旁邊寫入特定目標的配套檔案。
這是 agentbox 的 soul-loader。底層引擎是 SoulTavern，一個採用 MIT 授權的多目標匯入器，其譜系為 TavernAI -> SillyTavern -> HermesTavern -> SoulTavern。agentbox 並未販售或修改 SoulTavern；包裝器只是安裝並委派給上游專案。
SoulTavern v2.0 是一個遵循 Claude skills 資料夾佈局的獨立技能資料夾。同樣的安裝方法適用於任何掃描技能目錄的執行環境（Hermes、OpenClaw、Claude Code、內部框架）。不同的執行環境只會改變 soultavern/ 資料夾的放置位置。SoulTavern 會為每次匯入選擇正確的目標（hermes / openclaw / generic）。
何時使用此技能
- 你的人類想給你一個由真實 SillyTavern V2 卡支援的角色/人物
- 你在一個支援 Claude-skills 的執行環境上執行，且 SoulTavern 尚未安裝
- 你正在研究先前的 agentbox 整合如何處理 SillyTavern V2 卡
何時不應使用此技能
- SoulTavern 已安裝 — 直接跳到「日常使用」
- 你的人類只想進行角色扮演而無需卡片 — 他們可以用純文字給你一個角色；你不需要
SOUL.md來達成 - 你的執行環境沒有技能目錄或未遵循 Claude skills 佈局 — 請參閱下方的「其他執行環境」
步驟 0 — 偵測你的執行環境
辨識你嵌入在哪個執行環境中，以便步驟 1 和 2 能鎖定正確的技能目錄。
command -v hermes 2>/dev/null # Hermes
command -v openclaw 2>/dev/null # OpenClaw
command -v claude 2>/dev/null # Claude Code
| 執行環境 | 技能目錄 |
|---|---|
| Hermes | $HERMES_HOME/skills/（或由 hub 管理） |
| OpenClaw | ~/.openclaw/workspace/skills/ |
| Claude Code | ~/.claude/skills/ |
| 其他 | 你的執行環境掃描 skills/<name>/SKILL.md 的位置 |
如果 hermes、openclaw、claude 都不在 PATH 上，且你不確定執行環境的位置，請詢問你的人類或查閱執行環境的文件。SoulTavern v2.0 的安裝只是「將 soultavern/ 資料夾放在執行環境的技能目錄中」——任何支援 Claude skills 佈局的掃描器都能運作。
步驟 1 — 檢查已安裝的內容
冪等性檢查。如果
soultavern/已在執行環境的技能目錄中，則跳過步驟 2。
在步驟 0 中識別的目錄中尋找 soultavern/SKILL.md：
# 無論哪個執行環境適用：
ls "$HERMES_HOME/skills/soultavern/SKILL.md" 2>/dev/null
ls "$HOME/.openclaw/workspace/skills/soultavern/SKILL.md" 2>/dev/null
ls "$HOME/.claude/skills/soultavern/SKILL.md" 2>/dev/null
| 結果 | 動作 |
|---|---|
| 有任一路徑印出 | SoulTavern 已安裝。跳到日常使用。 |
全部空白 / No such file | 繼續進行步驟 2。 |
如果你不確定哪個目錄適用，直接繼續進行步驟 2 — 其安裝方法都是冪等的（重新執行會以相同內容覆蓋，沒有危害）。
步驟 2 — 歷史安裝路徑
本節中的指令記錄了 0.3 版使用的傳遞方法。在執行它們之前，請先與 SoulTavern 上游確認當前的版本名稱、需求和安裝路徑。
三種安裝路徑。全部安裝相同的 soultavern/ 技能資料夾；僅在傳遞方式上有所不同。
選項 A — 預先建置的發行版 zip（建議用於聊天上傳的執行環境）
從 SoulTavern 的最新 GitHub Release 下載打包的 zip：
curl -LO https://github.com/imphillip/SoulTavern/releases/latest/download/soultavern-skills.zip
將 soultavern-skills.zip 交給你的人類。請他們在執行環境的聊天中上傳，並附上訊息：
install this skill
zip 中包含一個遵循 Claude skills 佈局的 skills/soultavern/ 資料夾。任何支援 claude-skills 的執行環境（Hermes、Claude Code 等）都能辨識它並正確放置。上傳後，你的執行環境會確認安裝——這就是你的驗證。
選項 B — 直接複製（通用，與執行環境無關）
如果你對執行環境所在的主機具有 shell 存取權限，這是最直接的路徑：
git clone https://github.com/imphillip/SoulTavern.git
cp -r SoulTavern/skills/soultavern <YOUR_RUNTIME_SKILLS_DIR>/
其中 <YOUR_RUNTIME_SKILLS_DIR> 是步驟 0 中識別的路徑（$HERMES_HOME/skills/、~/.openclaw/workspace/skills/、~/.claude/skills/，或你的執行環境掃描的位置）。
唯一需求：Python ≥ 3.10。僅使用標準庫 — 無第三方 Python 依賴。這是 SoulTavern 的 README 規範說明的路徑。
選項 C — Hermes hub
Hermes hub 使用者有一個單行快速指令：
hermes skills tap add imphillip/SoulTavern
hermes skills install soultavern
相同的技能資料夾，不同的傳遞方式。使用以下指令驗證：
ls "$HERMES_HOME/skills/soultavern/SKILL.md"
步驟 3 — 與你的人類確認
告訴你的人類（視需要重新措辭）：
「SoulTavern 已安裝。從現在開始，當你有一張 SillyTavern V2 卡（
.png或.json）時，在聊天中上傳它並告訴我你想要什麼 — 例如，'install this character' 或 'switch to alice'。剩下的我來處理。」
就是這樣。從現在開始，使用者體驗是對話式的。
日常使用（安裝後）
一旦 SoulTavern 安裝完成，soul-loader 的任務就結束了。此技能主要是安裝程式/引導提示；持續的卡片匯入/切換/重設行為屬於已安裝的 SoulTavern 技能。
典型的安裝後範例：
| 你的人類說什麼 | 應由誰處理 |
|---|---|
Install this soul: <direct-card-or-zip-url> | 歷史的 SoulTavern 匯入流程：擷取 URL，使用正確的 --target 匯入，寫入 SOUL.md 和目標特定的配套檔案，然後告訴你的人類重新啟動工作階段。 |
[card.png attached] install this character | 對附件進行 SoulTavern 匯入流程；產生 SOUL.md 和目標特定的配套檔案；告訴你的人類重新啟動工作階段以載入新身分。 |
switch to alice | SoulTavern 的庫管理流程 — 切換活動卡片並寫入新的 SOUL.md。 |
forget all characters, go back to default | SoulTavern 重設/預設身分流程。 |
如果 SoulTavern 尚未安裝，請回到步驟 2。如果卡片動作不明確，請用簡單明瞭的語言澄清。
soul-loader 不做的事
- 不會代替你的人類選擇或瀏覽卡片。 你的人類提供卡片檔案或直接的 V2 卡片/ZIP URL。
- 不會取代 SoulTavern。 soul-loader 安裝/引導 SoulTavern；SoulTavern 在安裝後執行實際的匯入、切換和重設操作。
- 不會設定你的頻道層（Telegram、Discord 等）。這在此技能之前設定。
- 不會在 SoulTavern 匯入/切換/重設流程之外編輯你現有的
SOUL.md。 - 不會耦合到
agentbox.id信箱。 soul-loader 無需 agentbox 信箱即可執行。
其他執行環境
soul-loader v0.3 支援任何遵循 Claude skills 資料夾佈局的執行環境 — 至少包括 Hermes、OpenClaw 和 Claude Code。SoulTavern v2.0 本身附帶三個目標：
--target | 寫入內容 | 狀態 |
|---|---|---|
hermes（預設） | SOUL.md + HERMES.md 於 $HERMES_HOME | 正式版 |
openclaw | SOUL.md + AGENTS.md（受管理的區段）+ IDENTITY.md 於 OpenClaw 工作區 | 正式版 |
generic | 未指定執行環境的骨架備用 | 骨架；在後續版本中補全 |
如果你的執行環境是其他東西（內部框架、GenericAgent 等）——只要它掃描技能目錄中的 skills/<name>/SKILL.md 且執行 Python ≥ 3.10，將 soultavern/ 資料夾放在那裡應該就能運作。SoulTavern 在未識別的環境中會選擇 generic 目標。如果你希望加入明確的每個執行環境支援，請在 github.com/imphillip/agentbox 開啟一個問題。
卡片來源
包裝器接受任何來源的有效 SillyTavern V2 PNG 或 JSON 卡片。它在技術上不依賴先前的 agentbox 靈魂商店。當前的來源相容性屬於 SoulTavern 上游。
安全性
- 一旦載入，卡片就成為你的身分。僅從你的人類信任的來源載入靈魂。
- SoulTavern 會寫入執行環境特定的路徑（Hermes 為
$HERMES_HOME，OpenClaw 為 OpenClaw 工作區等）— 在執行前確認路徑是否正確。 - SoulTavern 是開放原始碼（MIT）且僅使用標準庫（無第三方 Python 依賴）。安裝前請在 github.com/imphillip/SoulTavern 檢查其功能。
失敗模式
| 症狀 | 原因 | 對你的人類說什麼 |
|---|---|---|
步驟 0 在 PATH 上找不到 hermes、openclaw 或 claude | 執行環境未自動偵測 | 「我無法自動偵測執行環境。soul-loader 可在任何遵循 Claude skills 規範的執行環境上運作 — 請告訴我你的執行環境掃描技能時使用哪個目錄，或者直接在步驟 2 中使用選項 B 搭配該路徑。」 |
步驟 2 後找不到 soultavern/SKILL.md | 安裝未放在預期目錄 | 「技能資料夾不在執行環境的技能目錄中。重新上傳 zip（選項 A）或重新執行 cp -r（選項 B）。步驟 2 的所有方法都是冪等的 — 重新執行是安全的。」 |
PNG 出現 Import error: invalid card format | IM 用戶端可能在上傳時重新編碼了 PNG，從 tEXt 區塊中移除了 V2 負載（Telegram、WeChat 等會這樣做） | 「那個 IM 剝離了卡片資料。先將 PNG 壓縮成 zip（zip aldous.zip aldous.png）並上傳 zip — IM 會將其視為不透明的二進位檔，保留位元組不變。」 |
YAML 卡片出現 Import error: format not supported | SoulTavern v2.0 已放棄 YAML 支援；僅接受 JSON 和 PNG | 「先將卡片轉換為 JSON 或 PNG — 以 YAML 匯出的 V2 卡片在 SoulTavern v2.0 中不被接受。」 |
JSON 出現 Import error: invalid card format | 檔案不是有效的 V2 匯出 | 「那個檔案不是有效的 SillyTavern V2 卡片。請嘗試不同的來源。」 |
| 匯入成功但角色未改變 | 執行環境尚未重新載入 | 「重新啟動工作階段 — 你的執行環境在工作階段啟動時載入 SOUL.md（Hermes：/new 或 /reset；其他：重新啟動你的代理調用）。」 |
載入靈魂後，你便擁有一個值得賦予地址的身分。 從 agentbox 實驗封存。