LINE 客户端技能

通过 Chrome 扩展网关 JSON API 实现的完整 LINE 消息客户端。

代码仓库与文件

• 仓库： /data/workspace/line-client（github.com/2manslkh/line-api）
• 主客户端： src/chrome_client.py → LineChromeClient
• 二维码登录： src/auth/qr_login.py → QRLogin
• HMAC 签名器： src/hmac/signer.js（Node.js，自动在端口 18944 启动）
• Token 存储： ~/.line-client/tokens.json
• 证书缓存： ~/.line-client/sqr_cert
• WASM 文件： lstm.wasm + lstmSandbox.js（必需，位于仓库根目录）

快速开始

import json
from pathlib import Path
from src.chrome_client import LineChromeClient

tokens = json.loads((Path.home() / ".line-client" / "tokens.json").read_text())
client = LineChromeClient(auth_token=tokens["auth_token"])

# 发送消息
client.send_message("U...", "Hello!")

# 获取个人资料
profile = client.get_profile()

Token 有效期约为 7 天。若已过期（APIError(10051)），请重新运行二维码登录流程。

二维码登录（身份验证）

二维码登录需用户交互：在手机上扫描二维码并输入 PIN 码。

from src.hmac import HmacSigner
from src.auth.qr_login import QRLogin
import qrcode

signer = HmacSigner(mode="server")
login = QRLogin(signer)
result = login.run(
    on_qr=lambda url: send_qr_image_to_user(qrcode.make(url)),
    on_pin=lambda pin: send_pin_to_user_IMMEDIATELY(pin),  # 时间敏感！
    on_status=lambda msg: print(msg),
)
# result.auth_token, result.mid, result.refresh_token

关键注意： PIN 码必须在约 60 秒内送达用户。请在 on_pin 回调触发的**第一时间**发送 PIN。

二维码登录状态机

1. createSession → 获取 session ID
2. createQrCode → 获取回调 URL（需附加 ?secret={curve25519_pubkey}&e2eeVersion=1）
3. checkQrCodeVerified — 轮询直至完成扫码（使用 X-Line-Session-ID，不带 origin 请求头）
4. verifyCertificate — 即使失败也**必须调用**（强制状态转移！）
5. createPinCode → 生成 6 位 PIN 码（若第 4 步中证书已验证，则跳过）
6. checkPinCodeVerified — 轮询直至用户输入 PIN
7. qrCodeLoginV2 → 返回 JWT token、证书及 refresh token

服务端登录脚本

python scripts/qr_login_server.py /tmp/qr.png

向 stdout 输出 JSON 事件：{"event": "qr", "path": "...", "url": "..."}、{"event": "pin", "pin": "123456"}、{"event": "done", "mid": "U..."}。

全部 API 方法

联系人与好友

消息

聊天与群组

消息表情反应

个人资料与设置

轮询与事件

其他服务

MID 格式

LINE 使用 MID 标识各类实体：

• U... 或 u... → 用户（toType=0）
• C... 或 c... → 群聊（toType=2）
• R... 或 r... → Room（toType=1）

客户端在发送消息时，会根据 MID 前缀自动推断 toType。

HMAC 签名

所有 API 请求均需携带 X-Hmac 请求头。WASM 签名器会自动完成该过程：

• 使用版本号 “3.7.1” 与 access token，通过专有 KDF（实现在 lstm.wasm 中）派生签名密钥
• 对 path + body 进行签名 → base64 编码 → 填入 X-Hmac 头
• 服务端模式：约 13ms/次（运行于端口 18944 的 Node.js HTTP 服务，自动启动）
• 子进程模式：约 2s/次（备用方案）

错误处理

from src.chrome_client import APIError

try:
    client.send_message(mid, "test")
except APIError as e:
    print(e.code, e.api_message)
    # 10051 = 会话过期 / 无效
    # 10052 = 后端返回 HTTP 错误
    # 10102 = 参数非法

架构

User's Phone (LINE app)
    ↕ (scan QR / enter PIN)
LINE Servers (line-chrome-gw.line-apps.com)
    ↕ (JSON REST + X-Hmac signing)
LineChromeClient (this repo)
    ↕ (WASM HMAC via Node.js signer)
lstm.wasm + lstmSandbox.js

Chrome 网关在内部完成 JSON ↔ Thrift 的双向转换。我们**无需直接处理 Thrift 二进制格式**——所有交互均为结构清晰的 JSON。