@zjex/git-workflow 0.4.3 → 0.4.5

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/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@zjex/git-workflow",
-	"version": "0.4.3",
+	"version": "0.4.5",
 	"description": "🚀 极简的 Git 工作流 CLI 工具，让分支管理和版本发布变得轻松愉快",
 	"type": "module",
 	"bin": {

package/src/commands/amend-date.ts

@@ -19,14 +19,33 @@ function formatGitDate(date: Date): string {
 
 /**
  * 解析用户输入的日期
- * 支持格式：YYYY-MM-DD (默认 00:00:00)
+ * 支持格式：
+ * - YYYY-MM-DD (默认 00:00:00)
+ * - YYYY-MM-DD HH:mm:ss
  * @param input 用户输入
  * @returns Date 对象或 null
  */
 function parseDate(input: string): Date | null {
   const trimmed = input.trim();
-  const dateMatch = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})$/);
 
+  // 尝试匹配完整格式: YYYY-MM-DD HH:mm:ss
+  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),
+    );
+  }
+
+  // 尝试匹配简化格式: YYYY-MM-DD (默认 00:00:00)
+  const dateMatch = trimmed.match(/^(\d{4})-(\d{2})-(\d{2})$/);
   if (dateMatch) {
     const [, year, month, day] = dateMatch;
     return new Date(
@@ -120,7 +139,6 @@ export async function amendDate(commitHash?: string): Promise<void> {
         value: c,
         description: c.date,
       })),
-      pageSize: 15,
       theme,
     });
   }
@@ -133,7 +151,9 @@ export async function amendDate(commitHash?: string): Promise<void> {
   divider();
 
   // ========== 步骤 2: 输入新日期 ==========
-  console.log(colors.dim("输入日期格式: YYYY-MM-DD (如: 2026-01-19)"));
+  console.log(colors.dim("支持格式:"));
+  console.log(colors.dim("  YYYY-MM-DD (如: 2026-01-19，默认 00:00:00)"));
+  console.log(colors.dim("  YYYY-MM-DD HH:mm:ss (如: 2026-01-19 14:30:00)"));
   console.log("");
 
   const dateInput = await input({
@@ -141,7 +161,7 @@ export async function amendDate(commitHash?: string): Promise<void> {
     validate: (value) => {
       const parsed = parseDate(value);
       if (!parsed) {
-        return "日期格式不正确，请使用 YYYY-MM-DD 格式";
+        return "日期格式不正确，请使用 YYYY-MM-DD 或 YYYY-MM-DD HH:mm:ss 格式";
       }
       return true;
     },

package/src/commands/amend.ts

@@ -79,7 +79,6 @@ export async function amend(commitHash?: string): Promise<void> {
         value: c,
         description: c.message,
       })),
-      pageSize: 15,
       theme,
     });
   }

package/src/commands/branch.ts

