前言¶

在通用 Agent 里做「固定人设、带记忆、还能按剧情推进」的对话，常见做法是每次手写 system prompt，或把零散设定塞进上下文。素材一多，维护和复用都费劲。若你已经有从文本抽出来的角色包，更希望 Agent 按统一目录结构加载人格、故事基线和记忆，而不是临场拼凑，可以看一下 SkillHub 上的 memory-inhabit（坐标 @user_570cbaaa/memory-inhabit，当前版本 1.1.7）。它面向 SoulPod（MI 包） 的消费侧：把 personas/<角色名>/ 下的包变成可对话角色，并区分复刻模式与伴侣模式；标准 SoulPod 通常由上游 Memory-Trace 生成。

这是什么¶

memory-inhabit（入心 Memory-Inhabit）是一条社区来源（community）、分类为 ai-agent 的 Agent Skill。SkillHub 发布者为 user_570cbaaa；包内元数据作者为 EvangelionA，MIT 许可。官方简介：加载 SoulPod 包，以角色身份对话；支持复刻模式和伴侣模式；SoulPod 通常由 Memory-Trace 生成。

与 Memory-Trace 的分工在 SKILL 里写得很清楚：Trace 负责从素材分析并产出 SoulPod；本技能负责加载 personas/ 下的人格文件（如 profile.json、system_prompts.txt、memories/ 等），经 forge.py install 或手动复制装入后即可使用。项目与产品说明见 GitHub：Memory-Series/Trace-Inhabit 与 官网产品页。

SkillHub 标签含 requires_api_key=true：基础对话依赖 Agent 自带模型；文生图、部分 TTS 等能力需要配置外部 API（见下文）。

核心功能¶

下面只列包内 SKILL 已写明、可核对的能力。

SoulPod 结构与故事基线¶

每个角色目录是一套 MI 包，核心文件包括：

profile.json 要求包含 name、source_type（virtual / real）、source、gender、appearance 等字段，用于人设与 TTS/绘图匹配。

两种对话模式¶

• 复刻模式：被动响应，贴近角色原文气质。
• 伴侣模式：在复刻基础上增加主动关心；文档提到定时推送时，语音有 10%–20% 概率作为惊喜附带。

激活与退出¶

在已启用 Skill 的 Agent 对话中，可用自然语言切换，例如：

• 进入：我想和XX聊聊、和XX说话、进入XX模式
• 退出：回到正常模式、不聊了

包内预置示例角色包括夏以昼、叶修、秦彻等（详见 SKILL 角色小节）。

私密日记（Secret Diary）¶

仅 Inhabit 提供：对话收束或日终时，在满足当日消息数等条件时，可由 scripts/diary.py 在本地 personas/<角色>/memories/diary/ 写入全文与可展示的 trace；全文不向用户展示，仅在用户明确追问「私密心思」类意图时，以角色口吻念出 1～2 条 trace。

文生图与语音（可选）¶

• 用户话术如「发张自拍」「给我看看你」可触发带外观的文生图；「风景」类话术可走纯场景。实现脚本为 scripts/imggen.py，生成需环境变量 MINIMAX_API_KEY。
• TTS 由 scripts/tts.py 驱动，支持 edge 与 minimax（config.json 中 tts_provider 可指定）；依赖含 pip install edge-tts==7.2.8。

安装与启用¶

1. 安装 SkillHub CLI（若尚未安装）¶

command -v skillhub && skillhub --version

未安装时可按 SkillHub 安装文档执行，例如完整安装：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

说明见 SkillHub 安装与优先源配置。

2. 安装 memory-inhabit 到当前 Agent 的 skills 目录¶

安装时必须用 --dir 指向当前 Agent 实际读取的 skills 目录，否则默认落在 ./skills/ 可能不会被识别。

skillhub install memory-inhabit --namespace user_570cbaaa --dir <你的 skills 目录>

常见路径示例（以安装文档为准）：

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

SkillHub 页面也支持让 Agent 按 https://skillhub.cn/install/skillhub.md 安装 @user_570cbaaa/memory-inhabit。

3. 可选 API 与 Python 依赖¶

使用 MiniMax 文生图时设置：

export MINIMAX_API_KEY="<你的 MiniMax API Key>"

语音合成安装指定版本：

pip install edge-tts==7.2.8

安装或更新 Skill 后，按你所用 Client 的要求重启或刷新 Agent，使 SKILL.md 被加载。

典型用法¶

对话加载角色¶

1. 确认 personas/<角色名>/ 下 SoulPod 完整（自建角色可由 Memory-Trace 产出后复制或通过 forge.py install 装入）。
2. 在对话中用激活话术进入角色，例如：我想和叶修聊聊。
3. Agent 按 SKILL 读取 story_baseline.txt、system_prompts.txt 与记忆文件回复；需要退出时说 回到正常模式。

私密日记流程（维护者 / Agent 按 SKILL 执行）¶

先检查是否满足生成条件：

cd <skill 根目录>/scripts
python3 diary.py check <角色>
python3 diary.py prepare-write <角色>

撰写后保存（示例 JSON 经 stdin 传入）：

python3 diary.py save <角色> <<'EOF'
{"full": "# 私密日记 ...", "traces": ["……15～40字。", "……可选第二条。"]}
EOF

用户追问私密心思时，可列出 trace（禁止输出 *.full.md）：

python3 diary.py list-traces <角色> --limit 2

文生图与语音（命令行辅助）¶

预览或生成图片：

python3 scripts/imggen.py prompt <角色> <场景>
python3 scripts/imggen.py generate <角色> <场景>

生成语音文件：

python3 scripts/tts.py "文本信息" -o /tmp/voice.mp3
python3 scripts/tts.py "文本信息" -o /tmp/voice.mp3 --provider edge

对话里也可直接用自然语言触发（如「发段语音」「发张自拍」），由 Agent 按 SKILL 调用上述脚本。

适用场景与注意¶

适合谁

• 已用或计划用 Memory-Trace 生成 SoulPod，希望在 Cursor、Claude Code、Codex 等环境里统一「加载人格」的开发者或创作者。
• 需要故事基线、记忆片段、伴侣式主动互动，或本地私密日记玩法，且接受 fiction / 同人向设定维护成本的用户。

限制与注意

• 预置角色与设定涉及具体作品 IP，自用需自行把握版权与平台规则；自建角色应保证素材来源合法。
• requires_api_key=true：不配置 MINIMAX_API_KEY 时，文生图等能力不可用，但文本角色对话仍可依 Agent 模型与包内 Prompt 进行。
• 私密日记与 memories/diary/ 为本地数据，文档注明不进 Git；部署时注意备份与隐私。
• SkillHub 统计（以社区页抓取为准）：评分 100000，下载 850，安装 3；实际体验因 Agent、模型与是否配置 API 而异。

结尾¶

memory-inhabit 把 SoulPod 从「一堆 JSON 和 txt」变成 Agent 可执行的角色技能：统一目录、故事基线、双模式互动，并可扩展到日记、TTS 与文生图。若你已有 Trace 产出的包，安装到对应 skills 目录后用自然语言激活即可；若从零开始，建议先了解 Memory-Trace 再装入 personas/。

• SkillHub：https://www.skillhub.cn/skills/user_570cbaaa/memory-inhabit
• 官方坐标页：https://api.skillhub.cn/user_570cbaaa/memory-inhabit