wx-bot-cli 0.1.0

package/README.en.md

@@ -0,0 +1,175 @@
+# wxbot — WeChat AI Bot CLI
+
+A command-line bot tool for the WeChat iLink API. Features QR-code login, message sending and receiving, SQLite-backed message history, and an Ink terminal dashboard (TUI).
+
+The background daemon is managed by **launchd** (macOS) or **systemd** (Linux) — auto-start on boot, auto-restart on crash.
+
+---
+
+## Features
+
+- **QR-code login** — renders a QR code in the terminal; scan with WeChat to authorize
+- **System service** — auto-registers as a launchd / systemd user service, no manual process management needed
+- **Long-polling** — daemon continuously fetches new messages and writes them to SQLite (WAL mode)
+- **Session quota** — up to 10 replies per context token; an automatic notice is sent on the 9th reply
+- **Unix Socket IPC** — CLI and daemon communicate over a local socket with minimal latency
+- **Ink TUI dashboard** — live message feed and service status, refreshed every 2 seconds
+
+---
+
+## Requirements
+
+- Node.js >= 22
+- macOS (launchd) or Linux (systemd)
+
+---
+
+## Installation
+
+```bash
+npm install -g wx-bot-cli
+```
+
+Or build from source:
+
+```bash
+git clone https://github.com/yourname/wx-bot-cli.git
+cd wx-bot-cli
+npm install
+npm run build
+npm link
+```
+
+---
+
+## Quick Start
+
+**1. Log in**
+
+```bash
+wxbot login
+```
+
+A QR code is rendered in the terminal. Scan it with WeChat and confirm. Once authorized, the background service is installed and started automatically.
+
+**2. Open the dashboard**
+
+```bash
+wxbot
+```
+
+Shows the live message feed, active user, and service status.
+
+**3. Send a message**
+
+```bash
+wxbot send "Hello! How can I help you?"
+```
+
+Sends to the currently active user (the most recent person who messaged the bot).
+
+---
+
+## Command Reference
+
+| Command | Description |
+|---|---|
+| `wxbot` | Open the TUI dashboard (default) |
+| `wxbot login` | QR-code login; install and start system service |
+| `wxbot logout` | Stop service and clear session (message history preserved) |
+| `wxbot send <text>` | Send a message to the active user |
+| `wxbot list [-n <count>]` | Show recent messages (default: 20) |
+| `wxbot status` | Show service running status |
+
+### wxbot list
+
+```bash
+wxbot list        # last 20 messages
+wxbot list -n 50  # last 50 messages
+```
+
+### wxbot status — example output
+
+```
+● Service running
+  PID:          12345
+  Account:      bot_abc123
+  Last poll:    2026-03-22T10:00:00.000Z
+  Active user:  user_xyz
+  Total msgs:   128
+  Uptime:       15m30s
+```
+
+---
+
+## Session Quota
+
+Each user message carries a `context_token` representing an independent conversation. Each conversation allows up to **10 bot replies**:
+
+- After the 9th reply, the bot automatically sends a notice asking the user to reply to start a new conversation
+- Once the quota is exhausted, the bot waits for the user's next message to reset
+- `wxbot send` shows a warning when 3 or fewer replies remain
+
+---
+
+## Data Files
+
+All runtime files are stored under `~/.wxbot/`:
+
+| Path | Purpose |
+|---|---|
+| `~/.wxbot/session.json` | Login session (chmod 600) |
+| `~/.wxbot/messages.db` | Message database (SQLite WAL) |
+| `~/.wxbot/wxbot.sock` | IPC Unix socket |
+| `~/.wxbot/service.pid` | Daemon PID |
+| `~/.wxbot/service-YYYY-MM-DD.log` | Daily service log |
+
+---
+
+## Architecture
+
+```
+wxbot (CLI / TUI)
+    │
+    │  Unix Socket IPC (newline-delimited JSON)
+    │
+wxbot _daemon (Daemon)
+    ├── Long-polls  ilink/bot/getupdates
+    ├── Writes messages to  SQLite (~/.wxbot/messages.db)
+    └── Tracks session state  ServiceState (in-memory)
+```
+
+### Key Modules
+
+| File | Responsibility |
+|---|---|
+| `bin.ts` | CLI entry point, Commander routing |
+| `tui.tsx` | Ink TUI dashboard (React) |
+| `service.ts` | Daemon main loop + IPC handler |
+| `auth.ts` | QR-code login flow |
+| `daemon.ts` | launchd plist / systemd unit generation |
+| `ipc.ts` | Unix socket server + client |
+| `api.ts` | iLink API HTTP wrappers |
+| `db.ts` | SQLite operations (better-sqlite3) |
+
+---
+
+## Development
+
+```bash
+npm run build      # compile TypeScript to dist/
+npm run typecheck  # type-check without emitting files
+npm test           # run Vitest tests with coverage
+```
+
+Run a single test file:
+
+```bash
+npx vitest run src/auth.test.ts
+```
+
+---
+
+## License
+
+[MIT](LICENSE)

