@worldzb/agent-sync 1.4.0

package/dist/commands/integrations.js

@@ -0,0 +1,77 @@
+import { confirm, isCancel } from '@clack/prompts';
+import chalk from 'chalk';
+export function registerIntegrationsCommand(program, context) {
+    program
+        .command('integrations')
+        .alias('manage')
+        .description('🧩 查看和管理 Agent 的插件、Skills 与 MCP')
+        .option('-a, --agent <agent>', '筛选 Agent：claude、codex、opencode')
+        .option('--project <path>', '包含项目级配置')
+        .option('--install-plugin <plugin>', '安装插件')
+        .option('--remove <agent:kind:name>', '移除资源')
+        .option('--scope <scope>', '安装范围：user、project', 'user')
+        .action(async (options) => {
+        validateAgent(options.agent);
+        validateScope(options.scope);
+        if (options.installPlugin) {
+            const agent = requireAgent(options.agent);
+            const accepted = await confirm({
+                message: `为 ${agent} ${options.scope === 'project' ? '项目范围' : '用户范围'}安装插件 "${options.installPlugin}"？`,
+                initialValue: false,
+            });
+            if (isCancel(accepted) || !accepted)
+                return;
+            context.agents.get(agent).installPlugin(options.installPlugin, options.scope || 'user');
+            console.log(chalk.green('插件安装命令已完成。'));
+            return;
+        }
+        if (options.remove) {
+            const item = findIntegration(context, options.remove, options.project);
+            const accepted = await confirm({ message: `移除 ${item.agent} ${item.kind} "${item.name}"？`, initialValue: false });
+            if (isCancel(accepted) || !accepted)
+                return;
+            context.agents.get(item.agent).removeIntegration(item);
+            console.log(chalk.green('资源已移除。'));
+            return;
+        }
+        listIntegrations(context, options.agent, options.project);
+    });
+}
+function listIntegrations(context, filter, project) {
+    const adapters = filter ? [context.agents.get(filter)] : context.agents.all();
+    adapters.forEach((adapter) => {
+        const items = adapter.listIntegrations(project);
+        console.log(chalk.bold(`\n${adapter.name}`));
+        if (!items.length) {
+            console.log(chalk.gray('  未发现 plugins、skills 或 MCP。'));
+            return;
+        }
+        items.forEach((item) => console.log(`  [${item.kind}] ${item.name} · ${item.scope} · ${item.location}`));
+    });
+}
+function findIntegration(context, value, project) {
+    const [agent, kind, ...nameParts] = value.split(':');
+    const name = nameParts.join(':');
+    if (!agent || !kind || !name)
+        throw new Error('--remove 应为 <agent>:<kind>:<name>。');
+    validateAgent(agent);
+    const item = context.agents.get(agent).listIntegrations(project).find((candidate) => candidate.kind === kind && candidate.name === name);
+    if (!item)
+        throw new Error(`未找到资源：${value}`);
+    if (!item.removable)
+        throw new Error(`当前版本不支持移除：${value}`);
+    return item;
+}
+function requireAgent(agent) {
+    if (!agent)
+        throw new Error('安装插件时必须通过 --agent 指定目标 Agent。');
+    return agent;
+}
+function validateAgent(agent) {
+    if (agent && !['claude', 'codex', 'opencode'].includes(agent))
+        throw new Error('Agent 必须为 claude、codex 或 opencode。');
+}
+function validateScope(scope) {
+    if (scope && scope !== 'user' && scope !== 'project')
+        throw new Error('scope 必须为 user 或 project。');
+}

package/dist/commands/list.js

