tools-cc 1.0.6 → 1.0.8

package/CHANGELOG.md

@@ -2,6 +2,37 @@
 
 本项目的所有重要变更都将记录在此文件中。
 
+## [1.0.8] - 2026-03-04
+
+### Added
+- 新增模板管理功能，支持保存/复用项目配置
+  - `tools-cc template save [-n <name>]` 保存当前项目配置为模板
+  - `tools-cc template list` 列出所有已保存的模板
+  - `tools-cc template rm <name>` 删除模板
+  - `tools-cc template use [name]` 应用模板到当前项目（无参数时交互选择）
+- 模板存储在 `~/.tools-cc/templates/` 目录
+
+### Fixed
+- 修复测试文件未纳入版本控制的问题
+
+## [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,37 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.0.8] - 2026-03-04
+
+### Added
+- Added template management feature for saving/reusing project configs
+  - `tools-cc template save [-n <name>]` save current project config as template
+  - `tools-cc template list` list all saved templates
+  - `tools-cc template rm <name>` remove a template
+  - `tools-cc template use [name]` apply template to current project (interactive selection if no name)
+- Templates stored in `~/.tools-cc/templates/` directory
+
+### Fixed
+- Fixed test files not being tracked in version control
+
+## [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/template.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 处理 template save 命令
+ */
+export declare function handleTemplateSave(options: {
+    name?: string;
+}): Promise<void>;
+/**
+ * 处理 template list 命令
+ */
+export declare function handleTemplateList(): Promise<void>;
+/**
+ * 处理 template rm 命令
+ */
+export declare function handleTemplateRemove(name: string): Promise<void>;
+/**
+ * 处理 template use 命令
+ */
+export declare function handleTemplateUse(name?: string): Promise<void>;

package/dist/commands/template.js

@@ -0,0 +1,154 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleTemplateSave = handleTemplateSave;
+exports.handleTemplateList = handleTemplateList;
+exports.handleTemplateRemove = handleTemplateRemove;
+exports.handleTemplateUse = handleTemplateUse;
+const chalk_1 = __importDefault(require("chalk"));
+const inquirer_1 = __importDefault(require("inquirer"));
+const path_1 = __importDefault(require("path"));
+const template_1 = require("../core/template");
+const config_1 = require("../core/config");
+const project_1 = require("../core/project");
+const source_1 = require("../core/source");
+const path_2 = require("../utils/path");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+/**
+ * 处理 template save 命令
+ */
+async function handleTemplateSave(options) {
+    const projectDir = process.cwd();
+    const configFile = (0, path_2.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;
+    }
+    try {
+        // 读取项目配置
+        const config = await (0, config_1.loadProjectConfig)(projectDir);
+        if (!config) {
+            console.log(chalk_1.default.yellow('No project configuration found.'));
+            return;
+        }
+        // 确定模板名称
+        let templateName = options.name;
+        if (!templateName) {
+            templateName = path_1.default.basename(projectDir);
+        }
+        // 检查是否已存在
+        const existing = await (0, template_1.getTemplate)(templateName, path_2.TEMPLATES_DIR);
+        if (existing) {
+            const answers = await inquirer_1.default.prompt([
+                {
+                    type: 'confirm',
+                    name: 'overwrite',
+                    message: `Template "${templateName}" already exists. Overwrite?`,
+                    default: false
+                }
+            ]);
+            if (!answers.overwrite) {
+                console.log(chalk_1.default.gray('Cancelled.'));
+                return;
+            }
+        }
+        // 保存模板
+        const template = await (0, template_1.saveTemplate)(templateName, projectDir, config, path_2.TEMPLATES_DIR);
+        console.log(chalk_1.default.green(`✓ Template saved: ${template.name}`));
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`✗ Failed to save template: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+/**
+ * 处理 template list 命令
+ */
+async function handleTemplateList() {
+    const templates = await (0, template_1.listTemplates)(path_2.TEMPLATES_DIR);
+    if (templates.length === 0) {
+        console.log(chalk_1.default.gray('No templates saved.'));
+        return;
+    }
+    console.log(chalk_1.default.bold('Saved templates:'));
+    for (const template of templates) {
+        const date = new Date(template.savedAt).toLocaleDateString();
+        console.log(`  ${chalk_1.default.cyan(template.name.padEnd(20))} (saved: ${date})`);
+    }
+}
+/**
+ * 处理 template rm 命令
+ */
+async function handleTemplateRemove(name) {
+    try {
+        await (0, template_1.removeTemplate)(name, path_2.TEMPLATES_DIR);
+        console.log(chalk_1.default.green(`✓ Template removed: ${name}`));
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`✗ Failed to remove template: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+}
+/**
+ * 处理 template use 命令
+ */
+async function handleTemplateUse(name) {
+    const projectDir = process.cwd();
+    const configFile = (0, path_2.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;
+    }
+    // 如果没有指定名称，显示选择列表
+    if (!name) {
+        const templates = await (0, template_1.listTemplates)(path_2.TEMPLATES_DIR);
+        if (templates.length === 0) {
+            console.log(chalk_1.default.gray('No templates saved.'));
+            return;
+        }
+        const answers = await inquirer_1.default.prompt([
+            {
+                type: 'list',
+                name: 'selectedTemplate',
+                message: 'Select a template to use:',
+                choices: templates.map(t => ({
+                    name: `${t.name} (from: ${path_1.default.basename(t.sourceProject)})`,
+                    value: t.name
+                }))
+            }
+        ]);
+        name = answers.selectedTemplate;
+    }
+    // 获取模板
+    const template = await (0, template_1.getTemplate)(name, path_2.TEMPLATES_DIR);
+    if (!template) {
+        console.log(chalk_1.default.red(`✗ Template not found: ${name}`));
+        return;
+    }
+    // 定义源路径解析函数
+    const resolveSourcePath = async (sourceName) => {
+        return await (0, source_1.getSourcePath)(sourceName, path_2.GLOBAL_CONFIG_DIR);
+    };
+    // 创建临时配置文件
+    const tempConfigPath = path_1.default.join(projectDir, '.toolscc-template-temp.json');
+    const exportConfig = {
+        version: '1.0',
+        type: 'project',
+        config: template.config,
+        exportedAt: new Date().toISOString()
+    };
+    // 导入配置
+    try {
+        await fs_extra_1.default.writeJson(tempConfigPath, exportConfig, { spaces: 2 });
+        await (0, project_1.importProjectConfig)(tempConfigPath, projectDir, resolveSourcePath);
+        console.log(chalk_1.default.green(`✓ Applied template: ${name}`));
+    }
+    catch (error) {
+        console.log(chalk_1.default.red(`✗ Failed to apply template: ${error instanceof Error ? error.message : 'Unknown error'}`));
+    }
+    finally {
+        await fs_extra_1.default.remove(tempConfigPath);
+    }
+}

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>;