QuiCommit/RAODMAP.md

QuiCommit Roadmap

本路线图按「已完成 / 进行中 / 计划中 / 长远规划」四档跟踪功能演进，并为"计划中"条目标注优先级（P0 = 核心必做，P1 = 重要增强，P2 = 探索性方向）。 更新约定：条目完成后请及时勾选并移入"已完成"，避免已完成事项长期滞留在"计划中"栏目；新增条目请附带动机说明与优先级。

已完成 ✅

• 基础 Git 操作（commit、tag、changelog）
• AI 驱动提交信息生成（Conventional Commits / commitlint 格式）
• 多 LLM 提供商支持：Ollama、OpenAI、Anthropic、Kimi、DeepSeek、OpenRouter
• 多 Git Profile 管理（SSH 密钥 + GPG 签名）
• 语义化版本自动升级与 AI 发布说明
• Keep a Changelog 格式自动生成
• 系统密钥环安全存储 API Key
• 敏感数据加密存储（AES-GCM + Argon2）
• 交互式 CLI 预览与确认
• 7 种语言国际化支持
• 配置导出/导入（支持加密保护）
• Profile Token 管理（PAT 等）
• Git 凭证管理器（Credential Helper 协议、Windows/macOS/Linux 跨平台密钥环对接、PAT scope/有效期与过期提醒）
• DeepSeek 最新模型支持（deepseek-chat / deepseek-reasoner / deepseek-v4）
• 流式生成的 SSE（Server-Sent Events）基础接入
• 一键初始化本地 Git 仓库（quicommit ginit / gi）：建库、写最简 README.md、按根目录标志文件生成 .gitignore、确立初始分支、按 --add 添加远程，可用 --profile 套用已有 Git 配置；全程离线、不创建首个提交、不覆盖已有 README.md 与 .gitignore

---

进行中 🚧

• （暂无）

---

计划中 📋

1. Agent Skills 技能包完善 P0（新增）

动机：.claude/skills、skills/ 目录下现有内容零散，需要系统化沉淀为可复用的 QuiCommit Agent 技能，让编码助手（Claude、Qoder 等）能够开箱用地安装、调用 QuiCommit。

• 安装类技能：install-quicommit
  • 指导用户 / Agent 在 Windows / macOS / Linux 上安装 QuiCommit：Cargo 安装、预编译二进制、源码构建等途径
  • 覆盖首次运行前的环境依赖检查（Git、系统密钥环服务等）
• 使用指导类技能：use-quicommit
  • 面向 Agent 的命令速查与调用范式：commit / tag / changelog / config / profile / credential，以及新增的 ginit
  • 说明各命令的输入前提（如需要先 quicommit init 配置 LLM Provider）、典型输出与常见失败排查
• 技能内容规范
  • 统一采用 SKILL.md 结构（触发场景 / 使用方式 / 注意事项），与 .claude/skills 现有约定保持一致
  • 技能内示例命令、参数需要与 src/commands/ 的实际实现保持同步，避免文档漂移
• 发布与复用
  • 评估随 crate 发布（打包进 skills/）还是通过独立仓库 / 技能市场分发

2. 新增模型支持 P1

扩展 LLM 提供商和模型覆盖范围，满足更多场景和偏好。

• 新增国内模型提供商
  • 通义千问 (Qwen) — 阿里云 DashScope API
  • 文心一言 (ERNIE) — 百度千帆 API
  • 智谱 GLM — ChatGLM API
  • 百川 (Baichuan) — Baichuan API
• 新增国际模型提供商
  • Google Gemini API
  • Mistral AI API
  • Cohere API
  • Groq (LPU 推理加速)
• 本地模型扩展
  • 支持 llama.cpp 服务端（兼容 OpenAI API 格式）
  • 支持 vLLM 部署的模型
  • 本地模型推荐列表与一键配置向导
• 模型能力适配
  • 不同模型的 token 限制自适应
  • 模型特定的 prompt 模板优化
  • 支持 function calling / tool use（用于复杂生成场景）

3. 生成体验优化 P1

提升 AI 生成提交信息、标签说明和变更日志时的用户体验。

• 流式输出与实时反馈
  • 终端打字机效果实时显示生成内容
  • 流式生成过程中支持 Ctrl+C 中断
• 生成质量提升
  • 基于 commitlint 规则的后校验与自动修正
  • 支持 Few-shot 示例引导（用户可自定义示例库）
  • 生成结果的置信度评分与多候选方案
• Diff 上下文增强
  • 智能 diff 摘要（大改动时自动压缩关键信息）
  • 支持 .gitattributes 排除 / 包含规则
  • 按文件类型分组生成更精准的提交描述
• 交互式编辑增强
  • 生成后支持内联编辑（类似 git rebase -i 体验）
  • 支持重新生成指定部分（如 scope、description）
  • 历史提交信息学习与风格适配
• 批量操作支持
  • 批量生成多个 commit（分组暂存区变更）
  • --dry-run 预览模式（只生成本地查看，不写 Git）
• 性能优化
  • API 请求并发优化（多个模型同时生成候选）
  • 本地缓存常用 prompt 模板
  • 减少不必要的 diff 计算

---

长远规划 🌟

• VS Code 扩展 — 在 IDE 内直接使用 QuiCommit
• GitHub Action / GitLab CI 集成 — 自动化 PR 标题和描述生成
• 团队协作 — 共享 commit 风格配置、prompt 模板库
• Web Dashboard — 可视化管理多仓库的 Git 活动与 AI 生成统计
• 插件系统 — 允许社区贡献自定义 LLM 提供商和生成策略