前言¶

在 DeepSeek Harness（DSH）裏做智能體，對話、軌跡和模型調用往往都在桌面端完成；一旦要把 AI 放進微信羣，常見做法是單獨起腳本、自己管登錄和網絡，關係和「誰說過什麼」也很難和 DSH 會話對齊。Attune（npm 包名 dsh-plugin-attune，曾用名 Weave / dsh-plugin-wechat-agent）是 maintainer lingmao233 發佈的 DSH 插件，分類爲「記憶」：它在 DSH 裏提供微信 AI Agent 工作臺，讓 Agent 在羣裏積累成員畫像、情感與關係，並支持語音、主動互動和跨平臺內容；Linux 側控制台跑在 Ubuntu / Xubuntu 24.04 虛擬機上，由插件通過 HTTP 代理、SSH 隧道或一鍵部署接回主機 DSH。

下面介紹插件定位、能力、安裝與最短使用路徑。事實以 GitHub 倉庫 README 爲準；社區目錄頁見 skillhub.cn 插件條目。DSH 生態是「一切皆插件」；skillhub 爲社區目錄，與 DeepSeek / 幻方無官方從屬關係。

這是什麼¶

Attune 是接入 DSH 桌面端（需帶 webServer 的 desktop profile）的微信 AI Agent 會話工作臺。host 半在 DSH 的 HTTP 服務上掛載同源 /wechat/api/* 代理、/wechat/health 與 /wechat/setup/* 一鍵部署接口；client 半提供藍白控制台（會話頂欄「Attune」標籤與設置裏「Attune」分節共用同一頁面）。成員畫像與羣像集中在頁面內「回聲」子頁查看。

開源協議爲 MIT。文檔明確要求只使用專用測試微信號，不要用主號。

核心功能¶

連接與運行模式¶

插件按優先級選擇連接方式：部署頁保存的虛擬機連接 > 插件設置裏的 remote_ssh > remote_url > 本地。

1. 一鍵部署模式（README 推薦給非技術用戶）：在「部署」子頁走「一鍵連接」→ 虛擬機終端粘貼命令拿到 WECHAT-VM-CODE → 填回 DSH 操作頁並輸入開機密碼；插件用內置 ssh2 上傳預置源碼包、裝依賴、建 Python 環境、寫初始 .env、啓動控制台並維持 SSH 隧道，無需用戶自行查 IP 或預先配 SSH 密鑰。
2. SSH 隧道模式：在插件設置填 remote_ssh（例如 wx@192.168.1.50），插件維持 ssh -N -L 轉發，虛擬機控制台只監聽 loopback。
3. 遠程直連模式：填 remote_url（例如 http://192.168.1.50:8765），前提是控制台已監聽該地址；插件不啓動本地子進程。
4. 本地模式：remote_ssh 與 remote_url 均留空時，按 desktop_host / desktop_port 啓動並管理 python -m wechat_agent desktop 子進程。

控制台六個子頁¶

頁面名爲 Attune，沿用 DSH 主題變量，子頁爲：概覽、回聲、平臺、設置、部署、日誌。

• 概覽：運行狀態、啓停、已回覆 / 讀取 / 隊列 / 異常計數、回覆能力與最近動態；監聽範圍與連接入口集中展示。
• 回聲：成員畫像與羣像（輸入框上方不再掛回聲摘要，避免佔聊天區）。
• 平臺：抖音 / 小紅書賬號狀態、三號互聯、瀏覽與評論等；動作臺賬、共享記憶等收在頁末摺疊區。
• 設置：讀寫虛擬機 .env（文檔稱共 216 項，常用項可見，高級摺疊）；含「聲音 DIY」與「試聽當前音色」（按供應商能力顯示）。
• 部署：一鍵連接、環境檢測、一鍵部署、微信登錄與配置的五步向導；內置 assets/wechat-agent-linux-src.tar.gz，一鍵部署無需再聯網拉取另一倉庫。
• 日誌：事件流、回覆賬本與發送審計。

完整 Linux Agent 源碼單獨維護於 wechat-agent-linux；插件 tarball 由該倉庫構建，僅使用時可不手動克隆源碼倉。

記憶與 Agent 能力（簡介層）¶

倉庫描述與關鍵詞強調：情感記憶、情緒（moods）、關係（relationships）、語音（voice），以及 wechat agent / 微信 AI 等檢索詞。具體模型字段與 216 項 .env 以控制台「設置」子頁與虛擬機 .env 爲準；首次部署默認 WECHAT_ALLOW_SEND=false（只讀、不自動回覆），需在設置裏確認羣、模型和發送開關後再打開。

環境要求¶

• DeepSeek Harness 桌面端（desktop profile，帶 webServer）；
• Node.js ^22.19.0 或 >=24；
• Ubuntu / Xubuntu 24.04 LTS 的 X11 虛擬機（文檔示例爲 VMware Workstation 17 等）；
• 專用測試微信號。

安裝與啓用¶

插件以當前 DSH 進程權限運行；安裝前應自行查看倉庫源碼與 MIT 許可證。README 說明本地路徑安裝會以 link: 鏈入 profile，需先安裝插件聲明的依賴（DSH 包由宿主提供）：

git clone https://github.com/lingmao233/dsh-plugin-attune-wechat-agent.git
cd dsh-plugin-attune-wechat-agent
npm ci --omit=peer
dsh plugin --profile desktop add "C:\path\to\dsh-plugin-attune-wechat-agent"

將 add 後的路徑換成克隆目錄的絕對路徑。也可在 DSH 插件頁按本地目錄安裝，或在官方「添加插件」處粘貼 GitHub 地址：

https://github.com/lingmao233/dsh-plugin-attune-wechat-agent

首次安裝會拉取依賴；裝完按 DSH 提示重啓。只輸入裸包名 dsh-plugin-attune 時需該包已發佈到 npm；文檔寫明目前以 GitHub 地址或本地目錄爲準。當前 package.json 版本爲 0.8.0。

從 Weave / 舊包名升級¶

若在 ~/.dsh/cordis.patch.yml 裏曾爲舊插件配置 remote_ssh，升級後需把 id / name 改爲 Attune，例如：

- id: attune
  name: "dsh-plugin-attune"
  config:
    remote_ssh: jdy@192.168.126.128

保存後 DSH 熱加載配置；頁面仍斷開時可 Ctrl+R 刷新。

典型用法（最短路徑）¶

README 給出的安裝後最短路徑如下：

1. 打開任意會話，點頂欄「對話 / 軌跡 / 微信 / 設計」中的 Attune，再切到 部署；
2. 點 一鍵連接，按彈窗在虛擬機終端運行命令，將打印的 WECHAT-VM-CODE:... 與開機密碼填回，點 一鍵連接；
3. 點 一鍵部署到虛擬機，等日誌結束；點 啓動微信 並 查看虛擬機截圖 掃碼登錄；
4. 回到 概覽 點 啓動；在 設置 裏確認羣、模型和發送開關。

另有兩個固定入口：會話頂欄 Attune 標籤，或左下角頭像 → 設置 → Attune（Ctrl + Alt + ,）。只改 lib/client.js 時 Ctrl+R 刷新；改 index.mjs / lib/*.mjs 的 host 半需重載插件或重啓 DSH。

虛擬機側一鍵連接用的 bash 命令（打印連接碼或安裝 openssh-server）見 README「部署」章節；連不上時文檔列出 IP、SSH 用戶密碼、服務狀態、從 Windows 試 ssh 用戶名@IP 等排查項。

適用場景與注意¶

適合誰：已在用 DSH desktop、希望在微信羣內跑帶關係與情感記憶的 Agent，並願意用 Ubuntu / Xubuntu 24.04 虛擬機承載微信客戶端與控制台的開發者或進階用戶；非技術用戶可優先走部署頁一鍵連接與一鍵部署。

注意：

• 務必使用測試號；插件與部署流程涉及 SSH、sudo 與虛擬機桌面，sudo 密碼僅在部署任務內通過 stdin 傳給 sudo -S，文檔稱不寫入虛擬機文件。
• 插件不替代你對源碼與安全邊界的判斷；遠程 SSH 模式下控制台仍只監聽 127.0.0.1，由隧道轉發。
• GitHub 倉庫當前星標爲 2（以目錄頁/倉庫頁爲準）。

結尾¶

Attune 把 DSH 會話界面與微信側 Agent 控制台接在一起：記憶與畫像在「回聲」查看，部署與隧道在「部署」和插件設置完成，Agent 行爲在「概覽」「設置」「日誌」裏控制。需要條目信息與鏈接時，可打開社區目錄 https://www.skillhub.cn/plugins/lingmao233/dsh-plugin-attune-wechat-agent 與源碼倉庫 https://github.com/lingmao233/dsh-plugin-attune-wechat-agent。