# 今日行动｜产品交互契约（评审稿）

版本：2026-09-28。本稿供梁晓雅、建波评审和开发对齐。文中「已确认」来自本轮需求及用户补充；「本轮提案」是可开发的选择，尚未得到用户体验验收；「待证据」不得直接作为健康承诺上线。配套机器可读定义见《字段与状态.json》。执行画面与可交互原型由本轮另一交付承载，本稿定义其行为。

## 1. 范围、目的与边界

用户从今日行动列表了解行动、进入引导、完成一个轻量行动、看到结算，再返回列表。当天完成任意 **3 个不同 action**，当日任务完成。已完成行动允许再练，重复完成不增加 3 个的计数。首批仅定义 4 个不同 action：**颈部轻转**（A/B 是二选一呈现）、**轻柔慢呼吸**、**指尖留意**、**自由画线**。既有「10 选 3」是未来行动库的结构；新版 10 项内容未提供，不用旧截图中的其他条目补齐。

本轮不做数值评分、等级、额外 bonus、签到或连胜惩罚。行动视觉暂选**柔和纸感 2D**：近白底、细线、半透明纸片与低幅度舒缓运动；图形的高亮和形变必须表达目标、操作与结果。行动选择页保持既定布局，配色采用已确认的 `#fafaf9`、`#e8effb` / `#f8edf1`、`#ffffff`、`#24272b`、`#416a9b`。这套视觉及下面的具体互动属于本轮主设计提案，须通过真实设备体验验证。统一的是材质、色彩、图形和反馈语法，不强制五套执行页控件同位。

原型已有明确脚本，不把所有完成条件写成「待定」：颈部左右交替共 6 次，每次在个人舒适位置保持 5 秒后回正；呼吸以 5 秒吸、5 秒呼的媒体节拍有效播放 300 秒；指尖从首触开始 60 秒前台体验；绘画从首笔开始 60 秒，之后可选择收好非空作品。颈部动作次数和保持时间、舒适范围与呼吸建议有公共健康来源；60 秒指尖/绘画是**设计取值**，非科学剂量。目标容差、回正判定与触控视觉阈值是**工程/原型取值**，需试机。原型中的摄像头和奖励结算持续标明模拟，不能说已判断动作正确或实际到账。

本轮《行动依据核查.md》提供了**可供内容审核的具体候选**：NHS 坐姿颈部旋转给出舒适范围、每侧保持约 5 秒、回正、左右各 3 次 [S1]；NHS 呼吸指导给出不强迫、可数到 5、持续至少约 5 分钟的做法 [S2]。它们支持动作/引导内容，不证明摄像头能判断颈椎转角，也不证明本产品健康效果。正式配置仍需健康内容负责人审核、版本化并经过设备/可用性验证。参考出处及可用前后文案见同目录《行动依据核查.md》。

## 2. 页面流与各页职责

`今日行动列表 → 行动介绍/教学 → 准备 → 执行 → 结算 → 今日行动列表`。准备环节对颈部包含摄像头授权与校准；呼吸、指尖、绘画用简短步骤提示，后续可与介绍页合并，但本原型均有准备画面。从执行页主动退出走确认框，确认后回列表；当次未完成进度清零。系统离开前台后未完成会话结束，返回介绍并从头开始。无暂停与续接。已经写入的历史完成和已经发放的奖励不受退出影响。

