@rewebaiyu/dsh-qq
通过 NapCat / OneBot 11 在本机 QQ 上收发消息、在群里自动接话，并带一个网页管理面板的 DSH 插件。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:ReWebaiyu/dsh-qq#8d98eb814efc1f5614df4a6301ec01e09ff477a1Qq 以 @rewebaiyu/dsh-qq 发布，当前版本为 0.1.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
让 DSH（DeepSeek Harness）里的 Agent 在 QQ 上发消息、在群里自动接话，并带一个网页管理面板。
通道是本机 NapCat（QQNT + OneBot 11 HTTP）：插件不加好友、不碰协议，只把 OneBot 的 HTTP 接口和事件推送接到 DSH 上。只依赖 Node 内置模块，没有第三方运行时依赖。
dsh plugin add github:ReWebaiyu/dsh-qq
也可以在 dsh-m 市场里搜「QQ」（收录后）直接装。装完重启 DSH，工具列表里出现 qq_* 六个工具，左侧栏出现 QQ 图标。
launcher.bat <你的QQ号>，首次扫码登录，之后可快速登录。config/onebot11_<QQ号>.json 里打开：
httpServers：127.0.0.1:3000，带 token（也可以不带）；httpClients：url: http://127.0.0.1:3012/event，reportSelfMessage: false。插件以 profile patch 的形式注入，默认值在 lib/config.js，仓库根目录的 cordis.patch.yml 是公开模板（token 留空、群号留空）。真实的 QQ 号 / 群号 / token 放进你自己的 profile cordis.patch.yml，按 id: qq 覆盖整行 config：
- id: qq
config:
accessToken: '你的 NapCat token'
launcherPath: 'C:\NapCat\launcher.bat'
loginAccount: '你的QQ号'
groups: ['你的群号']
| 字段 | 缺省 | 说明 |
|---|---|---|
baseUrl | http://127.0.0.1:3000 | OneBot HTTP 根地址 |
accessToken | 空 | 与 NapCat onebot11_<uin>.json 的 token 一致 |
launcherPath / loginAccount | C:\NapCat\launcher.bat / 空 | qq_backend start 与面板「启动后端」用 |
eventPort | 3012 | 事件监听端口（改完要同步改 NapCat httpClients 并重启 NapCat） |
eventToken | 空 | 必须空：NapCat 的 httpClients 不发 Authorization |
adminPort | 3014 | 面板端口 |
napcatWebuiUrl / napcatWebuiConfig | 127.0.0.1:6099 / C:\NapCat\config\webui.json | 面板读 WebUI token（登录状态 / 二维码） |
qrcodePath | C:\NapCat\cache\qrcode.png | 扫码登录时面板直接回这张图 |
groups / watchUsers | [] / [] | 白名单；都空 = 不限制（面板里改更直观，存进 data/admin.json） |
persona / aliases / chatChance / cooldownSec / … | 见 lib/config.js | 面板里都能改 |
| 部分 | 地址 | 作用 |
|---|---|---|
| 工具 | （Agent 直接调用） | 发消息、读历史、自动接话开关 |
| 事件入口 | http://127.0.0.1:3012/ | 收 NapCat 的 httpClients 推送 |
| 管理面板 | http://127.0.0.1:3014/ | 人设、白名单、用量、扫码登录 |
| 工具 | 作用 |
|---|---|
qq_status | 体检：后端连通性、端口监听、登录 QQ 号与昵称、在线状态、后端版本、延迟 |
qq_send_private | 按 QQ 号发私聊 |
qq_send_group | 按群号发群聊，可选 atUserIds @ 人 |
qq_history | 读好友/群最近消息、最近会话与未读数 |
qq_backend | 查端口；提权启动 NapCat |
qq_bot | 自动接话：status / on / off / test |
刷新一次页面后，左侧栏会出现 QQ 图标（sidebar.panellist + main 两个 Slot）：
/qq-panel/?embed=1，和网页版是同一份页面，只是去掉左侧竖栏、导航变顶部横排）。127.0.0.1:3014。不想多挂一个侧边框：设置 →「QQ 消息」→ 关掉「在侧边栏显示 QQ 面板」。开关状态存在 data/admin.json 的 panelEnabled，刷新后仍生效。
打开 http://127.0.0.1:3014/。
面板只监听 127.0.0.1，配置和用量落在 data/admin.json（改完立即覆盖到运行时，不用重启）。
群消息 ──NapCat httpClients──▶ POST http://127.0.0.1:3012/event
│
engine.handleEvent
│ ① 白名单 + 触发判定
@我 / 叫到名字 / 闲聊概率 + 问题句
│ ② 组 prompt（人设 + 最近 N 条上下文）
宿主 llm 服务（用 DSH 当前默认模型，无需额外 key）
│ ③ 清洗 + 拟人延迟 + send_group_msg + 记用量
▼
群里看到一句话
aliases 或账号昵称必回；其余按概率只捡问句。remove_bundle + install_bundle（ESM 缓存；单纯 reinstall 会报 already-installed）。只改面板 HTML 不用重启，刷新页面即可。globalThis（Symbol.for('dsh-qq.host')）上整进程只建一次，面板每个请求现取 cfg/store/engine，所以热重载不会拿到旧对象、也不会占住端口。改端口要重启 DSH 才彻底生效。httpClients 不发 Authorization，eventToken 必须留空（否则每个事件 401）。POST /api/auth/login {hash: sha256(token+'.napcat')} → 拿 Credential，再 Authorization: Bearer <Credential>。token 在 config/webui.json。MIT