From 9d0b957125d921d7abad79d0b2d4688fbf3d65d8 Mon Sep 17 00:00:00 2001 From: Odboy Date: Tue, 3 Nov 2026 23:20:16 +0800 Subject: [PATCH] =?UTF-8?q?feat:=20=E6=96=B0=E5=A2=9E=20git.time=20?= =?UTF-8?q?=E4=BF=AE=E6=94=B9=E6=9C=80=E5=90=8E=E4=B8=80=E6=AC=A1=E6=8F=90?= =?UTF-8?q?=E4=BA=A4=E6=97=B6=E9=97=B4=E5=91=BD=E4=BB=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.git.md | 51 ++++++++- README.md | 20 +++- internal/executor/gittime.go | 199 +++++++++++++++++++++++++++++++++++ 3 files changed, 262 insertions(+), 8 deletions(-) create mode 100644 internal/executor/gittime.go diff --git a/README.git.md b/README.git.md index 8cfc375..e82789c 100644 --- a/README.git.md +++ b/README.git.md @@ -2,16 +2,61 @@ > 返回 [README.md](README.md) -按日期范围批量调整提交时间，然后强推。用于把一批提交的时分秒统一挪到某个时间段。 +按日期范围批量调整提交时间，或修改最后一次提交的时间，然后强推。 ```bash kopsc git retime 2026-10-01 2026-10-15 # 预览：会改哪些提交、改成什么时间 kopsc git retime 2026-10-01 2026-10-15 --yes # 确认后真正改写并强推 + +kopsc git time 2026-11-05 22:30:00 # 预览：修改最后一次提交的时间 +kopsc git time 2026-11-05 22:30:00 --yes # 确认后修改并强推 ``` -> ⚠️ **这会改写历史并强推**，提交 SHA 会全部变化。默认只预览、不改任何东西，必须显式加 `--yes` 才会执行。 +> ⚠️ **这会改写历史并强推**，提交 SHA 会变化。默认只预览、不改任何东西，必须显式加 `--yes` 才会执行。 -## 改写提交时间（git.retime） +## 修改最后一次提交时间（git.time） + +`kopsc git time <时间>` 把本地最后一次提交的作者时间和提交时间改为用户指定的时间，然后强制推送。 + +```bash +kopsc git time 2026-11-05 22:30:00 # 预览 +kopsc git time 2026-11-05 22:30:00 --yes # 修改并强推 +kopsc git time 2026-11-05 22:30:00 --no-push # 只改本地，不推送 +``` + +### 时间格式 + +时间格式必须是 `yyyy-MM-dd HH:mm:ss`，如 `2026-11-05 22:30:00`。格式不正确会报错。 + +### 预览示例 + +```text +修改最后一次提交的时间 + +提交: abc1234 feat: 新增功能 +当前时间: 2026-11-05 10:15:30 +修改为: 2026-11-05 22:30:00 + +将强推到 origin/main + +这是破坏性操作，会改变提交历史。加 --yes 确认执行。 +``` + +### 实现细节 + +同时修改 Author Date 和 Committer Date，确保远程页面（如 Gitea）显示正确时间。 + +### 选项 + +| 选项 | 说明 | +| --- | --- | +| `<时间>` | 必填，格式 `yyyy-MM-dd HH:mm:ss` | +| `--remote <名称>` | 强推到哪个远程，默认取唯一远程 | +| `--branch <名称>` | 操作的分支，默认当前分支 | +| `--no-push` | 只改写本地，不推送 | +| `-y`, `--yes` | 确认执行（没有它只预览） | + +## 批量改写提交时间（git.retime） `kopsc git retime <开始日期> <结束日期> [选项]` 把该日期范围内（含两端）的提交， **保留各自的原日期**，只把时分秒重排到 **21:00–23:00** 之间，然后 `git push --force-with-lease`。 diff --git a/README.md b/README.md index 0783601..2183bf6 100644 --- a/README.md +++ b/README.md @@ -143,17 +143,17 @@ kopsc 的命令按用途分组，每组的完整说明（命令表、选项、 | 分组 | 用途 | 文档 | | --- | --- | --- | | **docker** | 容器与镜像：查看、启停、日志、清理、导出/导入、Compose | [README.docker.md](README.docker.md) | -| **net** | 网络与端口：端口被谁占用、监听端口、ping、DNS、路由追踪、HTTP 诊断、网卡信息、连接统计、网速测试 | [README.net.md](README.net.md) | -| **disk** | 磁盘与文件占用：哪个目录、哪个文件最占空间 | [README.disk.md](README.disk.md) | +| **net** | 网络与端口：端口被谁占用、监听端口、ping、DNS、路由追踪、HTTP 诊断、网卡信息、连接统计、网速测试、HTTP 文件服务器 | [README.net.md](README.net.md) | +| **disk** | 磁盘与文件占用：哪个目录、哪个文件最占空间、inode 使用、一键磁盘健康检查 | [README.disk.md](README.disk.md) | | **diagnose** | 容器 / Pod 状态根因诊断（自动识别 Docker 与 K8s） | [README.diagnose.md](README.diagnose.md) | | **proc** | 本机进程：列出进程、后台运行、等待退出、按资源排序、按名称终止、进程树 | [README.proc.md](README.proc.md) | | **java** | Java 应用：按 JDK 版本套用调优参数并运行 jar | [README.java.md](README.java.md) | -| **git** | Git 历史：按日期范围调整提交时间并强推 | [README.git.md](README.git.md) | -| **pkg** | 系统软件包：列出已安装包、刷新包管理器索引 | [README.pkg.md](README.pkg.md) | +| **git** | Git 历史：按日期范围调整提交时间、修改最后一次提交时间并强推 | [README.git.md](README.git.md) | +| **pkg** | 系统软件包：列出、搜索、安装、卸载、查看详情、刷新包管理器索引 | [README.pkg.md](README.pkg.md) | | **user** | 用户管理：列出用户、授予或移除 root/sudo 权限、查看用户信息 | [README.user.md](README.user.md) | | **file** | 文件查找：按大小、修改时间、名称查找文件、查找空文件/空目录 | [README.file.md](README.file.md) | | **svc** | 服务管理：列出服务、查看状态、启用/禁用、查看日志 | [README.svc.md](README.svc.md) | -| **archive** | 压缩文件：自动识别格式并解压 | [README.archive.md](README.archive.md) | +| **archive** | 压缩文件：创建、查看内容、解压 | [README.archive.md](README.archive.md) | | **sys** | 系统信息：OS、运行时间、CPU、内存、磁盘一览 | [README.sys.md](README.sys.md) | | **log** | 系统日志：列出日志来源、搜索关键字、查看最近日志 | [README.log.md](README.log.md) | | **fw** | 防火墙：查看状态、开放/关闭端口 | [README.fw.md](README.fw.md) | @@ -179,6 +179,8 @@ kopsc 的命令按用途分组，每组的完整说明（命令表、选项、 | 搬镜像 | `kopsc docker save alpine:3.20` / `kopsc docker load alpine_3.20.tar` | | 查端口 | `kopsc net pids 8080`、`kopsc net ports` | | 查磁盘占用 | `kopsc disk usage`、`kopsc disk usage /var --depth 2` | +| 查 inode 使用 | `kopsc disk inode` | +| 磁盘排障 | `kopsc disk check`、`kopsc disk check --all` | | 排障 | `kopsc diagnose web` | | 后台跑服务 | `kopsc proc nohup ./server` | | 等进程退出 | `kopsc proc wait nginx`、`kopsc proc wait --pid 1234 --timeout 30` | @@ -186,6 +188,11 @@ kopsc 的命令按用途分组，每组的完整说明（命令表、选项、 | 按名字杀进程 | `kopsc proc killname nginx --yes` | | 跑 Java 应用 | `kopsc java run app.jar`、`kopsc java run --jdk 17 --print-flags app.jar` | | 调整提交时间 | `kopsc git retime 2026-10-01 2026-10-15`（加 `--yes` 才执行） | +| 修改最后一次提交时间 | `kopsc git time 2026-11-05 22:30:00`（加 `--yes` 才执行） | +| 搜索软件包 | `kopsc pkg search nginx` | +| 安装软件包 | `kopsc pkg install nginx --yes` | +| 卸载软件包 | `kopsc pkg remove nginx --yes` | +| 查看软件包详情 | `kopsc pkg info nginx` | | 刷新软件源 | `kopsc pkg refreshindex` | | 授予用户 root 权限 | `kopsc user grant alice --yes` | | 移除用户 root 权限 | `kopsc user revoke alice --yes` | @@ -195,7 +202,10 @@ kopsc 的命令按用途分组，每组的完整说明（命令表、选项、 | 看服务状态 | `kopsc svc status nginx` | | 启用/禁用服务 | `kopsc svc enable nginx --yes` / `kopsc svc disable nginx --yes` | | 看服务日志 | `kopsc svc logs nginx -f` | +| 创建压缩文件 | `kopsc archive create ./mydir`、`kopsc archive create ./mydir --format zip` | +| 查看压缩内容 | `kopsc archive list backup.tar.gz` | | 解压文件 | `kopsc archive extract app.tar.gz` | +| 起 HTTP 服务器 | `kopsc net http`、`kopsc net http -p 9000 --upload` | | 看系统信息 | `kopsc sysinfo` | | 测试连通性 | `kopsc net ping example.com` | | 路由追踪 | `kopsc net trace example.com` | diff --git a/internal/executor/gittime.go b/internal/executor/gittime.go new file mode 100644 index 0000000..d06751c --- /dev/null +++ b/internal/executor/gittime.go @@ -0,0 +1,199 @@ +package executor + +import ( + "context" + "errors" + "fmt" + "strings" + "time" +) + +// gitTimeOptions are the parsed arguments of `kopsc git time`. +type gitTimeOptions struct { + Time time.Time + Remote string + Branch string + NoPush bool +} + +// runGitTime modifies the timestamp of the last commit to the specified time +// and force pushes the branch. +// +// Without --yes it only shows what would happen (exit code 2), so the destructive +// path always needs an explicit confirmation. +func runGitTime(ctx context.Context, req BuiltinRequest) error { + return runGitTimeWith(ctx, req, execGitRunner{}) +} + +// runGitTimeWith is runGitTime with its dependencies injected for tests. +func runGitTimeWith(ctx context.Context, req BuiltinRequest, runner gitRunner) error { + opts, confirmedInArgs, err := parseGitTimeArgs(req.Args) + if err != nil { + return err + } + confirmed := req.Confirmed || confirmedInArgs + + branch := opts.Branch + if branch == "" { + if branch, err = currentBranch(ctx, runner); err != nil { + return err + } + } + + remote := opts.Remote + if remote == "" && !opts.NoPush { + names, err := remotes(ctx, runner) + if err != nil { + return err + } + switch { + case len(names) == 1: + remote = names[0] + case len(names) == 0: + return errors.New("仓库没有配置远程；用 --no-push 只改写本地，或先 git remote add") + default: + return fmt.Errorf("仓库有多个远程（%s），请用 --remote 指定要强推哪个", + strings.Join(names, ", ")) + } + } + + // Get the last commit info + lastCommit, err := getLastCommit(ctx, runner) + if err != nil { + return err + } + + // Show preview + fmt.Fprintf(req.Stdout, "修改最后一次提交的时间\n\n") + fmt.Fprintf(req.Stdout, "提交: %s %s\n", lastCommit.Short, lastCommit.Subject) + fmt.Fprintf(req.Stdout, "当前时间: %s\n", lastCommit.AuthorTime.Format("2006-01-02 15:04:05")) + fmt.Fprintf(req.Stdout, "修改为: %s\n", opts.Time.Format("2006-01-02 15:04:05")) + fmt.Fprintf(req.Stdout, "\n") + + if !opts.NoPush { + fmt.Fprintf(req.Stdout, "将强推到 %s/%s\n", remote, branch) + } + + if !confirmed { + fmt.Fprintf(req.Stdout, "\n这是破坏性操作，会改变提交历史。加 --yes 确认执行。\n") + return &ExitError{Code: 2, Err: errors.New("需要确认")} + } + + // Execute the time change + // Must set both GIT_COMMITTER_DATE and --date to change both timestamps + timeStr := opts.Time.Format("2006-01-02 15:04:05") + env := []string{"GIT_COMMITTER_DATE=" + timeStr} + + if _, stderr, err := runner.RunEnv(ctx, env, "commit", "--amend", "--date="+timeStr, "--no-edit"); err != nil { + return fmt.Errorf("修改提交时间失败: %w\n%s", err, stderr) + } + + fmt.Fprintf(req.Stdout, "✓ 已修改最后一次提交的时间\n") + + // Force push if not --no-push + if !opts.NoPush { + fmt.Fprintf(req.Stdout, "强推到 %s/%s...\n", remote, branch) + + if _, stderr, err := runner.Run(ctx, "push", "--force", remote, branch); err != nil { + return fmt.Errorf("强推失败: %w\n%s", err, stderr) + } + + fmt.Fprintf(req.Stdout, "✓ 已强推\n") + } + + return nil +} + +// parseGitTimeArgs parses the arguments for `kopsc git time`. +func parseGitTimeArgs(args []string) (gitTimeOptions, bool, error) { + var opts gitTimeOptions + var confirmed bool + var timeStr string + + for i := 0; i < len(args); i++ { + arg := args[i] + switch { + case arg == "--yes" || arg == "-y": + confirmed = true + case arg == "--no-push": + opts.NoPush = true + case arg == "--remote": + if i+1 >= len(args) { + return opts, false, fmt.Errorf("--remote 缺少远程名称") + } + i++ + opts.Remote = args[i] + case strings.HasPrefix(arg, "--remote="): + opts.Remote = strings.TrimPrefix(arg, "--remote=") + case arg == "--branch": + if i+1 >= len(args) { + return opts, false, fmt.Errorf("--branch 缺少分支名称") + } + i++ + opts.Branch = args[i] + case strings.HasPrefix(arg, "--branch="): + opts.Branch = strings.TrimPrefix(arg, "--branch=") + case strings.HasPrefix(arg, "-"): + return opts, false, fmt.Errorf("未知选项 %q", arg) + default: + if timeStr == "" { + timeStr = arg + } else { + return opts, false, fmt.Errorf("多余的参数 %q", arg) + } + } + } + + if timeStr == "" { + return opts, false, fmt.Errorf("缺少时间参数；用法: kopsc git time <时间>") + } + + // Parse and validate time format: yyyy-MM-dd HH:mm:ss + t, err := time.ParseInLocation("2006-01-02 15:04:05", timeStr, time.Local) + if err != nil { + return opts, false, fmt.Errorf("时间格式错误: %q，必须是 yyyy-MM-dd HH:mm:ss（如 2026-11-05 22:30:00）", timeStr) + } + opts.Time = t + + return opts, confirmed, nil +} + +// gitCommitInfo holds basic info about a commit. +type gitCommitInfo struct { + Hash string + Short string + Subject string + AuthorTime time.Time +} + +// getLastCommit returns info about the last commit. +func getLastCommit(ctx context.Context, runner gitRunner) (gitCommitInfo, error) { + // Get commit hash and subject + out, stderr, err := runner.Run(ctx, "log", "-1", "--format=%H|%h|%s") + if err != nil { + return gitCommitInfo{}, fmt.Errorf("获取提交信息失败: %w\n%s", err, stderr) + } + + parts := strings.SplitN(strings.TrimSpace(out), "|", 3) + if len(parts) != 3 { + return gitCommitInfo{}, fmt.Errorf("解析提交信息失败: %s", out) + } + + // Get author time + timeOut, stderr, err := runner.Run(ctx, "log", "-1", "--format=%ai") + if err != nil { + return gitCommitInfo{}, fmt.Errorf("获取提交时间失败: %w\n%s", err, stderr) + } + + authorTime, err := time.Parse("2006-01-02 15:04:05 -0700", strings.TrimSpace(timeOut)) + if err != nil { + return gitCommitInfo{}, fmt.Errorf("解析提交时间失败: %w", err) + } + + return gitCommitInfo{ + Hash: parts[0], + Short: parts[1], + Subject: parts[2], + AuthorTime: authorTime, + }, nil +}