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
