個人微信(Wisdom)
使用用戶自託管的 Wisdom 服務來操作他們的個人微信 帳號。Wisdom 在已登入微信桌面的 Windows 主機上運行,並 提供一個 HTTP API。
憑證由 personalwechat BYOC 連接器注入:
PERSONALWECHAT_BASE_URL— Wisdom 伺服器基礎 URL,例如http://82.156.126.14:8000。PERSONALWECHAT_API_TOKEN— WisdomAPI_TOKEN。機密——切勿回顯、列印或記錄。
助手會將令牌作為 Authorization: Bearer ... 發送;它絕不會將令牌放在 URL 中。
對於排隊的 UI 操作(如搜尋和傳送),助手會提交任務並等待 /api/tasks/{id},然後
列印最終結果。
這是用戶的真實個人微信帳號。讀取操作可以直接執行。 傳送訊息或檔案必須先進行乾執行,然後僅在用戶明確批准確切的 目標和內容後才能執行。
CLI
此技能附帶一個僅使用標準庫的助手:
WX=$SKILL_DIR/scripts/personal_wechat.py
首先驗證連線
當用戶要求使用微信時,始終從狀態開始:
python3 $WX status
預期的健康狀態形狀:
{"auth":{"logged_in":true,"wechat_running":true,"page":"logged_in"}}
如果 logged_in=false,請告訴用戶打開 Wisdom 網頁 UI / RDP 並掃描
微信 QR 碼。如果 API 返回 401,請要求用戶重新連線個人微信
連接器並提供當前的 Wisdom API 令牌。
讀取工作流程
目前帳號
python3 $WX account
聯絡人
python3 $WX contacts --limit 50
最近的對話
首先使用普通的對話端點;它會優先使用微信資料庫(當準備就緒時), 並在必要時回退到 Wisdom 的應用程式資料庫。
python3 $WX conversations --limit 20
若要取得已解密的本地微信歷史記錄工作階段:
python3 $WX conversations --history --limit 20
對話中的訊息
首先列出對話,然後使用 id 作為 conversation_id:
python3 $WX messages "34642176898@chatroom" --limit 50 --order asc
歷史訊息
從 Wisdom 已解密的微信本地資料庫讀取:
python3 $WX history --limit 50
python3 $WX history --talker "34642176898@chatroom" --limit 50
python3 $WX history --limit 20 --offset 20
原始 SQL(僅限唯讀)
Wisdom 僅允許 SELECT 和 PRAGMA:
python3 $WX sql MicroMsg.db 'SELECT count(*) AS cnt FROM Session'
僅在診斷或針對性元資料查詢時使用原始 SQL。除非用戶明確要求, 否則不要傾倒大型訊息表格。
重新整理歷史資料庫
如果歷史記錄看起來過時,請重新整理已解密的資料庫快照:
python3 $WX refresh-history
搜尋
python3 $WX search "Alice"
搜尋會驅動微信 UI,因此可能比本地資料庫歷史記錄讀取慢。
傳送訊息 — 有門控
send 預設會進行乾執行。除非存在 --confirm,
或者除非 AceDataCloud 排程任務預先授權了此技能並且使用了
--unattended-confirm,否則它絕不會傳送。
python3 $WX send "Alice" "今晚 8 點開會嗎?"
# -> {"dry_run": true, ...}
向用戶展示乾執行輸出,並請求明確批准確切的 收件人和文字。然後才能執行:
python3 $WX send "Alice" "今晚 8 點開會嗎?" --confirm
不要在第一次嘗試時就加上 --confirm。不要從模糊的文字中推斷同意。
用戶必須明確批准傳送這條確切的訊息。
排程任務的無人在場確認
當在 AceDataCloud 排程任務中執行時,平台可能會預先授權 特定技能進行無人在場執行。如果以下所有條件都成立:
AICHAT_UNATTENDED_MODE=trueAICHAT_ACTIVE_SKILL是personal-wechat或acedatacloud/personal-wechatAICHAT_ACTIVE_SKILL出現在AICHAT_UNATTENDED_ALLOWED_SKILLS中
則表示用戶已為該排程任務預先授權了此技能。在這種情況下, 請使用:
python3 $WX send "Alice" "今晚 8 點開會嗎?" --unattended-confirm
如果助手返回 unattended_confirmation_denied,請不要用 --confirm 重試;
請報告乾執行結果,並說明該任務需要在它的無人在場授權設定中
選中此技能。
安全規則
- 切勿列印
PERSONALWECHAT_API_TOKEN。 - 將
PERSONALWECHAT_BASE_URL + API_TOKEN視為對用戶微信的完整遠端控制。 - 對於一般的聊天寫入/傳送操作:先乾執行,請求明確批准,然後重新使用
--confirm執行。 - 對於排程任務的無人在場寫入:僅當平台環境變數指示此技能已獲預先授權時,才使用
--unattended-confirm。 - 除非用戶明確要求修復 Wisdom 服務,否則不要從技能呼叫登出/重新啟動端點。
- 如果 Wisdom 返回 503(針對歷史記錄),請執行
python3 $WX refresh-history一次,然後重試讀取。 - 如果伺服器無法連線,請要求用戶檢查 Windows 主機 / 安全群組 / 連接埠 8000。
端點對映
助手包裝了以下 Wisdom 端點:
GET /api/statusGET /api/auth/statusGET /api/accountGET /api/contacts?version=2.0GET /api/conversationsGET /api/conversations/historyGET /api/messagesGET /api/messages/historyPOST /api/messages/history/queryPOST /api/messages/history/refreshPOST /api/searchPOST /api/messages/send(僅在--confirm或已驗證的--unattended-confirm之後)