@@ -0,0 +1,31 @@
+import chalk from 'chalk';
+import { findActiveConfig, readClaudeSettings } from '../claude/settings.js';
+import { maskApiKey } from '../ui/output.js';
+export function registerListCommand(program, context) {
+    program
+        .command('list')
+        .alias('ls')
+        .description('📋 列出所有 Claude 配置')
+        .action(() => listConfigs(context));
+}
+function listConfigs(context) {
+    const data = context.repository.read();
+    if (data.configs.length === 0) {
+        console.log(chalk.yellow('暂无配置，请先添加配置。'));
+        return;
+    }
+    const activeConfig = findActiveConfig(data.configs, readClaudeSettings(context.claudeSettingsFile));
+    console.log(chalk.bold('\n📋 可用配置：\n'));
+    data.configs.forEach((config) => {
+        const isActive = activeConfig?.name === config.name;
+        const isDefault = data.current === config.name;
+        const icon = isActive ? '🟢' : isDefault ? '🔵' : '⚪';
+        const status = isActive
+            ? (isDefault ? chalk.green(' (当前默认)') : chalk.yellow(' (使用中)'))
+            : (isDefault ? chalk.gray(' (已设为默认)') : '');
+        console.log(`${icon}  ${chalk.hex('#7C3AED')('[Claude]')} ${chalk.bold(config.name)}${status}`);
+        console.log(`   🔑 API Key: ${chalk.gray(maskApiKey(config.apiKey))}`);
+        console.log(`   🌐 Base URL: ${chalk.blue(config.baseUrl)}`);
+        console.log('');
+    });
+}

package/dist/commands/migrate.js

@@ -0,0 +1,42 @@
+import { cancel, confirm, isCancel, select } from '@clack/prompts';
+import chalk from 'chalk';
+import { parseSessionId } from '../history/session-service.js';
+import { migrateAndLaunch } from './history.js';
+export function registerMigrateCommand(program, context) {
+    program
+        .command('migrate <session>')
+        .description('🔀 将历史会话转换为新 Agent 会话')
+        .option('--to <agent>', '目标 Agent：claude、codex、opencode')
+        .action(async (sessionId, options) => {
+        const parsed = parseSessionId(sessionId);
+        const source = context.agents.get(parsed.agent).listSessions().find((session) => session.id === parsed.id);
+        if (!source)
+            throw new Error(`未找到会话：${sessionId}`);
+        const target = options.to || await select({
+            message: '选择目标 Agent',
+            initialValue: parsed.agent,
+            options: context.agents.all().filter((adapter) => adapter.discover().installed).map((adapter) => ({ value: adapter.id, label: adapter.name })),
+        });
+        if (isCancel(target))
+            return void cancel('已取消迁移');
+        validateAgent(target);
+        const result = await migrateAndLaunch(context, source, target);
+        if (!result.launch) {
+            console.log(chalk.gray(result.message));
+            return;
+        }
+        const [command, ...args] = result.launch.command;
+        if (!command)
+            throw new Error('启动命令为空。');
+        console.log(chalk.gray('原会话未被修改。'));
+        const { spawnSync } = await import('node:child_process');
+        const launched = spawnSync(command, args, { cwd: result.launch.cwd, stdio: 'inherit' });
+        if (launched.error)
+            throw new Error(`无法启动 ${command}：${launched.error.message}`);
+    });
+}
+function validateAgent(agent) {
+    if (!['claude', 'codex', 'opencode'].includes(agent)) {
+        throw new Error('目标 Agent 必须为 claude、codex 或 opencode。');
+    }
+}

package/dist/commands/sessions.js

