前言¶
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 模式下的宿主機能力暴露風險。
