# QuiCommit Roadmap

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

## 已完成 ✅

- [x] 基础 Git 操作（commit、tag、changelog）
- [x] AI 驱动提交信息生成（Conventional Commits / commitlint 格式）
- [x] 多 LLM 提供商支持：Ollama、OpenAI、Anthropic、Kimi、DeepSeek、OpenRouter
- [x] 多 Git Profile 管理（SSH 密钥 + GPG 签名）
- [x] 语义化版本自动升级与 AI 发布说明
- [x] Keep a Changelog 格式自动生成
- [x] 系统密钥环安全存储 API Key
- [x] 敏感数据加密存储（AES-GCM + Argon2）
- [x] 交互式 CLI 预览与确认
- [x] 7 种语言国际化支持
- [x] 配置导出/导入（支持加密保护）
- [x] Profile Token 管理（PAT 等）
- [x] Git 凭证管理器（Credential Helper 协议、Windows/macOS/Linux 跨平台密钥环对接、PAT scope/有效期与过期提醒）
- [x] DeepSeek 最新模型支持（`deepseek-chat` / `deepseek-reasoner` / `deepseek-v4`）
- [x] 流式生成的 SSE（Server-Sent Events）基础接入
- [x] 一键初始化本地 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 提供商和生成策略