前言¶

在使用 DeepSeek Harness（DSH）时，如果已安装 dsh-onebot-qq，QQ 线上会自动拉取当前所有全局工具，包括主机层面的 ops_*、agent-team 以及 MCP 资源等。这会让对话变得更「全能」，但也可能暴露本不该在聊天会话中出现的工具，浪费 token 并带来安全隐患。

dsh-onebot-qq-opsgate 作为一个配套插件，用于在 QQ 会话中过滤掉这些不该出现的全局工具，只保留与 QQ 交互相关的工具（如 mcp__qq__* 等），其余全部挡掉。

插件定位¶

• 插件名：dsh-onebot-qq-opsgate
• 维护者：YUsaltyfish
• 分类：admin-security
• 核心价值：在 QQ 会话中屏蔽全局工具，只放行与 QQ 相关的工具，减少 token 消耗并降低暴露风险。

核心功能¶

• 按预设过滤工具：只影响 qq-chat preset 的 QQ 会话，不影响网页、工作线或其他 preset。
• 自动模式（默认）：启动时探测 DSH 当前所有全局工具，只放行 mcp__qq__*（如果 web_search / web_fetch 是全局的，也会放行），其余工具全部拦截。
• 动态补挡：启动后每 500ms 复查一次，持续几秒补挡晚注册的工具，之后停止检查。
• 无需维护名单：新安装的全局插件也会被自动挡掉，不需要手动维护放行列表。
• 可配置：支持通过配置调整放行前缀、精确放行列表等，但仍兼容旧配置（deny: [...] / allow: [...] 会退回固定名单模式）。

安装与启用¶

前提：已安装 dsh-onebot-qq。

通过 GitHub 安装：

dsh plugin --profile web add github:YUsaltyfish/dsh-onebot-qq-opsgate

通过本地目录安装（代码改完立刻生效）：

dsh plugin --profile web add link:/abs/path/dsh-onebot-qq-opsgate

安装后，重启 DSH，QQ 线新建会话即可生效。

注意顺序：本插件必须在 profile bundles 里排在 dsh-onebot-qq 之后（后层覆盖前层）。如果手工调整过顺序，记得检查。

典型用法¶

安装完成后，打开一个 QQ 新会话，让智能体尝试调用 ops_bash 或 spawn_teammate 等工具，它将无法识别这些工具，从而避免暴露主机层面的能力。

适用场景与注意¶

• 适合希望把 QQ 会话隔离在「纯对话」范围内的开发者，减少 token 消耗并降低安全风险。
• 插件以当前 DSH 进程权限运行，安装前建议检查源码与许可证。
• 卸载即恢复原状，不影响其他 preset。

小结¶

dsh-onebot-qq-opsgate 是 dsh-onebot-qq 的配套工具守卫，通过自动过滤 QQ 会话中的全局工具，让对话更聚焦、更安全。需要调整放行规则时，可在 profile 的 cordis.patch.yml 中覆盖 preset-qq-chat 并为插件添加配置。

• 目录页：https://www.skillhub.cn/plugins/YUsaltyfish/dsh-onebot-qq-opsgate
• GitHub：https://github.com/YUsaltyfish/dsh-onebot-qq-opsgate