方向选择 公开笔记
不要一开始就做会员、支付和数据库
普通人做 AI 项目第一阶段最容易犯的错误：先冲会员系统、支付和数据库，把项目从验证拖进维护。
- 为什么发生
- 很多人把“做网站”等同于注册登录付费系统，而非先验证内容和方法。
- 更稳做法
- 第一阶段做公开内容站，先验证产出质量，再考虑补充会员支付。
Field Notes
避坑笔记
记录真实项目中交过的学费。重点记录盲目扩张、盲目信任模型、过度设计和发布前检查不足等反模式。
AI 协作边界 公开笔记
不要把 Codex 当成最终决策者
Codex 是执行者，不是老板或产品经理。用户定方向，Codex 做工程，最终验收责任在人。
- 为什么发生
- Codex 代码能力强，用户容易下意识把它当全栈工程师用，而忘记判断边界。
- 更稳做法
- 人定方向 → AI 做规划 → Codex 做工程，用任务分级控制不同风险。
发布纪律 公开笔记
不要写完 Markdown 就直接发布
写完 Markdown 只是内容完成，不等于发布完成。发布前必须检查 frontmatter、build、预览和 SEO。
- 为什么发生
- AI 写完 Markdown 后容易产生“已经完成”的错觉，忽略发布前验证步骤。
- 更稳做法
- 走完整本地发布流程：确认类型、检查 frontmatter、build、预览、记录状态。
工作节奏 公开笔记
不要在疲劳状态下做大重构
AI 能加快开发，但人越累越容易出错。疲劳时适合收口检查，不适合大重构和高风险改动。
- 为什么发生
- AI 输出快，人容易越做越上头，忽略疲劳状态下判断力下降的事实。
- 更稳做法
- 晚上最后一段工作时间留给收口检查，大重构放在清醒时并做好备份和任务分级。
内容边界 公开笔记
不要让内部文档进入公开路由
静态站中 src/pages 下的任何文件都可能成为公开页面。内部文档、备份、草稿必须放在公开路由之外。
- 为什么发生
- 新手容易把草稿、笔记随手放进 pages 目录，认为“别人不知道 URL”就安全。
- 更稳做法
- 内部文档放 docs/ 或 file_backups/，不在 Astro 构建范围内，发布前检查 sitemap 和构建输出。
页面检查 公开笔记
不要只看首页就认为网站正常
首页能打开只说明首页正常，更要检查文章、方法、模板、笔记、法律页、sitemap 和 OG 图。
- 为什么发生
- 部署后习惯只看首页一眼，深层页面可能 404 或 SEO 不一致，但不会在首页暴露。
- 更稳做法
- 上线前后至少抽查 10 个不同类型 URL，覆盖栏目页、详情页、法律页、sitemap 和 OG 图。
Git 初始化 公开
不要在错误目录初始化 Git 仓库
遇到的问题：在 C:\Users\AS 或 apps/web 里执行 git init，导致根目录关键文档没进仓库。
- 为什么发生
- 习惯在当前终端目录直接执行 git init，没有先检查自己在哪个目录。
- 更稳做法
- 先 cd 到项目根目录，确认 README 和 .gitignore 已准备，再 git init。
Git 提交 公开
不要把 node_modules 和 dist 提交到 GitHub
遇到的问题：git add . 之后发现提交了几百 MB 的 node_modules 或构建输出。
- 为什么发生
- .gitignore 不存在或不完整，git add . 把所有文件都加入暂存区。
- 更稳做法
- 用 .gitignore 排除 node_modules、dist、.astro 和日志，git add 前先 git status。
域名与 SEO 公开
不要部署成功后忘记绑定域名和检查 sitemap
遇到的问题：部署平台显示成功，但正式域名没绑定、sitemap 还是临时域名。
- 为什么发生
- 看到部署平台自动生成的临时域名能打开，就以为上线完成了。
- 更稳做法
- 部署后绑定正式域名、检查 HTTPS、sitemap 和 robots，走上线后检查流程。
项目失控 已有实践
AI 项目越做越乱怎么办
遇到的问题：文件越来越多，任务状态和下一步逐渐不可见。
- 为什么发生
- AI 连续执行修改，但项目缺少统一状态和只读检查。
- 解决方向
- 建立状态脚本、明确边界，并定期检查正式内容目录。
修改越界 已有实践
Codex 乱改文件怎么办
遇到的问题：工程任务影响了无关文件，或做了任务书之外的修改。
- 为什么发生
- 允许范围、禁止范围和验收条件没有写清楚。
- 解决方向
- 使用文件清单、禁止事项、哈希或差异核对控制范围。
终端编码 待整理
PowerShell 中文乱码
遇到的问题：终端、脚本输出或读取文件时中文显示异常。
- 为什么发生
- 终端代码页、脚本编码和文件编码不一致。
- 解决方向
- 区分显示乱码与文件损坏，记录 UTF-8 读取和输出检查顺序。
文档渲染 待整理
Markdown / PDF 中文乱码
遇到的问题：源文件正常，但预览、转换或导出的中文异常。
- 为什么发生
- 可能来自源文件编码、字体缺失或渲染工具配置。
- 解决方向
- 分层检查编码、字体和渲染链路，避免直接重写内容。
内容污染 已有实践
newtype-os 输出不能整体发布
遇到的问题：标题候选、标签建议和人工确认事项混入正式正文。
- 为什么发生
- 把内容生产工具的完整输出误当成最终文章。
- 解决方向
- 人工确认正文范围，再由 Codex 创建正式 posts 文件。
目录纪律 已有实践
content/posts 不要放草稿和备份
遇到的问题：草稿和 backup 文件被内容集合识别成正式文章。
- 为什么发生
- 为了就近保存临时文件，忽略了 posts 是正式发布目录。
- 解决方向
- 草稿和备份放到独立目录，并检查 backup / before_task 数量。
本地构建 已有实践
本地 dev / build 常见问题
遇到的问题：开发页面可见，但静态构建失败或路由结果不同。
- 为什么发生
- 开发服务器、内容同步、静态生成和缓存处于不同阶段。
- 解决方向
- 先看构建日志，再核对路由、内容集合和生成产物。
网络环境 待整理
代理和下载慢问题
遇到的问题：依赖安装、工具下载或外部请求速度不稳定。
- 为什么发生
- 代理、镜像、DNS 和本地网络环境可能同时影响结果。
- 解决方向
- 按网络、代理、源和缓存顺序排查，避免反复删除依赖。