通用数字产品网站产品需求文档 PRD

PRODUCT REQUIREMENTS DOCUMENT · PRD

规范MDv1.0

**通用数字产品**

网站产品需求文档

PRODUCT REQUIREMENTS DOCUMENT · PRD

不是技术展，是普通人与 AI 共同施工的真实档案。

项目字段	内容
产品名称	通用数字产品正式网站
站点域名	https://www.通用数字产品.com/
文档版本	V1.0
文档状态	正式基线版 / 可进入设计与开发评审
编制日期	2026-08-05
适用范围	公开网站、内容发布、页面设计、前端开发、测试、部署与后续迭代
主要读者	产品负责人、设计师、Codex/示例用户等 AI 协作者、开发、测试、运维

文档定位本 PRD 是网站建设的统一需求基线。它定义“为什么做、做什么、做到什么程度、如何验收”；技术细节可另行写入技术方案、接口文档和部署手册，但不得擅自改变本 PRD 的产品目标、内容诚信规则和安全边界。

文档控制

版本记录

版本	日期	变更说明	状态
V0.1	2026-08-05	整合既有网站方案、长期建设计划、内容系统与安全发布规则	草拟
V1.0	2026-08-05	形成可用于产品、设计、开发、测试和上线验收的正式基线	当前版本

审批与职责

角色	职责	最终权限
产品负责人 / 站点所有者	确认定位、范围、优先级、内容与最终验收	唯一产品决策与发布批准人
产品/内容协作者	整理需求、文章、标签、状态与证据	只能提交草稿或建议
视觉/交互设计	按 PRD 输出设计稿、组件规范与响应式方案	不得自行扩大产品范围
开发 / AI Coding	按验收标准实现、测试并提交构建产物	不得直接绕过审核修改线上版本
测试/审计	只读检查功能、性能、安全和内容准确性	只报告，不在审计阶段边查边改
Publisher / 运维	审核后发布、健康检查、记录与回滚	只按批准的构建产物执行

1. 文档目的与使用规则

本文件用于把通用数字产品的品牌叙事、网站页面、功能、内容、技术边界、安全要求和上线标准统一到一份可执行的产品需求文档中，避免需求散落在聊天、图片、临时指令和不同 AI 窗口里。

1.1 本 PRD 解决的问题

让设计师明确每一页承担什么任务，而不是只追求“好看”。
让开发明确哪些功能必须做、哪些暂缓、成功后应看到什么结果。
让 AI 协作者在上下文压缩或换窗口后，仍能通过文档重新接手。
让测试与验收不再依赖“看起来差不多”，而是依据明确的需求编号和验收条件。
让线上发布有审核、证据、回滚和边界，避免 AI 直接覆盖生产版本。

1.2 文档使用规则

产品定位、目标用户、内容诚信规则、安全边界属于强约束，任何实现不得绕开。
页面文案、图片和排序可在不改变核心任务的前提下调整，并记录变更原因。
技术栈如需替换，必须证明可维护性、可迁移性、构建结果和部署方式不低于当前基线。
所有“已完成”必须附带可验证证据；能打开、能构建、能加载、能工作、能发布必须分开描述。
新增需求先进入需求池，不得在开发过程中以“顺手优化”为由直接扩大范围。

优先级定义 P0 = 首次正式上线不可缺失；P1 = 形成完整使用闭环的重要增强；P2 = 有真实需求后再做；暂缓 = 当前明确不进入开发。

2. 产品概述

项目项	定义
产品形态	面向公众的响应式内容网站，桌面与移动浏览器均可使用
核心内容	起源故事、AI 施工日志、方法与制度、项目档案、作品与观察、资源模板、关于与时间线
主要模式	访客公开阅读；站点所有者与 AI 协作者在站外或后续 Studio 中完成内容生产
首版交互	导航、阅读、筛选、搜索、内容关联、下载、分享、联系
首版内容管理	Markdown/MDX 文件驱动；构建后生成静态页面
商业原则	先形成可信内容与帮助价值，再验证咨询或模板需求；不提前开发商城
技术原则	可迁移、可独立构建、核心资源可自托管、避免强绑定与付费依赖

通用数字产品不是普通个人博客、技术炫技站、证书墙或大而全的 AI 工具箱。它是一份“普通人与 AI 共同施工”的真实档案：故事让人停下，证据让人相信，方法让人带走，工具让人回来。

3. 背景与问题定义

3.1 项目背景

站点所有者在没有传统开发背景的情况下，从 AI 对话、内容创作逐步进入域名、服务器、终端、权限、构建、部署、本地模型与移动端工程。过程中形成了大量真实日志、截图、错误、修复方法、项目制度和可复用模板，但这些材料分散在聊天记录、文件夹、平台与不同项目中。

3.2 用户问题

问题	对用户的影响	网站应提供的解决方式
多数“小白教程”跳过真正卡人的第一步	用户看完仍不知道如何开始、如何判断成功	使用真实现场、症状、验证结果和最小下一步
AI 生成内容容易把阶段结果包装成最终完成	用户被误导，项目风险被隐藏	公开项目状态、证据、未解决项和下一步
AI 长项目会失忆、越权或顺手修改	返工、范围失控、线上风险	外置记忆、最小权限、先测后修、人工审批方法
个人作品和能力散落	无法形成连续叙事和可信证明	用起源故事、时间线和项目档案把内容串联
复杂视觉容易压过内容并增加维护成本	网站难阅读、难更新、难上线	以数字纪实杂志为主体，只保留克制的工业世界观

3.3 产品机会

市场上并不缺少“高手教你做项目”的内容，缺少的是仍然记得小白在哪一句开始听不懂、并愿意公开失败与验证证据的人。本网站的独特价值不在于宣称比程序员更懂代码，而在于把从听不懂到能够建立项目规则、权限边界和验收机制的过程翻译成可复用的方法。

4. 产品定位与价值主张

4.1 正式定位

定位句通用数字产品：一个普通人如何与 AI 一起施工，如何识别假完成、控制项目风险，并把踩过的坑铺成后来者能够走的路。

4.2 三层价值

面向对象	价值主张	希望产生的行动
第一次访问者	看见一个真实、具体、有反差的成长与工程故事	继续阅读起源故事或施工日志
长期读者	持续获得真实故障记录、项目进展与人话解释	订阅、收藏、回访、关联阅读
正在做 AI 项目的非技术用户	获得检查表、模板、判断方法与项目治理思路	下载资源、使用模板、提出咨询

4.3 品牌原则

真实胜过完美：允许展示未完成，但必须准确说明阶段。
证据胜过口号：截图、日志、构建结果和状态说明优先于夸张文案。
人话胜过术语：技术名词必须解释它在实际项目中解决什么问题。
克制胜过堆叠：一屏讲一个重点，不用十几张小卡片同时抢注意力。
可带走胜过只感动：每篇核心内容至少提供一个判断、动作、模板或清单。

5. 产品目标、指标与非目标

5.1 V1 产品目标

