面向 AI agent 的仓库维护说明。人类投稿者请看站点贡献指南。
武汉大学动漫协会（武大漫协 / WHUDAYS）社团历史存档站。VitePress 静态站，GitHub Pages 部署，正式域名 whudays.org。
- 内容源在
docs/，VitePress 配置在docs/.vitepress/config.js - 本地预览
pnpm dev，构建pnpm build
- 站内链接用绝对路径（
/group/...），禁用相对路径。构建期有死链检查，失效链接会让pnpm build失败、阻断部署。 - 新增页面必须同步侧边栏：在
docs/.vitepress/config.js的themeConfig.sidebar对应区域手动登记，否则页面不出现在导航。 - 改动后跑
pnpm build验证能通过再提交。 - commit 不要带 AI 的 Co-Authors——这是社区硬性规矩，带了会被拒。
- commit message 用中文，描述清楚"为什么"。
- 内容：Markdown 放
docs/<区域>/（activity/about/department/group/message-box/maintainer） - 资源：图片等放
docs/public/的镜像目录，页面用绝对路径引用（public= 站点根）。如docs/public/activity/2024/x.jpg→ 页面写/activity/2024/x.jpg - 年份 = 学年：
2024指 2024 学年（2024.6–2025.6），与干部任期一致
新增内容时优先模仿同区域的现有页面，再按需登记侧边栏：
| 任务 | 参考现有文件 |
|---|---|
| 加活动页 | docs/activity/2024/winter-festival.md |
| 加成员卡 | docs/activity/2025/welcome-party/credits.md |
| 加留声箱 | docs/message-box/quq/words.md |
| 加部门/小群 | docs/department/ 或 docs/group/ 下任一 |
docs/.vitepress/theme/ 注册了两个全局组件，必须用 <ClientOnly> 包裹（否则 SSR/hydration 报错）：
ChatMessage：对话气泡。仅docs/about/introduction.md中使用。propsavatar/nickname/message（支持 HTML）/position。例：MemberCard：成员卡。仅在docs/group/vocaloid-utau-fans中使用。propsname/avatar/description/link/:badges/:socials
为插件添加了 patch(patches/@nolebase__vitepress-plugin-git-changelog@2.17.1.patch) 以显示贡献者名称
用法细节见站点贡献指南。
统一参考和修改 docs/.vitepress/data/people.js。
- 头像复用：若某一成员的头像已存在，请直接复用，不要新建条目。暂无头像可缺省，会自动回退到占位图。
- 贡献者别名映射：
people.js同时作为gitChangelog的作者数据源。如果成员是仓库提交者（有 GitHub），需在其数据对象中补充github字段，并根据 Git 历史配置mapByNameAliases和mapByEmailAliases，插件才能将不同机器上的 commit 正确归拢到同一作者卡片下。