@cicctencent/agent-core 0.1.1 → 0.1.3

package/src/mcp/http-client.ts

@@ -1,149 +0,0 @@
-// ============================================================
-// HttpMCPClient — HTTP / SSE 传输的 MCP 客户端
-// ============================================================
-
-import { MCPClientBase } from './base-client.ts';
-import type { MCPServerConfig } from './types.ts';
-import { resolveProxyAgentForCategory } from './proxy-agent.ts';
-import type { Dispatcher } from 'undici';
-
-export class HttpMCPClient extends MCPClientBase {
-  private endpoint = '';
-  private sessionId?: string;
-  private dispatcher?: Dispatcher;
-  /** 用户自定义请求头（如 Authorization） */
-  private customHeaders?: Record<string, string>;
-  /** 结构化鉴权配置 */
-  private authConfig?: { type: string; value: string; name?: string };
-
-  protected async doConnect(config: MCPServerConfig): Promise<void> {
-    if (!config.endpoint) {
-      throw new Error(`${config.transport} transport requires an "endpoint" URL in config`);
-    }
-    this.endpoint = config.endpoint;
-    this.dispatcher = resolveProxyAgentForCategory(config.proxyCategory, 'MCP:HTTP');
-    this.customHeaders = config.headers;
-    this.authConfig = config.auth;
-  }
-
-  protected doDisconnect(): void {
-    this.endpoint = '';
-    this.sessionId = undefined;
-    this.customHeaders = undefined;
-    this.authConfig = undefined;
-    if (this.dispatcher && typeof (this.dispatcher as any).close === 'function') {
-      (this.dispatcher as any).close().catch(() => {});
-    }
-    this.dispatcher = undefined;
-  }
-
-  /** 根据 auth 配置生成鉴权请求头 */
-  private buildAuthHeaders(): Record<string, string> {
-    if (!this.authConfig) return {};
-    const { type, value, name } = this.authConfig;
-    switch (type) {
-      case 'bearer':
-        return { Authorization: `Bearer ${value}` };
-      case 'basic':
-        // value 已是 base64(user:pass) 编码
-        return { Authorization: `Basic ${value}` };
-      case 'apiKey':
-        return { [name || 'X-API-Key']: value };
-      case 'custom':
-        return { [name || 'X-Custom-Auth']: value };
-      default:
-        return {};
-    }
-  }
-
-  protected send(request: { jsonrpc: string; id: number; method: string; params?: Record<string, unknown> }): void {
-    // 通知（id=0）不需要响应，用 fire-and-forget
-    const isNotification = request.id === 0;
-
-    const headers: Record<string, string> = {
-      'Content-Type': 'application/json',
-      'Accept': 'application/json, text/event-stream',
-    };
-
-    // MCP SSE/StreamableHTTP 传输可能返回 session id
-    if (this.sessionId) {
-      headers['Mcp-Session-Id'] = this.sessionId;
-    }
-
-    // 注入结构化鉴权头（优先于自定义 headers，确保鉴权不被覆盖）
-    Object.assign(headers, this.buildAuthHeaders());
-
-    // 注入用户自定义请求头（最后注入，允许覆盖默认值）
-    if (this.customHeaders) {
-      Object.assign(headers, this.customHeaders);
-    }
-
-    const body = JSON.stringify(request);
-
-    // 使用 fetch（Node 18+ 内置），注入 proxy dispatcher
-    fetch(this.endpoint, {
-      method: 'POST',
-      headers,
-      body,
-      signal: isNotification ? AbortSignal.timeout(10000) : undefined,
-      ...(this.dispatcher ? { dispatcher: this.dispatcher } : {}),
-    } as RequestInit).then(async (res) => {
-      if (isNotification) return;
-
-      // 捕获 session id
-      const sessionId = res.headers.get('mcp-session-id');
-      if (sessionId) this.sessionId = sessionId;
-
-      // 检查 HTTP 错误状态码
-      if (!res.ok) {
-        const errBody = await res.text().catch(() => '');
-        console.error(`[MCP:HTTP] Server returned ${res.status} ${res.statusText} for id=${request.id}: ${errBody.substring(0, 500)}`);
-        this.handleResponse({
-          jsonrpc: '2.0',
-          id: request.id,
-          error: { code: -32000, message: `HTTP ${res.status}: ${errBody.substring(0, 200)}` },
-        });
-        return;
-      }
-
-      const contentType = res.headers.get('content-type') || '';
-
-      if (contentType.includes('text/event-stream')) {
-        // SSE 响应：解析事件流中的 JSON-RPC 响应
-        const text = await res.text();
-        this.parseSSE(text);
-      } else {
-        // 普通 JSON 响应
-        const data = await res.json();
-        this.handleResponse(data);
-      }
-    }).catch((err) => {
-      if (isNotification) return;
-      // 通知 handleResponse 超时由 pending 的 timer 负责
-      // 此处仅打日志
-      if (!isNotification) {
-        console.debug(`[MCP:HTTP] Request failed for id=${request.id}:`, err.message);
-      }
-    });
-  }
-
-  /** 解析 SSE 文本块中的 JSON-RPC 响应 */
-  private parseSSE(text: string): void {
-    // 支持 \r\n 和 \n 行分隔符
-    const lines = text.replace(/\r\n/g, '\n').split('\n');
-    for (const line of lines) {
-      if (line.startsWith('data:')) {
-        const jsonStr = line.slice(5).trim();
-        if (!jsonStr) continue;
-        try {
-          const data = JSON.parse(jsonStr);
-          if (data.id !== undefined && data.id !== 0) {
-            this.handleResponse(data);
-          }
-        } catch {
-          // 非 JSON data 忽略
-        }
-      }
-    }
-  }
-}

