# 青禾致知 · 学习工具作品集

课程创意示范，采用虚构创作画像。不是实际学员作品或学习效果证明。

## 打开

八个工具分别使用自己的网址，直接进入对应操作页面。离线使用时，解压并打开需要的工具 HTML 即可，不必先打开目录。每页的 CSS、JavaScript 和运行所需素材均内嵌，不依赖网络字体、接口、数据库或密钥。完整功能不需要登录。

| 文件 | 用途 |
| --- | --- |
| repair.html | 口算重试、记录错题、重新练习 |
| words.html | 根据中文提示回忆指定英文拼写、自定义词库 |
| recite.html | 原文遮挡、首字提示、标记不熟句 |
| fractions.html | 点选等分块、比较大小、探索等值分数 |
| ideas.html | 整理自己的想法并安排成作文提纲 |
| route.html | 按顺序推进放学任务，记录开始、暂存和完成 |
| cases.html | 错题归因、遮住答案重试、对照后自评 |
| reading.html | 在阅读报纸上编辑内容、保存多期并打印 |

## 数据与保存

- 每个工具使用 `qinghe-learning-<name>-v1` 独立本地存储空间。示例只在没有记录时初始化。
- 输入和学习记录留在当前设备、当前浏览器。没有数据上传、统计追踪或儿童身份信息采集。
- 刷新页面会保留已成功写入的记录。清除浏览器数据、换设备或换域名不会同步记录。
- 如果浏览器禁止本地存储、容量不足或隐私模式限制写入，页面会明确提示“本次可用，但无法持久保存”。这时不要依赖刷新保留内容；提纲可下载，阅读小报可打印。
- `file://` 下的存储行为由浏览器决定，长期使用建议访问已部署 HTTPS 地址。浏览器与域名之间的数据不会自动迁移。
- “恢复示例”会在确认后覆盖该工具的数据。不会改变其他工具。
- 口算“开启新一轮”只清空本轮记录，保留待修理题目。单词“全部重新晾上”保留词库并重置本轮状态。背诵“重新开始”保留不熟句标记。

## 学习边界

数学依据确定性运算；分数用整数交叉相乘判断，分母为 1～12。单词忽略大小写和首尾空格，只检查指定词的拼写，不是开放翻译评分。背诵不做语音识别或自动评分。任务完成由使用者自己标记，剩余预计用时不是计时器或预测。错题由使用者自行核对、自评，不自动判断开放题。作文和阅读内容由使用者填写，没有自动编造作文、书籍信息或引文。

## 示例与限制

背诵示例《雨后的院子》和阅读示例《留一盏灯》是本课程原创练习短文；点子地图中的场景为虚构练习内容。示例没有冒充教材、名家文章或真实经历。

单词每组最多 12 个；原文最多 10,000 字；地图最多 80 个想法；路线最多 24 站，单站预计 1～240 分钟；错题最多 100 份；阅读小报最多 50 期。超长阅读内容可能打印多页，浏览器的纸张、缩放与页眉页脚设置会影响最终版面。复制提纲在权限受限时回退为可手动复制的文本框。全部输入按文本展示，不作为 HTML 执行。

## 文件

- `design-briefs.md`：八种独立创作方向。
- `demo-scripts.md`：每个作品约 20～30 秒的演示操作。
- `qa-report.md`：实际验收范围与限制。
- `screenshots/`：实际浏览器截图及作品对比图。
- `DEPLOYMENT.md`：ECS 子域名与部署方式。

开发用的 `authoring/`、`qa/`、`deploy/` 保留在源工程中，不包含在离线作品包，也不部署到公网；它们不属于独立 HTML 的运行依赖。解压后的离线目录隐藏“下载完整作品包”链接，因为你已持有该作品包。

任务路线使用的原创生成插画以 data URI 保存在 HTML 内，离线包无需另存图片。原始素材与提示词留在源工程 `assets/route/` 和 `output/agent-reviews/route/`；作品展示截图均来自真实运行页面。
