Détail du package

template-syncer

IceyWu149MIT1.0.3

智能模板同步工具 - 让你的项目与模板仓库保持同步，支持智能合并、差异对比和交互式更新

template, sync, vitesse, vue

readme

Template Syncer

智能模板同步工具，让你的项目与模板仓库保持同步。

GitHub Repo stars npm npm downloads

✨ 特性

  • 🚀 智能同步 - 自动检测并同步模板更新
  • 🎇 自动扫描 - 智能扫描当前目录的所有可同步文件
  • ✅ 批量选择 - 支持全选/反选，批量处理文件
  • 🔍 智能对比 - 先对比差异，再选择性更新
  • 📦 智能合并 - 特别针对 package.json 的智能合并策略
  • 🔄 差异对比 - 使用 Git diff 显示文件变更
  • 💾 安全备份 - 操作前自动创建 Git 备份
  • 🎯 两阶段确认 - 先选择文件，再选择更新项

📦 安装

npm install -g template-syncer

🚀 使用方法

基本用法

# 交互式同步（会询问模板仓库）
syn

# 指定模板仓库
syn --repo https://github.com/IceyWu/cloud-template.git

# 指定模板仓库和分支
syn --repo https://github.com/IceyWu/cloud-template.git --branch dev

# 详细模式
syn --verbose

# 只指定分支（会使用配置文件中的仓库）
syn --branch main

同步流程

  1. 文件扫描 - 自动扫描当前目录下的所有支持文件
  2. 仓库克隆 - 克隆指定的模板仓库
  3. 分支选择 - 如果未指定分支，会列出所有分支供选择
  4. 文件选择 - 默认全选，可以自定义选择要检查的文件
  5. 差异对比 - 与模板进行对比，找出有变化的文件
  6. 变更选择 - 选择要更新的文件，可以预览差异
  7. 批量更新 - 一次性更新所有选中的文件

支持的文件类型

  • 配置文件: .json, .yml, .yaml, .xml
  • 代码文件: .js, .ts, .jsx, .tsx
  • 样式文件: .css, .scss, .less
  • 文档文件: .md, .txt
  • 配置文件: .gitignore, .npmrc, .eslintrc, .prettierrc 等
  • 容器文件: Dockerfile, .dockerignore
  • 构建文件: Makefile, 各种配置文件

初始化配置

syn --init

分支支持

Tool 支持从任意分支同步模板：

  • 指定分支: 使用 --branch 参数指定要同步的分支
  • 交互选择: 如果不指定分支，工具会列出所有可用分支供你选择
  • 配置保存: 可以在初始化配置时设置默认分支
# 从 dev 分支同步
syn --repo https://github.com/owner/repo.git --branch dev

# 从 feature/new-ui 分支同步
syn --repo https://github.com/owner/repo.git --branch feature/new-ui

# 不指定分支，工具会列出所有分支让你选择
syn --repo https://github.com/owner/repo.git

🛡️ 安全性

  • Git 备份: 操作前自动创建 stash 备份
  • 交互确认: 每个文件更改都需要用户确认
  • 差异显示: 清楚展示即将进行的更改

📄 许可证

MIT License