cc-wechat 0.1.0

package/src/cli.ts

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * cc-wechat CLI 入口 — install/login/status/help 命令
+ */
+
+import { execSync } from 'node:child_process';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loginTerminal } from './auth.js';
+import { saveAccount, getActiveAccount } from './store.js';
+
+// ─── help ────────────────────────────────────────────
+
+/** 打印帮助信息 */
+function help(): void {
+  console.log(`
+  cc-wechat — 微信 Claude Code Channel 插件
+
+  用法: npx cc-wechat <命令>
+
+  命令:
+    install   注册 MCP server + 扫码登录
+    patch     修补 Claude Code 以启用 Channels 功能
+    unpatch   恢复原始 Claude Code
+    login     重新扫码登录
+    status    查看连接状态
+    help      显示帮助
+`);
+}
+
+// ─── install ─────────────────────────────────────────
+
+/** 注册 MCP server + 扫码登录 */
+async function install(): Promise<void> {
+  console.log('\n🔧 cc-wechat 安装向导\n');
+
+  // [1/3] 注册 MCP server
+  console.log('[1/3] 注册 MCP server...');
+  const serverPath = path.join(path.dirname(fileURLToPath(import.meta.url)), 'server.js');
+
+  try {
+    execSync('claude mcp add -s user wechat-channel node ' + serverPath, { stdio: 'pipe' });
+    console.log('  ✅ MCP server 已注册');
+  } catch {
+    try {
+      execSync('claude mcp remove wechat-channel', { stdio: 'pipe' });
+      execSync('claude mcp add -s user wechat-channel node ' + serverPath, { stdio: 'pipe' });
+      console.log('  ✅ MCP server 已重新注册');
+    } catch (e) {
+      console.error('  ❌ MCP server 注册失败:', (e as Error).message);
+    }
+  }
+
+  // [2/3] 微信扫码登录
+  console.log('\n[2/3] 微信扫码登录...');
+  const existing = getActiveAccount();
+  if (existing) {
+    console.log('  ⏭️  已有登录账号，跳过扫码。如需重新登录请运行: npx cc-wechat login');
+  } else {
+    const { token, accountId, baseUrl } = await loginTerminal();
+    saveAccount({
+      token,
+      baseUrl: baseUrl ?? '',
+      botId: accountId.replace(/@/g, '-').replace(/\./g, '-'),
+      savedAt: new Date().toISOString(),
+    });
+    console.log('  ✅ 登录成功');
+  }
+
+  // [3/3] 完成
+  console.log('\n[3/3] 安装完成！');
+  console.log('\n启动 Claude Code 时使用:');
+  console.log('  claude --dangerously-load-development-channels server:wechat-channel\n');
+}
+
+// ─── login ───────────────────────────────────────────
+
+/** 重新扫码登录 */
+async function login(): Promise<void> {
+  console.log('\n🔑 微信扫码登录\n');
+  const { token, accountId, baseUrl } = await loginTerminal();
+  saveAccount({
+    token,
+    baseUrl: baseUrl ?? '',
+    botId: accountId.replace(/@/g, '-').replace(/\./g, '-'),
+    savedAt: new Date().toISOString(),
+  });
+  console.log('\n✅ 登录成功！账号已保存。\n');
+}
+
+// ─── status ──────────────────────────────────────────
+
+/** 查看连接状态 */
+function status(): void {
+  const account = getActiveAccount();
+  if (account) {
+    console.log('\n📋 当前账号状态:\n');
+    console.log(`  botId:   ${account.botId.substring(0, 12)}...`);
+    console.log(`  baseUrl: ${account.baseUrl}`);
+    console.log(`  savedAt: ${account.savedAt}\n`);
+  } else {
+    console.log('\n❌ 尚未登录。请运行: npx cc-wechat install\n');
+  }
+}
+
+// ─── main ────────────────────────────────────────────
+
+const command = process.argv[2];
+switch (command) {
+  case 'install': case 'setup': install(); break;
+  case 'login': login(); break;
+  case 'patch': case 'unpatch': {
+    // 动态导入 patch 模块，传递命令
+    process.argv[2] = command;
+    await import('./patch.js');
+    break;
+  }
+  case 'status': status(); break;
+  case 'help': case '--help': case '-h': case undefined: help(); break;
+  default: console.error(`未知命令: ${command}`); help(); process.exit(1);
+}

