Wisdom経由の個人WeChat
ユーザーが自己ホストする Wisdom サービスを使用して、個人のWeChatアカウントを操作します。WisdomはWeChatデスクトップがログインしたWindowsホスト上で動作し、HTTP APIを公開します。
認証情報は personalwechat BYOCコネクタによって注入されます。
PERSONALWECHAT_BASE_URL— WisdomサーバーのベースURL(例:http://82.156.126.14:8000)PERSONALWECHAT_API_TOKEN— WisdomのAPI_TOKEN。秘密情報です。絶対に表示、印刷、ログに記録しないでください。
ヘルパーはトークンを Authorization: Bearer ... として送信します。トークンをURLに含めることはありません。検索や送信などのキューに入ったUI操作の場合、ヘルパーはタスクを送信し、最終結果を表示する前に /api/tasks/{id} を待機します。
これはユーザーの 実際の個人WeChatアカウント です。読み取り操作は直接実行できます。メッセージやファイルの送信は、まずドライランを実行し、ユーザーが宛先と内容を明示的に承認した後にのみ実行します。
CLI
このスキルにはstdlibのみを使用したヘルパーが付属しています。
WX=$SKILL_DIR/scripts/personal_wechat.py
最初に接続を確認
ユーザーがWeChatの使用を要求した場合は、常にステータス確認から開始します。
python3 $WX status
正常な状態の例:
{"auth":{"logged_in":true,"wechat_running":true,"page":"logged_in"}}
logged_in=false の場合、ユーザーにWisdomのWeb UI/RDPを開いてWeChatのQRコードをスキャンするよう伝えてください。APIが401を返した場合は、現在のWisdom APIトークンでPersonal WeChatコネクタを再接続するようユーザーに依頼してください。
読み取りワークフロー
現在のアカウント
python3 $WX account
連絡先
python3 $WX contacts --limit 50
最近の会話
最初に通常の会話エンドポイントを使用します。WeChat DBが準備できている場合はそれを優先し、そうでない場合はWisdomのアプリDBにフォールバックします。
python3 $WX conversations --limit 20
復号化されたローカルWeChat履歴セッションの場合:
python3 $WX conversations --history --limit 20
会話内のメッセージ
まず会話を一覧表示し、次に id を conversation_id として使用します。
python3 $WX messages "34642176898@chatroom" --limit 50 --order asc
過去のメッセージ
Wisdomの復号化されたWeChatローカルデータベースから読み取ります。
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は診断または対象を絞ったメタデータクエリにのみ使用してください。ユーザーが明示的に要求しない限り、大きなメッセージテーブルをダンプしないでください。
履歴DBの更新
履歴が古く見える場合は、復号化されたDBスナップショットを更新します。
python3 $WX refresh-history
検索
python3 $WX search "Alice"
検索はWeChat UIを操作するため、ローカルDBの履歴読み取りよりも遅くなる可能性があります。
メッセージ送信 — ゲート付き
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-wechatであるAICHAT_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をユーザーのWeChatへの完全なリモートコントロールとして扱ってください。- 通常のチャット書き込み/送信操作: まずドライランを実行し、明示的な承認を求め、その後
--confirmを付けて再実行します。 - スケジュールタスクの無人書き込み: プラットフォームの環境変数がこのスキルが事前承認されていることを示す場合にのみ
--unattended-confirmを使用します。 - ユーザーが明示的にWisdomサービスの修復を依頼しない限り、スキルからログアウト/再起動エンドポイントを呼び出さないでください。
- Wisdomが履歴に対して503を返した場合、
python3 $WX refresh-historyを1回実行してから読み取りを再試行してください。 - サーバーに到達できない場合は、ユーザーに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がある場合のみ)