@zjex/git-workflow 0.4.4 → 0.4.6

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## [v1.0.0](https://github.com/iamzjt-front-end/git-workflow/compare/v0.4.5...v1.0.0) (2026-01-19)
+
+
+## [v0.4.5](https://github.com/iamzjt-front-end/git-workflow/compare/v0.4.4...v0.4.5) (2026-01-19)
+
+### ✨ Features
+
+- 更新日期格式说明，支持完整时间输入 ([25f2b39](https://github.com/iamzjt-front-end/git-workflow/commit/25f2b39))
+
+### 📖 Documentation
+
+- 📝 docs: 自动更新测试数量徽章 [skip ci] ([c49a4bd](https://github.com/iamzjt-front-end/git-workflow/commit/c49a4bd))
+
+### 🔧 Chore
+
+- 🔖 chore(release): 发布 v0.4.5 ([8abd7b4](https://github.com/iamzjt-front-end/git-workflow/commit/8abd7b4))
+
+
+## [v0.4.4](https://github.com/iamzjt-front-end/git-workflow/compare/v0.4.3...v0.4.4) (2026-01-19)
+
+### ✨ Features
+
+- 优化分支创建和删除功能的用户体验 ([88dec43](https://github.com/iamzjt-front-end/git-workflow/commit/88dec43))
+
+### 🔧 Chore
+
+- 🔖 chore(release): 发布 v0.4.4 ([d673bfb](https://github.com/iamzjt-front-end/git-workflow/commit/d673bfb))
+
+
 ## [v0.4.3](https://github.com/iamzjt-front-end/git-workflow/compare/v0.4.2...v0.4.3) (2026-01-19)
 
 ### ✨ Features

package/README.md

@@ -12,7 +12,7 @@
   <a href="https://github.com/iamzjt-front-end/git-workflow"><img src="https://img.shields.io/github/stars/iamzjt-front-end/git-workflow?style=flat&colorA=18181B&colorB=F59E0B" alt="github stars"></a>
   <a href="https://github.com/iamzjt-front-end/git-workflow/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/@zjex/git-workflow?style=flat&colorA=18181B&colorB=10B981" alt="license"></a>
   <a href="https://nodejs.org"><img src="https://img.shields.io/badge/node-%3E%3D18-339933?style=flat&logo=node.js&logoColor=white&colorA=18181B" alt="node version"></a>
-  <a href="https://github.com/iamzjt-front-end/git-workflow/actions"><img src="https://img.shields.io/badge/tests-431%20passed-success?style=flat&colorA=18181B" alt="tests"></a>
+  <a href="https://github.com/iamzjt-front-end/git-workflow/actions"><img src="https://img.shields.io/badge/tests-474%20passed-success?style=flat&colorA=18181B" alt="tests"></a>
   <a href="https://github.com/iamzjt-front-end/git-workflow/issues"><img src="https://img.shields.io/github/issues/iamzjt-front-end/git-workflow?style=flat&colorA=18181B&colorB=EC4899" alt="issues"></a>
 </p>
 

package/dist/index.js

@@ -11,6 +11,9 @@ var __export = (target, all) => {
 
 // src/utils.ts
 import { execSync, spawn } from "child_process";
+function setDebugMode(enabled) {
+  debugMode = enabled;
+}
 function exec(cmd, silent = false) {
   try {
     const options = {
@@ -53,21 +56,57 @@ function divider() {
 }
 function execAsync(command, spinner) {
   return new Promise((resolve) => {
-    const [cmd, ...args] = command.split(" ");
-    const process2 = spawn(cmd, args, {
-      stdio: spinner ? "pipe" : "inherit"
+    if (debugMode) {
+      console.log(colors.dim(`
+[DEBUG] \u6267\u884C\u547D\u4EE4: ${colors.cyan(command)}`));
+    }
+    const process2 = spawn(command, {
+      stdio: spinner ? "pipe" : "inherit",
+      shell: true
     });
+    let errorOutput = "";
+    let stdoutOutput = "";
+    if (debugMode && process2.stdout) {
+      process2.stdout.on("data", (data) => {
+        stdoutOutput += data.toString();
+      });
+    }
+    if (process2.stderr) {
+      process2.stderr.on("data", (data) => {
+        errorOutput += data.toString();
+      });
+    }
     process2.on("close", (code) => {
-      resolve(code === 0);
+      if (debugMode) {
+        console.log(colors.dim(`[DEBUG] \u9000\u51FA\u7801: ${code}`));
+        if (stdoutOutput) {
+          console.log(colors.dim(`[DEBUG] \u6807\u51C6\u8F93\u51FA:
+${stdoutOutput}`));
+        }
+        if (errorOutput) {
+          console.log(colors.dim(`[DEBUG] \u9519\u8BEF\u8F93\u51FA:
+${errorOutput}`));
+        }
+      }
+      if (code === 0) {
+        resolve({ success: true });
+      } else {
+        resolve({ success: false, error: errorOutput.trim() });
+      }
     });
-    process2.on("error", () => {
-      resolve(false);
+    process2.on("error", (err) => {
+      if (debugMode) {
+        console.log(colors.dim(`[DEBUG] \u8FDB\u7A0B\u9519\u8BEF: ${err.message}`));
+        console.log(colors.dim(`[DEBUG] \u9519\u8BEF\u5806\u6808:
+${err.stack}`));
+      }
+      resolve({ success: false, error: err.message });
     });
   });
 }
 async function execWithSpinner(command, spinner, successMessage, errorMessage) {
-  const success = await execAsync(command, spinner);
-  if (success) {
+  const result = await execAsync(command, spinner);
+  if (result.success) {
     if (successMessage) {
       spinner.succeed(successMessage);
     } else {
@@ -79,13 +118,27 @@ async function execWithSpinner(command, spinner, successMessage, errorMessage) {
     } else {
       spinner.fail();
     }
+    if (result.error) {
+      console.log(colors.dim(`  ${result.error}`));
+    }
+    if (debugMode) {
+      console.log(colors.yellow("\n[DEBUG] \u6545\u969C\u6392\u67E5\u4FE1\u606F:"));
+      console.log(colors.dim(`  \u547D\u4EE4: ${command}`));
+      console.log(colors.dim(`  \u5DE5\u4F5C\u76EE\u5F55: ${process.cwd()}`));
+      console.log(colors.dim(`  Shell: ${process.env.SHELL || "unknown"}`));
+      console.log(
+        colors.dim(`  \u5EFA\u8BAE: \u5C1D\u8BD5\u5728\u7EC8\u7AEF\u4E2D\u76F4\u63A5\u8FD0\u884C\u4E0A\u8FF0\u547D\u4EE4\u4EE5\u83B7\u53D6\u66F4\u591A\u4FE1\u606F
+`)
+      );
+    }
   }
-  return success;
+  return result.success;
 }
-var colors, TODAY, theme;
+var debugMode, colors, TODAY, theme;
 var init_utils = __esm({
   "src/utils.ts"() {
     "use strict";
+    debugMode = false;
     colors = {
       red: (s) => `\x1B[31m${s}\x1B[0m`,
       green: (s) => `\x1B[32m${s}\x1B[0m`,
@@ -3223,6 +3276,20 @@ function formatGitDate(date) {
 }
 function parseDate(input8) {
   const trimmed = input8.trim();
+  const fullMatch = trimmed.match(
+    /^(\d{4})-(\d{2})-(\d{2})\s+(\d{2}):(\d{2}):(\d{2})$/
+  );
+  if (fullMatch) {
+    const [, year, month, day, hours, minutes, seconds] = fullMatch;
+    return new Date(
+      parseInt(year),
+      parseInt(month) - 1,
+      parseInt(day),
+      parseInt(hours),
+      parseInt(minutes),
+      parseInt(seconds)
+    );
+  }
   const dateMatch = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})$/);
   if (dateMatch) {
     const [, year, month, day] = dateMatch;
@@ -3279,7 +3346,6 @@ async function amendDate(commitHash) {
         value: c,
         description: c.date
       })),
-      pageSize: 15,
       theme
     });
   }
@@ -3289,14 +3355,16 @@ async function amendDate(commitHash) {
   console.log(`  Message: ${selectedCommit.message}`);
   console.log(`  Date:    ${colors.cyan(selectedCommit.date)}`);
   divider();
-  console.log(colors.dim("\u8F93\u5165\u65E5\u671F\u683C\u5F0F: YYYY-MM-DD (\u5982: 2026-01-19)"));
+  console.log(colors.dim("\u652F\u6301\u683C\u5F0F:"));
+  console.log(colors.dim("  YYYY-MM-DD (\u5982: 2026-01-19\uFF0C\u9ED8\u8BA4 00:00:00)"));
+  console.log(colors.dim("  YYYY-MM-DD HH:mm:ss (\u5982: 2026-01-19 14:30:00)"));
   console.log("");
   const dateInput = await input6({
     message: "\u8F93\u5165\u65B0\u7684\u65E5\u671F:",
     validate: (value) => {
       const parsed = parseDate(value);
       if (!parsed) {
-        return "\u65E5\u671F\u683C\u5F0F\u4E0D\u6B63\u786E\uFF0C\u8BF7\u4F7F\u7528 YYYY-MM-DD \u683C\u5F0F";
+        return "\u65E5\u671F\u683C\u5F0F\u4E0D\u6B63\u786E\uFF0C\u8BF7\u4F7F\u7528 YYYY-MM-DD \u6216 YYYY-MM-DD HH:mm:ss \u683C\u5F0F";
       }
       return true;
     },
@@ -3409,7 +3477,6 @@ async function amend(commitHash) {
         value: c,
         description: c.message
       })),
-      pageSize: 15,
       theme
     });
   }
@@ -3519,7 +3586,7 @@ process.on("SIGTERM", () => {
   console.log("");
   process.exit(0);
 });
-var version = true ? "0.4.4" : "0.0.0-dev";
+var version = true ? "0.4.6" : "0.0.0-dev";
 async function mainMenu() {
   console.log(
     colors.green(`
@@ -3799,7 +3866,12 @@ cli.command("clean", "\u6E05\u7406\u7F13\u5B58\u548C\u4E34\u65F6\u6587\u4EF6").a
 });
 cli.option("-v, --version", "\u663E\u793A\u7248\u672C\u53F7");
 cli.option("-h, --help", "\u663E\u793A\u5E2E\u52A9\u4FE1\u606F");
+cli.option("-d, --debug", "\u542F\u7528\u8C03\u8BD5\u6A21\u5F0F\uFF0C\u663E\u793A\u8BE6\u7EC6\u7684\u547D\u4EE4\u548C\u9519\u8BEF\u4FE1\u606F");
 var processArgs = process.argv.slice(2);
+if (processArgs.includes("-d") || processArgs.includes("--debug")) {
+  setDebugMode(true);
+  console.log(colors.yellow("\u{1F41B} Debug \u6A21\u5F0F\u5DF2\u542F\u7528\n"));
+}
 if (processArgs.includes("-v") || processArgs.includes("--version")) {
   console.log(colors.yellow(`v${version}`));
   process.exit(0);

package/docs/commands/amend-date.md

@@ -66,12 +66,17 @@ gw ad HEAD~2    # 上上个 commit
 ### 步骤 3: 输入新日期
 
 ```
-输入日期格式: YYYY-MM-DD (如: 2026-01-19)
+支持格式:
+  YYYY-MM-DD (如: 2026-01-19，默认 00:00:00)
+  YYYY-MM-DD HH:mm:ss (如: 2026-01-19 14:30:00)
 
-? 输入新的日期: 2026-01-15
+? 输入新的日期: 2026-01-15 14:30:00
 ```
 
-**日期格式**: `YYYY-MM-DD`，时间默认为 `00:00:00`
+**支持的日期格式**:
+
+- `YYYY-MM-DD` - 只指定日期，时间默认为 `00:00:00`
+- `YYYY-MM-DD HH:mm:ss` - 指定完整的日期和时间
 
 ### 步骤 4: 确认修改
 
@@ -79,7 +84,7 @@ gw ad HEAD~2    # 上上个 commit
 修改预览:
   Commit:   a1b2c3d
   旧时间:   2026-01-19 14:30:00 +0800
-  新时间:   2026-01-15 00:00:00
+  新时间:   2026-01-15 14:30:00
   修改类型: Author + Committer (两者都修改)
 ────────────────────────────────────────
 
@@ -164,9 +169,37 @@ git push --force
 
 ### 📅 时间格式
 
-- **输入格式**: `YYYY-MM-DD`（如 `2026-01-19`）
-- **存储格式**: `YYYY-MM-DD 00:00:00`（时间默认为 00:00:00）
-- **时区**: 使用系统当前时区
+支持两种输入格式：
+
+1. **仅日期**: `YYYY-MM-DD`（如 `2026-01-19`）
+   - 时间默认为 `00:00:00`
+   - 适合只关心日期的场景
+
+2. **完整时间**: `YYYY-MM-DD HH:mm:ss`（如 `2026-01-19 14:30:00`）
+   - 可以精确指定时分秒
+   - 适合需要精确时间的场景
+
+**示例**:
+
+```bash
+# 只指定日期
+输入: 2026-01-19
+结果: 2026-01-19 00:00:00
+
+# 指定完整时间
+输入: 2026-01-19 14:30:00
+结果: 2026-01-19 14:30:00
+
+# 指定午夜
+输入: 2026-01-19 00:00:00
+结果: 2026-01-19 00:00:00
+
+# 指定一天结束
+输入: 2026-01-19 23:59:59
+结果: 2026-01-19 23:59:59
+```
+
+**时区**: 使用系统当前时区
 
 ### 🔄 修改范围
 
@@ -187,11 +220,21 @@ $ gw ad HEAD
 ✔ 修改成功
 ```
 
-### 示例 2: 修改指定 hash 的 commit
+### 示例 2: 修改为指定的完整时间
+
+```bash
+$ gw ad HEAD
+输入新的日期: 2026-01-15 14:30:00
+确认修改? y
+
+✔ 修改成功
+```
+
+### 示例 3: 修改指定 hash 的 commit
 
 ```bash
 $ gw ad a1b2c3d
-输入新的日期: 2026-01-10
+输入新的日期: 2026-01-10 09:00:00
 确认修改? y
 
 ⚠️  警告: 修改非最新 commit 需要使用 rebase，可能会改变 commit hash
@@ -199,7 +242,7 @@ $ gw ad a1b2c3d
 ✔ 修改成功
 ```
 
-### 示例 3: 交互式选择并修改
+### 示例 4: 交互式选择并修改
 
 ```bash
 $ gw ad
@@ -208,7 +251,7 @@ $ gw ad
 ❯ a1b2c3d ✨ feat: 添加登录功能 2026-01-19 14:30:00
   d4e5f6g 🐛 fix: 修复bug 2026-01-18 10:20:00
 
-输入新的日期: 2026-01-15
+输入新的日期: 2026-01-15 16:45:30
 确认修改? y
 
 ✔ 修改成功
@@ -363,11 +406,30 @@ git am < patch.diff
 
 ### Q: 为什么时间是 00:00:00？
 
-A: 为了简化操作，只需要输入日期（YYYY-MM-DD），时间默认为 00:00:00。大多数情况下，我们只关心日期，不需要精确到秒。
+A: 当你只输入日期（YYYY-MM-DD）时，时间会默认为 00:00:00。这是为了简化操作，大多数情况下我们只关心日期。
+
+如果需要指定精确时间，可以使用完整格式：
+
+```bash
+# 只输入日期
+输入: 2026-01-15
+结果: 2026-01-15 00:00:00
+
+# 输入完整时间
+输入: 2026-01-15 14:30:00
+结果: 2026-01-15 14:30:00
+```
 
 ### Q: 可以修改时间部分吗？
 
-A: 当前版本只支持修改日期，时间固定为 00:00:00。如需精确时间，可以手动使用 git 命令：
+A: 可以！使用完整格式 `YYYY-MM-DD HH:mm:ss` 即可指定精确时间：
+
+```bash
+$ gw ad
+输入新的日期: 2026-01-15 14:30:00
+```
+
+如果需要更灵活的控制，也可以手动使用 git 命令：
 
 ```bash
 # 修改最新 commit 的时间为指定的精确时间

package/docs/guide/command-quotes-handling.md

@@ -0,0 +1,279 @@
+# 命令参数引号处理
+
+本文档说明了 git-workflow 如何正确处理带引号和特殊字符的命令参数。
+
+## 问题背景
+
+在早期版本中，使用简单的字符串分割方式处理命令参数：
+
+```typescript
+// ❌ 错误的方式
+const [cmd, ...args] = command.split(" ");
+spawn(cmd, args);
+```
+
+这种方式无法正确处理引号：
+
+```javascript
+'git tag -a "v1.5.3" -m "Release v1.5.3"'.split(" ");
+// 结果: ["git", "tag", "-a", '"v1.5.3"', "-m", '"Release', 'v1.5.3"']
+// 引号被当作参数的一部分！
+```
+
+导致的问题：
+
+- Tag 名称包含引号：`"v1.5.3"` 而不是 `v1.5.3`
+- Git 报错：`fatal: Failed to resolve '"v1.5.3"' as a valid ref.`
+
+## 解决方案
+
+使用 `shell: true` 选项让 spawn 通过 shell 执行命令：
+
+```typescript
+// ✅ 正确的方式
+spawn(command, {
+  stdio: spinner ? "pipe" : "inherit",
+  shell: true, // 使用 shell 模式
+});
+```
+
+### 优势
+
+1. **正确处理引号**：Shell 会自动解析和移除引号
+2. **支持特殊字符**：emoji、中文、空格等都能正确处理
+3. **支持转义**：`\"` 等转义字符正常工作
+
+## 支持的场景
+
+### 1. Tag 命令
+
+```bash
+# 基本版本号
+gw tag  # 创建 v1.5.3
+
+# 预发布版本
+gw tag  # 创建 v1.0.0-beta.1
+
+# 带特殊字符
+git tag -a "v1.0.0-🎉" -m "Release 🎉"
+```
+
+### 2. Branch 命令
+
+```bash
+# 带日期和描述的分支
+gw b feature  # 创建 feature/20240120-123-add-feature
+
+# 删除带特殊字符的分支
+git branch -D "feature/20240120-123-add-feature"
+git push origin --delete "feature/20240120-123-add-feature"
+```
+
+### 3. Stash 命令
+
+```bash
+# 带中文的 stash 消息
+git stash push -m "临时保存：修复登录bug"
+
+# 带引号的消息
+git stash push -m "WIP: 添加\"新功能\""
+
+# 从 stash 创建分支
+git stash branch "feature/from-stash" stash@{0}
+```
+
+### 4. Commit 命令
+
+```bash
+# 带特殊字符的提交消息
+git commit -m "feat: add \"quotes\" support"
+git commit -m "fix: 修复登录问题 🐛"
+```
+
+## 测试覆盖
+
+我们创建了全面的测试用例来确保引号处理的正确性：
+
+### 测试场景
+
+1. **基本引号处理**
+   - 带引号的 tag 名称
+   - 带空格的分支名称
+   - 带特殊字符的 commit message
+
+2. **特殊字符支持**
+   - Emoji：`v1.0.0-🎉`
+   - 中文：`临时保存：修复bug`
+   - 转义引号：`feat: add \"quotes\" support`
+
+3. **错误处理**
+   - 捕获 stderr 错误信息
+   - 显示详细的失败原因
+   - 提供解决建议
+
+### 运行测试
+
+```bash
+# 运行引号处理测试
+npm test -- tests/command-with-quotes.test.ts
+
+# 运行所有测试
+npm test
+```
+
+## 错误信息改进
+
+现在当命令失败时，会显示详细的错误信息：
+
+### Tag 已存在
+
+```
+✗ Tag v1.5.3 已存在
+
+  提示: 如需重新创建，请先删除旧 tag:
+  git tag -d v1.5.3
+  git push origin --delete v1.5.3
+```
+
+### 没有提交
+
+```
+✗ 当前仓库没有任何提交
+
+  提示: 需要先创建至少一个提交才能打 tag:
+  git add .
+  git commit -m "Initial commit"
+  gw tag
+```
+
+### Git 命令错误
+
+```
+✗ tag 创建失败
+  fatal: Failed to resolve 'HEAD' as a valid ref.
+```
+
+## 实现细节
+
+### execAsync 函数
+
+```typescript
+export function execAsync(
+  command: string,
+  spinner?: Ora,
+): Promise<{ success: boolean; error?: string }> {
+  return new Promise((resolve) => {
+    const process = spawn(command, {
+      stdio: spinner ? "pipe" : "inherit",
+      shell: true, // 关键：使用 shell 模式
+    });
+
+    let errorOutput = "";
+
+    // 捕获错误输出
+    if (process.stderr) {
+      process.stderr.on("data", (data) => {
+        errorOutput += data.toString();
+      });
+    }
+
+    process.on("close", (code) => {
+      if (code === 0) {
+        resolve({ success: true });
+      } else {
+        resolve({ success: false, error: errorOutput.trim() });
+      }
+    });
+
+    process.on("error", (err) => {
+      resolve({ success: false, error: err.message });
+    });
+  });
+}
+```
+
+### execWithSpinner 函数
+
+```typescript
+export async function execWithSpinner(
+  command: string,
+  spinner: Ora,
+  successMessage?: string,
+  errorMessage?: string,
+): Promise<boolean> {
+  const result = await execAsync(command, spinner);
+
+  if (result.success) {
+    if (successMessage) {
+      spinner.succeed(successMessage);
+    } else {
+      spinner.succeed();
+    }
+  } else {
+    if (errorMessage) {
+      spinner.fail(errorMessage);
+    } else {
+      spinner.fail();
+    }
+
+    // 显示具体的错误信息
+    if (result.error) {
+      console.log(colors.dim(`  ${result.error}`));
+    }
+  }
+
+  return result.success;
+}
+```
+
+## 最佳实践
+
+### 1. 始终使用引号包裹可能包含特殊字符的参数
+
+```typescript
+// ✅ 推荐
+await execAsync(`git tag -a "${tagName}" -m "Release ${tagName}"`);
+
+// ❌ 不推荐（如果 tagName 包含空格会失败）
+await execAsync(`git tag -a ${tagName} -m Release ${tagName}`);
+```
+
+### 2. 转义用户输入中的引号
+
+```typescript
+// ✅ 正确处理用户输入
+const message = userInput.replace(/"/g, '\\"');
+await execAsync(`git commit -m "${message}"`);
+```
+
+### 3. 使用 execWithSpinner 显示进度
+
+```typescript
+// ✅ 推荐：显示进度和错误信息
+const spinner = ora("正在创建 tag...").start();
+const success = await execWithSpinner(
+  `git tag -a "${tagName}" -m "Release ${tagName}"`,
+  spinner,
+  "Tag 创建成功",
+  "Tag 创建失败",
+);
+
+if (!success) {
+  // 错误信息已自动显示
+  return;
+}
+```
+
+## 相关文件
+
+- `src/utils.ts` - execAsync 和 execWithSpinner 实现
+- `tests/command-with-quotes.test.ts` - 引号处理测试
+- `src/commands/tag.ts` - Tag 命令实现
+- `src/commands/branch.ts` - Branch 命令实现
+- `src/commands/stash.ts` - Stash 命令实现
+
+## 版本历史
+
+- **v0.4.5** - 修复引号处理问题，添加详细错误信息
+- **v0.4.4** - 修复 spinner 阻塞问题
+- **v0.4.3** - 添加 execAsync 和 execWithSpinner 函数