package/src/ilink-api.ts

@@ -0,0 +1,279 @@
+/**
+ * cc-wechat iLink Bot API 封装 — 7 个 HTTP API
+ */
+import { randomBytes } from 'node:crypto';
+import type {
+  BaseInfo,
+  QRCodeResponse,
+  QRStatusResponse,
+  GetUpdatesResp,
+  GetConfigResp,
+  GetUploadUrlResp,
+} from './types.js';
+
+// 默认 iLink 服务地址
+export const DEFAULT_BASE_URL = 'https://ilinkai.weixin.qq.com';
+const DEFAULT_BOT_TYPE = '3';
+const LONG_POLL_TIMEOUT_MS = 35_000;
+
+/** 构造 base_info 通用字段 */
+export function buildBaseInfo(): BaseInfo {
+  return { channel_version: '0.1.0' };
+}
+
+/** 生成随机 wechat uin（4 字节随机数 → 十进制 → base64） */
+export function randomWechatUin(): string {
+  const num = randomBytes(4).readUInt32BE(0);
+  const str = num.toString(10);
+  return Buffer.from(str, 'utf-8').toString('base64');
+}
+
+/** 构造请求头 */
+export function buildHeaders(
+  token?: string,
+  body?: string,
+): Record<string, string> {
+  const headers: Record<string, string> = {
+    'Content-Type': 'application/json',
+    'AuthorizationType': 'ilink_bot_token',
+    'X-WECHAT-UIN': randomWechatUin(),
+  };
+  if (token) {
+    headers['Authorization'] = `Bearer ${token}`;
+  }
+  if (body) {
+    headers['Content-Length'] = String(Buffer.byteLength(body, 'utf-8'));
+  }
+  return headers;
+}
+
+/** 通用 HTTP 请求 */
+export async function apiFetch(params: {
+  baseUrl?: string;
+  endpoint: string;
+  body?: string;
+  token?: string;
+  timeoutMs: number;
+  label: string;
+  method?: string;
+  extraHeaders?: Record<string, string>;
+}): Promise<string> {
+  const {
+    endpoint,
+    body,
+    token,
+    timeoutMs,
+    label,
+    method = 'POST',
+  } = params;
+
+  // 确保 base URL 末尾有 /
+  let base = params.baseUrl ?? DEFAULT_BASE_URL;
+  if (!base.endsWith('/')) base += '/';
+
+  const url = `${base}${endpoint}`;
+  const isGet = method === 'GET';
+
+  // GET 请求不传 body 和 Content-Type/Content-Length
+  const headers: Record<string, string> = isGet
+    ? {
+        'AuthorizationType': 'ilink_bot_token',
+        'X-WECHAT-UIN': randomWechatUin(),
+        ...(token ? { Authorization: `Bearer ${token}` } : {}),
+      }
+    : buildHeaders(token, body);
+
+  // 合并额外请求头
+  if (params.extraHeaders) {
+    Object.assign(headers, params.extraHeaders);
+  }
+
+  const controller = new AbortController();
+  const timer = setTimeout(() => controller.abort(), timeoutMs);
+
+  try {
+    const resp = await fetch(url, {
+      method,
+      headers,
+      ...(isGet ? {} : { body }),
+      signal: controller.signal,
+    });
+    const text = await resp.text();
+    if (!resp.ok) {
+      throw new Error(`[${label}] HTTP ${resp.status}: ${text}`);
+    }
+    return text;
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+// ─── QR 登录 API（GET 请求） ─────────────────────────
+
+/** 获取登录二维码 */
+export async function getQRCode(
+  baseUrl?: string,
+): Promise<QRCodeResponse> {
+  const text = await apiFetch({
+    baseUrl,
+    endpoint: `ilink/bot/get_bot_qrcode?bot_type=${DEFAULT_BOT_TYPE}`,
+    timeoutMs: 10_000,
+    label: 'getQRCode',
+    method: 'GET',
+  });
+  return JSON.parse(text) as QRCodeResponse;
+}
+
+/** 轮询二维码扫描状态（长轮询，35s 超时） */
+export async function pollQRStatus(
+  qrcode: string,
+  baseUrl?: string,
+): Promise<QRStatusResponse> {
+  try {
+    const text = await apiFetch({
+      baseUrl,
+      endpoint: `ilink/bot/get_qrcode_status?qrcode=${encodeURIComponent(qrcode)}`,
+      timeoutMs: LONG_POLL_TIMEOUT_MS,
+      label: 'pollQRStatus',
+      method: 'GET',
+      extraHeaders: { 'iLink-App-ClientVersion': '1' },
+    });
+    return JSON.parse(text) as QRStatusResponse;
+  } catch (err: unknown) {
+    if (err instanceof Error && err.name === 'AbortError') {
+      return { status: 'wait' };
+    }
+    throw err;
+  }
+}
+
+// ─── 消息 API（POST 请求） ───────────────────────────
+
+/** 长轮询获取新消息 */
+export async function getUpdates(
+  token: string,
+  buf: string,
+  baseUrl?: string,
+  timeoutMs?: number,
+): Promise<GetUpdatesResp> {
+  const body = JSON.stringify({
+    get_updates_buf: buf,
+    base_info: buildBaseInfo(),
+  });
+  try {
+    const text = await apiFetch({
+      baseUrl,
+      endpoint: 'ilink/bot/getupdates',
+      body,
+      token,
+      timeoutMs: timeoutMs ?? LONG_POLL_TIMEOUT_MS,
+      label: 'getUpdates',
+    });
+    return JSON.parse(text) as GetUpdatesResp;
+  } catch (err: unknown) {
+    if (err instanceof Error && err.name === 'AbortError') {
+      return { ret: 0, msgs: [], get_updates_buf: buf };
+    }
+    throw err;
+  }
+}
+
+/** 发送文本消息，返回 client_id */
+export async function sendMessage(
+  token: string,
+  to: string,
+  text: string,
+  contextToken: string,
+  baseUrl?: string,
+): Promise<string> {
+  const clientId = `cc-wechat-${randomBytes(4).toString('hex')}`;
+  const body = JSON.stringify({
+    msg: {
+      from_user_id: '',
+      to_user_id: to,
+      client_id: clientId,
+      message_type: 2,
+      message_state: 2,
+      item_list: [{ type: 1, text_item: { text } }],
+      context_token: contextToken,
+    },
+    base_info: buildBaseInfo(),
+  });
+  await apiFetch({
+    baseUrl,
+    endpoint: 'ilink/bot/sendmessage',
+    body,
+    token,
+    timeoutMs: 10_000,
+    label: 'sendMessage',
+  });
+  return clientId;
+}
+
+/** 发送输入状态指示 */
+export async function sendTyping(
+  token: string,
+  userId: string,
+  ticket: string,
+  status: number,
+  baseUrl?: string,
+): Promise<void> {
+  const body = JSON.stringify({
+    user_id: userId,
+    typing_ticket: ticket,
+    typing_status: status,
+    base_info: buildBaseInfo(),
+  });
+  await apiFetch({
+    baseUrl,
+    endpoint: 'ilink/bot/sendtyping',
+    body,
+    token,
+    timeoutMs: 5_000,
+    label: 'sendTyping',
+  });
+}
+
+/** 获取配置（typing ticket 等） */
+export async function getConfig(
+  token: string,
+  userId: string,
+  contextToken?: string,
+  baseUrl?: string,
+): Promise<GetConfigResp> {
+  const body = JSON.stringify({
+    user_id: userId,
+    ...(contextToken ? { context_token: contextToken } : {}),
+    base_info: buildBaseInfo(),
+  });
+  const text = await apiFetch({
+    baseUrl,
+    endpoint: 'ilink/bot/getconfig',
+    body,
+    token,
+    timeoutMs: 10_000,
+    label: 'getConfig',
+  });
+  return JSON.parse(text) as GetConfigResp;
+}
+
+/** 获取文件上传地址 */
+export async function getUploadUrl(
+  token: string,
+  params: Record<string, unknown>,
+  baseUrl?: string,
+): Promise<GetUploadUrlResp> {
+  const body = JSON.stringify({
+    ...params,
+    base_info: buildBaseInfo(),
+  });
+  const text = await apiFetch({
+    baseUrl,
+    endpoint: 'ilink/bot/getuploadurl',
+    body,
+    token,
+    timeoutMs: 10_000,
+    label: 'getUploadUrl',
+  });
+  return JSON.parse(text) as GetUploadUrlResp;
+}

package/src/patch.ts

@@ -0,0 +1,182 @@
+#!/usr/bin/env node
+/**
+ * cc-wechat 补丁工具
+ * 绕过 Claude Code 的 Channels 云控检查（tengu_harbor feature flag + accessToken auth）
+ * 用法：node dist/patch.js 或 npx cc-wechat patch
+ */
+
+import fs from 'node:fs';
+import path from 'node:path';
+import { homedir } from 'node:os';
+
+// 补丁定义：[特征字符串, 替换字符串, 说明]
+const PATCHES: Array<[string, string, string]> = [
+  // 1. Channels feature flag 云控
+  [
+    'function PaH(){return lA("tengu_harbor",!1)}',
+    'function PaH(){return                   !0 }',
+    'Channels feature flag (tengu_harbor)',
+  ],
+  // 2. S1_ gate auth 检查
+  [
+    'if(!yf()?.accessToken)',
+    'if(        false     )',
+    'Channel gate accessToken check',
+  ],
+  // 3. UI 层 noAuth 检查
+  [
+    'noAuth:!yf()?.accessToken',
+    'noAuth:         false    ',
+    'UI noAuth display check',
+  ],
+];
+
+/** 查找 claude.exe 路径 */
+function findClaudeExe(): string | null {
+  const candidates = [
+    path.join(homedir(), '.local', 'bin', 'claude.exe'),
+    path.join(homedir(), '.local', 'bin', 'claude'),
+    // npm 全局安装
+    path.join(homedir(), 'AppData', 'Roaming', 'npm', 'node_modules', '@anthropic-ai', 'claude-code', 'cli.js'),
+  ];
+
+  for (const p of candidates) {
+    if (fs.existsSync(p)) return p;
+  }
+  return null;
+}
+
+function patch(): void {
+  console.log('\n  cc-wechat patch — Claude Code Channels 补丁\n');
+
+  const exePath = findClaudeExe();
+  if (!exePath) {
+    console.error('  找不到 Claude Code。请确认已安装。');
+    process.exit(1);
+  }
+  console.log(`  目标: ${exePath}`);
+
+  // 读取二进制
+  const buf = fs.readFileSync(exePath);
+  let totalPatched = 0;
+  let alreadyPatched = 0;
+
+  for (const [original, replacement, desc] of PATCHES) {
+    if (original.length !== replacement.length) {
+      console.error(`  错误: "${desc}" 长度不匹配 (${original.length} vs ${replacement.length})`);
+      process.exit(1);
+    }
+
+    const origBuf = Buffer.from(original);
+    const patchBuf = Buffer.from(replacement);
+
+    // 搜索所有出现位置
+    let pos = 0;
+    let count = 0;
+    let alreadyCount = 0;
+
+    while (true) {
+      const idx = buf.indexOf(origBuf, pos);
+      if (idx === -1) break;
+      patchBuf.copy(buf, idx);
+      count++;
+      pos = idx + 1;
+    }
+
+    // 检查是否已经 patch 过
+    pos = 0;
+    while (true) {
+      const idx = buf.indexOf(patchBuf, pos);
+      if (idx === -1) break;
+      alreadyCount++;
+      pos = idx + 1;
+    }
+
+    if (count > 0) {
+      console.log(`  [PATCH] ${desc}: ${count} 处已修补`);
+      totalPatched += count;
+    } else if (alreadyCount > 0) {
+      console.log(`  [SKIP]  ${desc}: 已修补过 (${alreadyCount} 处)`);
+      alreadyPatched += alreadyCount;
+    } else {
+      console.log(`  [WARN]  ${desc}: 未找到特征字符串（CC 版本可能已更新）`);
+    }
+  }
+
+  if (totalPatched === 0 && alreadyPatched > 0) {
+    console.log('\n  所有补丁已生效，无需操作。\n');
+    return;
+  }
+
+  if (totalPatched === 0) {
+    console.error('\n  未找到任何可修补的位置。Claude Code 版本可能不兼容。\n');
+    process.exit(1);
+  }
+
+  // 备份
+  const backupPath = exePath + '.bak';
+  if (!fs.existsSync(backupPath)) {
+    fs.copyFileSync(exePath, backupPath);
+    console.log(`  [BACKUP] 已备份到 ${backupPath}`);
+  }
+
+  // 写入 — 先写临时文件再替换
+  const tmpPath = exePath + '.patched';
+  fs.writeFileSync(tmpPath, buf);
+
+  console.log(`\n  补丁已写入 ${tmpPath}`);
+  console.log('  请关闭所有 Claude Code 进程后手动替换：\n');
+
+  if (process.platform === 'win32') {
+    const dir = path.dirname(exePath);
+    const name = path.basename(exePath);
+    console.log(`  cd ${dir}`);
+    console.log(`  Move-Item ${name} ${name}.old -Force`);
+    console.log(`  Move-Item ${name}.patched ${name} -Force\n`);
+  } else {
+    console.log(`  mv "${exePath}" "${exePath}.old"`);
+    console.log(`  mv "${tmpPath}" "${exePath}"\n`);
+  }
+
+  console.log(`  恢复方法: 用 ${backupPath} 替换即可\n`);
+}
+
+function unpatch(): void {
+  console.log('\n  cc-wechat unpatch — 恢复原始 Claude Code\n');
+
+  const exePath = findClaudeExe();
+  if (!exePath) {
+    console.error('  找不到 Claude Code。');
+    process.exit(1);
+  }
+
+  const backupPath = exePath + '.bak';
+  if (!fs.existsSync(backupPath)) {
+    console.error(`  未找到备份文件 ${backupPath}`);
+    process.exit(1);
+  }
+
+  const tmpPath = exePath + '.restore';
+  fs.copyFileSync(backupPath, tmpPath);
+  console.log(`  已准备恢复文件 ${tmpPath}`);
+  console.log('  请关闭所有 Claude Code 进程后手动替换：\n');
+
+  if (process.platform === 'win32') {
+    const dir = path.dirname(exePath);
+    const name = path.basename(exePath);
+    console.log(`  cd ${dir}`);
+    console.log(`  Move-Item ${name} ${name}.patched -Force`);
+    console.log(`  Move-Item ${name}.restore ${name} -Force\n`);
+  } else {
+    console.log(`  mv "${exePath}" "${exePath}.patched"`);
+    console.log(`  mv "${tmpPath}" "${exePath}"\n`);
+  }
+}
+
+// 入口
+const cmd = process.argv[2];
+if (cmd === 'unpatch' || cmd === 'restore') {
+  unpatch();
+} else {
+  patch();
+}

package/src/qrcode-terminal.d.ts

@@ -0,0 +1,10 @@
+/**
+ * qrcode-terminal 类型声明
+ */
+declare module 'qrcode-terminal' {
+  export function generate(
+    text: string,
+    opts: { small: boolean },
+    cb: (qr: string) => void,
+  ): void;
+}