内容指南

English 为准，本页为中文参考。

内容位置

复制最接近的 <key>.en.md / <key>.zh.md 文件对。translationKey 和 slug 保持一致，标题、摘要、正文及展示标签均须翻译。slug 只用小写单词／数字及单个连字符。数字 order 越小越靠前：首页展示前两个重点项目，其余以紧凑列表呈现。

通用字段为 lang、translationKey、slug、title、summary、draft、order。draft: true 不进入构建；已发布条目必须有双语，两份文件的 slug 和草稿状态一致。公开 Git 仍能读取草稿源码，不得存放私人内容。

项目还需 year、category（ai、systems、interfaces）、art（cloud、laife、cat、asl、signals）、role、period、result、eyebrow、tags，可选已获准使用的本地 image。选择适合的现有插图；新增视觉属于设计改动。经历需 organization、period、year、highlights、metric、metricLabel。成果必须保留原任务与数据集语境。

个人资料提供 introduction、about.identity、about.paragraphs、shortBio、education、分组 skills 和职位／学校／学位信息。Markdown 正文用于经历页较长的自我介绍。修改事实时保持这些位置及中英文对应一致。

每个项目／经历至少提供公开 HTTPS sources 或经过认可的 sourceNote。获准使用的简历内容应如实标明来源，不暴露原文件名、路径、联系信息或 PDF，不得填入无关公开链接。根目录 PDF 输入被 Git 忽略，必须位于 public/ 和 Hugo 挂载目录之外。

执行 pnpm verify。新增双语 Markdown 文件可直接生成路由，无须修改组件；真实构建测试检查新增内容、草稿隐藏、缺少翻译及不合法 slug。

工程记录

遵循流程 ，每次改动使用一篇英文与一篇中文参考。Hugo 直接读取记录、根目录协作文档及 docs/。使用仓库相对链接，有真实 PR 后再补充元信息，把需求、决策、选定审查和实际结果集中在同一文章对中。

临时中文验收手册放在被忽略的 .local/acceptance/，不在 Hugo 挂载范围内。公开日志及搜索索引不得包含原始会话或私人证据。