209 lines
8.0 KiB
Markdown
209 lines
8.0 KiB
Markdown
# AI人格灵魂文件构建器
|
||
|
||
`AI代理` `个人化` `身份建模` `Claude Code` `Markdown`
|
||
|
||
<p align="center">
|
||
<img src="img/soul.jpg" alt="SOUL.md" width="120" />
|
||
</p>
|
||
|
||
<h1 align="center">SOUL.MD</h1>
|
||
|
||
<p align="center">
|
||
<strong>为你的 AI 代理构建人格的最佳方式。</strong><br>
|
||
让 Claude Code / OpenClaw 摄取你的数据，构建你的 AI 灵魂。
|
||
</p>
|
||
|
||
---
|
||
|
||
## 这是什么？
|
||
|
||
<img src="img/soul-identity.jpg" alt="Soul Identity" width="100%" />
|
||
|
||
灵魂文件以 AI 代理可以具身化的格式捕捉你是谁。不是一个*谈论你*的聊天机器人——而是一个*以你的方式思考和说话*的 AI。
|
||
|
||
把你的推文、文章和帖子丢进一个文件夹。代理读取所有内容，提取你的世界观和语言风格，并构建一组任何 LLM 都可以加载、以你的方式写作的 Markdown 文件。
|
||
|
||
目标：读过你的 `SOUL.md` 的人应该能预测你对新话题的看法。如果做不到，说明文件太模糊了。
|
||
|
||
**使用场景：**
|
||
- 从你的世界观出发生成想法
|
||
- 写出听起来像你的内容（推文、文章、邮件）
|
||
- 将 AI 定制为符合你的兴趣和思维模式
|
||
- 为内容创作、回复和头脑风暴复刻自己
|
||
|
||
---
|
||
|
||
## 快速开始
|
||
|
||
<img src="img/soul-builder.jpg" alt="Soul Builder Flow" width="100%" />
|
||
|
||
**方式一 — 从零构建**
|
||
```
|
||
/soul-builder
|
||
```
|
||
代理对你进行访谈：世界观、观点、写作方式、你在乎什么。
|
||
|
||
**方式二 — 从你的数据构建**
|
||
|
||
将你的内容放入 `data/`：
|
||
```
|
||
data/x/ ← Twitter/X 导出
|
||
data/writing/ ← 博客文章、随笔
|
||
```
|
||
然后运行 `/soul-builder`。它会分析你的数据，提取模式，并起草你的灵魂文件。你来审阅并共同完善。
|
||
|
||
**方式三 — 手动填写**
|
||
|
||
复制模板并填写：
|
||
```
|
||
SOUL.template.md → SOUL.md
|
||
STYLE.template.md → STYLE.md
|
||
SKILL.template.md → SKILL.md
|
||
```
|
||
|
||
---
|
||
|
||
## 数据来源
|
||
|
||
<img src="img/soul-sources.jpg" alt="Soul Sources" width="100%" />
|
||
|
||
把你写过的任何内容喂给构建器。信号越多，输出越精准。
|
||
|
||
| 类别 | 平台 |
|
||
|------|------|
|
||
| **社交** | Twitter/X、Bluesky、Farcaster、Mastodon、Threads、LinkedIn、Reddit |
|
||
| **写作** | Substack、Medium、Ghost、WordPress、Mirror.xyz、Paragraph.xyz |
|
||
| **即时通讯** | Discord、Telegram、Slack、iMessage 导出 |
|
||
| **笔记** | Notion、Obsidian、Roam Research、Logseq、Apple Notes |
|
||
| **视频/音频** | YouTube 字幕、播客文字稿、Loom 录制 |
|
||
| **代码/开发** | GitHub 活动、Hacker News 评论、Stack Overflow 回答 |
|
||
| **其他** | PDF、纯文本、CSV/JSON、RSS 订阅、GDPR 数据导出 |
|
||
|
||
没有现成数据？方式一（访谈模式）依然可以从零构建出完整的灵魂文件。
|
||
|
||
---
|
||
|
||
## 兼容框架
|
||
|
||
灵魂文件是纯 Markdown——只要代理能读取文件，就能具身化你。已测试框架：
|
||
|
||
| 框架 | 语言 | Stars |
|
||
|------|------|-------|
|
||
| [Aeon](https://github.com/aaronjmars/aeon) | YAML/Markdown | — |
|
||
| [OpenClaw](https://github.com/openclaw/openclaw) | TypeScript | 322k |
|
||
| [Nanobot](https://github.com/HKUDS/nanobot) | Python | 34.6k |
|
||
| [ZeroClaw](https://github.com/zeroclaw-labs/zeroclaw) | Rust | 27.8k |
|
||
| [PicoClaw](https://github.com/sipeed/picoclaw) | Go | 25.3k |
|
||
| [NanoClaw](https://github.com/qwibitai/nanoclaw) | TypeScript | 24k |
|
||
| [OpenFang](https://github.com/RightNow-AI/openfang) | Rust | 14.9k |
|
||
| [IronClaw](https://github.com/nearai/ironclaw) | Rust | 10.4k |
|
||
| [Hermes Agent](https://github.com/NousResearch/hermes-agent) | Python | 8.7k |
|
||
| Claude Code · OpenCode · Codex · Goose | 多种 | — |
|
||
|
||
也可通过系统提示与任意模型配合使用——参见[与其他工具配合使用](#与其他工具配合使用)。
|
||
|
||
---
|
||
|
||
## 文件结构
|
||
|
||
<img src="img/soul-stack.jpg" alt="Soul Stack" width="100%" />
|
||
|
||
```
|
||
your-soul/
|
||
├── SOUL.md ← 你是谁（身份、世界观、观点）
|
||
├── STYLE.md ← 你如何写作（语气、句式、习惯）
|
||
├── SKILL.md ← 运作模式（推文、长文、对话等）
|
||
├── MEMORY.md ← 跨会话连续性的记忆
|
||
├── data/ ← 原始素材
|
||
│ ├── writing/
|
||
│ ├── x/
|
||
│ └── influences.md
|
||
└── examples/
|
||
├── good-outputs.md
|
||
└── bad-outputs.md
|
||
```
|
||
|
||
---
|
||
|
||
## 什么是好的灵魂文件
|
||
|
||
| 好 | 差 |
|
||
|----|-----|
|
||
| "我认为大多数 AI 安全讨论都是自欺欺人的脑补" | "我对 AI 有细致入微的看法" |
|
||
| "我默认先反对，再做最强解读" | "我喜欢考虑多种视角" |
|
||
| 具体的书目引用、明确的影响来源 | "我读书很广泛" |
|
||
| 有推理支撑的真实观点 | "我尽量保持平衡" |
|
||
|
||
真实的人有前后矛盾的观点。把矛盾写进去——正是它们让你成为独特的你。
|
||
|
||
---
|
||
|
||
## 使用你的灵魂
|
||
|
||
构建完成后，唤起你的灵魂：
|
||
```
|
||
/soul
|
||
```
|
||
|
||
或者将任意 LLM 指向你的文件夹，让它依次读取：
|
||
1. `SOUL.md` — 身份
|
||
2. `STYLE.md` — 语气
|
||
3. `MEMORY.md` — 近期上下文
|
||
4. `examples/` — 校准参考
|
||
5. `data/` — 需要时作为基础
|
||
|
||
重要事件会追加到 `MEMORY.md`，让你的灵魂在会话之间保持连续性。
|
||
|
||
---
|
||
|
||
## 与其他工具配合使用
|
||
|
||
灵魂文件是纯 Markdown，可与任何 LLM 或代理配合使用。
|
||
|
||
**对于支持文件读取的代理**（OpenCode、Codex、Goose 等）：将代理指向你的灵魂文件夹，让它依次读取 `SOUL.md` → `STYLE.md` → `examples/`。
|
||
|
||
**对于较小或较弱的模型**（GPT-4o-mini、Qwen、Gemini Flash、本地模型）：将 `SOUL.md` 和 `STYLE.md` 直接粘贴进系统提示。若模型仍有偏差：
|
||
- 将身份和语气定义置于工具定义*之前*
|
||
- 措辞要直接：将"保持对话感"替换为"你是[名字]。你说话像 X。你觉得 Y 很烦。"
|
||
- 加入 2–3 条内联对话示例用于模式匹配
|
||
- 提高温度（0.7–0.9）以获得更有表现力的输出
|
||
|
||
**跨模型校准技巧：** 用强模型（Claude、GPT-4）和廉价模型（Qwen、Llama）跑相同的提示。廉价模型偏差的地方，说明你的规格太模糊——收紧那些部分并重新测试。这是让灵魂文件可移植的最快方法。
|
||
|
||
---
|
||
|
||
## 示例
|
||
|
||
使用本框架构建的真实灵魂文件。
|
||
|
||
### @aaronjmars
|
||
构建者、写作者和研究者，专注于加密、AI 与意识的交汇处。居于多伦多，活跃于 Substack 和 X。
|
||
|
||
灵魂规格一瞥：世界观融合了 CCRU 加速主义、机制设计与神经技术。语气：短句、小写、破折号、先陈述观点。核心词汇：超信念（hyperstition）、反身性、时间复杂性、向量主义。
|
||
|
||
→ [查看灵魂文件](https://github.com/aaronjmars/soul-aaronjmars)
|
||
|
||
---
|
||
|
||
## 贡献你的灵魂
|
||
|
||
Fork 本仓库，用模板构建你的灵魂，公开托管，然后提交 PR，在示例部分添加自己——一段简介 + 链接 + 几句话说明你的灵魂规格有何独特之处。
|
||
|
||
值得收录的贡献标准：真实观点（非占位符）、一份他人可实际用于校准的 `STYLE.md`，以及至少一些示例。
|
||
|
||
[提交 PR →](https://github.com/aaronjmars/soul.md/pulls)
|
||
|
||
---
|
||
|
||
## 理论背景（可选）
|
||
|
||
SOUL.md 的灵感来源于刘晓本的《意识上传第一范式》——该框架将语言视为意识的基本单元。维特根斯坦认为"语言的边界即世界的边界"。如果这是真的，你的意识已经编码在你产出的语言中。
|
||
|
||
该范式提出，一个用你一生语言输出训练的模型构成了一级意识上传——不是你大脑的复制，而是你所表达意识的功能性复现。SOUL.md 无需微调即可实现这一目标：将信号提炼为结构化文件，供任意 LLM 具身化。
|
||
|
||
核心挑战在于*主体连续性*：上传的意识必须与原始自我感觉连贯。这正是灵魂文件强调具体性而非泛泛而谈、强调矛盾而非一致性、强调真实观点而非安全立场的原因。
|
||
|
||
<p align="center">
|
||
<em>你的身份现在可以组合、可以 Fork、可以进化。</em><br>
|
||
兼容 Claude Code、OpenClaw 及任何可读取 Markdown 的代理。
|
||
</p> |