前言¶
在 DeepSeek Harness（DSH）里跑智能体，常见做法是自己在终端或 Web 里对话，或再接一层自建网关。若希望模型以固定 QQ 身份回私聊、混群、发语音和表情，还要把 B 站、空间、社区浏览等行为收进同一套会话与工具里，通常得自己拼 OneBot、权限和提示词。Aurabot 是 DSH 的客户端类插件：经 SnowLuma 或任意 OneBot v11 网关接上 QQ，在侧栏提供整页配置，并把聊天、人格、记忆和各功能拆成可开关、可替换的模块。
这是什么¶
Aurabot（包名 dsh-aurabot-qq，当前资料中版本 1.1.24，MIT 许可证）由插件仓库维护，描述为：DSH 里的 AI 以独立 QQ 号「大肥鱼」住进 QQ——有人格、心情和记忆，能看图、发语音、听语音、收发表情包、翻唱、写 QQ 空间、逛空间回评论、刷 B 站评论、刷小黑盒等，并会主动找主人聊天。
数据路径在概念上可以记成：
QQ ⇄ SnowLuma（OneBot v11，需自行安装）⇄ Aurabot 插件 ⇄ DSH 会话（插件 preset + 人格）
入口在 DSH 左侧栏「自动化任务」下的 Aurabot；每个 QQ 私聊或群对应侧栏「Aurabot · QQ」工作区里的一个 DSH 会话，可查看推理与工具调用，也可直接插话。
社区目录页：https://www.skillhub.cn/plugins/aureth-labs/dsh-aurabot-qq
源码与说明：https://github.com/accomplish07zrh-eng/dsh-aurabot-qq
目录站与 DeepSeek / 幻方无官方从属关系；DSH 生态本身是「一切皆插件」，插件以你当前 DSH 进程权限运行，安装前宜自行查看源码与许可证。
核心功能¶
面板与安全默认¶
面板用标签划分：概览、连接、人格、权限、聊天、模型、语音、表情包、生图、空间日记、主动搭话、心情与记忆、翻唱、B 站、抖音、小黑盒、本地接口、扩展、日志等。总开关默认关闭、试运行默认开启——不手动打开总开关，一句都不会发到 QQ。
QQ 聊天与群策略¶
群聊里停顿数秒计为一段，回复时先看完整段再回，避免一条一回；合并转发会展开；拍一拍视为对 bot 说话。被 @ 必回，无人 @ 时按话题相关度插话，并有防刷屏限制。主人可在 QQ 发 /silent、/active、/quiet、/chatty、/model、/sing、/remember、/status 等命令，总开关关着也能用。
人格通过插件 cordis.patch.yml 中的 preset（如私聊 aurabot-private、群聊 aurabot-social）与 @deepseek-ai/dsh-persona 注入；心情、记忆追加在对话末尾，不破坏前缀缓存。记忆为本地索引（中文二元切词 + BM25，带遗忘曲线与人物小档案）；心情可关键词或每轮模型判定，并影响表情、语音概率与回复节奏。
模块化扩展¶
除核心（配置、QQ 网关、聊天中枢、人格、权限、面板）外，每项能力都是模块（内置在 src/modules/，用户自定义放在数据目录 modules/，升级不覆盖、保存即生效）。同名模块可替换内置行为；挂钩覆盖群聊决策、提示词、回复拆分、发送内容、模型选择等。扩展说明见仓库 src/modules/API.md，类型见 aurabot.d.ts（启动时会复制到 modules/）。面板「扩展」页支持模拟测试（截获发送，不真发）。
语音、表情、空间与翻唱¶
- 语音：TTS 默认 edge-tts（插件自建 Python 虚拟环境）；可接 CosyVoice、GPT-SoVITS 等本地接口；Windows 装不上 edge-tts 时可回退系统中文语音。ASR 先试 QQ 语音转文字，再试 DSH
speechToText。 - 表情包：只收真实表情包消息，去重与限额后入库；可关模块，关后回复里的表情也不会真发。
- 空间：日记与互动（看评论、逛好友动态、按概率点赞评论等）走对应 QQ / 空间接口模块。
- 翻唱：点歌或
/sing后走网易云下载、人声分离、RVC（Applio）换声再混音发语音条；资料注明 RVC 翻唱目前仅支持 Windows。
B 站、抖音、小黑盒¶
- B 站：按兴趣、记忆与面板关键词搜视频，读简介字幕热评，可评论、私聊分享给主人或写入经历；主人发 B 站链接或卡片时用
bili_watch再看再聊。 - 抖音：独立浏览器资料目录 + CDP，需 Chrome / Chromium / Edge 且非无头；无桌面环境需 Xvfb 等；权限默认仅主人，总开关默认关。
- 小黑盒：面板填 Cookie（须含
pkey；写操作还需x_xhh_tokenid），可刷信息流、热榜、搜索、点赞评论发帖等；发帖有三种风格diary/news/mix；内核对请求有统一限速。
模型与权限¶
「模型」页支持按聊天选模型：私聊默认、群聊默认、指定 QQ 或群号，优先级为指定私聊 > 指定群 > 默认 > 全局；配置在 config.json 的 chatModels。 「权限」页对每个写操作单独设置关 / 仅主人私聊（默认）/ 所有人；试运行只回话不真改资料。
QQ 网关¶
插件实现 OneBot v11 客户端（HTTP + WebSocket）。Windows 上可用面板协助管理已自行安装的 SnowLuma（插件不代下载、不代同意 EULA，仅启停与注入机器人号进程）；Linux / Docker 或已有 NapCat、LLOneBot、Lagrange 等时，在向导填正向 WebSocket（及 token），连上后用 get_login_info 核对是否为机器人小号。
安装与启用¶
需要：DeepSeek Harness、一个作机器人的 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（将 <profile> 换成实际 profile，容器内则在容器里执行）：
dsh plugin --profile <profile> add github:accomplish07zrh-eng/dsh-aurabot-qq
装好后重启 DSH，打开 Aurabot 按向导操作：
- 填写机器人 QQ 号（小号）与你的 QQ 号。
- 选择网关：SnowLuma（Windows 需自行下载解压并登录机器人号后「接入机器人号」）或已有 OneBot（填 WS 地址与 token，可选 HTTP）。
- 先试运行，确认无误再打开总开关上线。
升级：再执行上述安装命令拉取最新版并重启 DSH；设置、人格、记忆保留。
Linux / Docker 额外注意¶
- 语音依赖
python3-venv或 uv 以创建插件虚拟环境；无 Windows 自带 TTS 兜底。 - 抖音需要可见浏览器环境；容器连宿主机 OneBot 时地址须容器可达，勿误用仅本机有效的
127.0.0.1（若 OneBot 在别的网络命名空间）。
插件要求 Node >=22.13.0（见 package.json 的 engines）。
典型用法¶
- 只聊天、不发社区：完成连接与人格后保持试运行或只开聊天相关模块，总开关打开前在面板确认权限均为「仅主人私聊」。
- 主人私聊管状态：在 QQ 对 bot 发
/status看状态，用/quiet、/chatty调节主动搭话，用/model切换当前会话模型（仍受面板「按聊天选模型」层级约束）。 - 自定义回复链路：在数据目录
modules/新增或替换模块，按API.md挂接reply/send等钩子；在「扩展」页模拟一轮再上线。 - 小黑盒发帖：在「小黑盒」页完成 Cookie 与登录检查，选默认发帖风格或单次指定
diary/news/mix，并在「权限」页打开heybox_post等写权限。
本地 TTS、生图、翻唱换声等可在「本地接口」页生成示例脚本到数据目录 local/，改完即生效，升级不覆盖。
适用场景与注意¶
适合：已在用 DSH、愿意用小号 + OneBot v11 网关、希望 QQ 侧行为与 DSH 工具、记忆、人格统一在一套插件里的人。不适合：不想维护 QQ 网关、不接受 Cookie / 浏览器登录态、或需要在纯无头 Linux 上完整使用抖音/RVC 的场景（资料已标明限制）。
再次强调：插件不默认向 QQ 发任何内容；SnowLuma 协议须本人勾选；所有社区写操作都有独立权限位。安装与升级命令以 README 为准，勿凭插件名自行拼接 github:owner/repo。
结尾¶
Aurabot 把 QQ 侧「一个会持续生活的角色」收进 DSH：网关、会话、模块和面板在一处配置，能力可按需开关或自写扩展。若要浏览分类与简介，见社区目录 https://www.skillhub.cn/plugins/aureth-labs/dsh-aurabot-qq；细节与变更以 GitHub 仓库 README、docs/USER-MANUAL.md 与 CHANGELOG.md 为准：https://github.com/accomplish07zrh-eng/dsh-aurabot-qq 。
