# 需求分析报告 - 日期 / 轮次:2026-09-02 / 第 1 轮 - 输入:`00-request.md` - 应用的历史教训:无 - 结论:分析完成,交产品设计 ## 用户原话摘录 > 启动并运行 bookshelf项目,并调用浏览器进行交互验收,检查是否有文字、按钮、交互不适合6岁儿童的交互,调用产品迭代pipline 进行优化 ## 需求拆分 | 上游编号 | 子问题 | 本报告落点 | | --- | --- | --- | | U01 | 启动并运行 bookshelf 项目 | S01、P0-1、硬约束 H01 | | U02 | 必须通过浏览器做真实交互验收 | S02、P0-2、硬约束 H02-H03 | | U03 | 检查文字、按钮、交互是否适合 6 岁儿童 | S03-S05、P0-3~P0-5、硬约束 H04-H09 | | U04 | 调用产品迭代流水线完成优化 | S06、P0-6、硬约束 H10-H11 | | B01 | 产品面向约 6 岁儿童,核心为自然拼读与绘本阅读 | 用户画像、S03-S05、P0-3~P0-5 | | B02 | 孩子主要依靠“听 + 点”独立操作 | 用户画像、P0-3~P0-5、硬约束 H04-H08 | | B03 | 核心路径为选书、阅读、读后检测、拼读、闯关 | S01、P0-2、P0-5、硬约束 H03 | | B04 | 经 Nginx 统一入口操作,开发后调用 child-ux-tester 复测 | P0-1、P0-6、硬约束 H01、H10 | | B05 | 仓库已有较多未提交改动,必须保护现有工作 | 开放问题 Q08、硬约束 H12 | | A00 | 自动推进,不设置原型人工确认停点 | 开放问题 Q07 | | A01 | 本轮优先孩子端核心闭环及孩子底栏,家长端只查误暴露 | 非目标、P1-1、硬约束 H03、H09 | | A02 | 优先前端体验优化,仅在接口或数据阻塞时考虑后端 | 非目标、开放问题 Q05、硬约束 H11 | | A03 | 优先解决会导致孩子卡住、误解或中断闭环的 P0/P1 问题 | S06、P0-6、硬约束 H10 | | A04 | 以 390×844 竖屏为主,必要时补 1024×768 横屏 | P1-2、开放问题 Q06、硬约束 H02 | > 编号说明:U 为用户原话拆分,B 为背景补充,A 为主 agent 初步假设。U 为最高依据;B/A 均不等同于用户明说,后续若与真实浏览器结果或用户意见冲突,应回到 U01-U04 裁决。 ## 用户画像 ### 主要使用者:约 6 岁儿童 - 正处于早期识字和英语启蒙阶段,不能假定其能独立理解长句、抽象概念、技术术语、成人化菜单或音标。设计推论:核心任务不得依赖阅读上述信息才能继续。(来源:B01、B02) - 主要通过“听 + 点”探索,注意力和工作记忆有限。设计推论:当前可做什么、操作后发生了什么、下一步去哪,应能直接感知,不应要求记住多步说明。(来源:B02) - 精细操作能力仍在发展。设计推论:核心按钮需要易发现、易点中,不能被遮挡,也不能与高风险相反操作拥挤排列。(来源:U03,能力边界为本轮推荐假设) - 可能在缺少成人即时指导的情况下完成选书、阅读、点词、翻页、检测、拼读和闯关。设计推论:正常路径、等待状态、犯错后的恢复路径都要支持孩子继续。(来源:B02、B03) ### 需求提出者:项目维护者或产品负责人(假设) - 关注的不是单个已知缺陷,而是当前可运行产品在真实操作中的年龄适配问题,并要求通过完整流水线从发现问题推进到优化及复验。(来源:U01-U04) - 具体身份、是否代表家长以及能否安排真实儿童测试均未说明,不能把这些当成已确认事实。(来源:U01-U04) ### 次要相关者:家长 - 本轮不以家长端体验重设计为目标;只关注孩子路径中是否误入、误显成人内容或需要家长权限的操作。(来源:A01,待用户确认) ## 场景与痛点 ### S01:从统一入口开始学习 孩子或陪同者打开 `http://127.0.0.1/`,进入孩子端并开始书架选书。当前真实运行状态尚未验明;若入口、资源、路由或服务不可用,后续体验验收没有有效基础。(来源:U01、B03、B04) ### S02:在真实页面完成核心闭环 用户要求的是浏览器交互验收,而不是只读代码或只看静态截图。必须实际点击、滚动、翻页、播放、答题、返回和切换底栏,并观察正常、等待、失败及恢复状态;否则容易漏掉遮挡、误触、无反馈、死路或状态丢失。(来源:U02、B03) ### S03:理解页面文字和下一步动作 约 6 岁儿童对长文字、技术术语、成人化层级及音标的理解有限。若关键指令、按钮或错误提示只靠这些内容表达,孩子即使页面“功能可用”也无法独立继续。(来源:U03、B01、B02) ### S04:准确点击关键按钮 核心控件若过小、相邻操作含义相反、位置被遮挡或视觉上不像可点击元素,孩子容易反复误触或不知道该点哪里。当前是否存在此类问题需要以主视口中的实际命中区域和交互结果验证,不能只凭组件名称判断。(来源:U02、U03、A04) ### S05:从反馈中理解结果并恢复 播放、点词、翻页、答题、拼读、闯关等行为需要可感知反馈。无反馈、反馈延迟时无等待提示、错误只显示成人化技术信息、答错后无法重试或误入家长功能,都会使孩子卡住并中断闭环。(来源:U03、B02、B03、A01) ### S06:把发现的问题转成可验证的优化 “检查”不是终点。每个问题需有可复现证据、儿童影响、严重级别和对应复验结果;优化后至少消除所有阻塞或明显妨碍孩子独立完成核心路径的问题,才算形成闭环。(来源:U04、A03) ## 核心诉求(按优先级) | # | 诉求 | 明说/隐含 | 来源 | 验收口径 | | --- | --- | --- | --- | --- | | P0-1 | 在 Nginx 统一入口启动并提供可交互的 bookshelf 产品,保证验收对象是真实运行版本。 | 明说“启动并运行”;统一入口为背景约束 | U01、B04 | 浏览器从 `http://127.0.0.1/` 可进入产品;孩子端核心入口、路由及完成主路径所需资源可加载。若失败,报告能定位到服务、路由、资源或数据中的具体阻塞,而不是继续做无效的静态验收。 | | P0-2 | 以真实浏览器操作覆盖孩子端核心闭环,而非仅做代码审查或截图审查。 | 明说 | U02、B03 | 至少逐段操作“书架选书 → 听故事/点词/翻页 → 读后检测 → 拼读 → 闯关”及孩子底栏;每段记录已覆盖的入口、关键动作、页面反馈与退出/返回路径,所有未能覆盖处均说明阻塞及影响。 | | P0-3 | 核心文字和提示应让约 6 岁儿童在不依赖成人解释的情况下理解当前任务与下一步。 | 明说检查文字;可独立理解为隐含目标 | U03、B01、B02 | 核心路径中不存在必须理解长说明、技术术语、音标、原始错误码或成人化信息层级才能继续的步骤;所有关键指令、等待、成功和失败状态均有儿童可理解的短提示,或有等效且可感知的声音/图形线索。 | | P0-4 | 核心按钮应易发现、易点中、含义明确,并避免高代价误触。 | 明说检查按钮 | U03、B02 | 在主验收视口中,核心控件均完整可见且不被遮挡;可点击区域与视觉区域一致,主要操作能与普通装饰区分。按本轮推荐基线,频繁使用的核心触控目标尽量不小于 48×48 CSS px;无法满足时须证明仍易命中,且相反或高代价操作不能紧邻到易误触。 | | P0-5 | 交互反馈、导航和恢复机制应让孩子不中断地完成学习闭环。 | 明说检查交互;闭环完整为隐含 | U03、B02、B03 | 每个核心操作后均出现可感知反馈;需要等待时有明确状态;答错、点错、返回、音频失败或资源加载失败时,不出现无响应、无法退出或丢失全部进度的死路。核心流程可以继续、重试或安全返回。 | | P0-6 | 对验收发现的高优先级年龄适配问题完成优化并复验,而不是只输出问题清单。 | 明说 | U04、A03、B04 | 每项问题均记录“页面/步骤、复现动作、当前表现、对儿童的影响、严重级别”;所有 P0/P1 均有对应改动及相同路径的复验结果,且开发后 `child-ux-tester` 不再报告未处理的 P0/P1。P2 可留存但需明确不影响核心闭环的依据。 | | P1-1 | 防止孩子在主路径中误入或直接接触仅供家长使用的功能和信息。 | 隐含,来自范围假设 | A01、B02 | 从孩子端各入口、底栏和返回路径操作,不会在无明确区分或保护的情况下进入家长操作;若产品刻意提供家长入口,其外观和进入方式不应诱导孩子误触。 | | P1-2 | 优化在主要儿童设备视口上可用,不因布局造成新增障碍。 | 隐含,来自范围假设 | A04 | 390×844 竖屏完成全量核心路径复验,无关键控件溢出、遮挡或必须精细滚动才能发现;若 1024×768 横屏存在独立布局,则补测差异路径并记录结果。 | ## 严重级别口径 - **P0(阻塞)**:统一入口或核心流程不可用;孩子无法继续且无可发现的恢复路径;或误操作会造成不可逆/高代价后果。 - **P1(严重)**:核心流程虽可继续,但约 6 岁儿童很可能因理解、命中、反馈、导航或成人内容误入而需要成人介入、反复试错或中断学习。 - **P2(一般)**:不阻碍核心闭环,主要影响一致性、愉悦感或低频边缘场景;可以作为本轮遗留项,但必须记录。 以上分级是为落实 A03 的推荐操作口径,并非用户原话;真实浏览器证据应优先于主观印象。 ## 非目标 - 不全面重设计家长端;仅处理孩子可直接触达或误入的家长内容。(来源:A01) - 不改变课程目标、自然拼读规则、绘本内容或学习数据含义;年龄适配不能以擅自删改教学内容达成。(来源:B01、A02) - 不预设需要新增后端接口或调整数据结构;只有真实交互证据表明现有接口/数据阻塞 P0/P1 体验时,才扩大到后端。(来源:A02) - 不把品牌重塑、大范围视觉换肤或纯装饰性动效作为本轮主要目标;它们不能替代可理解、可点击、可反馈、可恢复。(来源:U03、A03) - 不把专家启发式验收或自动化检查等同于真实 6 岁儿童可用性研究;本轮未明说招募儿童、家长访谈或长期学习效果验证。(来源:U01-U04) - 不保证修复与本次儿童核心路径无关的全部历史缺陷;无关问题应留存,不得借本需求扩大范围。(来源:U03、U04、A01) ## 关键假设与开放问题 | # | 未确认事项 | 推荐假设(用于自动推进) | 若假设不成立的影响 | | --- | --- | --- | --- | | Q01 | 是否需要真实 6 岁儿童参与观察测试? | 本轮先采用浏览器实操、儿童发展启发式和 `child-ux-tester`;把真实儿童观察列为后续验证,不宣称已经儿童实测。 | 只能证明符合既定检查口径,不能证明真实儿童一定能独立完成。 | | Q02 | “不适合 6 岁儿童”的最终判定由谁裁决? | 以是否妨碍孩子理解、点击、获得反馈、恢复和完成核心闭环为判据;边界争议项保留证据供用户裁决。 | 可能在趣味性、文案语气或教学专业性上存在主观分歧。 | | Q03 | “听 + 点”是否要求所有关键控件都提供语音播报? | 不强制每个控件新增语音;但不得把复杂文字作为完成核心动作的唯一线索,优先保证现有声音、图形和短文案组合可理解。 | 若用户要求全程语音引导,产品范围和音频资产/数据契约将扩大。 | | Q04 | 当前数据是否足以跑通所有核心环节? | 使用仓库现有可用绘本、单词和关卡数据完成一条代表性闭环,同时检查各核心页面的通用控件与异常状态。 | 若样本缺失或接口失败,需把数据/后端阻塞升级,不能以“未测”当作通过。 | | Q05 | 是否允许后端或数据改动? | 先做前端体验优化;只有 P0/P1 的根因明确位于接口或数据时,才提出最小必要变更并走后端阶段。 | 若完全禁止后端改动,部分阻塞只能列为遗留;若提前扩大后端则违背 A02。 | | Q06 | 横屏是否属于必测范围? | 390×844 竖屏全量;仅在产品支持、设备切换或布局差异可能影响核心操作时补测 1024×768。 | 若横屏也是主要使用方式,需要提升为全量覆盖矩阵。 | | Q07 | 是否需要原型人工确认后再开发? | 依据 A00,本轮不设置人工停点,但仍保留原型和审查记录供追溯。 | 若用户期望先确认,后续开发可能早于其决策。 | | Q08 | 现有未提交改动的归属及可修改边界是什么? | 依据 B05,视为用户已有工作;只修改与已确认 P0/P1 直接相关且可追溯的文件,不覆盖或回退无关改动。 | 若问题与现有改动重叠,实施阶段需先厘清差异,否则存在误覆盖风险。 | ## 给下游的硬约束 - **H01(U01/B04)**:体验与复验必须基于 `http://127.0.0.1/` 的真实运行版本;静态页面、组件目录或代码推断不能单独构成通过证据。 - **H02(U02/A04)**:以约 390×844 竖屏做全量核心路径;横屏是否补测按 Q06 执行,视口和页面状态必须写入证据。 - **H03(U02/B03/A01)**:覆盖书架选书、听故事、点词、翻页、读后检测、拼读、闯关、孩子底栏以及从孩子端误入家长功能的可能路径;不得用单页抽查代表完整闭环。 - **H04(U03/B01/B02)**:不得让长文字、技术术语、音标、成人化信息层级或原始错误信息成为孩子继续核心任务的唯一线索。 - **H05(U03/B02)**:每个页面应让孩子直接感知“现在做什么、哪里能点、操作后发生了什么、卡住后如何继续”;该约束是体验目标,不限定下游采用某一视觉样式。 - **H06(U03)**:所有核心按钮必须检查可发现性、实际命中区域、遮挡、相邻误触和操作后反馈,不能只检查按钮文案。 - **H07(U03/B02/B03)**:正常、等待、空内容、失败、答错、重试、返回等状态均须纳入检查;任一状态不得把孩子留在无反馈或不可恢复的死路。 - **H08(U03/B02)**:声音可以增强理解,但不得用自动、重复或不可停止的声音制造新的干扰;无声或播放失败时仍要有可感知的基础反馈。 - **H09(A01)**:家长端不做全面重设计,但孩子端到家长功能的边界必须纳入验收,不能因“家长端不在范围”而漏测误入风险。 - **H10(U04/A03/B04)**:每个发现项必须带复现证据、儿童影响和严重级别;所有 P0/P1 优化后沿原路径复验,并通过项目规定的 `child-ux-tester` 门禁后才能进入最终验收。 - **H11(U04/A02)**:任何方案与实现都必须可追溯到 P0-1~P1-2;无真实证据不得扩大到课程、数据结构或后端改造,P2 不得挤占 P0/P1 的完成优先级。 - **H12(B05)**:后续角色须先识别并保护仓库现有未提交改动;不得覆盖、回退或把无关已有改动冒充为本需求产出。 ## 双向核对结论 - 上游 U01-U04、B01-B05、A00-A04 均已在需求拆分、场景、核心诉求、非目标、开放问题或硬约束中落点,没有遗漏。 - 本报告 P0-1~P1-2、Q01-Q08、H01-H12 均标注或说明了上游来源;其中来自 B/A 的内容明确标为背景、假设或推荐口径,没有冒充用户明说。 - 未发现用户原话与主 agent 背景/假设直接冲突;需要用户裁决但不阻塞自动推进的事项已集中列入 Q01-Q08。