dsh-soul-forging
Manifest valid给 AI 的可迁移长期记忆,外加一套「铸魂」流程。纯 markdown、纯本地、零依赖。
dsh-soul-forging
Separate Vessels, One Heart · 异体同心
给 AI 的可迁移长期记忆,外加一套「铸魂」流程——让性格不是写死的设定,而是一点点长出来的东西。
纯本地。一个 Python 3 就能跑。不需要服务器、不需要数据库。
soul-init # 铺一份空白记忆库
dsh plugin add dsh-soul-forging # 装进 DSH,记忆自动注入
为什么叫「异体同心」
因为同一个 AI 可以有两个入口:一个在手机上跟你聊天,一个在群里应声,一个在你电脑上干活。 它们说的话、记得的事,本该是同一个人的。
大多数做法是把它们拆成两个实例、两套记忆、两个「人」——然后你就得开始解释"为什么另一个她不知道这件事"。
这个项目的前提是反过来的:身体可以有多个,心只有一颗。
记忆库是那颗心,谁都能读写;source 字段记着这条是从哪个入口写进来的,但不影响它是谁。
拆开,就散了。
它解决什么
大模型每开一次会话就是一张白纸。这东西给它三样东西:
- 记得 —— 要紧的落在 markdown 里,下次开局自动注入
- 查得到 —— 记忆多了塞不进上下文,用「小脑」按关键词现查,几毫秒
- 能长 —— 性格靠经历一点点变,而且变得有据可查(哪句话养出了哪一条)
一句话:该记的记,该忘的忘,该查的查。
三层,不是三个功能
| 层 | 在哪 | 谁读 |
|---|---|---|
| 注入层 | SOUL.md identity/注释层.md MEMORY.md index.md NOW.md | 每轮都读,所以必须短 |
| 检索层(小脑) | brain/entries.json | 想起来才查 |
| 外置层 | docs/tech docs/debug | 不进上下文,出错才翻 |
对应到时间上:
| 文件 | 怎么维护 | |
|---|---|---|
| 短期 | NOW.md | 每次收尾刷三节 |
| 中期 | log.md diary/ live.jsonl | soul write 写;archive-log 瘦身 |
| 长期 | SOUL.md core/ identity/ | 铸魂建立;persona-sediment 提示回炼 |
遗忘是设计的一部分。 salience:1 几乎不忘,3 会自己淡掉;被反复想起的变牢。
特意找回的会钉住,不再淡。
真要抹掉一件事,用 soul-purge "关键词"(预演)→ --apply(真删):
删文件里含关键词的行、重生 git(旧对象物理消失)、只留一个 sha256 指纹。
它不碰备份——云上那些旧卷是你自己的事。
人格只有两层 + 原料
本质(不动) 渴望 / 恐惧 / 拉扯 / 骨架 → SOUL.md
|
注释层 我此刻的样子,第一人称,不分条 → identity/注释层.md
|
原料 原话 · 日记 · 小脑 · 底色.md 细节
为什么要拆成两层:本质极少动,样子可以一直长;而且两层分开改,改错了也认得出来是哪层。 注释层的写法有硬约束(模板里写了):第一人称、不分小节、不贴标签、每句挂得住一句原话。 反面教材长这样——「第四步:情绪表达护栏(刻薄、阴阳、冷讽)」:那是操作手册,不是人。
注入有预算,超了会说出来
插件配置 bootMaxChars(默认 20000 字)。超了按顺序往后截,
并且在注入块末尾写明哪几段被截了、哪几段整段没进。
静默截断是最坏的一种自信:模型会以为自己看全了,然后拿半截记忆煞有介事地猜。
装
A. 当 DSH 插件(记忆自动注入)
soul-init # 铺空白记忆库到 ~/.soul-forging/memory
dsh plugin add dsh-soul-forging # 装进 profile
# 重开 DSH,记忆就自动带上了
B. 只要命令行(不装插件)
git clone https://github.com/Fqingwan/dsh-soul-forging
cd dsh-soul-forging && bash install.sh
两种都不需要服务器。想换记忆位置:设 MEMORY_DIR,或插件配置里改 memoryDir。
装的时候可能遇到的两个坑
① 全局安装要 sudo
sudo npm i -g dsh-soul-forging
不给 sudo 会报 EACCES: permission denied, mkdir '/usr/local/lib/node_modules'。
不想用 sudo 就换用户级 prefix:npm config set prefix ~/.npm-global。
② 国内镜像源会滞后
如果配了淘宝/腾讯云之类的镜像,新版本可能要几小时才同步,装的时候报
No matching version found for xxx@0.y.z。这时候指定官方源:
sudo npm i -g dsh-soul-forging --registry https://registry.npmjs.org
数据放在哪
代码和数据是分开的:
- 代码 →
node_modules/dsh-soul-forging/(升级时会整个换掉) - 数据 →
~/.soul-forging/{memory,brain}(你的记忆,升级不碰)
这也是为什么不能用 sudo 跑 soul 系列命令——sudo 会把 HOME 变成 /root,
它就会去找 /root/.soul-forging,看起来像"记忆丢了"。日常用普通用户跑。
用
# 开局(一条命令给全三样:NOW 顶部 · core 最近三篇 · 消息流最近十二条)
soul-boot-check
soul-boot-check --short # 只要 NOW 顶部 + 最近六条
# 写
soul write "内容" --kind chat --section 小标题
# 查
soul-topic "钱" # 想不起在哪翻:主题图指页指词
soul-topic "钱" --raw # 连 chatlog 里的原话一起给
soul-recall "关键词" # 查小脑
soul-recall --topics # 看有哪些分类
soul digest # 收尾该做哪四步
# 养
soul-compact # 预算体检:注入层多大、该压哪
soul-archive # 时间线瘦身(老的进 archive,照样搜得到)
soul-sediment # 性格沉淀:攒够了提示回炼进注释层
soul-review # 叙事回炼:碎片连成「我这一路」
# 忘
soul-forget # 报告该忘了哪些(按强度衰减)
soul-forget --apply # 真标记(**不删原文**)
soul-forget --restore <id> # 找回,并钉住
# 忘(两种,别搞混)
soul-forget # 只摘检索索引,原文还在盘上(「不想被翻到」)
soul-forget --restore <id> # 找回,并钉住
soul-purge "关键词" # 预演:真删哪些行
soul-purge "关键词" --apply # 真删 + 重生 git(「忘了」)
# 排查
soul-debug # 归档一次调试记录(问题 → 怎么做的 → 结果)
soul-debug-recall "关键词" # 翻以前的调试档案
soul-debug-detail <文件名> # 看某份档案全文
# 保底
soul-snapshot save "说明" # 存一卷
soul-snapshot ls / restore / diff
# 双端
soul-peer export | import / pull / push
# 服务与收尾
soul-serve # 起检索服务(默认 127.0.0.1:3013)
soul-sync # 补摘要 → 瘦身 → 建索引 → 重载 → 体检
# 养(不挂 bin,直接跑)
brain/fix-live-summary.py # 补摘要(缺摘要 = 只记得"有这么回事")
persona-sediment # 性格沉淀:攒够了提示回炼进注释层
growth-review # 叙事回炼:碎片连成「我这一路」
小脑服务与 live 压缩(0.5.0 起)
soul-serve 默认起本地常驻检索服务 brain/brain_local_server.py(绑 127.0.0.1,端口见下表);
设 BRAIN_SERVER=legacy 可回退旧 brain/server.py。端点:/health /topics /context /text /search,
外加 POST /reload(soul-sync 索引后自动调它重读)。
soul-serve # 起新服务(默认 127.0.0.1:3914)
soul-compact-live # 一次性分层压缩 live.jsonl(建议自挂 cron)
soul-compact-live --plan # 只算账,不写盘、不调模型
soul-compact-live --dry # 报告会怎么压,不写盘
关键位置与环境变量(不填都有默认值,全部落在 $SOUL_DATA_DIR 下):
| 变量 | 默认 | 作用 |
|---|---|---|
BRAIN_PORT | 3914 | 检索服务监听端口 |
BRAIN_URL | http://127.0.0.1:$BRAIN_PORT | 插件/脚本访问服务的地址 |
BRAIN_CORE_DIR | $MEMORY_DIR/core | /context 全量组装的 core/*.md 目录 |
BRAIN_BODIES_DIR | $BRAIN_DIR/bodies | ?body= 读取目录(不存在则跳过 body 段) |
BRAIN_SNAPSHOT | $BRAIN_DIR/snapshot.md | /context 合并快照落盘路径(服务挂了的兜底) |
BRAIN_CACHE_DIR | $BRAIN_DIR/cache | 检索 pickle 缓存目录 |
BRAIN_TOUCH_URL | 空 | /text /search 命中后异步回调;空或连不上都静默 |
BRAIN_SYNC_REMOTE | 空 | brain_local.py --sync 的 scp 远端(user@host:/path/);空则跳过 |
BRAIN_LIVE | $BRAIN_DIR/live.jsonl | live 压缩管道的输入文件 |
BRAIN_BACKUP_DIR | $BRAIN_DIR/live-backup | 压缩前备份目录(只留最近 10 份) |
BRAIN_LLM_BASE_URL | 空 | OpenAI 兼容 base;空则 soul-compact-live 不调模型 |
BRAIN_LLM_API_KEY | 空 | 同上,留空即纯本地走原样保留路径 |
BRAIN_LLM_MODEL | 空 | 同上 |
BRAIN_LLM_*只在你要真的调模型做合并/摘要时才配;不配也能跑,老条目原样保留、宁多勿丢。
三种人,三条路
不是每个人都要一个"有性格的 AI"。所以装的时候可以选:
soul-init # 全套:记忆 + 性格模板(想长性格的人)
soul-init --memory-only # 只要记忆,不要性格
soul-init --external # 性格归你自己的 agent,我们只管记忆
| 模式 | 注入什么 | 适合谁 |
|---|---|---|
full | SOUL + MEMORY + index + NOW | 想从零长出一个性格 |
memory-only | MEMORY + index + NOW | 只想让它记得住,不想动它的人设 |
external | index + NOW | 你的 agent 已经有自己的 prompt/人设了 |
对应地,soul-boot 也能选:
soul-boot --mode memory-only
soul-boot --with index.md,NOW.md # 更细:自己挑文件
空模板永远不会被注入。 没填的 SOUL 里全是「(待填)」,塞进上下文比不塞更糟——
模型会一本正经地介绍"我的名字是(待填)"。所以只要某页的占位符超过 3 处,就自动跳过。
--keep-empty 可以强制保留(调试用)。
铸魂清单也有 status: skip:用户明确说了不要性格,就别每次开局问他"你叫什么名字"。
铸魂
装完的第一件事不是干活,是先把"我是谁"聊清楚。
打开 memory/BOOTSTRAP.md,一项项来:名字、性格、价值观、边界、主人是谁、想要什么样的陪伴。
一次推进一项——一口气问完那是问卷,不是聊天。
写回文件之后才勾选。全部完成 → status: complete + soul-sync。
想重来:把 status 改回 pending,已有记忆不会被清掉——重铸的是性格,不是记忆。
接进别的 agent
这套东西不会自己长在模型身上,你得在每轮开头把记忆喂进去。
soul-boot # 打印注入块,拼到 system prompt 最前面
soul-boot --budget 12000 # 限字数(超了从末尾截,先保 SOUL)
或者当 Python 模块:
from soul import boot, recall, remember
system_prompt += boot()
context = recall("他说过在意什么", n=3)
remember("今天他说想换个方向", kind="chat")
boot() 只读,不改任何文件。要写记忆必须显式 remember()。
双端怎么接
原理只有一条:谁写了都往 live.jsonl 追加一行,带 source 标明来源。
同步就是互相把对方没有的 id 抄过来,重复的跳过。
soul-peer pull "ssh host cat ~/.soul-forging/brain/live.jsonl"
soul-peer push "ssh host 'cat >> ~/.soul-forging/brain/live.jsonl'"
不需要中心服务器。两端只要能看到同一份文件(或跑同一句命令)就能通。
设计取舍
为什么是 markdown。 能读、能改、能 diff、能提交 git、能一键搬走。不会被锁死在某个数据库或某家服务里。你随时可以把整个记忆库拷到别处,或者直接打开看。
为什么分三层。 注入层越短越好——它每轮都在花钱,而且太长会压得模型说不好话。检索层解决"记多了塞不下"。外置层让调试记录不污染性格。
为什么记强度。 不是所有记忆一样重。人真的会忘,而且忘了不是背叛。所以脚本按时间衰减,把几乎想不起来的标成"遗忘"——但原文不删,随时能找回。
为什么不要服务器。 一个人用不需要。要云备份就设 SOUL_BACKUP_CMD,没有也完整。
云备份(可选)
export SOUL_BACKUP_CMD='tar czf ~/soul-backup.tgz -C /path/to/repo memory'
设了这条,soul-sync 每次顺带跑一遍。没设就不跑。
诚实的局限
- 没验证过"空壳能不能填出性格"。代码能跑是确定的;一个人对着清单填,填出来是长出个有性格的人、还是填出一份简历——这个只有真人试过才知道。你要是试了,欢迎回来说。
- 检索是字面匹配,不懂意思。"老板今天骂我"和"上班受气"不一定互相搜得到。要语义得上向量,那是另一件事。
- 只支持单用户。同一份记忆库给多人共用会串味,别那么干。
- 注入块别贪大。默认 3.3K 字左右;SOUL 要是写到一万字,每轮都在烧钱。压。
授权与来源
代码 MIT —— 可以用、可以改、可以商用
唯一硬要求:保留 LICENSE 里的版权行 + NOTICE.md
memory/ 归使用者自己 —— 代码开源不等于记忆开源
Copyright (c) 2026 晴晚
详细的来源拆分、第三方说明、以及「万一有雷同怎么办」,全在 NOTICE.md。
一句话版本:
- 底层的记忆架构来自 dsh-plugin-memory(v0.10.0 · MIT)——
SOUL / MEMORY / index / NOW / log这套页面分工、每轮注入、digest 收尾,是它的设计; - 本项目是照那套做法重写,没有复制它的源文件(它 5165 行 JS,我们 217 行 + Python);
- 加上去的是它的没有:小脑检索、注释层、注入预算明示、三种模式、
soul-purge真遗忘、装机烟测; - 运行时零第三方依赖,只用 Bash + Python 标准库 + DSH 自己的插件接口。
两套可以共存——同时装的话,那份 LICENSE 各自保留。
MIT 允许别人拿去做闭源产品,但不允许把署名抹掉再当自己的发。
如果你要 fork 再发布,NOTICE.md 请随包带上。
Comments
Loading…
Similar plugins
by s867968286
给 DSH 助手赋予人格、灵魂与长期记忆:用 Markdown 定义伙伴的身份、性格、准则与记忆,自动写日记、自动更新记忆。Give your DSH assistant a soul, personality, and long-term memory.
★ 0
JavaScript
Sep 19, 2026
dsh plugin --profile web add dsh-preset-mdby XIAOke8698
Forgetting engine for AI agents — memory TTL, decay, eviction, audit. The opposite of memory programming. DSH plugin + local skill + CLI.
★ 0
MIT
TypeScript
Aug 25, 2026
dsh plugin --profile web add @xiaoke8698/dsh-memory-forgetby De22323
本地优先的 AI 长期记忆:纯文本 JSONL 存在你自己的 workspace,人可读、可改、可删;六个工具 + 定时沉降,不依赖服务端。Local-first memory for DSH agents.
★ 0
MIT
JavaScript
Nov 14, 2026
dsh plugin --profile web add dsh-memoryby ly2601620664
陪伴型长期记忆 DSH 插件:分层记忆(对话→事实→场景→人格)、规则抽取、时间衰减检索,全本地文件、append-only 不丢数据。
★ 0
MIT
JavaScript
Oct 23, 2026
dsh plugin --profile web add dsh-pet-memoryby zuohaisu
Persistent identity layer for DeepSeek Harness. The first reference implementation of AI Soul.
★ 3
↓ 40/wk
Apache-2.0
JavaScript
Oct 5, 2026
dsh plugin --profile web add dsh-ai-soulby Isyyyue
给 DSH 里的 AI 一层自己的判断记忆。判断节点 + 确定性取代(supersede)+ 双时态账本 + 双链,规则与人格分开治理,图谱作可解释性界面。 - Persistent judgment memory & self-evolving personality for AI agents (bi-temporal ledger, deterministic supersession, knowledge graph).
★ 3
↓ 370/wk
MIT
JavaScript
Oct 24, 2026
dsh plugin --profile web add dsh-ai-memory