tools-cc 1.0.6 → 1.0.7

package/CHANGELOG.md

@@ -2,6 +2,24 @@
 
 本项目的所有重要变更都将记录在此文件中。
 
+## [1.0.7] - 2026-03-02
+
+### Fixed
+- 修复 `tools-cc update` 命令无法正确识别旧版数组格式配置的问题（sources 为数组时会被错误解析为索引）
+
+### Changed
+- 更新帮助文档，完善命令说明和示例
+
+## [1.0.6] - 2026-03-02
+
+### Added
+- 新增无参数交互式源选择：`tools-cc use` 直接运行显示源列表供选择
+- 新增配置文件导入功能：`tools-cc use -c config.json` 从导出的配置文件快速恢复项目配置
+
+### Changed
+- 重构 `use` 命令，统一支持多种模式（配置导入、交互选择、路径语法、整体导入、点模式）
+- 优化交互选择模式，支持分组展示 skills/commands/agents
+
 ## [1.0.5] - 2026-02-28
 
 ### Added

package/CHANGELOG_en.md

@@ -2,6 +2,24 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.7] - 2026-03-02
+
+### Fixed
+- Fixed `tools-cc update` command failing to recognize legacy array format config (sources array was incorrectly parsed as indices)
+
+### Changed
+- Updated help documentation with improved command descriptions and examples
+
+## [1.0.6] - 2026-03-02
+
+### Added
+- Added interactive source selection: `tools-cc use` without arguments shows source list for selection
+- Added config import feature: `tools-cc use -c config.json` to quickly restore project config from exported file
+
+### Changed
+- Refactored `use` command to support multiple modes (config import, interactive selection, path syntax, full import, dot mode)
+- Improved interactive selection mode with grouped display of skills/commands/agents
+
 ## [1.0.5] - 2026-02-28
 
 ### Added

package/README.md

@@ -36,11 +36,14 @@ tools-cc -s list
 cd my-project
 tools-cc use my-skills -p iflow claude codex
 
-# 4a. 或使用部分引入（只引入需要的 skills/commands/agents）
+# 4a. 无参数运行，交互式选择源
+tools-cc use                               # 显示源列表供选择
+
+# 4b. 或使用部分引入（只引入需要的 skills/commands/agents）
 tools-cc use my-skills/skills/a-skill
-tools-cc use my-skills --ls                # 交互式选择
+tools-cc use my-skills --ls                # 交互式选择内容
 
-# 4b. 或从配置文件快速导入
+# 4c. 或从配置文件快速导入
 tools-cc use -c project-config.json
 
 # 5. 查看项目状态
@@ -117,6 +120,9 @@ tools-cc export [options]                 # 导出项目或全局配置
 #### `use` 命令详解
 
 ```bash
+# 无参数运行：交互式选择源
+tools-cc use                               # 显示可用源列表供选择
+
 # 整源引入（全部 skills/commands/agents）
 tools-cc use my-skills
 tools-cc use my-skills -p iflow claude codex    # 指定工具链接
@@ -127,7 +133,7 @@ tools-cc use my-skills/commands/test      # 引入单个 command
 tools-cc use my-skills/agents/reviewer    # 引入单个 agent
 tools-cc use my-skills/skills/a my-skills/commands/test  # 引入多项
 
-# 交互式选择（--ls 参数）
+# 交互式选择内容（--ls 参数）
 tools-cc use my-skills --ls               # 分组展示，勾选引入
 
 # 从配置文件导入

package/README_en.md

@@ -34,7 +34,8 @@ tools-cc -s list
 
 # 4. Enable configuration sources in a project and create links
 cd my-project
-tools-cc use my-skills -p iflow claude
+tools-cc use                              # Interactive source selection
+tools-cc use my-skills -p iflow claude codex
 
 # 5. View project status
 tools-cc status
@@ -99,11 +100,50 @@ tools-cc sources scan                     # Scan sourcesDir to auto-discover and
 ### Project Configuration
 
 ```bash
-tools-cc use [sources...] [-p tools...]   # Enable configuration sources and create symbolic links
+tools-cc use [sources...] [options]       # Enable configuration sources and create symbolic links
 tools-cc update [sources...]              # Sync configuration source content to project .toolscc directory
 tools-cc list                             # List enabled configuration sources
 tools-cc rm <source>                      # Disable configuration source
 tools-cc status                           # View project status