@@ -0,0 +1,52 @@
+import { confirm, isCancel } from '@clack/prompts';
+import chalk from 'chalk';
+import { describeManagedSession } from '../sessions/session-monitor.js';
+export function registerSessionsCommand(program, context) {
+    program
+        .command('sessions')
+        .description('📡 查看 zmai 启动的托管会话')
+        .option('--watch <id>', '显示托管会话的最新状态和输出')
+        .option('--stop <id>', '停止托管会话')
+        .action(async (options) => {
+        if (options.watch) {
+            showSession(context, options.watch);
+            return;
+        }
+        if (options.stop) {
+            const accepted = await confirm({ message: `停止托管会话 "${options.stop}"？`, initialValue: false });
+            if (isCancel(accepted) || !accepted)
+                return;
+            context.sessionLauncher.stop(context.managedSessions.get(options.stop));
+            console.log(chalk.green('托管会话已停止。'));
+            return;
+        }
+        const sessions = context.managedSessions.read();
+        if (!sessions.length) {
+            console.log(chalk.yellow('暂无由 zmai 启动的托管会话。'));
+            return;
+        }
+        sessions.forEach((session) => {
+            const status = context.sessionLauncher.status(session);
+            console.log(`${status === 'running' ? '🟢' : '⚪'} ${session.id} [${session.agent}] ${status}`);
+            console.log(`   ${session.cwd} · ${session.createdAt}`);
+        });
+    });
+    program
+        .command('watch <id>')
+        .description('👀 查看托管会话进度和最新输出')
+        .action((id) => showSession(context, id));
+    program
+        .command('stop <id>')
+        .description('⏹ 停止托管会话')
+        .action(async (id) => {
+        const accepted = await confirm({ message: `停止托管会话 "${id}"？`, initialValue: false });
+        if (isCancel(accepted) || !accepted)
+            return;
+        context.sessionLauncher.stop(context.managedSessions.get(id));
+        console.log(chalk.green('托管会话已停止。'));
+    });
+}
+function showSession(context, id) {
+    const session = context.managedSessions.get(id);
+    console.log(describeManagedSession(session, context.sessionLauncher));
+}

package/dist/commands/switch.js

@@ -0,0 +1,93 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { cancel, intro, isCancel, note, outro, select } from '@clack/prompts';
+import chalk from 'chalk';
+import { applyDefaultConfig, createTemporaryExports, readClaudeSettings, writeClaudeSettings, } from '../claude/settings.js';
+import { getConfig, setCurrentConfig } from '../config/config-data.js';
+import { maskApiKey, printSuccess } from '../ui/output.js';
+export function registerSwitchCommand(program, context) {
+    program
+        .command('switch')
+        .alias('use')
+        .description('🔄 切换 Claude API 配置')
+        .option('-i, --interactive', '交互式选择')
+        .option('-n, --name <name>', '配置名称')
+        .option('-t, --temp', '临时使用（仅当前终端）')
+        .option('-d, --default', '设为默认（修改 .claude/settings.json）')
+        .option('-e, --eval', '输出 eval 可执行的命令（配合 -t 使用）')
+        .action(async (options) => {
+        if (options.eval && !options.temp) {
+            throw new Error('--eval 只能与 --temp 一起使用。');
+        }
+        if (options.interactive || !options.name) {
+            await interactiveSwitch(context, options);
+            return;
+        }
+        switchNamedConfig(context, options.name, options.temp === true, options.eval === true);
+    });
+}
+async function interactiveSwitch(context, options) {
+    if (options.eval) {
+        throw new Error('--eval 不能与交互式模式一起使用。');
+    }
+    console.clear();
+    intro(chalk.cyan.bold('🔄 Claude API Switcher - 切换配置'));
+    const data = context.repository.read();
+    if (data.configs.length === 0) {
+        return void outro(chalk.yellow('暂无配置，请先添加配置。'));
+    }
+    const selected = await select({
+        message: '选择要切换的配置',
+        options: data.configs.map((config) => ({
+            value: config.name,
+            label: `${config.name}${data.current === config.name ? ' (当前默认)' : ''}`,
+            hint: maskApiKey(config.apiKey),
+        })),
+    });
+    if (isCancel(selected))
+        return void cancel('操作已取消');
+    const selectedName = String(selected);
+    const mode = options.temp || options.default
+        ? (options.temp ? 'temp' : 'default')
+        : await select({
+            message: '选择切换模式',
+            options: [
+                { value: 'temp', label: '🔹 临时使用（仅当前终端）', hint: '不影响默认配置' },
+                { value: 'default', label: '🟢 设为默认（全局配置）', hint: '修改 Claude 设置，需要重启' },
+            ],
+        });
+    if (isCancel(mode))
+        return void cancel('操作已取消');
+    switchNamedConfig(context, selectedName, mode === 'temp', false);
+    outro('');
+}
+function switchNamedConfig(context, name, temporary, evalMode) {
+    const data = context.repository.read();
+    const config = getConfig(data, name);
+    if (temporary) {
+        switchTemporary(config, evalMode);
+        return;
+    }
+    const updatedSettings = applyDefaultConfig(readClaudeSettings(context.claudeSettingsFile), config);
+    writeClaudeSettings(context.claudeSettingsFile, updatedSettings);
+    writeEnvironmentFile(context.environmentFile, config);
+    context.repository.write(setCurrentConfig(data, name));
+    printSuccess(`已将 "${name}" 设置为默认配置`);
+    note(`配置: ${name}\nAPI Key: ${maskApiKey(config.apiKey)}\nBase URL: ${config.baseUrl}\n\n已更新：\n~/.claude/settings.json\n~/.claude-switch-config/.claude-env\n\n需要重启 Claude Code 才能生效。`, '默认配置已更新');
+}
+function switchTemporary(config, evalMode) {
+    const exports = createTemporaryExports(config);
+    if (evalMode) {
+        console.log(exports);
+        return;
+    }
+    printSuccess(`临时使用配置 "${config.name}"`);
+    console.log(chalk.cyan('\n在当前终端运行以下命令：\n'));
+    console.log(exports);
+    console.log(chalk.yellow(`\n或直接运行：\n   eval $(zmai switch -n ${JSON.stringify(config.name)} -t --eval)`));
+}
+function writeEnvironmentFile(filePath, config) {
+    fs.mkdirSync(path.dirname(filePath), { recursive: true, mode: 0o700 });
+    fs.writeFileSync(filePath, `${createTemporaryExports(config)}\n`, { encoding: 'utf8', mode: 0o600 });
+    fs.chmodSync(filePath, 0o600);
+}

