基于真实对话整理的 EmDash CMS 用户文档
将反复出现的用户问题映射到长文文档与 FAQ 条目，并记录发布优先级与编辑标准。
本页用途
本页记录如何把重复的支持对话沉淀为可长期维护的文档资产。
让文档策略锚定在已观察到的用户摩擦上，而非内部臆测。
痛点来源与文档落位
痛点 1：「空 EmDash 项目该怎么起手？」
观察到的模式： 用户在写代码前就要文件夹规划，并需要前置的架构取舍说明。
落位： docs/docs 中的长文指南，因为答案需要顺序、理由与反模式分析。
对应页面：
docs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx
痛点 2：「能否部署到 Cloudflare 免费套餐？具体会坏在哪里？」
观察到的模式： 用户能部分部署成功，但在功能边界与计费文案理解上失败。
落位： 在 docs/docs 与 docs/faq 之间拆分：
- 部署运行手册属于长文文档
- 计费与边界澄清属于 FAQ
对应页面：
docs/docs/emdash-cms-cloudflare-free-tier-production-playbook.mdxdocs/faq/emdash-cms-cloudflare-pricing-and-billing-faq.mdxdocs/faq/emdash-cms-cloudflare-free-plan-limitations-faq.mdx
痛点 3：「这些命令该在哪里跑？」
观察到的模式： 命令本身往往没错，但工作目录上下文错误。
落位： FAQ，用户需要快速诊断与短决策规则。
对应页面：
docs/faq/emdash-cms-deployment-command-context-faq.mdx
痛点 4：「如何确认部署真的完成了？」
观察到的模式： 用户停在路由可达，遗漏管理端与数据路径校验。
落位： FAQ，采用清单格式与快速分诊顺序。
对应页面：
docs/faq/emdash-cms-deployment-verification-and-first-login-faq.mdx
痛点 5：「Dynamic Workers 到底是干什么的？」
观察到的模式： 功能名听得懂，安全边界含义不清楚。
落位： docs/docs 中的架构说明，这是模型解释，不是一句话 FAQ。
对应页面：
docs/docs/emdash-cms-plugin-runtime-and-security-model.mdx
发布顺序与理由
建议发布顺序：
docs/faq/emdash-cms-cloudflare-pricing-and-billing-faq.mdxdocs/docs/emdash-cms-cloudflare-free-tier-production-playbook.mdxdocs/faq/emdash-cms-cloudflare-free-plan-limitations-faq.mdxdocs/docs/emdash-cms-project-bootstrap-and-directory-layout.mdx- 其余架构与自托管参考
排序原则：
- 先发布困惑度最高、支持负载最重的话题
- 再发布完整执行指南
- 最后发布深度架构参考
保持文档可信的编辑规则
后续增补请遵循：
- 先写决策与边界，再写机制
- 每项操作包含成功信号与失败信号
- 每个高影响步骤提供回滚或兜底路径
- 避免空洞形容词，除非绑定可衡量标准
- 面向时间压力下的运维人员写，而非营销口吻
维护节奏
每月用三类输入复核本映射：
- 支持中重复最多的问题
- 用户报告中的失败部署模式
- 高跳出、低完成反馈的文档页
若某问题在一个月内支持中出现超过两次，要么改进现有页面的诊断，要么新增针对性 FAQ。