@zjex/git-workflow 0.3.0 → 0.3.3

package/docs/features/git-wrapped.md

@@ -0,0 +1,199 @@
+# 🎉 Git Wrapped - 年度编程回顾
+
+> 将你的Git活动转化为精美的年度报告，让编程成就可视化
+
+## 📋 功能概述
+
+Git Wrapped 是一个受 Spotify Wrapped 启发的功能，它分析你的Git提交历史，生成一份精美的年度编程报告。这不仅是对过去一年编程工作的总结，更是对个人成长的庆祝。
+
+## 🎯 核心功能
+
+### 基础命令
+```bash
+gw wrapped              # 生成当前年份报告
+gw wrapped 2024         # 生成指定年份报告
+gw wrapped --share      # 生成可分享的图片版本
+gw wrapped --format png # 指定输出格式 (png/svg/pdf)
+gw wrapped --theme dark # 指定主题风格
+```
+
+### 高级选项
+```bash
+gw wrapped --repo ./my-project    # 分析特定仓库
+gw wrapped --author "张三"        # 分析特定作者
+gw wrapped --range 2024-01-01..2024-12-31  # 自定义时间范围
+gw wrapped --compare 2023         # 与去年对比
+gw wrapped --team                  # 生成团队报告
+```
+
+## 📊 报告内容
+
+### 1. 📈 基础统计
+- **总提交数**: 今年的总提交次数
+- **活跃天数**: 有提交活动的天数
+- **最长连击**: 连续提交的最长天数
+- **代码行数**: 新增/删除的代码行数统计
+- **文件变更**: 修改的文件总数
+
+### 2. 🏆 年度亮点
+- **最忙碌的月份**: 提交最多的月份
+- **最活跃时间**: 最常提交的时间段
+- **最大单日提交**: 单日最多提交次数
+- **里程碑时刻**: 重要的提交节点
+- **项目贡献**: 贡献最多的项目
+
+### 3. 💻 技术分析
+- **编程语言分布**: 各语言使用占比
+- **文件类型统计**: 最常修改的文件类型
+- **提交类型分析**: feat/fix/docs等类型分布
+- **项目活跃度**: 各项目的贡献分布
+
+### 4. ⏰ 时间模式
+- **编程习惯**: 早鸟 vs 夜猫子分析
+- **工作日 vs 周末**: 工作时间分布
+- **月度趋势**: 全年活跃度变化曲线
+- **季节性模式**: 不同季节的编程活跃度
+
+### 5. 🎨 个性化洞察
+- **编程风格**: 基于提交信息的风格分析
+- **专注度**: 单次提交的平均文件数
+- **完美主义指数**: 小提交 vs 大提交的比例
+- **探索精神**: 新项目/新语言的尝试次数
+
+## 🎨 视觉设计
+
+### 终端版本
+```
+╭─────────────────────────────────────────────────────────────╮
+│                    🎉 2024 Git Wrapped 🎉                    │
+├─────────────────────────────────────────────────────────────┤
+│                                                             │
+│  📊 你的编程年度数据                                          │
+│  ├─ 总提交数: 1,247 次 (+23% vs 2023)                       │
+│  ├─ 活跃天数: 287 天 (78.6% 的日子)                         │
+│  ├─ 最长连击: 45 天 🔥                                       │
+│  └─ 代码贡献: +15,432 / -8,901 行                           │
+│                                                             │
+│  🏆 年度亮点                                                 │
+│  ├─ 最忙月份: 三月 (156 次提交)                             │
+│  ├─ 夜猫子指数: 68% (你更喜欢夜晚编程)                       │
+│  ├─ 最爱语言: TypeScript (42.3%)                            │
+│  └─ 主力项目: git-workflow (312 次提交)                     │
+│                                                             │
+│  🎯 成就解锁                                                 │
+│  ├─ 🔥 连击大师 (连续30天提交)                               │
+│  ├─ 🌙 夜猫子 (凌晨提交超过100次)                            │
+│  ├─ 🚀 效率之王 (单日最多23次提交)                           │
+│  └─ 📝 文档达人 (docs类型提交占15%)                          │
+│                                                             │
+╰─────────────────────────────────────────────────────────────╯
+```
+
+### 分享版本 (图片)
+- **卡片式设计**: 类似Instagram Story的竖版布局
+- **渐变背景**: 根据主要编程语言生成配色
+- **图表可视化**: 饼图、柱状图、热力图等
+- **个人头像**: 集成GitHub头像
+- **二维码**: 链接到个人GitHub或项目
+
+## 🛠️ 技术实现
+
+### 数据收集
+```typescript
+interface GitWrappedData {
+  year: number;
+  totalCommits: number;
+  activeDays: number;
+  longestStreak: number;
+  linesAdded: number;
+  linesDeleted: number;
+  languages: LanguageStats[];
+  repositories: RepoStats[];
+  timePatterns: TimePattern;
+  commitTypes: CommitTypeStats;
+  achievements: Achievement[];
+}
+```
+
+### 分析算法
+1. **Git日志解析**: 使用`git log`命令获取提交历史
+2. **语言检测**: 分析文件扩展名和Git属性
+3. **时间模式**: 统计提交时间分布
+4. **趋势分析**: 计算月度、季度变化
+5. **成就系统**: 基于规则检测特殊成就
+
+### 图片生成
+- **Canvas API**: 使用Node.js的canvas库
+- **SVG生成**: 矢量图形支持
+- **模板系统**: 可配置的设计模板
+- **字体支持**: 中英文字体兼容
+
+## 🎨 主题风格
+
+### 预设主题
+1. **GitHub风格**: 绿色系，类似GitHub贡献图
+2. **暗黑模式**: 深色背景，霓虹色彩
+3. **彩虹主题**: 渐变色彩，活泼风格
+4. **极简风格**: 黑白灰，简洁设计
+5. **节日主题**: 根据生成时间的节日风格
+
+### 自定义选项
+```bash
+gw wrapped --theme custom \
+  --bg-color "#1a1a1a" \
+  --accent-color "#00ff88" \
+  --font-family "JetBrains Mono"
+```
+
+## 📱 分享功能
+
+### 社交媒体优化
+- **Twitter**: 1200x675 横版卡片
+- **Instagram**: 1080x1920 竖版故事
+- **LinkedIn**: 1200x627 专业风格
+- **微信朋友圈**: 正方形 1080x1080
+
+### 导出格式
+- **PNG**: 高质量位图，适合分享
+- **SVG**: 矢量图形，可编辑
+- **PDF**: 打印友好格式
+- **HTML**: 交互式网页版本
+
+## 🔮 未来扩展
+
+### v1.0 增强功能
+- [ ] **AI洞察**: 使用AI分析编程模式并给出建议
+- [ ] **团队对比**: 与团队成员的数据对比
+- [ ] **目标设定**: 基于今年数据设定明年目标
+- [ ] **历史对比**: 多年数据的趋势分析
+
+### v2.0 高级功能
+- [ ] **Web仪表板**: 在线查看和分享
+- [ ] **实时更新**: 年度数据的实时追踪
+- [ ] **集成API**: 与其他平台的数据整合
+- [ ] **团队版本**: 企业级团队分析
+
+## 💡 使用场景
+
+### 个人用途
+- **年终总结**: 个人技术成长回顾
+- **简历亮点**: 展示编程活跃度
+- **社交分享**: 在社交媒体展示成就
+- **自我激励**: 通过数据可视化保持动力
+
+### 团队用途
+- **团队回顾**: 团队年度技术总结
+- **绩效展示**: 可视化团队贡献
+- **文化建设**: 增强团队凝聚力
+- **招聘宣传**: 展示团队技术实力
+
+## 🎯 成功指标
+
+- **用户参与度**: 生成报告的用户数量
+- **分享率**: 用户分享图片的比例
+- **回访率**: 用户重复使用的频率
+- **社交影响**: 在社交媒体的传播效果
+
+---
+
+*这个功能将让Git Workflow不仅仅是一个工具，更是一个让开发者为自己的编程旅程感到骄傲的平台。*