package/dist/config/config-data.js

@@ -0,0 +1,85 @@
+const DEFAULT_BASE_URL = 'https://api.anthropic.com';
+export function normalizeConfigData(value) {
+    if (!isRecord(value) || !Array.isArray(value.configs)) {
+        return { configs: [], current: null };
+    }
+    const configs = value.configs
+        .filter(isRecord)
+        .filter((config) => config.target === undefined || config.target === 'claude')
+        .map(toApiConfig)
+        .filter((config) => config !== null);
+    const current = typeof value.current === 'string' && configs.some((config) => config.name === value.current)
+        ? value.current
+        : null;
+    return { configs, current };
+}
+export function addConfig(data, config) {
+    if (data.configs.some((item) => item.name === config.name)) {
+        throw new Error(`配置 "${config.name}" 已存在。`);
+    }
+    return { ...data, configs: [...data.configs, config] };
+}
+export function deleteConfig(data, name) {
+    if (!data.configs.some((config) => config.name === name)) {
+        throw new Error(`配置 "${name}" 不存在。`);
+    }
+    return {
+        configs: data.configs.filter((config) => config.name !== name),
+        current: data.current === name ? null : data.current,
+    };
+}
+export function setCurrentConfig(data, name) {
+    if (!data.configs.some((config) => config.name === name)) {
+        throw new Error(`配置 "${name}" 不存在。`);
+    }
+    return { ...data, current: name };
+}
+export function getConfig(data, name) {
+    const config = data.configs.find((item) => item.name === name);
+    if (!config) {
+        throw new Error(`配置 "${name}" 不存在。`);
+    }
+    return config;
+}
+export function createApiConfig(input) {
+    const name = input.name.trim();
+    const apiKey = input.apiKey.trim();
+    const baseUrl = (input.baseUrl || DEFAULT_BASE_URL).trim();
+    if (!name) {
+        throw new Error('请输入配置名称。');
+    }
+    if (!apiKey) {
+        throw new Error('请输入 API Key。');
+    }
+    try {
+        new URL(baseUrl);
+    }
+    catch {
+        throw new Error('Base URL 格式不正确。');
+    }
+    return {
+        name,
+        apiKey,
+        baseUrl,
+        ...(input.createdAt ? { createdAt: input.createdAt } : {}),
+    };
+}
+function toApiConfig(value) {
+    if (typeof value.name !== 'string' || typeof value.apiKey !== 'string') {
+        return null;
+    }
+    try {
+        return createApiConfig({
+            name: value.name,
+            apiKey: value.apiKey,
+            baseUrl: typeof value.baseUrl === 'string' ? value.baseUrl : DEFAULT_BASE_URL,
+            createdAt: typeof value.createdAt === 'string' ? value.createdAt : undefined,
+        });
+    }
+    catch {
+        return null;
+    }
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}

