# CLAUDE.md

本项目的 AI 修改代码规范统一维护在仓库根目录的 [AGENTS.md](./AGENTS.md)，以该文件为准，请先完整阅读并遵守。核心规则：

1. **提交信息必须使用英文**（Conventional Commits：`<type>(<scope>): <subject>`）。
2. **代码样式必须使用 Tailwind CSS**（v4，语义 token 见 `src/ui/design-system.css`，禁止内联静态样式与硬编码颜色）。
3. **文案提示必须使用多语言** · 所有 UI 文案必须同时支持英文与简体中文（en + zh-CN），新增/重命名 i18n key 时由类型系统强制对齐两侧；详细规范见 [AGENTS.md §3](./AGENTS.md#3-文案提示必须使用多语言--ui-copy-must-be-bilingual-en--zh-cn)。
4. **打 tag 必须同步更新 website/ 版本号** · `git tag vX.Y.Z` 之前必须先 bump 根 `package.json` 并同步 `website/index.html` 与 `website/index-zh.html` 中的版本号字符串；三处必须字面一致；详细规范见 [AGENTS.md §4](./AGENTS.md#4-打-tag-必须同步更新-website-版本号--tagging-must-bump-website-version)。

收尾自检：`pnpm typecheck`、`pnpm test`；涉及 UI / manifest / 构建配置时加跑 `pnpm build`。