先把读者的问题排好顺序

首页回答“这里解决什么问题、有什么可看”;案例回答“实际完成了什么”;方法回答“怎样做、为什么这样做”;工作流回答“需要什么输入、会得到什么、什么时候适用”。同一个项目不需要在每页重讲一遍。

一条记录保留什么

  1. 给内容一个稳定ID,记录标题、摘要、类型、状态与实际更新日期。
  2. 写明来源和验证范围,再分段记录问题、步骤、判断与局限。
  3. 用关联ID连接案例、制作过程和工作流,避免重复复制正文。
  4. 只有拿到真实截图、成片或公开资源时才加媒体和获取链接;标题不能代替成果证据。

在本站怎样复现

当前记录位于 apps/web/app/data/public-content.ts。复制对应类型的记录,给出唯一ID,按实际情况填写state、source和verification;related只填写目录中存在的ID。重新构建后检查列表、详情和关联入口,再公开发布。

本页与“灵匠集网站”案例、任务验收方法共享目录,但使用不同的说明重点。下面的相关内容就是这条路径的实际入口。

为什么先不用复杂后台

当前公开内容数量少,一份类型明确的文件更容易维护来源和关联。代价是内容更新仍需要编辑文件、检查和构建。多人高频发布或媒体数量明显增长后,再评估编辑后台与媒体管理,不将尚未实现的能力写进当前介绍。