前言¶
DeepSeek Harness（DSH）的会话、任务和模型切换多在桌面端完成。离开电脑时，常见做法是另起 Python 桥接或第三方网关，维护成本高，状态也难和 DSH 进程对齐。DSH QQ 控制台（shenhua725/dsh-qq-console，README 中包名为 DSH QQ 控制台 2.2，版本 2.2.26）在 DSH 进程内运行：自带 QQ 网关、菜单注册、任务进度看门狗和设置卡片，不依赖 Python 桥接，把手机 QQ 当成遥控器使用。
这是什么¶
插件由社区维护者 shenhua725 发布，SkillHub 分类为客户端。一句话定位：在 QQ 里查看会话与任务进度，排队、打断、切换模型与权限，并向 DSH 投递指令。简介与目录页表述一致：Control DeepSeek Harness from QQ: sessions, tasks, progress, models and permissions.
本版本按 DSH 0.2.1-rc.2 的宿主依赖对齐（dsh-home-paths、schemastery、cordis），可与当前 Desktop profile 安装；不再依赖 dsh-credentials。许可证为 MIT。
核心功能¶
底部菜单与对话¶
底部菜单最多 7 个项目，外加「对话」「设置」「更多」。
- 对话：对话状态、排队执行、打断重发、退回编辑、删除取消。
- 设置：实时进度、当前进度、1 分钟汇报、5 分钟汇报、只要结果。
- 更多：当前对话、全部对话、项目、会话操作、面板。
某项目内超过 5 个会话时，第 5 项为「更多」，点开列出该项目全部会话。
对话状态固定 8 行：项目、对话、当前任务、排队任务、汇报方式、当前模型、推理强度、当前权限。电脑端直接发起的轮次也能在手机端看到。
任务、排队与汇报¶
流程为「任务确认 → 进度 → 结果」。默认 5 分钟汇报；可切换 1 分钟、实时流式、只要结果。
排队最多显示 5 条，每条带「引导 n」「取消 n」：引导表示打断当前轮并插入；取消只删第 n 条。
模型与权限¶
从 DSH 实时模型目录和 WorkBuddy 缓存目录添加可选模型，设置默认模型与推理强度。手机端「模型」以模型全称为可点按钮；强度按最高→最低排列，off 显示为「强度0（关闭）」；权限按只读→完全访问排列，档位直接读 DSH permissionPresets。WorkBuddy 缓存模型来自 ~/.dsh/.workbuddy-ai-catalog.json；未登录时仍可配置，但真正调用需先登录 WorkBuddy（README 对不可路由、失败记忆等有详细说明）。
凭据与闲时闸门¶
- AppID 明文保存在
~/.dsh/qq-console-v2/settings.json。 - AppSecret 经 Windows DPAPI 加密为
dpapi:v1:*后写入同一文件，设置页永不回显；重启 DSH 或插件重载后自动恢复并尝试连接。 - 闲时闸门：工作日 9:00–12:00、14:00–18:00 与 8:30–9:00、13:30–14:00 不直接外派，进闲时队列，到点自动放行；周末全天可跑（法定节假日需人工判断，当前仅自动识别周六/周日）。
附件¶
QQ 图片走 DSH 原生图片输入（session/prompt 的 image content）。MIME 按「文件魔数 > QQ 声明类型 > 扩展名」判定。DSH 接受 PNG/JPEG/WebP/GIF；BMP/HEIC/AVIF/TIFF 等会落盘到状态目录 inbox/ 并把绝对路径写进指令；其它文件同样落盘交路径。
安装与启用¶
插件不能从源码树就地安装（解析不到 DSH 的 peer）。官方 README 给出的部署方式如下。
1. 落到 profile 的 vendor 目录¶
在 PowerShell 中执行（路径以你本机 README 中的脚本位置为准）：
powershell -ExecutionPolicy Bypass -File "F:\Codex\办公自动化\QQ控制台\dsh-qq-console-v2\deploy.ps1"
默认目标目录：
C:\Users\<你>\.dsh\profiles\desktop\vendor\dsh-qq-console-v2
脚本只写该新目录，不会修改旧插件 dsh-qq-console-plugin。
2. 在 DSH 里安装¶
- 打开 DSH → 侧边栏「插件」。
- 选「从本地路径安装」，填入上述 vendor 目录的绝对路径。
- 安装后重启 DSH。
- 打开「插件 → DSH QQ 控制台 2.2」：填写 AppID / AppSecret，点「保存并连接」；从模型目录添加可选模型并设置推理强度（第一项为默认）；点「立即刷新菜单」，确认底部菜单为 7 项目 + 对话/设置/更多。
设置页保存后会立即重连网关并显示连接结果，一般不必再重启。从 2.1 升级到 2.2 时，旧版仅存在于进程内存的凭据无法迁移，需重填一次；从 2.2 起凭据持久保留，直至在设置页手动清除。
典型用法¶
经过上面的步骤连接成功后，日常可按菜单操作：
- 在「对话」里查看 8 行状态，按需打断重发、退回编辑或取消排队项。
- 在「设置」里切换汇报方式（例如从 5 分钟汇报改为实时流式）。
- 在「更多」里切换项目、会话或打开面板；通过模型/权限相关入口调整当前轮使用的模型与权限档位。
- 直接向机器人发送文字或图片；图片按 DSH 支持的格式进入会话，不支持的格式会落到
inbox/并以路径形式参与任务。
电脑端界面发起的轮次，DSH 能看见状态，也可用「打断重发」取消；「引导」仅对正在运行的轮次有效，空闲时会提示直接发文字。
适用场景与注意¶
适合谁：需要在移动端查看 DSH 任务进度、排队与模型权限，且已配置 QQ 机器人 AppID/AppSecret 的 Windows + DSH Desktop 用户。
运行与信任：插件在 DSH 进程内以当前 DSH 进程权限运行。安装前应在 GitHub 查看源码与 MIT 许可证，并理解凭据落盘方式（AppSecret 依赖 Windows DPAPI）。
重要限制（摘自 README）：
- 同一个 QQ 机器人 AppID 只能有一个消息消费者。安装前需停掉 Codex 版
qq_codex_bridge.py，或为本插件换用另一个 AppID。 - 旧插件
dsh-qq-console-plugin可与本插件并存，但不要同时启用并填写同一个 AppID。
卸载：DSH → 插件 → DSH QQ 控制台 2.2 → 卸载。用户数据默认保留在 ~/.dsh/qq-console-v2/，重装后继续使用；要彻底清空需手动删除该目录。
自检（需已部署的 vendor 副本与 DSH 自带的 node 路径）：
$node = "D:\Program Files (x86)\DeepSeek Harness\resources\runtime\primary-runtime\dependencies\node\bin\node.exe"
& $node ".\.selftest\v2.mjs"
结尾¶
DSH QQ 控制台把会话、任务进度、模型与权限收敛到 QQ 菜单里，减少外置桥接。社区目录 SkillHub 与 DeepSeek / 幻方无官方从属关系，可按需从目录页或仓库获取说明与源码。
- 目录页：https://www.skillhub.cn/plugins/shenhua725/dsh-qq-console
- GitHub：https://github.com/shenhua725/dsh-qq-console
