tools-cc 1.0.7 → 1.0.8

package/CHANGELOG.md

@@ -2,6 +2,19 @@
 
 本项目的所有重要变更都将记录在此文件中。
 
+## [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

package/CHANGELOG_en.md

@@ -2,6 +2,19 @@
 
 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

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/core/template.d.ts

@@ -0,0 +1,17 @@
+import { TemplateConfig, ProjectConfig } from '../types';
+/**
+ * 保存项目配置为模板
+ */
+export declare function saveTemplate(name: string, sourceProject: string, config: ProjectConfig, templatesDir: string): Promise<TemplateConfig>;
+/**
+ * 列出所有模板
+ */
+export declare function listTemplates(templatesDir: string): Promise<TemplateConfig[]>;
+/**
+ * 获取指定模板
+ */
+export declare function getTemplate(name: string, templatesDir: string): Promise<TemplateConfig | null>;
+/**
+ * 删除模板
+ */
+export declare function removeTemplate(name: string, templatesDir: string): Promise<void>;

package/dist/core/template.js

@@ -0,0 +1,74 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.saveTemplate = saveTemplate;
+exports.listTemplates = listTemplates;
+exports.getTemplate = getTemplate;
+exports.removeTemplate = removeTemplate;
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+/**
+ * 保存项目配置为模板
+ */
+async function saveTemplate(name, sourceProject, config, templatesDir) {
+    if (!name || !name.trim()) {
+        throw new Error('Template name is required');
+    }
+    await fs_extra_1.default.ensureDir(templatesDir);
+    const template = {
+        version: '1.0',
+        name,
+        sourceProject,
+        savedAt: new Date().toISOString(),
+        config
+    };
+    const templatePath = path_1.default.join(templatesDir, `${name}.json`);
+    await fs_extra_1.default.writeJson(templatePath, template, { spaces: 2 });
+    return template;
+}
+/**
+ * 列出所有模板
+ */
+async function listTemplates(templatesDir) {
+    if (!(await fs_extra_1.default.pathExists(templatesDir))) {
+        return [];
+    }
+    const files = await fs_extra_1.default.readdir(templatesDir);
+    const templates = [];
+    for (const file of files) {
+        if (file.endsWith('.json')) {
+            try {
+                const template = await fs_extra_1.default.readJson(path_1.default.join(templatesDir, file));
+                if (template.version && template.name && template.config) {
+                    templates.push(template);
+                }
+            }
+            catch {
+                // Skip invalid files
+            }
+        }
+    }
+    return templates.sort((a, b) => b.savedAt.localeCompare(a.savedAt));
+}
+/**
+ * 获取指定模板
+ */
+async function getTemplate(name, templatesDir) {
+    const templatePath = path_1.default.join(templatesDir, `${name}.json`);
+    if (!(await fs_extra_1.default.pathExists(templatePath))) {
+        return null;
+    }
+    return await fs_extra_1.default.readJson(templatePath);
+}
+/**
+ * 删除模板
+ */
+async function removeTemplate(name, templatesDir) {
+    const templatePath = path_1.default.join(templatesDir, `${name}.json`);
+    if (!(await fs_extra_1.default.pathExists(templatePath))) {
+        throw new Error(`Template not found: ${name}`);
+    }
+    await fs_extra_1.default.remove(templatePath);
+}

package/dist/index.js

@@ -6,6 +6,7 @@ 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 template_1 = require("./commands/template");
 const help_1 = require("./commands/help");
 const program = new commander_1.Command();
 program
@@ -76,6 +77,37 @@ configCmd
     .action(async () => {
     await (0, config_1.handleConfigList)();
 });
+// Template commands
+const templateCmd = program
+    .command('template')
+    .description('Template management')
+    .alias('tpl');
+templateCmd
+    .command('save')
+    .description('Save current project config as template')
+    .option('-n, --name <name>', 'Template name (default: project directory name)')
+    .action(async (options) => {
+    await (0, template_1.handleTemplateSave)(options);
+});
+templateCmd
+    .command('list')
+    .alias('ls')
+    .description('List all saved templates')
+    .action(async () => {
+    await (0, template_1.handleTemplateList)();
+});
+templateCmd
+    .command('rm <name>')
+    .description('Remove a template')
+    .action(async (name) => {
+    await (0, template_1.handleTemplateRemove)(name);
+});
+templateCmd
+    .command('use [name]')
+    .description('Apply a template to current project')
+    .action(async (name) => {
+    await (0, template_1.handleTemplateUse)(name);
+});
 // Project commands
 program
     .command('use [sources...]')

package/dist/types/config.d.ts

@@ -66,3 +66,13 @@ export interface GlobalExportConfig {
     config: GlobalConfig;
     exportedAt: string;
 }
+/**
+ * 模板配置格式
+ */
+export interface TemplateConfig {
+    version: string;
+    name: string;
+    sourceProject: string;
+    savedAt: string;
+    config: ProjectConfig;
+}

