ktziy/dsh-Yuuka-qqbot

README 摘要

优香 QQ 助手（Yuuka QQ Assistant） 把《蔚蓝档案》的 早濑优香 接入 QQ，做老师的理财会计助手。基于 DeepSeek Harness，fork 自 @tencent-connect/dsh-qqbot（MIT）。 功能 - 多机器人实例 ：一台服务器可跑多个 QQ 机器人账号，互不影响。 - Web 扫码登录 ：在 Harness 设置页点「扫码添加」，手机 QQ 扫码后自动保存凭据并启动。 - 优香的书桌工作区 ：所有 QQ 会话归入「优香的书桌」工作区，标题用用户昵称。 - SQLite 财政预算工具 ：记账 / 查明细 / 月度汇总 / 预算 / 搜索，统计全在数据库内完成（省 token）。 - 三档记忆系统 ：短期（每日/超 100k 简单压缩）→ 中期（每周、含日期+时段）→ 长期（每 4 周，分「稳定核心事实」与「按周归档」），对话时召回注入。 目录结构 安装 两个包都以 link: （本地路径）方式装进 Harness profile： 也可 dsh plugin --profile web add github:you/yuuka-qq-assistant （git 安装，需自行先 pnpm build 生成 lib/client.js ）。 配置 把 preset 放到可发现位置，并接线（profile 的 cordis.patch.yml ）： 重启 dsh web 后，Web 设置里出现「优香 QQ 机器人」页，扫码即可添加机器人。 构建（仅改 client 源码时需要） 说明 - 扫码登录依赖 @tencent-connect/qqbot-connector （npm 上标记 UNLICENSED，与官方 dsh-qqbot 用法一致，仅作依赖声明、不打包其源码，见 yuuka-qqbot/NOTICE ）。 - 重命名机器人不会迁移已有会话目录；如需迁移可自行实现目录搬迁。 - 记忆压缩在消息到达时惰性触发（到点或超阈值）。 License MIT（ yuuka-qqbot/LICENSE ）；fork 说明见 yuuka-qqbot/NOTICE 。

分类