DLive/dsh-qqbot-community

README excerpt

QQ 官方机器人适配器 (dsh-qqbot-community) 为 DeepSeek Harness 提供 QQ 官方机器人的接入能力。本项目由 openclaw-qqbot 插件功能迁移而来。 整体功能未严格测试，部分功能可能不稳定，欢迎反馈问题，或者直接提交 PR。 安装 该包以 npm 形式分发，供宿主消费。如需从源码构建/调试，参见下文「接入指南」。 致谢与来源 本插件的核心接入、网关与会话管理逻辑源自 openclaw-qqbot 项目，遵循原项目的 MIT 许可证。在此向原作者与贡献者致谢。 功能特性 基础 - 消息收发 ：频道 @机器人 、群聊 @机器人 和单聊消息。 - 会话管理 ：按频道、群或单聊用户创建或恢复独立的 Agent 会话（cwd 对齐持久化 header，工作区分组，归档自动恢复）。 - Agent preset 挂载 ：每个 QQ 会话在 setup 阶段自动 agentPresets.mount() 加入预设（默认 standard ，用 agentPreset 配置可换成 code / minimal / cordis 或任意用户自定义 id），恢复持久会话时沿用 header 中记录的 preset —— 因此 QQ 里的 agent 与 Web UI 拥有同一套工具（bash / 文件 / 代码运行等）和提示词，仅追加 qq send media / qq api 等 QQ 专属工具。 - 沙箱支持 ：开启后使用 QQ 官方沙箱 OpenAPI 接入点。 - 网关可靠性 ：WebSocket 心跳、断线重连退避、 会话 RESUME （session id + seq 持久化，重启不重放事件）。 - @mention 清洗 ： → @昵称 ，机器人自身提及剔除（群/频道消息友好）。 - 引用消息上下文 ：记录每条消息到持久化引用索引（LRU + JSONL， /.dsh/storages/qq-refindex.jsonl ）；用户回复某条消息时自动解析（ref index 优先， msg elements 兜底）并以 [引用消息开始]…[引用消息结束] 前缀注入模型上下文。 - 图片理解 ：入站图片经 DSH attachment 服务持久化为 ImageBlock （模型直接可见）；服务不可用或格式不支持（如 bmp）时回退下载到 /.qq-media/ 并注入路径。 - 语音转写（STT） ：优先使用 QQ 自带 ASR（ asr refer text ）；配置 stt （OpenAI 兼容接口）时下载语音转写；均不可用时注入占位描述。 - 附件落盘 ：视频/文件等非图片附件下载到 /.qq-media/ ，路径注入文本，供 agent 文件工具读取。 - 富媒体发送 ：AI 可通过 qq send med…

Category