@dongowu/git-ai-cli 1.0.19 → 1.0.21

package/README.md

@@ -18,144 +18,223 @@
 <p align="center">
   <a href="./README_EN.md">English</a> •
   <a href="#-快速开始">快速开始</a> •
-  <a href="#-核心特性">核心特性</a> •
-  <a href="#-git-flow-最佳实践">Git Flow</a> •
-  <a href="#-智能周报">智能周报</a>
+  <a href="#-使用指南推荐流程">使用指南</a> •
+  <a href="#-配置">配置</a> •
+  <a href="#-命令速查">命令</a>
 </p>
 
 ---
 
-**git-ai-cli** 不仅仅是一个 Commit Message 生成器，它是你的**全能 AI 开发助手**。它能读懂你的代码 Diff，看懂你的分支意图，甚至帮你写好周报。
+**git-ai-cli** 不只是 Commit Message 生成器，它是你的**全能 AI 开发助手**：理解 diff、识别分支意图、统一团队规范、自动生成周报/PR/Release Notes。
 
 ---
 
 ## 🚀 快速开始
 
 ```bash
-# 1. 安装
+# 1) 安装
 npm install -g @dongowu/git-ai-cli
 
-# 2. 初始化 (自动探测本地模型或配置 API)
+# 2) 初始化 (自动探测本地模型或配置 API)
 git-ai init
 
-# 3. 使用
+# 3) 使用
 git add .
 git-ai
 ```
 
 ---
 
-## ✨ 核心特性
-
-### 1. 🇨🇳 极致本土化 & 隐私优先
-- **DeepSeek/Qwen 深度优化**：内置专家级提示词，针对中文代码语境优化，不只是翻译 Diff，而是理解“意图”。
-- **Ollama 零配置**：自动探测本地运行的 Ollama 模型（如 `llama3`, `deepseek-coder`），无需手动输入模型名。数据完全不出网，绝对安全。
+## ✅ 使用指南（推荐流程）
 
-### 2. 🧠 上下文感知 (Context Aware)
-- **风格学习**：自动分析您最近的 10 次提交记录，模仿您的语气、格式（如 Emoji 使用习惯）和语言风格。
-- **分支感知**：读取当前分支名（如 `feat/user-login`, `fix/JIRA-123`），生成包含 Issue ID 或功能模块的规范提交信息。
+1) **安装与初始化**
+```bash
+npm install -g @dongowu/git-ai-cli
+git-ai init
+```
 
-### 3. 🤖 Agent 智能体 (New)
-从单纯的“文本生成”进化为“智能代码专家”。
-- **Smart Diff**: 遇到超大变更不再瞎编。Agent 会自动分析统计数据，只读取核心文件的代码，彻底解决 Token 限制问题。
-- **影响分析 (Impact Analysis)**: 修改了核心 API？Agent 会主动**搜索整个代码库**（`git grep`），检查调用方是否同步修改，并在 Commit Body 中提示潜在风险。
-- **Git Flow 护航**: 在 `release/*` 或 `hotfix/*` 分支上自动开启深度检查，守卫生产环境。
+2) **团队配置（推荐）**：在项目根目录写 `.git-ai.json`
+```json
+{
+  "provider": "deepseek",
+  "baseUrl": "https://api.deepseek.com/v1",
+  "model": "deepseek-reasoner",
+  "agentModel": "deepseek-chat",
+  "locale": "en",
+  "enableFooter": false,
+  "rulesPreset": "conventional",
+  "fallbackModels": ["deepseek-chat", "qwen-turbo"],
+  "policy": { "strict": true },
+  "rules": {
+    "types": ["feat", "fix", "docs", "refactor", "perf", "test", "chore", "build", "ci"],
+    "maxSubjectLength": 50,
+    "requireScope": false,
+    "issuePattern": "[A-Z]+-\\d+",
+    "issuePlacement": "footer",
+    "issueFooterPrefix": "Refs",
+    "requireIssue": false
+  },
+  "branch": {
+    "types": ["feat", "fix", "docs"],
+    "pattern": "{type}/{issue?}{name}",
+    "issueSeparator": "-",
+    "nameMaxLength": 50
+  }
+}
+```
 
-### 4. ⚙️ 工程化配置 (Project Config)
-- **项目级配置**：支持在项目根目录创建 `.git-ai.json`，团队统一共享模型和 Prompt 配置（优先级 > 全局配置）。
-- **智能忽略**：支持 `.git-aiignore` 文件，排除自动生成文件（如 `package-lock.json`）或大文件，节省 Token 并提高准确性。
+3) **日常提交**
+```bash
+git add .
+git-ai
+```
 
