helloloop 0.6.1 → 0.7.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "HelloLoop 的 Claude Code 原生插件元数据，用于多 CLI 宿主分发。",
   "author": {
     "name": "HelloLoop"

package/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件，Codex 路径为首发与参考实现。",
   "author": {
     "name": "HelloLoop"
@@ -16,8 +16,8 @@
   "skills": "./skills/",
   "interface": {
     "displayName": "HelloLoop",
-    "shortDescription": "基于 backlog 的持续仓库开发与验证循环",
-    "longDescription": "HelloLoop 把基于 backlog 的持续开发能力封装为官方 Codex 插件 bundle。显式调用 helloloop skill 时，默认优先进入 npx helloloop 主 CLI 流程：支持 npx helloloop、npx helloloop <PATH>、npx helloloop codex|claude|gemini ...，先分析、再展示确认单、确认后自动接续推进；运行中按无人值守自动恢复持续推进主线。",
+    "shortDescription": "显式调用后按 backlog 持续开发与验证",
+    "longDescription": "HelloLoop 把基于 backlog 的持续开发能力封装为官方 Codex 插件 bundle。只有在用户显式调用 helloloop skill，或明确要求使用 HelloLoop 时才应介入；进入后默认优先走 npx helloloop 主 CLI 流程：支持 npx helloloop、npx helloloop <PATH>、npx helloloop codex|claude|gemini ...，先分析、再展示确认单、确认后自动接续推进；运行中按无人值守自动恢复持续推进主线。",
     "developerName": "HelloLoop",
     "category": "Coding",
     "capabilities": [
@@ -25,7 +25,7 @@
       "Write"
     ],
     "defaultPrompt": [
-      "使用 HelloLoop 时，优先执行 npx helloloop 或 npx helloloop <PATH>；如果用户明确指定执行引擎，也允许使用 npx helloloop codex|claude|gemini ...。启动前确认一次，启动后按无人值守自动恢复与主线续跑执行，不要在对话里手工模拟流程。"
+      "只有当用户显式调用 $helloloop / #helloloop / helloloop:helloloop，或明确要求使用 HelloLoop 时，才进入 npx helloloop 主 CLI 流程；普通 Codex 会话不要自动接管。进入后优先执行 npx helloloop 或 npx helloloop <PATH>；如果用户明确指定执行引擎，也允许使用 npx helloloop codex|claude|gemini ...。启动前确认一次，启动后按无人值守自动恢复与主线续跑执行，不要在对话里手工模拟流程。"
     ],
     "brandColor": "#0F766E"
   }

package/README.md

@@ -18,6 +18,7 @@
 
 这意味着：
 
+- 三宿主都只在用户显式调用 `helloloop` 时介入；普通会话不会被 HelloLoop 自动接管
 - 无论在终端还是在 `Codex` / `Claude` / `Gemini` 宿主内，只要用户未明确指定引擎，`HelloLoop` 都会先询问本轮执行引擎
 - 当前宿主、项目历史、用户历史只作为推荐依据，不会自动替你选中引擎
 - 如果你已经显式指定，或已经在首轮确认中明确选定了引擎，本轮就固定按该引擎执行
@@ -27,9 +28,9 @@
 
 | 宿主 | 安装方式 | 原生入口 | 说明 |
 | --- | --- | --- | --- |
-| `Codex CLI` | `helloloop install` / `helloloop install --host codex` | `$helloloop` / `npx helloloop` | Codex 原生插件 + CLI |
-| `Claude Code` | `helloloop install --host claude` | `/helloloop` | Claude 原生 marketplace / plugin |
-| `Gemini CLI` | `helloloop install --host gemini` | `/helloloop` | Gemini 原生 extension |
+| `Codex CLI` | `helloloop install` / `helloloop install --host codex` | `$helloloop` / `npx helloloop` | 仅在显式调用时进入 HelloLoop |
+| `Claude Code` | `helloloop install --host claude` | `/helloloop` | 仅在显式调用时进入 HelloLoop |
+| `Gemini CLI` | `helloloop install --host gemini` | `/helloloop` | 仅在显式调用时进入 HelloLoop |
 
 ## 最短使用方式
 
@@ -62,7 +63,7 @@ npx helloloop gemini <PATH> 接续完成剩余开发
 - 首参只有第一个裸词会被解释为引擎；如果你真要把 `claude` 当目录名，请写成 `./claude`、`.\claude` 或绝对路径
 - 命令后的自然语言如果明确提到 `codex`、`claude`、`gemini`，也会纳入意图判断
 - 当前宿主、项目历史、用户历史不会触发自动选中，只会影响“推荐项”
-- `已安装` 不等于 `可继续执行`；如果当前引擎在运行中遇到 429、5xx、网络抖动、流中断、长时间卡死等问题，`HelloLoop` 会先按无人值守策略做同引擎自动恢复，不会中途停下来询问
+- `已安装` 不等于 `可继续执行`；如果当前引擎在运行中遇到 400、鉴权、欠费、429、5xx、网络抖动、流中断、长时间卡死等问题，`HelloLoop` 会先按无人值守策略做同引擎“健康探测 + 条件恢复”，不会中途停下来询问
 
 ## 默认工作流
 
@@ -89,25 +90,59 @@ npx helloloop gemini <PATH> 接续完成剩余开发
 
 `HelloLoop` 的设计目标不是“跑一轮停一轮”，而是启动前确认一次，启动后持续无人值守推进。
 
-因此运行中的默认策略是：
+- 因此运行中的默认策略是：
 
 - 普通运行故障不再中途提问：不会因为 429、5xx、网络抖动、结果流中断、短时空输出就停下来问用户
 - 同引擎优先恢复：默认不会自动切换引擎，也不会偷偷改用别的 CLI
+- 先探测、后续跑：重试前会先做最小健康探测；只有探测通过后，才会恢复主线任务，而不是盲目把完整任务再跑一遍
 - 保留主线上下文恢复：同引擎恢复时会生成恢复记录与恢复 prompt，要求新一轮执行直接基于当前仓库状态继续，而不是从头另起一套
 - 定时心跳检查：运行中会持续写入心跳与恢复状态，用于判断当前阶段是否还在正常推进
-- 先预警再终止：默认每 60 秒刷新一次心跳；若长时间没有可见进展，先标记为疑似卡住；达到更长的自动恢复阈值后，才会终止当前进程并做同引擎恢复
-- 硬错误直接停止：如果识别为 400 请求错误、登录/鉴权/订阅问题、本地 CLI 缺失或权限错误，不会盲目重试
+- 最终停止会告警：如果自动恢复额度真正用尽，且已配置全局邮箱，`HelloLoop` 会把错误类型与具体内容发到指定邮箱
 
 默认恢复节奏：
 
 - 心跳间隔：60 秒
 - 疑似卡住预警：15 分钟无可见进展
-- 自动恢复阈值：45 分钟无可见进展
-- 同阶段最多自动恢复：4 次
-- 恢复等待：2 分钟 → 5 分钟 → 15 分钟 → 30 分钟
+- 自动终止阈值：45 分钟无可见进展
+- 硬阻塞：每 15 分钟探测 1 次，共 5 次；仍失败则暂停等待人工介入
+- 软阻塞：先每 15 分钟探测 5 次，再 30 分钟 2 次，再按 60 / 90 / 120 / 150 / 180 分钟各探测 1 次；仍失败则暂停等待人工介入
 
 如果你明确指定或确认了本轮引擎，`HelloLoop` 在自动恢复阶段也会继续锁定该引擎，不会擅自切换。
 
+## 全局告警配置
+
+如果希望在“自动恢复彻底停止”后收到邮件告警，可在：
+
+```text
+~/.helloloop/settings.json
+```
+
+中配置邮件通知，例如：
+
+```json
+{
+  "notifications": {
+    "email": {
+      "enabled": true,
+      "to": ["you@example.com"],
+      "from": "helloloop@example.com",
+      "smtp": {
+        "host": "smtp.example.com",
+        "port": 465,
+        "secure": true,
+        "username": "helloloop@example.com",
+        "passwordEnv": "HELLOLOOP_SMTP_PASSWORD"
+      }
+    }
+  }
+}
+```
+
+说明：
+
+- 建议把 SMTP 密码放在环境变量里，不要明文写进配置文件
+- 邮件只在“本轮不再继续自动重试”时发送，不会每次失败都刷屏
+
 ## 自动发现与交互逻辑
 
 ### 1. 只输入 `npx helloloop`
@@ -253,7 +288,7 @@ npx helloloop install --host all --force
 
 说明：
 
-- `--force` 会清理当前宿主里旧分支 / 旧版本残留的 `helloloop` 安装目录后再重装
+- `--force` 会清理当前宿主里已有安装残留的 `helloloop` 目录后再重装
 - `Codex` 会刷新插件目录和 marketplace 条目
 - `Claude` 会刷新 marketplace、缓存插件目录，以及 `settings.json` / `known_marketplaces.json` / `installed_plugins.json` 中的 `helloloop` 条目
 - `Gemini` 会刷新 `extensions/helloloop/`，不会动同目录下其他扩展
@@ -301,6 +336,7 @@ npx helloloop
 ```
 
 如果你在 `Codex` 中直接使用 `$helloloop` 或 `npx helloloop`，但没有明确指定引擎，`HelloLoop` 仍会先让你确认本轮引擎；`Codex` 只会作为推荐项，不会被自动选中。
+未显式调用 `$helloloop`、`helloloop:helloloop` 或 `npx helloloop` 时，普通 `Codex` 会话不会被 HelloLoop 自动接管。
 
 ### Claude Code / Gemini CLI
 
@@ -309,6 +345,7 @@ npx helloloop
 ```
 
 它们会按各自 CLI 的原生 agent 逻辑执行，但共享同一套 `.helloloop/` 工作流规范。
+只有在你显式调用 `/helloloop` 时，它们才会进入 HelloLoop 工作流；普通 Claude / Gemini 会话不会被自动接管。
 
 ## 常用命令
 

package/hosts/claude/marketplace/plugins/helloloop/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "HelloLoop 的 Claude Code 原生插件。",
   "author": {
     "name": "HelloLoop"

package/hosts/claude/marketplace/plugins/helloloop/commands/helloloop.md

@@ -1,5 +1,5 @@
 ---
-description: 根据开发文档分析当前进度、生成确认单，并在确认后继续接续开发
+description: 仅在用户显式调用 `/helloloop` 后，根据开发文档分析当前进度、生成确认单，并在确认后继续接续开发
 argument-hint: [PATH]
 ---
 
@@ -7,8 +7,9 @@ argument-hint: [PATH]
 
 规则如下：
 
-1. 将当前代码视为事实源，将开发文档视为目标源。
-2. 如果用户在命令后提供了 `$ARGUMENTS`，必须同时保留其中的显式路径和自然语言补充要求，不要依赖固定关键词硬编码决策。
+1. 只有当用户显式调用 `/helloloop`，或明确要求“使用 HelloLoop / 走 HelloLoop 流程”时，才进入当前工作流；不要接管普通 Claude 会话。
+2. 将当前代码视为事实源，将开发文档视为目标源。
+3. 如果用户在命令后提供了 `$ARGUMENTS`，必须同时保留其中的显式路径和自然语言补充要求，不要依赖固定关键词硬编码决策。
 3. 自动识别目标仓库与开发文档，并先分析“当前代码做到哪里了”“与文档目标是否存在偏差”“当前项目与文档目标是否匹配”。
 4. 当前宿主是 `Claude`；如果用户未明确指定执行引擎，必须先确认本轮引擎，`Claude` 只可作为推荐项，不允许自动选中；如果用户明确要求改用 `Codex` 或 `Gemini`，必须先确认，不允许静默切换。
 5. 如果当前目录没有明确开发文档，先展示顶层文档文件、顶层目录和疑似项目目录，再询问用户开发文档路径。
@@ -32,7 +33,7 @@ argument-hint: [PATH]
    - 自动执行停止条件
 11. 未经用户确认，不要开始正式修改代码。
 12. 用户确认后，使用当前确认的执行引擎原生工具持续推进 backlog；每个任务完成后还要再做任务完成复核，backlog 清空后还要再做主线终态复核，直到开发文档的最终目标完成，且相关测试、验证、验收都已通过；遇到硬阻塞或需要用户补充关键信息时再停下。
-13. 如果当前引擎在运行中遇到 429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎自动恢复，不要中途停下来询问用户；只有明确硬阻塞时才停止。
+13. 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎；只有自动恢复额度真正用尽时才停止。
 14. 用户需求明确且当前任务可直接完成时，必须一次性完成本轮应交付的全部工作；禁止做一半后用“如果你要”“是否继续”之类的话术停下，也禁止用“希望这对你有帮助”等套话收尾。
 15. 始终优先使用安全 shell 与原生文件工具；在 Windows 上避免危险的嵌套命令、路径拼接删除和 `cmd` 风格破坏性命令。
 16. 不要调用外部 `npx helloloop` 来替代这个原生工作流；你现在就在 HelloLoop 的 Claude Code 原生模式中。

package/hosts/claude/marketplace/plugins/helloloop/skills/helloloop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: helloloop
-description: 当用户希望 Claude Code 按开发文档先分析当前进度，再展示确认单，并在确认后持续接续开发时使用。
+description: 仅当用户显式调用 `/helloloop`，或明确要求使用 HelloLoop 时，Claude Code 才按开发文档先分析当前进度，再展示确认单，并在确认后持续接续开发。
 ---
 
 # HelloLoop for Claude Code
@@ -9,6 +9,7 @@ description: 当用户希望 Claude Code 按开发文档先分析当前进度，
 
 ## 默认流程
 
+0. 仅在用户显式调用 `/helloloop`，或明确要求使用 HelloLoop 时才介入；不要接管普通 Claude 会话
 1. 自动识别目标仓库与开发文档
 2. 如果用户未明确指定执行引擎，先确认本轮引擎；`Claude` 只作为推荐项，不自动选中；如果用户明确要求改用 `Codex` / `Gemini`，先确认再切换
 3. 分析当前代码与文档目标之间的真实进度和偏差
@@ -18,11 +19,12 @@ description: 当用户希望 Claude Code 按开发文档先分析当前进度，
 
 ## 关键规则
 
+- 未显式调用 `helloloop` 且用户也没有明确要求使用 HelloLoop 时，不允许接管普通 Claude 会话。
 - 如果缺少目标仓库或开发文档，必须停下来询问用户。
 - 如果当前目录没有明确开发文档，应先展示顶层文档文件、顶层目录和疑似项目目录，再询问文档路径。
 - 项目路径对外只有一个概念；如果用户提供的项目路径不存在，直接按新项目路径处理，不要再追问“新项目路径”。
 - 如果当前项目与开发文档目标明显冲突，必须先确认是继续现有项目、清理后重建，还是取消。
-- 如果当前引擎在运行中遇到 429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎自动恢复，不要中途停下来询问用户。
+- 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎。
 - 只有识别为 400 请求错误、登录/鉴权/订阅问题、本地 CLI 缺失或权限错误等硬阻塞时，才允许结束本轮自动执行。
 - 不允许跳过执行确认单直接开始正式开发。
 - 不允许把开发文档整体压成一个大任务；需要输出足够细的 backlog。

package/hosts/gemini/extension/GEMINI.md

@@ -8,6 +8,7 @@
 
 ## 默认流程
 
+0. 仅在用户显式调用 `/helloloop`，或明确要求使用 HelloLoop 时才介入；不要接管普通 Gemini 会话
 1. 自动识别项目仓库与开发文档
 2. 如果用户未明确指定执行引擎，先确认本轮引擎；`Gemini` 只作为推荐项，不自动选中；如果用户明确要求改用 `Codex` / `Claude`，先确认再切换
 3. 如果当前目录没有明确开发文档，先展示顶层文档文件、顶层目录和疑似项目目录，再询问文档路径
@@ -20,12 +21,13 @@
 
 ## 强制规则
 
+- 未显式调用 `helloloop` 且用户也没有明确要求使用 HelloLoop 时，不允许接管普通 Gemini 会话。
 - 代码是事实源，开发文档是目标源。
 - 开发前必须先输出执行确认单。
 - 如果无法识别目标仓库或开发文档，必须停下来询问用户。
 - 不要单独追问“新项目路径”；项目路径只需要用户给一次。
 - 如果识别到偏差修正任务，优先收口偏差，再推进后续 backlog。
-- 如果当前引擎在运行中遇到 429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎自动恢复，不要中途停下来询问用户。
+- 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎。
 - 只有识别为 400 请求错误、登录/鉴权/订阅问题、本地 CLI 缺失或权限错误等硬阻塞时，才允许结束本轮自动执行。
 - 不允许因为执行引擎一句“已完成”就直接结束；必须经过任务复核和主线终态复核。
 - 用户需求明确且当前任务可直接完成时，必须一次性完成本轮应交付的全部工作；禁止做一半后用“如果你要”“是否继续”之类的话术停下，也禁止用客套套话收尾。

package/hosts/gemini/extension/commands/helloloop.toml

@@ -1,11 +1,12 @@
-description = "根据开发文档分析当前进度、生成确认单，并在确认后继续接续开发"
+description = "仅在用户显式调用 `/helloloop` 后，根据开发文档分析当前进度、生成确认单，并在确认后继续接续开发"
 prompt = """
 你现在正在执行 HelloLoop 的 Gemini CLI 原生工作流。
 
 执行要求：
 
-1. 自动识别目标仓库与开发文档；如果用户在命令后提供了参数，必须同时保留其中的显式路径和自然语言补充要求，不要靠固定关键词硬编码判断。
-2. 当前宿主是 `Gemini`；如果用户未明确指定执行引擎，必须先确认本轮引擎，`Gemini` 只可作为推荐项，不允许自动选中；如果用户明确要求改用 `Codex` 或 `Claude`，必须先确认，不允许静默切换。
+1. 只有当用户显式调用 `/helloloop`，或明确要求“使用 HelloLoop / 走 HelloLoop 流程”时，才进入当前工作流；不要接管普通 Gemini 会话。
+2. 自动识别目标仓库与开发文档；如果用户在命令后提供了参数，必须同时保留其中的显式路径和自然语言补充要求，不要靠固定关键词硬编码判断。
+3. 当前宿主是 `Gemini`；如果用户未明确指定执行引擎，必须先确认本轮引擎，`Gemini` 只可作为推荐项，不允许自动选中；如果用户明确要求改用 `Codex` 或 `Claude`，必须先确认，不允许静默切换。
 3. 如果当前目录没有明确开发文档，应先展示顶层文档文件、顶层目录和疑似项目目录，再询问用户开发文档路径。
 4. 项目路径对外只有一个概念；如果用户给出的项目路径不存在，直接按新项目路径处理，不要再单独追问“新项目路径”。
 5. 分析当前代码与开发文档之间的真实进度和偏差，并判断当前项目目录与开发文档目标是否匹配。
@@ -28,7 +29,7 @@ prompt = """
 8. 如果当前项目目录已存在，但分析认为它与开发文档目标明显冲突，必须先明确提示用户，并确认是继续现有项目、还是清理后按文档重建。
 9. 用户未确认前，不要开始正式修改代码。
 10. 用户确认后，继续用当前确认的执行引擎原生工具推进 backlog；每个任务完成后还要再做任务完成复核，backlog 清空后还要再做主线终态复核，直到开发文档的最终目标完成，且相关测试、验证、验收都已通过；遇到硬阻塞或需要用户补充关键信息时再停下。
-11. 如果当前引擎在运行中遇到 429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎自动恢复，不要中途停下来询问用户；只有明确硬阻塞时才停止。
+11. 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎；只有自动恢复额度真正用尽时才停止。
 12. 如果用户给了开发文档但找不到项目仓库，或给了项目路径但找不到开发文档，必须停下来询问。
 13. 用户需求明确且当前任务可直接完成时，必须一次性完成本轮应交付的全部工作；禁止做一半后用“如果你要”“是否继续”之类的话术停下，也禁止用“希望这对你有帮助”等套话收尾。
 14. Windows 上优先用安全的文件与 shell 操作；禁止危险删除、硬重置、强推和其他破坏性命令。

package/hosts/gemini/extension/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "HelloLoop 的 Gemini CLI 原生扩展，用于按开发文档接续推进项目开发。",
   "contextFileName": "GEMINI.md",
   "excludeTools": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "helloloop",
-  "version": "0.6.1",
+  "version": "0.7.0",
   "description": "面向 Codex CLI、Claude Code、Gemini CLI 的多宿主开发工作流插件",
   "author": "HelloLoop",
   "license": "Apache-2.0",

package/skills/helloloop/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: helloloop
-description: 当用户希望 Codex 先分析仓库当前进度、生成确认单，再自动按 backlog 持续接续开发时使用。
+description: 仅当用户显式调用 `$helloloop` / `#helloloop` / `helloloop:helloloop`，或明确要求使用 HelloLoop 按开发文档持续接续开发时使用。
 ---
 
 # HelloLoop
@@ -9,6 +9,7 @@ description: 当用户希望 Codex 先分析仓库当前进度、生成确认单
 
 ## 强制入口规则
 
+- 未显式调用 `helloloop`，且用户也没有明确要求“使用 HelloLoop / 使用 helloloop 插件 / 走 HelloLoop 流程”时，不允许接管普通 Codex 会话。
 - 用户显式调用 `$helloloop` / `#helloloop` / `helloloop:helloloop` 时，默认必须优先执行 `npx helloloop` 或 `npx helloloop <PATH>`；如果用户又明确指定了执行引擎，也允许使用 `npx helloloop codex|claude|gemini ...`。
 - 用户没有明确指定执行引擎时，不允许由 skill 自行补成 `codex` / `claude` / `gemini`；必须让 `HelloLoop` 先完成引擎确认。
 - 不允许在对话里手工模拟 `HelloLoop` 的分析、确认单、backlog 编排和自动续跑流程来代替 CLI。
@@ -74,8 +75,8 @@ description: 当用户希望 Codex 先分析仓库当前进度、生成确认单
 - 每个任务在执行引擎声称“完成”后，还必须再过一层任务完成复核；如果只是部分完成，继续当前主线任务，不直接结束。
 - 用户需求明确且当前任务可直接完成时，必须一次性完成本轮应交付的全部工作；禁止做一半后用“如果你要”“是否继续”之类的话术停下，也禁止用客套套话收尾。
 - 真正的代码分析与实现由本轮选中的 `codex` / `claude` / `gemini` CLI 原生完成。
-- 如果当前引擎在运行中遇到 429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎自动恢复，不要中途停下来询问用户。
-- 只有识别为 400 请求错误、登录/鉴权/订阅问题、本地 CLI 缺失或权限错误等硬阻塞时，才允许结束本轮自动执行。
+- 如果当前引擎在运行中遇到 400、鉴权、余额、429、5xx、网络抖动、流中断或长时间卡死，必须优先按无人值守策略做同引擎“健康探测 + 条件恢复”，不要中途停下来询问用户，也不要自动切换引擎。
+- 只有当硬阻塞或软阻塞的自动恢复额度真正用尽时，才允许结束本轮自动执行；若用户已在 `~/.helloloop/settings.json` 配置邮箱通知，则结束前发送告警邮件。
 - `$helloloop` 的职责是把用户请求路由到主 CLI 流程，而不是在对话里手工复刻一套平行流程。
 
 ## 核心命令

package/src/config.mjs

@@ -20,15 +20,13 @@ const defaultPolicy = {
   stopOnHighRisk: true,
   runtimeRecovery: {
     enabled: true,
-    allowEngineSwitch: false,
     heartbeatIntervalSeconds: 60,
     stallWarningSeconds: 900,
     maxIdleSeconds: 2700,
     killGraceSeconds: 10,
-    maxPhaseRecoveries: 4,
-    retryDelaysSeconds: [120, 300, 900, 1800],
-    retryOnUnknownFailure: true,
-    maxUnknownRecoveries: 1,
+    healthProbeTimeoutSeconds: 120,
+    hardRetryDelaysSeconds: [900, 900, 900, 900, 900],
+    softRetryDelaysSeconds: [900, 900, 900, 900, 900, 1800, 1800, 3600, 5400, 7200, 9000, 10800],
   },
   codex: {
     model: "",
@@ -84,9 +82,12 @@ export function loadPolicy(context) {
   policy.runtimeRecovery = {
     ...defaultPolicy.runtimeRecovery,
     ...(policy.runtimeRecovery || {}),
-    retryDelaysSeconds: Array.isArray(policy?.runtimeRecovery?.retryDelaysSeconds)
-      ? policy.runtimeRecovery.retryDelaysSeconds
-      : defaultPolicy.runtimeRecovery.retryDelaysSeconds,
+    hardRetryDelaysSeconds: Array.isArray(policy?.runtimeRecovery?.hardRetryDelaysSeconds)
+      ? policy.runtimeRecovery.hardRetryDelaysSeconds
+      : defaultPolicy.runtimeRecovery.hardRetryDelaysSeconds,
+    softRetryDelaysSeconds: Array.isArray(policy?.runtimeRecovery?.softRetryDelaysSeconds)
+      ? policy.runtimeRecovery.softRetryDelaysSeconds
+      : defaultPolicy.runtimeRecovery.softRetryDelaysSeconds,
   };
   return policy;
 }

package/src/discovery.mjs

@@ -1,3 +1,4 @@
+import os from "node:os";
 import path from "node:path";
 
 import { expandDocumentEntries } from "./doc_loader.mjs";
@@ -49,6 +50,11 @@ const DOCS_SOURCE_META = {
   repo_docs: { label: "仓库 docs 目录", confidence: "medium" },
 };
 
+function isImplicitHomeDirectory(targetPath) {
+  return Boolean(targetPath)
+    && path.resolve(targetPath) === path.resolve(os.homedir());
+}
+
 function pushBasis(basis, message) {
   if (message && !basis.includes(message)) {
     basis.push(message);
@@ -127,6 +133,10 @@ export function discoverWorkspace(options = {}) {
   const explicitRepoRoot = options.repoRoot ? resolveAbsolute(options.repoRoot, cwd) : "";
   const explicitDocsPath = options.docsPath ? resolveAbsolute(options.docsPath, cwd) : "";
   const explicitInputPath = options.inputPath ? resolveAbsolute(options.inputPath, cwd) : "";
+  const treatCwdAsHomeWorkspace = !explicitRepoRoot
+    && !explicitDocsPath
+    && !explicitInputPath
+    && isImplicitHomeDirectory(cwd);
 
   if (explicitRepoRoot && !pathExists(explicitRepoRoot)) {
     if (!allowNewRepoRoot) {
@@ -196,13 +206,15 @@ export function discoverWorkspace(options = {}) {
   }
 
   if (!repoRoot && !docsEntries.length) {
-    const cwdRepoRoot = findRepoRootFromPath(cwd);
+    const cwdRepoRoot = treatCwdAsHomeWorkspace ? "" : findRepoRootFromPath(cwd);
     if (cwdRepoRoot) {
       repoRoot = cwdRepoRoot;
       repoSource = "cwd_repo";
       pushBasis(repoBasis, "当前终端目录已经位于一个项目仓库内。");
     } else {
-      const cwdClassified = classifyExplicitPath(cwd);
+      const cwdClassified = treatCwdAsHomeWorkspace
+        ? { kind: "workspace", absolutePath: cwd }
+        : classifyExplicitPath(cwd);
       if (cwdClassified.kind === "docs") {
         docsEntries = [cwdClassified.absolutePath];
         docsSource = "cwd_docs";
@@ -373,6 +385,13 @@ export function resolveRepoRoot(options = {}) {
     return { ok: false, message: renderMissingRepoMessage([classified.absolutePath], inferred.candidates) };
   }
 
+  if (!explicitRepoRoot && !explicitInputPath && isImplicitHomeDirectory(cwd)) {
+    return {
+      ok: false,
+      message: "当前目录看起来是用户主目录；HelloLoop 不会把主目录自动当作项目仓库。请切到项目目录，或传入一个项目路径/开发文档路径。",
+    };
+  }
+
   const repoRoot = findRepoRootFromPath(cwd);
   if (repoRoot) {
     return { ok: true, repoRoot };