package/README.md

@@ -0,0 +1,177 @@
+# wxbot — 微信 AI Bot CLI
+
+[English](README.en.md)
+
+基于微信 iLink API 的命令行 Bot 工具，提供扫码登录、消息收发、SQLite 持久化存储，以及 Ink 终端看板（TUI）。
+
+后台守护进程由 **launchd**（macOS）或 **systemd**（Linux）托管，开机自启、崩溃自恢复。
+
+---
+
+## 功能特性
+
+- **扫码登录** — 终端内渲染二维码，用微信扫描即可完成授权
+- **系统服务** — 自动注册为 launchd / systemd 用户服务，无需手动守护
+- **长轮询收消息** — 后台持续拉取新消息，写入 SQLite（WAL 模式）
+- **会话额度管理** — 每个 context token 最多发送 10 条消息，第 9 条时自动发送提醒
+- **Unix Socket IPC** — CLI 与 Daemon 通过本地 socket 通信，延迟极低
+- **Ink TUI 看板** — 实时展示消息流与服务状态，每 2 秒刷新
+
+---
+
+## 环境要求
+
+- Node.js >= 22
+- macOS（launchd）或 Linux（systemd）
+
+---
+
+## 安装
+
+```bash
+npm install -g wx-bot-cli
+```
+
+或从源码构建：
+
+```bash
+git clone https://github.com/yourname/wx-bot-cli.git
+cd wx-bot-cli
+npm install
+npm run build
+npm link
+```
+
+---
+
+## 快速开始
+
+**1. 登录**
+
+```bash
+wxbot login
+```
+
+终端会显示二维码，用微信扫码并确认授权。登录成功后，后台服务自动安装并启动。
+
+**2. 打开看板**
+
+```bash
+wxbot
+```
+
+实时展示收到的消息、当前活跃用户及服务状态。
+
+**3. 发送消息**
+
+```bash
+wxbot send "你好，有什么可以帮你？"
+```
+
+消息发送给当前活跃用户（最近一个给 Bot 发过消息的人）。
+
+---
+
+## 命令参考
+
+| 命令 | 说明 |
+|---|---|
+| `wxbot` | 打开 TUI 看板（默认行为） |
+| `wxbot login` | 扫码登录，安装并启动系统服务 |
+| `wxbot logout` | 停止服务，清除会话（消息记录保留） |
+| `wxbot send <text>` | 向当前活跃用户发送消息 |
+| `wxbot list [-n <数量>]` | 查看最近消息，默认显示 20 条 |
+| `wxbot status` | 查看服务运行状态 |
+
+### wxbot list
+
+```bash
+wxbot list        # 最近 20 条
+wxbot list -n 50  # 最近 50 条
+```
+
+### wxbot status 输出示例
+
+```
+● 服务运行中
+  PID:       12345
+  账号:      bot_abc123
+  上次轮询:  2026-03-22T10:00:00.000Z
+  活跃用户:  user_xyz
+  消息总数:  128
+  运行时长:  15m30s
+```
+
+---
+
+## 会话额度机制
+
+每当用户发送一条消息时，会产生一个新的 `context_token`，对应一个独立会话。每个会话最多可回复 **10 条消息**：
+
+- 第 9 条发送完毕后，Bot 自动向用户发送一条提醒（"请回复以开启新会话"）
+- 第 10 条额度耗尽后，需等待用户回复才能继续
+- `wxbot send` 会在剩余额度 <= 3 时显示警告
+
+---
+
+## 数据文件
+
+所有运行时文件存放在 `~/.wxbot/`：
+
+| 路径 | 用途 |
+|---|---|
+| `~/.wxbot/session.json` | 登录会话（chmod 600） |
+| `~/.wxbot/messages.db` | 消息数据库（SQLite WAL） |
+| `~/.wxbot/wxbot.sock` | IPC Unix Socket |
+| `~/.wxbot/service.pid` | 守护进程 PID |
+| `~/.wxbot/service-YYYY-MM-DD.log` | 当日运行日志 |
+
+---
+
+## 架构
+
+```
+wxbot (CLI/TUI)
+    │
+    │  Unix Socket IPC (JSON-over-newline)
+    │
+wxbot _daemon (Daemon)
+    ├── 长轮询  ilink/bot/getupdates
+    ├── 消息写入  SQLite (~/.wxbot/messages.db)
+    └── 会话状态  ServiceState (内存)
+```
+
+### 核心模块
+
+| 文件 | 职责 |
+|---|---|
+| `bin.ts` | CLI 入口，Commander 路由 |
+| `tui.tsx` | Ink TUI 看板，React 组件 |
+| `service.ts` | Daemon 主循环 + IPC 处理 |
+| `auth.ts` | 扫码登录流程 |
+| `daemon.ts` | launchd plist / systemd unit 生成与管理 |
+| `ipc.ts` | Unix Socket 服务端 + 客户端 |
+| `api.ts` | iLink API HTTP 封装 |
+| `db.ts` | SQLite 操作（better-sqlite3） |
+
+---
+
+## 开发
+
+```bash
+npm run build      # TypeScript 编译到 dist/
+npm run typecheck  # 仅类型检查，不输出文件
+npm test           # Vitest 测试 + 覆盖率报告
+```
+
+单独运行某个测试文件：
+
+```bash
+npx vitest run src/auth.test.ts
+```
+
+---
+
+## 许可证
+
+[MIT](LICENSE)

