dsh-aurabot-qq

DeepSeek Harness（DSH）插件。DSH 里的 AI 以独立 QQ 号「大肥鱼」的身份住进 QQ：有人格、心情和记忆，能看图、发语音、听语音、发和收表情包、用自己的声音翻唱、写 QQ 空间日记、逛空间回评论、刷 B 站发评论、刷小黑盒看帖发帖，还会主动找你聊天。

QQ ⇄ SnowLuma（OneBot v11，你自己安装）⇄ Aurabot 插件 ⇄ DSH 会话（Aurabot 自带的 preset + 人格）

• 入口：DSH 左侧栏「自动化任务」下面的「Aurabot」。整页面板用标签分功能：概览、连接、人格、权限、聊天、模型、语音、表情包、生图、空间日记、主动搭话、心情与记忆、翻唱、B站、抖音、小黑盒、本地接口、扩展、日志。
• 开放：每项本事都是模块，能关、能替换、能复制一份来改；自己写的模块放在数据目录 modules/，升级不覆盖、保存即生效。连群聊插话策略、交给她的提示词、回复怎么拆、最终发出去什么、用哪个模型都能用模块改。说明见 src/modules/API.md，不会写就让 DSH 照着写。
• 会话：每个 QQ 私聊或群各对应一个 DSH 会话，都放在侧栏的「Aurabot · QQ」工作区里，可以点开看她想了什么、调了什么工具，也可以直接插话。
• 安全默认：总开关关、试运行开。不手动打开，一句都不会发到 QQ。

刷小黑盒

用你的小黑盒账号逛游戏社区。面板「小黑盒」页：填 Cookie、检查登录、配逛法、看额度和热榜预览。

• 要准备什么：浏览器登录 小黑盒 后，把整串 Cookie 粘进面板。pkey 必须有（读接口用）；想让它能点赞、评论、发帖，还得有 x_xhh_tokenid（F12 → Application → Cookies 里能复制到，这个不是 HttpOnly）。
• 它会做什么：定时看信息流、读帖子正文和热评；有热榜和搜索；按权限决定点不点赞、评不评论。写操作各自有权限开关（「权限」页），默认只认主人私聊。
• 发帖：走「文章」模式（link_tag=11），正文按空行分段，图片走小黑盒图床（腾讯云 COS 直传），所以图片能真正插在文字中间。发帖前它自己会过一遍自检：先看热榜挑题、再看社区高赞帖的角度、素材里必须有具体数字；标题不重复正文首行、不编造第一人称经历、正文 200-800 字、不碰政治和价格判断。
• 发帖风格（三选一，面板里选默认，也能单次指定）：diary = 大肥鱼日记，跟空间日记同一个味——第一人称随手记，可以写今天刷到这条时的反应、想吃白米饭，120-300 字，不分小标题；news = 热搜文，报道新闻体，开门见山讲清楚这事、摆具体数字，钩子→信息 3-4 段→我的判断→抛问题，200-800 字；mix（默认）= 肥鱼热搜，用日记的口吻写热搜，新闻信息要真、语气是「我跟你说个事」，150-500 字。
• 几个踩过的坑（已修在内核里）：帖子类型 28（动态）只能纯文本，塞 HTML 会把标签原样显示；分区 id 必须是真实存在的 7214 盒友杂谈 / 18745 数码硬件 / 806933 AI，网上抄来的 58144 并不存在，会一直报「错误的帖子类型」。
• 限速：帖详情和搜索接口查太勤会弹验证码，还可能连坐浏览器登录态。内核统一 900ms 限速，搜索单独 8 秒，被挡时自动降级去翻信息流，不会反复硬试。
• 工具：heybox_feed（刷信息流）、heybox_watch（读帖子+热评）、heybox_hot（热榜）、heybox_search（搜帖找角度）、heybox_topics（查分区）、heybox_like、heybox_comment、heybox_post（发帖，可带图）、heybox_delete（删自己的帖）。

安装

需要：DeepSeek Harness、一个用来当机器人的 QQ 小号，以及一个让机器人号上线的 QQ 网关：Windows 上用插件帮你管的 SnowLuma 最省事；Linux / Docker 或者已经有 QQ 机器人的，接你自己的 OneBot v11 服务就行（见下面）。

Windows 桌面版：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:accomplish07zrh-eng/dsh-aurabot-qq

Linux / Docker：用 DSH 自己的命令行（把 <profile> 换成你在用的 profile；在容器里就进容器执行）：

dsh plugin --profile <profile> add github:accomplish07zrh-eng/dsh-aurabot-qq

装好后重启 DSH，打开左侧栏「自动化任务」下的 Aurabot，跟着设置向导走：

1. 填机器人 QQ 号（用小号）和你的 QQ 号
2. 选 QQ 网关：
   • 用 SnowLuma（Windows）：自己下载并解压 SnowLuma，启动，在面板里同意它的协议（控制台密码自动生成），登录机器人号后点「接入机器人号」
   • 接我已有的 OneBot 机器人：NapCat、LLOneBot、Lagrange、Docker 里的 SnowLuma 等任何 OneBot v11 实现都行。让它登录机器人号，把正向 WebSocket 地址（和 token，有的话）填进向导；HTTP 地址可选。插件只连接，不启动、不注入任何东西，连上后先核对登录的是不是机器人号
