catalog/repos/aaronjmars--soul-md.md

209 lines
8.0 KiB
Markdown
Raw Normal View History

2026-04-06 19:01:37 +08:00
# 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 很烦。"
- 加入 23 条内联对话示例用于模式匹配
- 提高温度0.70.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>