@zjex/git-workflow 0.3.0 → 0.3.2

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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zjex/git-workflow",
-	"version": "0.3.0",
+	"version": "0.3.2",
 	"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/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 "代码已更新"
 

package/src/ai-service.ts

@@ -291,10 +291,16 @@ async function callOllamaAPI(
 
 /**
  * 清理AI生成的commit message
- * 移除重复行和多余的空行
+ * 移除重复行、多余的空行和开头的特殊字符
  */
 function cleanAIResponse(response: string): string {
-  const lines = response.split('\n').map(line => line.trim()).filter(line => line);
+  // 移除开头的特殊字符（如 ...、```、等）
+  let cleaned = response.replace(/^[.\s`~-]+/, '').trim();
+  
+  // 移除结尾的特殊字符
+  cleaned = cleaned.replace(/[.\s`~-]+$/, '').trim();
+  
+  const lines = cleaned.split('\n').map(line => line.trim()).filter(line => line);
   
   // 移除重复的行
   const uniqueLines = [];

package/src/commands/commit.ts

@@ -285,6 +285,7 @@ export async function commit(): Promise<void> {
     // 显示提交信息
     const commitHash = execOutput("git rev-parse --short HEAD");
     console.log(colors.dim(`commit: ${commitHash}`));
+    console.log("");
   } catch (error) {
     spinner.fail("提交失败");
     console.log("");
@@ -299,6 +300,9 @@ export async function commit(): Promise<void> {
     console.log(colors.yellow("你可以手动执行以下命令:"));
     console.log(colors.cyan(`  git commit -m "${message}"`));
     console.log("");
+    
+    // 重新抛出错误，让调用者知道提交失败了
+    throw error;
   }
 }