Git 提交信息 AI 助手-git-commit-log-ai
2026-08-11 12:16:52
行业：人工智能、企业内部管理
载体：Windows应用
技术：Python、Git
业务和功能介绍
1、立项背景和目标
在日常使用 Git / TortoiseGit 提交代码时，编写符合规范的提交信息（如 Conventional Commits）既耗时又容易遗漏，提交历史质量参差不齐，影响协作与代码审查。大模型已经具备理解代码差异的能力，但缺少一个把「git 变更采集 + 规范约束 + 模型生成 + 便捷交付」串起来的上手即用的工具。本项目目标是：选中任意 Git 项目目录，即可自动扫描全部未提交变更，一键生成规范、可编辑、可复制的提交信息，同时保持零依赖、免安装、配置集中，让普通开发者也能轻松部署使用。
2、软件功能、核心功能模块的介绍
变更采集模块（git_collector.py）：对选中项目执行 git status --porcelain、git diff HEAD、git log，得到变更文件清单、未跟踪新文件、差异内容与近期提交历史。
提示词组装模块（prompt_builder.py）：按配置的提交风格（Conventional / simple）与语言（auto / zh / en）动态拼装 system / user 提示词；长 diff 自动截断并显式标注，控制 token 开销。
模型生成模块（llm_client.py）：通过 OpenAI 兼容接口调用大模型生成提交信息，并对返回结果做清理（去除多余前后缀 / markdown 代码块）；对 401、429、超时等常见错误给出中文友好提示。
图形界面模块（gui.py）：tkinter 界面，左侧变更文件列表、右侧可直接编辑的提交信息；支持「重新生成」「复制到剪贴板」「打开 .env」「选择项目」；后台线程生成、queue 轮询回填，界面不卡顿。
配置与打包（config.py + build.bat）：全部配置收敛在 exe 同目录 .env，PyInstaller 一键打包成免安装单文件 exe。
3、业务流程、功能路径描述
启动程序 → 检测默认项目目录是否为 Git 仓库；
点击「选择项目」→ 指定任意 Git 项目根目录（非仓库会给出提示）；
自动执行 git status / diff / log 采集变更，并在左侧展示变更文件清单；
配置中心：点击「打开 .env」填写 API_KEY / MODEL / BASE_URL / 提交风格 / 语言等；
点击「重新生成」→ 组装提示词 → 后台线程调用大模型 → 结果回填到右侧可编辑文本框；
人工确认或修改后点击「复制到剪贴板」→ 粘贴到 TortoiseGit 或命令行使用（工具本身不执行提交，由用户人工确认，保证安全）。
在日常使用 Git / TortoiseGit 提交代码时，编写符合规范的提交信息（如 Conventional Commits）既耗时又容易遗漏，提交历史质量参差不齐，影响协作与代码审查。大模型已经具备理解代码差异的能力，但缺少一个把「git 变更采集 + 规范约束 + 模型生成 + 便捷交付」串起来的上手即用的工具。本项目目标是：选中任意 Git 项目目录，即可自动扫描全部未提交变更，一键生成规范、可编辑、可复制的提交信息，同时保持零依赖、免安装、配置集中，让普通开发者也能轻松部署使用。
2、软件功能、核心功能模块的介绍
变更采集模块（git_collector.py）：对选中项目执行 git status --porcelain、git diff HEAD、git log，得到变更文件清单、未跟踪新文件、差异内容与近期提交历史。
提示词组装模块（prompt_builder.py）：按配置的提交风格（Conventional / simple）与语言（auto / zh / en）动态拼装 system / user 提示词；长 diff 自动截断并显式标注，控制 token 开销。
模型生成模块（llm_client.py）：通过 OpenAI 兼容接口调用大模型生成提交信息，并对返回结果做清理（去除多余前后缀 / markdown 代码块）；对 401、429、超时等常见错误给出中文友好提示。
图形界面模块（gui.py）：tkinter 界面，左侧变更文件列表、右侧可直接编辑的提交信息；支持「重新生成」「复制到剪贴板」「打开 .env」「选择项目」；后台线程生成、queue 轮询回填，界面不卡顿。
配置与打包（config.py + build.bat）：全部配置收敛在 exe 同目录 .env，PyInstaller 一键打包成免安装单文件 exe。
3、业务流程、功能路径描述
启动程序 → 检测默认项目目录是否为 Git 仓库；
点击「选择项目」→ 指定任意 Git 项目根目录（非仓库会给出提示）；
自动执行 git status / diff / log 采集变更，并在左侧展示变更文件清单；
配置中心：点击「打开 .env」填写 API_KEY / MODEL / BASE_URL / 提交风格 / 语言等；
点击「重新生成」→ 组装提示词 → 后台线程调用大模型 → 结果回填到右侧可编辑文本框；
人工确认或修改后点击「复制到剪贴板」→ 粘贴到 TortoiseGit 或命令行使用（工具本身不执行提交，由用户人工确认，保证安全）。
项目实现
1、整体架构和设计思路，不同模块使用的技术栈
整体采用「采集 → 组装 → 生成 → 交付」的单向流水线架构：git_collector.py 通过 subprocess 静默执行 git status / diff / log（CREATE_NO_WINDOW 防弹窗），拿到变更清单、差异与历史；prompt_builder.py 按提交风格与语言拼装提示词，长 diff 自动截断控制 token；llm_client.py 经 langchain-openai 调用 OpenAI 兼容接口（兼容 DeepSeek / 通义千问 / Ollama 等）并清洗输出、友好报错；gui.py 用 tkinter + pyperclip 实现后台线程生成、queue 轮询回填、编辑与复制。设计要点：三路上下文而非裸读 diff，让模型先理解改动目的；工具不自动提交，人工确认兜底；配置收敛 .env，PyInstaller 打包免安装 exe。
2、我的负责模块和结果
我独立完成 6 个模块（main / config / 采集 / 提示词 / 模型 / GUI），源码约 650 行。采集覆盖 status、diff、log 三类信息，处理未跟踪文件与 diff 截断；报错覆盖 10+ 类场景（401/429/超时等）的中文提示；GUI 支持选项目、开 .env、重新生成、复制、编辑 5 项交互且不卡界面；打包产出单文件 exe 并配 build.bat 一键重建。
3、我遇到的难点、坑，和解决方案
Windows 下 git 弹黑窗、GBK 乱码：用 CREATE_NO_WINDOW 静默运行、utf-8 容错解码解决；大仓库 diff 超限：加 MAX_DIFF_LINES 截断并标注，保证一次生成；模型输出含 markdown 前后缀：clean_message() 清洗后可直接粘贴；GUI 卡死：后台线程 + queue 轮询 + 防重入，界面流畅；exe 路径问题：用 sys.frozen 定位 exe 目录读 .env，GUI 下可先开界面再选仓库。
整体采用「采集 → 组装 → 生成 → 交付」的单向流水线架构：git_collector.py 通过 subprocess 静默执行 git status / diff / log（CREATE_NO_WINDOW 防弹窗），拿到变更清单、差异与历史；prompt_builder.py 按提交风格与语言拼装提示词，长 diff 自动截断控制 token；llm_client.py 经 langchain-openai 调用 OpenAI 兼容接口（兼容 DeepSeek / 通义千问 / Ollama 等）并清洗输出、友好报错；gui.py 用 tkinter + pyperclip 实现后台线程生成、queue 轮询回填、编辑与复制。设计要点：三路上下文而非裸读 diff，让模型先理解改动目的；工具不自动提交，人工确认兜底；配置收敛 .env，PyInstaller 打包免安装 exe。
2、我的负责模块和结果
我独立完成 6 个模块（main / config / 采集 / 提示词 / 模型 / GUI），源码约 650 行。采集覆盖 status、diff、log 三类信息，处理未跟踪文件与 diff 截断；报错覆盖 10+ 类场景（401/429/超时等）的中文提示；GUI 支持选项目、开 .env、重新生成、复制、编辑 5 项交互且不卡界面；打包产出单文件 exe 并配 build.bat 一键重建。
3、我遇到的难点、坑，和解决方案
Windows 下 git 弹黑窗、GBK 乱码：用 CREATE_NO_WINDOW 静默运行、utf-8 容错解码解决；大仓库 diff 超限：加 MAX_DIFF_LINES 截断并标注，保证一次生成；模型输出含 markdown 前后缀：clean_message() 清洗后可直接粘贴；GUI 卡死：后台线程 + queue 轮询 + 防重入，界面流畅；exe 路径问题：用 sys.frozen 定位 exe 目录读 .env，GUI 下可先开界面再选仓库。
示例图片视频
相似推荐
基于YOLOv8的课堂行为检测与管理系统
本项目设计并实现了一套基于YOLOv8的课堂行为检测与管理系统，主要针对传统课堂中教师难以持续、客观地掌握学生课堂状态的问题，利用计算机视觉技术对课堂行为进行智能识别和数据化管理。系统以提升课堂管理效率、辅助教师分析学生学习状态为目标，可识别专注听讲、举手、记笔记、走神、睡觉、玩手机、讨论等课堂行为，并对异常行为进行记录和告警。
系统按照不同用户角色提供相应功能，包括管理员、教师、班主任及校级管理人员等。管理员可进行用户、班级、学生、摄像头和检测参数管理，并查看年级、学科、教师等维度的统计数据；教师可查看课程安排、课堂实时监控、学生行为记录和异常告警，并能够进行行为纠正、告警处理以及班级报告生成；系统同时支持摄像头实时视频检测以及图片、视频文件上传检测。整体业务流程为用户登录系统后，根据角色进入对应管理界面，选择课堂或检测数据源，系统调用YOLOv8模型进行行为识别，将检测结果保存至数据库，并进一步形成行为记录、异常告警和统计报告，为课堂教学管理提供数据支持。
教学仪软件
本项目是一款面向教育教学场景的实物展台软件，配套 USB 与 WiFi 双模摄像头硬件使用。传统教学展示依赖实物投影仪，存在布线繁琐、无法数字标注、采集内容难以保存归档等问题。本软件旨在提供一套集视频采集、实时展示、书写标注、图像采集、视频录制、OCR 文字识别、条码扫描、多媒体导出于一体的综合性桌面应用，帮助教师高效完成课堂教学展示与资料数字化归档。
本项目所有功能均本人完成。
基于uniapp开发的答题微信小程序-代码与理论奥赛练学通小程序
练学通答题小程序是面向教育培训行业学生的在线刷题与考试工具（微信小程序端），与机构管理后台配套使用，目标是让学生利用碎片化时间完成题库练习、模拟考试和学科竞赛，并通过积分激励和能力分析报告形成"练习—竞赛—激励—反馈"的学习闭环。小程序核心功能包括：首页功能导航、理论题库与实操题库（按科目、难度分级浏览与作答）、专项训练、每日一练、随机刷题、模拟考试与真题作答、赛事真题、错题本与错题分类训练、考试记录、收藏、公告、搜索、个人中心（积分、兑换码、能力分析、设置、用户协议与隐私政策）等，全部页面支持分享到微信好友和朋友圈。主要业务流程：① 竞赛流程——学生在"赛事真题"Tab 浏览赛事列表，进入赛事后按赛程（初赛/复赛/决赛）查看试卷，未解锁的试卷显示锁定状态，学生可通过管理员授权或输入兑换码解锁，随后在线限时作答并即时查看成绩与解析；② 积分兑换流程——学生在"我的积分"页查看积分余额和可兑换商品，使用积分兑换竞赛试卷解锁资格，兑换成功后获得兑换码（支持一键复制，也可在"我的兑换码"页集中查看），凭兑换码在锁定的赛事试卷处完成解锁；③ 能力分析流程——管理员在后台为学生生成并发布能力分析报告后，学生在"能力分析"页查看包含统计数据、能力雷达图、能力分析文字、柱状图和表格五大模块的个性化报告，各模块展示内容由后台开关控制。
基于H5开发的答题小程序运营后台-代码与理论奥赛练学通小程序管理后台
练学通是面向教育培训行业的在线刷题与考试平台，由学生端小程序和管理后台两部分组成，本系统为管理后台。平台旨在帮助学生通过日常练习、模拟考试和学科竞赛巩固知识，同时为机构管理员提供题库、考试、用户和数据的集中管理能力。管理后台核心功能包括：题库管理、题目管理（单选/多选/判断/填空，支持选项图片）、试卷管理、用户管理、班级管理、成绩管理、字典管理、比赛管理、积分商城和学生能力分析等。主要业务流程：① 竞赛流程——管理员创建比赛并配置赛程（初赛/复赛/决赛），为每个赛程组卷并发布试卷，设置解锁条件（全员开放/指定用户/积分兑换码），学生在端内解锁试卷并在线作答；② 积分兑换流程——学生通过练习和参赛累积积分，管理员在积分商城将竞赛试卷配置为积分商品并定价上架，学生兑换后获得试卷解锁资格；③ 能力分析流程——管理员选中学生后一键生成能力分析报告，报告包含统计数据、雷达图、能力分析文本、柱状图和表格五大模块，可逐模块编辑、控制展示开关并发布给学生查看，也可导出 PDF 供线下沟通使用。
家教app-家教app
本平台配套专属后台管理支撑系统，为家教业务提供全链路数字化运营支撑，实现平台业务统一管控、资源高效调度、业务数据可视化，保障整个家教服务流程稳定有序运行。
## 核心能力介绍
1. **平台基础管控能力**
支持平台基础信息、首页展示内容、公告通知、消息触达的统一配置管理；可对后台操作人员做权限分级管理，保障平台操作安全可控，适配不同岗位协同工作。
2. **双端用户统一管理能力**
对平台两类核心用户（学员家长、授课教师）进行集中化管理，维护平台用户资源，完善用户基础档案，支撑平台用户分层运营，保障入驻服务人员基础资质合规。
3. **服务订单与教学调度能力**
统一管理平台全部家教服务业务单，支撑教学服务预约、排课调度、服务闭环全流程业务处理，适配线上、线下多种授课模式，保障教学服务有序落地，处理服务过程中的各类业务申请。
4. **财务与结算支撑能力**
搭建标准化财务业务支撑体系，完成平台业务资金流转管理，支持业务对账、周期化结算，留存完整业务财务记录，满足业务规范化财务管理需求。
5. **营销与内容运营能力**
提供业务运营工具，支持科目体系维护、营销权益配置、课程及教学资源管理，可灵活开展各类运营活动，丰富平台服务内容，提升用户体验。
6. **客户服务支撑能力**
内置服务问题处理通道，集中接收并处理平台用户反馈与服务纠纷，形成完整服务闭环，高效响应家长与教师的各类服务诉求。
7. **业务数据洞察能力**
提供多维度业务统计看板，覆盖用户、订单、经营等核心业务指标，直观展现平台运营现状，支持业务报表输出，辅助运营决策。
8. **业务风险保障能力**
内置业务风险防护机制，对平台业务开展过程中的风险场景做识别与管控，维护平台健康的服务环境。
9. **增值业务拓展（可选）**
支持拓展会员增值服务体系，可配置对应服务权益，满足平台多样化商业运营需求。
---
如果你需要，我可以再给你一版**更简短的150字版本**，用于PPT简介、项目文档摘要。
帮助文档
Copyright @ 2021-2024 程聚宝 | 浙ICP备2021014372号
人工客服