package/docs/index.md

@@ -23,6 +23,9 @@ features:
   - icon: 🎯
     title: 规范命名
     details: 自动生成带日期的规范分支名，如 feature/20260109-PROJ-123-add-login
+  - icon: 📋
+    title: 优雅日志
+    details: GitHub 风格的提交历史查看，时间线分组，交互式浏览，支持搜索和过滤
   - icon: 🏷️
     title: 智能版本
     details: 自动识别当前版本，交互式选择下一版本，支持 semver + 预发布版本
@@ -126,6 +129,32 @@ gw f
 # ✔ 分支创建成功: feature/20260109-PROJ-123-add-user-login
 ```
 
+### 📋 优雅的提交历史
+
+GitHub 风格的提交历史查看，让代码历史一目了然：
+
+```bash
+gw log
+# ┌─────────────────────────────────────────────────────────────────────────────┐
+# │                                Git 提交历史                                │
+# ├─────────────────────────────────────────────────────────────────────────────┤
+# │                                                                             │
+# │ 📅 今天                                                                     │
+# │                                                                             │
+# │ ✅ test: 完善commit message格式化测试用例                                   │
+# │    🔗 #8d74ffa • 2小时前 • zjex                                            │
+# │                                                                             │
+# │ 🔧 chore: 删除重复的测试文件                                               │
+# │    🔗 #746aa87 • 3小时前 • zjex                                            │
+# │                                                                             │
+# │ 📅 昨天                                                                     │
+# │                                                                             │
+# │ ✨ feat(log): 实现GitHub风格的提交历史查看                                  │
+# │    🔗 #a1b2c3d • 1天前 • zjex                                              │
+# │    🔖 v0.3.0                                                               │
+# └─────────────────────────────────────────────────────────────────────────────┘
+```
+
 ### 🏷️ 智能版本管理
 
 自动检测现有 tag 前缀，智能递增版本号：
@@ -164,6 +193,7 @@ gw s
 | 分支命名规范     | ✅ 自动生成   | ❌ 需手动   | ❌ 需手动 |
 | 版本号管理       | ✅ 智能递增   | ❌ 需手动   | ❌ 需手动 |
 | AI Commit        | ✅ 支持       | ❌ 不支持   | ❌ 不支持 |
+| 提交历史查看     | ✅ GitHub风格 | ❌ 不支持   | ⚠️ 原生命令 |
 | Stash 可视化管理 | ✅ 支持       | ❌ 不支持   | ❌ 不支持 |
 | 交互式操作       | ✅ 支持       | ❌ 不支持   | ❌ 不支持 |
 | 配置灵活性       | ✅ 项目级配置 | ⚠️ 有限     | -         |
@@ -187,7 +217,8 @@ Git Workflow 提供优雅的命令行界面，支持键盘快捷操作：
   [2] 🐛 创建 hotfix 分支       gw h
   [3] 🗑️  删除分支               gw d
   [4] 📝 提交代码               gw c
-  [5] 🏷️  创建 tag               gw t
+  [5] 📋 查看提交历史           gw log
+  [6] 🏷️  创建 tag               gw t
   ...
 ```
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zjex/git-workflow",
-	"version": "0.3.0",
+	"version": "0.3.3",
 	"description": "🚀 极简的 Git 工作流 CLI 工具，让分支管理和版本发布变得轻松愉快",
 	"type": "module",
 	"bin": {
@@ -54,6 +54,7 @@
 		"@inquirer/prompts": "^7.0.0",
 		"boxen": "^8.0.1",
 		"cac": "^6.7.14",
+		"node-pager": "^0.3.6",
 		"ora": "^9.0.0",
 		"semver": "^7.7.3"
 	},

