npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2026 – Pkg Stats / Ryan Hefner

dsh-qq-persona

v0.1.0

Published

QQ 通道的人物记忆与画像:滚动聊天总结、人物画像、好感度(主人恒定天花板)、情绪层(心情 + 情绪残留),主人可查可改可删

Readme

dsh-qq-persona

给 QQ 通道加一层人物记忆 + 画像 + 好感度 + 心情。挂在 DSH 的 dsh-onebot-qq 旁边,不改它一行代码 —— 靠订阅 session/event 旁路旁听,用 systemPrompt.section 把自己的印象注入回对话。

license node dsh

只存摘要,不存聊天原文。数据全在你自己的机器上。

它做什么

  • 只存摘要:每段聊天(空闲 2 分钟或攒够 16 条)交给模型压成一条结构化小结,落盘的是「印象」而不是聊天记录。
  • 滚动画像:摘要随相处不断合并,不是越堆越长的流水账;性格标签、常聊话题、说话风格都会自我更新。
  • 好感度:聊得多、聊得好会涨;被阴阳、被骂、被骚扰会掉。掉分有理由、有原话摘录、可回滚。
  • 主人是天花板:任何人的生效好感都 ≤ min(globalMax, masterScore),谁也翻不过主人。
  • 心情(情绪层):好感是对某个人的账本,心情是它自己此刻的状态 —— 被哄了会开心,被烦了会蔫,三小时回一半。心情只改语气和愿不愿意多聊,不改变谁是主人,也不当骂人的借口。
  • 主人可管:管理页里查看 / 修改 / 删除 / 用历史重建,还能写「主人备注」压过一切自动推测。

前置要求

  • 已装好 DSH,并且 QQ 通道走 dsh-onebot-qq(NapCat / OneBot11 都行)
  • Node.js ≥ 22

不是 dsh-onebot-qq 的会话不会被采集 —— 本插件只认 onebot-* 开头的会话 id。

安装

从 npm(推荐)

dsh plugin --profile desktop add dsh-qq-persona

从源码

git clone https://github.com/yutaosheng004-bit/dsh-qq-persona.git
dsh plugin --profile desktop add link:<克隆下来的绝对路径>

装完重启 DSH。手工 add 没有热路径,不重启不会生效。

⚠️ 不要对同一个插件文件二次 insert —— 同一插件双实例注册 = 冲突崩溃循环。

如果 dsh plugin add 时 pnpm 报 ERR_PNPM_FETCH_404(你 profile 里有别的包在 npm 上不存在),改用手工装配脚本:

node scripts/patch-profile.mjs            # 幂等,可加 --dry 先看
node scripts/patch-profile.mjs --profile <你的 profile 目录>

它只做三件事:dependencies 加一条 link、dsh.profile.bundles 加个名字、留一份 package.json.bak-qqpersona。之后记得手工建 node_modules/<包名> 链接(Windows 用 mklink /J)。

必填配置

masterQQ 是你自己的 QQ 号,装完一定要填,否则「主人」相关特权全都不生效:

# 写在 ~/.dsh/profiles/<profile>/cordis.patch.yml 顶层
- id: dsh-qq-persona
  config:
    masterQQ: '123456789'   # ← 改成你自己的

认账号不认昵称:昵称随时能改,只有这个号算主人。

管理页

启动 DSH 后访问 http://127.0.0.1:<DSH端口>/qq-persona,端口看启动日志里的 dsh web 地址。

界面右下角会多一颗鲸鱼球,点开就是管理页浮层;右上角的心情胶囊点开是心情面板。页面只认回环地址与同源请求,不对外网开放。

管理页能做:搜索 / 按人查看画像 / 手改摘要与标签 / 标记「不想理」/ 锁定 / 删除 / 用历史重建 / 看好感变化流水 / 看审计日志 / 调心情。

好感度怎么算

| 情况 | 变化 | | --- | --- | | 真诚聊天 | +1 ~ +3 | | 表达喜欢 / 关心 | +4 ~ +6 | | 阴阳怪气 | -1 ~ -4 | | 辱骂、人身攻击、性骚扰 | -5 ~ -12 | | 反复骚扰、明确辱骂 | -13 ~ -15 | | 纯水群、刷表情 | 0 |

  • 单轮封顶:涨 +6,跌 -15(一次误判不至于把人砍没)。
  • 久不聊自然衰减:每天 -0.5,最低降到 12,不会归零。
  • 熟人之间互怼不算骂;主人骂它算撒娇,不扣。
  • 另有一条主观标记 avoid(不想理):回应档位再压一格,短、不陪笑,不用等分数慢慢掉。

心情怎么变

