前言¶

DeepSeek Harness（DSH）採用插件化架構。若需要在微信中與本地運行的 DSH 進程交互，或通過微信控制本地智能體，需要一個專門的連接層。dsh-wechat-bridge 插件提供了這一能力，它將微信 iLink 通道接入 DSH 生態。

插件簡介¶

這是一個獨立社區集成項目，將本地 DSH 進程連接到微信 iLink 機器人通道。它不包含桌面微信自動化腳本，也不依賴任何第三方運行時環境。項目採用 MIT 許可證。

該插件定位爲面向終端和自動化工作流的微信遠程橋接，而非通用多 IM 聚合器。它不提供圖形化設置面板，而是通過獨立 CLI 和 SSE 控制接口實現操作。

核心功能¶

插件提供以下核心能力：

• 消息接入：接入微信 iLink 文本消息及語音轉寫消息。
• 會話管理：支持繼續、創建、列出和切換 DSH 會話。
• 雙向同步：微信與 DSH 的用戶確認問題雙向同步。電腦端和微信端誰先回答，該端的問題狀態即生效。
• 摘要同步：DSH 生成的回覆摘要會主動同步回微信。
• 控制與監控：提供 SSE 事件流、消息 relay、待發隊列管理以及狀態/日誌查詢 API。
• 文件傳輸：支持受目錄白名單約束的流式加密文件上傳。
• 獨立 CLI：提供 dsh-wechat 命令行工具，避免佔用易衝突的 wx 名稱。

安裝與啓用¶

安裝前請確保本地環境已安裝 Node.js 20+，且 DeepSeek Harness 版本兼容 0.1.5-rc.1。由於 GitHub 存在同名項目，請務必覈對完整倉庫名 LZG3530606141/dsh-wechat-bridge。

通過 DSH 插件管理器安裝指定版本的插件：

dsh plugin --profile <你的-profile> add "github:LZG3530606141/dsh-wechat-bridge#v0.1.0"

安裝後需重啓對應的 DSH profile 以使 bundle 生效。

使用方式¶

安裝完成後，可以使用 dsh-wechat 命令進行操作。默認情況下，插件在 127.0.0.1:8848 啓動控制接口。

常用命令如下：

• 狀態與診斷：

    dsh-wechat status
    dsh-wechat doctor

• 登錄與重連：

    dsh-wechat qr
    dsh-wechat relogin

• 消息處理：

    dsh-wechat listen [--json] [--filter <regex>]
    dsh-wechat send <text...>
    dsh-wechat send-file <absolute-path>
    dsh-wechat outbox [flush|clear]
    dsh-wechat chat <text...>
    dsh-wechat repl

• 會話操作：

    dsh-wechat sessions
    dsh-wechat switch <n|sessionId>
    dsh-wechat new [--bind]

• 功能開關：

    dsh-wechat relay [session|cli|off]
    dsh-wechat log [--tail N] [-f]

CLI 支持環境變量配置：
* DSH_WECHAT_BRIDGE：控制面 URL，默認 http://127.0.0.1:8848。
* DSH_WECHAT_PORT：覆蓋默認端口。
* DSH_WECHAT_TOKEN：遠程控制令牌。

安全與注意事項¶

插件在安全設計上遵循“默認拒絕”原則：

• 默認監聽：HTTP/控制面默認綁定 host: 127.0.0.1。
• 遠程控制：默認拒絕無令牌的遠程控制（controlAllowRemote: false）。
• 依賴：零第三方運行時依賴。
• 數據隱私：本倉庫不包含桌面微信自動化邏輯，也不會打包任何令牌、二維碼鏈接、日誌、會話標識或運行狀態數據。

若需配置文件發送功能，建議收窄 fileSendRoots 目錄白名單，避免將整個磁盤暴露給文件發送接口。

務必不要提交 $DSH_HOME/wechat-bridge 目錄下的數據，該目錄包含敏感的授權憑證、上下文、待發隊列和日誌。

生態背景¶

DSH 的核心理念是“一切皆插件”。DeepSeek Harness 插件市場是一個獨立的社區目錄，與 DeepSeek 或幻方 AI 無官方從屬關係。本文檔僅基於社區覈實的事實編寫，旨在爲開發者提供工具選擇參考。