# 探趣岛学习页 1:1 复刻报告 > 抓取时间:2026-10-11(UTC+8) > 材料目录:`D:\codes\MyProjects\easy-study\tanqudao-capture\deep-20261011\` > 对照课程:`c-mn15edqe-qirc12`《新手英语生活场景入门》/ Lesson 1 `l-mn15jfdn-ikcigx` > 脚本:`tanqudao-capture\work\deep-capture.js`(CDP 9222) > 交互设计(Agent):`docs/练习页交互与功能设计.md` --- ## 1. 信息架构 / Sitemap ``` /app/courses 课程广场(分类 Tab + 卡片网格) /app/courses/:courseId 课程详情(封面信息 + 课节网格 + 继续学习/收藏) /app/game 练习主界面(课节内答题;由「继续学习」或课节进入) 侧栏(全局):首页 / 我的收藏 / 课程广场 / 教辅广场 / 复习本 / 发帖有奖 / 合伙人计划 / 开通会员 / 奖励明细 / 设置 / 深色模式 顶栏(广场/详情):咨询客服 / 建议反馈 / 用户胶囊(昵称·等级·今日时长) ``` **学习端复刻范围(P0)**:广场 → 详情 → `/app/game` 练习三页。会员/支付/发帖等非目标。 进入练习的实测路径: 1. 详情页点 **继续学习** → 进入 `/app/game`(已验证,带登录态与进度)。 2. 详情页点具体 **Lesson N** 卡片:脚本曾误判侧栏「开通会员」为付费墙;实际若课程已解锁,应同样进入 game。材料见 `03-practice-lesson1/paywall*`(需人工复核是否为误报)。 --- ## 2. 逐页布局 ### 2.1 课程广场 `/app/courses` | 区域 | 结构 | 要点 | |------|------|------| | 左栏 aside | 宽约 176px,竖向导航按钮 | 圆角 12px;当前项有蓝色描边光晕 `rgba(79,139,255,.3)` | | 顶栏 header | 高 56px,半透明 `rgba(7,10,15,.72)` | 右侧客服/反馈/用户 | | 分类 Tab | 全部 / 零基础 / 入门 / 初级 / 中级 / 进阶 / 高级 | 点击过滤列表(会再次请求 `/api/courses`) | | 卡片网格 | 约 128×210 卡片,多列 | 封面 + 标题 + editorName + `N小节` | 截图/清单:`01-plaza/`(含各分类 `filter-*.png`)。 ### 2.2 课程详情 `/app/courses/:id` | 区域 | 结构 | |------|------| | 标题区 | 课程名、返回上一层、小节数、累计练习时长 | | 主操作 | **继续学习**、**收藏** | | 进度 | 「学习进度 0%」类文案 | | 课节网格 | 每课一颗大按钮:英中标题、练习时长、完成次数、状态(最近练习/待完成)+#序号 | 截图:`02-course-detail/`。 ### 2.3 练习页 `/app/game` 全屏深色练习台(无左栏主导航,或弱化): | 区域 | 内容 | |------|------| | 顶左 | **返回**(紫粉色字 `rgba(183,126,255,.98)`)+ 课节标题 /「练习(i/n)」 | | 顶右 pills | 设置 / **切换模式** / 学习内容 / 重置进度 / 个性化 / 报错 / 沉浸模式 / 全屏 | | 计时 | 如 `00:36` | | 变体 Tab | **拆句练习** / **整句练习** / 显示图片(`variant-pill`,激活项蓝色 inset 光晕) | | 主区 | 中文提示句;拆句时多个 `input.word-input`(「第 N 个单词」);整句时多为 textarea;下方可展示 IPA、词性、句法、切块卡片 | | 底栏快捷键条 | 一排 `hk-key` 芯片(见第 5 节) | 截图:`04-game/`、`03-practice-via-continue/`、`practice-unstick/`。 --- ## 3. 颜色 / 字体 / 间距(Design Tokens) 来源:`design-tokens.json`、各页 `*-tokens.json`。 | Token | 值 | |-------|-----| | 页面底色 | `rgb(7, 10, 15)` | | 主文字 | `rgb(255, 255, 255)` / 次级 `rgba(255,255,255,.86)` / 更弱 `.66` | | 字体 | `Hind, -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, "Microsoft YaHei", system-ui, sans-serif` | | 基准字号 | 16px(底栏芯片 12px) | | 侧栏宽 | ~176px;顶栏高 56px | | 圆角 | 导航/ pill **12px**;变体 pill **10px**;底栏 hk **10px** | | 激活导航光晕 | `rgba(79,139,255,.3) 0 0 0 1px` + 深阴影 | | 返回按钮色 | `rgba(183, 126, 255, 0.98)` | | 填空字色 | `rgb(65, 98, 255)`(word-input) | | 底栏芯片底 | `rgb(27, 28, 33)` | | pill 底 | `color(srgb 1 1 1 / 0.04)`,描边约白 24% | | 正确反馈相关 | DOM 存在 `correct-fx-canvas`;成功图标色约 `rgb(77, 124, 255)` | | CSS 变量 | 根上几乎无自定义 `--*`(0 个),样式靠 class | 音效资源(`/api/sound-effects`):`typing` / `nav` / `correct` / `wrong` / `complete`,各有 defaultUrl + variants(`/api/sfx/...`)。 --- ## 4. 控件与行为清单 ### 4.1 广场 / 详情 | 控件 | 行为 | |------|------| | 分类 Tab | 过滤课程列表 | | 课程卡片 | 进详情 `/app/courses/:id` | | 返回上一层 | 回广场 | | 继续学习 | 进 `/app/game` 并恢复进度 | | 收藏 | `POST /api/favorites/courses/:id` | | 课节按钮 | 进入该课练习(带 lessonId) | ### 4.2 练习页顶栏 / 变体 | 控件 | 行为 | |------|------| | 返回 | 离开 game(回详情或广场) | | 切换模式 | 打开模式面板(见下) | | 学习内容 | 打开课节内容/句表相关面板 | | 重置进度 | 重置当前课进度(慎用) | | 拆句 / 整句 | 切换练习变体;请求 `lesson-sheet?...&practice=split` 等 | | 显示图片 | 开关句配图 | ### 4.3 模式面板(`mode-card` / `variant-btn`) 已在 DOM 中出现的模式(`practice-unstick/01-before.json`): - **整句练习** / **拆句练习**(变体) - **拼图模式** - **听写模式** - **中译英模式** - **打字练习**(输入框 `typing-practice-input`,aria「打字练习输入框」;界面可出现虚拟键盘字符) 切换后进度 API 的 `mode` 字段可见如 `listening`;`/api/practice/full-source` 返回 `{ mode: "split" }` 等。 --- ## 5. 答题体验与快捷键 ### 5.1 底栏芯片(权威 UI 文案) | 芯片文案 | 键位 | 作用(按界面标注) | |----------|------|-------------------| | `< 上一题` | 点击 / 导航 | 上一题 | | `空格 / ←→ 跳格` 或 `空格 隐藏答案` | **Space**(及部分模式下方向键) | **显示/隐藏答案**;拆句时亦标注跳格 | | `Ctrl A 朗读` | **Ctrl+A** | 朗读当前句/词音频 | | `Ctrl Q 不熟悉` | **Ctrl+Q** | 标记不熟悉(拆句等模式) | | `Enter / 空格 提交` | **Enter**(部分模式 Space) | 提交作答 | | `↓ ↑ 答案` | **↓ / ↑** | 显示答案 | | `Shift ←→ 切题` | **Shift+← / →** | 上一题/下一题 | | `Ctrl ; 再来一次` | **Ctrl+;** | 清空重练当前题 | | `下一题 >` | 点击 | 下一题 | **推荐抓取/人工复刻工作流(禁止瞎编英文)**: 1. Space(或 ↓)**揭晓答案** → 芯片变为「隐藏答案」。 2. 把揭晓的英文 **原样填入** `word-input` / textarea / `typing-practice-input`。 3. Enter 提交或点下一题。 4. 记录对错反馈(音效、`correct-fx-canvas`、进度 `i/n` 变化、toast)。 5. Shift+→ 或「下一题」继续;Ctrl+; 重练。 材料:`04-game/keyboard-probe.json`、`practice-unstick/*`、`interactions.jsonl`。 ### 5.2 拆句练习作答模型 - 中文提示在上(如「起床啦!早上好。」)。 - 多个空:`input.word-input`,aria/文案「第 N 个单词」。 - 揭晓后下方展示:词(Wake / up / It's / morning)+ IPA + 句法块(「谓语(短语动词)」等)+ 切句 `cardCut`。 - 错答:触发 wrong 音效路径;可「再来一次」。 - 对答:`correct-fx-canvas` 动效 + correct 音效;进度前进。 ### 5.3 整句 / 听写 / 中译英 / 打字 / 拼图 | 模式 | 输入 | 答案来源 | |------|------|----------| | 整句练习 | textarea | Space 揭晓后的整句英文 | | 听写模式 | 听音频后输入 | Space 揭晓;Ctrl+A 可再听 | | 中译英 | 见中文写英文 | Space 揭晓 | | 打字练习 | `typing-practice-input` + 屏幕键盘视觉 | 逐字;Space 显隐答案 | | 拼图模式 | 拖拽/点击词块(待补交互细节) | Space / 答案键 | 父进程 `practice-unstick` 已演示:揭晓 → 填 → 下一题后进度 **1/19 → 2/19**,并切到打字练习 UI(出现字母键与 `Hi!`)。 ### 5.4 答后效应(已观察到) - Toast / 文案:「已重置」等(重置进度时)。 - `correct-fx-canvas` 画布层。 - `/api/sfx` correct/wrong/complete/typing/nav。 - `POST /api/practice/progress`、`POST /api/practice/add-time`、`POST /api/review/wrong-sentences`。 - 进度文案 `练习(i/n)` 或课节标题内 `(1/17)`。 --- ## 6. 数据 API 与字段 统一包络:`{ ok, message, data }`。 ### 6.1 课程 `GET /api/courses` → `data: { items[], total, categories[] }` item:`id, title, category, lessonsCount, learnersCount, visitorsCount, hidden, cover, landscapeCover, editorName, editorColor, heatLevel` `GET /api/courses/:id` → 同上 + `lessons[]`:`{ id, title, durationSec, hidden }` title 常含换行:`Lesson 1: ...\n第一课:...` 封面:`/api/course-covers/...jpg` ### 6.2 练习核心(句子/单词) `GET /api/lesson-sheet?courseId=&lessonId=&practice=split` ``` data.found data.columns: content | translation | cardCut | annotations | voiceUrl | imageUrl data.rows[]: id, content, translation, wordTranslation, ipa, pos, syntax, cardCut, annotations, voiceUrl (/tts/....mp3), imageUrl (/course-images/....webp), rowType ``` Lesson 1 实测 **62 行**:词行 + 句行交错;约 17 行带 `imageUrl`/`cardCut`(整句卡片)。 `cardCut` 例:`/Wake up!/+/It's morning./` `wordTranslation` 例:`醒来+起+是早晨+早晨` 其它: - `GET /api/practice/progress?courseId=&lessonId=` → `{ found, current, total, mode, updatedAt }` - `POST /api/practice/enter` / `progress` / `add-time` - `POST /api/review/wrong-sentences` - `GET /api/practice/full-source` → `{ mode }` - `GET /api/course-always-text?courseId=` → `{ alwaysText: ["TV"] }` - `GET /api/sound-effects` - `GET /api/favorites/course-status`、`POST /api/favorites/courses/:id` - `GET /api/practice/course-status?courseId=` 原始响应:`deep-20261011/03-api-data/`(约 200+ 组)。 --- ## 7. 音频 | 类型 | URL 形态 | 用途 | |------|----------|------| | 句/词 TTS | `/tts/{hash}-....mp3`(挂在 lesson-sheet.voiceUrl) | 朗读、听写 | | 音效 | `/api/sfx/...wav|mp3` | 打字/导航/对/错/完成 | | 配图 | `/course-images/....webp` | 显示图片 | 复刻时:库内存相对路径;静态挂载或代理同源路径。 --- ## 8. 与我方模型的差距 & 复刻建议 | 探趣岛 | 我方 ARCHITECTURE v0.1 | 建议 | |--------|------------------------|------| | lesson-sheet 扁平 rows(词+句混排) | Course→Lesson→Sentence→WordOccurrence | **导入时**把无空格/短 token 当词,带 `cardCut`/多词且有图的当句;或增加 `sheet_rows` 原样表 | | `/app/game` + 多模式 | 单一 practice 页 | 路由对齐 `/practice` 或 `/game`;模式枚举:split/whole/dictation/cn2en/typing/puzzle | | Space 显隐答案 | 未写 | 练习交互必须支持 reveal→fill→submit | | 音效包 | 仅内容音频 | 增加 sfx 五类 | | editorColor / heatLevel | 无 | 广场卡片可加 | | IPA/pos/syntax | 无 | words/sentences 扩展字段 | 像素向 React 要点:深色底 `#070a0f`、Hind 字体栈、12px 圆角 pill、底栏 hk 条、紫返回、蓝填空字、激活蓝光晕。 --- ## 9. 材料索引 | 路径 | 内容 | |------|------| | `deep-20261011/01-plaza/` | 广场截图、inventory、分类过滤 | | `deep-20261011/02-course-detail/` | 详情 | | `deep-20261011/03-practice-*` | 进课尝试 | | `deep-20261011/04-game/` | 练习页主捕获、答题前后图、键盘探测 | | `deep-20261011/03-api-data/` | API JSON | | `deep-20261011/practice-unstick/` | Space/答案→填→下一题过程 | | `deep-20261011/design-tokens.json` | 合并 token | | `deep-20261011/interactions.jsonl` | 交互日志 | | `deep-20261011/SUMMARY.json` | 汇总 | --- ## 10. 阻塞与备注 1. 自动化键盘探测时若焦点不在练习区,Space/方向键可能呈 no-op;**以底栏芯片文案与人工/unstick 流程为准**。 2. 课节点击「付费墙」可能为侧栏「开通会员」文案误判;**继续学习已成功进入 game 并拉到 lesson-sheet**。 3. 拼图模式拖拽细节、听写/中译英每种模式的完整答对/答错分镜,建议在 `practice-unstick` 续跑中补齐截图后追加本报告附录。 4. **禁止用模型翻译填空**;一律 Space/↓ 揭晓后抄写。 ## 输入单词答题实录(2026-10-10T23:35:11.089Z) - 模式优先:打字练习 → 听写 → 中译英 - 流程:Space 显答案 → 向 `input.typing-practice-input`(或可见 input/textarea)逐字输入 → Enter 提交 → Shift+→ 下一题 - 素材目录:`tanqudao-capture/deep-20261011/typing-answer/` - 本轮题数:10 ```json [ { "step": "q1", "progress": [ "1", "19" ], "answer": "Hello!", "typed": "", "feedback": { "correct": false, "wrong": false }, "after": [ "3", "19" ] }, { "step": "q2", "progress": [ "3", "19" ], "answer": "Hello,", "typed": "Hello, ", "feedback": { "correct": false, "wrong": false }, "after": [ "4", "19" ] }, { "step": "q3", "progress": [ "4", "19" ], "answer": "I am", "typed": "", "feedback": { "correct": false, "wrong": false }, "after": [ "5", "19" ] }, { "step": "q4", "progress": [ "5", "19" ], "answer": "Hello,", "typed": "Hello, ", "feedback": { "correct": false, "wrong": false }, "after": [ "6", "19" ] }, { "step": "q5", "progress": [ "6", "19" ], "answer": "Tom!", "typed": "", "feedback": { "correct": false, "wrong": false }, "after": [ "7", "19" ] }, { "step": "q6", "progress": [ "7", "19" ], "answer": "Hello!", "typed": "Hello! ", "feedback": { "correct": false, "wrong": false }, "after": [ "8", "19" ] }, { "step": "q7", "progress": [ "8", "19" ], "answer": "Lucy.", "typed": "", "feedback": { "correct": false, "wrong": false }, "after": [ "9", "19" ] }, { "step": "q8", "progress": [ "9", "19" ], "answer": "Hello,", "typed": "Hello, ", "feedback": { "correct": false, "wrong": false }, "after": [ "10", "19" ] }, { "step": "q9", "progress": [ "10", "19" ], "answer": "Lucy!", "typed": "", "feedback": { "correct": false, "wrong": false }, "after": [ "11", "19" ] }, { "step": "q10", "progress": [ "11", "19" ], "answer": "to meet", "typed": "", "feedback": { "correct": true, "wrong": false }, "after": [ "12", "19" ] } ] ```