从对话到公网学习站

这套流程解决的是一个简单但容易半途而废的问题：把与 Codex 的学习对话，变成自己能持续阅读、补充、分享的公开材料，而不是散落在聊天记录里。

最终结果

学习对话
  -> 提炼为 Markdown
  -> 按主题放入仓库
  -> VitePress 构建为静态网站
  -> Cloudflare Pages 免费部署
  -> 获得可公开访问的网址

公开站点地址：https://industry-research-os.pages.dev/

1. 把对话沉淀成材料

不要把整段聊天记录直接保存。每次学完一个主题，只留下未来还能复用的内容：

1. 一句话结论：这个行业或问题的本质是什么。
2. 机制：钱从哪里来、成本如何发生、失败会发生在哪里。
3. 案例：用一个公司、门店或项目验证机制。
4. 检查清单：下一次遇到类似问题时该问什么。

本仓库按用途组织：

目录	放什么
framework/	可重复使用的分析框架、术语和速查卡
industries/	某个行业的完整学习材料
cases/	公司、赛道或周期的具体案例
comparisons/	两种商业模式的对照练习
daily/	每日学习过程、练习与复盘

一个材料只要先是普通 Markdown 即可，例如 industries/milk-tea.md。网站会自动把它构建为可访问页面。

2. 在材料之间建立关联

学习材料不是孤立文章。每日练习应该能跳回对应的行业正文和速查卡。

在 Markdown 中用下面的写法记录材料路径：

- `industries/milk-tea.md`
- `framework/store-unit-economics-card.md`

本站的构建配置会把 framework/、industries/、cases/、comparisons/ 下的这类路径自动转为可点击链接。所有材料也集中列在全部材料页，并出现在左侧导航。

3. 本地预览与构建

首次使用时安装依赖：

make install

写材料时启动本地预览：

make dev

浏览器会显示本地网址。确认页面、链接和排版没有问题后，构建生产文件：

make build

构建结果位于 .vitepress/dist/。这个目录是静态 HTML、CSS 和 JavaScript，可以放到任何静态托管平台；这里选择 Cloudflare Pages。

4. 配置 Cloudflare Pages

Cloudflare Pages 适合本仓库，因为材料不需要数据库、登录或后端计算。它提供免费的静态托管、HTTPS 和全球 CDN。

本地发布依赖 wrangler，已通过 package.json 安装；不需要全局安装 CLI。发布身份由环境变量 CLOUDFLARE_API_TOKEN 提供。

令牌只保存在本机的 .cloudflare.env：

CLOUDFLARE_API_TOKEN := your-token

这个文件已经被 .gitignore 忽略，且应该保持仅当前用户可读。令牌不能写进 Markdown、截图、Git 提交或公开网页。令牌曾出现在不可信位置时，应立刻在 Cloudflare 撤销并重新签发。

验证本机是否有权限：

make pages-verify
make pages-whoami

5. 第一次发布

先创建一次 Pages 项目：

make pages-create

默认项目名是 industry-research-os。需要改名时可以覆盖：

make pages-create PAGES_PROJECT=my-learning-site

然后发布：

make deploy

该命令会依次构建网站、上传 .vitepress/dist/ 并将其发布到 Cloudflare Pages。完成后 Wrangler 会返回一个 pages.dev 预览地址；生产地址是：

https://<项目名>.pages.dev/

6. 日常更新：一条命令

之后的工作流只有三步：

1. 把新的学习结论写进对应 Markdown。
2. 本地用 make dev 查看需要修改的地方。
3. 运行 make deploy。

部署记录可通过下面命令查看：

make pages-deployments

7. 发布前检查清单

• 新材料是否放在正确目录，并有明确标题。
• 提到的相关材料是否能从左侧导航、全部材料或正文链接找到。
• make build 是否成功。
• .cloudflare.env 是否仍被忽略，且没有出现在材料或提交中。
• 公网网址打开后，首页和新页面是否都能显示。

这个流程可以迁移到哪里

它并不限于行业学习。读书笔记、产品研究、项目复盘、课程资料、团队手册，都可以采用同一模式：先用 Markdown 保留可维护的源材料，再构建为可分享的公开站点。