@local/dsh-qq-bot
DeepSeek Harness 的 QQ 聊天桥接：OneBot v11、人格面板、长期记忆、图片搜索、工具和实时设置页面。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:1ceDrag0n/dsh-qq-bot#1a9e51ff7addd9b89437a7d315d14c7cd302ff71Qq Bot 以 @local/dsh-qq-bot 发布，当前版本为 1.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
给 DeepSeek Harness 接上 QQ：一个有长期记忆、有人设、能联网、能看图、能自己管理表情包的 DSH agent。
把 DeepSeek Harness 的智能体接入 QQ 的插件。
通过 OneBot v11 连接 NapCat / Lagrange / LLOneBot，把 QQ 私聊和群聊消息交给一个真正的 DSH agent 处理，再把回复发回 QQ。插件同时负责长期记忆、人设、表情包、日记、群管理和设置页面。
这是一个社区插件，不是 QQ 官方客户端。QQ 登录由 NapCat / Lagrange 等 OneBot 实现完成，本插件只负责 OneBot 消息收发。
1. 安装 NapCat / Lagrange / LLOneBot，登录 QQ
2. 开启 OneBot v11 正向 WebSocket（默认 ws://127.0.0.1:3001）
3. 在 DSH 中安装本仓库，打开 设置 → QQ 聊天
4. 填人设、选模型、点保存，然后给机器人发一条私聊
详细安装见下文，或直接看 Releases。
[[SPLIT]] 拆成多条独立 QQ 消息，带打字间隔qq_web_search 调用独立搜索会话qq_describe_image 看图qq_image_search 按关键词搜图并直接把图片发到 QQ；设置页「能力」里有搜索/发送测试区<dataDir>/diary#qq approve/reject/ignoredsh-qq-bot connects a DeepSeek Harness agent to QQ through OneBot v11 (NapCat / Lagrange / LLOneBot).
It is not a keyword bot. Every QQ message is handled by a real DSH agent with web search, web fetch, image understanding and read-only file tools. Private and group chats run separate agents with independent model choices, context, long-term memory and persona boards. The agent is restricted to read-only and web tools; shell, file writes, subagents and workflows are not exposed.
QQ 客户端
↕
NapCat / Lagrange / LLOneBot（OneBot v11）
↕ WebSocket（事件）+ HTTP（动作，可选兜底）
DSH Host 插件
├─ 去重 / 触发判断 / 串行队列
├─ DSH Agent（ctx.agents）
│ ├─ 系统提示：底层人设 + 自我认知
│ ├─ 工具白名单：web / 只读文件 / QQ 工具
│ └─ 回合结束 → 取最终文本 → 分段发送
├─ 记忆引擎：联系人/群 recent + LLM 摘要压缩 + 人设演化
└─ HTTP API：/qq-bot/status /overview /settings /memory /models /groups /images ...
↕ 同源 fetch
设置页（React，注册到 settings.section）
安全边界：
web_search、web_fetch、read、glob、grep、read_image 等只读/联网工具tools.restrict + tools.guard 双重限制；即使群里有提示词注入，也不能让机器人执行命令或改文件ws://127.0.0.1:3001不要和 AstrBot 等其它程序同时接同一个 OneBot 账号，否则会出现双回复。
把本仓库放到本机任意目录，然后在 DSH 中使用 plugin_manager 的 install_bundle，target 指向该目录。
安装后：
[qq-bot] 前缀ws://127.0.0.1:3001dsh plugin --profile web add /path/to/dsh-qq-bot
或在 profile 的 package.json 里加入本地依赖，并把 @local/dsh-qq-bot 追加到 dsh.profile.bundles，然后重启 DSH。
默认包名是 @local/dsh-qq-bot，适合本地 link。发布到 npm 时请改成自己的 scope：
dsh plugin --profile web add @your-scope/dsh-qq-bot
并同步修改 package.json、cordis.patch.yml 和 client.js 里的包名/id。
打开 设置 → QQ 聊天。设置页左侧分为：
模型 | 能力 | 人设 | 对话 | 群聊 | 记忆 | 安全 | 内容 | 连接
模型留空时跟随默认模型。每个通道有自己的 agent 会话，不会串上下文。
qq_web_search 调用独立搜索会话qq_describe_image 看图qq_image_search 搜图并直接发到当前 QQ图片搜索默认使用 Bing 图片搜索，不需要 API key；发送时把图片转成 base64 经 OneBot 发出，同时缓存到 <dataDir>/images，方便复查或再次发送。下载失败会自动换下一张候选，并拒绝访问内网 / 本机地址。
#qq evolve on / #qq evolve off{error} 插入摘要所有运行数据默认保存在本机：
~/.dsh-qq-bot/
├── settings.json # 配置（可能含 access token，注意不要泄露）
├── state.json # 联系人、群、消息、记忆、表情包元数据
├── diary/ # 日记
├── images/ # 图片搜索缓存
└── stickers/ # 表情包文件
state.json 会包含 QQ 号、昵称、聊天内容和长期记忆。不要把这些文件提交到公开仓库。
本仓库的 .gitignore 已排除：
settings.jsonstate.jsondiary/images/stickers/node_modules/发布前请自行检查 settings.json、state.json、截图、日志和个人路径。
index.js Host 插件：OneBot、agent、记忆、路由、工具
client.js Web 设置页（React，无 JSX）
cordis.patch.yml bundle 插入 + qq-bot agent preset
locale/ 设置页标题与描述
icon.svg 设置页图标
主要入口：
Config：schemastery 配置 schemanormalizeConfig / SETTINGS_SHAPE：配置归一化与保存校验handleInbound / wakeMatch：触发逻辑buildSystemPrompt / buildTurnPrompt：提示词ensureAgent / chatAgents：私聊/群聊双 agentsplitReply / sendReply：连续输出与发送searchImages / downloadImage / sendImageToJob：图片搜索、缓存与发图compressContact / compressGroup / evolvePersona：记忆与人设演化registerRoutes：设置页 HTTP API提交前运行：
node --check index.js
node --check client.js
| 现象 | 检查 |
|---|---|
| 设置页显示连接错误 | NapCat 是否启动、WS 地址/端口/token、WebSocket 服务是否开启 |
| 已连接但不回复 | 群聊是否 @ / 带唤醒词；trigger.groupAlways；access.groups/whitelist |
| 人设改了保存不了 | 修改后点顶部或底部「保存设置」；新建预设需要「创建」后再保存 |
| 机器人莫名私聊人 | 「对话 → 主动私聊白名单」是否为空；同时检查 proactive.enabled |
| 回复“没有可用模型” | 在 DSH 配置默认模型，或在私聊/群聊模型选择器里选一个模型 |
| 搜索报缺少 API key | 搜索模型选有搜索凭据的 provider，或在 DSH 配置 Exa/Perplexity |
| 搜图或发图失败 | 图片站点是否可访问、图片是否超过大小上限、OneBot 是否能发图；到设置页「能力 → 图片搜索」测试区复现 |
| 群列表读取失败 | OneBot 是否在线；设置页会回退到本地已知群 |
MIT License。见 LICENSE。
本项目按“现状”提供，不对 QQ 账号安全、封号风险、数据丢失或第三方服务可用性作担保。使用前请自行评估平台规则和账号风险。
欢迎 issue 和 PR，详见 CONTRIBUTING.md：
settings.json、state.json、真实 QQ 号、聊天记录、access tokenConfig、normalizeConfig、SETTINGS_SHAPE 和设置页如果你发现安全问题，请不要公开提交可利用细节；先通过 issue 描述影响范围，或私下联系维护者。 详见 SECURITY.md。
不包含账号和 token 的最小配置示例见 settings.example.json。