# 24 - Notion 与 Cloudflare 共享链路经验沉淀

更新时间：2026-05-29 Asia/Shanghai

## 1. 阶段突破

本阶段完成了从“本地研究沉淀”到“可共享研究系统”的第一次闭环。

```text
本地 Markdown/HTML -> site 发布包 -> Cloudflare Pages -> Notion 伙伴入口
```

这意味着项目不再只是个人本地资料，而是可以低摩擦同步给创业伙伴的研究系统。

## 2. 最终角色分工

| 层级 | 工具 | 角色 | 不做什么 |
|---|---|---|---|
| Source of Truth | 本地 Markdown/HTML | 保存完整研究、证据、决策、专题页 | 不直接给非技术伙伴阅读 |
| Partner Portal | Notion | 伙伴入口、讨论、索引、分工、阶段结论 | 不作为唯一源仓库 |
| HTML Reading Layer | Cloudflare Pages | 发布图谱、专题 HTML、交互阅读页 | 不放敏感资料 |
| Research Copilot | NotebookLM，待启用 | 基于资料问答、FAQ、学习消化 | 不作为主编辑空间 |

## 3. 已验证的实践

### Notion 适合做共享入口

Notion 的价值不是替代本地知识库，而是降低伙伴进入项目的认知门槛。

适合放：

- 项目主线
- 阶段性结论
- 研究共享索引
- 待验证问题
- 伙伴分工
- Cloudflare Pages 链接
- 讨论入口

不适合放：

- 全量源文档
- 复杂 HTML/JS 交互页
- 敏感账户资料
- 原始密钥、证件、后台截图

### Cloudflare Pages 适合发布 HTML 阅读层

Cloudflare Pages 解决的是 Notion 不能很好承载 HTML/CSS/JS 交互页面的问题。

适合发布：

- Cytoscape 项目知识图谱
- 支付习惯数据地图
- 支付接入商对比
- 美国公司决策树
- 营业额梯度模型
- 共享策略说明页

不适合发布：

- Markdown 源仓库全量内容
- 公司资料
- 支付账户后台
- 供应链资源
- 未公开商品方向
- 利润和资金流水

## 4. 关键工程决策

### 使用 `site/` 白名单发布目录

不发布项目根目录，只发布明确筛选后的 HTML。

原因：

- 避免误发布敏感资料。
- 避免把源仓库和草稿暴露到公网。
- 让发布内容可控。
- 方便后续做链接治理和静态站优化。

### 发布 URL 使用英文 slug

源文件可以中文命名，发布文件使用英文 slug。

例子：

```text
美国公司设立与税务预检.html -> us-company-tax-precheck.html
营业额梯度触发权重模型.html -> revenue-trigger-model.html
```

原因：

- 公网 URL 更稳定。
- Notion 粘贴更清晰。
- 伙伴转发更少乱码。
- 未来接自定义域名更自然。

### 暂不使用自定义域名

当前使用：

```text
https://ecommerce-research-portal.pages.dev/
```

原因：

- 当前目标是验证共享层，而不是品牌化。
- 自定义域名会引入 DNS、命名、权限、品牌判断等额外复杂度。
- `*.pages.dev` 已足够支持 1-2 位可信伙伴试运行。

## 5. 部署经验

### Wrangler 部署链路

最终可行路径：

```text
.cloudflare-pages.env -> scripts/build-cloudflare-pages-site.sh -> scripts/deploy-cloudflare-pages.sh -> Wrangler -> Cloudflare Pages
```

### 环境变量经验

在另一个终端中 `export` 的变量，Codex 这里通常读不到。

因此采用本地私密文件：

```text
.cloudflare-pages.env
```

该文件已被 `.gitignore` 忽略，不进入共享和提交。

### 项目不存在时要先创建

第一次部署遇到：

```text
Project not found
```

解决方式：

```bash
npx wrangler pages project create ecommerce-research-portal --production-branch main
```

然后再部署：

```bash
scripts/deploy-cloudflare-pages.sh
```

## 6. 当前已上线链接

- 生产入口：https://ecommerce-research-portal.pages.dev/
- 本次部署预览：https://f21d3df9.ecommerce-research-portal.pages.dev

常用页面：

- 项目知识图谱：https://ecommerce-research-portal.pages.dev/research-atlas-cytoscape.html
- 支付习惯地图：https://ecommerce-research-portal.pages.dev/payment-habit-data-map.html
- 支付接入商对比：https://ecommerce-research-portal.pages.dev/payment-provider-benchmark.html
- 美国公司预检：https://ecommerce-research-portal.pages.dev/us-company-tax-precheck.html
- 美国公司决策树：https://ecommerce-research-portal.pages.dev/us-company-decision-tree.html
- 营业额梯度模型：https://ecommerce-research-portal.pages.dev/revenue-trigger-model.html

## 7. 共享系统准则

### 准则一：共享层不等于源仓库

Notion 和 Cloudflare Pages 是为了传播和协作，不替代本地源仓库。

### 准则二：先可用，再优雅

先用 `*.pages.dev` 跑通，不急着自定义域名。

### 准则三：先白名单发布，再考虑自动化

只把明确可共享内容复制到 `site/`。

### 准则四：敏感内容默认不发布

所有账户、公司、财务、供应链、商品机会都默认不进入 `site/`。

### 准则五：Notion 负责讨论，Pages 负责阅读

伙伴讨论、评论、分工在 Notion；长图谱、交互页、专题阅读在 Pages。

## 8. 后续演进路径

### 短期

- 使用 Notion + Pages 分享给 1-2 位可信伙伴。
- 收集伙伴是否能快速理解主线。
- 观察 HTML 页面是否真的提升阅读效率。

### 中期

- 如果更新频率变高，接 GitHub/GitLab + Cloudflare Pages Git integration。
- 如果伙伴数量增加，考虑访问控制或 Cloudflare Access。
- 如果共享对象变成外部公开读者，再考虑自定义域名。

### 长期

- Notion 保留为协作层。
- Cloudflare Pages 成为研究展示站。
- NotebookLM 作为新伙伴 onboarding 和资料问答助手。
- 本地 Markdown/HTML 继续作为项目知识母本。