# UX 优化统一规则中心（v2.1.2）

> 适用范围：福帮手 Team Lead、S0-S6 工作流、会话恢复、质检反馈与进度展示。  
> 目标：把“能力存在”转成“用户可感知”。

---

## A. 主动会话恢复（P0）

每次新会话首轮触达，执行三级检测：

1. `.fbs/smart-memory/session-resume-brief.md`（48h）
2. `.fbs/esm-state.md`（当前阶段）
3. 宿主记忆中的本书摘要（若可用）

命中后输出 4 行恢复卡：

- 书稿已加载：{书名}
- 当前阶段：{S状态}
- 上次完成：{节点}
- 建议下一步：A / B / C

---

## B. 渐进式引导（P1）

- 只推荐“最近可达下一步”，每次最多 3 个动作。
- 首次用户只问“你要写什么”，不直接抛内部术语。
- 每次阶段完成后更新 `.fbs/next-action.md`。

---

## C. 行为学习（P2，半透明）

- 学习用户偏好前后都要可解释。
- 应用偏好时必须提示：

> 根据你之前偏好，我先用 {风格} 输出；如果你想改，我马上切。

- 临时事实不进长期记忆，长期只保留“策略经验”。

---

## D. 质检反馈文案（P1）

从“考试式阻断”改为“成就式反馈”：

- 旧：质检失败，请修复后继续
- 新：本章已完成，当前 87/100；2 处已自动优化，1 处待你确认

失败项统一三动作：`[现在修] [稍后修] [跳过]`

---

## E. 进度可视化（P1）

自动触发点：

- S 阶段切换
- 每章完成
- 用户主动询问进度

默认不在普通写作中途打断。

推荐仪表盘：

```
━━━━━━ 书稿进度 ━━━━━━
📖 [书名]  阶段：S3 写作中
章节：4/12 完成  |  质检：3/4 通过
预计剩余：8 章  |  总字数：~12,350
━━━━━━━━━━━━━━━━━━━━
```

### E.1 可抽查工件（可选，P2）

- **目的**：仪表盘仍以对话输出为主；若需**对照本节约束做人工抽查**，可让 Agent 在阶段切换或章节完成后运行 `node scripts/write-progress-snapshot.mjs --book-root <书稿根>`，生成 `.fbs/progress-snapshot.md`（文本块 + 台账节选），与上表版式对照即可。  
- **性质**：**非** `pack:skill-gates` 门禁；不强制每轮生成。

---

## F. 用户语言规则（强制）

- 用户可见层禁止暴露 Tier、调度层、内部模块名。
- 对用户只说“功能中文名 + 当前动作 + 下一步建议”。
- 出错说明采用三段式：发生了什么 / 影响是什么 / 怎么做。

---

## G. 首屏三秒与确认-执行分离（WorkBuddy 实测 2026-04-13）

### G.1 首屏三秒

用户看到的第一屏须包含：

1. **当前状态**（一句话：环境已连接 / 是否已有书稿目录等，用人话）。
2. **可执行动作（≤3 条）**：写新书、接着写、质检或整理素材；需要更多时再展开。
3. **帮助入口**：可用「不知道该选什么？」引导补一句，而非堆长列表。

### G.2 确认-执行分离

- **大段信息收集**（书名、结构、读者、字数）→ 收齐后 **一次性汇总**，用户说「开始」再分步落地。
- **小步修改** → 可直接执行后汇报，避免对同一信息反复确认。

### G.3 退出与长静默

- **退出**：见 [`ux-agent-playbook.md`](../05-ops/ux-agent-playbook.md)「退出前软询问」；技术字段见 `session-exit` 的 `agentGuidance`。
- **脚本/终端报错**：对用户用「环境兼容性 / 已降级」类人话；勿直接贴 `CommandNotFoundException` 全文（维护者排障可另给日志）。
