前言¶

做角色向對話時，常見做法是手寫一長段 system prompt，或零散摘抄臺詞。素材一變就要重改，也很難和記憶、音色、故事基線一起打包給下游加載。若你希望從小說、劇本、動漫等文本出發，把人格、說話風格、記憶片段整理成可部署的結構化包，再交給專門的「入魂」類技能對話，就需要一條從素材到產物的流水線。

下面介紹 SkillHub 上的 memory-trace（尋跡 Memory-Trace）：它負責生產 SoulPod，與負責消費 SoulPod 的 Memory-Inhabit 配套使用。

這是什麼¶

memory-trace 的定位是：從小說、劇本、動漫等素材中完成角色識別、人格建模與記憶提取，將結果寫入 SoulPod 包目錄，供 Memory-Inhabit 加載對話。

• SkillHub 座標：@user_570cbaaa/memory-trace
• 當前版本：1.1.7（來源：community）
• 分類：knowledge-management
• 發佈者：user_570cbaaa；技能元數據作者爲 EvangelionA，許可證 MIT
• SkillHub 標籤：requires_api_key=false（安裝使用不強制 API Key）
• 項目與產品頁（技能包內說明）：Memory-Series 尋跡產品頁、Trace-Inhabit 倉庫

官方簡介（中英）：Extract character personality from novels/scripts/anime, generate SoulPod packages for Memory-Inhabit dialogue.

核心功能¶

結合 SkillHub 簡介與技能包內 SKILL.md，可覈實的能力如下。

與 Memory-Inhabit 的分工¶

本技能把成品寫到 output/<角色名>/。生成包可被 Memory-Inhabit（入心） 直接加載；部署到 Inhabit 的 personas/ 後，用戶可用「和 XX 聊聊」等自然語言進入角色對話。Memory-Inhabit 的說明位於同一 Monorepo 的 inhabit/SKILL.md（隨 Trace-Inhabit 倉庫分發）。

觸發與自動化工作流¶

觸發意圖包括：復刻角色、分析人格、製作 SoulPod。對 Agent 說 「幫我復刻 XX」 時，技能描述要求按順序自動執行（素材齊備後步驟 6–8 不等待人工確認）：

1. 檢測聯網搜索能力；若缺失，從 SkillHub 安裝 multi-search-engine@1
2. Web Search：檢索角色文本、圖片、音頻
3. 文本素材保存到 trace/origin/<遊戲>/<角色名>/（見 origin/README.md）
4. 圖片（3–5 張）→ .../assets/images/
5. 音頻（2–3 段）→ .../assets/audio/
6. analyzer.py 提取人格特徵（forge 會合並 origin 下 *.md）
7. forge.py create --from-origin <遊戲>/<角色名> 生成 SoulPod，並同步 origin 的 assets 到 output
8. forge.py install <角色名> 部署到 inhabit/personas/

技能包內已帶部分示例 SoulPod（如 output/夏以晝、output/葉修、output/秦徹 等）；這些角色在引入 origin/ 之前已生成，文檔說明不必補齊 trace/origin/，以 output/<角色名>/ 爲準。

SoulPod 產物結構¶

每個角色目錄通常包含：

生成時會根據性格關鍵詞、職業、身份推斷音色，寫入 config.json（如 tts_provider、minimax_voice_id、edge_voice 等字段，見技能文檔示例）。

Python 依賴¶

技能文檔要求：

pip install pdfplumber==0.11.9

用於處理 PDF 類素材時的解析（與 scripts/analyzer.py、scripts/forge.py 配合）。

安裝與啓用¶

通過 SkillHub CLI（推薦）¶

SkillHub 頁面給出的安裝方式是：讓 Agent 按 SkillHub 安裝說明 安裝本技能。核心命令形如：

command -v skillhub && skillhub --version

若未安裝 CLI，可按官方文檔執行一鍵安裝腳本；安裝技能時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能無法被識別：

skillhub install @user_570cbaaa/memory-trace --dir ~/.cursor/skills/

常見客戶端 skills 路徑（摘自 SkillHub 安裝文檔，按你實際環境選擇）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或項目下的 .agents/skills/

安裝完成後需重啓或刷新 Agent，使其加載新技能。SkillHub 上該技能當前統計爲：評分 100000，下載 1834 次，安裝 60 次（以 SkillHub 頁面/抓取數據爲準）。

與 Monorepo 開發路徑的區別¶

在 Trace-Inhabit 倉庫內開發時，路徑以 trace/ 爲根（origin/、output/、scripts/）。通過 SkillHub 安裝到 Agent 後，Agent 主要依據技能根目錄下的 SKILL.md 與 scripts/ 驅動流程；手工生成時可進入技能內的 scripts/ 目錄執行 forge.py（見下一節）。

典型用法¶

自然語言（交給 Agent）¶

技能文檔列出的入口話術：

• 「幫我復刻 XXX 人格」 — 走完整流程（搜索、下載、生成、部署）
• 把素材文件發給 AI 助手 — 手動啓動流程

已有 origin 素材時（腳本）¶

origin/README.md 中的推薦命令（在技能包的 scripts 目錄下執行，路徑相對 Trace 佈局）：

cd trace/scripts

python forge.py create --from-origin 戀與深空/秦徹

python forge.py create --from-origin 秦徹 --character "秦徹"

python forge.py install 秦徹

create --from-origin 會合並該 origin 目錄下排序後的 *.md，分析並寫入 trace/output/<角色名>/，並複製 assets；install 將包部署到 Inhabit 的 personas/。下游需已安裝 memory-inhabit 並完成 personas 部署，才能用「我想和 XX 聊聊」等話術進入對話（具體激活語句以 Memory-Inhabit 的 SKILL.md 爲準）。

適用場景與注意¶

適合誰

• 需要從小說、劇本、動漫或自備 Markdown/PDF 素材系統化提煉虛擬角色人格的團隊或個人
• 已計劃或正在使用 Memory-Inhabit，希望 SoulPod 目錄結構、記憶與故事基線一次生成、可版本管理

限制與注意

1. 下游依賴：本技能只負責生產 SoulPod；持續對話能力在 Memory-Inhabit，需單獨安裝並配置 personas/。
2. 聯網與搜索：完整「復刻」流程依賴 Web Search；無聯網搜索 skill 時會嘗試從 SkillHub 拉取 multi-search-engine@1，需網絡與 CLI 可用。
3. 版權與合規：角色與素材來自第三方作品時，請自行確認使用範圍；技能面向創作與私人實驗場景，不宜默認用於商用角色克隆。
4. 路徑語境：文檔中 trace/origin、inhabit/personas 等路徑對應 Trace-Inhabit Monorepo 佈局；僅通過 SkillHub 安裝單技能時，以 Agent 讀取的 SKILL.md 與包內 output/、scripts/ 爲準，避免與本地倉庫路徑混淆。
5. 無 API Key 標籤：SkillHub 標記 requires_api_key=false，但 TTS、圖生等擴展能力若啓用，仍可能依賴你在 config.json 中配置的外部服務。

結尾¶

memory-trace 把「從敘事素材到可加載人格包」收成一條可重複的 Agent 工作流：搜索與整理 origin、腳本分析、forge 出包、可選 install 到 Inhabit。若你正在搭建 Memory 系列的 Trace → Inhabit 鏈路，可以從 SkillHub 安裝該技能並按 SKILL.md 觸發復刻流程。

• SkillHub 頁面：https://www.skillhub.cn/skills/user_570cbaaa/memory-trace
• API 座標頁：https://api.skillhub.cn/user_570cbaaa/memory-trace
• 產品頁：https://memory-series.github.io/#/product/trace