package/dist/config/config-repository.js

@@ -0,0 +1,29 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import { normalizeConfigData } from './config-data.js';
+export class ConfigRepository {
+    filePath;
+    constructor(filePath) {
+        this.filePath = filePath;
+    }
+    read() {
+        if (!fs.existsSync(this.filePath)) {
+            return { configs: [], current: null };
+        }
+        try {
+            return normalizeConfigData(JSON.parse(fs.readFileSync(this.filePath, 'utf8')));
+        }
+        catch {
+            throw new Error(`无法读取配置文件：${this.filePath}`);
+        }
+    }
+    write(data) {
+        const directory = path.dirname(this.filePath);
+        fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
+        fs.writeFileSync(this.filePath, `${JSON.stringify(normalizeConfigData(data), null, 2)}\n`, {
+            encoding: 'utf8',
+            mode: 0o600,
+        });
+        fs.chmodSync(this.filePath, 0o600);
+    }
+}

package/dist/config/paths.js

@@ -0,0 +1,16 @@
+import path from 'node:path';
+export function getAppPaths(homeDirectory = process.env.HOME || process.env.USERPROFILE) {
+    if (!homeDirectory) {
+        throw new Error('无法确定用户主目录。');
+    }
+    const configDirectory = path.join(homeDirectory, '.claude-switch-config');
+    const zmaiDirectory = path.join(homeDirectory, '.zmai');
+    return {
+        configFile: path.join(configDirectory, 'claude-configs.json'),
+        environmentFile: path.join(configDirectory, '.claude-env'),
+        claudeSettingsFile: path.join(homeDirectory, '.claude', 'settings.json'),
+        zmaiDirectory,
+        managedSessionsFile: path.join(zmaiDirectory, 'sessions.json'),
+        migrationDirectory: path.join(zmaiDirectory, 'migrations'),
+    };
+}

package/dist/config/types.js

@@ -0,0 +1 @@
+export {};

package/dist/history/session-loader-worker.js

@@ -0,0 +1,23 @@
+import { parentPort } from 'node:worker_threads';
+import { AgentRegistry } from '../agents/registry.js';
+const port = parentPort;
+if (!port) {
+    throw new Error('历史扫描 Worker 必须在 worker_threads 中运行。');
+}
+const homeDirectory = process.env.HOME || process.env.USERPROFILE;
+if (!homeDirectory) {
+    throw new Error('无法确定用户主目录。');
+}
+try {
+    const registry = new AgentRegistry(homeDirectory);
+    const sessions = registry.all().flatMap((adapter) => {
+        port.postMessage({ type: 'progress', message: `正在扫描 ${adapter.name} 的本地记录…` });
+        const result = adapter.listSessions();
+        port.postMessage({ type: 'progress', message: `${adapter.name} 扫描完成，找到 ${result.length} 条会话。` });
+        return result;
+    });
+    port.postMessage({ type: 'complete', sessions });
+}
+catch (error) {
+    port.postMessage({ type: 'error', message: error instanceof Error ? error.message : '历史扫描失败。' });
+}