package/scripts/format-commit-msg.js

@@ -0,0 +1,258 @@
+#!/usr/bin/env node
+
+/**
+ * Commit Message Emoji 格式化工具
+ * 
+ * 功能：
+ * 1. 检测 commit message 是否包含 emoji
+ * 2. 如果没有 emoji，根据 type 自动添加
+ * 3. 如果有 emoji 但与 type 不匹配，自动替换
+ * 4. 支持 Conventional Commits 规范
+ */
+
+import { readFileSync, writeFileSync, existsSync } from 'fs';
+import { homedir } from 'os';
+import path from 'path';
+
+// Emoji 映射表
+const EMOJI_MAP = {
+  feat: '✨',
+  fix: '🐛', 
+  docs: '📝',
+  style: '💄',
+  refactor: '♻️',
+  perf: '⚡️',
+  test: '✅',
+  build: '📦',
+  ci: '👷',
+  chore: '🔧',
+  revert: '⏪',
+  merge: '🔀',
+  release: '🔖',
+  hotfix: '🚑',
+  security: '🔒',
+  breaking: '💥'
+};
+
+/**
+ * 解析 commit message
+ * @param {string} message - commit message
+ * @returns {object} 解析结果
+ */
+function parseCommitMessage(message) {
+  // 移除开头和结尾的空白字符
+  const cleanMessage = message.trim();
+  
+  // 检测是否以已知的emoji开头
+  const allEmojis = Object.values(EMOJI_MAP);
+  let hasEmoji = false;
+  let currentEmoji = null;
+  let messageWithoutEmoji = cleanMessage;
+  
+  for (const emoji of allEmojis) {
+    if (cleanMessage.startsWith(emoji)) {
+      hasEmoji = true;
+      currentEmoji = emoji;
+      messageWithoutEmoji = cleanMessage.substring(emoji.length).trim();
+      break;
+    }
+  }
+  
+  // 如果没有找到已知emoji，检查是否以其他emoji开头
+  if (!hasEmoji) {
+    const emojiMatch = cleanMessage.match(/^(\p{Emoji})\s*/u);
+    if (emojiMatch) {
+      hasEmoji = true;
+      currentEmoji = emojiMatch[1];
+      messageWithoutEmoji = cleanMessage.replace(/^(\p{Emoji})\s*/u, '').trim();
+    }
+  }
+  
+  // 解析 Conventional Commits 格式: type(scope): subject
+  const conventionalMatch = messageWithoutEmoji.match(/^(\w+)(\([^)]+\))?(!)?:\s*(.+)/);
+  
+  if (!conventionalMatch) {
+    return {
+      isConventional: false,
+      hasEmoji,
+      currentEmoji,
+      originalMessage: message,
+      cleanMessage: messageWithoutEmoji
+    };
+  }
+  
+  const [, type, scope, breaking, subject] = conventionalMatch;
+  
+  return {
+    isConventional: true,
+    hasEmoji,
+    currentEmoji,
+    type: type.toLowerCase(),
+    scope: scope || '',
+    breaking: breaking === '!',
+    subject,
+    originalMessage: message,
+    cleanMessage: messageWithoutEmoji,
+    messageWithoutEmoji
+  };
+}
+
+/**
+ * 获取正确的 emoji
+ * @param {string} type - commit type
+ * @returns {string} emoji
+ */
+function getCorrectEmoji(type) {
+  return EMOJI_MAP[type] || EMOJI_MAP.chore;
+}
+
+/**
+ * 检查 emoji 是否匹配 type
+ * @param {string} emoji - 当前 emoji
+ * @param {string} type - commit type
+ * @returns {boolean} 是否匹配
+ */
+function isEmojiCorrect(emoji, type) {
+  return emoji === getCorrectEmoji(type);
+}
+
+/**
+ * 格式化 commit message
+ * @param {string} message - 原始 commit message
+ * @returns {object} 格式化结果
+ */
+function formatCommitMessage(message) {
+  const parsed = parseCommitMessage(message);
+  
+  // 如果不是 Conventional Commits 格式，不处理
+  if (!parsed.isConventional) {
+    return {
+      needsUpdate: false,
+      originalMessage: message,
+      formattedMessage: message,
+      reason: 'Not a conventional commit format'
+    };
+  }
+  
+  const correctEmoji = getCorrectEmoji(parsed.type);
+  let needsUpdate = false;
+  let reason = '';
+  
+  // 检查是否需要更新
+  if (!parsed.hasEmoji) {
+    needsUpdate = true;
+    reason = `Added missing emoji for type '${parsed.type}'`;
+  } else if (!isEmojiCorrect(parsed.currentEmoji, parsed.type)) {
+    needsUpdate = true;
+    reason = `Replaced incorrect emoji '${parsed.currentEmoji}' with '${correctEmoji}' for type '${parsed.type}'`;
+  }
+  
+  // 构建格式化后的消息
+  const formattedMessage = needsUpdate 
+    ? `${correctEmoji} ${parsed.messageWithoutEmoji}`
+    : message;
+  
+  return {
+    needsUpdate,
+    originalMessage: message,
+    formattedMessage,
+    reason,
+    type: parsed.type,
+    currentEmoji: parsed.currentEmoji,
+    correctEmoji
+  };
+}
+
+/**
+ * 检查用户配置是否启用 emoji
+ * @returns {boolean} 是否启用 emoji
+ */
+function isEmojiEnabled() {
+  try {
+    // 尝试读取配置文件
+    const configPaths = ['.gwrc.json', '.gwrc', 'gw.config.json'];
+    
+    for (const configPath of configPaths) {
+      try {
+        if (existsSync(configPath)) {
+          const config = JSON.parse(readFileSync(configPath, 'utf-8'));
+          if (config.useEmoji !== undefined) {
+            return config.useEmoji;
+          }
+        }
+      } catch {
+        // 继续尝试下一个配置文件
+      }
+    }
+    
+    // 尝试读取全局配置
+    try {
+      const globalConfigPath = path.join(homedir(), '.gwrc.json');
+      if (existsSync(globalConfigPath)) {
+        const globalConfig = JSON.parse(readFileSync(globalConfigPath, 'utf-8'));
+        if (globalConfig.useEmoji !== undefined) {
+          return globalConfig.useEmoji;
+        }
+      }
+    } catch {
+      // 忽略全局配置错误
+    }
+    
+    // 默认启用 emoji
+    return true;
+  } catch {
+    return true;
+  }
+}
+
+/**
+ * 主函数
+ */
+function main() {
+  // 获取 commit message 文件路径
+  const commitMsgFile = process.argv[2];
+  
+  if (!commitMsgFile) {
+    console.error('Error: No commit message file provided');
+    process.exit(1);
+  }
+  
+  try {
+    // 检查是否启用 emoji
+    if (!isEmojiEnabled()) {
+      // 如果禁用了 emoji，直接退出
+      process.exit(0);
+    }
+    
+    // 读取 commit message
+    const originalMessage = readFileSync(commitMsgFile, 'utf-8').trim();
+    
+    // 跳过空消息或合并消息
+    if (!originalMessage || originalMessage.startsWith('Merge ')) {
+      process.exit(0);
+    }
+    
+    // 格式化消息
+    const result = formatCommitMessage(originalMessage);
+    
+    // 如果需要更新
+    if (result.needsUpdate) {
+      // 写入格式化后的消息
+      writeFileSync(commitMsgFile, result.formattedMessage + '\n');
+      
+      // 输出提示信息
+      console.log(`\n🎨 Commit message formatted:`);
+      console.log(`   ${result.reason}`);
+      console.log(`   Before: ${result.originalMessage}`);
+      console.log(`   After:  ${result.formattedMessage}\n`);
+    }
+    
+    process.exit(0);
+  } catch (error) {
+    console.error('Error formatting commit message:', error.message);
+    process.exit(0); // 不阻止提交，只是跳过格式化
+  }
+}
+
+// 运行主函数
+main();

