构建雅思学习工作室
为当前学习者创建一个完整、可用的学习站点。将任何现有的雅思网站仅作为行为参考。切勿复制其他学习者的 Drive URL、文档、日期、主题、保存点、收藏夹、错误或部署身份。
从学习者开始
在一组最多三个问题中,收集仅缺失的决策:
- 询问学习者的 Google Drive 文件夹 URL,或是否从本地上传/手动粘贴开始。
- 确认学习类别和启用的模式。默认为听力、阅读、口语、写作、笔记、闪卡、中译英测试、收藏夹和错误笔记本。
- 确认存储预期:默认为设备本地持久化,或在明确请求时使用经过身份验证的跨设备持久化。
当请求已回答这些问题时立即继续。在生成可用的第一个屏幕之前,不需要示例文档。
在实施之前,请阅读 product-contract.md。在配置 Drive、持久化、共享或部署时,请阅读 customization-and-privacy.md。使用 acceptance-tests.md 进行最终验证。
构建工作流
- 检查工作区并保留其框架和设计约定。当
.openai/hosting.json存在时,使用 Sites 构建和托管工作流。 - 创建一个首次运行设置,用于存储当前学习者的文件夹 URL 和偏好。不要将参考学习者的值硬编码为默认值。
- 在打磨次要 UI 之前实施摄入管道:
- 列出学习者 Drive 文件夹中的支持文件;
- 解析 DOCX 的黄色高亮和修订跟踪,不限制数量;
- 从 PDF 中提取工作表词汇;
- 当没有高亮或更正时,从普通文本中提取有价值的语言;
- 为文件创建指纹,以便添加、编辑和删除能干净地更新站点。
- 在提取的每个知识点到达笔记、卡片或测试之前进行标准化:
- 使用可复用的词元或词典形式;
- 除非语法要求复数,否则使用单数名词;
- 保留被动分词,例如
be accompanied by; - 保留所需的动名词,例如
prevent someone from doing something; - 将依赖介词和完整搭配保持在一起;
- 将包含多个可学习单词或搭配的句子拆分为单独的知识点;
- 排除名称、格式垃圾和低价值更正。
- 为每个接受的知识点补充准确的中文含义、用法、示例、发音、搭配、来源句子、日期、主题以及一个或多个雅思类别。当丰富失败时,切勿显示占位符解释;重试或标记该项目以供审查。
- 当相同的表达出现在多个类别中时,保留一个逻辑知识点,但在每个适用的类别中显示它。
- 构建完整的学习循环:笔记本、学习卡片、语音播放、收藏夹、限定范围测试、提示、三次错误后揭示、持久化错误笔记本以及每日/主题存档。
- 持久化学习者状态。设备本地存储必须能在刷新和浏览器退出后存活。仅当用户请求基于帐户或跨设备行为时,才使用服务器持久化。
- 验证 acceptance-tests.md 中的行为,成功构建,并私有发布,除非学习者明确选择另一种访问模式。
适配规则
- 允许学习者更改标签、启用的类别、主题命名约定、测试范围以及视觉方向,而不会削弱提取的正确性。
- 从文件名和文档标题推断日期、主题和类别。当推断不明确时,提供可编辑的回退选项。
- 偏好安静、专注工作型的界面,适合日常重复。保持控件紧凑且响应迅速;不要将产品变成营销登录页面。
- 当学习者尚未拥有 Drive 文件夹时,保持上传和粘贴文本的完全可用性,并将 Drive 连接作为可选的下一步。
- 诚实地解释公共链接的限制。公共 Drive 文件夹 MVP 不等同于私有 OAuth 访问。
完成标准
以学习者的独立站点 URL 和已启用功能的简要总结结束。坦率说明任何不可用的集成。不要暴露源凭据、内部项目 ID、参考学习者数据或部署内部信息。