dsh-napcatqq-remote：通过 QQ 私聊远程操控 DeepSeek Harness

DeepSeek Harness (DSH) 本质上是一个插件化框架。开发者通常在本地通过 WebUI 或命令行与它交互。如果要远程安排任务，传统方式需要开放端口或使用 SSH。这个插件基于 NapCatQQ 和 OneBot 11 协议，在本地增加了一个 QQ 私聊入口。它将白名单联系人的私聊消息转化为 dsh 的指令，并将处理结果发回 QQ。这解决了在无浏览器环境或不想开 WebUI 时，通过手机或远程工具控制本地 DSH 的问题。

这是什么¶

dsh-napcatqq-remote 是一个远程操控插件，由 riki-forsure 维护。它利用 NapCatQQ 将 QQ 消息转换为 OneBot 11 事件，再注入到 DeepSeek Harness 中。核心价值在于让 dsh 的控制入口从 WebUI 扩展到了 QQ 私聊，支持文件传输、视觉理解以及任务中途调整。

核心功能¶

白名单私聊工作：只接收白名单联系人的私聊，忽略群聊和机器人自身消息。
文件与图片处理：支持接收和发送文件、图片、表情，视觉模型可直接读取图片内容。
任务追加与长期对话：同一联系人持续复用会话，中途发送新消息作为补充；上下文用尽前不切换。
指令系统：提供 /新任务、/历史、/切换 等指令，用于管理会话和恢复历史。
多人隔离：不同联系人有独立的会话、上下文、附件目录和顺序队列。
多版本兼容：适配多个 DSH 预览版本，支持可选依赖和运行时降级。
自定义语气：支持为特定联系人配置回复语气模板。
重启恢复：保存联系人会话映射，重启后可继续对话。

安装与启用¶

确保已安装 DeepSeek Harness 和 NapCatQQ。
克隆插件仓库：

    git clone https://github.com/riki-forsure/dsh-napcatqq-remote.git
    cd dsh-napcatqq-remote
    pnpm install --frozen-lockfile

在 dsh 中启动 WebUI（或相应服务）以加载插件。

典型用法¶

查看状态：发送 /状态 或 /status 查看连接、白名单和配置。
新建任务：发送 /新任务 或 /new 解除当前会话映射，下一条消息开启新对话。
查看历史：发送 /历史 或 /history 查看该联系人最近 10 段对话。
恢复历史：发送 /切换 2 或 /switch 2 恢复第 2 段历史对话；或使用完整会话 ID 精确恢复。
日常交互：直接发送文件或图片，dsh 会自动处理并回复。

适用场景与注意¶

适用场景：适合需要在远程服务器或家中电脑上控制本地 dsh，且希望使用手机 QQ 进行操作的场景。
注意：
- 插件以当前 dsh 进程的权限运行，安装前应检查源码与许可证。
- dsh 与 NapCatQQ 必须同时运行。
- 修改配置或语气文件后，必须重启 dsh 才能生效。
- 表情识别需要 NapCat 提供真实图片数据或本地缓存，否则只能看到编号。
- Token、QQ 号、聊天记录属于本地数据，不应提交。

这个插件通过 OneBot 11 协议将 QQ 私聊转化为 dsh 的控制流。它不仅提供了远程控制能力，还解决了多会话隔离和文件传输等实际问题。更多细节请查阅项目主页。