-### 4. 🪝 无感集成 (Git Hook)
-- **零打扰**：安装 Hook 后，只需执行 `git commit`（不带 `-m`），AI 自动填充消息并打开编辑器。
-- **兼容性**：完美兼容现有 Git 工作流，支持 `git commit --no-verify` 跳过。
+4) **Hook 无感集成（强烈推荐）**
+```bash
+git-ai hook install
+# 失败阻断提交（可选）
+GIT_AI_HOOK_STRICT=1 git commit
+# 失败时关闭兜底（可选）
+GIT_AI_HOOK_FALLBACK=0 git commit
+```
 
-### 4. 📊 智能周报 (AI Report)
-- **一键生成**：`git-ai report` 自动分析你最近的代码提交。
-- **价值导向**：将零碎的 Commit 转化为结构化的“核心产出”、“问题修复”和“技术优化”报告。
+5) **脚本 / CI**
+```bash
+git-ai msg --json
+```
 
----
+6) **创建分支（交互式）**
+```bash
+git-ai branch
+```
 
-## ⚙️ 高级配置
+7) **PR / Release / Report**
+```bash
+# PR 描述
+git-ai pr --base main --head HEAD
 
-### 项目级配置文件 `.git-ai.json`
-在项目根目录创建此文件，可覆盖全局设置，方便团队统一规范：
+# Release Notes
+git-ai release --from v1.0.0 --to HEAD
 
-```json
-{
-  "model": "deepseek-coder",
-  "temperature": 0.5,
-  "locale": "zh-CN",
-  "customPrompt": "Always start with an emoji."
-}
+# 周报
+ git-ai report --days 7
 ```
 
-### 忽略文件 `.git-aiignore`
-在项目根目录创建，用于排除不想发送给 AI 的文件（语法同 `.gitignore`）：
+---
 
-```text
-package-lock.json
-dist/
-*.min.js
-```
+## ✨ 核心特性
+
+- **DeepSeek/Qwen 深度优化**：理解意图而不是简单翻译 diff
+- **本地模型隐私优先**：Ollama / LM Studio 即插即用
+- **上下文感知**：分支规则、提交风格学习、智能 scope
+- **Agent 智能体**：大改动时自动做影响分析
+- **团队规则**：规则模板 + 强校验（policy）
+- **Hook 集成**：无感生成提交信息
+- **AI 报告**：日报/周报/PR/Release Notes 一键生成
 
 ---
 
-## 📖 使用方式
+## ⚙️ 配置
+
+### 项目级配置 `.git-ai.json`
+- `provider / baseUrl / model / agentModel`
+- `locale`: `zh` / `en`
+- `outputFormat`: `text` / `json`
+- `rulesPreset`: `conventional` / `angular` / `minimal`
+- `fallbackModels`: 主模型失败时的回退模型列表
+- `policy.strict`: 是否阻断不合规提交
+- `rules`: 提交规范（类型、scope、长度、issue 等）
+- `branch`: 分支规范（类型、pattern、长度等）
+
+### 规则与策略
+- `issuePattern`: 任务号正则（如 `PROJ-123` / `#123`）
+- `issuePlacement`: `scope | subject | footer`
+- `requireIssue`: 是否必须包含任务号
+- `policy.strict`: 不合规则阻断提交
+- `branch.pattern`: 分支模板（如 `{type}/{issue?}{name}`）
+- `branch.types`: 分支类型列表
+- `branch.issueSeparator`: issue 分隔符（默认 `-`）
+- `branch.nameMaxLength`: 分支名长度上限
+
+### CLI 设置（可脚本化）
+```bash
+# 查看当前生效配置
+git-ai config get --json
 
-### 场景一：交互式提交 (Interactive)
+# 设置规则模板 / 严格策略 / 回退模型
+git-ai config set rulesPreset conventional
+git-ai config set policy '{"strict":true}'
+git-ai config set fallbackModels "deepseek-chat,qwen-turbo"
 
-```bash
-git add .
-git-ai
-```
+# 设置规则（JSON 或 @文件）
+git-ai config set rules '{"types":["feat","fix"]}'
+git-ai config set rules @rules.json --local
 
-### 场景二：Git Flow 最佳实践 (Hook) 🌟 推荐
+# 设置分支规则
+git-ai config set branch '{"types":["feat","fix"],"pattern":"{type}/{issue?}{name}"}'
+```
 
