@zjex/git-workflow 0.3.2 → 0.3.4

package/dist/index.js

@@ -660,7 +660,8 @@ async function listTags(prefix) {
   exec("git fetch --tags", true);
   spinner.stop();
   const pattern = prefix ? `${prefix}*` : "";
-  const tags = execOutput(`git tag -l ${pattern} --sort=v:refname`).split("\n").filter(Boolean);
+  const allTags = execOutput(`git tag -l ${pattern} --sort=v:refname`).split("\n").filter(Boolean);
+  const tags = allTags.filter((tag) => /\d/.test(tag));
   if (tags.length === 0) {
     console.log(
       colors.yellow(prefix ? `\u6CA1\u6709 '${prefix}' \u5F00\u5934\u7684 tag` : "\u6CA1\u6709 tag")
@@ -668,31 +669,31 @@ async function listTags(prefix) {
     return;
   }
   if (prefix) {
-    console.log(colors.green(`\u4EE5 '${prefix}' \u5F00\u5934\u7684 tags:`));
-    const displayTags = tags.length > 20 ? tags.slice(-20) : tags;
-    displayTags.forEach((tag) => console.log(`  ${tag}`));
-    if (tags.length > 20) {
-      console.log(colors.yellow(`
-\u5171 ${tags.length} \u4E2A\uFF0C\u4EC5\u663E\u793A\u6700\u65B0 20 \u4E2A`));
+    console.log(
+      colors.green(`\u4EE5 '${prefix}' \u5F00\u5934\u7684 tags (\u5171 ${tags.length} \u4E2A):`)
+    );
+    if (tags.length > 5) {
+      console.log(colors.dim("  ..."));
     }
+    const displayTags = tags.slice(-5);
+    displayTags.forEach((tag) => console.log(`  ${tag}`));
     return;
   }
   const grouped = /* @__PURE__ */ new Map();
   tags.forEach((tag) => {
-    const prefix2 = tag.replace(/[0-9].*/, "") || "(\u65E0\u524D\u7F00)";
+    const prefix2 = tag.replace(/\d.*/, "") || "(\u65E0\u524D\u7F00)";
     if (!grouped.has(prefix2)) {
       grouped.set(prefix2, []);
     }
     grouped.get(prefix2).push(tag);
   });
   if (grouped.size === 1) {
-    console.log(colors.green("\u6240\u6709 tags:"));
-    const displayTags = tags.length > 20 ? tags.slice(-20) : tags;
-    displayTags.forEach((tag) => console.log(`  ${tag}`));
-    if (tags.length > 20) {
-      console.log(colors.yellow(`
-\u5171 ${tags.length} \u4E2A\uFF0C\u4EC5\u663E\u793A\u6700\u65B0 20 \u4E2A`));
+    console.log(colors.green(`\u6240\u6709 tags (\u5171 ${tags.length} \u4E2A):`));
+    if (tags.length > 5) {
+      console.log(colors.dim("  ..."));
     }
+    const displayTags = tags.slice(-5);
+    displayTags.forEach((tag) => console.log(`  ${tag}`));
     return;
   }
   console.log(colors.green("\u6240\u6709 tags (\u6309\u524D\u7F00\u5206\u7EC4):"));
@@ -735,7 +736,7 @@ async function listTags(prefix) {
   }
 }
 function getLatestTag(prefix) {
-  const tags = execOutput(`git tag -l "${prefix}*" --sort=-v:refname`).split("\n").filter(Boolean);
+  const tags = execOutput(`git tag -l "${prefix}*" --sort=-v:refname`).split("\n").filter((tag) => tag && /\d/.test(tag));
   return tags[0] || "";
 }
 async function createTag(inputPrefix) {
@@ -750,7 +751,7 @@ async function createTag(inputPrefix) {
     console.log(colors.dim(`(\u4F7F\u7528\u914D\u7F6E\u7684\u9ED8\u8BA4\u524D\u7F00: ${prefix})`));
   }
   if (!prefix) {
-    const allTags = execOutput("git tag -l").split("\n").filter(Boolean);
+    const allTags = execOutput("git tag -l").split("\n").filter((tag) => tag && /\d/.test(tag));
     if (allTags.length === 0) {
       prefix = await input2({
         message: "\u5F53\u524D\u4ED3\u5E93\u6CA1\u6709 tag\uFF0C\u8BF7\u8F93\u5165\u524D\u7F00 (\u5982 v):",
@@ -797,7 +798,7 @@ async function createTag(inputPrefix) {
       return;
     }
     const prefixes = [
-      ...new Set(allTags.map((t) => t.replace(/[0-9].*/, "")).filter(Boolean))
+      ...new Set(allTags.map((t) => t.replace(/\d.*/, "")).filter(Boolean))
     ];
     if (prefixes.length === 0) {
       prefix = await input2({
@@ -1463,12 +1464,34 @@ async function init() {
       ],
       theme
     });
+    const aiUseEmoji = await select4({
+      message: "AI \u751F\u6210\u7684 commit message \u662F\u5426\u5305\u542B emoji?",
+      choices: [
+        {
+          name: "\u662F\uFF08\u63A8\u8350\uFF09",
+          value: true,
+          description: "\u5982\uFF1A\u2728 feat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD"
+        },
+        {
+          name: "\u5426",
+          value: false,
+          description: "\u5982\uFF1Afeat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD"
+        },
+        {
+          name: "\u8DDF\u968F\u5168\u5C40\u8BBE\u7F6E",
+          value: void 0,
+          description: `\u5F53\u524D\u5168\u5C40\u8BBE\u7F6E\uFF1A${useEmoji ? "\u542F\u7528" : "\u7981\u7528"} emoji`
+        }
+      ],
+      theme
+    });
     config2.aiCommit = {
       enabled: true,
       provider: aiProvider,
       apiKey: apiKey || void 0,
       language,
-      detailedDescription
+      detailedDescription,
+      useEmoji: aiUseEmoji
     };
     const defaultModels = {
       github: "gpt-4o-mini",
@@ -1812,13 +1835,13 @@ function getGitDiff() {
     return "";
   }
 }
-function buildPrompt(diff, language, detailedDescription = false) {
+function buildPrompt(diff, language, detailedDescription = false, useEmoji = true) {
   const isZh = language === "zh-CN";
   if (detailedDescription) {
     const systemPrompt = isZh ? `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 Git commit message \u751F\u6210\u52A9\u624B\u3002\u8BF7\u6839\u636E\u63D0\u4F9B\u7684 git diff \u751F\u6210\u7B26\u5408 Conventional Commits \u89C4\u8303\u7684\u8BE6\u7EC6 commit message\u3002
 
 \u683C\u5F0F\u8981\u6C42\uFF1A
-1. \u7B2C\u4E00\u884C\uFF1A<type>(<scope>): <subject>
+1. \u7B2C\u4E00\u884C\uFF1A${useEmoji ? "<emoji> " : ""}<type>(<scope>): <subject>
 2. \u7A7A\u884C
 3. \u8BE6\u7EC6\u63CF\u8FF0\uFF1A\u5217\u51FA\u4E3B\u8981\u4FEE\u6539\u70B9\uFF0C\u6BCF\u4E2A\u4FEE\u6539\u70B9\u4E00\u884C\uFF0C\u4EE5 "- " \u5F00\u5934
 
@@ -1829,9 +1852,22 @@ function buildPrompt(diff, language, detailedDescription = false) {
 - \u8BE6\u7EC6\u63CF\u8FF0\u8981\u5217\u51FA 3-6 \u4E2A\u4E3B\u8981\u4FEE\u6539\u70B9\uFF0C\u6BCF\u4E2A\u4FEE\u6539\u70B9\u7B80\u6D01\u660E\u4E86
 - \u5982\u679C\u4FEE\u6539\u8F83\u5C11\uFF0C\u53EF\u4EE5\u53EA\u5217\u51FA 2-3 \u4E2A\u4FEE\u6539\u70B9
 - \u4E0D\u8981\u6709\u5176\u4ED6\u89E3\u91CA\u6216\u591A\u4F59\u5185\u5BB9
+${useEmoji ? `
+Emoji \u6620\u5C04\u89C4\u5219\uFF1A
+- feat: \u2728 (\u65B0\u529F\u80FD)
+- fix: \u{1F41B} (\u4FEE\u590DBug)
+- docs: \u{1F4DD} (\u6587\u6863)
+- style: \u{1F484} (\u4EE3\u7801\u683C\u5F0F)
+- refactor: \u267B\uFE0F (\u91CD\u6784)
+- perf: \u26A1\uFE0F (\u6027\u80FD\u4F18\u5316)
+- test: \u2705 (\u6D4B\u8BD5)
+- build: \u{1F4E6} (\u6784\u5EFA)
+- ci: \u{1F477} (CI/CD)
+- chore: \u{1F527} (\u5176\u4ED6\u6742\u9879)
+- revert: \u23EA (\u56DE\u6EDA)` : ""}
 
 \u793A\u4F8B\uFF1A
-feat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD
+${useEmoji ? "\u2728 " : ""}feat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD
 
 - \u5B9E\u73B0\u7528\u6237\u540D\u5BC6\u7801\u767B\u5F55\u63A5\u53E3
 - \u6DFB\u52A0\u767B\u5F55\u72B6\u6001\u9A8C\u8BC1\u4E2D\u95F4\u4EF6
@@ -1839,7 +1875,7 @@ feat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD
 - \u66F4\u65B0\u7528\u6237\u8BA4\u8BC1\u76F8\u5173\u6587\u6863` : `You are a professional Git commit message generator. Generate a detailed commit message following Conventional Commits specification based on the provided git diff.
 
 Format requirements:
-1. First line: <type>(<scope>): <subject>
+1. First line: ${useEmoji ? "<emoji> " : ""}<type>(<scope>): <subject>
 2. Empty line
 3. Detailed description: List main changes, one per line, starting with "- "
 
@@ -1850,9 +1886,22 @@ Rules:
 - Detailed description should list 3-6 main changes, each change should be concise
 - If changes are minimal, list 2-3 changes
 - No explanations or extra content
+${useEmoji ? `
+Emoji mapping rules:
+- feat: \u2728 (new feature)
+- fix: \u{1F41B} (bug fix)
+- docs: \u{1F4DD} (documentation)
+- style: \u{1F484} (code style)
+- refactor: \u267B\uFE0F (refactoring)
+- perf: \u26A1\uFE0F (performance)
+- test: \u2705 (testing)
+- build: \u{1F4E6} (build)
+- ci: \u{1F477} (CI/CD)
+- chore: \u{1F527} (chore)
+- revert: \u23EA (revert)` : ""}
 
 Example:
-feat(auth): add user login functionality
+${useEmoji ? "\u2728 " : ""}feat(auth): add user login functionality
 
 - Implement username/password login API
 - Add login status validation middleware
@@ -1870,30 +1919,56 @@ ${userPrompt}`;
     const systemPrompt = isZh ? `\u4F60\u662F\u4E00\u4E2A\u4E13\u4E1A\u7684 Git commit message \u751F\u6210\u52A9\u624B\u3002\u8BF7\u6839\u636E\u63D0\u4F9B\u7684 git diff \u751F\u6210\u7B26\u5408 Conventional Commits \u89C4\u8303\u7684 commit message\u3002
 
 \u89C4\u5219\uFF1A
-1. \u683C\u5F0F\uFF1A<type>(<scope>): <subject>
+1. \u683C\u5F0F\uFF1A${useEmoji ? "<emoji> " : ""}<type>(<scope>): <subject>
 2. type \u5FC5\u987B\u662F\u4EE5\u4E0B\u4E4B\u4E00\uFF1Afeat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
 3. scope \u662F\u53EF\u9009\u7684\uFF0C\u8868\u793A\u5F71\u54CD\u8303\u56F4
 4. subject \u7528\u4E2D\u6587\u63CF\u8FF0\uFF0C\u7B80\u6D01\u660E\u4E86\uFF0C\u4E0D\u8D85\u8FC7 50 \u5B57
 5. \u53EA\u8FD4\u56DE\u4E00\u6761 commit message\uFF0C\u5373\u4F7F\u6709\u591A\u4E2A\u6587\u4EF6\u6539\u52A8\u4E5F\u8981\u603B\u7ED3\u6210\u4E00\u6761
 6. \u4E0D\u8981\u6709\u5176\u4ED6\u89E3\u91CA\u6216\u591A\u4F59\u5185\u5BB9
+${useEmoji ? `
+Emoji \u6620\u5C04\u89C4\u5219\uFF1A
+- feat: \u2728 (\u65B0\u529F\u80FD)
+- fix: \u{1F41B} (\u4FEE\u590DBug)
+- docs: \u{1F4DD} (\u6587\u6863)
+- style: \u{1F484} (\u4EE3\u7801\u683C\u5F0F)
+- refactor: \u267B\uFE0F (\u91CD\u6784)
+- perf: \u26A1\uFE0F (\u6027\u80FD\u4F18\u5316)
+- test: \u2705 (\u6D4B\u8BD5)
+- build: \u{1F4E6} (\u6784\u5EFA)
+- ci: \u{1F477} (CI/CD)
+- chore: \u{1F527} (\u5176\u4ED6\u6742\u9879)
+- revert: \u23EA (\u56DE\u6EDA)` : ""}
 
 \u793A\u4F8B\uFF1A
-- feat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD
-- fix(api): \u4FEE\u590D\u6570\u636E\u83B7\u53D6\u5931\u8D25\u7684\u95EE\u9898
-- docs(readme): \u66F4\u65B0\u5B89\u88C5\u8BF4\u660E` : `You are a professional Git commit message generator. Generate a commit message following Conventional Commits specification based on the provided git diff.
+- ${useEmoji ? "\u2728 " : ""}feat(auth): \u6DFB\u52A0\u7528\u6237\u767B\u5F55\u529F\u80FD
+- ${useEmoji ? "\u{1F41B} " : ""}fix(api): \u4FEE\u590D\u6570\u636E\u83B7\u53D6\u5931\u8D25\u7684\u95EE\u9898
+- ${useEmoji ? "\u{1F4DD} " : ""}docs(readme): \u66F4\u65B0\u5B89\u88C5\u8BF4\u660E` : `You are a professional Git commit message generator. Generate a commit message following Conventional Commits specification based on the provided git diff.
 
 Rules:
-1. Format: <type>(<scope>): <subject>
+1. Format: ${useEmoji ? "<emoji> " : ""}<type>(<scope>): <subject>
 2. type must be one of: feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert
 3. scope is optional, indicates the affected area
 4. subject should be concise, no more than 50 characters
 5. Return only ONE commit message, even if multiple files are changed, summarize into one message
 6. No explanations or extra content
+${useEmoji ? `
+Emoji mapping rules:
+- feat: \u2728 (new feature)
+- fix: \u{1F41B} (bug fix)
+- docs: \u{1F4DD} (documentation)
+- style: \u{1F484} (code style)
+- refactor: \u267B\uFE0F (refactoring)
+- perf: \u26A1\uFE0F (performance)
+- test: \u2705 (testing)
+- build: \u{1F4E6} (build)
+- ci: \u{1F477} (CI/CD)
+- chore: \u{1F527} (chore)
+- revert: \u23EA (revert)` : ""}
 
 Examples:
-- feat(auth): add user login functionality
-- fix(api): resolve data fetching failure
-- docs(readme): update installation guide`;
+- ${useEmoji ? "\u2728 " : ""}feat(auth): add user login functionality
+- ${useEmoji ? "\u{1F41B} " : ""}fix(api): resolve data fetching failure
+- ${useEmoji ? "\u{1F4DD} " : ""}docs(readme): update installation guide`;
     const userPrompt = isZh ? `\u8BF7\u6839\u636E\u4EE5\u4E0B git diff \u751F\u6210 commit message\uFF1A
 
 ${diff}` : `Generate a commit message based on the following git diff:
@@ -2017,13 +2092,14 @@ async function generateAICommitMessage(config2) {
   const language = aiConfig.language || "zh-CN";
   const detailedDescription = aiConfig.detailedDescription !== false;
   const maxTokens = aiConfig.maxTokens || (detailedDescription ? 400 : 200);
+  const useEmoji = aiConfig.useEmoji !== void 0 ? aiConfig.useEmoji : config2.useEmoji !== false;
   const diff = getGitDiff();
   if (!diff) {
     throw new Error("\u6CA1\u6709\u68C0\u6D4B\u5230\u4EE3\u7801\u66F4\u6539");
   }
   const maxDiffLength = detailedDescription ? 6e3 : 4e3;
   const truncatedDiff = diff.length > maxDiffLength ? diff.slice(0, maxDiffLength) + "\n..." : diff;
-  const prompt = buildPrompt(truncatedDiff, language, detailedDescription);
+  const prompt = buildPrompt(truncatedDiff, language, detailedDescription, useEmoji);
   const providerInfo = AI_PROVIDERS[provider];
   if (!providerInfo) {
     throw new Error(`\u4E0D\u652F\u6301\u7684 AI \u63D0\u4F9B\u5546: ${provider}`);
@@ -2244,7 +2320,14 @@ async function commit() {
   }
   const spinner = ora4("\u6B63\u5728\u63D0\u4EA4...").start();
   try {
-    const finalStatus = parseGitStatus();
+    let finalStatus = parseGitStatus();
+    if (finalStatus.staged.length === 0 && finalStatus.unstaged.length > 0) {
+      const autoStage = config2.autoStage ?? true;
+      if (autoStage) {
+        execSync5("git add -A", { stdio: "pipe" });
+        finalStatus = parseGitStatus();
+      }
+    }
     if (finalStatus.staged.length === 0) {
       spinner.fail("\u6CA1\u6709\u6682\u5B58\u7684\u6587\u4EF6\u53EF\u4EE5\u63D0\u4EA4");
       console.log("");
@@ -2255,8 +2338,9 @@ async function commit() {
       console.log("");
       return;
     }
-    const escapedMessage = message.replace(/"/g, '\\"');
-    execSync5(`git commit -m "${escapedMessage}"`, { stdio: "pipe" });
+    execSync5(`git commit -F -`, {
+      input: message
+    });
     spinner.succeed("\u63D0\u4EA4\u6210\u529F");
     const commitHash = execOutput("git rev-parse --short HEAD");
     console.log(colors.dim(`commit: ${commitHash}`));
@@ -2832,7 +2916,7 @@ process.on("SIGTERM", () => {
   console.log("");
   process.exit(0);
 });
-var version = true ? "0.3.2" : "0.0.0-dev";
+var version = true ? "0.3.4" : "0.0.0-dev";
 async function mainMenu() {
   console.log(
     colors.green(`

package/docs/.vitepress/cache/deps/_metadata.json

@@ -1,43 +1,43 @@
 {
-  "hash": "cb9fc065",
+  "hash": "f08de2d7",
   "configHash": "e91271f8",
-  "lockfileHash": "eae41063",
-  "browserHash": "fa434d50",
+  "lockfileHash": "f6311290",
+  "browserHash": "b692a8b2",
   "optimized": {
     "vue": {
       "src": "../../../../node_modules/vue/dist/vue.runtime.esm-bundler.js",
       "file": "vue.js",
-      "fileHash": "69cff841",
+      "fileHash": "6f2468ef",
       "needsInterop": false
     },
     "vitepress > @vue/devtools-api": {
       "src": "../../../../node_modules/@vue/devtools-api/dist/index.js",
       "file": "vitepress___@vue_devtools-api.js",
-      "fileHash": "5ad8b965",
+      "fileHash": "1a2fc2f9",
       "needsInterop": false
     },
     "vitepress > @vueuse/core": {
       "src": "../../../../node_modules/@vueuse/core/index.mjs",
       "file": "vitepress___@vueuse_core.js",
-      "fileHash": "9696f0e0",
+      "fileHash": "b2503aca",
       "needsInterop": false
     },
     "vitepress > @vueuse/integrations/useFocusTrap": {
       "src": "../../../../node_modules/@vueuse/integrations/useFocusTrap.mjs",
       "file": "vitepress___@vueuse_integrations_useFocusTrap.js",
-      "fileHash": "6cc36968",
+      "fileHash": "d3937329",
       "needsInterop": false
     },
     "vitepress > mark.js/src/vanilla.js": {
       "src": "../../../../node_modules/mark.js/src/vanilla.js",
       "file": "vitepress___mark__js_src_vanilla__js.js",
-      "fileHash": "08475884",
+      "fileHash": "9d53e58c",
       "needsInterop": false
     },
     "vitepress > minisearch": {
       "src": "../../../../node_modules/minisearch/dist/es/index.js",
       "file": "vitepress___minisearch.js",
-      "fileHash": "1cb3d774",
+      "fileHash": "4ea50106",
       "needsInterop": false
     }
   },

package/docs/.vitepress/config.ts

@@ -61,8 +61,9 @@ export default defineConfig({
             { text: '概览', link: '/commands/' },
             { text: '交互式菜单', link: '/commands/interactive' },
             { text: '分支命令', link: '/commands/branch' },
-            { text: 'Tag 命令', link: '/commands/tag' },
             { text: '提交命令', link: '/commands/commit' },
+            { text: '日志命令', link: '/commands/log' },
+            { text: 'Tag 命令', link: '/commands/tag' },
             { text: 'Stash 命令', link: '/commands/stash' },
             { text: '版本命令', link: '/commands/release' },
             { text: '配置命令', link: '/commands/config' },

package/docs/commands/help.md

@@ -0,0 +1,248 @@
+# gw help - 帮助命令
+
+`gw help` 命令提供了完整的命令帮助信息和使用指南。
+
+## 🎯 功能特性
+
+- 📋 **命令列表** - 显示所有可用命令及其描述
+- 🔍 **详细说明** - 每个命令的具体用法和参数
+- 💡 **使用示例** - 实际的命令使用示例
+- ⌨️ **快捷键** - 交互式界面的键盘操作
+- 🔗 **相关链接** - 文档链接和更多资源
+
+## 📋 命令格式
+
+```bash
+# 显示帮助信息
+gw help
+gw --help
+gw -h
+
+# 显示特定命令的帮助
+gw help <command>
+gw <command> --help
+gw <command> -h
+```
+
+## 🎨 帮助界面
+
+### 主帮助页面
+
+```bash
+gw help
+```
+
+```
+Git Workflow v0.3.2 - 极简的 Git 工作流 CLI 工具
+
+用法:
+  gw [command] [options]
+
+核心命令:
+  gw              显示交互式菜单
+  gw f, feat      创建 feature 分支
+  gw h, hotfix    创建 hotfix 分支
+  gw c, commit    提交代码（支持 AI 生成）
+  gw log, ls, l   查看提交历史（GitHub 风格）
+  gw t, tag       创建版本标签
+  gw d, delete    删除分支
+  gw s, stash     管理 stash
+
+辅助命令:
+  gw r, release   发布版本
+  gw ts, tags     列出标签
+  gw td           删除标签
+  gw tu           修改标签
+  gw init         初始化配置
+  gw upt, update  更新工具
+
+全局选项:
+  -h, --help      显示帮助信息
+  -v, --version   显示版本号
+  --config        指定配置文件路径
+  --no-emoji      禁用 emoji 显示
+
+示例:
+  gw              # 显示交互式菜单
+  gw f            # 创建 feature 分支
+  gw c            # AI 智能提交
+  gw log          # 查看提交历史
+  gw t v          # 创建 v 前缀的标签
+
+更多信息:
+  文档: https://iamzjt-front-end.github.io/git-workflow/
+  问题: https://github.com/iamzjt-front-end/git-workflow/issues
+```
+
+### 特定命令帮助
+
+```bash
+gw help commit
+# 或
+gw c --help
+```
+
+```
+gw commit - 提交代码
+
+用法:
+  gw c [options]
+  gw commit [options]
+
+描述:
+  交互式提交代码，支持 AI 自动生成 commit message
+
+选项:
+  -m, --message <msg>    直接指定 commit message
+  --ai                   强制使用 AI 生成
+  --manual               强制手动输入
+  --no-verify            跳过 pre-commit 钩子
+  --amend                修改上次提交
+  -h, --help             显示帮助信息
+
+示例:
+  gw c                   # 交互式选择提交方式
+  gw c --ai              # 直接使用 AI 生成
+  gw c -m "fix: bug"     # 直接提交指定消息
+  gw c --amend           # 修改上次提交
+
+相关命令:
+  gw log                 # 查看提交历史
+  gw s                   # 管理 stash
+```
+
+## 📚 命令分类帮助
+
+### 分支管理
+
+```bash
+gw help branch
+```
+
+显示所有分支相关命令的帮助：
+- `gw f` - 创建 feature 分支
+- `gw h` - 创建 hotfix 分支
+- `gw d` - 删除分支
+
+### 版本管理
+
+```bash
+gw help tag
+```
+
+显示所有标签相关命令的帮助：
+- `gw t` - 创建标签
+- `gw ts` - 列出标签
+- `gw td` - 删除标签
+- `gw tu` - 修改标签
+
+### 提交管理
+
+```bash
+gw help commit
+```
+
+显示所有提交相关命令的帮助：
+- `gw c` - 提交代码
+- `gw log` - 查看历史
+
+## 🔍 在线帮助
+
+### 快速查找
+
+如果不确定使用哪个命令，可以：
+
+1. **运行交互式菜单**
+   ```bash
+   gw
+   ```
+
+2. **查看完整帮助**
+   ```bash
+   gw help
+   ```
+
+3. **搜索特定功能**
+   ```bash
+   gw help | grep "分支"
+   ```
+
+### 详细文档
+
+每个命令都有详细的在线文档：
+
+- [命令概览](/commands/) - 所有命令的快速参考
+- [分支命令](/commands/branch) - 分支管理详细指南
+- [提交命令](/commands/commit) - 提交和 AI 功能
+- [日志命令](/commands/log) - 提交历史查看
+- [标签命令](/commands/tag) - 版本标签管理
+- [Stash 命令](/commands/stash) - 代码暂存管理
+
+## ⌨️ 交互式帮助
+
+在任何交互式界面中，都可以使用以下快捷键获取帮助：
+
+| 快捷键 | 功能 |
+|--------|------|
+| `h` / `?` | 显示当前界面的帮助 |
+| `Ctrl+H` | 显示全局帮助 |
+| `F1` | 显示详细帮助 |
+| `Esc` | 返回上级菜单 |
+
+## 🛠️ 故障排除
+
+### 常见问题
+
+**Q: 命令不存在或无法识别？**
+```bash
+# 检查安装
+npm list -g @zjex/git-workflow
+
+# 重新安装
+npm install -g @zjex/git-workflow@latest
+```
+
+**Q: 帮助信息显示不完整？**
+```bash
+# 调整终端窗口大小
+# 或使用分页查看
+gw help | less
+```
+
+**Q: 中文显示乱码？**
+```bash
+# 检查终端编码设置
+echo $LANG
+
+# 设置 UTF-8 编码
+export LANG=zh_CN.UTF-8
+```
+
+### 获取支持
+
+如果遇到问题，可以通过以下方式获取帮助：
+
+1. **查看详细日志**
+   ```bash
+   DEBUG=gw:* gw <command>
+   ```
+
+2. **检查配置**
+   ```bash
+   gw init --show-config
+   ```
+
+3. **提交问题**
+   - [GitHub Issues](https://github.com/iamzjt-front-end/git-workflow/issues)
+   - [讨论区](https://github.com/iamzjt-front-end/git-workflow/discussions)
+
+## 📖 更多资源
+
+- 📚 [完整文档](https://iamzjt-front-end.github.io/git-workflow/)
+- 🎥 [视频教程](https://github.com/iamzjt-front-end/git-workflow#videos)
+- 💡 [最佳实践](https://github.com/iamzjt-front-end/git-workflow/wiki)
+- 🔄 [更新日志](https://github.com/iamzjt-front-end/git-workflow/blob/main/CHANGELOG.md)
+
+---
+
+通过 `gw help` 命令，你可以随时获取最新的使用指南和帮助信息。如果有任何疑问，不要犹豫，直接查看帮助或访问在线文档。

package/docs/commands/index.md

@@ -12,6 +12,7 @@ Git Workflow 提供了一套简洁而强大的命令，涵盖了 Git 工作流
 | `gw f`  | `feat`, `feature` | 创建 feature 分支    | `gw f --base develop`   |
 | `gw h`  | `fix`, `hotfix`   | 创建 hotfix 分支     | `gw h`                  |
 | `gw c`  | `cm`, `commit`    | 提交代码（AI 模式）  | `gw c`                  |
+| `gw log`| `ls`, `l`         | 查看提交历史         | `gw log`                |
 | `gw t`  | `tag`             | 创建 tag             | `gw t v`                |
 | `gw d`  | `del`, `delete`   | 删除分支             | `gw d feature/old`      |
 | `gw s`  | `st`, `stash`     | 管理 stash           | `gw s`                  |
@@ -54,13 +55,14 @@ gw
   [2] 🐛 创建 hotfix 分支       gw h
   [3] 🗑️  删除分支               gw d
   [4] 📝 提交代码               gw c
-  [5] 🏷️  创建 tag               gw t
-  [6] 🗑️  删除 tag               gw td
-  [7] ✏️  修改 tag               gw tu
-  [8] 📋 列出 tags              gw ts
-  [9] 📦 发布版本               gw r
-  [a] 💾 管理 stash             gw s
-  [b] ⚙️  初始化配置             gw init
+  [5] 📋 查看提交历史           gw log
+  [6] 🏷️  创建 tag               gw t
+  [7] 🗑️  删除 tag               gw td
+  [8] ✏️  修改 tag               gw tu
+  [9] 📋 列出 tags              gw ts
+  [a] 📦 发布版本               gw r
+  [b] 💾 管理 stash             gw s
+  [c] ⚙️  初始化配置             gw init
   [0] ❓ 帮助
   [q] 退出
 ```
@@ -179,6 +181,7 @@ DEBUG=gw:* gw c
 处理代码提交和提交信息：
 
 - [**gw c**](/commands/commit) - 交互式提交（支持 AI 生成）
+- [**gw log**](/commands/log) - 查看 Git 提交历史（GitHub 风格）
 
 ### 版本管理
 
@@ -268,12 +271,14 @@ gw d
 
 - [**交互式菜单**](/commands/interactive) - 了解主菜单的所有功能
 - [**分支命令**](/commands/branch) - 掌握分支管理的最佳实践
-- [**Tag 命令**](/commands/tag) - 学习版本标签的高级用法
 - [**提交命令**](/commands/commit) - 深入了解 AI 提交和手动提交
+- [**日志命令**](/commands/log) - GitHub 风格的提交历史查看
+- [**Tag 命令**](/commands/tag) - 学习版本标签的高级用法
 - [**Stash 命令**](/commands/stash) - 高效管理代码暂存
 - [**版本命令**](/commands/release) - 自动化版本发布流程
 - [**配置命令**](/commands/config) - 自定义工具行为
 - [**更新命令**](/commands/update) - 保持工具最新状态
+- [**帮助命令**](/commands/help) - 获取详细的使用帮助和故障排除
 
 ## 🔍 命令查找
 
@@ -283,6 +288,7 @@ gw d
 
 - **我想创建分支** → `gw f` (feature) 或 `gw h` (hotfix)
 - **我想提交代码** → `gw c` (commit)
+- **我想查看历史** → `gw log` (log)
 - **我想创建版本** → `gw t` (tag) 或 `gw r` (release)
 - **我想删除分支** → `gw d` (delete)
 - **我想管理 stash** → `gw s` (stash)
@@ -294,6 +300,7 @@ gw d
 - **开始新功能** → `gw f`
 - **修复紧急 Bug** → `gw h`
 - **提交当前更改** → `gw c`
+- **查看项目历史** → `gw log`
 - **发布新版本** → `gw r` + `gw t`
 - **清理旧分支** → `gw d`
 - **暂存当前工作** → `gw s`