「规矩」：这个网站怎么建、内容怎么发、AI 怎么搭手

一、这个站是什么#

站名叫「永恒欲望」，域名 stulanez.com。技术上是一套 Astro 7 + Svelte 5 + TypeScript 的静态站，包管理只用 pnpm，代码风格跟 Biome 走：tab 缩进、双引号。

目录就记住几个：页面在 src/pages，布局在 src/layouts，组件在 src/components，文章在 src/content/posts，样式在 src/styles，站点配置在 src/config（优先从 @/config 导入）。静态资源放 public，源码图片放 src/assets。

二、改代码的规矩#

• 本地开发 pnpm dev，验证改动静置三件套：pnpm check、pnpm type-check、pnpm build。视觉和交互上的改动，在 dev 或 preview 里亲眼看过再算完成。
• pnpm format 和 pnpm lint 会改写整个 src 和 scripts，不在共享工作区里全量跑，只对本次动过的文件定向处理。
• 构建时会自动生成一些文件：图片占位数据 src/constants/lqips.json、GitHub 卡片数据 github-card-data.json、VNDB 封面。这些是产物，不要手改；动了相关资产就让构建重新生成。
• 网站内部有一批 /lab/* 工具页（下载名单、清理监控之类），成熟前一律不上线。现在靠三层保护：生产中间件直接 404、构建后把 dist/lab 删掉、Vercel 路由兜底 404。动这一块时三层要一起理解，别觉得加个 noindex 就算藏住了。
• 改滚动、背景、侧栏这类常驻效果，保持 rAF 节流，别逐帧读布局，别上全屏模糊。

三、发内容的规矩#

• 文章是 src/content/posts 下的 MDX。文章想配什么展示框架（交互演示、专用阅读器），就动手做配套组件，但普通文章不强行套小说阅读器。
• MDX 里挂了组件，就必须在 frontmatter 后面 import 它，然后打开文章页亲眼确认渲染。pnpm check 查不出漏 import，这是踩过的坑。
• 新文章封面一律通过 Grok API 现场新生成，不复用站内旧图、旧封面。凭证只在本机，不进日志、不进提交。图里不要硬生成中文标题——AI 生成的中文字不可靠，标题交给网页排版。
• 写给读者的话要解释术语、短句分段、数字真实。内容完成后自行提交推送，不用等我点头。

四、提交与部署#

• 提交信息走 Conventional Commits；只暂存本次明确动过的路径，提交前看一眼暂存列表。
• 几条硬红线：不 git add . / git add -A / git commit -a，不 git stash、git reset --hard、git clean，不强推。
• 生产由 Vercel 监听 main 分支自动构建上线。推送成功只代表代码进了仓库，不代表网站已更新——说「已上线」必须有目标平台的部署记录或页面核验，不能用本地 build 成功来冒充。
• 新增需要服务端运行的接口，要确认适配器配置还在，别回退成纯静态配置。这类配置问题曾经导致推送成功但生产停在旧版本。
• 密钥、Cookie、个人素材、本地运行数据一律不进仓库；.ai-work/ 是临时工作区，永不提交。

五、协作纪律#

现在跟我搭手的 AI 不再看板打卡了，但几条底线保留下来：

• 我的当前指令优先于任何历史记录里的「下一步计划」。
• 开工前先看 git status：别人没提交的修改，一律保留，不去还原、覆盖、格式化。
• 一个路径同一时间只有一个人动；撞了就只停冲突的路径，别的不耽误。
• 有话直说，用大白话向我汇报；进度诚实，不捏造验收、截图和上线结果。
• 拿不准的事先问一句，但能自己查证的别拿去烦我。

六、站长与游客#

这个站要分清两种人：我是站长，其余来访者都是游客。站长身份不走登录后台，按设备认定——哪台设备算站长，由我直接指定，AI 把设备清单记在仓库根目录的 AGENTS.md 里（目前只有本机一台）。

落到页面上的规矩：

• 每一块界面先想清楚「这是给谁用的」。相册、图库这类页面，游客看到的是「参观」视角：看展、按站内已有的方式取用，到此为止。「选择图库」、上传、整理、改配置这类维护入口只对站长设备出现，绝不进游客的界面。
• 反过来也一样：站长的界面上，该有的维护能力不能因为怕游客看见就阉割掉，身份分清楚就行。
• 站长识别目前是轻量做法（设备标记 + AI 记账），没有密码和后台。等真正需要服务端权限的功能出现时再补硬校验，但「游客界面不出现管理入口」这条从现在起就生效。

七、图库和资产#

数字资产库的采集、判图、去重、分类操作规程单独放在仓库的 docs/ai/assets.md，那部分是操作手册，不并入这篇。对外的规则只有一条：站上展示的资产要干净、有来源意识，个人素材和未授权的私货不上站。

更新记录#

• 2026-09-16：初版。停用 AI 协作看板及认领/短锁/在线状态体系；原「网站协议」「部署协议」「内容发布说明」「写入协作协议」四份文档并入本文，作为本站唯一长期协议。
• 2026-09-17：新增「六、站长与游客」：站长按设备认定、不设登录后台，维护类界面只对站长设备出现，游客界面一律不出现管理入口；原「图库和资产」顺延为第七节。
• 2026-09-22：下线视频总结页与艺术馆半成品；「站长与游客」举例改为相册、图库。