tootaio.com/AGENTS.md

当然可以，下面是完整的中文翻译版，保持了原文的结构与语气，适合直接放在项目的 AGENTS.zh-CN.md 中使用👇

---

仓库指南（Repository Guidelines）

本仓库托管了 Tootaio Studio 网站项目，基于 Nuxt 4、@nuxt/content、@nuxt/ui 和 i18n 构建。 项目使用 pnpm 进行全部工作流程。

---

项目结构与模块组织

• app/ — Nuxt 应用源码目录，包含：pages/、layouts/、assets/、composables/、utils/ 等（例如：app/pages/index.vue）。
• content/ — 基于 YAML 的多语言内容文件（如：content/en-US、content/zh-CN）。内容结构定义在 content.config.ts 中。
• i18n/ — UI 翻译文件（JSON 格式），位于 i18n/locales/<locale>/。
• public/ — 静态资源目录，内容将原样提供给客户端。
• 根级配置文件包括：nuxt.config.ts、eslint.config.mjs、pnpm-workspace.yaml。项目文档存放于 docs/。

---

构建、测试与开发命令

• 安装依赖：pnpm i（会自动执行 nuxt prepare）
• 开发服务器：pnpm dev — 启动后访问 http://localhost:3000，支持 HMR。
• 生产构建：pnpm build — 生成 .output/ 目录。
• 预览构建：pnpm preview — 以生产模式运行构建产物。
• 静态生成：pnpm generate — 执行 SSG（静态站点生成）。
• 代码检查：pnpm exec eslint .（手动执行时使用；CI 流程中会自动运行）。

---

代码风格与命名规范

• 使用 TypeScript 与 Vue 3 <script setup lang="ts">；配置文件采用 ESM 模块 格式。
• 缩进统一为 2 空格；保持与现有代码库的引号与风格一致。
• Vue 单文件组件（SFC）位于 pages/ 下，文件名简洁（例如：webDev.vue）； 自定义组合式函数（composables）使用 PascalCase（如：LocalizedCollection.ts）。
• ESLint 通过 @nuxt/eslint 配置，依赖编辑器集成与 CI/构建阶段反馈。
• i18n 多语言 key 使用 点号嵌套命名法，例如：$t('index.featuredProjects.viewDemo')。

---

测试指南

• 当前尚未配置自动化测试。 推荐在未来使用 Vitest 进行单元测试，Playwright 进行端到端（e2e）测试。

• 在此之前，请进行本地验证：

  • 运行 pnpm dev；
  • 切换多语言；
  • 检查 content/*.yml 是否符合 content.config.ts 中的 schema；
  • 确认 pnpm build 与 pnpm preview 能成功执行。

---

提交与 Pull Request 规范

• 遵循 Conventional Commits 规范，并带有 scope（可参考提交历史）：

  • 示例：feat(content): …、refactor(ui): …、feat(pages): …

• 分支命名格式：

  • feat/<简短描述>、fix/<简短描述>

• Pull Request 要包含以下信息：

  • 改动目的
  • 关联的 Issue（如有）
  • UI 改动截图
  • 测试步骤
  • 若涉及内容文件，请确保 中英文版本同步更新。

---

内容与多语言（i18n）建议

• 在 content/en-US/ 与 content/zh-CN/ 下维护平行的内容文件。 若新增页面类型，请同时扩展 content.config.ts 的 schema。
• 使用 useLocalizedCollection('index') 或类似函数来获取内容，以获得类型支持与语言回退（fallback）。
• 保持多语言翻译文件在各个 locale 目录下同步更新：i18n/locales/<locale>/。

---

是否希望我帮你把这份翻译排版成一个更正式、带 Front Matter 的文档版本（例如带 title, lastUpdated, description 的 YAML 头部），以便直接放进 Nuxt Content 或 docs 目录？