package/dist/api.d.ts

@@ -0,0 +1,27 @@
+export declare const DEFAULT_BASE_URL = "https://ilinkai.weixin.qq.com";
+export declare const BOT_TYPE = "3";
+export declare const LONG_POLL_TIMEOUT_MS = 35000;
+export declare const API_TIMEOUT_MS = 15000;
+export declare function buildHeaders(token?: string): Record<string, string>;
+export declare function apiPost(params: {
+    baseUrl: string;
+    endpoint: string;
+    body: unknown;
+    token?: string;
+    timeoutMs: number;
+}): Promise<unknown>;
+export declare function apiGet(params: {
+    baseUrl: string;
+    endpoint: string;
+    token?: string;
+    extraHeaders?: Record<string, string>;
+    timeoutMs: number;
+}): Promise<unknown>;
+export declare function sendTextMessage(params: {
+    baseUrl: string;
+    token: string;
+    toUserId: string;
+    text: string;
+    contextToken: string;
+}): Promise<void>;
+//# sourceMappingURL=api.d.ts.map

package/dist/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,gBAAgB,kCAAkC,CAAC;AAChE,eAAO,MAAM,QAAQ,MAAM,CAAC;AAC5B,eAAO,MAAM,oBAAoB,QAAS,CAAC;AAC3C,eAAO,MAAM,cAAc,QAAS,CAAC;AAOrC,wBAAgB,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQnE;AAaD,wBAAsB,OAAO,CAAC,MAAM,EAAE;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB;AAED,wBAAsB,MAAM,CAAC,MAAM,EAAE;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,OAAO,CAAC,CAoBnB;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACtB,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBhB"}