package/scripts/release.sh

@@ -138,7 +138,67 @@ print_success "已登录 npm (用户: ${NPM_USER})"
 # 拉取最新代码
 print_step "拉取最新代码..."
 if [[ "$DRY_RUN" == false ]]; then
-  git pull origin "$CURRENT_BRANCH"
+  # 检查是否有远程更新
+  git fetch origin "$CURRENT_BRANCH"
+  
+  # 检查本地和远程是否有分歧
+  LOCAL_COMMIT=$(git rev-parse HEAD)
+  REMOTE_COMMIT=$(git rev-parse "origin/$CURRENT_BRANCH")
+  
+  if [[ "$LOCAL_COMMIT" != "$REMOTE_COMMIT" ]]; then
+    print_warning "检测到本地和远程分支有分歧"
+    
+    # 检查是否可以快进
+    if git merge-base --is-ancestor HEAD "origin/$CURRENT_BRANCH"; then
+      print_info "远程有新提交，正在快进合并..."
+      git pull origin "$CURRENT_BRANCH" --ff-only
+    elif git merge-base --is-ancestor "origin/$CURRENT_BRANCH" HEAD; then
+      print_info "本地有新提交，需要推送到远程"
+      print_warning "建议先推送本地提交再发布"
+      read -p "是否继续发布? (y/N) " -n 1 -r
+      echo
+      if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+        print_info "已取消，请先推送本地提交: git push origin $CURRENT_BRANCH"
+        exit 0
+      fi
+    else
+      print_warning "本地和远程分支有冲突，需要解决分歧"
+      echo ""
+      echo "建议的解决方案："
+      echo "1. 使用 rebase: git pull origin $CURRENT_BRANCH --rebase"
+      echo "2. 使用 merge:  git pull origin $CURRENT_BRANCH --no-rebase"
+      echo ""
+      read -p "选择解决方案 (1=rebase, 2=merge, q=退出): " -n 1 -r
+      echo
+      
+      case $REPLY in
+        1)
+          print_info "使用 rebase 策略合并..."
+          if git pull origin "$CURRENT_BRANCH" --rebase; then
+            print_success "Rebase 成功"
+          else
+            print_error "Rebase 失败，请手动解决冲突后重新运行发布脚本"
+            exit 1
+          fi
+          ;;
+        2)
+          print_info "使用 merge 策略合并..."
+          if git pull origin "$CURRENT_BRANCH" --no-rebase; then
+            print_success "Merge 成功"
+          else
+            print_error "Merge 失败，请手动解决冲突后重新运行发布脚本"
+            exit 1
+          fi
+          ;;
+        *)
+          print_info "已取消，请手动解决分支分歧后重新运行"
+          exit 0
+          ;;
+      esac
+    fi
+  else
+    print_info "本地和远程分支已同步"
+  fi
 fi
 print_success "代码已更新"