ID	目标	完成判定
G-01	建立清晰可信的第一印象	新访客在首屏内能理解网站是什么、为什么值得看、下一步去哪里
G-02	形成完整内容阅读闭环	首页可进入故事、日志、方法、项目、作品、关于；详情页可继续关联阅读
G-03	建立真实项目与内容状态制度	所有项目、日志和研究内容都有统一状态、来源和更新时间
G-04	让网站可长期维护与迁移	内容与核心资源不依赖单一平台，干净环境可构建并部署
G-05	建立安全发布基线	AI 只能提交成果，正式上线需人工批准，并支持回滚与发布记录
G-06	移动端可完整阅读	导航、正文、图片、表格、代码块和下载均可在常见手机宽度使用

5.2 建议观察指标

指标	意义	首版使用方式
起源故事进入率	首屏叙事是否有效	观察首页到 /story 的点击占比
施工日志阅读深度	真实现场是否有吸引力	观察 50%/90% 阅读进度或停留
关联内容点击率	内容闭环是否成立	观察详情页到方法/项目/资源的跳转
资源下载或复制次数	内容是否产生实际帮助	记录模板下载/复制事件
真实咨询数	是否出现可产品化需求	人工记录有效联系，不只看浏览量
构建与发布成功率	网站是否稳定可维护	每次发布记录构建、健康检查和回滚情况

5.3 V1 非目标

不做用户注册登录、会员中心或复杂权限系统。
不做社区、论坛、用户投稿和开放评论系统。
不做商城、购物车、自动支付、自动发货或付费墙。
不做全站 3D、游戏式实验室、大规模粒子或持续高负载动画。
不做大而全 AI 工具箱，不承诺在线运行所有历史 Demo。
不一次性上传全部历史资料，不为数量牺牲内容核验与隐私检查。
不在 V1 将后台 Studio、Vault、AI Workers 和 Publisher 全部产品化；仅保留接口与路线。

6. 用户与使用场景

6.1 核心用户画像

用户类型	特征	核心需求	成功体验
A. AI 好奇但不会写代码的人	有想法，怕终端和技术词，容易被教程劝退	看懂真实步骤、判断自己做到哪一步	读完后敢完成一个最小动作
B. 正在用 AI 做项目的人	遇到失忆、返工、越权、迁移和验收问题	项目规则、检查表、交接模板	能够把一个方法直接用于自己的项目
C. 产品/内容/招聘观察者	想判断站点所有者的能力与成长真实性	项目证据、决策过程、作品与时间线	形成可信、立体而不过度包装的印象
D. 回访读者	关注真实进展而非一次性教程	最新日志、项目状态和后续结果	快速找到自上次以来发生的变化

6.2 核心用户旅程

旅程	入口	关键步骤	最终目标
故事旅程	首页/分享链接	首屏 → 起源故事 → 时间线/日志 → 方法	从共鸣进入可信与实用
故障搜索旅程	搜索引擎/站内搜索	具体日志 → 问题环境 → 验证 → 关联方法/模板	解决或缩小实际问题
项目评估旅程	项目页	项目列表 → 生命体征 → 版本证据 → 关键决策 → 相关日志	准确理解项目真实成熟度
资源使用旅程	方法页/资源页	方法 → 一页清单/模板 → 下载或复制 → 相关说明	把内容带回自己的项目
能力了解旅程	关于/作品页	时间线 → 作品证据 → 项目档案 → 联系	建立合作、招聘或咨询判断

7. 产品范围与优先级

7.1 P0：正式开站必备

模块	P0 范围
全局	品牌页头、桌面/移动导航、页脚、内容来源标签、状态标签、404、基础 SEO
首页	正式 Hero、核心宣言、三条主入口、最新日志、方法入口、项目状态、作品横带、联系入口
起源故事	长文封面、目录、阅读进度、证据图、引句、结尾分流
施工现场	日志列表、类型/状态筛选、日志详情、统一文章结构
方法与制度	方法总览、方法详情、可复制模板入口
项目档案	项目列表、项目生命体征、证据、关键决策、相关日志
作品与观察	音乐、视觉、产品观察、失败作品说明
关于	自我定义、时间线、能力地图、证据、诚信声明、联系
内容	至少 1 篇母故事 + 6 篇首发内容；所有截图完成状态核对与隐私处理

7.2 P1：形成帮助与发现闭环

资源库正式上线：一页清单、PROJECT_STATE、AI_HANDOFF 等最小模板。
全站静态搜索、标签页与档案页。
文章、方法、项目之间的自动关联推荐。
RSS/Atom、站点地图、分享卡片与更完整结构化数据。
轻量、隐私友好的访问统计与自定义事件。

7.3 P2：真实需求验证后再做

咨询预约或项目状态整理服务。
付费模板包或方法包。
自建评论、订阅邮件、用户账户。
Starmo Studio 与主站内容正式联动。
可执行 Demo 沙盒、视频/PDF/PPT 等高级媒体管理。

8. 信息架构与路由

8.1 正式网站地图

层级	页面	建议路由	核心任务	优先级
一级	首页	/	建立第一印象并分流	P0
一级	起源故事	/story	承载成长与精神主线	P0
一级	AI 施工现场	/logs	发布真实开发、故障与修复记录	P0
一级	方法与制度	/methods	沉淀可复用的 AI 项目治理方法	P0
一级	项目档案	/projects	展示项目真实状态、证据与决策	P0
一级	作品与观察	/works	连接音乐、视觉、产品观察与能力	P0
二级	资源库	/resources	提供清单、模板、提示词与下载	P1
二级	关于与时间线	/about	身份、证据、时间线、诚信声明与联系	P0
二级	全站档案	/archive	按日期、主题、类型和状态检索全部内容	P1
系统	404	/404.html	帮助用户回到有效内容	P0

8.2 详情页路由规则

内容类型	路由模板	示例
故事	/story/[slug]	/story/desert-rose
施工日志	/logs/[slug]	/logs/model-loaded-but-no-reply
方法	/methods/[slug]	/methods/external-memory
项目	/projects/[slug]	/projects/通用数字产品-blog
作品/观察	/works/[slug]	/works/ai-music-release
资源	/resources/[slug]	/resources/project-state-template
标签	/tags/[slug]	/tags/local-model

8.3 导航规则

桌面顶部主导航固定为：故事、施工现场、方法、项目、作品、关于。
Logo 点击返回首页。资源库和档案作为首页、详情页与页脚的次级入口，不挤占主导航。
移动端使用全屏或大面积抽屉导航，每个入口附一句说明。
当前页面需有清晰的激活态；详情页显示面包屑。
导航不得因新增栏目无限增长；超过 6 个主入口时必须重新评审信息架构。

9. 全局体验与导航

9.1 全局页面骨架

1. 跳至正文链接（键盘与无障碍用户可见）。

2. 品牌页头：Logo、主导航、移动菜单按钮。

3. 页面主内容：唯一 H1、内容区域、必要的目录/筛选/元信息。

4. 关联内容区：最多 3–6 条，与当前内容确有关系。