-这是最流畅的体验。你不需要改变任何习惯，只需一次安装：
+---
 
-```bash
-# 在当前项目安装
-git-ai hook install
+## 🛠 命令速查
 
-# 或者全局安装（所有项目生效）
-git-ai hook install --global
-```
+| 命令 | 说明 |
+|------|------|
+| `git-ai init` | 初始化配置 |
+| `git-ai config get/set/describe` | 配置管理 |
+| `git-ai` / `git-ai commit` | 交互式提交 |
+| `git-ai -a` | Agent 模式 |
+| `git-ai msg` | 仅输出消息（脚本/Hook） |
+| `git-ai branch` | 交互式创建分支 |
+| `git-ai hook install/remove` | Git Hook 管理 |
+| `git-ai report` | 生成 AI 周报 |
+| `git-ai pr` | 生成 PR 描述 |
+| `git-ai release` | 生成 Release Notes |
 
-**之后只需：**
-```bash
-git checkout -b feature/awesome-login
-# ... 写代码 ...
-git add .
-git commit  # ✨ AI 自动帮你写好了 "feat(login): implement awesome login logic"
-```
+---
 
-### 场景三：生成周报 (Report)
+## ⚡ 环境变量（常用）
+
+- `GIT_AI_PROVIDER` / `GIT_AI_BASE_URL` / `GIT_AI_MODEL` / `GIT_AI_AGENT_MODEL`
+- `GIT_AI_API_KEY`（也支持 `DEEPSEEK_API_KEY`, `OPENAI_API_KEY`）
+- `GIT_AI_TIMEOUT_MS`
+- `GIT_AI_MAX_DIFF_CHARS` / `GIT_AI_MAX_OUTPUT_TOKENS`
+- `GIT_AI_RULES_PRESET`
+- `GIT_AI_FALLBACK_MODELS`
+- `GIT_AI_POLICY_STRICT`
+- `GIT_AI_ISSUE_PATTERN` / `GIT_AI_ISSUE_PLACEMENT` / `GIT_AI_REQUIRE_ISSUE`
+- `GIT_AI_OUTPUT_FORMAT=json`
+- `GIT_AI_MSG_DELIM=<<<GIT_AI_END>>>`
+- `GIT_AI_HOOK_STRICT=1` / `GIT_AI_HOOK_FALLBACK=0`
+- `GIT_AI_BRANCH_PATTERN` / `GIT_AI_BRANCH_TYPES`
+- `GIT_AI_BRANCH_ISSUE_SEPARATOR` / `GIT_AI_BRANCH_NAME_MAXLEN`
 
-每逢周五不想写周报？
+---
 