package/dist/history/session-scope.js

@@ -0,0 +1,10 @@
+import path from 'node:path';
+export function filterSessionsByScope(sessions, scope, currentDirectory) {
+    if (scope === 'all')
+        return sessions;
+    const normalizedCurrentDirectory = normalizePath(currentDirectory);
+    return sessions.filter((session) => normalizePath(session.cwd) === normalizedCurrentDirectory);
+}
+function normalizePath(value) {
+    return path.resolve(value);
+}

package/dist/history/session-service.js

@@ -0,0 +1,29 @@
+export function pageSessions(sessions, options) {
+    const pageSize = Math.max(1, Math.min(options.pageSize, 100));
+    const filtered = options.agent ? sessions.filter((session) => session.agent === options.agent) : sessions;
+    const ordered = [...filtered].sort((left, right) => right.updatedAt.localeCompare(left.updatedAt));
+    const totalPages = Math.max(1, Math.ceil(ordered.length / pageSize));
+    const page = Math.max(1, Math.min(options.page, totalPages));
+    const start = (page - 1) * pageSize;
+    return {
+        items: ordered.slice(start, start + pageSize),
+        page,
+        pageSize,
+        total: ordered.length,
+        totalPages,
+    };
+}
+export function createSessionId(session) {
+    return `${session.agent}:${encodeURIComponent(session.id)}`;
+}
+export function parseSessionId(value) {
+    const separator = value.indexOf(':');
+    if (separator < 1) {
+        throw new Error('会话 ID 应为 <agent>:<session-id>。');
+    }
+    const agent = value.slice(0, separator);
+    if (!['claude', 'codex', 'opencode'].includes(agent)) {
+        throw new Error(`不支持的 Agent：${agent}`);
+    }
+    return { agent, id: decodeURIComponent(value.slice(separator + 1)) };
+}

package/dist/history/ui/formatters.js

@@ -0,0 +1,37 @@
+export function formatSessionRow(session, width) {
+    const titleWidth = Math.max(12, Math.floor(width * 0.56));
+    const cwdWidth = Math.max(12, width - titleWidth);
+    return {
+        agent: session.agent.toUpperCase(),
+        id: session.id.slice(0, 8),
+        title: truncate(session.title.replaceAll(/\s+/g, ' '), titleWidth),
+        cwd: truncatePath(session.cwd, cwdWidth),
+    };
+}
+export function relativeTime(value, now = new Date()) {
+    const elapsedSeconds = Math.max(0, Math.floor((now.valueOf() - new Date(value).valueOf()) / 1_000));
+    if (elapsedSeconds < 60)
+        return '刚刚';
+    if (elapsedSeconds < 3_600)
+        return `${Math.floor(elapsedSeconds / 60)} 分钟前`;
+    if (elapsedSeconds < 86_400)
+        return `${Math.floor(elapsedSeconds / 3_600)} 小时前`;
+    if (elapsedSeconds < 2_592_000)
+        return `${Math.floor(elapsedSeconds / 86_400)} 天前`;
+    return new Date(value).toLocaleDateString('zh-CN');
+}
+export function truncate(value, width) {
+    if (value.length <= width)
+        return value;
+    return `${value.slice(0, Math.max(0, width - 1))}…`;
+}
+export function truncatePath(value, width) {
+    if (value.length <= width)
+        return value;
+    const segments = value.split('/').filter(Boolean);
+    let result = '';
+    while (segments.length && result.length < width - 1) {
+        result = `/${segments.pop()}${result}`;
+    }
+    return truncate(`…${result}`, width);
+}