chatccc 0.2.234 → 0.2.236

package/src/adapters/claude-adapter.ts

@@ -1,17 +1,7 @@
 import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { delimiter, dirname, join } from "node:path";
-import { fileURLToPath } from "node:url";
-
-import {
-  getSessionInfo as sdkGetSessionInfo,
-  unstable_v2_createSession,
-  unstable_v2_resumeSession,
-  type SDKMessage,
-  type SDKSession,
-  type SDKSessionOptions,
-  type EffortLevel,
-} from "@anthropic-ai/claude-agent-sdk";
+import { fileURLToPath, pathToFileURL } from "node:url";
 
 import type {
   CreateSessionResult,
@@ -31,6 +21,7 @@ import {
   createRawStreamLog,
   type RawStreamLogHandle,
 } from "./raw-stream-log.ts";
+import { getClaudeSdkEntryPath } from "../claude-sdk-installer.ts";
 
 const PROJECT_ROOT = dirname(dirname(dirname(fileURLToPath(import.meta.url))));
 const CLAUDE_SPECIFIC_PROMPT_PATH = join(
@@ -303,16 +294,78 @@ export function buildClaudePromptText(
   ].join("\n");
 }
 
-type ClaudeSdkSessionOptions = Omit<SDKSessionOptions, "model"> & {
+export interface ClaudeSdkSessionOptions {
+  cwd?: string;
   model?: string;
   abortController?: AbortController;
   autoCompactEnabled?: boolean;
-  effort?: EffortLevel | number;
+  effort?: string | number;
   maxTurns?: number;
   mcpServers?: Record<string, unknown>;
   skills?: "all";
   stderr?: (data: string) => void;
-};
+  settingSources?: SettingSource[];
+  permissionMode?: string;
+  settings?: unknown;
+  allowDangerouslySkipPermissions?: boolean;
+  env?: Record<string, string | undefined>;
+}
+
+/** SDK 会话的最小接口（实际由动态加载的 @anthropic-ai/claude-agent-sdk 提供） */
+export interface ClaudeSdkSession {
+  send(text: string): Promise<void>;
+  stream(): AsyncIterable<SdkMessageLike>;
+  close(): void;
+}
+
+/** SDK getSessionInfo 的返回形状（只取本项目用到的字段） */
+export interface ClaudeSdkSessionInfo {
+  sessionId: string;
+  cwd?: string;
+  summary: string;
+  lastModified: number;
+  [key: string]: unknown;
+}
+
+/** 动态加载的 SDK 模块接口（unstable_v2_* API 保持与 SDK 0.2.133 一致） */
+export interface ClaudeSdkModule {
+  unstable_v2_createSession(options: unknown): ClaudeSdkSession;
+  unstable_v2_resumeSession(sessionId: string, options: unknown): ClaudeSdkSession;
+  getSessionInfo(
+    sessionId: string,
+    opts?: { dir?: string },
+  ): Promise<ClaudeSdkSessionInfo | null | undefined>;
+}
+
+let sdkModulePromise: Promise<ClaudeSdkModule> | null = null;
+
+/**
+ * 按需加载 Claude Code 引擎（Agent SDK）。SDK 不在 chatccc 的 dependencies 中，
+ * 首次使用前需在设置页「Claude Code」卡片点「安装引擎」下载到 ~/.chatccc/claude-sdk/。
+ */
+export function loadClaudeSdkModule(): Promise<ClaudeSdkModule> {
+  if (!sdkModulePromise) {
+    sdkModulePromise = import(pathToFileURL(getClaudeSdkEntryPath()).href)
+      .then((m) => m as unknown as ClaudeSdkModule)
+      .catch((err: unknown) => {
+        sdkModulePromise = null;
+        const detail = err instanceof Error ? err.message : String(err);
+        throw new Error(
+          `Claude Code 引擎（SDK）未安装或加载失败：${detail}。` +
+            "请在设置页「Claude Code」卡片点击「安装引擎」后重试。",
+        );
+      });
+  }
+  return sdkModulePromise;
+}
+
+/**
+ * 测试钩子：注入假 SDK 模块（vitest 的 vi.mock 无法拦截变量路径的动态 import）。
+ * 传入 null 恢复为真实按需加载。
+ */
+export function __setClaudeSdkModuleForTest(module: ClaudeSdkModule | null): void {
+  sdkModulePromise = module ? Promise.resolve(module) : null;
+}
 
 function buildSdkOptions(args: {
   cwd: string;
@@ -392,10 +445,6 @@ function buildSdkOptions(args: {
   return options;
 }
 
-function toMessageLike(message: SDKMessage): SdkMessageLike {
-  return message as unknown as SdkMessageLike;
-}
-
 function safeRawStreamJson(value: unknown): string {
   try {
     return JSON.stringify(value) ?? "null";
@@ -421,12 +470,12 @@ function bridgeAbortSignal(
   return () => signal.removeEventListener("abort", onAbort);
 }
 
-function closeSdkSession(session: SDKSession): void {
+function closeSdkSession(session: ClaudeSdkSession): void {
   session.close();
 }
 
-function toSdkSessionOptions(options: ClaudeSdkSessionOptions): SDKSessionOptions {
-  return options as SDKSessionOptions;
+function toSdkSessionOptions(options: ClaudeSdkSessionOptions): unknown {
+  return options;
 }
 
 class ClaudeAdapter implements ToolAdapter {
@@ -460,8 +509,9 @@ class ClaudeAdapter implements ToolAdapter {
       removeAbortListener?.();
       throw new Error("Claude session creation aborted");
     }
+    const sdk = await loadClaudeSdkModule();
     let sessionId: string | undefined;
-    const session = unstable_v2_createSession(
+    const session = sdk.unstable_v2_createSession(
       toSdkSessionOptions(buildSdkOptions({
         cwd,
         model: this.model,
@@ -479,7 +529,7 @@ class ClaudeAdapter implements ToolAdapter {
     try {
       await session.send("ok");
       for await (const raw of session.stream()) {
-        const msg = toMessageLike(raw);
+        const msg = raw;
         if (msg.session_id && !sessionId) {
           sessionId = msg.session_id;
           await this.metaStore.set(sessionId, {
@@ -514,7 +564,9 @@ class ClaudeAdapter implements ToolAdapter {
     const rawLogConfig = config.rawStreamLogs.claude;
     let rawLog: RawStreamLogHandle | null = null;
 
-    const session = unstable_v2_resumeSession(
+    const sdk = await loadClaudeSdkModule();
+
+    const session = sdk.unstable_v2_resumeSession(
       sessionId,
       toSdkSessionOptions(buildSdkOptions({
         cwd,
@@ -554,7 +606,7 @@ class ClaudeAdapter implements ToolAdapter {
           break;
         }
 
-        const msg = toMessageLike(raw);
+        const msg = raw;
         rawLog?.writeLine(safeRawStreamJson(msg));
         if (msg.type === "system" && msg.subtype === "init" && msg.session_id) {
           const meta: { cwd?: string; model?: string } = {};
@@ -585,7 +637,8 @@ class ClaudeAdapter implements ToolAdapter {
     const meta = await this.metaStore.get(sessionId);
 
     try {
-      const sdkInfo = await sdkGetSessionInfo(
+      const sdk = await loadClaudeSdkModule();
+      const sdkInfo = await sdk.getSessionInfo(
         sessionId,
         meta?.cwd ? { dir: meta.cwd } : undefined,
       );

package/src/claude-sdk-installer.ts

@@ -0,0 +1,324 @@
+// =============================================================================
+// claude-sdk-installer.ts — Claude Code 引擎（Agent SDK）按需安装器
+// =============================================================================
+// 背景：@anthropic-ai/claude-agent-sdk 通过 optionalDependencies 内置各平台
+// 的原生 CLI 二进制（Windows 上 claude.exe 约 215MB），若作为 chatccc 的硬依赖，
+// 所有用户（包括不用 Claude Code 的）都要白白下载 220MB+。
+//
+// 方案：把 SDK 从 chatccc 的 dependencies 中移除，改为**按需安装**到
+// `~/.chatccc/claude-sdk/`：
+//   - 用户未启用 Claude Code → 完全不下载，npm 包体积大幅下降；
+//   - 用户在设置页打开 Claude Code 开关时，点「安装引擎」触发后台安装，
+//     带进度条（状态式：检测环境 → 下载中 → 安装中 → 完成/失败）。
+//
+// 设计约束：
+//   - **不 import config.ts**（config.ts 顶层有 loadConfig 副作用，web-ui.ts
+//     依赖本模块，间接 import config.ts 会污染依赖 web-ui.ts 的单测）。
+//   - 始终使用 SDK 内置的 CLI 二进制（用户拍板档位 b），不依赖用户自装 CLI。
+//   - 安装目录可注入（dir 参数），便于单测用临时目录，不碰真实用户目录。
+// =============================================================================
+
+import { spawn } from "node:child_process";
+import {
+  existsSync,
+  mkdirSync,
+  readdirSync,
+  readFileSync,
+  rmSync,
+  statSync,
+  unlinkSync,
+  writeFileSync,
+  type Dirent,
+} from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+
+/** 与当前代码配套的 SDK 版本（package.json 移除依赖后此常量成为唯一版本来源） */
+export const CLAUDE_SDK_VERSION = "0.2.133";
+
+/** 按需安装目录：~/.chatccc/claude-sdk */
+export const CLAUDE_SDK_DIR = join(homedir(), ".chatccc", "claude-sdk");
+
+const SDK_PKG_REL = join("node_modules", "@anthropic-ai", "claude-agent-sdk", "package.json");
+const SDK_ENTRY_REL = join("node_modules", "@anthropic-ai", "claude-agent-sdk", "sdk.mjs");
+const LOCK_FILE = ".installing";
+
+/** 估算的完整安装体积（含内置 CLI 二进制），用于进度条展示 */
+export const CLAUDE_SDK_EXPECTED_BYTES = 240 * 1024 * 1024;
+
+export type SdkInstallPhase =
+  | "idle"
+  | "detecting"
+  | "downloading"
+  | "installing"
+  | "done"
+  | "error";
+
+export interface SdkInstallProgress {
+  phase: SdkInstallPhase;
+  /** 0-100 */
+  percent: number;
+  message: string;
+  error?: string;
+}
+
+export interface SdkInstallOptions {
+  /** 安装目录（测试注入临时目录） */
+  dir?: string;
+  /** npm 命令（测试注入 fake） */
+  npmCommand?: string;
+  /** 期望版本（默认 CLAUDE_SDK_VERSION） */
+  expectedVersion?: string;
+  /** 进度回调 */
+  onProgress?: (p: SdkInstallProgress) => void;
+}
+
+// ---------------------------------------------------------------------------
+// 状态查询
+// ---------------------------------------------------------------------------
+
+/** SDK 入口文件绝对路径（供动态 import） */
+export function getClaudeSdkEntryPath(dir: string = CLAUDE_SDK_DIR): string {
+  return join(dir, SDK_ENTRY_REL);
+}
+
+/** 是否已安装（node_modules 里存在 SDK package.json 即视为已装） */
+export function isClaudeSdkInstalled(dir: string = CLAUDE_SDK_DIR): boolean {
+  return existsSync(join(dir, SDK_PKG_REL));
+}
+
+/** 已安装版本号；未安装/解析失败返回 null */
+export function getClaudeSdkInstalledVersion(dir: string = CLAUDE_SDK_DIR): string | null {
+  try {
+    const raw = readFileSync(join(dir, SDK_PKG_REL), "utf8");
+    const pkg = JSON.parse(raw) as { version?: unknown };
+    return typeof pkg.version === "string" ? pkg.version : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 是否正在安装（锁文件存在且 pid 存活）；pid 已死视为过期锁并自动清理 */
+export function isClaudeSdkInstalling(dir: string = CLAUDE_SDK_DIR): boolean {
+  const lockPath = join(dir, LOCK_FILE);
+  if (!existsSync(lockPath)) return false;
+  try {
+    const pid = Number.parseInt(readFileSync(lockPath, "utf8").trim(), 10);
+    if (Number.isFinite(pid) && pid > 0 && isPidAlive(pid)) return true;
+  } catch {
+    // 锁文件损坏 → 按过期处理，走清理
+  }
+  try {
+    unlinkSync(lockPath);
+  } catch {
+    // 清理失败不阻塞判断
+  }
+  return false;
+}
+
+function isPidAlive(pid: number): boolean {
+  try {
+    process.kill(pid, 0);
+    return true;
+  } catch (err) {
+    return (err as NodeJS.ErrnoException).code === "EPERM";
+  }
+}
+
+// ---------------------------------------------------------------------------
+// 安装（后台任务 + 进度）
+// ---------------------------------------------------------------------------
+
+/** 最近一次安装的进度快照，供 web-ui 轮询 */
+let lastProgress: SdkInstallProgress = { phase: "idle", percent: 0, message: "" };
+let installInProgress = false;
+
+export function getLastInstallProgress(): SdkInstallProgress {
+  return { ...lastProgress, ...(lastProgress.error ? { error: lastProgress.error } : {}) };
+}
+
+export function isInstallRunning(): boolean {
+  return installInProgress;
+}
+
+function setProgress(p: SdkInstallProgress, onProgress?: (p: SdkInstallProgress) => void): void {
+  lastProgress = { ...p };
+  onProgress?.(lastProgress);
+}
+
+/**
+ * 启动按需安装。返回 Promise，安装完成 resolve、失败 reject。
+ * 调用方通常不 await（后台执行），通过 onProgress / getLastInstallProgress() 获取进度。
+ */
+export async function installClaudeSdk(options: SdkInstallOptions = {}): Promise<void> {
+  const dir = options.dir ?? CLAUDE_SDK_DIR;
+  const npmCommand = options.npmCommand ?? "npm";
+  const expected = options.expectedVersion ?? CLAUDE_SDK_VERSION;
+  const onProgress = options.onProgress;
+
+  if (installInProgress) {
+    throw new Error("Claude Code 引擎正在安装中，请等待完成后再试。");
+  }
+  if (isClaudeSdkInstalling(dir)) {
+    throw new Error("检测到另一个安装任务正在进行（锁文件存在），请稍后再试。");
+  }
+
+  const installedVersion = isClaudeSdkInstalled(dir) ? getClaudeSdkInstalledVersion(dir) : null;
+  if (installedVersion === expected) {
+    setProgress({ phase: "done", percent: 100, message: `已安装 v${installedVersion}` }, onProgress);
+    return;
+  }
+  if (installedVersion !== null && installedVersion !== expected) {
+    setProgress(
+      {
+        phase: "detecting",
+        percent: 3,
+        message: `已装 v${installedVersion} ≠ 期望 v${expected}，开始重装…`,
+      },
+      onProgress,
+    );
+  }
+
+  installInProgress = true;
+  mkdirSync(dir, { recursive: true });
+  writeFileSync(join(dir, LOCK_FILE), String(process.pid), "utf8");
+
+  setProgress({ phase: "detecting", percent: 2, message: "检测环境…" }, onProgress);
+
+  return new Promise<void>((resolve, reject) => {
+    const child = spawn(
+      npmCommand,
+      [
+        "install",
+        "--prefix",
+        dir,
+        `@anthropic-ai/claude-agent-sdk@${expected}`,
+        "--no-audit",
+        "--no-fund",
+        "--loglevel=http",
+      ],
+      {
+        stdio: ["ignore", "pipe", "pipe"],
+        windowsHide: true,
+        // Windows 下 npm 是 npm.cmd，需要 shell 才能解析
+        shell: process.platform === "win32",
+      },
+    );
+
+    let stderrBuf = "";
+    let requestCount = 0;
+    let sizeTimer: ReturnType<typeof setInterval> | null = null;
+
+    const updateBySize = (): void => {
+      const size = dirSizeBytes(dir);
+      const sizePercent = Math.min((size / CLAUDE_SDK_EXPECTED_BYTES) * 90, 90);
+      const requestPercent = Math.min(5 + requestCount * 4, 70);
+      const percent = Math.max(sizePercent, requestPercent);
+      const mb = (size / 1048576).toFixed(0);
+      setProgress(
+        {
+          phase: "downloading",
+          percent: Math.min(percent, 94),
+          message: `下载中… 已下载 ${mb} MB / 约 220 MB`,
+        },
+        onProgress,
+      );
+    };
+
+    child.stdout.on("data", (chunk: Buffer) => {
+      const text = chunk.toString();
+      // npm --loglevel=http 每完成一个请求输出一行 "npm http fetch GET 200 ..."
+      requestCount += (text.match(/http fetch GET|GET \d{3}/g) ?? []).length;
+      updateBySize();
+    });
+
+    child.stderr.on("data", (chunk: Buffer) => {
+      stderrBuf += chunk.toString();
+    });
+
+    child.on("error", (err) => {
+      cleanupAfterFailure(dir, err, onProgress, () => {
+        installInProgress = false;
+        reject(err);
+      });
+    });
+
+    child.on("close", (code) => {
+      if (sizeTimer) clearInterval(sizeTimer);
+      if (code === 0 && isClaudeSdkInstalled(dir)) {
+        const version = getClaudeSdkInstalledVersion(dir);
+        installInProgress = false;
+        try {
+          unlinkSync(join(dir, LOCK_FILE));
+        } catch {
+          // 锁文件不存在可忽略
+        }
+        setProgress(
+          { phase: "done", percent: 100, message: `安装完成（v${version ?? expected}）` },
+          onProgress,
+        );
+        resolve();
+      } else {
+        const tail = stderrBuf.trim().split("\n").slice(-5).join(" | ");
+        const detail = code !== 0 ? `npm 退出码 ${code}` : "安装后校验未通过";
+        const message = tail ? `${detail}：${tail.slice(0, 400)}` : detail;
+        cleanupAfterFailure(dir, new Error(message), onProgress, () => {
+          installInProgress = false;
+          reject(new Error(message));
+        });
+      }
+    });
+
+    // 定期按目录体积刷新进度（大文件下载时 stdout 事件稀疏）
+    sizeTimer = setInterval(() => {
+      if (installInProgress) updateBySize();
+    }, 400);
+    if (typeof sizeTimer.unref === "function") sizeTimer.unref();
+  });
+}
+
+function cleanupAfterFailure(
+  dir: string,
+  err: Error,
+  onProgress: ((p: SdkInstallProgress) => void) | undefined,
+  after: () => void,
+): void {
+  setProgress(
+    { phase: "error", percent: 0, message: "安装失败", error: err.message.slice(0, 500) },
+    onProgress,
+  );
+  try {
+    rmSync(dir, { recursive: true, force: true });
+  } catch {
+    // 清理失败不阻塞
+  }
+  after();
+}
+
+function dirSizeBytes(dir: string): number {
+  let total = 0;
+  const stack = [dir];
+  while (stack.length > 0) {
+    const current = stack.pop()!;
+    let entries: Dirent[];
+    try {
+      entries = readdirSync(current, { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    for (const entry of entries) {
+      const full = join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(full);
+      } else if (entry.isFile()) {
+        try {
+          total += statSync(full).size;
+        } catch {
+          // 文件被并发删除可忽略
+        }
+      }
+    }
+  }
+  return total;
+}