| 页面/层 | 用户先看到什么 | 操作与去向 | 状态与边界 |
|---|---|---|---|
| 今日行动列表 | 标题说明、周日开始的 7 日记录条、花朵/旗帜、行动卡片、固定的「今日完成 X/3」 | 点卡片进介绍；日期条可查看记录，不改选定日期的今日任务 | 只列有效 action；已完成卡片写「今日已完成·再练一次」。0/3 时今日标「待开始」，过往 0 标睡觉图案，未来日期标未来且不伪装记录；1–2/3 旗帜显示当前进度，3/3 花朵完成态。图标必须配文字或可读标签。 |
| 介绍/教学 | 行动名称、预计时长、做什么、怎么做、为何做、步骤预览与来源入口；首要按钮「开始准备」 | 四项均进入准备；返回列表 | 科学描述短句放卡片及介绍；详细来源可展开。颈部约 1–2 分钟、呼吸 5 分钟、指尖 1 分钟、绘画约 1 分钟；颈部时长受校准和个人节奏影响。所有效果描述按来源边界审核。 |
| 摄像头准备 | 相机用途、授权入口、设备摆放与取景提示、脸部可见性、中央校准点、镜像预览 | 授权后校准中立位；稳定识别且设备条件满足才启用「开始」；拒绝可返回列表 | 不存储原始人脸视频的方案属于待隐私确认；原型无真实识别时只有「模拟开始」并标模拟。授权失败、遮挡、多人入镜、光线/距离不适合时具体提示和重试。手机摆放/识别阈值待实机定。 |
| 非摄像头准备 | 一句话准备引导及各自 3 步操作说明 | 点「开始练习」进入执行 | 呼吸、指尖、绘画均有此环节。是否合并到介绍页可在手机可用性测试后调整，不影响执行规则。 |
| 执行 | 当前一步、应做动作、可感知的自己位置或触点、目标与进度、明显退出入口 | 按各行动规则逐步推进；完成后自动提交结果并进结算 | 文案随步骤变，不用闪烁或倒计时催快。后台/来电等中断按退出处理，当次进度不保留；若提交结果已成功，重入直接可查历史与结算。 |
| 退出确认 | 「退出后本次进度不保留」及「继续练习」「退出活动」 | 继续关闭弹窗；退出清会话并回来源页 | 只清未提交会话，不能回滚永久历史或已到账奖励。 |
| 结算 | 本次 action 已完成、今日不同 action 进度、行动后说明、实际到账奖励及状态 | 「返回今日行动」；再练仅从列表重新进入 | 结果提交和奖励到账分别显示。奖励未知/处理中时写「正在核对奖励」，提供刷新/重查，不假称已到账，也不提供重复领取。无新奖励的再练写「本次为重复练习，今日进度不变」。 |

日历与日期边界采用设备本地日期仅作原型展示；正式版需选定账号时区和服务端日期口径，跨日时以服务端权威结果刷新。周视图从周日到周六。过去 0、今日 0、未来三种外观不同；过去是否有缺席含义，只是中性睡觉图案，不能当惩罚。

## 3. 五套执行方案

下述参数区分三类：**来源支持的动作候选**、**本版产品设计取值**、**工程模拟/待测值**。通用完成原则：达到各自明确的原型完成条件才触发一次完成提交；这不表示系统判定生理动作正确。所有方案完成后进入结算，不额外加「领取」步骤。

### 3.1 颈部轻转 A：鼻子追踪轨道（本轮提案）

**开始与画面。**准备页完成相机授权、中立位校准后，执行画面显示水平柔和轨道、中央起点、左右目标光点、代表鼻子估计位置的实心蓝点。短文案「蓝点跟着你。缓慢向目标方向移动，进入光圈后停留。」脸部预览只在准备页；执行页以抽象点呈现，仍保留「重新对准」入口。左右先后、幅度、组数由已核定配置决定，不能从稿中推导处方。

**逐步过程。**`回正待机 → 向当前方向缓慢移动 → 进入目标范围 → 连续保持 5 秒 → 回正 → 下一方向 → 完成`。左右交替共 6 次，每侧 3 次。每步仅点亮当前一段轨道；目标方向用箭头和文字双重提示。位置在范围内时光圈缓缓闭合并出现「保持舒服的位置」；离开目标范围时本次保持从 0 重计，不累计剩余时长。原型把归一化鼻点距目标小于 **0.12** 作为「进入」的模拟容差，把回正连续稳定 **0.65 秒** 作为下一次开启条件；两值均为工程待测，不是转头角度或医疗阈值。每段后显示「回到正中」，回正被确认后再显示另一侧。6 次结束后提交。

**异常。**相机失焦、鼻点丢失、多人入镜或检测置信不足时立即停止动作判定，光点退为未识别态，文字「先回到自然正中，让整张脸重新进入画面」；本次保持清 0，重获识别后回正并重试**当前次**，前面完成的次数保留。不能冻结并继续剩余保持时长。模型不能识别颈部动作是否在医学安全范围；界面只提醒「到舒服的位置即可，有疼痛或头晕就结束」。反复无法识别提供重新对准与退出；退出清当次进度。

