NOTICE

NOTICE
======

This project is a minimal, independent Python implementation of a WeChat iLink
Bot <-> Claude Agent SDK bridge. The iLink protocol layer was reverse-referenced
from the following upstream repositories (cross-checked 2026-07-30). No
substantial source code was copied from them; the protocol constants below were
verified against the listed commits and re-implemented from scratch in Python.

Upstream references
-------------------

1. Tencent/openclaw-weixin  (authoritative for protocol constants)
   - commit: cef0bfc39039  (main, "release v2.4.6", 2026-06-25)
   - https://github.com/Tencent/openclaw-weixin
   - License: see upstream repository.

2. photon-hq/wechat-ilink-client  (independent TypeScript iLink client)
   - commit: b3e59440e90d  (main, 2026-03-22)
   - https://github.com/photon-hq/wechat-ilink-client

3. paceaitian/cc-wechat  (iLink + Claude Code reference)
   - commit: 6644b4d5f08c  (master, 2026-03-27)
   - https://github.com/paceaitian/cc-wechat

4. Claude Agent SDK for Python
   - package: claude-agent-sdk (verified version 0.2.128, bundled CLI 2.1.220)
   - https://code.claude.com/docs/en/agent-sdk/python

Verified protocol constants (from Tencent/openclaw-weixin v2.4.6)
-----------------------------------------------------------------

- Initial base URL:        https://ilinkai.weixin.qq.com
- iLink-App-Id:            bot
- iLink-App-ClientVersion: 132102   (encoded from 2.4.6 as (2<<16)|(4<<8)|6)
- channel_version:         2.4.6
- AuthorizationType:       ilink_bot_token
- Stale/expired token code: errcode == -14 (also defensively check ret == -14)
- message_type:            1 = USER, 2 = BOT, 0 = NONE
- message_state:           2 = FINISH (complete message)
- QR status values:        wait, scaned, expired, confirmed,
                           scaned_but_redirect, need_verifycode,
                           verify_code_blocked, binded_redirect (success-equivalent)
- qrcode_img_content:      the QR payload itself (a weixin:// deep-link string),
                           encoded directly into the QR; NOT a URL to fetch

These constants are centralized in src/wechat_ilink_claude_bridge/ilink/protocol.py
and are overridable via environment variables. If upstream changes, update that
single module rather than patching business code.

This project does NOT install or run OpenClaw, does NOT patch Claude Code, and
does NOT use browser automation. It identifies itself as "WeChatClaudeBridge"
and does not impersonate OpenClaw or the Claude Code brand.