5. 页脚：一句品牌宣言、资源库、档案、RSS、联系、版权与内容声明。

9.2 全局状态与反馈

场景	要求
加载	静态页面优先；局部搜索或图片加载应有轻量反馈，不使用长时间全屏 Loading
空状态	说明为什么为空，并给出返回全部内容或清除筛选的操作
错误状态	使用人话说明，保留技术错误编号仅供定位；不得暴露服务器路径或堆栈
外链	必要时显示外链图标；不强制新窗口，下载资源需标明格式和大小
复制	代码、命令、模板支持复制并显示“已复制”反馈
减少动态	尊重 prefers-reduced-motion，关闭非必要动效

10. 页面级需求

统一要求每个页面必须定义：页面任务、目标用户、入口、核心模块、主要操作、内容状态、移动端行为、空/错状态、SEO 信息和验收条件。

10.1 首页 /

页面任务：在 10 秒内让新访客理解“这是什么网站、为什么可信、下一步去哪里”。

模块	需求说明
首屏 Hero	超大标题 + 一句解释 + 真实施工现场大图/横图；主按钮“阅读起源故事”，次按钮“进入施工现场”。
核心宣言	整屏大字说明：这里不展示一键成功，而是记录每一步发生过的证据。
三条主入口	无人区玫瑰 / AI 施工现场 / 管住 AI 的方法；使用横向大章节，不做密集小卡片。
最新现场	显示最新 3 条日志，必须带日期、类型与状态：已解决/检修中/待验证等。
方法入口	外置记忆、双工牌、先测后修，每项一句原则并链接详情。
项目生命体征	至少展示通用数字产品 Blog、Starmo Studio、星语本地模型应用；写明已完成、未完成、下一步。
作品横带	音乐、视觉、产品观察以影像带呈现，不在首页堆完整履历。
页尾行动	资源库、档案、联系或订阅入口；仅保留一个主要联系动作。

关键验收

H-01 首屏在常见桌面和手机宽度不出现遮挡、溢出或关键信息折叠。
H-02 所有主入口可点击且指向有效页面。
H-03 项目状态不得使用模糊的“已完成”替代实际阶段。

10.2 起源故事 /story

页面任务：以数字杂志方式承载《荒漠里盛开的无人区玫瑰》，成为网站的精神中心与主要品牌入口。

模块	需求说明
封面	标题、副标题、发布日期、更新时间、阅读时长、内容来源标签、氛围背景。
章节目录	桌面左侧粘性目录；移动端折叠目录；点击平滑跳转但尊重减少动态。
正文	正文宽度 760–820px；大编号章节；段落、引句、图片、图注和代码可读。
证据插图	每 1–2 章可放真实截图或作品证据；每张标明日期、当时目标、真实状态。
核心引句	关键句做大幅引文，不把所有句子都做卡片。
结尾分流	至少提供：看时间线、看相关施工日志、看方法制度三个方向。

关键验收

S-01 目录与正文标题一一对应。
S-02 图片均有替代文本、图注和隐私处理。
S-03 阅读进度不遮挡移动端浏览器控件。

10.3 AI 施工现场 /logs

页面任务：把失败与修复写成可检索的工程档案，成为网站长期更新的主内容区。

模块	需求说明
页面头部	标题与一句解释：“真实项目没有一键完成，只有一轮轮缩小问题。”
筛选	类型：网站/服务器/Codex/移动端/本地模型/鸿蒙；状态：检修中/已解决/未复现/暂缓/待验证。
日志列表	大横条或宽卡片；显示标题、日期、现场一句话、状态、项目、证据缩略图。
日志详情	统一结构：发生了什么 → 环境 → 症状 → 错误判断 → 处理 → 验证 → 未解决 → 小白建议 → 可复制内容。
证据	可包含构建输出、终端结果、模拟器、设置页，但必须打码并解释。
关联	自动或人工关联项目档案、方法文章和资源模板。

关键验收

L-01 筛选可组合，清除筛选后恢复全部。
L-02 无结果时显示空状态，不显示空白页。
L-03 “加载成功”与“能够回复/工作”必须使用不同状态描述。

10.4 方法与制度 /methods

页面任务：把个人事故沉淀为可复用的 AI 项目治理方法，是网站长期价值与未来产品化核心。

模块	需求说明
方法总览	外置记忆 / 双工牌最小权限 / 先测试后修复 / 可迁移性与隐藏依赖。
方法详情	问题现场 → 核心原则 → 人类制度映射 → 实际实施 → 边界与风险 → 可复制模板。
模板入口	提供查看、复制或下载；标注版本、格式、适用范围和更新时间。
结构图	用于解释角色、目录、流程；不得公开密钥、真实 IP、Token 或可利用的敏感细节。

关键验收

M-01 每个方法至少含一个具体场景与一个可执行动作。
M-02 模板可用且文件名、编码、格式正确。
M-03 边界与风险不可省略。

10.5 项目档案 /projects

页面任务：像公开项目病历一样展示真实生命体征，而不是只放漂亮效果图。

模块	需求说明
项目列表	名称、目标、开始时间、当前阶段、状态、最近更新、下一步。
项目封面	一句话目标、当前版本、平台/技术标签、真实截图。
四格状态	能用的 / 正在修的 / 明确没做的 / 下一步唯一动作。
版本证据	Build/Test/部署结果、截图、发布日期、已知问题。
关键决策	说明为什么改变方向、为何选择本地化/可迁移/安全发布。
关联日志	展示与该项目相关的施工日志、方法和资源。

关键验收

P-01 项目状态与最新日志一致。
P-02 所有时间与版本有来源，不凭空填写。
P-03 明确未做功能，不用“敬请期待”掩盖。

10.6 作品与观察 /works

页面任务：把散落的音乐、视觉、用户研究和产品观察连接为能力线，而不是做荣誉墙。

模块	需求说明
开场	说明“我不是不会，而是能力曾经太散”。
音乐	平台发布证据 + 作品故事 + 在项目中的作用。
视觉	代表作品、角色/网站世界观、制作方式标签：AI 生成/手工/后期。
产品观察	汽车场景、AI 产品体验、用户需求洞察；重点展示问题发现与推理过程。
失败作品	保留漂亮但未形成后续价值的作品，解释为什么它成为“可回收物”。

关键验收

W-01 所有作品明确作者/AI 参与方式。
W-02 外部平台链接可访问或明确下线状态。
W-03 不夸大播放量、奖项与因果贡献。

10.7 资源库 /resources

页面任务：提供真正能带走并立即使用的清单、模板与提示词。

模块	需求说明
分类	一页清单 / 项目文档模板 / 测试与验收 / 权限与发布 / 提示词。
资源卡	标题、用途、适用对象、版本、格式、更新时间、预览、下载/复制。
来源标签	本人原始规范 / 本人主导·AI 协助整理 / AI 生成·待核验。
安全处理	删除真实路径、账号、密钥、IP、内部身份与可被利用的漏洞细节。

关键验收