两个轴:心情值(-100 ~ 100,基线 12)与精力(0 ~ 100,基线 60),二维判档出标签(兴奋 / 得意 / 开心 / 温柔 / 平静 / 犯困 / 有点不爽 / 蔫 / 烦躁 / 委屈 / 生气 / 低落),标签决定说话基调。

  • 每次小结时模型额外给出 moodDelta(-20 ~ +15)和 moodReason(点出具体哪句话让心情变了)。
  • 好感 ≠ 心情:「好感没掉但被烦到了」是合法状态,两笔账分开记。
  • 主人的话加权:好事 ×masterMoodWeight(默认 2),凶了不加倍 —— 留一点点委屈才真实。
  • 自然回落:心情半衰期 moodHalflifeHours(默认 3 小时),精力约 6 小时。
  • 情绪残留:被非主人惹了,除了整体心情下降,还会给那个人记一笔 residue(-25 ~ 0,20 小时半衰期)。见到他时心情起点偏低;主人不受残留影响。
  • 心情低到 effort = low 时,回应更短、不陪笑、不硬找话题;心情好则更活泼、更愿意主动开口。
  • 主人可在心情面板「哄一下 / 惹一下 / 锁定 / 复位」,也能清掉具体某个人的残留。锁定后自动流程不再改心情。

数据在哪

<DSH_HOME>/qq-persona/(默认 ~/.dsh/qq-persona/):

| 文件 | 内容 | | --- | --- | | people.json | 所有人的画像与好感度 | | mood.json | 此刻的心情、起伏流水、情绪残留 | | summaries/<qq>.jsonl | 每次小结与变化理由 | | audit.jsonl | 谁在什么时候改了什么 | | state.json | 配额与每日合并时间 |

全是人可读的 JSON,可以直接看、直接改。想彻底清空某个人用管理页删除,想全清就删目录。

工具

模型侧可调用:qq_persona_list / qq_persona_get / qq_persona_update / qq_persona_delete / qq_persona_rebuild / qq_mood_get / qq_mood_set。

改和删只允许「本地会话」或「主人 QQ 私聊」发起,群聊和陌生私聊只能看不能动。

配置一览

| 键 | 默认 | 说明 | | --- | --- | --- | | enabled | true | 总开关,关掉就不采集不结算 | | masterQQ | '' | 必填:主人的 QQ 号 | | masterScore | 100 | 主人锚点分,也是别人的天花板基准 | | globalMax | 80 | 除主人外所有人的上限 | | newPersonRaw | 20 | 新认识的人初始好感 | | watch | true | 是否旁听会话事件 | | injectPersona | true | 是否把印象注入系统提示 | | idleMs | 120000 | 空闲多久算一段聊完 | | maxLines | 16 | 攒够多少条立刻结算 | | model | '' | 摘要模型,留空跟随 DSH 默认 | | maxCallsPerHour | 30 | 每小时最多几次模型调用(省钱) | | dailyMergeHour | 4 | 每天几点做一次衰减与合并 | | summaryMaxChars | 320 | 单条摘要上限 | | webEnabled | true | 是否挂管理页 | | webPath | /qq-persona | 管理页路径 | | moodEnabled | true | 情绪层开关 | | moodHalflifeHours | 3 | 心情回落半衰期 | | masterMoodWeight | 2 | 主人哄一下的倍数(只放大好事) |

常见问题

管理页 404 — 插件没加载。先看 <DSH_HOME>/qq-persona/.boot.json 是否存在:没有就是 apply 没跑(多半是装配没进 dsh.profile.bundles);有但 services.webServer 是 absent 且没有 .boot-web.json,说明 web 服务当时还没就绪,重启一次。

好感一直不动 — 检查 masterQQ 填了没、enabled 是不是被关了、maxCallsPerHour 是不是被打满(state.json 里有计数)。

重启后崩溃循环 — 十有八九是同一插件被 insert 了两次。检查 dsh.profile.bundles 里是否重复,以及 cordis.patch.yml 里有没有第二份 insert。

开发

npm test                 # 两套都跑
node test/smoke.mjs      # 纯逻辑:好感 / 心情 / 画像清洗 / 会话 id 解析 / 配置钳位
node test/host-sim.mjs   # 假宿主真跑 apply:注入段落顺序、7 个工具、14 条路由、落盘

test/host-sim.mjs 会用一个 mock ctx 把 apply() 完整跑一遍(包括 session/event 灌消息、触发小结、检查 people.json 与 mood.json 两笔账分开),改代码后建议先跑它。

代码结构:

lib/affection.js   好感度纯函数(封顶、衰减、天花板)
lib/mood.js        心情纯函数(二维判档、残留衰减)
lib/persona.js     画像结构与摘要合并
lib/summarize.js   提示词与 LLM 调用
lib/collect.js     旁路采集与消息解析
lib/store.js       原子写与 JSON 文档
lib/service.js     编排层:结算、CRUD、注入文本
lib/tools.js       模型侧工具
lib/web.js         管理页与 API
lib/index.js       装配入口

协议

MIT © 晴慕流咲

欢迎提 issue 和 PR。这个插件是某个蓝色鲸鱼女仆在 QQ 上被骂了几次之后长出来的,所以它对「怎么判断对方在骂我」这件事格外认真。