---
name: git-rebuild-process
description: 重新建库流程（2026-08-21 EIGHTfs 确立，权威；权威源 = dsh-git-push 插件项目 skills/）——在数据文件夹新建 git 仓库 → 按原始项目每次提交重新分析合理提交点 → 建立长期任务分步骤按顺序还原到提交点复制进新 git → 走 gitpush 提交流程（不推送）→ 全部转移完成推送 → 仓库移到根目录（.dsh 同级）「项目」文件夹。处理「重新建库」「重建仓库」「按提交点还原重建」「迁移仓库到项目文件夹」类任务时加载。
whenToUse: 用户说「重新建库/重建仓库」、原仓库需按提交历史重梳理还原、项目仓库要迁移到「项目」文件夹、需要分步骤按提交点重建 git 时。
generatedBy: EIGHTfs 2026-08-21（规则整理；权威归属 = dsh-git-push 插件权威 skill）
---

# 重新建库流程（git-rebuild-process）

> 2026-08-21 用户（EIGHTfs）确立。开发者文档留档：`ai-work-archive/开发者文档/重新建库流程-20260821.md`。
> 配套：dsh-git-push（提交纪律）、commit-checkpoint-before-push-reorg（推送前整理）、multi-task-todo-queue（长期任务）、task-data-dirs-rule（目录纪律）、versioning-rule（版本号）。

## 一、流程（7 步，按序执行）

1. **建库**：在数据文件夹新建 git 仓库（`/vol1/@appshare/DeepSeekHarness/数据/`，可建子目录如 `数据/重建仓库`）
2. **分析提交点**：按原始项目**每次提交**重新分析合理提交点（原始提交可能杂乱，重梳理出有意义的 commit 点）——**提交点判定细则见第五节**
3. **长期任务**：建立任务清单，分步骤按顺序还原到提交点
4. **还原+复制**：每步还原一个提交点的文件状态 → 复制进新建 git
5. **提交**：新建 git 走 dsh-git-push 提交流程——**只 commit 不推送**
6. **推送**：全部转移完成后才推送新位置的仓库
7. **归位**：仓库移到根目录（.dsh 同级）「项目」文件夹（`/vol1/@appshare/DeepSeekHarness/项目/`）

## 二、目录约定

| 名称 | 路径 | 角色 |
|------|------|------|
| 数据文件夹 | `/vol1/@appshare/DeepSeekHarness/数据/` | 重建暂存 git 位置 |
| 根目录（.dsh 同级） | `/vol1/@appshare/DeepSeekHarness/` | 归位上级 |
| 项目文件夹 | `/vol1/@appshare/DeepSeekHarness/项目/` | 重建后仓库最终位置（2026-08-21 新建，0700） |

## 三、纪律

- git 纪律：**未同意不推送**；提交可自主作检查点（bugfix-auto-authority）
- 推送前可撤销整理 README/提交记录再正式提交推送（commit-checkpoint-before-push-reorg）
- 长期任务分步骤不跳序（multi-task-todo-queue）
- 还原 = 复制不动原始项目，全程可回退

## 四、合理提交点判定（2026-08-21 用户补充，权威）

> **核心**：提交点 = **推送过的主版本**（feat/功能里程碑）；**推送过后修复过 bug 的提交不能算合理提交点**，应并入其所属主版本。

### 判定细则

1. **主版本 = 合理提交点**：源仓库中带版本号的 **feat/功能** 提交（如带版本号的 feat/功能提交）= 提交点骨架
2. **修复不单独成点**：推送（发布）后针对该版本修 bug 的提交（fix/补丁版本）**不能算合理提交点**——并入其主版本提交点，不单独拆开
3. **并入方式**：提交点取「主版本线的最终状态」文件树（含修复内容）；package.json 版本修正为**主版本号**；commit message 注明并入的修复（如 `主版本号（含修复说明）`）
4. **docs/清理/跨项目杂项提交**：按时间就近并入相邻主版本提交点（内容随文件树自然包含），不单独成点
5. **版本号规范**：提交点版本号遵循 versioning-rule（1 开头、X.Y.Z、版本只在提交时变化）；源仓库漏 bump 的按规范修正（如 1.13.1 修复并入 1.13.0 时版本号归 1.13.0）
6. **初始提交**：无代码文档版 = 1.0.0（原理/架构/规划文档，最新规范定义）

### 反例（2026-08-21 dsh-git-rescue 1.x 重建实测）

- ❌ 把修复版本拆成独立提交点
- ✅ 修复并入主版本后 13 个提交点：1.0.0 + 1.2.0（含 1.2.1/1.2.2 修复）→1.3.0→1.4.0（含 1.4.1）→1.5.0（含 1.5.1）→1.6.0→1.7.0（含 1.7.1/1.7.2）→1.8.0→1.9.0→1.10.0→1.11.0→1.12.0→1.13.0（含 1.13.1）

## 相关