R-01 下载文件与页面说明一致。
R-02 文件不可包含敏感元数据或真实凭证。
R-03 资源版本变更有更新说明。

10.8 关于与时间线 /about

页面任务：用可核验的时间线、项目证据与内容诚信声明说明“我是谁”。

模块	需求说明
自我定义	“我不是程序员，也不假装自己是。我正在学习怎样让强大但不永远可靠的 AI 安全地进入真实工作。”
时间线	从初次使用 AI、音乐/视觉创作，到域名、服务器、网站、本地模型和移动端工程。
能力地图	故事表达、用户观察、产品判断、AI 协作、项目治理、真实推进。
证据	证书、作品平台、项目截图；编号、二维码、电话、账号等必须打码。
诚信声明	解释三类内容来源标签与核验规则。
联系	仅一个明确入口；说明适合联系的事项与预计回复方式。

关键验收

A-01 时间线与公开文章事实一致。
A-02 联系方式可用且不暴露不必要隐私。
A-03 页面不写空泛技能列表，必须由证据或项目支撑。

10.9 全站档案 /archive

页面任务：让回访用户和搜索用户快速按时间、类型、项目、标签与状态找到内容。

模块	需求说明
时间索引	按年份/月聚合；显示内容数量与最近更新。
筛选	内容类型、项目、主题标签、状态、来源标签。
搜索	标题、摘要、正文与标签；结果高亮可选。
排序	默认最新更新；可切换最早发布或相关度。

关键验收

AR-01 查询结果数量与列表一致。
AR-02 URL 可反映主要筛选条件或至少支持返回状态。
AR-03 无 JavaScript 时仍能访问基础档案列表。

10.10 404 与系统页

页面任务：当链接失效时保留网站语气，并引导用户回到有效内容。

模块	需求说明
404	明确“页面不存在或已移动”，提供首页、施工现场、全站档案与搜索入口。
错误页	不暴露堆栈、路径或服务器信息；提供错误编号和返回操作。
无网络/资源失败	核心文字内容尽量仍可读；图片失败显示替代文本。

关键验收

E-01 任意不存在路径返回正确 404 状态，而不是 200 伪 404。
E-02 404 页面在手机上可完整操作。

11. 内容模型与业务规则

11.1 通用内容字段

字段	类型/示例	规则
id	字符串/UUID	内部唯一且稳定，不随标题改变
title	文本	页面唯一 H1；避免夸张和无法验证的结论
slug	英文小写短横线	发布后尽量不改；改动需重定向
summary	80–180 字	用于列表、SEO 和分享，不等于正文首段复制
type	story/log/method/project/work/resource	使用受控枚举
status	按内容类型使用受控状态	状态必须与证据一致
publishedAt	ISO 日期时间	首次公开时间
updatedAt	ISO 日期时间	实质更新才修改
author	站点所有者/协作者	公开显示适当名称
sourceLabel	原创实录/本人主导·AI 协助/AI 生成·待核验	必填
tags	字符串数组	建议 2–6 个，使用统一词表
project	项目引用	日志、方法、作品可关联项目
cover	本地媒体引用	需 alt、宽高、图注、来源
evidence	证据数组	包含日期、目标、状态、隐私检查标记
related	内容引用数组	人工优先，自动推荐不得造成误导
draft	布尔值	草稿不得进入生产构建或站点地图
seo	title/description/canonical/noindex	可覆盖默认值

11.2 日志状态枚举

状态	定义	允许使用条件
待确认	现象已记录，原因与复现尚不明确	仅有初步现场
检修中	正在定位或修复，尚无最终验证	有当前动作和下一步
待验证	已完成候选修复，但尚未通过完整验证	需写验证计划
已解决	问题已修复并通过预定验证	必须记录验证结果和时间
未复现	当前环境无法复现，不能证明问题不存在	记录环境差异
暂缓	因优先级、资源或外部依赖暂停	写清暂停原因与恢复条件
已回滚	修复或版本撤销，恢复到安全状态	记录回滚点和影响

11.3 项目阶段与生命体征

阶段	说明	不得等同于
想法/验证	目标与可行性仍在确认	已立项或已开发
原型	可展示流程或界面，未必具有真实能力	可用产品
开发中	代码或内容正在实现	已通过测试
可运行	在指定环境可以启动	可迁移、可发布
可验证	关键功能可按用例重复验证	稳定生产
已上线	生产环境可访问	长期稳定或功能完整
维护中	持续修复与迭代	没有已知问题
暂停/归档	当前不继续投入	失败或删除

11.4 每篇施工/方法文章的统一结构

1. 一句真实冲突：立即说明发生了什么。

2. 现场环境：时间、设备、项目阶段、目标与前置条件。

3. 具体症状：看到什么、预期什么、实际发生什么。

4. 错误判断：当时以为什么，后来为何发现不对。

5. 实际处理：做了什么、为什么做、改变了哪里。

6. 验证结果：使用什么方法验证，结果是什么。

7. 仍未解决：明确阶段边界和未知项。

8. 我后来才知道：把技术逻辑翻译成人话。

9. 你可以先做什么：给读者一个最小动作。

10. 可复制内容：命令、清单、模板或判断表。

11. 来源标签、隐私说明、更新时间和相关内容。

12. 功能需求

需求 ID	功能	需求说明	优先级
FR-001	全局导航	所有正式页面显示一致导航；移动端可打开、关闭并锁定背景滚动	P0
FR-002	面包屑	详情页显示可点击的层级路径	P0
FR-003	阅读进度	长文显示轻量阅读进度；减少动态时仍可用	P0
FR-004	章节目录	根据正文标题生成或维护目录，支持键盘跳转	P0
FR-005	内容列表	按内容类型输出列表并显示标题、摘要、日期、状态与标签	P0
FR-006	类型筛选	施工日志按类型筛选	P0
FR-007	状态筛选	施工日志和项目按受控状态筛选	P0
FR-008	组合筛选	多个筛选条件可组合，支持一键清除	P1
FR-009	站内搜索	搜索标题、摘要、正文和标签；结果按相关度/日期展示	P1
FR-010	标签页	点击标签进入该标签内容聚合页	P1
FR-011	全站档案	按时间、类型、项目、标签、状态浏览	P1
FR-012	关联内容	详情页展示相关项目、日志、方法或资源	P0
FR-013	内容来源标签	所有正式内容公开显示来源类型	P0
FR-014	项目状态	项目页显示能用/在修/未做/下一步	P0
FR-015	证据组件	图片/日志证据显示日期、目标、状态、图注与 alt	P0
FR-016	图片查看	大图可放大查看；支持关闭、键盘与移动手势	P1
FR-017	代码与命令	代码块可横向滚动、复制，并保留语言标识	P0
FR-018	资源下载	显示格式、版本、大小和更新时间，下载链接有效	P1
FR-019	模板复制	纯文本模板支持复制并显示反馈	P1
FR-020	分享	提供复制链接和系统分享；不强依赖第三方 SDK	P1
FR-021	RSS/Atom	输出主要更新订阅源	P1
FR-022	Sitemap	构建时生成站点地图，排除草稿与 noindex 内容	P0
FR-023	Robots	提供 robots.txt 并引用站点地图	P0
FR-024	Canonical	每个可索引页面有唯一规范链接	P0
FR-025	社交卡片	主要页面提供 Open Graph/Twitter 卡片信息	P1
FR-026	结构化数据	文章、面包屑、网站信息使用合适 JSON-LD	P1
FR-027	站长验证	支持在全局 head 中配置搜索引擎验证 meta	P0
FR-028	404	无效路径返回 404 状态与品牌化引导页面	P0
FR-029	联系入口	全站仅一个主要联系入口，明确适用事项	P0
FR-030	外链安全	外链按需使用 rel 属性，不泄露来源敏感参数	P0
FR-031	草稿隔离	草稿不出现在生产页面、搜索、RSS、站点地图	P0
FR-032	更新提示	实质更新的文章显示更新时间与变更摘要	P1
FR-033	旧链接重定向	slug 或信息架构变更时维护永久重定向	P1
FR-034	轻量统计	可选隐私友好统计，不阻塞首屏，不收集无必要个人信息	P1
FR-035	打印样式	长文和模板提供基本可读的打印/PDF 样式	P2
FR-036	评论	V1 不开放；未来启用时必须自建或可迁移且具备审核/反垃圾	暂缓
FR-037	用户账户	V1 不开放；未来需单独 PRD	暂缓
FR-038	付费与商城	V1 不开放；真实需求验证后单独立项	暂缓

