0001 · 网站方向
静态网站、内容、质量与部署的拟定方案。
英文版本 为准，本文供参考。
状态：方案提议，应用实现尚未授权。 本记录明确网站方向；当前文档基线见 0002 ，协作规则见 AGENTS 。本方案尚无应用代码、PR、构建或部署；未来开始实现前，须与用户确定该任务的审查选择。
需求
- 易维护的个人网站，含 Projects 和 Experience，不设 Research Tab。通过 Markdown/MDX 管理条目，增加内容无需修改页面组件。
- 界面和内容英文为主、简体中文参考，英文位于
/、中文位于/zh/，支持语言切换。不虚构个人成果，发布页面排除草稿；私密草稿内容不得放入公开仓库。 - 使用 OINK 建立独立公开 PR log 网站，每项变更以一篇完整文章展示需求、决策、执行及验收。
- 使用 pnpm、有效测试和简单 CI/CD；PR 合并前必需检查通过，合并后自动部署。原创仓库材料使用 Apache-2.0，并遵守第三方许可。
最终视觉设计、个人简介更新、博客整合、域名及替换现有线上网站，仍须用户决定后才能开展依赖这些决定的实现。
计划与决策
| 方面 | 方向及理由 |
|---|---|
| 个人站 | Astro 静态输出、TypeScript、Markdown collections。预渲染适合以内容为主的网站，无需请求时运行应用服务器。实现时核实依赖/工具的最新稳定版，按共享版本规则固定精确版本并提交 pnpm 锁文件。 |
| 交互 | 先用 CSS 并支持减少动态效果；选定设计有需要时才加入浏览器 JavaScript 或独立 Three.js 交互。React/MUI 不作为基础依赖，当前内容页面尚不需要其组件/运行时层。 |
| 日志 | 从仓库日志文章构建独立 Hugo/OINK 站，不维护重复内容；复用协作指南放 docs/。 |
| 托管 | 两个生成站点以 Cloudflare Workers Static Assets 为目标。实现前核实最新限制、构建配置及部署行为；本次文档基线不含生产设置。 |
| 质量 | 计划冻结依赖安装、类型/内容检查、路由/草稿排除/翻译覆盖测试、两站静态构建及浏览器验收。包含有用的失败用例，不写仅重复实现的测试。 |
| 发布 | PR 任务不使用部署密钥；合并后部署已检查的 main 产物，并用仓库规则强制 PR 及必需检查。 |
| 部署顺序 | 串行生产上传，并在上传前立即检查待部署版本仍为 main 最新版本。仅有锁仍允许旧任务重跑覆盖新版；跳过过时任务，已开始上传的任务完成后再退出，并考虑两站不能原子发布。 |
实现应遵循以下依赖顺序：内容/路由 → 视觉设计及选定交互 → 独立日志 → 测试及 CI/CD → 验收。实现获授权后，仍须制定包含具体任务和工具版本的当前执行计划。
执行
网站方向已形成文档，尚未加入应用代码、依赖、测试、CI/CD 或托管配置。协作和审查步骤见开发流程 。
验收
计划验证：干净安装及静态构建、Markdown 生成路由、草稿排除、双语覆盖、有效正反测试、OINK 导航/搜索、PR 及部署行为。这些检查尚未运行。 本提议不代表实现已验收或获准部署。