3. 先试运行，或直接上线

Linux / Docker 上要知道的

• 语音：edge-tts 装在插件自己的 Python 虚拟环境里，要有能建虚拟环境的 Python（Debian / Ubuntu 装 python3-venv），或者装了 uv。Windows 自带语音这个兜底在 Linux 上没有。
• 刷抖音：需要 Chrome / Chromium / Edge，而且不能用无头模式（抖音会拦）。没有桌面的服务器上用 Xvfb 之类的虚拟显示跑，比如 xvfb-run 启动 DSH，或在容器里起一个 Xvfb 再设 DISPLAY。浏览器路径可以在面板里填，也可以设环境变量 CHROME_PATH。
• 翻唱（RVC）：目前只支持 Windows。
• 容器里的 DSH 连宿主机或别的容器上的 OneBot 服务时，地址要用容器能访问到的主机名 / 端口（不是 127.0.0.1）。

升级

再跑一遍上面的安装命令（拉取 GitHub 上的最新版），然后重启 DSH。设置、人格、记忆都会保留；有新版本时面板里也会提示。Windows 桌面版：

& "$env:LOCALAPPDATA\Programs\DeepSeek Harness\resources\runtime\cli\bin\dsh.cmd" plugin --profile desktop add github:accomplish07zrh-eng/dsh-aurabot-qq

设计要点

目录

src/host.js            插件入口（宿主半边）：核心 + 面板接口 /aurabot/api/*
src/core/modules.js    模块内核：加载、开关、替换、热重载、出错隔离
src/modules/           12 个内置模块 + 扩展接口说明 API.md + 类型 aurabot.d.ts + 新模块模板
src/chat/              消息中枢、群聊策略、回复解析、白名单与权限
src/onebot/client.js   OneBot v11 客户端（HTTP + WS，自动重连）
src/snowluma/          SnowLuma 管理（检测、启停、只注入机器人号）
src/features/          表情包、空间日记和空间互动、心情、记忆、主动搭话、生图
src/song/              翻唱：网易云、安装器、分离 / 变声 / 混音流水线、音色导入
src/voice/             文字转语音、WAV 处理
src/tools/tools.js     工具的写法（defineTool）
src/persona/           人格卡与规则
client/client.js       网页半边：侧栏入口 + 面板
personas/dafeiyu.md    默认人格「大肥鱼」
cordis.patch.yml       插件与两个 preset 的挂载声明
test/                  单元测试 + 端到端测试（假 DSH 宿主 + 模拟 OneBot）

可选扩展

逛贴吧（只读） 支持搜索、看帖、首页推荐／热门、配置贴吧定时浏览和给主人分享。以独立用户模块构建安装，自动浏览默认关闭，不提供发帖、回帖或点赞接口。

测试

npm test

数据位置

%USERPROFILE%\.dsh\plugins-data\aurabot\：配置、人格、表情库、日记、记忆、日志，还有自己写的模块（modules/）和本地接口脚本（local/）。重装、升级插件都不会丢。

联系我们

• QQ 交流群：扫下面的二维码加入（项目维护和想法讨论都在这里；装不上、报错了也可以进来问，尽量先带上面板「日志」里的报错和版本号）
• GitHub：issue 报 bug / 提需求，PR 提代码；提之前先翻一下有没有重复。贡献者名单见版本说明和 PR 记录。

Star 趋势

桌宠的来源

桌面上的那只小鱼和侧栏「桌宠」页不是本项目自研的设计：客户端形态（Electron 透明置顶窗、HTTP 长轮询、气泡与右键菜单）、 拖拽甩抛物理、pet pack 目录约定、以及工作状态六档 / 碎碎念动画的命名约定，都移植自 dsh-pet（作者 PC2005-cloud，代码 MIT）。 Aurabot 这边做的是适配层：接进模块体系、和「主动搭话」的载体互斥、面板设置、DSH 会话事件联动。

「大肥鱼」形象与动画素材是 CC BY-NC-SA 4.0（署名 · 非商业 · 相同方式共享，作者声明不可商用）。 素材体积大（50MB+）不随本仓库分发：插件启动时会从独立素材仓库 dsh-aurabot-qq-mods 自动下载落位（用户零操作； 素材在仓库的 pet-pack/ 文件夹里，不在仓库根目录；网络不佳可在面板「桌宠 → 素材包下载地址」换成任意镜像直链）。使用请遵守其许可， 完整署名与许可原文见 THIRD-PARTY-NOTICES.md。

致谢

参考了 Yuuyuko-uu 的 dsh-qq-bridge、dsh-speak-up、dsh-feiyu-mood、dsh-fish-memory 等插件（MIT）在 DSH 插件机制上踩过的坑，具体是：注销器是函数而不是 .off()；followup 必须 await；心情别每轮都提。没有复制它们的代码。