@@ -7,6 +7,7 @@ import {
   theme,
   exec,
   execOutput,
+  execWithSpinner,
   getMainBranch,
   divider,
   type BranchType,
@@ -35,8 +36,8 @@ export async function getBranchName(type: BranchType): Promise<string | null> {
   // 描述是否必填，默认非必填
   const requireDescription =
     type === "feature"
-      ? config.featureRequireDescription ?? false
-      : config.hotfixRequireDescription ?? false;
+      ? (config.featureRequireDescription ?? false)
+      : (config.hotfixRequireDescription ?? false);
   const descMessage = requireDescription
     ? "请输入描述:"
     : "请输入描述 (可跳过):";
@@ -62,7 +63,7 @@ export async function getBranchName(type: BranchType): Promise<string | null> {
 
 export async function createBranch(
   type: BranchType,
-  baseBranchArg?: string | null
+  baseBranchArg?: string | null,
 ): Promise<void> {
   const config = getConfig();
 
@@ -142,12 +143,16 @@ export async function createBranch(
 
     if (shouldPush) {
       const pushSpinner = ora("正在推送到远程...").start();
-      try {
-        execSync(`git push -u origin "${branchName}"`, { stdio: "pipe" });
-        pushSpinner.succeed(`已推送到远程: origin/${branchName}`);
-      } catch {
-        pushSpinner.warn(
-          "远程推送失败，可稍后手动执行: git push -u origin " + branchName
+      const success = await execWithSpinner(
+        `git push -u origin "${branchName}"`,
+        pushSpinner,
+        `已推送到远程: origin/${branchName}`,
+        "远程推送失败",
+      );
+
+      if (!success) {
+        console.log(
+          colors.dim(`  可稍后手动执行: git push -u origin ${branchName}`),
         );
       }
     }
@@ -175,20 +180,23 @@ export async function deleteBranch(branchArg?: string): Promise<void> {
   if (!branch) {
     // 获取本地分支
     const localBranches = execOutput(
-      "git for-each-ref --sort=-committerdate refs/heads/ --format='%(refname:short)'"
+      "git for-each-ref --sort=-committerdate refs/heads/ --format='%(refname:short)'",
     )
       .split("\n")
       .filter((b) => b && b !== currentBranch);
 
     // 获取远程分支（排除 HEAD 和已有本地分支的）
     const remoteBranches = execOutput(
-      "git for-each-ref --sort=-committerdate refs/remotes/origin/ --format='%(refname:short)'"
+      "git for-each-ref --sort=-committerdate refs/remotes/origin/ --format='%(refname:short)'",
     )
       .split("\n")
       .map((b) => b.replace("origin/", ""))
       .filter(
         (b) =>
-          b && b !== "HEAD" && b !== currentBranch && !localBranches.includes(b)
+          b &&
+          b !== "HEAD" &&
+          b !== currentBranch &&
+          !localBranches.includes(b),
       );
 
     if (localBranches.length === 0 && remoteBranches.length === 0) {
@@ -252,14 +260,12 @@ export async function deleteBranch(branchArg?: string): Promise<void> {
       }
 
       const spinner = ora(`正在删除远程分支: origin/${remoteBranch}`).start();
-      try {
-        execSync(`git push origin --delete "${remoteBranch}"`, {
-          stdio: "pipe",
-        });
-        spinner.succeed(`远程分支已删除: origin/${remoteBranch}`);
-      } catch {
-        spinner.fail("远程分支删除失败");
-      }
+      await execWithSpinner(
+        `git push origin --delete "${remoteBranch}"`,
+        spinner,
+        `远程分支已删除: origin/${remoteBranch}`,
+        "远程分支删除失败",
+      );
       return;
     }
   }
@@ -275,7 +281,7 @@ export async function deleteBranch(branchArg?: string): Promise<void> {
   if (!localExists) {
     if (hasRemote) {
       console.log(
-        colors.yellow(`本地分支不存在，但远程分支存在: origin/${branch}`)
+        colors.yellow(`本地分支不存在，但远程分支存在: origin/${branch}`),
       );
       const deleteRemote = await select({
         message: `确认删除远程分支 origin/${branch}?`,
@@ -288,12 +294,12 @@ export async function deleteBranch(branchArg?: string): Promise<void> {
 
       if (deleteRemote) {
         const spinner = ora(`正在删除远程分支: origin/${branch}`).start();
-        try {
-          execSync(`git push origin --delete "${branch}"`, { stdio: "pipe" });
-          spinner.succeed(`远程分支已删除: origin/${branch}`);
-        } catch {
-          spinner.fail("远程分支删除失败");
-        }
+        await execWithSpinner(
+          `git push origin --delete "${branch}"`,
+          spinner,
+          `远程分支已删除: origin/${branch}`,
+          "远程分支删除失败",
+        );
       }
     } else {
       console.log(colors.red(`分支不存在: ${branch}`));
@@ -319,21 +325,24 @@ export async function deleteBranch(branchArg?: string): Promise<void> {
   }
 
   const localSpinner = ora(`正在删除本地分支: ${branch}`).start();
-  try {
-    execSync(`git branch -D "${branch}"`, { stdio: "pipe" });
-    localSpinner.succeed(`本地分支已删除: ${branch}`);
-  } catch {
-    localSpinner.fail("本地分支删除失败");
+  const localSuccess = await execWithSpinner(
+    `git branch -D "${branch}"`,
+    localSpinner,
+    `本地分支已删除: ${branch}`,
+    "本地分支删除失败",
+  );
+
+  if (!localSuccess) {
     return;
   }
 
   if (hasRemote) {
     const remoteSpinner = ora(`正在删除远程分支: origin/${branch}`).start();
-    try {
-      execSync(`git push origin --delete "${branch}"`, { stdio: "pipe" });
-      remoteSpinner.succeed(`远程分支已删除: origin/${branch}`);
-    } catch {
-      remoteSpinner.fail("远程分支删除失败");
-    }
+    await execWithSpinner(
+      `git push origin --delete "${branch}"`,
+      remoteSpinner,
+      `远程分支已删除: origin/${branch}`,
+      "远程分支删除失败",
+    );
   }
 }

package/src/commands/stash.ts

@@ -1,4 +1,4 @@
-import { execSync, spawn } from "child_process";
+import { spawn } from "child_process";
 import { select, input } from "@inquirer/prompts";
 import ora from "ora";
 import boxen from "boxen";
@@ -7,6 +7,8 @@ import {
   theme,
   divider,
   execOutput,
+  execAsync,
+  execWithSpinner,
   type BranchType,
 } from "../utils.js";
 import { getBranchName } from "./branch.js";
@@ -40,7 +42,7 @@ function parseStashList(): StashEntry[] {
       message = message || "(no message)";
 
       const filesRaw = execOutput(
-        `git stash show stash@{${index}} --name-only 2>/dev/null`
+        `git stash show stash@{${index}} --name-only 2>/dev/null`,
       );
       const files = filesRaw ? filesRaw.split("\n").filter(Boolean) : [];
 
@@ -145,10 +147,10 @@ async function showStashActions(entry: StashEntry): Promise<void> {
 
   switch (action) {
     case "apply":
-      applyStash(entry.index, false);
+      await applyStash(entry.index, false);
       break;
     case "pop":
-      applyStash(entry.index, true);
+      await applyStash(entry.index, true);
       break;
     case "branch":
       await createBranchFromStash(entry.index);
@@ -193,27 +195,34 @@ async function createStash(): Promise<void> {
   });
 
   const spinner = ora("创建 stash...").start();
-  try {
-    let cmd = "git stash push";
-    if (includeUntracked) cmd += " -u";
-    if (message) cmd += ` -m "${message.replace(/"/g, '\\"')}"`;
-    execSync(cmd, { stdio: "pipe" });
-    spinner.succeed("Stash 创建成功");
+  let cmd = "git stash push";
+  if (includeUntracked) cmd += " -u";
+  if (message) cmd += ` -m "${message.replace(/"/g, '\\"')}"`;
+
+  const success = await execWithSpinner(
+    cmd,
+    spinner,
+    "Stash 创建成功",
+    "Stash 创建失败",
+  );
+
+  if (success) {
     await stash();
-  } catch {
-    spinner.fail("Stash 创建失败");
   }
 }
 
-function applyStash(index: number, pop: boolean): void {
+async function applyStash(index: number, pop: boolean): Promise<void> {
   const action = pop ? "pop" : "apply";
   const spinner = ora(`${pop ? "弹出" : "应用"} stash...`).start();
 
-  try {
-    execSync(`git stash ${action} stash@{${index}}`, { stdio: "pipe" });
-    spinner.succeed(`Stash ${pop ? "已弹出" : "已应用"}`);
-  } catch {
-    spinner.fail("操作失败，可能存在冲突");
+  const success = await execWithSpinner(
+    `git stash ${action} stash@{${index}}`,
+    spinner,
+    `Stash ${pop ? "已弹出" : "已应用"}`,
+    "操作失败，可能存在冲突",
+  );
+
+  if (!success) {
     const status = execOutput("git status --porcelain");
     if (status.includes("UU") || status.includes("AA")) {
       console.log(colors.yellow("\n存在冲突，请手动解决后提交"));
@@ -225,7 +234,7 @@ async function showDiff(index: number): Promise<void> {
   try {
     // 获取差异内容（不使用颜色，我们自己格式化）
     const diffOutput = execOutput(
-      `git stash show -p --no-color stash@{${index}}`
+      `git stash show -p --no-color stash@{${index}}`,
     );
 
     if (!diffOutput) {
@@ -424,14 +433,12 @@ async function createBranchFromStash(index: number): Promise<void> {
   if (!branchName) return;
 
   const spinner = ora(`创建分支 ${branchName}...`).start();
-  try {
-    execSync(`git stash branch "${branchName}" stash@{${index}}`, {
-      stdio: "pipe",
-    });
-    spinner.succeed(`分支已创建: ${branchName} (stash 已自动弹出)`);
-  } catch {
-    spinner.fail("创建分支失败");
-  }
+  await execWithSpinner(
+    `git stash branch "${branchName}" stash@{${index}}`,
+    spinner,
+    `分支已创建: ${branchName} (stash 已自动弹出)`,
+    "创建分支失败",
+  );
 }
 
 async function dropStash(index: number): Promise<void> {
@@ -450,10 +457,10 @@ async function dropStash(index: number): Promise<void> {
   }
 
   const spinner = ora("删除 stash...").start();
-  try {
-    execSync(`git stash drop stash@{${index}}`, { stdio: "pipe" });
-    spinner.succeed("Stash 已删除");
-  } catch {
-    spinner.fail("删除失败");
-  }
+  await execWithSpinner(
+    `git stash drop stash@{${index}}`,
+    spinner,
+    "Stash 已删除",
+    "删除失败",
+  );
 }