Skip to content

dsh-feini

Verified

dsh-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