12.1 核心功能验收原则

每个需求必须有可重复测试步骤、预期结果和实际结果。
不得通过降低测试标准、隐藏错误、删除失败模块或注释代码来制造“通过”。
第一轮审计只记录问题，不直接修复；经产品负责人确认范围后再进入修复。
修复后必须完整回归，而不是只验证被修改的局部。

13. 内容治理与真实性制度

13.1 内容来源标签

标签	定义	适用范围
原创实录	本人亲历、观察、手写或口述，未由 AI 代替核心判断	个人经历、现场日志、原始观点
本人主导 · AI 协助整理	事实、观点和判断由本人提供，AI 负责结构、润色或排版	多数正式文章、方法、清单
AI 生成 · 待核验	由 AI 生成的研究材料，尚未完成事实核验	研究草稿、行业资料，不得包装成确定事实

13.2 事实与状态规则

真实经历优先：能用本人现场说明的，不用宏大概念替代。
状态准确：已安装、能启动、能加载、能推理、能回复、能发布必须分别描述。
不夸大贡献：产品后来出现相似功能，不代表能证明由个人建议促成。
不伪装技术身份：明确不会独立完成复杂编码，同时真实说明产品推进、治理和验收能力。
涉及公司、用户数量、价格、法律、漏洞、架构或时间敏感事实时，发布前必须查证可靠来源。
每篇核心文章至少提供一个判断方法、最小动作或可复制模板。

13.3 内容发布工作流

1. 素材进入 Inbox：原始聊天、截图、音视频、笔记和想法。

2. 内容整理：建立标题、类型、目标读者、状态、来源标签与关联项目。

3. 草稿：生成正文与媒体清单，不进入生产。

4. 事实核验：核对时间、状态、版本、外部事实和项目证据。

5. 隐私检查：打码账号、IP、Token、二维码、编号、路径、私人聊天和可利用细节。

6. 预览：在本地或预览环境检查桌面/移动、链接、SEO 与可访问性。

7. 批准：只有站点所有者明确批准后进入发布。

8. 发布与健康检查：生成新 release，检查关键页面，再切换 current。

9. 回滚与记录：失败恢复上一版本；写入版本、构建结果和变更日志。

14. 视觉与交互规范

14.1 视觉定位

视觉关键词数字纪实杂志 × 温暖工业档案 × 无人区玫瑰。正式、克制、有电影感；世界观通过材质、线条、档案编号和局部细节表达，不把全站做成难维护的游戏界面。

14.2 色彩基线

用途	名称	色值	建议比例/规则
主背景	荒漠纸白	#F4EFE7	约 55%，承载正文与留白
正文/深色区	夜墨黑	#17171A	约 25%，文字与少量深色章节
品牌强调	无人区玫瑰	#B63A55	约 8%，关键词、章节号、状态与交互
结构细节	旧黄铜	#9C8058	约 5%，细线、图注、档案编号
辅助文字	雾灰	#77736F	约 7%，元信息与次级说明

14.3 字体与排版

内容	字体建议	桌面	移动
品牌/大标题	本地自托管中文衬线体；装饰字体少量使用	56–88px	36–48px
章节标题	思源宋体/Noto Serif CJK SC	32–46px	28–36px
正文	思源黑体/Noto Sans CJK SC	18–20px；行高 1.85–1.95	17–18px；行高约 1.8
图注/元信息	无衬线体	13–14px	12–13px
代码/日志	本地等宽字体	14–15px	13–14px

14.4 栅格与留白

桌面最大内容宽度 1440px，建议 12 栏栅格；长文正文 760–820px。
首屏建议 80–92vh，但不得迫使重要操作完全位于首屏之外。
大章节上下留白 96–140px；移动端 64–88px。
截图优先大图、双图或证据条，不做几十张缩略图瀑布流。
按钮最小高度 48px；正文移动端左右边距 20–24px。

14.5 动效

只使用淡入、轻微上移、阅读进度和必要的菜单过渡。
首页可使用非常轻的星尘或玫瑰线稿呼吸，不得影响性能和阅读。
所有非必要动效必须在 prefers-reduced-motion 下关闭。
禁止大规模粒子、持续齿轮旋转、滚动劫持和影响可读性的视差。

14.6 明确禁止的视觉方向

首页堆满 20 个功能图标或九宫格小卡片。
每段内容都包进圆角玻璃卡片。
大面积金色渐变、廉价励志海报和全站粉色。
用 AI 人物插画替代所有真实项目证据。
为了“视觉冲击”牺牲正文宽度、对比度、加载速度和移动端使用。

15. 响应式、兼容性与无障碍

15.1 响应式断点原则

区间	主要行为
≤ 480px	单列；标题优先于图片；20–24px 边距；代码/表格横向滚动
481–767px	单列或有限双列；抽屉导航；证据图按阅读顺序排列
768–1023px	平板布局；目录可折叠或侧栏；项目状态可 2 列
≥ 1024px	桌面栅格；长文目录与正文并列；大章节充分留白
≥ 1440px	内容宽度封顶，不无限拉宽正文

15.2 浏览器与设备基线

支持当前主流桌面 Chromium、Edge、Firefox、Safari 的最近稳定版本。
支持 Android/HarmonyOS 常见浏览器与 iOS Safari 的常用视口。
核心阅读与导航不依赖鼠标悬停；触摸、键盘和屏幕阅读器可操作。
页面在 JavaScript 失败时仍应保留主要正文、链接和基础导航。

