# 人工介入点与确认文案（用户动作明确版）

默认策略是全托管执行，但以下节点必须提供人工介入机会。

统一格式（每个介入点必须包含）：

```text
[当前进展]：<系统现在做到哪里>
[你要做的]：<用户此刻需要选择/输入什么>
[系统下一步]：<用户确认后系统会执行什么>
```

## 介入点 1：工作目录创建

触发条件：目标目录不存在。

确认文案模板：

```text
[当前进展]：已完成环境检测，准备进入工作目录
[你要做的]：确认是否创建目录 <workspacePath>
[系统下一步]：确认后执行 mkdir 并继续 Hugo 初始化检测
```

用户选择：

- 是：执行 `mkdir -p "<workspacePath>"` 并继续。
- 否：暂停流程，等待用户提供新目录。

---

## 介入点 2：初始化模板选择

触发条件：目标目录不是已初始化 Hugo 站点（缺少 Hugo 配置文件）。

确认文案模板：

```text
[当前进展]：目录可用，但尚未初始化 Hugo 站点
[你要做的]：请选择模板
1) ananke（官方示例）
2) PaperMod（技术博客）
3) Stack（内容型博客）
4) Docsy（文档站）
5) blowfish（现代风格）
6) 自定义模板 Git 地址
[系统下一步]：按你的选择初始化站点并写入模板状态
```

用户选择：

- 选择内置模板：按内置模板仓库地址执行初始化。
- 选择自定义模板：使用用户提供 Git URL 初始化。
- 取消：暂停流程，保留当前目录状态。

---

## 介入点 3：Git 仓库初始化

触发条件：`workspacePath` 非 Git 仓库。

确认文案模板：

```text
[当前进展]：Hugo 站点已初始化，正在检查 Git 状态
[你要做的]：确认是否对 <workspacePath> 执行 git init
[系统下一步]：确认后初始化仓库并进入预览验收
```

用户选择：

- 是：执行 `git init`，继续首次提交引导。
- 否：仅记录状态，不执行提交相关步骤。

---

## 介入点 4：提交信息确认

触发条件：检测到可提交变更。

确认文案模板：

```text
检测到待提交变更，建议提交信息：
<suggestedCommitMessage>
[当前进展]：改动已就绪，准备提交
[你要做的]：确认使用该提交信息，或输入新提交信息
[系统下一步]：按你确认的信息执行提交并继续发布流程
```

用户选择：

- 直接确认：按建议提交。
- 提供新信息：使用用户输入提交。
- 取消：跳过提交，仅保存状态。

---

## 介入点 5：启用 GitHub Actions 自动部署

触发条件：用户要求公网可访问，且仓库尚未配置 Hugo Pages workflow。

确认文案模板：

```text
[当前进展]：本地流程已通过，准备启用公网发布
[你要做的]：确认是否创建 `.github/workflows/hugo-pages.yml`
[系统下一步]：创建 workflow、提示你开启 Pages，然后推送验证部署
```

用户选择：

- 是：写入 workflow，提交并推送。
- 否：仅给出手动配置步骤，不自动写入。

---

## 介入点 6：未发布文章提醒确认

触发条件：检测到 `content/` 下存在未提交变更。

确认文案模板：

```text
[当前进展]：检测到 <unpublishedArticleCount> 项未发布文章变更
[你要做的]：确认是否先预览再发布
[系统下一步]：按你的选择执行预览或直接提交发布
```

用户选择：

- 是：先进入预览，再确认提交发布。
- 否：允许直接发布，但再次提醒风险。

---

## 人工接管后回归托管

当用户手动完成某步（例如手动 `git init` 或手动提交）后，下一次流程应：

1. 重新检测当前状态
2. 从“下一未完成步骤”继续
3. 刷新状态文件，避免重复动作

## 最终反馈模板

```text
[当前进展]：发布流程已完成
[你要做的]：如需继续发布，请确认是否再次进入“未发布检测”
[系统下一步]：读取当前工作目录状态并继续阶段 C
```