-```bash
-# 生成本周日报/周报
-git-ai report
+## 🧩 忽略文件 `.git-aiignore`
 
-# 生成最近 30 天的汇报
-git-ai report --days 30
+```text
+package-lock.json
+dist/
+*.min.js
 ```
 
+同时兼容 OpenCommit 的 `.opencommitignore`。
+
 ---
 
-## 🛠 命令速查
+## ❓常见问题
+
+**1) 401 / API Key 无效**
+- 先看配置：`git-ai config get --json --local`
+- 检查环境变量是否覆盖
+
+**2) Diff 被截断**
+- 用 `.git-aiignore` 忽略大文件
+- 或设置 `GIT_AI_MAX_DIFF_CHARS`
 
-| 命令 | 别名 | 说明 |
-|------|------|------|
-| `git-ai init` | `config` | **初始化配置**（设置模型、Key、语言） |
-| `git-ai` | | 交互式生成并提交 |
-| `git-ai -a` | | **Agent 模式** (深度分析 & 影响检查) |
-| `git-ai -y` | | 跳过确认直接提交 |
-| `git-ai -n 3` | | 生成 3 条候选消息 |
-| `git-ai hook install` | | **安装 Git Hook** (支持 `--global`) |
-| `git-ai hook remove` | | 移除 Git Hook |
-| `git-ai report` | | **生成 AI 周报** (支持 `--days`) |
-| `git-ai msg` | | 仅输出消息（供脚本调用） |
+**3) Agent 自动回退**
+- 设置 `GIT_AI_DEBUG=1` 查看原因
 
 ---
 
@@ -163,17 +242,15 @@ git-ai report --days 30
 
 | 类型 | 服务商 | 优势 | 配置方式 |
 |------|--------|------|----------|
-| **本地隐私** | **Ollama** | 免费、离线、绝对隐私 | `git-ai init` 自动探测 |
+| **本地隐私** | **Ollama** | 免费、离线、隐私 | `git-ai init` 自动探测 |
 | | **LM Studio** | 兼容性好 | 手动输入 URL |
-| **国内高速** | **DeepSeek** | **性价比之王**，代码能力极强 | API Key |
-| | **通义千问** | 阿里生态，长文本能力强 | API Key |
-| | **智谱/Moonshot** | 国内主流模型 | API Key |
+| **国内高速** | **DeepSeek** | 性价比高 | API Key |
+| | **通义千问** | 长文本能力强 | API Key |
+| | **智谱/Moonshot** | 国内主流 | API Key |
 | **国际通用** | **OpenAI** | GPT-4o 基准能力 | API Key |
 
 ---
 
-
-
 ## 📄 License
 
 [MIT](LICENSE)
@@ -184,4 +261,4 @@ git-ai report --days 30
   Made with ❤️ by git-ai team
   <br>
   <sub>🤖 Generated by git-ai 🚀</sub>
-</p>
+</p>

package/README_EN.md

@@ -18,141 +18,236 @@
 <p align="center">
   <a href="./README.md">中文文档</a> •
   <a href="#-quick-start">Quick Start</a> •
-  <a href="#-features">Features</a> •
-  <a href="#-usage">Usage</a> •
-  <a href="#-configuration">Configuration</a>
+  <a href="#-usage-guide-recommended">Usage</a> •
+  <a href="#-configuration">Configuration</a> •
+  <a href="#-command-reference">Commands</a>
 </p>
 
 ---
 
-**git-ai-cli** is more than just a commit message generator. It's your **AI Development Assistant**. It understands your code diffs, recognizes your branch intent, and even writes your weekly reports.
+**git-ai-cli** is more than a commit message generator. It understands diffs, enforces team rules, and generates reports, PR descriptions, and release notes.
 
 ---
 
 ## 🚀 Quick Start
 
 ```bash
-# 1. Install
+# 1) Install
 npm install -g @dongowu/git-ai-cli
 
-# 2. Initialize (Auto-detects local models or configures API)
+# 2) Initialize (auto-detect local models or configure API)
 git-ai init
 
