assist/推送脚本使用说明.md

TSP智能助手 - 推送脚本使用说明

📁 脚本文件说明

1. auto_push.bat - 标准自动推送脚本

功能: 完整的Git推送流程，包含状态检查、确认、提交和推送 特点:

• 显示详细的Git状态
• 用户确认机制
• 自定义提交信息
• 错误处理和状态反馈

使用方法:

# 直接运行
auto_push.bat

# 运行后会提示输入提交信息

2. auto_push.ps1 - PowerShell高级版本

功能: 功能最全面的推送脚本，支持参数和高级功能 特点:

• 彩色输出和美观的界面
• 支持命令行参数
• 智能提交信息生成
• 详细的统计信息
• 错误处理和回滚

使用方法:

# 基本使用
.\auto_push.ps1

# 指定提交信息
.\auto_push.ps1 "feat: 添加新功能"

# 强制推送（跳过确认）
.\auto_push.ps1 -NoConfirm

# 强制推送并指定信息
.\auto_push.ps1 "紧急修复" -Force -NoConfirm

3. quick_push.bat - 快速推送脚本

功能: 最简单的推送方式，适合日常快速提交 特点:

• 一键推送
• 自动生成提交信息
• 最小化交互

使用方法:

# 使用默认提交信息
quick_push.bat

# 指定提交信息
quick_push.bat "修复bug"

🚀 推荐使用场景

日常开发

# 快速提交日常更改
quick_push.bat "日常更新"

功能开发

# 使用PowerShell版本，获得最佳体验
.\auto_push.ps1 "feat: 添加用户管理功能"

紧急修复

# 快速修复
quick_push.bat "hotfix: 修复登录问题"

团队协作

# 使用标准版本，确保流程规范
auto_push.bat

⚙️ 脚本特性对比

特性	quick_push.bat	auto_push.bat	auto_push.ps1
执行速度	⚡ 最快	🐌 中等	🐌 中等
用户交互	最少	中等	最多
错误处理	基础	完整	完整
状态显示	基础	详细	最详细
参数支持	基础	无	完整
彩色输出	无	无	✅
统计信息	无	基础	详细

🔧 自定义配置

修改默认提交信息格式

编辑 auto_push.bat 第25行：

set commit_msg=feat: 自动提交 - %date% %time%

修改远程分支

编辑所有脚本中的 origin main 为你的分支：

git push origin your-branch

添加预提交检查

在 auto_push.ps1 中添加检查函数：

function Test-PreCommit {
    # 运行测试
    python -m pytest
    # 代码格式化检查
    python -m black --check .
    # 类型检查
    python -m mypy .
}

🛠️ 故障排除

常见问题

1. PowerShell执行策略错误

   Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
   

2. Git认证失败

   # 检查远程仓库配置
   git remote -v
   
   # 重新设置认证
   git config --global credential.helper store
   

3. 编码问题

   # 确保控制台支持UTF-8
   chcp 65001
   

错误代码说明

• 退出代码 0: 成功
• 退出代码 1: Git操作失败
• 退出代码 2: 用户取消操作

📝 最佳实践

1. 提交前检查: 使用 auto_push.ps1 查看详细状态
2. 提交信息规范: 使用 feat:, fix:, docs: 等前缀
3. 定期推送: 避免长时间不推送导致冲突
4. 分支管理: 在功能分支开发，合并到主分支

🎯 示例工作流

# 1. 开发功能
# ... 编写代码 ...

# 2. 快速推送
quick_push.bat "feat: 添加AI建议功能"

# 3. 或者详细推送
.\auto_push.ps1 "feat: 添加AI建议功能
- 实现语义相似度计算
- 优化前端UI显示
- 添加配置化阈值"

---

提示: 建议将脚本文件添加到项目根目录，并设置适当的执行权限。对于团队使用，建议统一使用 auto_push.ps1 以确保流程一致性。