DeepSeek Harness QQBot

中文 | English

这是一个树外 DeepSeek Harness 通道插件，通过 QQ 官方 Gateway 把 QQ 智能机器人连接到可持久化的 Harness agent。

功能

使用官方 @tencent-connect/qqbot-nodejs SDK
支持 QQ 私聊和群聊文本收发
接收 PNG、JPEG、WebP、GIF 图片并保存为 Harness 持久附件
当前模型不支持图片输入时自动降级为文本元数据，不让整轮失败
接收语音转写和非图片附件元数据，并向模型提供 QQ 临时下载地址
发送 agent 生成的文本、图片和工作目录内的本地文件
提供仅当前 QQ 回合可用的 qq_send_file 工具，并校验工作目录范围和文件大小
默认以 QQ Markdown 格式发送回复
每个私聊或群聊对应一个独立、可恢复的 Harness 会话
挂载 Harness agent preset，使 QQ 会话与网页会话使用相同的工具、提示词和技能组合
网页已打开同一会话时安全复用 live agent，不创建第二个 session writer
通过 QQ 主动推送仅限回合发起人操作的“允许一次”和“拒绝”批准按钮
批准超时自动拒绝、发送失败回退其他已组合批准通道，且后续工具调用不继承提权
输入状态提示、长回复拆分、同会话消息串行处理、消息排重、发送重试和超时保护
私聊/群聊可分别配置开放、白名单或禁用
内置 /bot-ping、/bot-image-test、/bot-file-test、/bot-help、/bot-status、/bot-cancel
Secret 通过 Harness 凭据服务解析，不进入插件配置
未配置 AppID 或 AppSecret 时保持休眠，单独安装插件不会阻断 DSH 启动

从 GitHub 安装到 web profile：

pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-qqbot

从本地检出安装：

pnpm dsh plugin --profile web add /absolute/path/to/DeepSeek-harness-qqbot

AppID 由启动环境提供，AppSecret 保存到 QQBOT_APP_SECRET 凭据引用。开发时也可以直接通过环境变量注入：

export QQBOT_APP_ID='your-app-id'
export QQBOT_APP_SECRET='your-app-secret'
pnpm dsh --profile web

组合包会读取 QQBOT_APP_ID，通过 ctx.credentials 解析 QQBOT_APP_SECRET，并默认让 agent 使用启动目录作为工作目录。可以用 DSH_QQBOT_CWD 覆盖工作目录。

安装组合包后不必立即配置凭据。AppID 为空，或引用的 AppSecret 不存在/为空时，通道会记录“未配置、保持休眠”的日志并允许 DSH 正常完成启动；补齐两项配置后重载或重启 DSH 即可连接。非空但错误的凭据仍会在 QQ 鉴权阶段报错。

长期使用时，建议把 QQBOT_APP_ID 放到 ~/.dsh/.env，并通过 Harness 凭据设置界面保存。不要把任何真实凭据提交到 Git。