### 3.2 颈部轻转 B：滑翔片与气流带（本轮提案）

**开始与画面。**与 A 使用同一 action 内容和摄像头准备。执行页是一张水平纸面，中央小滑翔片代表用户，左右柔和的目标气流带代表缓慢进入并保持的位置；浅色光片只在保持阶段沿气流飘来。文案「缓慢移动滑翔片，进入亮起的气流带，保持片刻。」无需 3D、俯冲速度、无限障碍或追逐节奏。镜头鼻子估计位移映射为横向位移，映射灵敏度与中立位置待实机校准。

**逐步过程。**`中央待机 → 气流带点亮 → 缓慢横移 → 进入目标带 → 保持 5 秒并逐片收集光片 → 回正稳定 0.65 秒 → 下一段 → 完成`。左右交替共 6 次。到位时气流带**软色变化**，不使用虚线变实线；保持进度由光片逐片累积和文字「保持舒服的位置」表达。光片只是进度视觉，不是额外奖励。回正后才开启另一侧目标。0.65 秒与归一化目标容差 0.12 是模拟/工程待测取值，不能解释为安全角度。6 次完成后进入结算。

**边界与恢复。**本版没有碰撞、真实边缘弹动或障碍判定；偏离目标带时本次保持清 0，画面继续提示轻缓返回气流带，不扣分或奖励。相机丢失时停止判定，重获后回正并重试当前次，前面完成次数保留；不保留当前次保持的剩余时长。两方案分别做可理解性与舒适度测试后再选择上线版，不能把 A/B 当成两次当日行动。

### 3.3 轻柔慢呼吸：纸感圆片（本轮提案）

**开始与画面。**介绍页说明跟随文字和圆片，不声称检测呼吸；准备页以简短步骤帮助用户找到舒服的姿势。执行页播放同材质圆片缓缓展开/收拢的 10 秒循环 WebM；阶段文字在界面层，前 5 秒为「轻轻吸气」、后 5 秒为「慢慢呼气」。不屏息、不强迫，跟不上时按自己的自然节奏。5/5 秒、约 300 秒引导依据 NHS 可数到 5、至少 5 分钟的建议形成产品节拍候选，并非对每个人适用的强制呼吸剂量。

**反馈与结束。**圆片展开/收拢仅表示引导节奏，不判断用户是否真的吸气或呼气。以媒体实际有效播放累计到 **300 秒** 才完成；暂停、缓冲、寻找播放位置不累计。原型视频静音，此版无音频开关；声音属于后续可选设计。视频无法播放时显示重试或可用的同节拍文字/圆片替代方案，替代方案需单独验证有效计时，不能让失败的媒体在后台虚增到 300 秒。系统离开前台结束未完成会话。

### 3.4 指尖留意：柔性圆片聚合（本轮提案）

**开始与画面。**介绍页说「用手指缓慢、连续地触摸圆片，让注意力跟随接触的位置」。执行页有散开的几片半透明纸圆；用户触摸后，附近圆片缓缓向触点聚合，连续缓慢滑动时群体跟随。指尖位置始终有一枚小实心点与轻波纹，避免用户不清楚谁在控制。机制是本轮独立设计提案，不能声称复现某一产品当前确切关卡。

**反馈与结束。**首触才开始 **60 秒前台体验计时**。手指抬起时计时继续，圆片从聚合态柔和舒展；再次触摸仍可继续聚合。移动过快时反馈可减弱，不设置惩罚或数值评分。满 60 秒自动结束并结算，完成的含义是经历了这段前台指尖引导，设备没有判断是否专注。60 秒是产品体验取值，移动响应阈值是工程待测。触控不可用时计时不开始，提示重试或退出；系统离开前台结束未完成会话。

### 3.5 自由画线：手指笔迹与可选对称（本轮提案）

**开始与画面。**介绍页文案「手指到哪里，线条就延伸到哪里；想要时可打开对称」。执行页是纸面画布、固定的柔色笔迹、可见的「对称」开关、剩余创作时间和退出。触点立即留下笔迹；开启对称后沿画布中轴同步生成镜像笔迹，关闭后原有笔迹保留。首版不做随机扩散、复杂丝绸笔触或健康结果推断。

