前言¶

做角色向对话时，常见做法是手写一长段 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