前言¶
DeepSeek Harness (DSH) 提供了 Agent 运行时，但连接 IM 平台需要协议适配。dsh-qqbot-dafeiyu 是一个插件，将 QQ 消息作为 DSH agents 的前端协议驱动。
核心功能¶
该插件提供以下能力：
* Per-peer sessions：每个 QQ 私聊用户或群聊对应独立的 Agent，会话隔离。
* Markdown 输出：回复以 Markdown 格式发送，支持代码块与表格感知切分。
* 闲置回收：会话闲置超时后自动销毁 Agent，防止内存泄漏。
* 斜杠命令：支持 /bot-reset、/bot-model 等内置指令。
* 图片生成：支持图片生成能力。
* TTS 语音回复：支持语音回复。
* 附件处理：支持附件处理。
安装与启用¶
- 执行安装命令：
dsh plugin --profile qqbot add github:cheesewoo/dsh-qqbot-dafeiyu
- 启动 DSH：
dsh --profile qqbot
- 首次启动时，插件检测到凭据未配置会自动进入扫码引导。终端输出二维码，手机 QQ 扫码绑定后，凭据自动保存到 profile，后续启动无需再次扫码。
- 也可以通过环境变量提前配置 AppID 和 AppSecret：
export QQBOT_APPID="你的AppID" QQBOT_SECRET="你的AppSecret"
dsh --profile qqbot
典型用法¶
- 凭据绑定：首次启动时自动进入扫码引导。
- 配置项：通过
appId、appSecret、model等配置项控制行为。 - 斜杠命令：
/bot-reset：重置当前会话（清除上下文）。/bot-model：查看或切换模型。/bot-status：查看当前会话状态。/bot-help：查看所有指令。
适用场景与注意¶
- 默认策略：插件默认采用白名单模式，空名单时拒绝所有人。刚装好的机器人不会响应任何人，需先在配置中填入允许的
openid或group_openid。 - 安全风险：⚠️
open模式下会暴露宿主机能力（如 shell/文件读写），任何能私聊或 @ 到该机器人的人都能用。对外暴露前请务必谨慎。 - 权限范围：插件运行在当前 dsh 进程上下文中。
生态背景¶
DSH 理念是「一切皆插件」。该插件由社区开发者维护，并非官方应用商店产品。
总结¶
该插件将 QQ 平台接入 DeepSeek Harness，实现了基于会话隔离的机器人逻辑。开发者需注意默认的白名单安全策略，以及 open 模式下的宿主机能力暴露风险。
