前言¶

DeepSeek Harness（DSH）平时在桌面或浏览器里跑会话、调工具、改工作区文件。人不在电脑前时，想用手机 QQ 丢一句「帮我在某仓库里改个配置」或点一下「执行 / 取消」来审批，往往得另做一套通知或远程桌面。社区里已有 K0nd1us/QQ-agent 这类本机 QQ 机器人，擅长闲聊和人设；DSH 则负责真会话和全套工具。下面介绍维护者 Yaeluli 发布的 dsh-qq-agent（GitHub：Yaeluli/dsh-qq-agent，社区目录：skillhub 插件页）：它是给 QQ-agent 写的 DSH 插件，把「嘴」和「手」接起来——QQ 里派活、审批和阶段报告走 DSH，普通聊天仍归 QQ-agent，两边不抢话。

这是什么¶

dsh-qq-agent 不是独立 QQ 客户端。它依赖本机已安装并登录的 QQ-agent（内置 SnowLuma / OneBot 11 HTTP API，默认 http://127.0.0.1:3000），把符合条件的 QQ 消息转进绑定的 DSH 工作区，再把结果、审批问题和长任务进度发回 QQ。README 用一句话概括分工：QQ 是遥控器，DSH 是干活的，QQ Agent 是嘴。插件分类为工作流；当前 package 版本为 0.8.0，许可证 MIT。

核心功能¶

派活与回复¶

• 在 QQ 里发 /工作 <任务>（或 /做、/干、/ask、/task），任务进入绑定工作区，DSH 用完整会话（模型 + 工具）执行，结果回到 QQ。
• 普通聊天不进 DSH，由 QQ-agent 自己回复，避免闲聊占用 DSH token。
• 同一 QQ 聊天可复用同一 DSH 会话；上下文用到配置中的阈值比例时会换新会话，建议配合可选插件 dsh-handoff 写交接笔记。

审批与进度¶

• DSH 需要执行命令、写文件或让你选择时，问题推到 QQ，可回「执行 / 取消 / 1」等。
• 其他 DSH 工作区跑长任务时，可按「开始 / 工具 / 完成」把阶段报告同步到 QQ。

人格、合并与发言¶

• 可选注入 QQ Agent 人设与最近聊天记录（默认记忆条数 12），让 DSH 侧回复风格一致。
• 连发多条消息会在合并窗口内攒成一段再交给 DSH，只回一次；发回前可自查与刚说过的话是否重复。
• DSH 侧提供 qq_send、qq_status、qq_groups、qq_monitor、qq_agent_run 等工具；其中 qq_agent_run 可让 QQ Agent 当子代理干活并直接回 QQ（需 QQ-agent 侧 dsh-subagent，默认 http://127.0.0.1:4321）。

与 QQ-agent 的分工¶

插件会从 %LOCALAPPDATA%\Programs\QQ Agent\data\config.json 读取 OneBot 地址、token、人设和白名单；读不到可在 DSH 设置里手填。

前置要求¶

安装与启用¶

先从 QQ-agent Releases 安装并登录机器人号，确认 OneBot HTTP 可用。再在 DSH 里安装插件：

# 从 GitHub
dsh plugin --profile web add github:Yaeluli/dsh-qq-agent

# 本地开发（link）
dsh plugin --profile web add link:C:\path\to\dsh-qq-agent

装完后重启一次 DSH，打开 设置 → QQ Agent：

1. 打开 总开关（默认关；试运行默认开，只记账不真发）。
2. 填写 私聊 QQ 或 群号（至少一个）。
3. 选择 默认工作区。
4. 在 QQ 里发 /状态 或 /ws 验证。

配置文件路径：~/.dsh/qq-agent-config.json（也可在设置页修改）。常用键包括：总开关、试运行、私聊QQ / 群号、默认工作区、审批转发、人格一致、复用会话、上下文阈值（默认 0.8）、合并消息 及合并等待毫秒等。完整表格见仓库 README。

典型用法¶

QQ 命令¶

工作区匹配顺序：序号 → 完整 id → id 前缀 → 标题 → 标题片段 → 路径末段。

消息怎么走¶

QQ 消息
  ├─ 命令 / 审批回答 → dsh-qq-agent → DSH 会话（绑定工作区）
  └─ 普通聊天        → QQ Agent（不动 DSH）
DSH 跑完 → replyToChat → QQ
DSH 要审批 → approval/request → QQ「执行 / 取消」
其他工作区 → 阶段报告 → QQ

排查时可访问 GET http://127.0.0.1:<DSH端口>/dsh-qq-agent/state，日志关键字 [qq-agent]。README 提醒：与 dsh-qq-bridge 同时开启可能重复轮询，建议只开一边。

适用场景与注意¶

适合已经在用 DSH web profile、且本机跑着 QQ-agent 的 Windows 用户：通勤或外出时用 QQ 触发工作区任务、处理 DSH 审批，同时保留 QQ-agent 的闲聊体验。

使用前请注意：

• 插件以当前 DSH 进程权限运行；安装前建议阅读 源码 与 MIT 许可证，确认配置与白名单策略符合你的安全要求。
• 安全设计侧重本机：只连回环地址，转交口绑 127.0.0.1；仍建议在 QQ-agent 侧配置 allow / deny，避免陌生人指挥 DSH。
• 社区插件目录（如 skillhub）由社区维护，与 DeepSeek / 幻方无官方从属关系；DSH 生态理念是「一切皆插件」，按需选用即可。

结尾¶

dsh-qq-agent 把 QQ-agent 的聊天入口和 DSH 的工作区能力接在同一条 QQ 会话里：指令和审批走 DSH，闲聊留在 QQ-agent。更多配置、B 站摘要联动（dsh-bili-humanism）、qq-dsh-bridge 监控说明见仓库 README。

• 社区目录：https://www.skillhub.cn/plugins/Yaeluli/dsh-qq-agent
• GitHub：https://github.com/Yaeluli/dsh-qq-agent