**反馈与结束。**首笔开始 **60 秒前台计时**，停笔欣赏仍继续计时。60 秒后若画布非空，启用「收好这幅作品」按钮，用户点击才完成、查看本次作品并结算；不自动收起画布。若仍为空，则显示「画下一笔，再收好作品」并保持按钮禁用。清屏只清笔迹，**不重置已开始的计时**；继续画后仍可收好。60 秒是产品设计取值，非临床剂量。离开页面清当次未提交画布；完成后原型可在结算页回看本次作品，长期保存/导出与隐私范围待确认，不自动上传。

## 4. 完成、奖励与数据写入

服务端需要把 `action_id` 作为计数单位：两种颈部模式共享 `neck_left_right`。一次完整练习生成不可复用的 `session_id`。完成提交先持久化完成事件，再据服务端本地日历日与 `action_id` 原子判断是否当天首个不同完成；当天已存在此 action 则标重复练习，不增加 0–3 进度。当天第 3 个不同 action 后，任务完成旗帜/花朵状态更新。列表和结算必须读同一权威结果，不能仅靠页面内计数。

**奖励提案，待产品确认：**当天前 3 个不同 action 首次完成时按既有奖励配置自动发放；之后的重复练习及第 4 个不同 action 无新增今日行动奖励。奖励具体资源类型、数量、上限、是否存在 action 固有奖励及「完成 3/3」额外奖励，当前均未知，不能在页面写假数。结算页从奖励账本显示实际到账项；无新奖励显示「本次无新增奖励」。奖励写入以 `user_id + service_date + action_id + reward_rule_id`（或后端同等唯一约束）幂等，完成事件和奖励事务有明确关联；重复点击、断网重试、跨设备并发只得一份。同一个完成事件的服务端处理中或结果未知时先按 `session_id` 查询，不盲目重发另一事件。发放失败时完成记录保留，奖励状态为待处理/失败可重试，自动补偿不得重复到账。

原型可以模拟「完成提交」和「奖励结算」，但需在原型显著标「模拟结算，非真实资源到账」，奖励位置用资源名称/数量占位或「待接入」而非虚构数值。永久历史与已发奖励不可因主动退出、相机失败或返回列表而清除。

### 字段级展示规范与结算文案

| 字段/状态 | 页面呈现与来源 | 可用操作 |
|---|---|---|
| `display_name`、`estimated_duration`、`benefit_short` | 卡片依次显示名称、约时长与中性收获句；颈部约 1–2 分钟，呼吸 5 分钟，指尖 1 分钟，自由画线约 1 分钟。名称使用本稿四个正式显示名。 | 点卡片进入介绍。 |
| `intro_steps`、`source_url`、`before_copy` | 介绍页可读步骤与「为什么这样练习」展开来源；不能把游戏参考写成疗效依据。 | 开始准备、查看来源。 |
| `session_progress`、`cue`、`input_state` | 执行页显示当前步/剩余时长与短文案；鼻点追踪失效写「重新找到正中位置」，呼吸媒体未播不能计时，触控未开始前不倒数。 | 退出，或按本动作继续。 |
| `daily_distinct_count`、`is_replay` | 列表与结算从已提交完成记录显示 X/3；再练显示「本次是再次练习，今日进度不变」。 | 返回今日行动。 |
| 奖励确认中 `pending` | 「完成已记录 · 奖励确认中」。当前原型因未接业务系统只停在此模拟态，不能声称到账。 | 可返回列表；正式版提供「查看奖励状态」并在重入时刷新。 |
| 奖励到账 `granted` | 「已获得：{真实资源名称} × {账本数量}」；多项逐项列出，到账时间取服务端。数值未知时不能显示假数。 | 返回今日行动；可查看奖励明细。 |
| 奖励失败待重试 `failed_retryable` | 「行动已完成，奖励暂未到账。系统会继续处理。」若已超过自动重试时限，则显示「重新查询奖励」；不能把行动改回未完成。 | 查询同一完成事件的处理结果，不创建第二份奖励。 |
| 无需奖 `not_eligible` / `none_for_replay` | 再练写「本次是再次练习，今日进度不变，无新增奖励」；若前三不同 action 奖励提案获批准，第 4 个不同 action 写「本次行动已记录，今日任务已完成，无新增今日行动奖励」。 | 返回今日行动。 |

