@zjex/git-workflow 0.3.0 → 0.3.3

package/.husky/commit-msg

@@ -0,0 +1,5 @@
+#!/usr/bin/env sh
+. "$(dirname -- "$0")/_/husky.sh"
+
+# 格式化 commit message（自动添加/修正 emoji）
+node scripts/format-commit-msg.js "$1"

package/.husky/pre-commit

@@ -1,11 +1,8 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
 # 运行测试
 echo "正在运行测试..."
 npm test
 
-# 如果测试失败，询问用户是否继续
+# 检查测试结果
 if [ $? -ne 0 ]; then
   echo ""
   echo "⚠️  测试失败！"
@@ -16,4 +13,4 @@ if [ $? -ne 0 ]; then
   exit 1
 fi
 
-echo "✅ 测试通过，继续提交..."
+echo "✅ 测试通过，继续提交..."

package/README.md

@@ -12,7 +12,7 @@
   <a href="https://github.com/iamzjt-front-end/git-workflow"><img src="https://img.shields.io/github/stars/iamzjt-front-end/git-workflow?style=flat&colorA=18181B&colorB=F59E0B" alt="github stars"></a>
   <a href="https://github.com/iamzjt-front-end/git-workflow/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@zjex/git-workflow?style=flat&colorA=18181B&colorB=10B981" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat&logo=node.js&logoColor=white&colorA=18181B" alt="node version"></a>
-  <a href="https://github.com/iamzjt-front-end/git-workflow/actions"><img src="https://img.shields.io/badge/tests-231%20passed-success?style=flat&colorA=18181B" alt="tests"></a>
+  <a href="https://github.com/iamzjt-front-end/git-workflow/actions"><img src="https://img.shields.io/badge/tests-266%20passed-success?style=flat&colorA=18181B" alt="tests"></a>
   <a href="https://github.com/iamzjt-front-end/git-workflow/issues"><img src="https://img.shields.io/github/issues/iamzjt-front-end/git-workflow?style=flat&colorA=18181B&colorB=EC4899" alt="issues"></a>
 </p>
 

package/ROADMAP.md