package/src/mcp/proxy-agent.ts

@@ -1,227 +0,0 @@
-// ============================================================
-// Proxy Agent — 通用 HTTP/HTTPS/SOCKS 代理解析工具
-// ============================================================
-
-import { ProxyAgent, type Dispatcher } from 'undici';
-import { SocksProxyAgent } from 'socks-proxy-agent';
-import { execSync } from 'child_process';
-
-// ---- 代理模式类型 ----
-
-/** 代理模式：system=系统代理, custom=自定义, direct=直连 */
-export type ProxyMode = 'system' | 'custom' | 'direct';
-
-/** 单分类代理配置 */
-export interface ProxyCategoryConfig {
-  mode: ProxyMode;
-  /** mode='custom' 时的代理 URL */
-  url?: string;
-}
-
-/** 分类代理设置（LLM / MCP / Fetch 各自独立） */
-export interface ProxySettings {
-  llm: ProxyCategoryConfig;
-  mcp: ProxyCategoryConfig;
-  fetch: ProxyCategoryConfig;
-}
-
-/** 默认代理设置：全部分类走系统代理 */
-export const DEFAULT_PROXY_SETTINGS: ProxySettings = {
-  llm: { mode: 'system' },
-  mcp: { mode: 'system' },
-  fetch: { mode: 'system' },
-};
-
-// ---- macOS 系统代理检测 ----
-
-/**
- * 从 macOS 系统偏好设置读取代理配置
- * 通过 scutil --proxy 查询，仅 macOS 平台生效
- */
-function getMacOSSystemProxy(): string | undefined {
-  if (process.platform !== 'darwin') return undefined;
-
-  try {
-    const output = execSync('scutil --proxy', { encoding: 'utf-8', timeout: 3000 });
-    const parsed: Record<string, string> = {};
-    // scutil 输出格式: "  Key : Value"
-    for (const line of output.split('\n')) {
-      const m = line.trim().match(/^(\w+)\s*:\s*(.+)$/);
-      if (m) parsed[m[1]] = m[2].trim();
-    }
-
-    // 优先 HTTPS 代理，其次 HTTP 代理，最后 SOCKS 代理
-    if (parsed['HTTPSEnable'] === '1' && parsed['HTTPSProxy']) {
-      const port = parsed['HTTPSPort'] || '443';
-      const url = `http://${parsed['HTTPSProxy']}:${port}`;
-      console.debug(`[Proxy] macOS system HTTPS proxy detected: ${url}`);
-      return url;
-    }
-    if (parsed['HTTPEnable'] === '1' && parsed['HTTPProxy']) {
-      const port = parsed['HTTPPort'] || '80';
-      const url = `http://${parsed['HTTPProxy']}:${port}`;
-      console.debug(`[Proxy] macOS system HTTP proxy detected: ${url}`);
-      return url;
-    }
-    if (parsed['SOCKSEnable'] === '1' && parsed['SOCKSProxy']) {
-      const port = parsed['SOCKSPort'] || '1080';
-      const url = `socks5://${parsed['SOCKSProxy']}:${port}`;
-      console.debug(`[Proxy] macOS system SOCKS proxy detected: ${url}`);
-      return url;
-    }
-
-    return undefined;
-  } catch {
-    return undefined;
-  }
-}
-
-// ---- Windows 系统代理检测 ----
-
-let _cachedSystemProxy: string | undefined | null = null;
-
-/**
- * 从 Windows 注册表读取系统代理配置
- * 仅 Windows 平台生效，其他平台返回 undefined
- * 结果缓存，避免重复查询注册表
- */
-export function getWindowsSystemProxy(): string | undefined {
-  if (_cachedSystemProxy !== null) return _cachedSystemProxy || undefined;
-
-  if (process.platform !== 'win32') {
-    _cachedSystemProxy = undefined;
-    return undefined;
-  }
-
-  try {
-    const regPath = 'HKCU\\Software\\Microsoft\\Windows\\CurrentVersion\\Internet Settings';
-    const output = execSync(`reg query "${regPath}" /v ProxyEnable`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
-    const enabledMatch = output.match(/ProxyEnable\s+REG_DWORD\s+0x(\d+)/i);
-    if (!enabledMatch || enabledMatch[1] === '0') {
-      _cachedSystemProxy = undefined;
-      return undefined;
-    }
-
-    const serverOutput = execSync(`reg query "${regPath}" /v ProxyServer`, { encoding: 'utf-8', timeout: 3000, windowsHide: true });
-    const serverMatch = serverOutput.match(/ProxyServer\s+REG_SZ\s+(.+)/i);
-    if (!serverMatch) {
-      _cachedSystemProxy = undefined;
-      return undefined;
-    }
-
-    const proxyServer = serverMatch[1].trim();
-    // Windows 代理可能是 ip:port 格式，需要补全协议
-    const proxyUrl = proxyServer.includes('://') ? proxyServer : `http://${proxyServer}`;
-    _cachedSystemProxy = proxyUrl;
-    console.debug(`[Proxy] Windows system proxy detected: ${proxyUrl}`);
-    return proxyUrl;
-  } catch {
-    _cachedSystemProxy = undefined;
-    return undefined;
-  }
-}
-
-/** 清除系统代理缓存（设置变更时可调用） */
-export function clearSystemProxyCache(): void {
-  _cachedSystemProxy = null;
-}
-
-/**
- * 获取系统代理 URL
- * 优先级：环境变量 HTTPS_PROXY / HTTP_PROXY / ALL_PROXY > macOS scutil > Windows 注册表
- */
-export function getSystemProxyUrl(): string | undefined {
-  return process.env.HTTPS_PROXY
-    || process.env.https_proxy
-    || process.env.HTTP_PROXY
-    || process.env.http_proxy
-    || process.env.ALL_PROXY
-    || process.env.all_proxy
-    || getMacOSSystemProxy()
-    || getWindowsSystemProxy();
-}
-
-// ---- Dispatcher 创建 ----
-
-/**
- * 根据代理 URL 创建对应的 dispatcher
- *
- * 自动识别协议：
- * - `http://proxy:8080`  → undici ProxyAgent（HTTP 代理）
- * - `https://proxy:8443` → undici ProxyAgent（HTTPS 代理）
- * - `socks5://proxy:1080`→ SocksProxyAgent（SOCKS5）
- * - `socks4://proxy:1080`→ SocksProxyAgent（SOCKS4）
- *
- * @returns dispatcher 实例，无代理时返回 undefined
- */
-function createDispatcherFromUrl(proxyUrl: string, label = 'Proxy'): Dispatcher | undefined {
-  if (proxyUrl.startsWith('socks')) {
-    console.debug(`[${label}] using SOCKS proxy: ${proxyUrl}`);
-    return new SocksProxyAgent(proxyUrl) as unknown as Dispatcher;
-  }
-
-  console.debug(`[${label}] using HTTP proxy: ${proxyUrl}`);
-  return new ProxyAgent(proxyUrl);
-}
-
-// ---- 新版分类代理解析 ----
-
-/**
- * 根据分类代理配置创建 dispatcher
- *
- * - `mode='system'`：自动检测系统代理（环境变量 + Windows 注册表）
- * - `mode='custom'`：使用用户指定的代理 URL
- * - `mode='direct'`：不走代理，返回 undefined
- *
- * @param category 分类代理配置
- * @param label 日志标签（如 'LLM', 'MCP', 'Fetch'）
- * @returns dispatcher 实例，无代理时返回 undefined
- */
-export function resolveProxyAgentForCategory(
-  category?: ProxyCategoryConfig,
-  label = 'Proxy',
-): Dispatcher | undefined {
-  if (!category) return undefined;
-
-  switch (category.mode) {
-    case 'direct':
-      console.debug(`[${label}] proxy mode: direct (no proxy)`);
-      return undefined;
-
-    case 'custom':
-      if (!category.url) {
-        console.debug(`[${label}] proxy mode: custom but no URL configured, falling back to direct`);
-        return undefined;
-      }
-      return createDispatcherFromUrl(category.url, label);
-
-    case 'system':
-    default: {
-      const systemUrl = getSystemProxyUrl();
-      if (!systemUrl) {
-        console.debug(`[${label}] proxy mode: system, no system proxy detected`);
-        return undefined;
-      }
-      return createDispatcherFromUrl(systemUrl, label);
-    }
-  }
-}
-
-/**
- * 获取分类代理的有效 URL（用于 axios 等不支持 undici Dispatcher 的场景）
- *
- * @returns 代理 URL 字符串，无代理时返回 undefined
- */
-export function resolveProxyUrlForCategory(category?: ProxyCategoryConfig): string | undefined {
-  if (!category) return undefined;
-
-  switch (category.mode) {
-    case 'direct':
-      return undefined;
-    case 'custom':
-      return category.url || undefined;
-    case 'system':
-    default:
-      return getSystemProxyUrl();
-  }
-}

package/src/mcp/stdio-client.ts

@@ -1,104 +0,0 @@
-// ============================================================
-// StdioMCPClient — 通过子进程 stdio 通信的 MCP 客户端
-// ============================================================
-
-import { spawn, type ChildProcess } from 'child_process';
-import { MCPClientBase } from './base-client.ts';
-import type { MCPServerConfig } from './types.ts';
-
-export class StdioMCPClient extends MCPClientBase {
-  private process: ChildProcess | null = null;
-  private buffer = '';
-
-  protected async doConnect(config: MCPServerConfig): Promise<void> {
-    if (!config.command) {
-      throw new Error('stdio transport requires a "command" in config');
-    }
-
-    return new Promise<void>((resolve, reject) => {
-      const child = spawn(config.command!, config.args || [], {
-        env: { ...process.env, ...(config.env || {}) },
-        stdio: ['pipe', 'pipe', 'pipe'],
-      });
-
-      this.process = child;
-
-      // 超时检查
-      const timer = setTimeout(() => {
-        reject(new Error(`stdio MCP server '${config.name}' failed to start within 10s`));
-      }, 10000);
-
-      child.on('spawn', () => {
-        clearTimeout(timer);
-        resolve();
-      });
-
-      child.on('error', (err) => {
-        clearTimeout(timer);
-        reject(new Error(`Failed to start MCP server '${config.name}': ${err.message}`));
-      });
-
-      // stdout 接收 JSON-RPC 响应（逐行）
-      child.stdout?.on('data', (chunk: Buffer) => {
-        this.buffer += chunk.toString();
-        this.flushBuffer();
-      });
-
-      // stderr 用于日志
-      child.stderr?.on('data', (chunk: Buffer) => {
-        const msg = chunk.toString().trim();
-        if (msg) console.debug(`[MCP:${config.name}] ${msg}`);
-      });
-
-      child.on('exit', (code) => {
-        if (this.connected) {
-          console.warn(`[MCP:${config.name}] process exited with code ${code}`);
-          this.connected = false;
-        }
-      });
-    });
-  }
-
-  protected doDisconnect(): void {
-    if (this.process) {
-      this.process.kill('SIGTERM');
-      this.process = null;
-    }
-    this.buffer = '';
-  }
-
-  protected send(request: { jsonrpc: string; id: number; method: string; params?: Record<string, unknown> }): void {
-    if (!this.process?.stdin?.writable) {
-      throw new Error('MCP stdio process is not writable');
-    }
-    // 通知 (id=0) 不发 content-length，用 JSON-RPC notification 格式
-    if (request.id === 0) {
-      const msg = JSON.stringify({ jsonrpc: request.jsonrpc, method: request.method, params: request.params });
-      this.process.stdin.write(msg + '\n');
-      return;
-    }
-    const msg = JSON.stringify(request);
-    this.process.stdin.write(msg + '\n');
-  }
-
-  // ---- 内部 ----
-
-  private flushBuffer(): void {
-    const lines = this.buffer.split('\n');
-    this.buffer = lines.pop() || ''; // 最后一行可能不完整
-
-    for (const line of lines) {
-      const trimmed = line.trim();
-      if (!trimmed) continue;
-      try {
-        const data = JSON.parse(trimmed);
-        // 只处理有 id 的响应（非 notification）
-        if (data.id !== undefined && data.id !== 0) {
-          this.handleResponse(data);
-        }
-      } catch {
-        // 非 JSON 行忽略
-      }
-    }
-  }
-}

package/src/mcp/types.ts

@@ -1,65 +0,0 @@
-// ============================================================
-// MCP Client 类型定义
-// ============================================================
-
-import type { ToolDefinition } from '../tool/types.ts';
-import type { ProxyCategoryConfig } from './proxy-agent.ts';
-
-// ---- MCPServerConfig ----
-
-export type MCPTransport = 'stdio' | 'http' | 'sse' | 'streamableHttp' | (string & {});
-
-export interface MCPServerConfig {
-  name: string;
-  transport: MCPTransport;
-  /** stdio 模式：启动命令 */
-  command?: string;
-  /** stdio 模式：命令参数 */
-  args?: string[];
-  /** stdio 模式：环境变量 */
-  env?: Record<string, string>;
-  /** HTTP/SSE/StreamableHTTP 模式：服务端点 */
-  endpoint?: string;
-  /** HTTP/SSE/StreamableHTTP 模式：自定义请求头（如 Authorization） */
-  headers?: Record<string, string>;
-  /** HTTP/SSE/StreamableHTTP 模式：结构化鉴权配置（bearer/basic/apiKey/custom） */
-  auth?: { type: 'bearer' | 'basic' | 'apiKey' | 'custom'; value: string; name?: string };
-  /** 请求超时（毫秒） */
-  timeout?: number;
-  /** 自动重连配置 */
-  autoReconnect?: boolean | { maxRetries?: number; interval?: number };
-  /**
-   * 分类代理配置（支持 system / custom / direct 三种模式）
-   *
-   * 由上层应用（如 workspace settings）传入对应的 ProxyCategoryConfig，
-   * 客户端根据 mode 自动创建 dispatcher。
-   */
-  proxyCategory?: ProxyCategoryConfig;
-  /** 扩展配置（自定义 transport 的专属数据统一放在此处） */
-  extra?: Record<string, unknown>;
-}
-
-// ---- MCPClient 接口 ----
-
-export interface MCPClient {
-  /** 连接 MCP 服务 */
-  connect(config: MCPServerConfig): Promise<void>;
-
-  /** 发现远程工具列表 */
-  listTools(): Promise<ToolDefinition[]>;
-
-  /** 调用远程工具 */
-  callTool(name: string, args: Record<string, unknown>): Promise<string>;
-
-  /** 发现远程资源列表（可选能力） */
-  listResources?(): Promise<Array<{ uri: string; name: string; description?: string }>>;
-
-  /** 读取远程资源（可选能力） */
-  readResource?(uri: string): Promise<string>;
-
-  /** 断开连接 */
-  disconnect(): void;
-
-  /** 连接状态 */
-  isConnected(): boolean;
-}

package/src/memory/checkpoint.ts

@@ -1,146 +0,0 @@
-// ============================================================
-// MemoryCheckpoint — 记忆管道检查点
-// ============================================================
-// 记录管道调度器的执行状态，避免重复处理：
-// - 上次 L2 聚合时的 L1 条目数
-// - 上次 L3 生成时的 L2 条目数
-// - 最后执行时间
-
-import * as fs from 'fs';
-import * as path from 'path';
-
-/** 检查点数据 */
-export interface CheckpointData {
-  /** 上次 L2 聚合时的 L1 条目总数 */
-  lastL1Count: number;
-  /** 上次 L3 生成时的 L2 条目总数 */
-  lastL2Count: number;
-  /** 最后执行时间（ISO 字符串） */
-  lastRunAt: string;
-  /** 累计执行次数 */
-  runCount: number;
-}
-
-const DEFAULT_CHECKPOINT: CheckpointData = {
-  lastL1Count: 0,
-  lastL2Count: 0,
-  lastRunAt: '',
-  runCount: 0,
-};
-
-/** 默认检查点文件路径（基于 process.cwd()） */
-const DEFAULT_CHECKPOINT_PATH = 'data/memories/checkpoint.json';
-
-/**
- * 记忆管道检查点
- * 
- * 用于管道调度器判断是否需要触发 L2/L3：
- * - 当 L1 增量（当前 - lastL1Count）达到阈值时触发 L2
- * - 当 L2 增量（当前 - lastL2Count）达到阈值时触发 L3
- */
-export class MemoryCheckpoint {
-  private filePath: string;
-  private data: CheckpointData;
-
-  /**
-   * @param filePath 检查点文件路径，默认为 {cwd}/data/memories/checkpoint.json
-   */
-  constructor(filePath?: string) {
-    this.filePath = filePath ?? path.join(process.cwd(), DEFAULT_CHECKPOINT_PATH);
-    this.data = this.load();
-  }
-
-  /** 获取当前检查点数据 */
-  get(): CheckpointData {
-    return { ...this.data };
-  }
-
-  /**
-   * 判断是否应触发 L2 聚合
-   * @param currentL1Count 当前 L1 条目总数
-   * @param threshold L2 触发阈值
-   */
-  shouldTriggerL2(currentL1Count: number, threshold: number): boolean {
-    return (currentL1Count - this.data.lastL1Count) >= threshold;
-  }
-
-  /**
-   * 判断是否应触发 L3 画像更新
-   * @param currentL2Count 当前 L2 条目总数
-   * @param threshold L3 触发阈值
-   */
-  shouldTriggerL3(currentL2Count: number, threshold: number): boolean {
-    return (currentL2Count - this.data.lastL2Count) >= threshold;
-  }
-
-  /**
-   * 更新检查点（L2 聚合完成后调用）
-   */
-  updateL2(currentL1Count: number): void {
-    this.data.lastL1Count = currentL1Count;
-    this.data.lastRunAt = new Date().toISOString();
-    this.data.runCount++;
-    this.persist();
-  }
-
-  /**
-   * 更新检查点（L3 画像完成后调用）
-   */
-  updateL3(currentL2Count: number): void {
-    this.data.lastL2Count = currentL2Count;
-    this.data.lastRunAt = new Date().toISOString();
-    this.persist();
-  }
-
-  /**
-   * 重置检查点（用于手动触发全量重建）
-   */
-  reset(): void {
-    this.data = { ...DEFAULT_CHECKPOINT };
-    this.persist();
-  }
-
-  private load(): CheckpointData {
-    try {
-      if (fs.existsSync(this.filePath)) {
-        const raw = fs.readFileSync(this.filePath, 'utf-8');
-        const data = JSON.parse(raw) as CheckpointData;
-        return { ...DEFAULT_CHECKPOINT, ...data };
-      }
-    } catch (err) {
-      console.warn('[MemoryCheckpoint] Failed to load:', err);
-    }
-    return { ...DEFAULT_CHECKPOINT };
-  }
-
-  private persist(): void {
-    try {
-      const dir = path.dirname(this.filePath);
-      if (!fs.existsSync(dir)) {
-        fs.mkdirSync(dir, { recursive: true });
-      }
-      fs.writeFileSync(this.filePath, JSON.stringify(this.data, null, 2), 'utf-8');
-    } catch (err) {
-      console.warn('[MemoryCheckpoint] Failed to persist:', err);
-    }
-  }
-}
-
-/** 全局单例（可配置路径） */
-let checkpointInstance: MemoryCheckpoint | null = null;
-
-/**
- * 获取全局检查点实例
- * @param filePath 可选，首次调用时指定自定义路径
- */
-export function getMemoryCheckpoint(filePath?: string): MemoryCheckpoint {
-  if (!checkpointInstance) {
-    checkpointInstance = new MemoryCheckpoint(filePath);
-  }
-  return checkpointInstance;
-}
-
-/** 重置全局实例（用于测试或路径变更场景） */
-export function resetMemoryCheckpoint(): void {
-  checkpointInstance = null;
-}