@zjex/git-workflow 0.3.2 → 0.3.4

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,6 +1,3 @@
-#!/usr/bin/env sh
-. "$(dirname -- "$0")/_/husky.sh"
-
 # 运行测试
 echo "正在运行测试..."
 npm test
@@ -17,6 +14,3 @@ if [ $? -ne 0 ]; then
 fi
 
 echo "✅ 测试通过，继续提交..."
-
-# 确保正常退出，让 Git 继续提交过程
-exit 0

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

@@ -5,7 +5,7 @@
 ## 📋 当前状态
 
 - **版本**: v0.3.0
-- **测试覆盖**: 231个测试用例
+- **测试覆盖**: 231 个测试用例
 - **核心功能**: ✅ 完成
 - **文档**: ✅ 完成
 - **品牌标识**: ✅ 完成
@@ -14,20 +14,78 @@
 
 ## 🎯 高优先级功能 (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活动
+  - 自动分析当前年份的 Git 活动
   - 生成精美的终端输出报告
   - 包含提交统计、语言分布、活跃时间等
 - [ ] `gw wrapped 2024` - 指定年份分析
   - 支持分析任意年份的数据
   - 历史数据对比功能
 - [ ] `gw wrapped --share` - 生成可分享的图片
-  - 输出PNG/SVG格式的精美报告卡片
+  - 输出 PNG/SVG 格式的精美报告卡片
   - 适合社交媒体分享
   - 支持多种主题风格
 
 **功能亮点**:
+
 - 📊 提交统计和趋势图表
 - � 最活跃的月份/季度/时间段
 - 💻 编程语言使用分布
@@ -38,24 +96,26 @@
 - ⏰ 编程时间习惯分析（早鸟 vs 夜猫子）
 
 **技术难点**: 数据聚合分析、图表生成、图片渲染
-**独特价值**: 市场上唯一的Git年度回顾工具，具有病毒式传播潜力
+**独特价值**: 市场上唯一的 Git 年度回顾工具，具有病毒式传播潜力
+
+### 2. 📊 Git 日志和历史查看 - 解决真实痛点
 
-### 2. 📊 Git日志和历史查看 - 解决真实痛点
 - [ ] `gw log` - 美化的提交历史查看
   - 彩色输出，图形化分支显示
   - 支持筛选（作者、日期、关键词）
   - 分页显示，交互式导航
 - [ ] `gw recent` - 显示最近的提交
-  - 可配置天数（默认7天）
+  - 可配置天数（默认 7 天）
   - 按作者分组显示
 - [ ] `gw authors` - 显示贡献者统计
   - 提交数量、代码行数统计
   - 时间范围筛选
 
 **技术难点**: 图形化分支显示、性能优化
-**独特价值**: 比原生git log更美观，比lazygit更简洁
+**独特价值**: 比原生 git log 更美观，比 lazygit 更简洁
 
 ### 3. 🌿 分支管理增强 - 高频使用场景
+
 - [ ] `gw recent-branches` - 显示最近使用的分支
   - 按最后使用时间排序
   - 显示分支状态（ahead/behind）
@@ -68,39 +128,42 @@
 **技术难点**: 分支状态检测、搜索算法
 **独特价值**: 解决多分支项目的切换痛点
 
-### 4. 🤖 AI智能Merge - � 革命性功能
-- [ ] `gw merge --ai` - AI自动处理merge冲突
+### 4. 🤖 AI 智能 Merge - � 革命性功能
+
+- [ ] `gw merge --ai` - AI 自动处理 merge 冲突
   - 自动识别和处理简单冲突（import、格式化等）
   - 智能分析复杂冲突，提供解决建议
   - 基于代码语义理解的冲突博弈
   - 学习用户偏好，提升决策准确性
 - [ ] `gw merge --preview` - 冲突预览和分析
-  - merge前预测可能的冲突
+  - merge 前预测可能的冲突
   - 显示冲突复杂度和建议策略
   - 提供冲突解决时间估算
-- [ ] `gw merge --safe` - 安全模式merge
+- [ ] `gw merge --safe` - 安全模式 merge
   - 自动创建备份分支
   - 重要文件强制人工确认
   - 提供一键回滚功能
 
-**技术难点**: AI模型集成、代码语义分析、安全机制
-**独特价值**: 市场首个AI驱动的merge冲突处理工具，解决开发者最大痛点
+**技术难点**: AI 模型集成、代码语义分析、安全机制
+**独特价值**: 市场首个 AI 驱动的 merge 冲突处理工具，解决开发者最大痛点
 
 ### 5. �🔍 提交历史搜索 - 实用工具
