前言¶
在 DSH（DeepSeek Harness）裏做智能體，常見做法是接 HTTP、腳本或 IDE 通道；若你希望在自己電腦上、針對指定微信小號的白名單單聊，按可配置的人格以擬人節奏被動回覆，又不想綁死某一家模型或把完整聊天記錄外發，就需要一個在 host 內運行的專用插件，並在本地規則層先攔截再決定是否調用 LLM。
dsh-wechat-persona（維護者 xinghui2628，GitHub 倉庫 xinghui2628/dsh-wechat-persona，社區目錄 SkillHub 條目）即爲此設計：個人獨立開發、MIT 開源、實驗性質；與騰訊 / 微信官方無關。當前文檔標註版本爲 3.0.0-beta.1（開發者預覽，2026-11-01），上一已發佈版本爲 0.2.8；分類上屬於模型推理類插件。
下面介紹它是什麼、能做什麼、如何在不碰真實微信的前提下用 mock 驗證，以及安裝與風險邊界。
這是什麼¶
一句話：運行在你自己電腦上的 DSH 插件，配置、記憶、審計日誌默認只落在本機 dataDir（默認 <工作區>/.dsh-wechat-persona/）。
它只處理白名單裏的單聊：非白名單、免打擾時段、超頻、敏感話題等在本地規則層攔截，不花 token、不發消息。回覆由你在 DSH 裏配置的 LLM 服務生成；插件不綁定模型廠商，README 寫明不含遙測。
它不是微信官方功能，也不是協議逆向或羣控；desktop 通道是在 Windows 客戶端上模擬桌面操作。README 明確：3.0.0-beta.1 真實微信環境的讀取 / OCR / 發送尚未實機驗收，不能當作穩定產品使用。
核心功能（與 beta 狀態一致）¶
資料中的功能矩陣摘要如下，完整列表見倉庫 docs/BETA-LIMITATIONS.md。
| 能力 | beta 狀態 |
|---|---|
| mock 通道（入站模擬、草稿、審計） | 可用，不接觸真實微信 |
| DSH LLM 生成回覆 | 可用，需自行配置模型與承擔費用 |
| 人格庫（4 個內置 + 自定義 / 導入） | 可用，內置含「AI 身份透明」規則 |
| 白名單、在線時段、頻控、預算、熔斷 | 可用，本地規則優先 |
sendMode（auto / draft / confirm） |
可用，beta 默認受安全模式限制 |
發送可靠性（10 態狀態機 + sendOperationId 冪等賬本） |
已實現，真實故障路徑未實機演練 |
| OCR 流水線（WinRT 主引擎等） | 離線驗證，真實微信窗口未實機驗收 |
| desktop 桌面通道自動發送 | beta 默認禁用（betaSafeMode 默認 true） |
| 表情包、人格相關能力 | 部分可用，通道差異見限制文檔 |
| 插件市場 / 長期記憶 / 視覺模型 | 文檔標註爲未來規劃，非 beta 功能 |
安全模式：betaSafeMode / safeMode 下拒絕真實通道發送；只讀測試模式在引擎、桌面通道、HTTP API、PowerShell 腳本四層拒發，mock 不受影響（見 docs/READ-ONLY-MODES.md）。
環境要求¶
| 項目 | 要求 |
|---|---|
| 操作系統 | Windows 10/11（desktop 通道）；mock 可在任意平臺驗證 |
| Node.js | 22 及以上（構建與測試） |
| DSH 桌面版 | 0.2.1-rc.3 及以上 |
| 微信 PC | 僅 desktop 通道需要，4.x |
| 中文 OCR | Windows 簡體中文 OCR 語言包，分辨率 ≥ 1366×768（desktop） |
| PowerShell | Windows PowerShell 5.1 |
安裝與啓用¶
安裝、更新、卸載與首次配置以倉庫文檔爲準，勿憑插件名自行拼接市場命令：
README 說明：將插件以開發方式鏈接進 DSH profile 的步驟見 BETA-QUICKSTART；配置項、10 個設置標籤頁、6 個運維工具（如 wechat_persona_status、pause、resume、send_test、clear_memory、clear_audit）見使用說明。從 0.2.8 升級見 docs/MIGRATION-v3.md。
本地構建與離線驗收（README「五分鐘 mock 快速開始」）在倉庫根目錄執行：
npm ci --ignore-scripts --no-audit --no-fund
npm run build
npm run verify:api
verify:api 爲離線 harness，覆蓋鑑權、配置、mock、草稿、暫停恢復等路徑。
典型用法：mock 通道（不碰真實微信）¶
經過上面的鏈接與構建後，在 DSH 設置頁 → 微信分身 中：通道選 mock，白名單添加虛構聯繫人（如 張三）。
注入一條測試消息（將 <DSH端口> 換成你本機 DSH 監聽端口）：
curl -X POST http://127.0.0.1:<DSH端口>/dsh-wechat-persona/api/test/inbound \
-H "x-dsh-wechat-persona: 1" -H "Content-Type: application/json" \
-d "{\"text\":\"在嗎\",\"contactId\":\"張三\"}"
查看結果可調用 GET /status，並閱讀 <dataDir>/outbox.jsonl（mock 發送記錄）與 <dataDir>/audit.jsonl（審計）。
草稿模式：設置 sendMode=draft，重複注入 → GET /drafts 查看草稿 → POST /drafts/approve 人工批准後再發送。無真實 LLM 也可完成 mock 流程（默認可走本地規則 / persona）；需要模型時使用 DSH 已配置的模型。
數據、費用與隱私¶
- 本機：
state.json、memory/、audit.jsonl、drafts.json、send-ledger.json等，清單見 docs/PRIVACY.md。 - 離開本機：僅生成回覆所需的消息內容、最近上下文、聯繫人偏好會發到你配置的 LLM（及可選搜索服務）；不發送完整聊天曆史與截圖。
- 費用：插件本身免費；LLM 按你的服務商計費。
適用場景與注意¶
適合誰
- 已在用 DSH，想在本機實驗「白名單單聊 + 人格 + 本地風控」鏈路的人。
- 希望先用 mock 驗證配置、草稿、審計，再評估是否接觸 desktop 通道的人。
務必知曉
- 使用前閱讀 DISCLAIMER.md：自動化操作微信客戶端可能違反《微信軟件許可及服務協議》，賬號風險自擔；僅建議自用小號，禁止冒充、羣發、營銷、詐騙等用途。
- 3.0.0-beta.1 爲開發者預覽：未打 tag、未 npm 發佈、未正式 Release；真實微信 OCR / 發送視爲預覽、未驗證。
- 插件以當前 DSH 進程權限運行；安裝前請自行審閱源碼與 MIT 許可證，勿在 Issue / 日誌中粘貼真實好友名、wxid、API Key 等。
- DeepSeek Harness 生態強調「一切皆插件」；SkillHub 等社區目錄爲獨立站點，與 DeepSeek / 幻方無官方從屬關係，本文介紹的是社區插件而非官方應用。
結尾¶
dsh-wechat-persona 把「本地零 token 決策、白名單、頻控與熔斷、人格與可選 LLM 回覆」收進 DSH 插件；beta 階段應優先 mock 與文檔中的離線驗收，再謹慎看待 desktop 自動發送。
- 目錄頁：https://www.skillhub.cn/plugins/xinghui2628/dsh-wechat-persona
- 源碼與文檔：https://github.com/xinghui2628/dsh-wechat-persona