15.3 无障碍要求

ID	要求
A11Y-01	页面只有一个主 H1，标题层级不跳级。
A11Y-02	所有信息性图片有准确 alt；装饰图使用空 alt。
A11Y-03	正文与交互文本对比度满足通用可读性标准。
A11Y-04	键盘可访问导航、筛选、目录、弹层与关闭按钮；焦点可见。
A11Y-05	表单控件有标签，错误信息与字段关联。
A11Y-06	状态不能只靠颜色表达，需有文字或图标。
A11Y-07	支持跳至正文、减少动态与放大 200% 后可用。
A11Y-08	弹层打开后管理焦点，关闭后返回触发元素。

16. SEO 与站点发现

16.1 页面级 SEO 字段

字段	规则
title	每页唯一；核心主题在前，品牌名在后；避免堆关键词。
description	概括页面价值与真实内容，不使用空泛口号。
canonical	指向唯一正式 URL，避免 www/非 www、尾斜杠等重复。
robots	公开内容 index,follow；草稿、预览、内部页 noindex。
Open Graph	标题、摘要、规范 URL、本地分享图与类型。
结构化数据	文章、网站、面包屑等按页面类型输出。

16.2 站点级 SEO

生成 sitemap.xml，并在 robots.txt 中引用。
提供 RSS/Atom 订阅源（P1）。
支持 Bing、Google 等站长平台验证标签放入全局 <head>，且位于 <body> 之前。
旧 URL 变更应提供 301/308 永久重定向。
图片使用明确尺寸、延迟加载与合适格式；首屏关键图不得过度延迟。
文章标题、摘要、标签、内部链接和更新时间均来源于内容字段，不在模板中硬编码。

17. 非功能需求

ID	类别	要求	优先级
NFR-001	性能	普通内容页在合理网络与设备下快速显示首屏；避免阻塞式第三方脚本	P0
NFR-002	页面重量	首屏只加载必要字体、CSS 与关键图片；非关键媒体延迟加载	P0
NFR-003	稳定性	静态页面即使后续统计/搜索组件失败，正文仍可阅读	P0
NFR-004	可维护性	页面由共享布局与组件构成，设计 Token 统一管理	P0
NFR-005	可迁移性	可在干净目录重新安装、构建；域名、路径、端口可配置	P0
NFR-006	离线/外部失败	核心字体、CSS、图标和首要素材不依赖不可控外链	P0
NFR-007	安全	生产站点不包含私钥、Token、.env、真实 IP 或内部路径	P0
NFR-008	隐私	不默认收集不必要个人信息；统计与联系功能遵循最小化	P0
NFR-009	SEO	每个正式页面有完整元信息、规范 URL 与可抓取正文	P0
NFR-010	可访问性	核心流程支持键盘、触摸与屏幕阅读器	P0
NFR-011	可测试性	构建、链接、路由、内容 schema 和关键页面可自动检查	P0
NFR-012	可回滚	每次生产发布保留上一可用 release 与发布记录	P0

17.1 建议性能目标（验收目标，不作为绝对承诺）

指标	目标
首屏最大内容渲染（LCP）	在常见移动网络与中端设备测试中尽量 ≤ 2.5s
交互响应（INP）	主要交互尽量 ≤ 200ms
布局偏移（CLS）	尽量 ≤ 0.1；图片提前声明宽高
关键页面 Lighthouse	性能、可访问性、最佳实践、SEO 均以 ≥ 90 为努力目标；需结合真实设备复核
构建	生产构建无错误；路由、内容 schema、内部链接检查通过

18. 技术约束与系统边界

18.1 当前建议基线

层次	基线
前端框架	Astro + TypeScript
样式	原生 CSS + Design Tokens；避免为了简单页面引入重型 UI 框架
内容	Markdown/MDX + Content Collections/Schema 校验
输出	静态生成；Nginx/等价静态服务器托管
媒体	本地目录与构建优化；后续可接自建对象存储，但需可迁移
搜索	P1 使用构建期生成的静态索引或等价本地方案
代码质量	TypeScript 检查、Lint、构建、关键测试和链接检查
包管理	锁定包管理器与 lockfile，记录 Node 版本和安装步骤

18.2 技术强约束

不得把核心内容、字体、样式或站点运行绑定到单一收费平台。
第三方服务必须可替换；服务失败不能使核心正文不可用。
不得硬编码本地绝对路径、服务器 IP、生产域名以外的环境信息和秘密。
环境差异通过配置管理；公开配置与秘密配置分离。
构建产物必须可独立部署，不依赖开发电脑上的临时缓存或未提交文件。
任何技术替换需记录 ADR/DECISIONS：原因、备选、影响、迁移与回滚。

18.3 与长期系统的边界

系统	本 PRD 中的边界
Starmo Vault	保存原始素材与项目外置记忆；V1 主站只消费已批准的公开内容，不直接暴露 Vault。
Starmo Studio	未来用于登录、文章编辑、预览与任务；V1 主站不得依赖 Studio 才能构建。
AI Workers	可生成草稿、代码、标签与检查报告；默认无正式发布权。
Safe Publisher	负责检查、人工批准、release、健康检查与回滚；V1 可先以受限脚本/流程实现。

19. 安全与隐私

19.1 权限原则

角色	允许	禁止
Audit	只读生产文件、运行非破坏性检查、提交报告	修改、删除、发布、sudo
Deploy	向 incoming 交付构建产物	直接写 releases/current、sudo、读取秘密
Publisher	发布批准的构建、设置权限、健康检查、回滚、记录	修改源内容、越过批准发布其他版本
root	人工紧急系统管理	交给 AI 做日常工作

19.2 敏感信息禁止项

密码、私钥、公钥全文、Token、AccessKey、数据库密码、.env 内容。
真实公网 IP、可利用的端口组合、内部用户名与完整服务器路径（公开内容中）。
未打码的手机号、邮箱、证书编号、二维码、账号 ID、地址和私人聊天。
可直接复现攻击的漏洞细节、未经修复的高风险配置与内部日志。

19.3 发布前隐私检查

检查对象	必检项
截图	账号、手机号、邮箱、IP、路径、二维码、通知、聊天联系人、设备序列
文档/下载	作者元数据、批注、修订记录、隐藏文本、内部路径、示例密钥
代码	秘密扫描、环境变量、注释中的凭证、调试接口、source map 暴露
链接	带 Token 的查询参数、私有分享链接、内部控制台地址
文章	他人隐私、无法证实指控、未公开商业信息和过度暴露的个人经历

20. 发布、回滚与运维

20.1 标准发布链路

AI/用户提交成果 → incoming → 自动检查 → 预览 → 人工批准 → 创建新 release → 设置安全权限 → 切换 current → 健康检查 → 成功记录 / 失败回滚。

20.2 发布前自动检查

