DeepSeek Harness (DSH) 採用“一切皆插件”的架構。官方的 @tencent-connect/dsh-qqbot 插件目前僅提供 CLI 功能，缺乏可視化的 Web 界面。在配置文件中手動修改參數（如 appId、appSecret 或訪問控制列表）容易出錯。
dsh-qqbot-panel 是一個伴生插件，它爲 DSH Web 界面增加了一個專門的“設置 -> QQ Bot”頁面。通過這個頁面，可以直接在瀏覽器中管理所有配置，甚至支持通過掃描二維碼自動綁定 QQ 機器人賬號。
核心功能¶
該插件通過 /api/dsh-qqbot-panel 路由與官方 QQ Bot 插件通信，直接讀寫其配置文件。主要能力包括：
-
Web GUI 設置管理
在 DSH Web 界面的“設置 -> QQ Bot”頁面下，管理appId和appSecret、私聊（c2c）與羣組訪問模式（開放/允許列表/禁用）、requireMention開關以及智能體的工作目錄 (cwd)。 -
掃碼綁定
點擊生成二維碼，使用 QQ 客戶端掃描即可完成appId和appSecret的自動填入。該流程基於 QQ Bot 的連接任務，無需瀏覽器掃碼頁或 Apple ID 登錄。 -
工作區選擇器
列出所有已存在會話的工作區及其會話數量，選擇目標工作區即可將 QQ Bot 的智能體會話定向至此目錄。
安裝與啓用¶
使用此插件前，必須先安裝官方的 QQ Bot 插件。
- 安裝官方 QQ Bot 插件（綁定到
qqbot配置文件）：
dsh plugin --profile qqbot add @tencent-connect/dsh-qqbot
- 安裝 Web 設置面板（綁定到
web配置文件）：
dsh plugin --profile web add github:zhengjy01/dsh-qqbot-panel
- 重啓
dsh web，在瀏覽器中打開設置頁面，導航至“設置 -> QQ Bot”即可看到配置面板。
典型用法¶
安裝完成後，開發者無需編輯 ~/.dsh/profiles/qqbot/cordis.patch.yml 文件。所有配置變更通過 Web 面板提交，官方插件會自動熱重載配置。
在命令行直接啓動 QQ Bot：
dsh --profile qqbot
適用場景與注意¶
- 依賴關係：該插件是官方 QQ Bot 插件的伴生組件，必須先安裝並運行官方插件才能生效。
- 安全機制：
appSecret在界面中始終以遮蔽形式顯示，且永遠不會被空值覆蓋，防止配置誤操作導致服務不可用。 - 路由限制：
/api/dsh-qqbot-panel路由僅限瀏覽器同源訪問（loopback-only），無跨域風險。 - 權限與存儲：通過掃碼綁定的配置值，以
0600權限存儲在 QQ Bot 配置文件中。 - UI 設計：插件採用極簡設計，僅使用內聯樣式，無外部 UI 依賴。
總結¶
對於需要在 Web 界面集中管理 QQ Bot 參數的開發者，dsh-qqbot-panel 提供了必要的可視化層。它解決了官方插件純 CLI 配置繁瑣的問題，同時保持了與底層配置文件的一致性。
- 插件目錄：dsh-qqbot-panel
- GitHub 倉庫：zhengjy01/dsh-qqbot-panel
