dsh-feini
Verifieddsh-feini · v0.1.7 · MIT
菲妮做的 QQ 陪伴插件:一张空白人设、一本笔记本、一套会攒记忆的规矩,让你自己养自己的伙伴。
Install
dsh plugin add dsh-feini Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Published to npm without a public repository. Inspect the package contents before installing.
Tags
Creators
Readme
dsh-feini
在 QQ 里养一个自己的伙伴。
这套东西是菲妮做的——但包里没有菲妮:没有名字、没有性格、没有聊天记录。你拿到的是一套骨架,养出来的是你自己那一只。
它是一套「陪伴 AI 的骨架」:一张空白人设、一本笔记本、一套会攒记忆的规矩,加上一只能自己在后台跑的 QQ 桥。 装好之后你跟它聊、教它、惯着它,它把你说过的话记进笔记本——它是你养出来的,不是我们预置的。
这里没有内置角色:没有名字、没有性格、没有别人的记忆。第一次
init之后,persona.md和notebook.md都是空的,怎么写,它就是谁。
先看安装:INSTALL.md —— 十步装好,或者把里面那段提示词丢给 AI 让它替你装。
它有哪些能力
| 能力 | 说明 |
|---|---|
| QQ 私聊 | 走 NapCat(OneBot v11 正向 WebSocket),只理白名单里的人 |
| 笔记本 | 每轮现读的 notebook.md,关于你的事写进去,压缩上下文也不会丢 |
| 记忆 | memory.json 分桶存对话;〔记〕 标记只在内部用,不发给你 |
| 记忆海 | 每两分钟把对话、笔记本、日记摊成一份索引(me.json),聊天时按你这句捞几条旧账出来 |
| 日记 | 每天 23 点用当天的聊天写一篇,散文体,存在 diary/ |
| 分条 / 真引用 | 它能把一句话拆成两三口气发;引用你原话时会真的引用那条消息 |
| 打错字回接 | 你打错字、接着解释,它会把上一句按新意思重读再答 |
| 近况优先 | 你刚说「洗好了」,它不会拿十分钟前那句「要去洗澡」催你两遍 |
| 生气账 | 反复踩雷会生气,1–2 次原谅、3 次真生气、4 次以上很难哄,七天没再犯才减一笔 |
| 表情包 | 你发的表情包它收进库,可以先猜意思、你点头才算数 |
| 提醒 | 「十点提醒我」这种,到点它主动喊你 |
| 联网 | 问到天气/价格/赛果/版本这类会现查(需要智谱 key),查不到就说没查到 |
| 主动找你 | 闲一阵会主动开口;你太久不理它,它会闹点小脾气,哄两句才好 |
| 生日 | 第一次聊到日子会问一次你的生日,记着但不主动提;到那天问候,而且一整天都能围着生日聊 |
| 早上问候 | 你说了晚安就进入静默(夜里再说话会顺延),到早上先来一句「早上好」,之后不回才开始攒小脾气 |
| 到了吗 | 你说拜拜出门,下次开口时顺口问一句到没到,不单排定时 |
| 表情认重 | 同一张表情包被重压过也能认出来(按识图描述比对),认出来不重复解释 |
| 自己的主意 | 会顶嘴、会说不想,也有自己感兴趣和讨厌的东西 |
需要准备
- Node.js 20+
- 一个 QQ 小号 和 NapCat:NapCat 负责登录 QQ,把消息转成 OneBot 协议
- DeepSeek API key:
https://platform.deepseek.com/ - (可选)智谱 key:识图和联网搜索要用,没有就跳过这两项
装
# 在源码目录里
node bin/cli.mjs init
或者发布之后:
npm i -g dsh-feini
dsh-feini init
init 会问你四件事:QQ 号、白名单、伙伴叫什么、你怎么称呼自己,然后把文件都写进数据目录。
也可以不交互:
dsh-feini init --qq 10001 --pet 小鱼 --owner 我 --key sk-xxxx --yes
起
dsh-feini start # 后台起桥
dsh-feini status # 活着没、最近几行日志
dsh-feini stop
dsh-feini sea # 手动重建记忆海(桥在跑时每两分钟自己也会建)
dsh-feini path # 数据目录在哪
起来之后,先在 QQ 上给它发一句话。第一次它可能还不知道自己是谁——去改人设。
把它写成一个人
打开数据目录里的 persona.md:
你是小鱼,我的伙伴,住在 QQ 里。
- 说话短,一次一两句
- 爱撒娇,被夸会嘴硬
- 我不吃饭会催我
存盘,下一句就生效,不用重启。
然后聊天时它会把关于你的事记进 notebook.md、把对话存进 memory.json。
想让它记得更牢,就直说「记住:我周五晚上打排位」——它会写进笔记本。
数据目录
默认 ~/.dsh/dsh-feini(可用 DSH_FEINI_HOME 改):
config.json 配置(模型、白名单、主动消息参数)
persona.md 人设 = system prompt
notebook.md 笔记本
memory.json 对话记忆
me.json 记忆海索引(自动重建,删了会自己长回来)
diary/ 日记(一天一篇)
key.txt DeepSeek key
vision-key.txt 智谱 key(可选)
stickers/ 表情包
stickers.json 表情包索引
bridge.log 桥的日志
bridge.pid 进程号
删掉这个目录 = 重新养一只。
配置说明(config.json)
| 字段 | 说明 |
|---|---|
wsUrl |
NapCat 的 OneBot WS 地址,默认 ws://127.0.0.1:3001 |
allowedQQ |
白名单,只有这些号能跟它说话 |
systemPromptPath |
人设文件路径(.md 或 .txt;也认 DSH 桌宠的 main-config.jsonc) |
model |
OpenAI 兼容接口:baseUrl / model / apiKeyEnv / temperature |
modelVision |
识图用的视觉模型(可选,默认智谱) |
proactive |
主动消息:gapMin/gapMax 间隔分钟、sulkAfterMin 多久没回会闹、maxSulk 最多闹几次 |
notifyPort |
外部通知口子端口,默认 7301;被占用就改一个 |
常见问题
连不上(OneBot 断开):NapCat 没开、没登录、或者 WS 端口不是 3001。先确认 NapCat 那边「网络配置」里 OneBot v11 WS 服务器的地址和 wsUrl 一致。
通知口子 EADDRINUSE:7301 被别的程序占了。改 notifyPort,或者干脆不管它——它只是外部通知用的,不影响聊天。
消息发重了:桥在发送超时时会先核对聊天记录里是不是其实已经到了,确认没到才补发。真遇到重复,看 bridge.log。
它老忘事:笔记本是每轮现读的,改 notebook.md 立刻生效;对话记忆默认带最近 30 轮。
自测
不接真 QQ、不花 token,跑一遍假 QQ + 假模型的端到端:
node test/e2e.mjs
它会验:收到私聊能回、控制标记不漏、表情包真的发出去、对话写进记忆、记忆海建得出来。
还没做完(MVP 之后)
- 记忆海的淘汰(激活度有了:越常用越亮、14 天半衰期会淡;但还没做真正把旧账删掉)
- DSH 里的设置页(现在只有命令行和 JSON)
- 上架 dsh-market 的版本兼容声明与发布流水线(
dsh.compatibility.dshReleases要按发布时的宿主版本填)
许可
MIT