@@ -0,0 +1,356 @@
+# 🗺️ Git Workflow 功能路线图
+
+> 记录和管理即将实现的功能，按优先级和开发阶段组织
+
+## 📋 当前状态
+
+- **版本**: v0.3.0
+- **测试覆盖**: 231 个测试用例
+- **核心功能**: ✅ 完成
+- **文档**: ✅ 完成
+- **品牌标识**: ✅ 完成
+
+---
+
+## 🎯 高优先级功能 (v0.3.x)
+
+### 0. 🔍 AI Code Review - ⭐ 最高优先级
+
+- [ ] `gw review` - AI 智能代码审查
+  - 自动分析暂存区或指定提交的代码变更
+  - 多维度审查：Bug 检测、安全漏洞、性能问题、代码规范
+  - 提供具体的修改建议和代码示例
+  - 支持自定义审查规则和忽略模式
+- [ ] `gw review --staged` - 审查暂存区的更改
+  - 提交前快速检查代码质量
+  - 发现潜在问题，避免低质量提交
+- [ ] `gw review HEAD~3..HEAD` - 审查指定范围的提交
+
+  - 支持 Git 提交范围语法
+  - 批量审查多个提交的变更
+    **审查维度**:
+
+- 🐛 **Bug 检测**: 空指针、数组越界、逻辑错误、边界条件
+- 🔒 **安全漏洞**: SQL 注入、XSS、敏感信息泄露、不安全的依赖
+- ⚡ **性能问题**: 内存泄漏、N+1 查询、不必要的循环、资源未释放
+- 📝 **代码规范**: 命名规范、注释完整性、代码复杂度、重复代码
+- 🏗️ **架构建议**: 设计模式、模块化、可测试性、可维护性
+
+**输出格式示例**:
+
+```
+📋 代码审查报告
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+
+🔴 严重问题 (2)
+  ├─ src/api.ts:45 - SQL注入风险
+  │  建议: 使用参数化查询替代字符串拼接
+  └─ src/auth.ts:23 - 密码明文存储
+     建议: 使用bcrypt进行密码哈希
+
+🟡 警告 (3)
+  ├─ src/utils.ts:12 - 未处理的Promise rejection
+  ├─ src/data.ts:78 - 可能的内存泄漏
+  └─ src/handler.ts:34 - 函数复杂度过高(15)
+
+🔵 建议 (5)
+  ├─ src/config.ts:8 - 建议添加类型注解
+  └─ ... 更多建议
+
+✅ 总结: 发现2个严重问题，3个警告，5个建议
+```
+
+**配置选项**:
+
+- `review.severity` - 最低报告级别 (error/warning/info)
+- `review.ignore` - 忽略的文件或规则
+- `review.customRules` - 自定义审查规则
+- `review.language` - 报告语言 (zh/en)
+
+**技术难点**: AI 模型集成、代码语义分析、多语言支持
+**独特价值**: 提交前的最后一道防线，提升代码质量，减少 Code Review 负担
+
+### 1. 🎉 年度回顾 (Git Wrapped) - 🔥 杀手级功能
+
+- [ ] `gw wrapped` - 生成年度编程报告
+  - 自动分析当前年份的 Git 活动
+  - 生成精美的终端输出报告
+  - 包含提交统计、语言分布、活跃时间等
+- [ ] `gw wrapped 2024` - 指定年份分析
+  - 支持分析任意年份的数据
+  - 历史数据对比功能
+- [ ] `gw wrapped --share` - 生成可分享的图片
+  - 输出 PNG/SVG 格式的精美报告卡片
+  - 适合社交媒体分享
+  - 支持多种主题风格
+
+**功能亮点**:
+
+- 📊 提交统计和趋势图表
+- � 最活跃的月份/季度/时间段
+- 💻 编程语言使用分布
+- 🎯 最大贡献的项目/仓库
+- 🔥 最长连击记录和活跃天数
+- 📝 提交信息风格分析
+- 🌟 年度编程亮点和里程碑
+- ⏰ 编程时间习惯分析（早鸟 vs 夜猫子）
+
+**技术难点**: 数据聚合分析、图表生成、图片渲染
+**独特价值**: 市场上唯一的 Git 年度回顾工具，具有病毒式传播潜力
+
+### 2. 📊 Git 日志和历史查看 - 解决真实痛点
+
+- [ ] `gw log` - 美化的提交历史查看
+  - 彩色输出，图形化分支显示
+  - 支持筛选（作者、日期、关键词）
+  - 分页显示，交互式导航
+- [ ] `gw recent` - 显示最近的提交
+  - 可配置天数（默认 7 天）
+  - 按作者分组显示
+- [ ] `gw authors` - 显示贡献者统计
+  - 提交数量、代码行数统计
+  - 时间范围筛选
+
+**技术难点**: 图形化分支显示、性能优化
+**独特价值**: 比原生 git log 更美观，比 lazygit 更简洁
+
+### 3. 🌿 分支管理增强 - 高频使用场景
+
+- [ ] `gw recent-branches` - 显示最近使用的分支
+  - 按最后使用时间排序
+  - 显示分支状态（ahead/behind）
+  - 快速切换功能
+- [ ] `gw switch` - 交互式分支切换
+  - 模糊搜索分支名
+  - 显示分支描述和状态
+  - 支持远程分支
+
+**技术难点**: 分支状态检测、搜索算法
+**独特价值**: 解决多分支项目的切换痛点
+
+### 4. 🤖 AI 智能 Merge - � 革命性功能
+
+- [ ] `gw merge --ai` - AI 自动处理 merge 冲突
+  - 自动识别和处理简单冲突（import、格式化等）
+  - 智能分析复杂冲突，提供解决建议
+  - 基于代码语义理解的冲突博弈
+  - 学习用户偏好，提升决策准确性
+- [ ] `gw merge --preview` - 冲突预览和分析
+  - merge 前预测可能的冲突
+  - 显示冲突复杂度和建议策略
+  - 提供冲突解决时间估算
+- [ ] `gw merge --safe` - 安全模式 merge
+  - 自动创建备份分支
+  - 重要文件强制人工确认
+  - 提供一键回滚功能
+
+**技术难点**: AI 模型集成、代码语义分析、安全机制
+**独特价值**: 市场首个 AI 驱动的 merge 冲突处理工具，解决开发者最大痛点
+
+### 5. �🔍 提交历史搜索 - 实用工具
+
+- [ ] `gw search` - 在提交历史中搜索
+  - 支持提交信息、作者、文件名搜索
+  - 正则表达式支持
+  - 结果高亮显示
+  - AI 增强的语义搜索
+
+**技术难点**: 搜索性能、结果展示
+**独特价值**: AI 增强的智能搜索，理解搜索意图
+
+---
+
+## 🚀 中优先级功能 (v0.4.x)
+
+### 1. 👥 团队协作功能
+
+- [ ] `gw standup` - 显示团队成员最近的工作
+  - 可配置时间范围和团队成员
+  - 按项目/仓库分组
+  - 支持多仓库扫描
+- [ ] `gw summary` - 仓库统计信息
+  - 代码行数、文件数统计
+  - 语言分布、活跃度分析
+  - 贡献者排行榜
+
+**技术难点**: 多仓库管理、数据聚合
+
+### 2. 🔗 GitHub 集成增强
+
+- [ ] `gw pr` - PR 管理功能
+  - 创建、查看、合并 PR
+  - PR 状态检查（CI/CD）
+  - 代码审查集成
+- [ ] `gw issues` - Issue 管理
+  - 创建、查看、关闭 Issue
+  - 标签和里程碑管理
+- [ ] `gw repo` - 仓库信息和统计
+  - Star、Fork、Watch 数据
+  - Release 信息
+  - 贡献者信息
+
+**技术难点**: GitHub API 集成、认证管理
+
+### 3. 🎨 增强的 diff 显示
+
+- [ ] `gw diff` - 语法高亮的 diff 显示
+  - 集成 delta 或类似工具
+  - 支持 side-by-side 显示
+  - 文件类型智能识别
+
+**技术难点**: 语法高亮、布局优化
+
+---
+
+## 🔮 低优先级功能 (v0.5.x+)
+
+### 1. 🛠️ 高级工具
+
+- [ ] `gw blame` - 交互式 blame 查看
+- [ ] `gw template` - commit message 模板管理
+- [ ] `gw hooks` - Git hooks 管理
+- [ ] `gw alias` - Git 别名管理
+- [ ] `gw ignore` - 交互式.gitignore 管理
+
+### 2. 🔄 工作流程优化
+
+- [ ] `gw backup` - 创建当前工作的备份
+- [ ] `gw undo` - 智能撤销操作
+- [ ] `gw changed` - 显示最近更改的文件
+
+### 3. ❌ 已移除功能 (不再考虑实现)
+
+- ~~交互式 Rebase 简化~~ - 原生 Git rebase 已足够好用
+- ~~智能 Cherry-pick~~ - 原生 cherry-pick 已足够好用
+- ~~智能同步功能~~ - 用户自己 stash + pull 即可
+- ~~浏览器集成~~ - 偏离 CLI 工具初衷，价值不大
+
+---
+
+## 🎯 现有功能优化计划
+
+### AI Commit 增强 (v0.3.1)
+
+- [ ] 支持多种 commit 风格选择
+  - Conventional Commits（当前）
+  - Gitmoji 风格
+  - 自定义模板
+- [ ] 批量 commit 功能
+  - 智能分组相关更改
+  - 支持部分文件提交
+- [ ] commit 模板系统
+  - 项目级模板
+  - 个人模板库
+
+### 分支管理优化 (v0.3.2)
+
+- [ ] 分支描述功能
+  - 添加/编辑分支描述
+  - 在分支列表中显示描述
+- [ ] 分支模板
+  - 预定义分支命名规则
+  - 自动添加分支描述
+- [ ] 分支保护检查
+  - 检测保护分支规则
+  - 提交前验证
+
+### 发布流程增强 (v0.3.3)
+
+- [ ] 多环境发布支持
+  - dev/staging/prod 环境配置
+  - 环境特定的发布流程
+- [ ] 回滚功能
+  - 快速回滚到指定版本
+  - 回滚影响分析
+- [ ] CI/CD 集成
+  - 检查 CI 状态
+  - 等待部署完成
+
+---
+
+## 📊 开发计划
+
+### Q1 2025 (v0.3.1-0.3.3)
+
+- ⭐ **最高优先级**: AI Code Review (`gw review`)
+- ✅ 完成高优先级功能中的 3-4 个
+- 🎯 重点：用户体验提升，核心工作流优化
+
+### Q2 2025 (v0.4.0)
+
+- 🎯 团队协作功能
+- 🎯 GitHub 深度集成
+- 🎯 性能优化
+
+### Q3 2025 (v0.5.0)
+
+- 🎯 高级工具和自定义功能
+- 🎯 插件系统（如果需要）
+- 🎯 企业级功能
+
+---
+
+## 🤝 贡献指南
+
+### 如何选择功能实现
+
+1. **用户价值** - 功能对用户的实际价值
+2. **实现复杂度** - 开发难度和时间成本
+3. **维护成本** - 长期维护的复杂度
+4. **社区需求** - 用户反馈和请求
+
+### 开发流程
+
+1. 在此文件中标记功能状态
+2. 创建对应的 Issue 讨论设计
+3. 实现功能并添加测试
+4. 更新文档
+5. 发布版本
+
+---
+
+## 📝 更新日志
+
+- **2025-01-12**: 添加 AI Code Review 功能作为最高优先级（第 0 项）
+- **2025-01-11**: 创建路线图，当前版本 v0.3.0，规划后续功能
+- **待更新**: 根据开发进度持续更新
+
+---
+
+## 💡 想法收集
+
+> 记录临时想法和用户建议，定期整理到正式计划中
+
+### Git Wrapped 扩展想法
+
+- [ ] 🏆 成就系统集成 - 在年度报告中展示解锁的成就
+- [ ] 📈 多年对比 - 对比不同年份的编程成长
+- [ ] 🎨 自定义主题 - 支持多种视觉风格（暗黑、彩虹、极简等）
+- [ ] 📱 移动端适配 - 生成适合手机分享的竖版图片
+- [ ] 🌍 团队版本 - 生成整个团队的年度报告
+- [ ] 🎵 音乐集成 - 根据编程语言推荐"年度编程歌单"
+- [ ] 📝 AI 总结 - 用 AI 生成个性化的年度编程故事
+- [ ] 🎯 目标设定 - 基于今年数据设定明年目标
+
+### AI Git 操作扩展想法
+
+- [ ] 🤖 AI 智能 Rebase - 自动分析提交关系，智能建议合并/重排/拆分操作
+- [ ] 🍒 AI 智能 Cherry-pick - 基于代码语义推荐相关提交，预测冲突并自动处理
+- [ ] 🔄 AI 工作流分析 - 分析用户 Git 使用模式，提供个性化优化建议
+- [ ] 🧹 AI 仓库清理 - 智能检测无用分支和过时提交，建议清理策略
+- [ ] 📊 AI 提交质量评分 - 分析提交历史质量，提供改进建议
+- [ ] 🎯 AI 冲突预测 - 在操作前预测可能的冲突和解决方案
+
+### 其他功能想法
+
+- [ ] 集成 AI 代码审查功能
+- [ ] 支持多种 Git 托管平台
+- [ ] 添加性能监控和分析
+- [ ] 考虑 GUI 版本或 Web 界面
+- [ ] 插件系统设计
+- [ ] 编程习惯健康度分析
+- [ ] 代码质量趋势追踪
+
+---
+
+_最后更新: 2025-01-11_