package/dist/api.js

@@ -0,0 +1,100 @@
+import crypto from 'node:crypto';
+export const DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com';
+export const BOT_TYPE = '3';
+export const LONG_POLL_TIMEOUT_MS = 35_000;
+export const API_TIMEOUT_MS = 15_000;
+function randomWechatUin() {
+    const uint32 = crypto.randomBytes(4).readUInt32BE(0);
+    return Buffer.from(String(uint32), 'utf-8').toString('base64');
+}
+export function buildHeaders(token) {
+    const h = {
+        'Content-Type': 'application/json',
+        'AuthorizationType': 'ilink_bot_token',
+        'X-WECHAT-UIN': randomWechatUin(),
+    };
+    if (token?.trim())
+        h['Authorization'] = `Bearer ${token.trim()}`;
+    return h;
+}
+function ensureSlash(url) {
+    return url.endsWith('/') ? url : `${url}/`;
+}
+function isAbortError(err) {
+    if (!(err instanceof Error))
+        return false;
+    if (err.name === 'AbortError')
+        return true;
+    const cause = err.cause;
+    return cause?.name === 'AbortError' || false;
+}
+export async function apiPost(params) {
+    const url = new URL(params.endpoint, ensureSlash(params.baseUrl)).toString();
+    const bodyStr = JSON.stringify(params.body);
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), params.timeoutMs);
+    try {
+        const res = await fetch(url, {
+            method: 'POST',
+            headers: { ...buildHeaders(params.token), 'Content-Length': String(Buffer.byteLength(bodyStr)) },
+            body: bodyStr,
+            signal: ctrl.signal,
+        });
+        clearTimeout(t);
+        const text = await res.text();
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}: ${text}`);
+        return JSON.parse(text);
+    }
+    catch (err) {
+        clearTimeout(t);
+        throw err;
+    }
+}
+export async function apiGet(params) {
+    const url = new URL(params.endpoint, ensureSlash(params.baseUrl)).toString();
+    const ctrl = new AbortController();
+    const t = setTimeout(() => ctrl.abort(), params.timeoutMs);
+    try {
+        const res = await fetch(url, {
+            method: 'GET',
+            headers: { ...buildHeaders(params.token), ...(params.extraHeaders ?? {}) },
+            signal: ctrl.signal,
+        });
+        clearTimeout(t);
+        if (res.status === 204 || res.headers.get('content-length') === '0')
+            return {};
+        const text = await res.text();
+        if (!res.ok)
+            throw new Error(`HTTP ${res.status}: ${text}`);
+        return JSON.parse(text);
+    }
+    catch (err) {
+        clearTimeout(t);
+        if (isAbortError(err))
+            return { status: 'wait' };
+        throw err;
+    }
+}
+export async function sendTextMessage(params) {
+    const clientId = `wxbot:${Date.now()}-${crypto.randomBytes(4).toString('hex')}`;
+    await apiPost({
+        baseUrl: params.baseUrl,
+        endpoint: 'ilink/bot/sendmessage',
+        body: {
+            msg: {
+                from_user_id: '',
+                to_user_id: params.toUserId,
+                client_id: clientId,
+                message_type: 2,
+                message_state: 2,
+                item_list: [{ type: 1, text_item: { text: params.text } }],
+                context_token: params.contextToken,
+            },
+            base_info: { channel_version: 'standalone' },
+        },
+        token: params.token,
+        timeoutMs: API_TIMEOUT_MS,
+    });
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../src/api.ts"],"names":[],"mappings":"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"}

package/dist/auth.d.ts

@@ -0,0 +1,6 @@
+import type { Session } from './types.js';
+export declare function loadSession(sessionPath: string): Session | null;
+export declare function saveSession(sessionPath: string, session: Session): void;
+export declare function clearSession(sessionPath: string): void;
+export declare function loginWithQr(baseUrl: string): Promise<Session>;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAO/D;AAED,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAIvE;AAED,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CAEtD;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAmEnE"}

package/dist/auth.js

@@ -0,0 +1,95 @@
+import fs from 'node:fs';
+import path from 'node:path';
+// @ts-ignore — no type declarations for qrcode-terminal
+import qrterm from 'qrcode-terminal';
+import { apiGet } from './api.js';
+export function loadSession(sessionPath) {
+    try {
+        if (!fs.existsSync(sessionPath))
+            return null;
+        return JSON.parse(fs.readFileSync(sessionPath, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+export function saveSession(sessionPath, session) {
+    fs.mkdirSync(path.dirname(sessionPath), { recursive: true });
+    fs.writeFileSync(sessionPath, JSON.stringify(session, null, 2), 'utf-8');
+    try {
+        fs.chmodSync(sessionPath, 0o600);
+    }
+    catch { /* best-effort */ }
+}
+export function clearSession(sessionPath) {
+    try {
+        fs.unlinkSync(sessionPath);
+    }
+    catch { /* ignore */ }
+}
+export async function loginWithQr(baseUrl) {
+    process.stdout.write('正在获取二维码...\n');
+    const qrResp = await apiGet({
+        baseUrl,
+        endpoint: `ilink/bot/get_bot_qrcode?bot_type=3`,
+        timeoutMs: 10_000,
+    });
+    if (!qrResp.qrcode || !qrResp.qrcode_img_content) {
+        throw new Error(`获取二维码失败: ${JSON.stringify(qrResp)}`);
+    }
+    process.stdout.write('\n请用微信扫描以下二维码：\n\n');
+    qrterm.generate(qrResp.qrcode_img_content, { small: true });
+    process.stdout.write('等待扫码确认...\n\n');
+    const deadline = Date.now() + 5 * 60_000;
+    let qrcode = qrResp.qrcode;
+    let qrcodeImg = qrResp.qrcode_img_content;
+    let refreshCount = 0;
+    while (Date.now() < deadline) {
+        const statusResp = await apiGet({
+            baseUrl,
+            endpoint: `ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(qrcode)}`,
+            extraHeaders: { 'iLink-App-ClientVersion': '1' },
+            timeoutMs: 35_000,
+        });
+        const status = statusResp.status ?? 'wait';
+        if (status === 'scaned') {
+            process.stdout.write('\r👀 已扫码，请在微信中确认...         \n');
+        }
+        else if (status === 'confirmed') {
+            if (!statusResp.ilink_bot_id)
+                throw new Error('登录成功但缺少 ilink_bot_id');
+            const session = {
+                token: statusResp.bot_token ?? '',
+                baseUrl: statusResp.baseurl || baseUrl,
+                accountId: statusResp.ilink_bot_id,
+                userId: statusResp.ilink_user_id,
+                savedAt: new Date().toISOString(),
+            };
+            process.stdout.write(`\n✅ 登录成功！accountId=${session.accountId}\n`);
+            return session;
+        }
+        else if (status === 'expired') {
+            refreshCount++;
+            if (refreshCount > 3)
+                throw new Error('二维码多次过期，请重新运行');
+            process.stdout.write(`\n⏳ 二维码已过期，正在刷新... (${refreshCount}/3)\n`);
+            const newQr = await apiGet({
+                baseUrl,
+                endpoint: `ilink/bot/get_bot_qrcode?bot_type=3`,
+                timeoutMs: 10_000,
+            });
+            if (!newQr.qrcode || !newQr.qrcode_img_content)
+                throw new Error('刷新二维码失败');
+            qrcode = newQr.qrcode;
+            qrcodeImg = newQr.qrcode_img_content;
+            process.stdout.write('\n新二维码已生成，请重新扫描：\n\n');
+            qrterm.generate(qrcodeImg, { small: true });
+        }
+        else {
+            process.stdout.write('.');
+        }
+        await new Promise((r) => setTimeout(r, 1000));
+    }
+    throw new Error('登录超时，请重新运行');
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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"}

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}