-# 3. Use
+# 3) Use
 git add .
 git-ai
 ```
 
 ---
 
-## ✨ Features
+## ✅ Usage Guide (Recommended)
 
-### 1. 🔒 Privacy First & Local Models
-- **Ollama Zero-Config**: Automatically detects locally running Ollama models (like `llama3`, `deepseek-coder`). No manual setup required. Your data never leaves your machine.
-- **DeepSeek/OpenAI**: Built-in support for popular API providers with optimized prompts.
+1) **Install & Init**
+```bash
+npm install -g @dongowu/git-ai-cli
+git-ai init
+```
 
-### 2. 🧠 Context Aware
-- **Style Learning**: Automatically analyzes your recent 10 commits to mimic your personal tone, format (e.g., emojis), and language style.
-- **Branch Awareness**: Reads your current branch name (e.g., `feat/user-login`, `fix/JIRA-123`) to generate semantic commits with Issue IDs or scopes.
+2) **Team config (recommended)**: create `.git-ai.json` in project root
+```json
+{
+  "provider": "deepseek",
+  "baseUrl": "https://api.deepseek.com/v1",
+  "model": "deepseek-reasoner",
+  "agentModel": "deepseek-chat",
+  "locale": "en",
+  "enableFooter": false,
+  "rulesPreset": "conventional",
+  "fallbackModels": ["deepseek-chat", "qwen-turbo"],
+  "policy": { "strict": true },
+  "rules": {
+    "types": ["feat", "fix", "docs", "refactor", "perf", "test", "chore", "build", "ci"],
+    "maxSubjectLength": 50,
+    "requireScope": false,
+    "issuePattern": "[A-Z]+-\\d+",
+    "issuePlacement": "footer",
+    "issueFooterPrefix": "Refs",
+    "requireIssue": false
+  },
+  "branch": {
+    "types": ["feat", "fix", "docs"],
+    "pattern": "{type}/{issue?}{name}",
+    "issueSeparator": "-",
+    "nameMaxLength": 50
+  }
+}
+```
 
-### 3. 🤖 Agent Intelligence (New)
-Evolving from a text generator to a code expert.
-- **Smart Diff**: No more truncated diffs. The Agent automatically analyzes file stats and reads only the critical source code, solving token limits for large refactors.
-- **Impact Analysis**: Changing a core API? The Agent proactively searches your codebase (`git grep`) to find usages and warns you about potential breaking changes in the commit body.
-- **Git Flow Guard**: Automatically enables deep analysis on `release/*` or `hotfix/*` branches to protect production code.
+3) **Daily commit**
+```bash
+git add .
+git-ai
+```
 
-### 4. ⚙️ Engineering Ready
-- **Project Config**: Create a `.git-ai.json` in your project root to share settings (model, prompts) with your team.
-- **Smart Ignore**: Use `.git-aiignore` to exclude auto-generated files (like `package-lock.json`) or large files to save tokens and improve accuracy.
+4) **Hook (recommended)**
+```bash
+git-ai hook install
+# Block commit on failure (optional)
+GIT_AI_HOOK_STRICT=1 git commit
+# Disable fallback message (optional)
+GIT_AI_HOOK_FALLBACK=0 git commit
+```
 
-### 4. 🪝 Seamless Integration (Git Hook)
-- **Zero Distraction**: After installing the hook, just run `git commit` (without `-m`). AI automatically fills in the message and opens your editor.
-- **Compatibility**: Perfectly compatible with existing Git workflows. Supports `git commit --no-verify`.
+5) **Scripts / CI**
+```bash
+git-ai msg --json
+```
+
+6) **Create branch (interactive)**
+```bash
+git-ai branch
+```
+
+7) **PR / Release / Report**
+```bash
+# PR description
+git-ai pr --base main --head HEAD
+
+# Release notes
+git-ai release --from v1.0.0 --to HEAD
 
-### 5. 📊 AI Reports
-- **One-Click Generation**: `git-ai report` analyzes your recent commits.
-- **Value Driven**: Transforms fragmented commits into structured reports highlighting "Core Outputs", "Bug Fixes", and "Technical Improvements".
+# Weekly report
+git-ai report --days 7
+```
+
+---
+
+## ✨ Features
+
+- **DeepSeek/Qwen optimized**: intent-focused prompts
+- **Local privacy**: Ollama / LM Studio support
+- **Context aware**: branch rules, style learning, smart scope
+- **Agent mode**: impact analysis for large diffs
+- **Team rules**: presets + strict policy
+- **Git hooks**: zero-friction commits
+- **AI reports**: weekly report / PR / release notes
 
 ---
 
 ## ⚙️ Configuration
 
-### Project-Level Config `.git-ai.json`
-Create this file in your project root to override global settings:
+### Project-level config `.git-ai.json`
+- `provider / baseUrl / model / agentModel`
+- `locale`: `zh` / `en`
+- `outputFormat`: `text` / `json`
+- `rulesPreset`: `conventional` / `angular` / `minimal`
+- `fallbackModels`: fallback list when the primary model fails
+- `policy.strict`: block commit when rules are violated
+- `rules`: types/scopes/length/issue rules
+- `branch`: branch naming rules (types/pattern/length)
+
+### Rules & Policy
+- `issuePattern`: regex for issue IDs
+- `issuePlacement`: `scope | subject | footer`
+- `requireIssue`: enforce issue id
+- `policy.strict`: block commit when invalid
+- `branch.pattern`: branch template (e.g., `{type}/{issue?}{name}`)
+- `branch.types`: branch type list
+- `branch.issueSeparator`: issue separator (default `-`)
+- `branch.nameMaxLength`: max length for name
+
+### CLI config
+```bash
+# Show effective config
+git-ai config get --json
 
-```json
-{
-  "model": "deepseek-coder",
-  "temperature": 0.5,
-  "locale": "en",
-  "customPrompt": "Always start with an emoji."
-}
-```
+# Preset / policy / fallback
+git-ai config set rulesPreset conventional
+git-ai config set policy '{"strict":true}'
+git-ai config set fallbackModels "deepseek-chat,qwen-turbo"
 
-### Ignore File `.git-aiignore`
-Exclude specific files from AI analysis (syntax similar to `.gitignore`):
+# Rules (JSON or @file)
+git-ai config set rules '{"types":["feat","fix"]}'
+git-ai config set rules @rules.json --local
 
-```text
-package-lock.json
-dist/
-*.min.js
+# Branch rules
+git-ai config set branch '{"types":["feat","fix"],"pattern":"{type}/{issue?}{name}"}'
 ```
 
 ---
 
-## 📖 Usage
+## 🛠 Command Reference
 
-### Scenario 1: Interactive
-```bash
-git add .
-git-ai
-```
+| Command | Description |
+|--------|-------------|
+| `git-ai init` | Initialize config |
+| `git-ai config get/set/describe` | Config management |
+| `git-ai` / `git-ai commit` | Interactive commit |
+| `git-ai -a` | Agent mode |
+| `git-ai msg` | Message only (scripts/hooks) |
+| `git-ai branch` | Create branch interactively |
+| `git-ai hook install/remove` | Hook management |
+| `git-ai report` | Weekly report |
+| `git-ai pr` | PR description |
+| `git-ai release` | Release notes |
 
-### Scenario 2: Git Hook (Recommended) 🌟
-The smoothest experience. Install once, use forever.
+---
 
-```bash
-# Install for current project
-git-ai hook install
+## ⚡ Environment Variables
+
+- `GIT_AI_PROVIDER` / `GIT_AI_BASE_URL` / `GIT_AI_MODEL` / `GIT_AI_AGENT_MODEL`
+- `GIT_AI_API_KEY` (also `DEEPSEEK_API_KEY`, `OPENAI_API_KEY`)
+- `GIT_AI_TIMEOUT_MS`
+- `GIT_AI_MAX_DIFF_CHARS` / `GIT_AI_MAX_OUTPUT_TOKENS`
+- `GIT_AI_RULES_PRESET`
+- `GIT_AI_FALLBACK_MODELS`
+- `GIT_AI_POLICY_STRICT`
+- `GIT_AI_ISSUE_PATTERN` / `GIT_AI_ISSUE_PLACEMENT` / `GIT_AI_REQUIRE_ISSUE`
+- `GIT_AI_OUTPUT_FORMAT=json`
+- `GIT_AI_MSG_DELIM=<<<GIT_AI_END>>>`
+- `GIT_AI_HOOK_STRICT=1` / `GIT_AI_HOOK_FALLBACK=0`
+- `GIT_AI_BRANCH_PATTERN` / `GIT_AI_BRANCH_TYPES`
+- `GIT_AI_BRANCH_ISSUE_SEPARATOR` / `GIT_AI_BRANCH_NAME_MAXLEN`
 
-# Or install globally (for all projects)
-git-ai hook install --global
-```
+---
 
-**Then just run:**
-```bash
-git checkout -b feature/awesome-login
-# ... write code ...
-git add .
-git commit  # ✨ AI generates "feat(login): implement awesome login logic"
+## 🧩 Ignore File `.git-aiignore`
+
+```text
+package-lock.json
+dist/
+*.min.js
 ```
 
-### Scenario 3: Generate Reports
-Hate writing weekly reports?
+Also compatible with `.opencommitignore`.
 
-```bash
-# Generate report for this week
-git-ai report
+---
 
-# Generate report for the last 30 days
-git-ai report --days 30
-```
+## ❓Troubleshooting
+
+**1) 401 / Invalid API key**
+- `git-ai config get --json --local`
+- Check env overrides
+
+**2) Diff truncated**
+- Ignore large files via `.git-aiignore`
+- Or set `GIT_AI_MAX_DIFF_CHARS`
+
+**3) Agent falls back**
+- Set `GIT_AI_DEBUG=1` to see reasons
 
 ---
 
-## 🛠 Command Reference
+## 🤖 Supported Models
 
-| Command | Alias | Description |
-|---------|-------|-------------|
-| `git-ai init` | `config` | **Initialize Config** (Provider, Key, Language) |
-| `git-ai` | | Interactive generation & commit |
-| `git-ai -a` | | **Agent Mode** (Deep analysis & Impact check) |
-| `git-ai -y` | | Skip confirmation and commit directly |
-| `git-ai -n 3` | | Generate 3 options to choose from |
-| `git-ai -l en` | | Force language (en/zh) |
-| `git-ai hook install` | | **Install Git Hook** (supports `--global`) |
-| `git-ai report` | | **Generate AI Report** (supports `--days`) |
-| `git-ai msg` | | Generate message only (stdout for scripts) |
+| Type | Provider | Notes | Setup |
+|------|----------|------|-------|
+| **Local** | **Ollama** | Offline & private | `git-ai init` auto-detect |
+| | **LM Studio** | Good compatibility | Manual URL |
+| **CN** | **DeepSeek** | High value | API Key |
+| | **Qwen** | Long context | API Key |
+| | **Zhipu/Moonshot** | Popular in CN | API Key |
+| **Global** | **OpenAI** | Baseline GPT-4o | API Key |
 
 ---