tools-cc 1.0.3 → 1.0.5

package/dist/commands/use.js

@@ -12,8 +12,10 @@ const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const project_1 = require("../core/project");
 const source_1 = require("../core/source");
+const manifest_1 = require("../core/manifest");
 const symlink_1 = require("../core/symlink");
 const path_1 = require("../utils/path");
+const parsePath_1 = require("../utils/parsePath");
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_2 = __importDefault(require("path"));
 const SUPPORTED_TOOLS = {
@@ -22,37 +24,64 @@ const SUPPORTED_TOOLS = {
     codebuddy: '.codebuddy',
     opencode: '.opencode'
 };
-async function handleUse(sourceNames, options) {
+/**
+ * 默认选择配置 - 导入所有内容
+ */
+const DEFAULT_SELECTION = {
+    skills: ['*'],
+    commands: ['*'],
+    agents: ['*']
+};
+/**
+ * 处理 use 命令
+ *
+ * 支持多种模式：
+ * 1. 配置导入模式: tools-cc use -c config.json
+ * 2. 交互选择模式: tools-cc use my-source -ls
+ * 3. 路径语法模式: tools-cc use my-source/skills/a-skill
+ * 4. 整体导入模式: tools-cc use my-source
+ * 5. 点模式: tools-cc use . (使用已配置源)
+ */
+async function handleUse(sourceSpecs, options) {
     const projectDir = process.cwd();
-    // 如果没有指定 source，进入交互模式
-    if (sourceNames.length === 0) {
-        const sources = await (0, source_1.listSources)(path_1.GLOBAL_CONFIG_DIR);
-        const sourceList = Object.keys(sources);
-        if (sourceList.length === 0) {
-            console.log(chalk_1.default.yellow('No sources configured. Use `tools-cc -s add` to add one.'));
+    const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
+    const configFile = (0, path_1.getProjectConfigPath)(projectDir);
+    // 1. 配置导入模式
+    if (options.config) {
+        await handleConfigImportMode(options.config, projectDir, options.projects);
+        return;
+    }
+    // 2. 点模式：使用当前项目已配置的源
+    if (sourceSpecs.length === 1 && sourceSpecs[0] === '.') {
+        await handleDotMode(projectDir, toolsccDir, configFile, options.projects);
+        return;
+    }
+    // 3. 交互选择模式：单个源 + -ls 选项
+    if (options.ls && sourceSpecs.length === 1) {
+        const parsed = (0, parsePath_1.parseSourcePath)(sourceSpecs[0]);
+        // 只有源名称时才进入交互模式
+        if (!parsed.type && parsed.sourceName) {
+            await handleInteractiveMode(parsed.sourceName, projectDir, options.projects);
             return;
         }
-        const answers = await inquirer_1.default.prompt([
-            {
-                type: 'checkbox',
-                name: 'selectedSources',
-                message: 'Select sources to use:',
-                choices: sourceList
-            }
-        ]);
-        sourceNames = answers.selectedSources;
     }
-    if (sourceNames.length === 0) {
-        console.log(chalk_1.default.gray('No sources selected.'));
-        return;
+    // 4. 无参数时显示源选择列表
+    if (sourceSpecs.length === 0) {
+        sourceSpecs = await selectSourcesInteractively();
+        if (sourceSpecs.length === 0) {
+            console.log(chalk_1.default.gray('No sources selected.'));
+            return;
+        }
     }
+    // 5. 解析路径语法并构建选择配置
+    const selectionMap = (0, parsePath_1.buildSelectionFromPaths)(sourceSpecs);
     // 初始化项目
     await (0, project_1.initProject)(projectDir);
-    // 启用每个配置源
-    for (const sourceName of sourceNames) {
+    // 应用每个源的选择配置
+    for (const [sourceName, selection] of Object.entries(selectionMap)) {
         try {
             const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
-            await (0, project_1.useSource)(sourceName, sourcePath, projectDir);
+            await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
             console.log(chalk_1.default.green(`✓ Using source: ${sourceName}`));
         }
         catch (error) {
@@ -60,8 +89,150 @@ async function handleUse(sourceNames, options) {
         }
     }
     // 创建符号链接
-    const tools = options.projects || Object.keys(SUPPORTED_TOOLS);
-    const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
+    await createToolLinks(projectDir, toolsccDir, configFile, options.projects);
+}
+/**
+ * 配置导入模式
+ */
+async function handleConfigImportMode(configPath, projectDir, projects) {
+    try {
+        const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
+        const configFile = (0, path_1.getProjectConfigPath)(projectDir);
+        // 解析配置文件路径
+        const resolvedPath = path_2.default.resolve(configPath);
+        // 定义源路径解析函数
+        const resolveSourcePath = async (sourceName) => {
+            return await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
+        };
+        // 导入配置
+        await (0, project_1.importProjectConfig)(resolvedPath, projectDir, resolveSourcePath);
+        console.log(chalk_1.default.green(`✓ Imported config from: ${resolvedPath}`));
+        // 创建符号链接
+        await createToolLinks(projectDir, toolsccDir, configFile, projects);
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`✗ Failed to import config: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+/**
+ * 点模式：使用已配置源创建符号链接
+ */
+async function handleDotMode(projectDir, toolsccDir, configFile, projects) {
+    if (!(await fs_extra_1.default.pathExists(configFile))) {
+        console.log(chalk_1.default.yellow('Project not initialized. Run `tools-cc use <source>` first.'));
+        return;
+    }
+    const config = await fs_extra_1.default.readJson(configFile);
+    const configuredSources = Object.keys(config.sources || {});
+    if (configuredSources.length === 0) {
+        console.log(chalk_1.default.yellow('No sources configured in this project. Run `tools-cc use <source>` to add one.'));
+        return;
+    }
+    console.log(chalk_1.default.cyan(`Using existing sources: ${configuredSources.join(', ')}`));
+    await createToolLinks(projectDir, toolsccDir, configFile, projects);
+}
+/**
+ * 交互选择模式：显示技能/命令/代理选择列表
+ */
+async function handleInteractiveMode(sourceName, projectDir, projects) {
+    try {
+        const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
+        const manifest = await (0, manifest_1.scanSource)(sourcePath);
+        // 构建选项列表
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const choices = [];
+        // Skills 组
+        if (manifest.skills && manifest.skills.length > 0) {
+            choices.push(new inquirer_1.default.Separator(`--- Skills (${manifest.skills.length}) ---`));
+            for (const skill of manifest.skills) {
+                choices.push({ name: skill, value: `skills/${skill}` });
+            }
+        }
+        // Commands 组
+        if (manifest.commands && manifest.commands.length > 0) {
+            choices.push(new inquirer_1.default.Separator(`--- Commands (${manifest.commands.length}) ---`));
+            for (const cmd of manifest.commands) {
+                choices.push({ name: cmd, value: `commands/${cmd}` });
+            }
+        }
+        // Agents 组
+        if (manifest.agents && manifest.agents.length > 0) {
+            choices.push(new inquirer_1.default.Separator(`--- Agents (${manifest.agents.length}) ---`));
+            for (const agent of manifest.agents) {
+                choices.push({ name: agent, value: `agents/${agent}` });
+            }
+        }
+        if (choices.length === 0) {
+            console.log(chalk_1.default.yellow(`No items found in source: ${sourceName}`));
+            return;
+        }
+        // 显示选择列表
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'checkbox',
+                name: 'selectedItems',
+                message: `Select items from ${sourceName}:`,
+                choices,
+                pageSize: 15
+            }
+        ]);
+        if (answers.selectedItems.length === 0) {
+            console.log(chalk_1.default.gray('No items selected.'));
+            return;
+        }
+        // 将选择转换为 SourceSelection
+        const selection = {
+            skills: [],
+            commands: [],
+            agents: []
+        };
+        for (const item of answers.selectedItems) {
+            const [type, name] = item.split('/');
+            if (type === 'skills')
+                selection.skills.push(name);
+            else if (type === 'commands')
+                selection.commands.push(name);
+            else if (type === 'agents')
+                selection.agents.push(name);
+        }
+        // 初始化项目并应用选择
+        await (0, project_1.initProject)(projectDir);
+        await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
+        console.log(chalk_1.default.green(`✓ Using source: ${sourceName}`));
+        // 创建符号链接
+        const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
+        const configFile = (0, path_1.getProjectConfigPath)(projectDir);
+        await createToolLinks(projectDir, toolsccDir, configFile, projects);
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`✗ Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+/**
+ * 显示源选择列表并返回用户选择
+ */
+async function selectSourcesInteractively() {
+    const sources = await (0, source_1.listSources)(path_1.GLOBAL_CONFIG_DIR);
+    const sourceList = Object.keys(sources);
+    if (sourceList.length === 0) {
+        console.log(chalk_1.default.yellow('No sources configured. Use `tools-cc -s add` to add one.'));
+        return [];
+    }
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: 'checkbox',
+            name: 'selectedSources',
+            message: 'Select sources to use:',
+            choices: sourceList
+        }
+    ]);
+    return answers.selectedSources;
+}
+/**
+ * 创建工具符号链接
+ */
+async function createToolLinks(projectDir, toolsccDir, configFile, projects) {
+    const tools = projects || Object.keys(SUPPORTED_TOOLS);
     for (const tool of tools) {
         const linkName = SUPPORTED_TOOLS[tool];
         if (!linkName) {
@@ -78,7 +249,6 @@ async function handleUse(sourceNames, options) {
         }
     }
     // 更新项目配置
-    const configFile = (0, path_1.getProjectConfigPath)(projectDir);
     const config = await fs_extra_1.default.readJson(configFile);
     const existingLinks = config.links || [];
     config.links = [...new Set([...existingLinks, ...tools])];
@@ -141,26 +311,29 @@ async function handleProjectUpdate(sourceNames) {
         return;
     }
     const config = await fs_extra_1.default.readJson(configFile);
+    const configuredSources = Object.keys(config.sources || {});
     let sourcesToUpdate = sourceNames && sourceNames.length > 0
         ? sourceNames
-        : config.sources || [];
+        : configuredSources;
     if (sourcesToUpdate.length === 0) {
         console.log(chalk_1.default.gray('No sources to update.'));
         return;
     }
     // 验证指定的源是否存在于项目配置中
     if (sourceNames && sourceNames.length > 0) {
-        const invalidSources = sourceNames.filter((s) => !config.sources.includes(s));
+        const invalidSources = sourceNames.filter((s) => !configuredSources.includes(s));
         if (invalidSources.length > 0) {
             console.log(chalk_1.default.yellow(`Sources not in project: ${invalidSources.join(', ')}`));
         }
-        sourcesToUpdate = sourcesToUpdate.filter((s) => config.sources.includes(s));
+        sourcesToUpdate = sourcesToUpdate.filter((s) => configuredSources.includes(s));
     }
     // 更新每个配置源
     for (const sourceName of sourcesToUpdate) {
         try {
             const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
-            await (0, project_1.useSource)(sourceName, sourcePath, projectDir);
+            // 使用保存的选择配置进行更新
+            const selection = config.sources[sourceName];
+            await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
             console.log(chalk_1.default.green(`✓ Updated source: ${sourceName}`));
         }
         catch (error) {

package/dist/core/project.d.ts

@@ -1,4 +1,13 @@
+import { SourceSelection } from '../types';
 export declare function initProject(projectDir: string): Promise<void>;
-export declare function useSource(sourceName: string, sourceDir: string, projectDir: string): Promise<void>;
+export declare function useSource(sourceName: string, sourceDir: string, projectDir: string, selection?: SourceSelection): Promise<void>;
 export declare function unuseSource(sourceName: string, projectDir: string): Promise<void>;
 export declare function listUsedSources(projectDir: string): Promise<string[]>;
+/**
+ * 导出项目配置到 JSON 文件
+ */
+export declare function exportProjectConfig(projectDir: string, outputPath: string): Promise<void>;
+/**
+ * 从 JSON 文件导入项目配置
+ */
+export declare function importProjectConfig(configPath: string, projectDir: string, resolveSourcePath: (sourceName: string) => Promise<string>): Promise<void>;

package/dist/core/project.js

@@ -7,10 +7,21 @@ exports.initProject = initProject;
 exports.useSource = useSource;
 exports.unuseSource = unuseSource;
 exports.listUsedSources = listUsedSources;
+exports.exportProjectConfig = exportProjectConfig;
+exports.importProjectConfig = importProjectConfig;
 const fs_extra_1 = __importDefault(require("fs-extra"));
 const path_1 = __importDefault(require("path"));
+const types_1 = require("../types");
 const manifest_1 = require("./manifest");
 const path_2 = require("../utils/path");
+/**
+ * 默认选择配置 - 导入所有内容
+ */
+const DEFAULT_SELECTION = {
+    skills: ['*'],
+    commands: ['*'],
+    agents: ['*']
+};
 async function initProject(projectDir) {
     const toolsccDir = (0, path_2.getToolsccDir)(projectDir);
     const configFile = (0, path_2.getProjectConfigPath)(projectDir);
@@ -21,13 +32,37 @@ async function initProject(projectDir) {
     // Create project config if not exists
     if (!(await fs_extra_1.default.pathExists(configFile))) {
         const config = {
-            sources: [],
+            sources: {},
             links: []
         };
         await fs_extra_1.default.writeJson(configFile, config, { spaces: 2 });
     }
 }
-async function useSource(sourceName, sourceDir, projectDir) {
+/**
+ * 读取项目配置，自动处理新旧格式
+ */
+async function readProjectConfig(configFile) {
+    const rawConfig = await fs_extra_1.default.readJson(configFile);
+    return (0, types_1.normalizeProjectConfig)(rawConfig);
+}
+/**
+ * 获取源名称列表（兼容新旧格式）
+ */
+function getSourceNames(config) {
+    return Object.keys(config.sources);
+}
+/**
+ * 检查是否应该复制某项（根据选择配置）
+ */
+function shouldInclude(itemName, selection) {
+    // 如果选择包含通配符，包含所有项
+    if (selection.includes('*')) {
+        return true;
+    }
+    // 否则检查是否在选择列表中
+    return selection.includes(itemName);
+}
+async function useSource(sourceName, sourceDir, projectDir, selection) {
     // Input validation
     if (!sourceName || !sourceName.trim()) {
         throw new Error('Source name is required');
@@ -40,13 +75,20 @@ async function useSource(sourceName, sourceDir, projectDir) {
     const manifest = await (0, manifest_1.loadManifest)(sourceDir);
     // Ensure project is initialized
     await initProject(projectDir);
+    // 使用传入的选择配置或默认配置
+    const effectiveSelection = selection ?? DEFAULT_SELECTION;
     // Copy/link skills (flattened with prefix)
     const sourceSkillsDir = path_1.default.join(sourceDir, 'skills');
     if (await fs_extra_1.default.pathExists(sourceSkillsDir)) {
         const skills = await fs_extra_1.default.readdir(sourceSkillsDir);
         for (const skill of skills) {
+            // 检查是否应该包含此 skill
+            if (!shouldInclude(skill, effectiveSelection.skills)) {
+                continue;
+            }
             const srcPath = path_1.default.join(sourceSkillsDir, skill);
-            const destPath = path_1.default.join(toolsccDir, 'skills', `${sourceName}-${skill}`);
+            const name = `${sourceName}` == `${skill}` ? skill : `${sourceName}-${skill}`;
+            const destPath = path_1.default.join(toolsccDir, 'skills', name);
             // Remove existing if exists
             await fs_extra_1.default.remove(destPath);
             // Copy directory
@@ -56,23 +98,51 @@ async function useSource(sourceName, sourceDir, projectDir) {
     // Copy commands (in subdirectory by source name)
     const sourceCommandsDir = path_1.default.join(sourceDir, 'commands');
     if (await fs_extra_1.default.pathExists(sourceCommandsDir)) {
-        const destDir = path_1.default.join(toolsccDir, 'commands', sourceName);
-        await fs_extra_1.default.remove(destDir);
-        await fs_extra_1.default.copy(sourceCommandsDir, destDir);
+        // 检查是否有选择 commands
+        if (effectiveSelection.commands.includes('*')) {
+            // 复制所有 commands
+            const destDir = path_1.default.join(toolsccDir, 'commands', sourceName);
+            await fs_extra_1.default.remove(destDir);
+            await fs_extra_1.default.copy(sourceCommandsDir, destDir);
+        }
+        else if (effectiveSelection.commands.length > 0) {
+            // 只复制选中的 commands
+            const destDir = path_1.default.join(toolsccDir, 'commands', sourceName);
+            await fs_extra_1.default.ensureDir(destDir);
+            for (const cmdName of effectiveSelection.commands) {
+                const srcFile = path_1.default.join(sourceCommandsDir, `${cmdName}.md`);
+                if (await fs_extra_1.default.pathExists(srcFile)) {
+                    await fs_extra_1.default.copy(srcFile, path_1.default.join(destDir, `${cmdName}.md`));
+                }
+            }
+        }
     }
     // Copy agents (in subdirectory by source name)
     const sourceAgentsDir = path_1.default.join(sourceDir, 'agents');
     if (await fs_extra_1.default.pathExists(sourceAgentsDir)) {
-        const destDir = path_1.default.join(toolsccDir, 'agents', sourceName);
-        await fs_extra_1.default.remove(destDir);
-        await fs_extra_1.default.copy(sourceAgentsDir, destDir);
+        // 检查是否有选择 agents
+        if (effectiveSelection.agents.includes('*')) {
+            // 复制所有 agents
+            const destDir = path_1.default.join(toolsccDir, 'agents', sourceName);
+            await fs_extra_1.default.remove(destDir);
+            await fs_extra_1.default.copy(sourceAgentsDir, destDir);
+        }
+        else if (effectiveSelection.agents.length > 0) {
+            // 只复制选中的 agents
+            const destDir = path_1.default.join(toolsccDir, 'agents', sourceName);
+            await fs_extra_1.default.ensureDir(destDir);
+            for (const agentName of effectiveSelection.agents) {
+                const srcFile = path_1.default.join(sourceAgentsDir, `${agentName}.md`);
+                if (await fs_extra_1.default.pathExists(srcFile)) {
+                    await fs_extra_1.default.copy(srcFile, path_1.default.join(destDir, `${agentName}.md`));
+                }
+            }
+        }
     }
-    // Update project config
+    // Update project config - 保存实际使用的选择配置
     const configFile = (0, path_2.getProjectConfigPath)(projectDir);
-    const config = await fs_extra_1.default.readJson(configFile);
-    if (!config.sources.includes(sourceName)) {
-        config.sources.push(sourceName);
-    }
+    const config = await readProjectConfig(configFile);
+    config.sources[sourceName] = effectiveSelection;
     await fs_extra_1.default.writeJson(configFile, config, { spaces: 2 });
 }
 async function unuseSource(sourceName, projectDir) {
@@ -99,13 +169,13 @@ async function unuseSource(sourceName, projectDir) {
     // Update project config with error handling
     let config;
     try {
-        config = await fs_extra_1.default.readJson(configFile);
+        config = await readProjectConfig(configFile);
     }
     catch (error) {
         // If config file doesn't exist or is invalid, nothing to update
         return;
     }
-    config.sources = config.sources.filter(s => s !== sourceName);
+    delete config.sources[sourceName];
     await fs_extra_1.default.writeJson(configFile, config, { spaces: 2 });
 }
 async function listUsedSources(projectDir) {
@@ -113,6 +183,54 @@ async function listUsedSources(projectDir) {
     if (!(await fs_extra_1.default.pathExists(configFile))) {
         return [];
     }
-    const config = await fs_extra_1.default.readJson(configFile);
-    return config.sources;
+    const config = await readProjectConfig(configFile);
+    return getSourceNames(config);
+}
+/**
+ * 导出项目配置到 JSON 文件
+ */
+async function exportProjectConfig(projectDir, outputPath) {
+    const configFile = (0, path_2.getProjectConfigPath)(projectDir);
+    if (!(await fs_extra_1.default.pathExists(configFile))) {
+        throw new Error('Project not initialized. Use `tools-cc use <source>` to get started.');
+    }
+    const config = await readProjectConfig(configFile);
+    const exportConfig = {
+        version: '1.0',
+        type: 'project',
+        config,
+        exportedAt: new Date().toISOString()
+    };
+    await fs_extra_1.default.writeJson(outputPath, exportConfig, { spaces: 2 });
+}
+/**
+ * 从 JSON 文件导入项目配置
+ */
+async function importProjectConfig(configPath, projectDir, resolveSourcePath) {
+    if (!(await fs_extra_1.default.pathExists(configPath))) {
+        throw new Error(`Config file not found: ${configPath}`);
+    }
+    const exportConfig = await fs_extra_1.default.readJson(configPath);
+    // Validate version
+    if (exportConfig.version !== '1.0') {
+        throw new Error(`Unsupported config version: ${exportConfig.version}`);
+    }
+    // Validate type
+    if (exportConfig.type !== 'project') {
+        throw new Error(`Invalid config type: ${exportConfig.type}. Expected 'project'.`);
+    }
+    // Initialize project
+    await initProject(projectDir);
+    // Apply each source
+    for (const [sourceName, selection] of Object.entries(exportConfig.config.sources)) {
+        const sourceDir = await resolveSourcePath(sourceName);
+        await useSource(sourceName, sourceDir, projectDir, selection);
+    }
+    // Update links if present
+    if (exportConfig.config.links && exportConfig.config.links.length > 0) {
+        const configFile = (0, path_2.getProjectConfigPath)(projectDir);
+        const config = await readProjectConfig(configFile);
+        config.links = exportConfig.config.links;
+        await fs_extra_1.default.writeJson(configFile, config, { spaces: 2 });
+    }
 }

package/dist/index.js

@@ -5,6 +5,7 @@ const commander_1 = require("commander");
 const config_1 = require("./commands/config");
 const source_1 = require("./commands/source");
 const use_1 = require("./commands/use");
+const export_1 = require("./commands/export");
 const help_1 = require("./commands/help");
 const program = new commander_1.Command();
 program
@@ -80,6 +81,8 @@ program
     .command('use [sources...]')
     .description('Use sources in current project')
     .option('-p, --projects <tools...>', 'Tools to link (iflow, claude, codebuddy, opencode)')
+    .option('-ls', 'Interactive selection mode for single source')
+    .option('-c, --config <file>', 'Import from config file')
     .action(async (sources, options) => {
     await (0, use_1.handleUse)(sources, options);
 });
@@ -107,6 +110,14 @@ program
     .action(async (sources) => {
     await (0, use_1.handleProjectUpdate)(sources);
 });
+program
+    .command('export')
+    .description('Export project or global config')
+    .option('-o, --output <file>', 'Output file path')
+    .option('--global', 'Export global config')
+    .action(async (options) => {
+    await (0, export_1.handleExport)(options);
+});
 // Help command
 program
     .command('help')

package/dist/types/config.d.ts

@@ -7,10 +7,37 @@ export interface GlobalConfig {
     sourcesDir: string;
     sources: Record<string, SourceConfig>;
 }
+/**
+ * 源选择配置 - 指定从源中导入哪些 skills/commands/agents
+ */
+export interface SourceSelection {
+    skills: string[];
+    commands: string[];
+    agents: string[];
+}
+/**
+ * 新版项目配置 - sources 使用 Record 格式支持部分导入
+ */
 export interface ProjectConfig {
+    sources: Record<string, SourceSelection>;
+    links: string[];
+}
+/**
+ * 旧版项目配置 - sources 为字符串数组（向后兼容）
+ */
+export interface LegacyProjectConfig {
     sources: string[];
     links: string[];
 }
+/**
+ * 判断值是否为有效的 SourceSelection 对象
+ */
+export declare function isSourceSelection(value: unknown): value is SourceSelection;
+/**
+ * 将旧版项目配置转换为新版格式
+ * 如果 sources 是字符串数组，转换为 Record 格式，每个源默认导入全部内容
+ */
+export declare function normalizeProjectConfig(config: LegacyProjectConfig | ProjectConfig): ProjectConfig;
 export interface Manifest {
     name: string;
     version: string;
@@ -21,3 +48,21 @@ export interface Manifest {
 export interface ToolConfig {
     linkName: string;
 }
+/**
+ * 项目配置导出格式
+ */
+export interface ExportConfig {
+    version: string;
+    type: 'project';
+    config: ProjectConfig;
+    exportedAt: string;
+}
+/**
+ * 全局配置导出格式
+ */
+export interface GlobalExportConfig {
+    version: string;
+    type: 'global';
+    config: GlobalConfig;
+    exportedAt: string;
+}

package/dist/types/config.js

@@ -1,2 +1,34 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSourceSelection = isSourceSelection;
+exports.normalizeProjectConfig = normalizeProjectConfig;
+/**
+ * 判断值是否为有效的 SourceSelection 对象
+ */
+function isSourceSelection(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return (Array.isArray(obj.skills) &&
+        Array.isArray(obj.commands) &&
+        Array.isArray(obj.agents));
+}
+/**
+ * 将旧版项目配置转换为新版格式
+ * 如果 sources 是字符串数组，转换为 Record 格式，每个源默认导入全部内容
+ */
+function normalizeProjectConfig(config) {
+    // If sources is an array, convert to new format
+    if (Array.isArray(config.sources)) {
+        const newSources = {};
+        for (const sourceName of config.sources) {
+            newSources[sourceName] = {
+                skills: ['*'],
+                commands: ['*'],
+                agents: ['*']
+            };
+        }
+        return { sources: newSources, links: config.links };
+    }
+    return config;
+}