+tools-cc export [options]                 # Export project or global config
+```
+
+#### `use` Command Details
+
+```bash
+# No arguments: interactive source selection
+tools-cc use                               # Show available sources for selection
+
+# Full source import (all skills/commands/agents)
+tools-cc use my-skills
+tools-cc use my-skills -p iflow claude codex    # Specify tool links
+
+# Partial import (path syntax)
+tools-cc use my-skills/skills/a-skill     # Import single skill
+tools-cc use my-skills/commands/test      # Import single command
+tools-cc use my-skills/agents/reviewer    # Import single agent
+tools-cc use my-skills/skills/a my-skills/commands/test  # Import multiple
+
+# Interactive content selection (--ls flag)
+tools-cc use my-skills --ls               # Grouped display, checkbox selection
+
+# Import from config file
+tools-cc use -c project-config.json       # Quick restore project config
+
+# Use "." for existing project sources (only create links, no copy)
+tools-cc use . -p iflow claude codex
+```
+
+#### `export` Command Details
+
+```bash
+# Export project config
+tools-cc export                           # Export to .toolscc-export.json
+tools-cc export -o my-config.json         # Specify output path
+
+# Export global config
+tools-cc export --global                  # Export to .toolscc-global-export.json
+tools-cc export --global -o global.json   # Specify output path
 ```
 
 ### Config Management
@@ -135,6 +175,7 @@ tools-cc --version                        # Display version number
 | claude | `.claude` |
 | codebuddy | `.codebuddy` |
 | opencode | `.opencode` |
+| codex | `.codex` |
 
 ## Configuration Source Structure
 
@@ -208,11 +249,22 @@ my-project/
 
 ```json
 {
-  "sources": ["my-skills"],
-  "links": ["iflow", "claude"]
+  "sources": {
+    "my-skills": {
+      "skills": ["a-skill", "b-skill"],
+      "commands": ["test"],
+      "agents": ["*"]
+    }
+  },
+  "links": ["iflow", "claude", "codex"]
 }
 ```
 
+**Notes:**
+- `sources` records specific content imported from each source
+- `["*"]` means import all content of that type
+- `[]` means import nothing of that type
+
 ## License
 
 MIT

package/dist/commands/help.js

@@ -28,7 +28,8 @@ ${chalk_1.default.bold('COMMANDS / 命令')}
     tools-cc sources add <name> <path-or-url>    Add a source / 添加配置源
     tools-cc sources list, ls                    List all sources / 列出所有配置源
     tools-cc sources remove, rm <name>           Remove a source / 移除配置源
-    tools-cc sources update, up [name]           Update source(s) / 更新配置源
+    tools-cc sources update, up [name]           git pull update / 更新源代码
+    tools-cc sources scan                        Scan dir for sources / 扫描发现新源
     
     ${chalk_1.default.gray('Shortcut: -s')}  e.g., tools-cc -s add my-skills https://github.com/user/skills.git
 
@@ -40,16 +41,27 @@ ${chalk_1.default.bold('COMMANDS / 命令')}
     ${chalk_1.default.gray('Shortcut: -c')}  e.g., tools-cc -c set sourcesDir D:/skills
 
   ${chalk_1.default.cyan('Project Commands / 项目命令')}
-    tools-cc use [sources...] [-p tools...]      Use sources in project / 在项目中启用配置源
+    tools-cc use [sources...] [options]          Use sources in project / 在项目中启用配置源
+    tools-cc update [sources...]                 Sync source content to project / 同步内容到项目
     tools-cc list                                List used sources / 列出已启用的配置源
     tools-cc rm <source>                         Remove source from project / 禁用配置源
     tools-cc status                              Show project status / 显示项目状态
+    tools-cc export [options]                    Export config / 导出配置
 
   ${chalk_1.default.cyan('Help / 帮助')}
     tools-cc help                                Show this help / 显示此帮助信息
     tools-cc --help, -h                          Show command help / 显示命令帮助
     tools-cc --version, -V                       Show version / 显示版本号
 
+${chalk_1.default.bold('USE OPTIONS / use 命令选项')}
+  -p, --tools <tools...>    Target tools (iflow, claude, etc.) / 目标工具
+  --ls                      Interactive selection / 交互式选择内容
+  -c, --config <file>       Import from config file / 从配置文件导入
+
+${chalk_1.default.bold('EXPORT OPTIONS / export 命令选项')}
+  -o, --output <file>       Output file path / 输出文件路径
+  --global                  Export global config / 导出全局配置
+
 ${chalk_1.default.bold('SUPPORTED TOOLS / 支持的工具')}
   iflow      → .iflow
   claude     → .claude
@@ -64,21 +76,36 @@ ${chalk_1.default.bold('EXAMPLES / 示例')}
   ${chalk_1.default.gray('# Add a local source / 添加本地配置源')}
   tools-cc sources add local-skills D:/path/to/local-skills
 
+  ${chalk_1.default.gray('# Scan for sources / 扫描发现配置源')}
+  tools-cc sources scan
+
   ${chalk_1.default.gray('# List all sources / 列出所有配置源')}
   tools-cc sources list
 
   ${chalk_1.default.gray('# Use sources in project / 在项目中启用配置源')}
   tools-cc use my-skills -p iflow claude codex
 
+  ${chalk_1.default.gray('# Interactive selection / 交互式选择内容')}
+  tools-cc use my-skills --ls
+
+  ${chalk_1.default.gray('# Import from config file / 从配置文件导入')}
+  tools-cc use -c project-config.json
+
+  ${chalk_1.default.gray('# Sync source content to project / 同步源内容到项目')}
+  tools-cc update my-skills
+
   ${chalk_1.default.gray('# Check project status / 检查项目状态')}
   tools-cc status
 
+  ${chalk_1.default.gray('# Export project config / 导出项目配置')}
+  tools-cc export -o my-config.json
+
   ${chalk_1.default.gray('# Show full configuration / 显示完整配置')}
   tools-cc config list
 
 ${chalk_1.default.bold('MORE INFO / 更多信息')}
-  GitHub: https://github.com/user/tools-cc
-  Docs:   https://github.com/user/tools-cc#readme
+  GitHub: https://github.com/q759410559/tools-cc
+  Docs:   https://github.com/q759410559/tools-cc#readme
 
 ${chalk_1.default.bold.cyan('═══════════════════════════════════════════════════════════════════════════')}
 `);

