西之月登录

要解决什么问题

访问西之月业务接口时，请求头里需要有效的 Authorization: Bearer token。手工扫码、临时抄 token 很容易过期，其它 Skill 在收到 HTTP 401 时也不知道该走哪套登录流程。本 Skill 把「生成二维码 → 用户确认 → 落盘 → 校验」固定成一条可复用的链路，避免绕过 token 校验直接调业务 API。

工作方式

1. 调用生成接口拿到 scan_token 与 wxacode，将 data URI 解码为 PNG，在终端输出路径；OPENCLAW_SESSION=1 时额外输出 [OPENCLAW_SEND_FILE] 标记供会话展示。
2. 非阻塞默认：展示二维码后结束，把待处理 scan_token 写入 ~/.westmoon-user-login/pending_login.json，用户扫码后再用 --continue / --poll 完成登录；--blocking 则每 5 秒轮询 /umc/miniprogram/qrcode/poll，直到 confirmed。
3. 确认后持久化 access_token、refresh_token、expires_at、user_info 等，并用 Bearer 访问 /umc/user/user/info 做有效性验证。
4. 其它 Skill 可通过 scripts/token_manager.py 或约定路径读取登录态；收到 401 时先 --check，无效再触发重新登录。

边界与注意点

• 先走本 Skill 再调业务接口，不要跳过落盘与校验逻辑。
• 阻塞轮询间隔默认 5 秒，长时间无人扫码会占住进程（非阻塞模式更适合 Agent 分步执行）。
• 接口字段与集成细节见 Skill 内 references/api_reference.md、references/integration_guide.md。