package/dist/utils/path.d.ts

@@ -1,8 +1,10 @@
 export declare const GLOBAL_CONFIG_DIR: string;
 export declare const GLOBAL_CONFIG_FILE: string;
+export declare const TEMPLATES_DIR: string;
 export declare const DEFAULT_CONFIG: {
     sourcesDir: string;
     sources: {};
 };
+export declare function getTemplatePath(templateName: string): string;
 export declare function getToolsccDir(projectDir: string): string;
 export declare function getProjectConfigPath(projectDir: string): string;

package/dist/utils/path.js

@@ -3,17 +3,22 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_CONFIG = exports.GLOBAL_CONFIG_FILE = exports.GLOBAL_CONFIG_DIR = void 0;
+exports.DEFAULT_CONFIG = exports.TEMPLATES_DIR = exports.GLOBAL_CONFIG_FILE = exports.GLOBAL_CONFIG_DIR = void 0;
+exports.getTemplatePath = getTemplatePath;
 exports.getToolsccDir = getToolsccDir;
 exports.getProjectConfigPath = getProjectConfigPath;
 const os_1 = __importDefault(require("os"));
 const path_1 = __importDefault(require("path"));
 exports.GLOBAL_CONFIG_DIR = path_1.default.join(os_1.default.homedir(), '.tools-cc');
 exports.GLOBAL_CONFIG_FILE = path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'config.json');
+exports.TEMPLATES_DIR = path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'templates');
 exports.DEFAULT_CONFIG = {
     sourcesDir: path_1.default.join(exports.GLOBAL_CONFIG_DIR, 'sources'),
     sources: {}
 };
+function getTemplatePath(templateName) {
+    return path_1.default.join(exports.TEMPLATES_DIR, `${templateName}.json`);
+}
 function getToolsccDir(projectDir) {
     return path_1.default.join(projectDir, '.toolscc');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tools-cc",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "tools-cc [options] <command> [args]",
   "main": "index.js",
   "directories": {
@@ -18,14 +18,14 @@
     "release": "npm run tag:create && npm run publish:npm && npm run release:gh"
   },
   "bin": {
-    "tools-cc": "./dist/index.js"
+    "tools-cc": "dist/index.js"
   },
   "keywords": [],
   "author": "",
   "license": "ISC",
   "repository": {
     "type": "git",
-    "url": "https://github.com/q759410559/tools-cc.git"
+    "url": "git+https://github.com/q759410559/tools-cc.git"
   },
   "bugs": {
     "url": "https://github.com/q759410559/tools-cc/issues"

package/src/commands/template.ts

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

package/src/core/template.ts

@@ -0,0 +1,91 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { TemplateConfig, ProjectConfig } from '../types';
+
+/**
+ * 保存项目配置为模板
+ */
+export async function saveTemplate(
+  name: string,
+  sourceProject: string,
+  config: ProjectConfig,
+  templatesDir: string
+): Promise<TemplateConfig> {
+  if (!name || !name.trim()) {
+    throw new Error('Template name is required');
+  }
+
+  await fs.ensureDir(templatesDir);
+
+  const template: TemplateConfig = {
+    version: '1.0',
+    name,
+    sourceProject,
+    savedAt: new Date().toISOString(),
+    config
+  };
+
+  const templatePath = path.join(templatesDir, `${name}.json`);
+  await fs.writeJson(templatePath, template, { spaces: 2 });
+
+  return template;
+}
+
+/**
+ * 列出所有模板
+ */
+export async function listTemplates(templatesDir: string): Promise<TemplateConfig[]> {
+  if (!(await fs.pathExists(templatesDir))) {
+    return [];
+  }
+
+  const files = await fs.readdir(templatesDir);
+  const templates: TemplateConfig[] = [];
+
+  for (const file of files) {
+    if (file.endsWith('.json')) {
+      try {
+        const template = await fs.readJson(path.join(templatesDir, file));
+        if (template.version && template.name && template.config) {
+          templates.push(template);
+        }
+      } catch {
+        // Skip invalid files
+      }
+    }
+  }
+
+  return templates.sort((a, b) => b.savedAt.localeCompare(a.savedAt));
+}
+
+/**
+ * 获取指定模板
+ */
+export async function getTemplate(
+  name: string,
+  templatesDir: string
+): Promise<TemplateConfig | null> {
+  const templatePath = path.join(templatesDir, `${name}.json`);
+
+  if (!(await fs.pathExists(templatePath))) {
+    return null;
+  }
+
+  return await fs.readJson(templatePath);
+}
+
+/**
+ * 删除模板
+ */
+export async function removeTemplate(
+  name: string,
+  templatesDir: string
+): Promise<void> {
+  const templatePath = path.join(templatesDir, `${name}.json`);
+
+  if (!(await fs.pathExists(templatePath))) {
+    throw new Error(`Template not found: ${name}`);
+  }
+
+  await fs.remove(templatePath);
+}