Wisdom을 통한 개인 위챗
사용자가 직접 호스팅하는 Wisdom 서비스를 사용하여 개인 위챗 계정을 조작합니다. Wisdom은 WeChat Desktop이 로그인된 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}를 기다립니다.
이는 사용자의 실제 개인 위챗 계정입니다. 읽기 작업은 직접 실행할 수 있습니다. 메시지 또는 파일 전송은 먼저 dry-run을 수행한 후 사용자가 정확한 대상과 내용을 명시적으로 승인한 경우에만 수행해야 합니다.
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
최근 대화
먼저 일반 대화 엔드포인트를 사용합니다. 위챗 DB가 준비되면 이를 선호하고, 그렇지 않으면 Wisdom의 앱 DB로 대체합니다.
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은 진단 또는 대상 메타데이터 쿼리에만 사용하십시오. 사용자가 명시적으로 요청하지 않는 한 대용량 메시지 테이블을 덤프하지 마십시오.
기록 DB 새로고침
기록이 오래된 것으로 보이면 복호화된 DB 스냅샷을 새로고침합니다:
python3 $WX refresh-history
검색
python3 $WX search "앨리스"
검색은 위챗 UI를 구동하므로 로컬 DB 기록 읽기보다 느릴 수 있습니다.
메시지 전송 — 게이트됨
send는 기본적으로 dry-run을 수행합니다. --confirm이 있거나 AceDataCloud 예약 작업이 이 스킬을 사전 승인하고 --unattended-confirm을 사용하는 경우에만 실제 전송이 이루어집니다.
python3 $WX send "앨리스" "오늘 8시에 회의 있나요?"
# -> {"dry_run": true, ...}
dry-run 출력을 사용자에게 보여주고 정확한 수신자와 텍스트에 대한 명시적 승인을 요청합니다. 그런 다음에만 실행합니다:
python3 $WX send "앨리스" "오늘 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 "앨리스" "오늘 8시에 회의 있나요?" --unattended-confirm
헬퍼가 unattended_confirmation_denied를 반환하면 --confirm으로 재시도하지 말고 dry-run을 보고하고 작업의 무인 승인 설정에서 이 스킬을 선택해야 한다고 설명합니다.
안전 규칙
PERSONALWECHAT_API_TOKEN을 절대 출력하지 마십시오.PERSONALWECHAT_BASE_URL + API_TOKEN을 사용자 위챗의 완전한 원격 제어로 취급하십시오.- 일반 채팅 쓰기/전송 작업: 먼저 dry-run을 수행하고 명시적 승인을 요청한 후
--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후에만)