+
 - [ ] `gw search` - 在提交历史中搜索
   - 支持提交信息、作者、文件名搜索
   - 正则表达式支持
   - 结果高亮显示
-  - AI增强的语义搜索
+  - AI 增强的语义搜索
 
 **技术难点**: 搜索性能、结果展示
-**独特价值**: AI增强的智能搜索，理解搜索意图
+**独特价值**: AI 增强的智能搜索，理解搜索意图
 
 ---
 
 ## 🚀 中优先级功能 (v0.4.x)
 
 ### 1. 👥 团队协作功能
+
 - [ ] `gw standup` - 显示团队成员最近的工作
   - 可配置时间范围和团队成员
   - 按项目/仓库分组
@@ -112,25 +175,27 @@
 
 **技术难点**: 多仓库管理、数据聚合
 
-### 2. 🔗 GitHub集成增强
-- [ ] `gw pr` - PR管理功能
-  - 创建、查看、合并PR
-  - PR状态检查（CI/CD）
+### 2. 🔗 GitHub 集成增强
+
+- [ ] `gw pr` - PR 管理功能
+  - 创建、查看、合并 PR
+  - PR 状态检查（CI/CD）
   - 代码审查集成
-- [ ] `gw issues` - Issue管理
-  - 创建、查看、关闭Issue
+- [ ] `gw issues` - Issue 管理
+  - 创建、查看、关闭 Issue
   - 标签和里程碑管理
 - [ ] `gw repo` - 仓库信息和统计
-  - Star、Fork、Watch数据
-  - Release信息
+  - Star、Fork、Watch 数据
+  - Release 信息
   - 贡献者信息
 
-**技术难点**: GitHub API集成、认证管理
+**技术难点**: GitHub API 集成、认证管理
 
-### 3. 🎨 增强的diff显示
-- [ ] `gw diff` - 语法高亮的diff显示
-  - 集成delta或类似工具
-  - 支持side-by-side显示
+### 3. 🎨 增强的 diff 显示
+
+- [ ] `gw diff` - 语法高亮的 diff 显示
+  - 集成 delta 或类似工具
+  - 支持 side-by-side 显示
   - 文件类型智能识别
 
 **技术难点**: 语法高亮、布局优化
@@ -140,40 +205,45 @@
 ## 🔮 低优先级功能 (v0.5.x+)
 
 ### 1. 🛠️ 高级工具
