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 的控制流。它不僅提供了遠程控制能力，還解決了多會話隔離和文件傳輸等實際問題。更多細節請查閱項目主頁。