类别	检查项
内容	草稿隔离、必填字段、来源标签、状态、日期、slug 唯一、敏感词/敏感信息人工复核
代码	依赖安装、类型检查、Lint、单元测试、生产构建
页面	关键路由 200、404 正确、内部链接、图片与下载文件存在
SEO	title/description/canonical、sitemap、robots、站长验证 meta 位于 head
安全	秘密扫描、目录/文件权限、部署账号不可写生产 release
视觉	桌面/移动关键页面截图或人工预览；无溢出、遮挡、错位

20.3 健康检查

首页、起源故事、日志列表、项目列表、关于页与 404 可访问。
CSS、字体、关键图片、JS 和下载资源返回正常。
页面 title、canonical 和验证 meta 正确。
current 指向新 release；旧 release 保留且可回滚。
失败时自动或人工切回上一 release，并记录原因。

20.4 发布记录字段

字段	说明
release_id	唯一版本号/时间戳/提交号
approved_by	批准人
source_commit	对应源代码提交或归档包
build_result	构建与测试摘要
deployed_at	发布时间
health_check	关键路由与资源结果
rollback_point	上一可用版本
change_summary	用户可理解的变更说明
known_issues	已知但接受上线的问题

21. 数据分析与运营

21.1 事件建议

事件	触发	用途
home_primary_click	点击首屏主按钮	判断首页分流
content_read_50/90	长文读到 50%/90%	判断内容深度
related_click	点击关联日志/方法/项目	判断内容闭环
resource_download	下载资源	判断实际帮助价值
template_copy	复制模板/命令	判断可执行价值
contact_click	点击联系入口	判断合作/咨询意向
search	执行站内搜索	发现用户真实问题
filter_apply	使用类型/状态筛选	优化分类与信息架构

21.2 数据原则

统计服务不得阻塞首屏或使正文不可用。
不采集无必要的精确位置、指纹、私人输入或跨站行为。
优先看有效阅读、模板使用和真实咨询，不以单纯浏览量指导所有决策。
没有真实订单前，不因“可能变现”开发复杂交易系统。

22. 验收标准与测试

22.1 上线总门槛

验收 ID	验收条件
AC-01	首页、故事、日志、方法、项目、作品、关于和 404 均完成并可访问
AC-02	至少发布 1 篇母故事 + 6 篇首发内容，且全部有来源与状态标签
AC-03	所有真实截图完成隐私打码、图注、日期与状态核对
AC-04	桌面与移动端导航、正文、图片、表格、代码块和下载可用
AC-05	类型检查、Lint、测试、生产构建和内部链接检查通过
AC-06	关键路由返回正确 HTTP 状态；404 非伪 404
AC-07	每个正式页面具有 title、description、canonical；sitemap/robots 正常
AC-08	站长验证 meta 位于 head 且部署后源代码可见
AC-09	生产 release 目录/文件使用安全权限；AI 部署账号无法直接写 current/release
AC-10	发布前有人工预览与批准；发布后健康检查通过；存在回滚点
AC-11	无公开密钥、Token、真实 IP、.env、私人聊天或可利用漏洞细节
AC-12	README、部署手册、PROJECT_STATE、CHANGELOG 与实际版本一致

22.2 关键测试场景

用例 ID	场景	步骤	预期
TC-001	新访客从首页进入起源故事	打开首页 → 点击主按钮	进入有效故事页，标题与来源信息正确
TC-002	移动端导航	375px 宽度打开菜单并点击“项目”	菜单可开关、焦点可见、进入项目页
TC-003	日志筛选	选择“本地模型 + 检修中”	仅显示匹配内容；数量与列表一致
TC-004	清除筛选	应用筛选后点击清除	恢复全部内容且无页面刷新错误
TC-005	文章目录	点击章节 05	跳转到正确标题，URL/焦点行为可接受
TC-006	代码复制	点击复制按钮	剪贴板内容正确并显示反馈
TC-007	资源下载	下载 PROJECT_STATE 模板	文件可打开，版本与页面一致，无敏感信息
TC-008	失效链接	访问不存在路径	返回 404 状态和可操作 404 页面
TC-009	无 JavaScript	禁用 JS 打开文章	正文、图片 alt、导航和链接仍基本可用
TC-010	搜索引擎验证	查看首页源代码	验证 meta 在 head 内、body 之前，content 正确
TC-011	生产写权限反测	以 deploy/audit 身份尝试写 current 文件	写入失败；不改变线上内容
TC-012	发布失败回滚	模拟关键页面健康检查失败	current 恢复上一版本，记录失败原因

22.3 验收报告输出

测试环境、版本、时间与执行人。
每个用例的通过/失败、实际结果、截图或日志证据。
缺陷分级、影响范围、复现步骤和建议。
接受上线的已知问题与批准记录。
回滚点与上线后复核结果。

23. 版本路线图

阶段	目标	主要交付	退出条件
V1.0 正式开站	形成品牌与阅读闭环	8 个核心页面、1+6 首发内容、移动适配、SEO、安全发布基线	通过 AC-01 至 AC-12
V1.1 帮助价值	让方法可被直接使用	资源库、模板、搜索、标签、档案、内容关联	资源真实使用且无敏感泄露
V1.2 运营优化	根据真实行为优化内容	轻量统计、RSS、分享卡片、更新日志与更多首批文章	形成稳定更新节奏
V2.0 内容后台	减少 SSH 与手工文件操作	Starmo Studio 接入内容、预览与审批；主站仍可独立构建	手机/电脑可提交草稿，批准后发布
V2.x 服务验证	验证真实咨询或模板需求	少量人工服务、付费方案探索	完成 3–5 次真实交付再决定产品化

23.1 V1.0 建议迭代顺序

1. 冻结信息架构、内容类型、状态与来源标签。

2. 完成全局布局、Design Tokens、导航、页脚与基础 SEO。

3. 完成首页和起源故事，验证整体视觉与长文排版。

4. 完成日志、方法、项目三个核心内容类型及详情模板。

5. 完成作品、关于、404 与首批内容。

6. 完成移动端、无障碍、链接、性能、隐私和 SEO 检查。

7. 进入预览、人工批准、安全发布、健康检查和回滚演练。

24. 风险、依赖与应对

风险	概率/影响	应对
视觉再次扩张为复杂实验室	高/高	以内容阅读和维护成本为验收；复杂视觉进入独立实验页或后续版本
AI 顺手修改无关内容	高/高	任务范围、只读审计、交稿区、人工批准、差异审查
上下文压缩造成项目失忆	高/高	PROJECT_STATE、AI_HANDOFF、DECISIONS、CHANGELOG 每次更新
阶段成果被写成“已完成”	高/高	受控状态、证据字段、验收模板与内容审核
图片泄露隐私或秘密	中/高	打码清单、元数据清理、发布前双人/双模型复核
外部服务或平台绑定	中/高	核心资源自托管、可替换 Provider、干净构建与迁移测试
内容太多导致迟迟不上线	高/高	限制 V1 为 1+6 首发内容；其余进入内容池
SEO 验证/元信息位置错误	中/中	全局布局管理 head；部署后查看源代码与站长平台复核
发布脚本产生宽松权限	中/高	发布器统一 chmod/chown，反向验证 deploy/audit 不可写
统计、评论等第三方脚本拖慢站点	中/中	P1 后评估；异步、可禁用、核心内容独立