-- [ ] `gw blame` - 交互式blame查看
-- [ ] `gw template` - commit message模板管理
-- [ ] `gw hooks` - Git hooks管理
-- [ ] `gw alias` - Git别名管理
-- [ ] `gw ignore` - 交互式.gitignore管理
+
+- [ ] `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工具初衷，价值不大
+
+- ~~交互式 Rebase 简化~~ - 原生 Git rebase 已足够好用
+- ~~智能 Cherry-pick~~ - 原生 cherry-pick 已足够好用
+- ~~智能同步功能~~ - 用户自己 stash + pull 即可
+- ~~浏览器集成~~ - 偏离 CLI 工具初衷，价值不大
 
 ---
 
 ## 🎯 现有功能优化计划
 
-### AI Commit增强 (v0.3.1)
-- [ ] 支持多种commit风格选择
+### AI Commit 增强 (v0.3.1)
+
+- [ ] 支持多种 commit 风格选择
   - Conventional Commits（当前）
-  - Gitmoji风格
+  - Gitmoji 风格
   - 自定义模板
-- [ ] 批量commit功能
+- [ ] 批量 commit 功能
   - 智能分组相关更改
   - 支持部分文件提交
-- [ ] commit模板系统
+- [ ] commit 模板系统
   - 项目级模板
   - 个人模板库
 
 ### 分支管理优化 (v0.3.2)
+
 - [ ] 分支描述功能
   - 添加/编辑分支描述
   - 在分支列表中显示描述
@@ -185,14 +255,15 @@
   - 提交前验证
 
 ### 发布流程增强 (v0.3.3)
+
 - [ ] 多环境发布支持
-  - dev/staging/prod环境配置
+  - dev/staging/prod 环境配置
   - 环境特定的发布流程
 - [ ] 回滚功能
   - 快速回滚到指定版本
   - 回滚影响分析
-- [ ] CI/CD集成
-  - 检查CI状态
+- [ ] CI/CD 集成
+  - 检查 CI 状态
   - 等待部署完成
 
 ---
@@ -200,15 +271,19 @@
 ## 📊 开发计划
 
 ### Q1 2025 (v0.3.1-0.3.3)
-- ✅ 完成高优先级功能中的3-4个
+
+- ⭐ **最高优先级**: AI Code Review (`gw review`)
+- ✅ 完成高优先级功能中的 3-4 个
 - 🎯 重点：用户体验提升，核心工作流优化
 
 ### Q2 2025 (v0.4.0)
+
 - 🎯 团队协作功能
-- 🎯 GitHub深度集成
+- 🎯 GitHub 深度集成
 - 🎯 性能优化
 
 ### Q3 2025 (v0.5.0)
+
 - 🎯 高级工具和自定义功能
 - 🎯 插件系统（如果需要）
 - 🎯 企业级功能
@@ -218,14 +293,16 @@
 ## 🤝 贡献指南
 
 ### 如何选择功能实现
+
 1. **用户价值** - 功能对用户的实际价值
 2. **实现复杂度** - 开发难度和时间成本
 3. **维护成本** - 长期维护的复杂度
 4. **社区需求** - 用户反馈和请求
 
 ### 开发流程
+
 1. 在此文件中标记功能状态
-2. 创建对应的Issue讨论设计
+2. 创建对应的 Issue 讨论设计
 3. 实现功能并添加测试
 4. 更新文档
 5. 发布版本
@@ -234,7 +311,8 @@
 
 ## 📝 更新日志
 
-- **2025-01-11**: 创建路线图，当前版本v0.3.0，规划后续功能
+- **2025-01-12**: 添加 AI Code Review 功能作为最高优先级（第 0 项）
+- **2025-01-11**: 创建路线图，当前版本 v0.3.0，规划后续功能
 - **待更新**: 根据开发进度持续更新
 
 ---
@@ -244,32 +322,35 @@
 > 记录临时想法和用户建议，定期整理到正式计划中
 
 ### Git Wrapped 扩展想法
+
 - [ ] 🏆 成就系统集成 - 在年度报告中展示解锁的成就
 - [ ] 📈 多年对比 - 对比不同年份的编程成长
 - [ ] 🎨 自定义主题 - 支持多种视觉风格（暗黑、彩虹、极简等）
 - [ ] 📱 移动端适配 - 生成适合手机分享的竖版图片
 - [ ] 🌍 团队版本 - 生成整个团队的年度报告
 - [ ] 🎵 音乐集成 - 根据编程语言推荐"年度编程歌单"
-- [ ] 📝 AI总结 - 用AI生成个性化的年度编程故事
+- [ ] 📝 AI 总结 - 用 AI 生成个性化的年度编程故事
 - [ ] 🎯 目标设定 - 基于今年数据设定明年目标
 
-### AI Git操作扩展想法
-- [ ] 🤖 AI智能Rebase - 自动分析提交关系，智能建议合并/重排/拆分操作
-- [ ] 🍒 AI智能Cherry-pick - 基于代码语义推荐相关提交，预测冲突并自动处理
-- [ ] 🔄 AI工作流分析 - 分析用户Git使用模式，提供个性化优化建议
-- [ ] 🧹 AI仓库清理 - 智能检测无用分支和过时提交，建议清理策略
-- [ ] 📊 AI提交质量评分 - 分析提交历史质量，提供改进建议
-- [ ] 🎯 AI冲突预测 - 在操作前预测可能的冲突和解决方案
+### AI Git 操作扩展想法
+
+- [ ] 🤖 AI 智能 Rebase - 自动分析提交关系，智能建议合并/重排/拆分操作
+- [ ] 🍒 AI 智能 Cherry-pick - 基于代码语义推荐相关提交，预测冲突并自动处理
+- [ ] 🔄 AI 工作流分析 - 分析用户 Git 使用模式，提供个性化优化建议
+- [ ] 🧹 AI 仓库清理 - 智能检测无用分支和过时提交，建议清理策略
+- [ ] 📊 AI 提交质量评分 - 分析提交历史质量，提供改进建议
+- [ ] 🎯 AI 冲突预测 - 在操作前预测可能的冲突和解决方案
 
 ### 其他功能想法
-- [ ] 集成AI代码审查功能
-- [ ] 支持多种Git托管平台
+
+- [ ] 集成 AI 代码审查功能
+- [ ] 支持多种 Git 托管平台
 - [ ] 添加性能监控和分析
-- [ ] 考虑GUI版本或Web界面
+- [ ] 考虑 GUI 版本或 Web 界面
 - [ ] 插件系统设计
 - [ ] 编程习惯健康度分析
 - [ ] 代码质量趋势追踪
 
 ---
 
-*最后更新: 2025-01-11*
+_最后更新: 2025-01-11_