上述「前三不同 action 奖励」仍是产品待确认建议；实际到账与失败文案在正式接入后按真实账本状态显示。原型的完成页 `grant`/`completed` 仅在内存模拟，刷新页面可能丢失，不构成永久历史或奖励实现。

### 手机实测验收

在目标手机上分别检查：前摄对正中与左右个人舒适位置的校准、镜像方向是否易懂、鼻点跳动/脸部短时遮挡后的 0.12 容差与 0.65 秒回正是否稳定；长时间保持时看屏是否增加不适。A/B 用同一动作脚本比较，不诱导追逐目标。呼吸检查 WebM 循环与 5/5 秒文字同步、缓冲与切后台不虚增 300 秒；指尖检查首触后抬手、重触及慢移时的计时/舒展；绘画检查清屏后计时不断、空白不可完成、60 秒后仍由用户收好。小屏、文字放大、单手触摸与系统返回下，退出入口和步骤提示保持可见。摄像头安全阈值与触控体验阈值未经过这些试机前不能当正式动作质量判断。

## 5. 可观察验收

1. 选择页只呈现已提供的 4 个不同 action；颈部卡片可对比 A/B，但任意完成模式后同一卡片显示已完成，当日仅计 1 个。
2. 新用户从每张卡片能看到动作概述、预计时长或明确待定、科学信息及来源状态，并经引导进入对应执行；未授权相机不能假装识别成功。
3. 五套执行页均能让观察者指出「我控制什么、目标是什么、下一步怎样做、怎样看出到位/保持/完成」；A/B 还需实机测试动作可看性、延迟、晕动/疲劳及识别稳健性。
4. 相机丢失立即停止动作判定；恢复后回正重试当前节点，不沿用剩余保持时长。退出、后台中断均不续接；历史完成和到账奖励仍可查。
5. 三个不同 action 首次完成后显示 3/3；重复练习不增计数。周日始周视图中过去 0、今日 0、未来日期，以及 1–2/3 旗帜、3/3 花朵均能区分。
6. 结算展示完成记录与奖励到账的各自真实状态；重复请求、页面返回、双设备并发不能重复加进度或重复发放。
7. 左右各 3 次/保持 5 秒、5/5 秒呼吸与 300 秒有效播放、指尖和绘画各 60 秒的当前脚本可逐项复现；0.12 目标容差、0.65 秒回正与触控响应阈值仍需试机。所有模拟摄像头及结算画面可被评审者一眼识别为模拟。

## 6. 上线前待确认/待验证

| 事项 | 当前处理与解决责任 |
|---|---|
| 颈部、呼吸、指尖、绘画的正式动作、剂量、禁忌提示、科学前后文案与逐条来源 | 健康内容负责人提供可追溯证据与版本；产品核对动作和 UI 文案。未核定前只展示中性操作语句。 |
| 颈部 A/B 哪套上线、镜头摆放、人脸追踪精度、阈值、失焦判定、动作映射和隐私方案 | 建波做真实设备技术验证，梁晓雅做至少一轮用户理解与舒适度观察；此稿不代表验收。 |
| 首三不同 action 奖励、第四项及再练奖励、资源类型/数量、完成 3/3 是否另奖 | 产品/后端核对既有奖励表后确认；当前仅是建议。 |
| 指尖与绘画 60 秒体验取值的适用性、触控响应；画作长期保存 | 产品通过手机体验测试确定是否调整；本轮原型计时行为和绘画收好条件已写清。 |
| 完整 10 项行动库、旧行动迁移、跨日时区与周记录历史口径 | 新行动库和服务端规则另行提供；首版仅四个 action。 |
| 相机权限文案、原始帧处理、视频/作品存储与安全边界 | 隐私与技术方案评审后定稿。 |

本稿没有宣称五套交互通过用户验收，也没有把外部产品的受欢迎程度当作健康效果证据。