24.1 关键依赖

首批文章、项目状态、真实截图与时间线事实核对。
品牌 Logo、基础图形、字体授权与本地字体文件。
服务器/Nginx/域名/HTTPS 与 DNS 正常。
安全发布器或至少可审计的人工发布步骤。
干净构建环境与锁定的依赖版本。

25. 需求变更与项目交接

25.1 需求变更流程

1. 提出变更：写清问题、用户、目标、期望结果，不能只写“感觉不好看”。

2. 影响分析：页面、内容、数据、技术、安全、SEO、测试、发布与工期。

3. 确定优先级：P0/P1/P2/暂缓，并说明为什么现在做。

4. 产品批准：未经批准不进入开发。

5. 更新文档：PRD、设计稿、任务、测试用例和变更记录保持一致。

6. 实施与验证：按新验收标准执行，不以旧测试掩盖新风险。

25.2 每次工作结束的交接内容

文件/记录	必须包含
PROJECT_STATE.md	今天完成、验证结果、未解决、下一步唯一动作、禁止事项、最近回滚点
AI_HANDOFF.md	目标、范围、当前文件、环境、风险、新 AI 接手前必读内容
CHANGELOG.md	用户可理解的版本变化与日期
DECISIONS.md	重要取舍、原因、备选、影响与回滚
BUG_TRACKER.md	缺陷位置、复现、严重度、证据、状态与责任人
session-logs	实际执行、命令、输出摘要与未完成事项

25.3 AI 接手规则

接手前置条件任何新 AI 在执行命令或修改文件前，必须先读取 PRD、PROJECT_STATE、ROADMAP/版本计划、DECISIONS、SECURITY 与 RUNBOOK，并用自己的话复述当前完成项、真实风险和下一步唯一动作。遇到路径、身份、提示符或输出不确定时必须停止，不猜。

26. 术语表

术语	定义
PRD	产品需求文档，定义产品目标、范围、功能、规则与验收。
MVP	最小可行版本，用最少范围验证核心价值，不等于粗糙或无验收。
静态站点	构建时生成 HTML/CSS/JS 文件，访问时不依赖动态数据库即可阅读。
Content Collection	对 Markdown/MDX 内容进行分类和字段校验的内容集合。
Slug	URL 中用于标识内容的稳定字符串。
Canonical	告诉搜索引擎某内容的唯一规范 URL。
Release	一次可独立部署和回滚的完整站点构建版本。
current	指向当前线上 release 的软链接或等价引用。
incoming	AI/开发可提交构建产物但不能直接上线的交稿区。
Audit	只读检查角色。
Deploy	只能交付构建产物的受限角色。
Publisher	经人工批准后执行正式发布、健康检查和回滚的角色/程序。
外置记忆	用项目文件保存状态和决策，使项目不依赖某个聊天窗口记忆。
假完成	把“出现界面、能启动、能加载”等局部阶段误写成完整可用。

附录 A：首批内容清单

栏目	建议标题	目的
起源	荒漠里盛开的无人区玫瑰	网站置顶母故事
施工现场	踩完所有坑后，我居然觉得丑黑框有点可爱	终端与建站现场
施工现场	AI 一压缩就像失忆：我看着它从全绿写到满屏报错	上下文失忆观察
施工现场	模型显示 True，却不回复“你好”	本地模型故障实录
方法	我不会写代码，所以我给 AI 发了两张工牌	最小权限法
方法	先测试，后修复：为什么不允许 AI 边查边改	验收与范围控制
项目	一个网站怎样从复杂实验室退回到能活下去的博客	产品取舍与项目状态

附录 B：内容 Frontmatter 示例

title: “模型显示 True，却不回复‘你好’”
slug: “model-loaded-but-no-reply”
type: “log”
status: “检修中”
summary: “模型已经完成加载，但消息发送后没有有效回复。本文记录当时环境、症状、排查过程与尚未解决的边界。”
publishedAt: “2026-08-05”
updatedAt: “2026-08-05”
sourceLabel: “原创实录”
tags: [“本地模型”, “移动端”, “故障排查”]
project: “xingyu-local-ai”
draft: false
seo:
noindex: false

附录 C：发布前检查清单

□ 页面目标与 PRD 一致，没有新增未批准范围。
□ 标题、摘要、状态、日期、来源标签和关联项目完整。
□ 外部事实已核验；无法确认的内容明确标注。
□ 截图、下载和文档已完成隐私与元数据检查。
□ 桌面、平板、手机宽度均无溢出、遮挡和不可点击。
□ 键盘、焦点、alt、标题层级和减少动态通过检查。
□ 内部链接、外链、图片、下载和 404 正常。
□ TypeScript、Lint、测试、构建、内容 schema 和链接检查通过。
□ SEO 元信息、canonical、sitemap、robots 和验证 meta 正确。
□ 预览已由产品负责人批准。
□ 新 release、文件权限、健康检查和回滚点已准备。
□ 发布记录、CHANGELOG 和 PROJECT_STATE 已更新。

附录 D：通用需求卡模板

字段	填写说明
需求名称	用用户可理解的结果描述，不写纯技术动作
需求 ID	唯一编号，如 FR-039
背景/问题	谁在什么场景遇到什么问题
目标	希望改变什么行为或结果
范围	本次明确做什么
非范围	本次明确不做什么
业务规则	状态、权限、边界、异常和内容规则
交互/页面	入口、步骤、反馈、空状态、错误状态
数据/内容字段	新增或修改的字段与校验
依赖	内容、设计、技术、外部服务、安全、服务器
验收标准	可重复执行的 Given/When/Then 或步骤与预期
风险与回滚	失败影响、保护措施与恢复方式
优先级/版本	P0/P1/P2/暂缓与目标版本
批准人/日期	进入开发前必须确认

附录 E：PRD 与其他文档的边界

文档	回答的问题	与本 PRD 的关系
视觉设计稿/组件规范	具体长什么样、组件状态与尺寸	不得改变页面任务与功能范围
技术方案	系统如何实现、架构、依赖与部署	必须满足非功能、安全与可迁移要求
数据字典/内容 Schema	字段、枚举、校验和关联	落实第 11 章
测试计划与用例	如何验证每条需求	覆盖第 22 章及所有需求 ID
部署手册/RUNBOOK	如何构建、发布、健康检查与回滚	落实第 20 章
SECURITY.md	账号、权限、秘密和响应规则	不得低于第 19 章
PROJECT_STATE/AI_HANDOFF	当前做到哪里和下一步	保证长期接力，不替代 PRD

最终产品判断通用数字产品的成功不是“页面看起来像一个成熟公司”，而是任何读者都能看懂真实发生了什么、项目真正做到哪一步、哪些方法可以带走；任何协作者都能依据同一套规则继续建设，而不会因为换窗口、换模型或换平台让项目重新归零。

—— PRD V1.0 结束 ——