docs: refine growth next steps (#4331)

* docs: refine growth next steps

* docs: add NotionComments Netlify 404 check

Author: tangly1024

docs/developer/GROWTH_ROADMAP.zh-CN.md

@@ -111,3 +111,14 @@ NotionNext 的增长不应先依赖复杂平台能力。更短路径是把现有
 5. 把 Showcase 加到 README、文档首页和 VitePress 导航。
 
 每一步都可以单独提交和回滚，不依赖大改版。
+
+## 下一轮执行清单
+
+当前进入 Phase 3/4 的小步推进，不新增后台，也不一次性补齐所有模板。
+
+| 优先级 | 任务 | 验收 |
+| --- | --- | --- |
+| P0 | 明确模板页的内容源边界 | 新用户能知道 NotionNext 用 Notion 写内容，GitHub 只负责代码和部署 |
+| P1 | 先补博客和知识库两条模板路线 | 每条路线说明适合谁、先改哪几处、推荐主题 |
+| P1 | 从最近 Issue / Discussion 抽 3 个重复新手问题 | 每个问题能指向已有文档，或生成一个可拆的小文档任务 |
+| P2 | 继续收集 Showcase 站点 | 累计 3-5 个真实站点后，再反向完善模板示例 |

docs/user-guide/comments/notion-comments.md

@@ -251,6 +251,19 @@ NotionComments 需要 `/api/notion-comments` 服务端接口来读取和写入 N
 - 数据库字段名称和类型是否与文档表格一致。
 - 如果开启了审核，`Status` 是否已经改成 `Approved`。
 
+### Netlify 部署后接口 404
+
+先直接访问：
+
+```text
+https://你的域名/api/notion-comments?postId=test
+```
+
+- 返回 `[]` 或 `500`：说明 API Route 已部署成功，再检查 Notion Token、数据库 ID、共享权限和字段。
+- 返回 `404`：说明请求还没有进入 NotionComments 接口，优先检查 Netlify 是否启用了 Next.js API Routes，不要使用 `yarn export`，也不要把发布目录设成 `out`。
+
+Netlify 项目应使用 Next.js 动态部署能力；构建日志里需要能看到 Next.js 插件和 Functions / API Routes 相关输出。
+
 ### 评论能写入，但页面不显示
 
 检查 `PostId` 是否等于当前文章页面 ID。手动改数据库内容时，不要修改 `PostId`、`ParentId` 和 `Level`。

docs/user-guide/templates.md

@@ -22,4 +22,34 @@
 4. 只修改站点名称、菜单、首页说明和 3-5 篇示例内容。
 5. 上线后把站点提交到 [用户作品墙](./showcase.md)。
 
+## 内容源说明
+
+NotionNext 的内容源是 Notion。文章、页面和菜单先在 Notion 模板里维护，GitHub 仓库主要负责代码、配置和部署。
+
+如果你的目标是直接在 GitHub 里写 Markdown 文章，NotionNext 不是最短路径；这种需求更适合 GitHub Pages 或其他 Markdown 博客。
+
+## 个人博客路线
+
+适合：个人写作、技术笔记、生活记录和长期内容沉淀。
+
+先改这几处：
+
+- 站点标题、作者名和头像。
+- 首页菜单，只保留首页、归档、分类、关于。
+- 3-5 篇示例文章，覆盖你的主要写作方向。
+
+推荐主题：`simple` 适合快速上线，`hexo` 和 `next` 适合更传统的博客样式。
+
+## 知识库路线
+
+适合：教程文档、学习笔记、项目手册和产品帮助中心。
+
+先改这几处：
+
+- 菜单层级，先控制在 2-3 层。
+- 首页说明，写清楚这个知识库解决什么问题。
+- 文档分类，每类先放 2-3 篇核心页面。
+
+推荐主题：`gitbook` 适合文档目录，`claude` 适合更轻的知识整理。
+
 先不要一次打开所有插件。评论、统计、搜索、广告、邮件订阅都可以等站点跑通后再补。