package/dist/commands/use.d.ts

@@ -9,12 +9,12 @@ export interface UseOptions {
 /**
  * 处理 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 . (使用已配置源)
+ * 5. 点模式: tools-cc use . (使用已配置源)
  */
 export declare function handleUse(sourceSpecs: string[], options: UseOptions): Promise<void>;
 export declare function handleList(): Promise<void>;

package/dist/commands/use.js

@@ -11,6 +11,7 @@ exports.handleProjectUpdate = handleProjectUpdate;
 const chalk_1 = __importDefault(require("chalk"));
 const inquirer_1 = __importDefault(require("inquirer"));
 const project_1 = require("../core/project");
+const config_1 = require("../types/config");
 const source_1 = require("../core/source");
 const manifest_1 = require("../core/manifest");
 const symlink_1 = require("../core/symlink");
@@ -28,12 +29,12 @@ const SUPPORTED_TOOLS = {
 /**
  * 处理 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 . (使用已配置源)
+ * 5. 点模式: tools-cc use . (使用已配置源)
  */
 async function handleUse(sourceSpecs, options) {
     const projectDir = process.cwd();
@@ -44,7 +45,7 @@ async function handleUse(sourceSpecs, options) {
         await handleConfigImportMode(options.config, projectDir, options.projects);
         return;
     }
-    // 2. 点模式：使用当前项目已配置的�?
+    // 2. 点模式：使用当前项目已配置的源
     if (sourceSpecs.length === 1 && sourceSpecs[0] === '.') {
         await handleDotMode(projectDir, toolsccDir, configFile, options.projects);
         return;
@@ -52,7 +53,7 @@ async function handleUse(sourceSpecs, options) {
     // 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;
@@ -68,17 +69,17 @@ async function handleUse(sourceSpecs, options) {
     }
     // 5. 解析路径语法并构建选择配置
     const selectionMap = (0, parsePath_1.buildSelectionFromPaths)(sourceSpecs);
-    // 初始化项�?
+    // 初始化项目
     await (0, project_1.initProject)(projectDir);
     // 应用每个源的选择配置
     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, selection);
-            console.log(chalk_1.default.green(`�?Using source: ${sourceName}`));
+            console.log(chalk_1.default.green(`✓ Using source: ${sourceName}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`�?Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            console.log(chalk_1.default.red(`✗ Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
     // 创建符号链接
@@ -93,18 +94,18 @@ async function handleConfigImportMode(configPath, projectDir, projects) {
         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}`));
+        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'}`));
+        console.log(chalk_1.default.red(`✗ Failed to import config: ${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
 /**
@@ -125,7 +126,7 @@ async function handleDotMode(projectDir, toolsccDir, configFile, projects) {
     await createToolLinks(projectDir, toolsccDir, configFile, projects);
 }
 /**
- * 交互选择模式：显示技�?命令/代理选择列表
+ * 交互选择模式：显示技能/命令/代理选择列表
  */
 async function handleInteractiveMode(sourceName, projectDir, projects) {
     try {
@@ -134,21 +135,21 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
         // 构建选项列表
         // eslint-disable-next-line @typescript-eslint/no-explicit-any
         const choices = [];
-        // Skills �?
+        // 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 �?
+        // 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 �?
+        // 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) {
@@ -173,7 +174,7 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
             console.log(chalk_1.default.gray('No items selected.'));
             return;
         }
-        // 将选择转换�?SourceSelection
+        // 将选择转换为 SourceSelection
         const selection = {
             skills: [],
             commands: [],
@@ -191,14 +192,14 @@ async function handleInteractiveMode(sourceName, projectDir, projects) {
         // 初始化项目并应用选择
         await (0, project_1.initProject)(projectDir);
         await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
-        console.log(chalk_1.default.green(`�?Using source: ${sourceName}`));
+        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'}`));
+        console.log(chalk_1.default.red(`✗ Failed to use ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
 /**
@@ -235,10 +236,10 @@ async function createToolLinks(projectDir, toolsccDir, configFile, projects) {
         const linkPath = path_2.default.join(projectDir, linkName);
         try {
             await (0, symlink_1.createSymlink)(toolsccDir, linkPath, true);
-            console.log(chalk_1.default.green(`�?Linked: ${linkName} -> .toolscc`));
+            console.log(chalk_1.default.green(`✓ Linked: ${linkName} -> .toolscc`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`�?Failed to link ${linkName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            console.log(chalk_1.default.red(`✗ Failed to link ${linkName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
     // 更新项目配置
@@ -263,10 +264,10 @@ async function handleRemove(sourceName) {
     const projectDir = process.cwd();
     try {
         await (0, project_1.unuseSource)(sourceName, projectDir);
-        console.log(chalk_1.default.green(`�?Removed source: ${sourceName}`));
+        console.log(chalk_1.default.green(`✓ Removed source: ${sourceName}`));
     }
     catch (error) {
-        console.log(chalk_1.default.red(`�?${error instanceof Error ? error.message : 'Unknown error'}`));
+        console.log(chalk_1.default.red(`✗ ${error instanceof Error ? error.message : 'Unknown error'}`));
     }
 }
 async function handleStatus() {
@@ -274,12 +275,12 @@ async function handleStatus() {
     const sources = await (0, project_1.listUsedSources)(projectDir);
     console.log(chalk_1.default.bold('\nProject Status:'));
     console.log(chalk_1.default.gray(`  Directory: ${projectDir}`));
-    // 检�?.toolscc
+    // 检查 .toolscc
     const toolsccDir = (0, path_1.getToolsccDir)(projectDir);
     console.log(`  .toolscc: ${await fs_extra_1.default.pathExists(toolsccDir) ? chalk_1.default.green('exists') : chalk_1.default.red('not found')}`);
-    // 检�?sources
+    // 检查 sources
     console.log(`  Sources: ${sources.length > 0 ? sources.map(s => chalk_1.default.cyan(s)).join(', ') : chalk_1.default.gray('none')}`);
-    // 检�?links
+    // 检查 links
     const configFile = (0, path_1.getProjectConfigPath)(projectDir);
     if (await fs_extra_1.default.pathExists(configFile)) {
         const config = await fs_extra_1.default.readJson(configFile);
@@ -298,40 +299,44 @@ async function handleStatus() {
 async function handleProjectUpdate(sourceNames) {
     const projectDir = process.cwd();
     const configFile = (0, path_1.getProjectConfigPath)(projectDir);
-    // 检查项目是否已初始�?
+    // 检查项目是否已初始化
     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 rawConfig = await fs_extra_1.default.readJson(configFile);
+    // 使用 normalizeProjectConfig 处理旧版（数组）和新版（对象）格式
+    const config = (0, config_1.normalizeProjectConfig)(rawConfig);
     const configuredSources = Object.keys(config.sources || {});
-    let sourcesToUpdate = sourceNames && sourceNames.length > 0
-        ? sourceNames
+    // 过滤掉无效的源名称（如数字字符串），这些可能是 Commander.js 解析错误产生的
+    const validSourceNames = sourceNames?.filter(s => isNaN(Number(s))) || [];
+    let sourcesToUpdate = validSourceNames.length > 0
+        ? validSourceNames
         : 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) => !configuredSources.includes(s));
+    // 验证指定的源是否存在于项目配置中（仅当用户明确指定了有效源名称时）
+    if (validSourceNames.length > 0) {
+        const invalidSources = validSourceNames.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) => configuredSources.includes(s));
     }
-    // 更新每个配置�?
+    // 更新每个配置源
     for (const sourceName of sourcesToUpdate) {
         try {
             const sourcePath = await (0, source_1.getSourcePath)(sourceName, path_1.GLOBAL_CONFIG_DIR);
             // 使用保存的选择配置进行更新
             const selection = config.sources[sourceName];
             await (0, project_1.useSource)(sourceName, sourcePath, projectDir, selection);
-            console.log(chalk_1.default.green(`�?Updated source: ${sourceName}`));
+            console.log(chalk_1.default.green(`✓ Updated source: ${sourceName}`));
         }
         catch (error) {
-            console.log(chalk_1.default.red(`�?Failed to update ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
+            console.log(chalk_1.default.red(`✗ Failed to update ${sourceName}: ${error instanceof Error ? error.message : 'Unknown error'}`));
         }
     }
-    console.log(chalk_1.default.green(`\n�?Project update complete`));
+    console.log(chalk_1.default.green(`\n✓ Project update complete`));
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-cc",
-  "version": "1.0.6",
+  "version": "1.0.7",
   "description": "tools-cc [options] <command> [args]",
   "main": "index.js",
   "directories": {

package/src/commands/help.ts

@@ -23,7 +23,8 @@ ${chalk.bold('COMMANDS / 命令')}
     tools-cc sources add <name> <path-or-url>    Add a source / 添加配置源
     tools-cc sources list, ls                    List all sources / 列出所有配置源
     tools-cc sources remove, rm <name>           Remove a source / 移除配置源
-    tools-cc sources update, up [name]           Update source(s) / 更新配置源
+    tools-cc sources update, up [name]           git pull update / 更新源代码
+    tools-cc sources scan                        Scan dir for sources / 扫描发现新源
     
     ${chalk.gray('Shortcut: -s')}  e.g., tools-cc -s add my-skills https://github.com/user/skills.git
 
@@ -35,16 +36,27 @@ ${chalk.bold('COMMANDS / 命令')}
     ${chalk.gray('Shortcut: -c')}  e.g., tools-cc -c set sourcesDir D:/skills
 
   ${chalk.cyan('Project Commands / 项目命令')}
-    tools-cc use [sources...] [-p tools...]      Use sources in project / 在项目中启用配置源
+    tools-cc use [sources...] [options]          Use sources in project / 在项目中启用配置源
+    tools-cc update [sources...]                 Sync source content to project / 同步内容到项目
     tools-cc list                                List used sources / 列出已启用的配置源
     tools-cc rm <source>                         Remove source from project / 禁用配置源
     tools-cc status                              Show project status / 显示项目状态
+    tools-cc export [options]                    Export config / 导出配置
 
   ${chalk.cyan('Help / 帮助')}
     tools-cc help                                Show this help / 显示此帮助信息
     tools-cc --help, -h                          Show command help / 显示命令帮助
     tools-cc --version, -V                       Show version / 显示版本号
 
+${chalk.bold('USE OPTIONS / use 命令选项')}
+  -p, --tools <tools...>    Target tools (iflow, claude, etc.) / 目标工具
+  --ls                      Interactive selection / 交互式选择内容
+  -c, --config <file>       Import from config file / 从配置文件导入
+
+${chalk.bold('EXPORT OPTIONS / export 命令选项')}
+  -o, --output <file>       Output file path / 输出文件路径
+  --global                  Export global config / 导出全局配置
+
 ${chalk.bold('SUPPORTED TOOLS / 支持的工具')}
   iflow      → .iflow
   claude     → .claude
@@ -59,21 +71,36 @@ ${chalk.bold('EXAMPLES / 示例')}
   ${chalk.gray('# Add a local source / 添加本地配置源')}
   tools-cc sources add local-skills D:/path/to/local-skills
 
+  ${chalk.gray('# Scan for sources / 扫描发现配置源')}
+  tools-cc sources scan
+
   ${chalk.gray('# List all sources / 列出所有配置源')}
   tools-cc sources list
 
   ${chalk.gray('# Use sources in project / 在项目中启用配置源')}
   tools-cc use my-skills -p iflow claude codex
 
+  ${chalk.gray('# Interactive selection / 交互式选择内容')}
+  tools-cc use my-skills --ls
+
+  ${chalk.gray('# Import from config file / 从配置文件导入')}
+  tools-cc use -c project-config.json
+
+  ${chalk.gray('# Sync source content to project / 同步源内容到项目')}
+  tools-cc update my-skills
+
   ${chalk.gray('# Check project status / 检查项目状态')}
   tools-cc status
 
+  ${chalk.gray('# Export project config / 导出项目配置')}
+  tools-cc export -o my-config.json
+
   ${chalk.gray('# Show full configuration / 显示完整配置')}
   tools-cc config list
 
 ${chalk.bold('MORE INFO / 更多信息')}
-  GitHub: https://github.com/user/tools-cc
-  Docs:   https://github.com/user/tools-cc#readme
+  GitHub: https://github.com/q759410559/tools-cc
+  Docs:   https://github.com/q759410559/tools-cc#readme
 
 ${chalk.bold.cyan('═══════════════════════════════════════════════════════════════════════════')}
 `);

package/src/commands/use.ts

@@ -1,6 +1,7 @@
 import chalk from 'chalk';
 import inquirer from 'inquirer';
 import { useSource, unuseSource, listUsedSources, initProject, importProjectConfig } from '../core/project';
+import { normalizeProjectConfig } from '../types/config';
 import { getSourcePath, listSources } from '../core/source';
 import { scanSource } from '../core/manifest';
 import { createSymlink, isSymlink } from '../core/symlink';
@@ -368,11 +369,16 @@ export async function handleProjectUpdate(sourceNames?: string[]): Promise<void>
     return;
   }
   
-  const config = await fs.readJson(configFile);
+  const rawConfig = await fs.readJson(configFile);
+  // 使用 normalizeProjectConfig 处理旧版（数组）和新版（对象）格式
+  const config = normalizeProjectConfig(rawConfig);
   const configuredSources = Object.keys(config.sources || {});
   
-  let sourcesToUpdate = sourceNames && sourceNames.length > 0 
-    ? sourceNames 
+  // 过滤掉无效的源名称（如数字字符串），这些可能是 Commander.js 解析错误产生的
+  const validSourceNames = sourceNames?.filter(s => isNaN(Number(s))) || [];
+  
+  let sourcesToUpdate = validSourceNames.length > 0 
+    ? validSourceNames 
     : configuredSources;
   
   if (sourcesToUpdate.length === 0) {
@@ -380,9 +386,9 @@ export async function handleProjectUpdate(sourceNames?: string[]): Promise<void>
     return;
   }
   
-  // 验证指定的源是否存在于项目配置中
-  if (sourceNames && sourceNames.length > 0) {
-    const invalidSources = sourceNames.filter((s: string) => !configuredSources.includes(s));
+  // 验证指定的源是否存在于项目配置中（仅当用户明确指定了有效源名称时）
+  if (validSourceNames.length > 0) {
+    const invalidSources = validSourceNames.filter((s: string) => !configuredSources.includes(s));
     if (invalidSources.length > 0) {
       console.log(chalk.yellow(`Sources not in project: ${invalidSources.join(', ')}`));
     }