AI 测试开发学习站部署规划
日期：2026-09-08 状态：已上线 / Codex 独立验收 PASS
正式访问地址：https://ai-study.xhscopy.top/
1. 这份规划解决什么问题
这份规划用于说明学习站如何承载学习路线、章节卡片、项目复盘和公众号素材，同时保证学习过程中的草稿和真实项目资料不被公开。
学习站的定位是：
- 一个公开的 AI 测试开发学习演示站。
- 一个可持续更新的学习成果展示入口。
- 一个把章节学习转化为提示词、用例、脚本和验收表的展示载体。
它不是课程原文镜像，不是生产系统，也不承载登录、支付、数据库或真实项目后台。
2. 当前状态
当前版本已经完成独立子域名部署和公网验收：
| 项目 | 状态 |
|---|---|
| 公网地址 | https://ai-study.xhscopy.top/ |
| 访问方式 | 公开访问，无需登录 |
| 页面服务 | HTTPS 正常，HTTP 自动跳转 HTTPS |
| 内容形态 | 脱敏后的静态学习成果 |
| 更新方式 | 本地整理后生成静态页面，再进行增量发布 |
| 验收状态 | PASS |
详细上线证据保留在本地工程记录中，公开页面不展示服务器 IP、内部目录、证书文件路径或运维命令。
3. 推荐架构
本地学习源
↓
章节辅助卡 / 章节考核卡
↓
脱敏与公开性检查
↓
静态学习演示站
↓
公开访问与持续迭代这个架构的核心是“先在自己的学习环境中形成成果，再发布可公开版本”，而不是把全部学习过程直接暴露到网站。
4. 两类内容区域
公开演示区
公开演示区面向自己复习和访客浏览，只放：
- 学习路线和时间分配。
- 学习辅助流程和空白模板。
- 脱敏后的章节考核标准。
- 通用提示词、测试用例、脚本和验收表。
- 不含敏感细节的失败复盘和公众号选题框架。
私有学习区
私有学习区用于保存：
- 尚未整理的学习草稿。
- 含真实项目背景的章节卡。
- 未脱敏失败样本、日志和截图。
- 临时实验、构建文件和内部复盘。
私有学习区不通过公开网页访问。需要查看时使用本地文件、受控的远程连接或其他私有方式，不用“隐藏 URL”代替访问控制。
5. 内容公开边界
可以公开
- 自己编写的学习总结。
- 通用方法和空白模板。
- 脱敏后的测试问题与解决思路。
- 已确认可以公开的项目经验结构。
- 自己原创的公众号踩坑总结。
默认不公开
- 课程付费正文或大段转载内容。
- 账号、邮箱、手机号、密码、密钥、Token、Cookie 和 Session。
- 订单、支付、客户和真实业务数据。
- 未脱敏的后台截图、日志和服务器信息。
- 主产品的内部代码、配置和构建文件。
- 未经授权的图片、字体、音乐、视频或其他素材。
- 尚未验证却写成“已经验证有效”的结论。
发布前自问
- 这段内容是不是我自己的表达或已获授权的内容？
- 删除项目名称、账号、路径、日志和截图后，是否仍能说明方法？
- 访客能否从页面反推出真实项目、客户或服务器信息？
- 失败样本是否已经脱敏，并且没有暴露可利用的凭证或业务数据？
任何一项不能确认，就先留在私有学习区。
6. 学习内容如何进入网站
每一章按以下链路整理：
- 查看章节在整体路线中的位置。
- 学习课程，只记录和自己项目有关的要点。
- 填写单章学习辅助卡。
- 把暂时解决不了的问题放入卡点停车场，不阻塞主线。
- 按四项考核形成章节卡片。
- 对真实踩坑做脱敏，合适时转为公众号素材。
- 通过公开性检查后，更新网站页面。
每章的通过标准是：
- 讲清本章解决的测试问题。
- 找到一个自己的项目应用场景。
- 产出至少一项可复用资产。
- 记录一个失败样本和修正方式。
7. 发布与更新流程
内容更新前
- 在本地修改源文件。
- 检查 Markdown 链接和页面导航。
- 删除或替换敏感内容。
- 执行本地验证脚本：
python3 scripts/validate_ai_study.py验证失败时不发布，先修复失败项。
增量发布
将本次新增或修改的公开文件列表交给 Kimi。Kimi 只做已经通过本地检查的静态产物增量部署，不做范围外重构；部署提示词、服务器读回、验收证据和内部路径不进入公开站。
发布后验收
Kimi 返回读回报告后，由 Codex 独立检查：
- 正式地址和 HTTPS 是否正常。
- 页面标题、导航和关键链接是否正确。
- 是否仍是脱敏后的静态内容。
- 是否错误暴露隐藏文件、目录列表或私有学习区。
- 是否影响其他网站或主产品。
只有 Codex 判定 PASS，才登记新的正式发布记录。
8. 迭代阶段
当前阶段：静态公开演示
当前采用静态页面，重点是稳定学习和持续沉淀：
- 每章形成一张学习辅助卡和一张考核卡。
- 每周更新学习进度和卡点。
- 从真实失败中筛选公众号素材。
- 每次发布都保留版本和验收记录。
后续阶段：增强阅读体验
当内容量明显增加后，再考虑：
- 更清晰的章节导航。
- 页面搜索和标签筛选。
- 按学习状态查看卡片。
- 更方便的静态构建和预览流程。
这些增强仍优先采用静态生成方式，不因为增加搜索或导航就直接引入数据库、账号系统或在线编辑后台。
暂不做：全栈动态系统
除非出现明确的在线编辑、多人协作或数据统计需求，否则暂不增加：
- 注册登录。
- 数据库。
- 在线编辑。
- 支付和用户订阅。
- 主产品 API 或埋点。
这样可以把时间用于学习和项目实操，而不是维护一套与目标无关的后台系统。
9. 常见异常处理
本机打不开，但 DNS 检测显示正常
可能是本机代理、TUN 或 fake-IP 影响解析。先用其他干净网络确认，再判断是否是网站故障。验收时记录目标 IP、HTTP 状态、TLS 状态和页面标题。
想把私有内容临时放到网站
不要直接上传。先复制到公开候选区，完成脱敏和公开性检查，再生成静态页面。
某一章卡住很久
将问题写入卡点停车场，保留当前理解和下一步验证动作，继续主线学习。卡点解决后再回填章节卡，不让局部问题拖慢整体进度。
10. 当前有效结论
- 学习站已部署在独立子域名，当前正式地址是
https://ai-study.xhscopy.top/。 - 站点公开访问，不需要用户账号或
guest登录。 - 公开站只展示脱敏静态学习成果。
- 私有练习、真实项目资料和内部运维信息不进入公开页面。
- 后续内容更新遵循“本地整理 -> 本地验证 -> 增量发布 -> Codex 验收 -> 版本记录”的闭环。