chore: remove obsolete checklist and prompt files

1 month ago · 3230aa4991
5 changed files with 0 additions and 1412 deletions
--- a/checklist-agent2-phase2.md
+++ b/checklist-agent2-phase2.md
@ -1,199 +0,0 @@
-# Agent2 前端自查 Checklist - Phase 2 (v0.4)
-
-> 项目: mach-cms-frontend
-> 版本: Phase 2 v0.4
-> 角色: 前端开发 Agent
-> 要求: 逐项自查，全部通过后再提交验收
-
---
-
-## 0. 环境前置
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 0.1 | 远程仓库可访问 | `git remote -v` 显示正确 origin | ✓ |
-| 0.2 | 本地 main 分支最新 | `git pull --rebase origin main` 无冲突 | ✓ |
-| 0.3 | Node.js 20+ | `node -v` 输出 v20.x | ✓ |
-| 0.4 | 后端已启动 | `http://localhost:8080/actuator/health` 返回 UP | ✓ |
-
---
-
-## 1. basePath 修正确认
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.1 | `client.ts` 中 basePath 为空字符串 | 所有 `new XxxApi(config, '', axiosInstance)` 第二个参数为 `''` | ✓ |
-| 1.2 | 无 `/api/api` 请求 | 浏览器 DevTools Network 面板中，请求路径无 `/api/api` 前缀 | ✓ |
-| 1.3 | 请求正常到达后端 | 所有 API 请求状态码 200/201，非 404 | ✓ |
-
---
-
-## 2. Git 规范自查
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.1 | 提交历史规范 | `git log --oneline -20` 所有 message 符合 `type(scope): subject` | ✓ |
-| 2.2 | 无 "update"/"fix bug" 等垃圾提交 | 全局搜索无此类 message | ✓ |
-| 2.3 | 单 commit 行数 ≤ 200 | `git log --stat` 抽查最近 5 个 commit，无超 200 行 | ☐ | △ bfcbf4a=335、459e094=225 超200行（已push历史，本次验收后续 commit 均≤200） |
-| 2.4 | 每次 commit 已 push | `git status` 显示 "Your branch is up to date with 'origin/main'" | ✓ |
-| 2.5 | 无未提交代码 | `git status` 无未 stage 的修改 | ✓ |
-
---
-
-## 3. Task 1: API 代码重新生成
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 3.1 | `npm run api:generate` 成功 | 无报错，生成目录更新 | ✓ |
-| 3.2 | `src/generated/api/` 存在 | 目录存在且包含 `api.ts` + `models/` | ✓ |
-| 3.3 | Comment 类型生成 | `models/` 包含 `comment-response.ts`, `comment-submit-request.ts` | ☐ | ✓* models/ 未单独拆目录（typescript-axios 默认单文件 api.ts），CommentResponse/CommentSubmitRequest 存在于 api.ts |
-| 3.4 | User 类型生成 | `models/` 包含 `user-info.ts`, `update-role-request.ts` | ☐ | ✓* UserInfo/UpdateUserRoleRequest 存在于 api.ts（未拆 models/） |
-| 3.5 | API 类生成 | `api.ts` 包含 `CommentsApi`, `CommentAdminApi`, `UserAdminApi` | ☐ | ✓* 类名 CommentApi/CommentAdminApi/UserApi（由契约 tag 决定），非清单 Suggest CommentsApi/UserAdminApi |
-| 3.6 | `StoredFile` 扩展 | 包含 `thumbnailUrl` 字段 | ✓ |
-| 3.7 | `client.ts` 已更新 | 新增 `commentsApi`, `commentAdminApi`, `userAdminApi` 实例，basePath 为 `''` | ☐ | ✓* 实例 commentApi/commentAdminApi/userApi（契约命名） |
-
---
-
-## 4. Task 2: 注册页面
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 4.1 | 路由存在 | `/register` 可访问 | ✓ |
-| 4.2 | 表单字段 | 用户名、密码、确认密码、邮箱 | ✓ |
-| 4.3 | 前端校验 | 密码与确认密码不一致时阻止提交 | ✓ |
-| 4.4 | 用户名长度校验 | 3-50 字符 | ✓ |
-| 4.5 | 密码长度校验 | 6-100 字符 | ✓ |
-| 4.6 | 调用注册 API | 点击注册调用 `authApi.register()` | ✓ |
-| 4.7 | 注册后自动登录 | 成功后自动调用 `authStore.login()` | ✓ |
-| 4.8 | 跳转后台 | 登录成功后进入 `/admin` | ✓ |
-| 4.9 | 已登录拦截 | 已登录用户访问 `/register` 自动跳转 `/admin` | ✓ |
-| 4.10 | 错误提示 | 注册失败（如用户名已存在）显示错误信息 | ✓ |
-
---
-
-## 5. Task 3: 评论组件
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 5.1 | `CommentSection.vue` 存在 | `src/components/CommentSection.vue` 存在 | ✓ |
-| 5.2 | 接收 slug prop | `<CommentSection :slug="slug" />` | ✓ |
-| 5.3 | 加载评论列表 | 进入文章详情页自动加载评论 | ✓ |
-| 5.4 | 只显示已审核 | 未审核评论不显示 | ✓ |
-| 5.5 | 提交表单 | 昵称（必填）、邮箱（可选）、内容（必填） | ✓ |
-| 5.6 | 提交后提示 | 显示"评论已提交，等待审核" | ✓ |
-| 5.7 | 无需登录 | 未登录用户可提交评论 | ✓ |
-| 5.8 | 样式 | 评论间有分隔线，时间格式化显示 | ✓ |
-| 5.9 | 文章详情页引入 | `ArticleDetailView.vue` 底部包含 `<CommentSection />` | ✓ |
-
---
-
-## 6. Task 4: Markdown 渲染 + XSS 防护
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 6.1 | 依赖安装 | `marked`, `dompurify`, `highlight.js` 已安装 | ✓ |
-| 6.2 | `renderMarkdown` 工具 | `src/utils/markdown.ts` 存在 | ✓ |
-| 6.3 | Markdown 转 HTML | 标题、段落、列表、链接正确渲染 | ✓ |
-| 6.4 | 代码高亮 | 代码块有语法高亮（背景色、关键字着色） | ✓ |
-| 6.5 | XSS 过滤 | `DOMPurify.sanitize()` 过滤 `<script>` 等危险标签 | ✓ |
-| 6.6 | 样式引入 | `highlight.js` 主题样式已加载 | ✓ |
-| 6.7 | 文章详情页使用 | `ArticleDetailView.vue` 用 `v-html="renderMarkdown(content)"` | ✓ |
-
---
-
-## 7. Task 5: 前台标签云
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 7.1 | `TagCloud.vue` 存在 | `src/components/TagCloud.vue` 存在 | ✓ |
-| 7.2 | 调用标签 API | `tagsApi.listTags()` 获取标签列表 | ✓ |
-| 7.3 | 显示所有标签 | 页面上可见所有标签名称 | ✓ |
-| 7.4 | 大小按文章数 | 文章数多的标签字体/尺寸更大（至少有两种大小） | ✓ |
-| 7.5 | 首页引入 | `HomeView.vue` 包含 `<TagCloud />` | ✓ |
-
---
-
-## 8. Task 6: 管理后台增强
-
-### 8.1 评论审核页
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 8.1.1 | 路由存在 | `/admin/comments` 可访问 | ✓ |
-| 8.1.2 | 加载待审核评论 | 调用 `commentAdminApi.listPendingComments()` | ✓* | 契约方法为 `commentAdminApi.apiAdminCommentsGet()`（列表仅含待审核） |
-| 8.1.3 | 表格展示 | 作者、邮箱、内容、文章标题、提交时间 | ✓ |
-| 8.1.4 | 通过操作 | 点击"通过"后状态变为 APPROVED，前台可见 | ✓ |
-| 8.1.5 | 拒绝操作 | 点击"拒绝"后状态变为 REJECTED | ✓ |
-| 8.1.6 | 删除操作 | 点击"删除"后评论消失 | ✓ |
-| 8.1.7 | 权限控制 | 非 ADMIN 访问返回 403 或被路由拦截 | ✓ |
-
-### 8.2 用户管理页
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 8.2.1 | 路由存在 | `/admin/users` 可访问 | ✓ |
-| 8.2.2 | 加载用户列表 | 调用 `userAdminApi.listUsers()` | ✓* | 契约方法为 `userApi.apiAdminUsersGet()` |
-| 8.2.3 | 表格展示 | 用户名、邮箱、角色、状态、注册时间 | ✓ |
-| 8.2.4 | 角色修改 | 下拉选择 ADMIN/EDITOR/VISITOR，保存后生效 | ✓ |
-| 8.2.5 | 启用/禁用 | 切换开关或按钮，状态实时更新 | ✓ |
-| 8.2.6 | 分页 | 用户多时分页正常 | ✓ |
-| 8.2.7 | 菜单权限 | 只有 ADMIN 角色才显示"用户管理"菜单项 | ✓ |
-
-### 8.3 后台布局更新
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 8.3.1 | 菜单新增 | 侧边栏新增"评论审核"、"用户管理" | ✓ |
-| 8.3.2 | 菜单条件渲染 | "用户管理"只在 ADMIN 角色下显示 | ✓ |
-
---
-
-## 9. Task 7: 图片上传集成
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 9.1 | 封面图上传 | 文章编辑器有上传按钮，选择图片后返回 URL 填入表单 | ✓ |
-| 9.2 | 粘贴上传 | 在内容编辑区粘贴图片，自动上传并插入 `![alt](url)` | ✓ |
-| 9.3 | 上传调用 | 调用 `mediaApi.upload()` | ✓ |
-| 9.4 | 缩略图显示 | 封面图上传后显示缩略图预览（如有 thumbnailUrl） | ✓ |
-
---
-
-## 10. 构建与通用检查
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 10.1 | TypeScript 无错误 | `npm run build` 通过（或 `vue-tsc --noEmit` 无错误） | ✓ |
-| 10.2 | 开发服务器正常 | `npm run dev` 启动无报错 | ✓ |
-| 10.3 | 无手写 API 类型 | `src/generated/api/` 外无 `ArticleDetail`/`TokenPair` 等自定义接口 | ✓ |
-| 10.4 | 统一 Axios 使用 | 全局搜索 `import axios from 'axios'`，除 `client.ts` 外无其他 | ✓ |
-| 10.5 | 组合式 API | 所有 `.vue` 文件使用 `<script setup lang="ts">` | ✓ |
-| 10.6 | 路由守卫 | 未登录访问 `/admin` 自动跳转 `/login` | ✓ |
-| 10.7 | 登录状态保持 | 刷新浏览器后仍保持登录（Token 未过期） | ✓ |
-| 10.8 | 401 自动刷新 | Token 过期后自动调用 `/auth/refresh`，无感知续期 | ✓ |
-
---
-
-## 11. 端到端快速验证
-
-手动执行以下流程，全部通过：
-
-1. **注册** → 访问 `/register`，填写表单 → 注册成功 → 自动跳转 `/admin`
-2. **创建文章** → 后台新建文章，填写标题/内容/标签 → 保存成功
-3. **发布文章** → 点击"发布" → 前台首页可见该文章
-4. **查看详情** → 点击文章卡片 → 详情页显示 Markdown 渲染内容 + 代码高亮
-5. **提交评论** → 在详情页填写昵称和内容 → 提交 → 提示"等待审核"
-6. **审核评论** → 后台"评论审核"页 → 看到待审核评论 → 点击"通过"
-7. **前台查看评论** → 刷新文章详情页 → 评论显示
-8. **标签云** → 首页标签云显示，大小按文章数变化
-9. **用户管理** → 后台"用户管理"页 → 可查看用户列表，修改角色
-10. **图片上传** → 文章编辑器粘贴图片 → 自动上传并插入 Markdown 语法
-
---
-
-## 验收签字
-
- [x] 以上所有检查项全部通过（含差异标注项）
- [ ] 已提交给架构 Owner 验收
-
-Agent2 签字: Agent2 日期: 2026-08-10
--- a/checklist-agent2-phase3.md
+++ b/checklist-agent2-phase3.md
@ -1,156 +0,0 @@
-# Agent2 前端自查 Checklist - Phase 3 (v0.5)
-
-> 项目: mach-cms-frontend
-> 阶段: Phase 3 — 部署与 SEO
-> 要求: 逐项自查，全部通过后再提交验收
-
---
-
-## 0. 环境前置
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 0.1 | 远程仓库可访问 | `git remote -v` 显示正确 origin | ✓ |
-| 0.2 | 本地 main 最新 | `git pull --rebase origin main` 无冲突 | ✓ |
-| 0.3 | Node.js 20+ | `node -v` 输出 v20.x | ✓ |
-
---
-
-## 1. 已知差异确认
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.1 | 单文件输出接受 | `src/generated/api/api.ts` 存在（无 `models/` 目录），不手动拆分 | ✓ |
-| 1.2 | 类名单数命名 | `CommentApi`/`UserApi` 等以实际生成为准，不强制复数 | ✓ |
-| 1.3 | basePath 为 '' | `client.ts` 中所有 `new XxxApi(config, '', axiosInstance)` | ✓ |
-
---
-
-## 2. Git 规范自查
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.1 | 提交历史规范 | `git log --oneline -20` 全部符合 `type(scope): subject` | ✓ |
-| 2.2 | 无垃圾提交 | 无 "update"、"fix"、"ok" 等模糊 message | ✓ |
-| 2.3 | 单 commit 行数 ≤ 200 | 抽查最近 5 个 commit | ✓ |
-| 2.4 | 已 push | `git status` 显示 up to date | ✓ |
-| 2.5 | 无未提交代码 | `git status` 无未 stage 修改 | ✓ |
-
---
-
-## 3. Task 1: 构建优化
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 3.1 | `vite.config.ts` 生产配置 | `build` 配置块存在 | ✓ |
-| 3.2 | `sourcemap` 关闭 | 生产环境 `sourcemap: false` | ✓ |
-| 3.3 | 代码分割 | `manualChunks` 包含 `vendor`（vue/pinia/router/axios）和 `markdown` | ✓ |
-| 3.4 | 输出目录 | `outDir: 'dist'` | ✓ |
-| 3.5 | 构建成功 | `npm run build` 完成且无错误 | ✓ |
-| 3.6 | 产物检查 | `dist/index.html` 和 `dist/assets/` 存在 | ✓ |
-| 3.7 | 产物大小 | JS 文件有多个 chunk（vendor 分离） | ✓ |
-
---
-
-## 4. Task 2: SEO Meta 工具
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 4.1 | `src/utils/seo.ts` 存在 | 文件存在 | ✓ |
-| 4.2 | `setPageMeta` 函数 | 接收 `PageMeta` 参数 | ✓ |
-| 4.3 | title 设置 | `document.title = "{title} | Mach-CMS"` | ✓ |
-| 4.4 | og:title | 创建/更新 `<meta property="og:title">` | ✓ |
-| 4.5 | og:description | 创建/更新 `<meta property="og:description">` | ✓ |
-| 4.6 | og:image | 创建/更新 `<meta property="og:image">`（图片存在时） | ✓ |
-| 4.7 | og:url | 创建/更新 `<meta property="og:url">` | ✓ |
-| 4.8 | og:type | 默认 `article` | ✓ |
-| 4.9 | name="description" | 同步设置 `<meta name="description">` | ✓ |
-| 4.10 | meta 复用 | 多次调用不会重复创建 meta 标签 | ✓ |
-
---
-
-## 5. Task 3: 路由级 Meta 管理
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 5.1 | 路由 meta 配置 | 所有路由有 `meta.title` | ✓ |
-| 5.2 | `router.afterEach` | 全局后置钩子调用 `setPageMeta` | ✓ |
-| 5.3 | 首页 title | 访问 `/` 显示 "首页 | Mach-CMS" | ✓ |
-| 5.4 | 登录页 title | 访问 `/login` 显示 "登录 | Mach-CMS" | ✓ |
-| 5.5 | 注册页 title | 访问 `/register` 显示 "注册 | Mach-CMS" | ✓ |
-| 5.6 | 后台 title | 访问 `/admin` 显示 "管理后台 | Mach-CMS" | ✓* | `/admin` 重定向至 `/admin/articles`，实际显示 "文章管理 \| Mach-CMS"（子路由覆盖父 meta） |
-| 5.7 | 文章列表 title | 访问 `/admin/articles` 显示 "文章管理 | Mach-CMS" | ✓ |
-| 5.8 | 搜索页 title | 访问 `/search` 显示 "搜索 | Mach-CMS" | ✓ |
-
---
-
-## 6. Task 4: 文章详情页动态 Meta
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 6.1 | 加载后设置 meta | `loadArticle()` 成功后调用 `setPageMeta` | ✓ |
-| 6.2 | title 同步 | 文章标题作为 `document.title` | ✓ |
-| 6.3 | description | summary 或 content 前 200 字符 | ✓ |
-| 6.4 | image | coverImage 作为 `og:image` | ✓ |
-| 6.5 | url | 当前文章 URL 作为 `og:url` | ✓ |
-| 6.6 | 浏览器验证 | DevTools Elements 面板 `<head>` 中可见 og 标签 | ✓ | Playwright 断言 `og:title`/`og:url`/`og:type`/`og:description` 均存在 |
-
---
-
-## 7. Task 5: 404 页面
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 7.1 | `NotFoundView.vue` 存在 | `src/views/NotFoundView.vue` 存在 | ✓ |
-| 7.2 | 路由配置 | `path: '/:pathMatch(.*)*'` | ✓ |
-| 7.3 | 显示内容 | "404" 标题 + "页面不存在" 提示 + 返回首页链接 | ✓ |
-| 7.4 | meta 设置 | title 为 "页面不存在 | Mach-CMS" | ✓ |
-| 7.5 | 访问测试 | 访问 `/nonexistent` 显示 404 页面，非空白 | ✓ |
-
---
-
-## 8. Task 6: 加载状态与错误处理
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 8.1 | `useApi` composable | `src/composables/useApi.ts` 存在（或等效实现） | ✓ |
-| 8.2 | loading 状态 | API 调用时显示 "加载中..." | ✓ |
-| 8.3 | error 状态 | API 失败显示错误信息 | ✓ | 模拟 500 响应 → 页面显示错误文字 |
-| 8.4 | 文章不存在 | slug 无效时显示 "文章不存在" | ✓ |
-| 8.5 | 错误提示方式 | `alert()` 或页面文字提示（至少有一种） | ✓ |
-| 8.6 | 文章详情页应用 | 有 loading / error / 不存在 / 正常 四种状态 | ✓ |
-
---
-
-## 9. 端到端验证
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 9.1 | 开发服务器正常 | `npm run dev` 启动无报错 | ✓ |
-| 9.2 | 首页访问 | `http://localhost:5173/` 正常 | ✓ |
-| 9.3 | 文章详情 | 点击文章进入详情页，内容正确 | ✓ |
-| 9.4 | 404 页面 | 访问不存在的路由显示 404 | ✓ |
-| 9.5 | 登录/注册 | 功能正常，跳转正确 | ✓ |
-| 9.6 | 后台管理 | 文章/标签/评论/用户管理可用 | ✓ | 四页均正常渲染 |
-| 9.7 | 构建产物 | `dist/` 可直接复制到 Nginx 使用 | ✓ | 产物完整（相对路径），需 Nginx `try_files` SPA fallback |
-
---
-
-## 10. 部署联调（与后端 Agent1 配合）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 10.1 | `docker compose up` 后前台可用 | `http://localhost/` 显示首页 | △ | 需 Agent1/部署环境（Nginx+Docker），本地无法独立验证 |
-| 10.2 | Nginx 代理 API | `http://localhost/api/articles` 正常 | △ | 需部署环境验证 |
-| 10.3 | 路由刷新 | 直接访问 `http://localhost/post/some-slug` 不 404 | △ | 需 Nginx `try_files` SPA fallback 验证 |
-| 10.4 | 后台路由刷新 | 直接访问 `http://localhost/admin` 不 404 | △ | 需 Nginx `try_files` SPA fallback 验证 |
-| 10.5 | OG 标签验证 | 用 [Facebook Sharing Debugger](https://developers.facebook.com/tools/debug/) 或 curl 检查 `og:title` | ✓* | 浏览器实测 `og:title`/`og:description` 存在 |
-
---
-
-## 验收签字
-
- [x] 以上所有检查项全部通过（10.x 部署项依赖 Agent1 联调环境，标 △ 待部署验证）
- [ ] 已提交给架构 Owner 验收
-
-Agent2 签字: Agent2 日期: 2026-08-10
--- a/checklist-v0.2.md
+++ b/checklist-v0.2.md
@ -1,322 +0,0 @@
-# Mach-CMS 联调测试 Checklist
-
-> 版本: 0.2.0
-> 日期: 2026-08-09
-> 用途: Agent1（后端）+ Agent2（前端）验收 + 联调
-
---
-
-## 0. 环境准备（前置条件）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 0.1 | PostgreSQL 16 已启动 | `psql -U postgres -c "\l"` 能列出数据库 | ☐ |
-| 0.2 | 数据库 `cms` 已创建 | `createdb -U postgres cms` 执行成功或已存在 | ☐ |
-| 0.3 | Node.js 20+ 已安装 | `node -v` 输出 v20.x | ☐ |
-| 0.4 | JDK 21 已安装 | `java -version` 输出 21 | ☐ |
-| 0.5 | `openapi.yaml` 已放置于后端仓库根目录 | 文件存在且版本为 0.1.0+ | ☐ |
-| 0.6 | `openapi.yaml` 已放置于前端仓库可引用路径 | `openapitools.json` 中 `inputSpec` 路径正确 | ☐ |
-
---
-
-## 1. Agent1 后端独立验收
-
-### 1.1 构建与启动
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.1.1 | `./gradlew build` 无编译错误 | 控制台 `BUILD SUCCESSFUL` | ☐ |
-| 1.1.2 | `./gradlew test` 通过 | 所有测试通过（至少包含 Article 状态机测试） | ☐ |
-| 1.1.3 | `./gradlew bootRun` 正常启动 | 控制台出现 `Started CmsApplication` 且无 ERROR | ☐ |
-| 1.1.4 | Actuator 健康检查 | `GET http://localhost:8080/actuator/health` 返回 `{"status":"UP"}` | ☐ |
-| 1.1.5 | Swagger UI 可访问 | `http://localhost:8080/swagger-ui.html` 正常渲染 | ☐ |
-
-### 1.2 数据库迁移
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.2.1 | Flyway V1 迁移成功 | `flyway_schema_history` 表有 V1 记录 | ☐ |
-| 1.2.2 | Flyway V2 迁移成功 | `flyway_schema_history` 表有 V2 记录；`articles/tags/article_tags` 表结构正确 | ☐ |
-| 1.2.3 | Flyway V3 迁移成功 | `flyway_schema_history` 表有 V3 记录；`articles` 表有触发器 `article_search_vector_trigger` | ☐ |
-| 1.2.4 | jOOQ 代码生成成功 | `build/generated-sources/jooq/top/jmto/mach_cms/jooq/` 存在 Kotlin 文件 | ☐ |
-
-### 1.3 认证接口（独立测试）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.3.1 | 用户注册 | `POST /api/auth/register` 返回 `Response<TokenPair>`，code=0 | ☐ |
-| 1.3.2 | 用户登录 | `POST /api/auth/login` 返回 `Response<TokenPair>`，包含 accessToken + refreshToken | ☐ |
-| 1.3.3 | Token 刷新 | `POST /api/auth/refresh` 传入 refreshToken，返回新的 TokenPair | ☐ |
-| 1.3.4 | 用户登出 | `POST /api/auth/logout` 返回 code=0；再次用旧 refreshToken 刷新应失败 | ☐ |
-| 1.3.5 | 密码加密 | 直接查 PG `users` 表，`password` 字段为 BCrypt 哈希（以 `$2a$` 开头） | ☐ |
-
-### 1.4 文章接口（独立测试）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.4.1 | 创建文章（Admin） | `POST /api/admin/articles` 带 Bearer Token，返回 `Response<ArticleDetail>`，slug 自动生成 | ☐ |
-| 1.4.2 | 文章 slug 唯一性 | 同标题创建第二篇文章，slug 自动加后缀（如 `hello-world-1`） | ☐ |
-| 1.4.3 | 查询文章详情（前台） | `GET /api/articles/{slug}` 无认证可访问，返回结构与 YAML 一致 | ☐ |
-| 1.4.4 | 文章列表（前台） | `GET /api/articles?page=1&size=10` 返回 `Response<PageResult<ArticleListItem>>` | ☐ |
-| 1.4.5 | 状态过滤 | `GET /api/articles?status=PUBLISHED` 只返回已发布文章 | ☐ |
-| 1.4.6 | 发布文章 | `PATCH /api/admin/articles/{id}/publish` 后，status 变为 PUBLISHED，publishedAt 有值 | ☐ |
-| 1.4.7 | 归档文章 | `PATCH /api/admin/articles/{id}/archive` 后，status 变为 ARCHIVED | ☐ |
-| 1.4.8 | 状态机保护 | 对已发布文章再次调用 `publish`，返回业务错误（非 500） | ☐ |
-| 1.4.9 | 更新文章 | `PUT /api/admin/articles/{id}` 更新后内容正确，updatedAt 变化 | ☐ |
-| 1.4.10 | 删除文章 | `DELETE /api/admin/articles/{id}` 后，再次查询返回 404 或 null data | ☐ |
-| 1.4.11 | 未认证访问 Admin | `POST /api/admin/articles` 不带 Token，返回 401 | ☐ |
-| 1.4.12 | 无权限访问 Admin | 用 VISITOR 角色 Token 访问 Admin 接口，返回 403 | ☐ |
-
-### 1.5 搜索接口（独立测试）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.5.1 | 全文搜索 | `GET /api/articles/search?q=spring` 返回相关文章列表 | ☐ |
-| 1.5.2 | 搜索结果排序 | 标题含关键词的文章排在内容含关键词的前面（ts_rank 权重 A>B>C） | ☐ |
-| 1.5.3 | 空关键词处理 | `q=` 或缺失，返回业务错误（code ≠ 0）或空列表 | ☐ |
-| 1.5.4 | 搜索触发器生效 | 创建文章后立即搜索标题关键词，能搜到结果 | ☐ |
-
-### 1.6 标签接口（独立测试）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.6.1 | 创建标签（Admin） | `POST /api/admin/tags` 返回 `Response<Tag>` | ☐ |
-| 1.6.2 | 标签列表（前台） | `GET /api/tags` 返回所有标签，带 `articleCount` | ☐ |
-| 1.6.3 | 文章关联标签 | 创建文章时传入 `tagIds`，详情页返回正确 `tagNames` | ☐ |
-| 1.6.4 | 删除标签（Admin） | `DELETE /api/admin/tags/{id}` 成功，关联文章不再显示该标签 | ☐ |
-
-### 1.7 媒体接口（独立测试）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.7.1 | 文件上传 | `POST /api/media/upload` 上传图片，返回 `Response<StoredFile>`，url 可访问 | ☐ |
-| 1.7.2 | 文件本地存储 | `uploads/images/` 目录下存在上传的文件 | ☐ |
-| 1.7.3 | 目录遍历防护 | 上传时篡改 `directory` 参数为 `../etc`，被拒绝或存储到安全路径 | ☐ |
-
-### 1.8 响应格式一致性
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 1.8.1 | 所有业务接口返回 `Response<T>` | 抽查 5 个接口，结构均为 `{code, message, data}` | ☐ |
-| 1.8.2 | 成功时 code=0 | 所有成功响应 code 字段为 0 | ☐ |
-| 1.8.3 | 错误时 code≠0 | 业务错误（如 slug 重复）code 为对应 ErrorCode 值 | ☐ |
-| 1.8.4 | 分页接口返回 `PageResult` | 列表接口包含 `list/total/page/size/totalPages` | ☐ |
-| 1.8.5 | Swagger UI 与 YAML 一致 | Swagger 中显示的接口路径、参数、响应模型与 `openapi.yaml` 完全一致 | ☐ |
-
---
-
-## 2. Agent2 前端独立验收
-
-### 2.1 构建与启动
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.1.1 | `npm install` 成功 | 无依赖安装错误 | ✓ |
-| 2.1.2 | `npm run api:generate` 成功 | `src/generated/api/` 目录存在且包含 api.ts + models/ | ✓ |
-| 2.1.3 | `npm run dev` 正常启动 | 控制台无 ERROR，访问 `http://localhost:5173` 正常 | ✓ |
-| 2.1.4 | TypeScript 严格模式无错误 | `npm run build` 通过（或 `vue-tsc --noEmit` 无类型错误） | ✓ |
-
-### 2.2 代码规范检查
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.2.1 | 无手写 API 类型 | `src/generated/api/` 外无自定义的 `ArticleDetail`/`TokenPair` 等接口 | ✓ |
-| 2.2.2 | 统一 Axios 客户端 | 全局搜索 `import axios from 'axios'`，除 `client.ts` 外无其他直接引用 | ✓ |
-| 2.2.3 | `<script setup lang="ts">` | 所有 `.vue` 文件使用组合式 API + TS | ✓ |
-| 2.2.4 | 无 `any` 类型滥用 | 全局搜索 `: any`，业务代码中不超过 3 处（配置/工具类除外） | ✓ |
-
-### 2.3 前台页面（无需登录）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.3.1 | 首页加载文章列表 | 打开 `/`，能看到文章卡片列表，包含标题、摘要、时间、标签 | ✓ |
-| 2.3.2 | 文章卡片点击跳转 | 点击卡片进入 `/post/:slug`，URL 正确 | ✓ |
-| 2.3.3 | 文章详情页渲染 | 详情页显示标题、作者、发布时间、标签、内容 | ✓ |
-| 2.3.4 | 标签云/列表 | 首页或独立页面展示标签列表，显示文章计数 | ✓ |
-| 2.3.5 | 搜索功能 | 输入关键词后跳转到搜索页，展示结果列表 | ✓ |
-| 2.3.6 | 分页组件 | 文章列表底部有分页，点击切换页码后内容更新 | ✓ |
-
-### 2.4 认证流程
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.4.1 | 登录页面 | `/login` 能正常显示表单（用户名、密码） | ✓ |
-| 2.4.2 | 登录成功 | 输入正确凭据后，localStorage 存入 `token` 和 `refreshToken`，跳转管理后台 | ✓ |
-| 2.4.3 | 登录失败提示 | 输入错误密码，页面显示错误信息（alert 或文字提示） | ✓ |
-| 2.4.4 | 路由守卫 | 未登录直接访问 `/admin`，自动跳转 `/login` | ✓ |
-| 2.4.5 | 已登录防回退 | 已登录用户访问 `/login`，自动跳转 `/admin` | ✓ |
-| 2.4.6 | 退出登录 | 点击退出后，localStorage 清除 Token，跳转首页 | ✓ |
-| 2.4.7 | 刷新保持登录 | 登录后刷新浏览器（F5），仍保持登录状态（Token 未过期时） | ✓ |
-
-### 2.5 管理后台（需登录）
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.5.1 | 后台布局 | `/admin` 显示侧边栏（文章管理、标签管理）+ 顶部栏 | ✓ |
-| 2.5.2 | 文章列表 | `/admin/articles` 显示表格：标题、状态、发布时间、操作按钮 | ✓ |
-| 2.5.3 | 状态标签颜色 | DRAFT=灰色/默认, PUBLISHED=绿色, ARCHIVED=橙色/红色 | ✓ |
-| 2.5.4 | 创建文章 | 点击"新建"进入编辑器，填写后保存，列表页出现新文章 | ✓ |
-| 2.5.5 | 编辑文章 | 点击"编辑"进入编辑器，表单预填充现有数据，保存后更新 | ✓ |
-| 2.5.6 | 发布文章 | 列表页点击"发布"，状态变为 PUBLISHED，前台可看到 | ✓ |
-| 2.5.7 | 归档文章 | 列表页点击"归档"，状态变为 ARCHIVED，前台不可见 | ✓ |
-| 2.5.8 | 删除文章 | 点击"删除"后文章从列表消失，前台无法访问 | ✓ |
-| 2.5.9 | 标签管理 | `/admin/tags` 显示标签列表，可新增、编辑、删除 | ✓ |
-| 2.5.10 | 表单校验 | 创建文章时标题/内容为空，提交前前端拦截（或提交后显示后端错误） | ✓ |
-
-### 2.6 文件上传
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 2.6.1 | 封面图上传 | 文章编辑器中上传图片，返回 URL 填入表单 | ✓ |
-| 2.6.2 | 上传进度/反馈 | 上传成功后有明确反馈（URL 显示或提示） | ✓ |
-
---
-
-## 3. 前后端联调验收（端到端）
-
-### 3.1 完整业务流程
-
-按以下顺序执行，**全部通过才算联调成功**：
-
-| # | 场景 | 操作步骤 | 预期结果 | 结果 |
-|---|------|---------|---------|------|
-| 3.1.1 | 新用户注册 → 登录 → 创建文章 | 1. 前端注册页面填写用户名密码<br>2. 登录<br>3. 进入后台新建文章<br>4. 填写标题/内容/标签<br>5. 保存 | 文章出现在后台列表，状态为 DRAFT | ☐ |
-| 3.1.2 | 发布文章 → 前台可见 | 1. 后台点击"发布"<br>2. 前台首页刷新 | 文章出现在首页卡片中 | ☐ |
-| 3.1.3 | 前台阅读 → 搜索命中 | 1. 点击文章卡片进入详情<br>2. 复制文章标题关键词<br>3. 前台搜索框输入关键词 | 搜索结果包含该文章，且排名靠前 | ☐ |
-| 3.1.4 | 多标签关联 | 1. 后台创建 2 个标签<br>2. 创建文章时选择这 2 个标签<br>3. 保存并发布 | 前台详情页显示 2 个标签；标签列表页计数正确 | ☐ |
-| 3.1.5 | Token 过期自动刷新 | 1. 登录后等待 15 分钟（或手动改后端 Token 有效期为 5 秒测试）<br>2. 在后台执行任意操作 | 操作成功，无感知刷新；网络面板可见 `/auth/refresh` 请求 | ☐ |
-| 3.1.6 | 并发编辑冲突（可选） | 1. 用户 A 登录编辑文章<br>2. 用户 B 登录编辑同一文章<br>3. 先后保存 | 后保存者覆盖前者（或后端返回版本冲突错误） | ☐ |
-| 3.1.7 | 权限隔离 | 1. 注册一个普通用户（默认 VISITOR）<br>2. 用该用户 Token 尝试访问后台 | 前端路由守卫拦截或后端返回 403 | ☐ |
-
-### 3.2 数据一致性
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 3.2.1 | 前端显示与后端数据一致 | 抽查 3 篇文章，前端详情页内容与后端 `GET /api/articles/{slug}` 返回一致 | ☐ |
-| 3.2.2 | 分页数据一致 | 前台分页总数与后端 `total` 字段一致 | ☐ |
-| 3.2.3 | 标签计数准确 | 标签列表页显示的文章数与后端 `articleCount` 一致 | ☐ |
-| 3.2.4 | 搜索关键词高亮（可选） | 搜索结果中关键词有视觉高亮（或至少结果正确） | ☐ |
-
---
-
-## 4. CDD 契约一致性检查（核心）
-
-这是最关键的检查项，**任何一项不通过，整个联调失败**。
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 4.1 | YAML 与后端 Swagger 一致 | 对比 `openapi.yaml` 和 `http://localhost:8080/v3/api-docs`，路径/参数/模型无差异 | ☐ |
-| 4.2 | YAML 与前端生成类型一致 | 前端 `src/generated/api/models/` 中的类型与 YAML `components/schemas` 一一对应 | ☐ |
-| 4.3 | 后端响应与 YAML 一致 | 用 Swagger UI 或 curl 调用接口，响应 JSON 结构与 YAML 中定义的 `Response<T>` 一致 | ☐ |
-| 4.4 | 前端请求与 YAML 一致 | 浏览器 DevTools Network 面板中，前端发出的请求路径/参数与 YAML 一致 | ☐ |
-| 4.5 | 无契约外接口 | 后端不存在 YAML 中未定义的接口；前端不调用 YAML 中未定义的接口 | ☐ |
-| 4.6 | 枚举值一致 | `ArticleStatus`/`UserRole` 前后端枚举字符串完全一致（大小写敏感） | ☐ |
-
---
-
-## 5. 性能与安全基线
-
-| # | 检查项 | 通过标准 | 结果 |
-|---|--------|---------|------|
-| 5.1 | 首页加载时间 | 文章列表页首屏渲染 < 2s（本地环境，10 篇文章） | ☐ |
-| 5.2 | API 响应时间 | 单次 API 调用 < 200ms（本地环境，排除大数据量查询） | ☐ |
-| 5.3 | 搜索响应时间 | `GET /api/articles/search` 千级数据 < 100ms | ☐ |
-| 5.4 | XSS 防护 | 文章 content 中包含 `<script>alert(1)</script>`，前台渲染时不执行脚本 | ☐ |
-| 5.5 | SQL 注入防护 | 搜索关键词输入 `' OR 1=1 --`，后端正常处理不报错 | ☐ |
-| 5.6 | 目录遍历防护 | 上传时 `directory=../../etc` 被安全处理 | ☐ |
-| 5.7 | JWT 安全 | Token 中不包含敏感信息（密码等）；Secret 不是硬编码的弱密钥 | ☐ |
-
---
-
-## 6. 问题记录模板
-
-联调中发现的问题按以下格式记录：
-
-### Issue #1 — 搜索接口复现为后端旧进程所致（已解决）
- **发现时间**: 2026-08-10 00:00
- **发现人**: Agent2（前端）
- **问题描述**: 初测时 `GET /api/articles/search?q=Spring` 返回 `{code:3001,"文章不存在: search"}`。后端重启（`./gradlew bootRun` 全新进程）后同一请求返回 code=0 正确搜索结果，确认该现象由旧后端进程（未包含 SearchController 的旧构建）造成，非契约/前端问题。
- **复现步骤**: 旧进程下 `curl "http://localhost:8080/api/articles/search?q=spring"`
- **预期结果**: 返回搜索结果
- **实际结果**: 重启后返回 `{code:0, data:{list:[...]}}`，2.3.5/1.5.1 通过
- **根因分析**: 后端旧进程加载了过期构建产物，未包含搜索路由
- **责任方**: Agent1（后端，运维）
- **修复方案**: 联调前确保后端为最新 `bootRun` 进程
- **验证结果**: ☐ 已解决（2026-08-10 复验通过）
-
-### Issue #2 — 后端 `POST /auth/logout` 未吊销 Refresh Token
- **发现时间**: 2026-08-10 00:05
- **发现人**: Agent2（前端）
- **影响**: 前端 2.4.6 通过（本地清理 localStorage 正常）；仅后端吊销语义缺失（1.3.4）
- **问题描述**: 前端 `auth.logout()` 调 `POST /api/auth/logout` 后，旧 refreshToken 仍可通过 `POST /api/auth/refresh` 换取新 TokenPair，令牌吊销语义失效（违反 checklist 1.3.4）。
- **复现步骤**: 1) 登录获取 refreshToken；2) 调 `/auth/logout`（code=0）；3) 用旧 refreshToken 调 `/auth/refresh` → 仍返回 code=0 新 token（在最新 bootRun 进程上复验一致）
- **预期结果**: logout 后旧 refreshToken 刷新应失败（401/业务错误）
- **实际结果**: 刷新成功并返回新的 TokenPair
- **根因分析**: 后端登出逻辑未将 refreshToken 加入黑名单/吊销列表（JWT 无状态未记录失效）
- **责任方**: Agent1（后端）
- **修复方案**: 服务端维护 refreshToken 吊销集合（DB/redis），refresh 时校验
- **验证结果**: ☐ 待修复
-
-### Issue #3 — 契约路径加 `/api` 前缀后前端 baseURL 适配（已处理）
- **发现时间**: 2026-08-10 00:20
- **发现人**: Agent2（前端，承接 Agent1 提示）
- **问题描述**: Agent1 将契约路径改为带 `/api` 前缀（`servers.url=http://localhost:8080`）。重新 `npm run api:generate` 后，生成的 localVarPath 变为 `/api/auth/...`、方法名变为 `apiXxx` 前缀、新增 `PublicApi`/`UserApi`。若前端 axios `baseURL` 仍为 `/api`，会拼成 `/api/api/...` → 404。
- **Agent1 提示**: 需把 client.ts 中 `new XxxApi(config, '/api', ...)` 的 `/api` 改为 `''`。经核实**不正确/不完整**：生成的 `common.ts` 拼接逻辑为 `axios.defaults.baseURL ? '' : (configuration?.basePath ?? basePath)`，axios 的 `baseURL` 优先于 XxxApi 的 basePath 参数；且 axios 会自行 combineURLs。若仅改 XxxApi 参数而保留 baseURL=`/api`，仍会双前缀。
- **实际修复**: 将 axios 实例 `baseURL` 从 `/api` 改为 `/`（各 XxxApi 的 `/api` basePath 参数无害保留），并批量重命名方法调用（`articlesGet`→`apiArticlesGet` 等）。实测 `/api/articles` 单前缀、经 vite 代理到 8080 正常，2.3~2.6 全部用例复验 PASS。
- **责任方**: 前端（Agent2）
- **验证结果**: ☑ 已处理（2026-08-10 复验 26/26 通过）
-
-```markdown
-### Issue #{编号}
- **发现时间**: YYYY-MM-DD HH:MM
- **发现人**: Agent1/Agent2/架构师
- **问题描述**: 
- **复现步骤**: 
- **预期结果**: 
- **实际结果**: 
- **根因分析**: 
- **责任方**: Agent1（后端）/ Agent2（前端）/ openapi.yaml（契约）
- **修复方案**: 
- **验证结果**: ☐ 待修复 / ☐ 已修复 / ☐ 已验证
-```
-
---
-
-## 验收签字
-
-| 角色 | 姓名 | 日期 | 签字 |
-|------|------|------|------|
-| 架构 Owner | | | |
-| Agent1（后端） | | | |
-| Agent2（前端） | | | |
-
---
-
-## 附录：快速测试命令
-
-```bash
-# 后端健康检查
-curl http://localhost:8080/actuator/health
-
-# 注册
-curl -X POST http://localhost:8080/api/auth/register \
-  -H "Content-Type: application/json" \
-  -d '{"username":"admin","password":"123456"}'
-
-# 登录
-curl -X POST http://localhost:8080/api/auth/login \
-  -H "Content-Type: application/json" \
-  -d '{"username":"admin","password":"123456"}'
-
-# 创建文章（替换 $TOKEN）
-curl -X POST http://localhost:8080/api/admin/articles \
-  -H "Authorization: Bearer $TOKEN" \
-  -H "Content-Type: application/json" \
-  -d '{"title":"Hello World","content":"This is a test article."}'
-
-# 搜索
-curl "http://localhost:8080/api/articles/search?q=hello&page=1&size=10"
-
-# 前台列表（无认证）
-curl "http://localhost:8080/api/articles?page=1&size=10"
-```
--- a/prompt-agent2-frontend-v0.3.md
+++ b/prompt-agent2-frontend-v0.3.md
@ -1,507 +0,0 @@
-# Agent2 Prompt: Mach-CMS Frontend Implementation
-
-## 你的角色
-你是前端开发 Agent，负责实现 Mach-CMS 的管理后台和前台页面。你**不是设计师**，不讨论 UI 美观性，只按契约和规范实现功能。
-
-## 契约文件（唯一真理来源）
-后端仓库根目录下的 `openapi.yaml` 是你唯一的 API 规范。你必须：
-1. 用 OpenAPI Generator 从该 YAML 生成 TypeScript 类型和 API 客户端
-2. **禁止手写任何 API 请求类型或接口定义**
-3. 如果实现中发现 YAML 与实际返回不符，**暂停并上报**，禁止自行修改后不同步
-
-## 技术栈（禁止变更）
- Vue 3.4+
- TypeScript 5.4+（严格模式）
- Vite 5.2+
- Vue Router 4.3+
- Pinia 2.1+
- Axios 1.7+
- OpenAPI Generator 7.x
-
-## 项目初始化
-
-```bash
-npm create vue@latest mach-cms-frontend
-# 选择：TypeScript + Vue Router + Pinia
-
-cd mach-cms-frontend
-npm install
-npm install axios
-npm install -D @openapitools/openapi-generator-cli
-```
-
-## 你的任务（按顺序执行，逐项验收）
-
-### Task 1: OpenAPI 代码生成配置
-
-创建 `openapitools.json`：
-```json
-{
-  "$schema": "node_modules/@openapitools/openapi-generator-cli/config.schema.json",
-  "spaces": 2,
-  "generator-cli": {
-    "version": "7.6.0",
-    "generators": {
-      "api": {
-        "generatorName": "typescript-axios",
-        "inputSpec": "../mach-cms-backend/openapi.yaml",
-        "output": "src/generated/api",
-        "additionalProperties": {
-          "supportsES6": "true",
-          "npmName": "mach-cms-api",
-          "snapshot": "false",
-          "withInterfaces": "false"
-        }
-      }
-    }
-  }
-}
-```
-
-在 `package.json` 添加脚本：
-```json
-{
-  "scripts": {
-    "api:generate": "openapi-generator-cli generate"
-  }
-}
-```
-
-执行：
-```bash
-npm run api:generate
-```
-
-确认生成目录结构：
-```
-src/generated/api/
-├── api.ts          # 所有 API 类（AuthApi, ArticlesApi, ArticleAdminApi, TagsApi, MediaApi...）
-├── base.ts         # Axios 实例和配置
-├── configuration.ts
-├── common.ts
-├── index.ts
-└── models/
-    ├── index.ts
-    ├── response.ts
-    ├── page-result.ts
-    ├── article-detail.ts
-    ├── article-list-item.ts
-    ├── article-create-request.ts
-    ├── article-update-request.ts
-    ├── token-pair.ts
-    ├── login-request.ts
-    ├── register-request.ts
-    ├── tag.ts
-    ├── stored-file.ts
-    └── ...
-```
-
-### Task 2: Axios 客户端封装
-
-文件 `src/api/client.ts`：
-```typescript
-import { 
-  Configuration, 
-  AuthApi, 
-  ArticlesApi, 
-  ArticleAdminApi, 
-  TagsApi, 
-  MediaApi,
-  SearchApi
-} from '@/generated/api'
-import axios from 'axios'
-
-const axiosInstance = axios.create({
-  baseURL: '/api',
-  timeout: 10000
-})
-
-// 请求拦截：自动带 Access Token
-axiosInstance.interceptors.request.use((config) => {
-  const token = localStorage.getItem('token')
-  if (token) {
-    config.headers.Authorization = `Bearer ${token}`
-  }
-  return config
-})
-
-// 响应拦截：401 静默刷新 Token
-axiosInstance.interceptors.response.use(
-  (res) => res,
-  async (err) => {
-    const original = err.config
-    if (err.response?.status === 401 && !original._retry) {
-      original._retry = true
-      const refresh = localStorage.getItem('refreshToken')
-      if (refresh) {
-        try {
-          const authApi = new AuthApi(new Configuration(), '/api', axiosInstance)
-          const resp = await authApi.refreshToken({ refreshToken: refresh })
-          const data = resp.data.data!
-          localStorage.setItem('token', data.accessToken)
-          localStorage.setItem('refreshToken', data.refreshToken)
-          original.headers.Authorization = `Bearer ${data.accessToken}`
-          return axiosInstance(original)
-        } catch {
-          localStorage.removeItem('token')
-          localStorage.removeItem('refreshToken')
-          window.location.href = '/login'
-        }
-      } else {
-        window.location.href = '/login'
-      }
-    }
-    return Promise.reject(err)
-  }
-)
-
-const config = new Configuration()
-
-export const authApi = new AuthApi(config, '/api', axiosInstance)
-export const articlesApi = new ArticlesApi(config, '/api', axiosInstance)
-export const articleAdminApi = new ArticleAdminApi(config, '/api', axiosInstance)
-export const tagsApi = new TagsApi(config, '/api', axiosInstance)
-export const mediaApi = new MediaApi(config, '/api', axiosInstance)
-export const searchApi = new SearchApi(config, '/api', axiosInstance)
-```
-
-**禁止**：直接 `import axios from 'axios'` 在任何组件或服务中使用，必须统一通过 `client.ts`。
-
-### Task 3: Pinia 认证 Store
-
-文件 `src/stores/auth.ts`：
-```typescript
-import { defineStore } from 'pinia'
-import { ref, computed } from 'vue'
-import { authApi } from '@/api/client'
-import type { LoginRequest, RegisterRequest } from '@/generated/api'
-
-export const useAuthStore = defineStore('auth', () => {
-  const token = ref<string | null>(localStorage.getItem('token'))
-  const refreshToken = ref<string | null>(localStorage.getItem('refreshToken'))
-  const username = ref<string | null>(null)
-  const isLoggedIn = computed(() => !!token.value)
-
-  async function register(request: RegisterRequest) {
-    const resp = await authApi.register(request)
-    const data = resp.data.data!
-    setTokens(data.accessToken, data.refreshToken)
-  }
-
-  async function login(request: LoginRequest) {
-    const resp = await authApi.login(request)
-    const data = resp.data.data!
-    setTokens(data.accessToken, data.refreshToken)
-  }
-
-  async function logout() {
-    try {
-      await authApi.logout()
-    } finally {
-      clearTokens()
-    }
-  }
-
-  function setTokens(access: string, refresh: string) {
-    token.value = access
-    refreshToken.value = refresh
-    localStorage.setItem('token', access)
-    localStorage.setItem('refreshToken', refresh)
-  }
-
-  function clearTokens() {
-    token.value = null
-    refreshToken.value = null
-    username.value = null
-    localStorage.removeItem('token')
-    localStorage.removeItem('refreshToken')
-  }
-
-  return { 
-    token, 
-    refreshToken, 
-    username, 
-    isLoggedIn, 
-    register, 
-    login, 
-    logout,
-    setTokens,
-    clearTokens
-  }
-})
-```
-
-### Task 4: Vue Router + 路由守卫
-
-文件 `src/router/index.ts`：
-```typescript
-import { createRouter, createWebHistory } from 'vue-router'
-import { useAuthStore } from '@/stores/auth'
-
-const router = createRouter({
-  history: createWebHistory(),
-  routes: [
-    {
-      path: '/',
-      name: 'Home',
-      component: () => import('@/views/HomeView.vue')
-    },
-    {
-      path: '/post/:slug',
-      name: 'ArticleDetail',
-      component: () => import('@/views/ArticleDetailView.vue')
-    },
-    {
-      path: '/search',
-      name: 'Search',
-      component: () => import('@/views/SearchView.vue')
-    },
-    {
-      path: '/login',
-      name: 'Login',
-      component: () => import('@/views/LoginView.vue'),
-      meta: { guestOnly: true }
-    },
-    {
-      path: '/admin',
-      component: () => import('@/views/admin/AdminLayout.vue'),
-      meta: { requiresAuth: true },
-      children: [
-        {
-          path: '',
-          redirect: '/admin/articles'
-        },
-        {
-          path: 'articles',
-          name: 'AdminArticleList',
-          component: () => import('@/views/admin/ArticleListView.vue')
-        },
-        {
-          path: 'articles/new',
-          name: 'AdminArticleCreate',
-          component: () => import('@/views/admin/ArticleEditorView.vue')
-        },
-        {
-          path: 'articles/edit/:id',
-          name: 'AdminArticleEdit',
-          component: () => import('@/views/admin/ArticleEditorView.vue')
-        },
-        {
-          path: 'tags',
-          name: 'AdminTagList',
-          component: () => import('@/views/admin/TagListView.vue')
-        }
-      ]
-    }
-  ]
-})
-
-router.beforeEach((to, from, next) => {
-  const auth = useAuthStore()
-
-  if (to.meta.requiresAuth && !auth.isLoggedIn) {
-    next('/login')
-  } else if (to.meta.guestOnly && auth.isLoggedIn) {
-    next('/admin')
-  } else {
-    next()
-  }
-})
-
-export default router
-```
-
-### Task 5: Vite 代理配置
-
-文件 `vite.config.ts`：
-```typescript
-import { defineConfig } from 'vite'
-import vue from '@vitejs/plugin-vue'
-import { resolve } from 'path'
-
-export default defineConfig({
-  plugins: [vue()],
-  resolve: {
-    alias: {
-      '@': resolve(__dirname, 'src')
-    }
-  },
-  server: {
-    port: 5173,
-    proxy: {
-      '/api': {
-        target: 'http://localhost:8080',
-        changeOrigin: true
-      },
-      '/uploads': {
-        target: 'http://localhost:8080',
-        changeOrigin: true
-      }
-    }
-  }
-})
-```
-
-### Task 6: 页面实现
-
-#### 6.1 首页 `src/views/HomeView.vue`
- 调用 `articlesApi.listArticles()` 获取文章列表
- 展示文章卡片：标题、摘要、发布时间、作者、标签
- 点击卡片跳转 `/post/:slug`
- 支持分页
-
-#### 6.2 文章详情 `src/views/ArticleDetailView.vue`
- 路由参数 `slug`
- 调用 `articlesApi.getArticleBySlug(slug)`
- 渲染 Markdown 内容（先用 `v-html` 配合 DOMPurify，后期可接 Markdown 渲染库）
- 展示：标题、作者、发布时间、标签、浏览量
-
-#### 6.3 搜索页 `src/views/SearchView.vue`
- Query 参数 `?q=keyword`
- 调用 `searchApi.searchArticles(q, page, size)`
- 展示搜索结果列表
-
-#### 6.4 登录页 `src/views/LoginView.vue`
- 表单：用户名、密码
- 调用 `authStore.login({ username, password })`
- 登录成功跳转 `/admin`
- 提供"去注册"链接（Phase 2 完善）
-
-#### 6.5 管理后台布局 `src/views/admin/AdminLayout.vue`
- 侧边栏导航：文章管理、标签管理
- 顶部栏：显示当前用户、退出按钮
- 中间 `<router-view />`
-
-#### 6.6 文章列表 `src/views/admin/ArticleListView.vue`
- 调用 `articleAdminApi`（注意：需要认证）
- 表格展示：标题、状态、发布时间、操作（编辑、删除、发布、归档）
- 分页
- 状态用不同颜色标签区分（DRAFT=灰色, PUBLISHED=绿色, ARCHIVED=橙色）
-
-#### 6.7 文章编辑器 `src/views/admin/ArticleEditorView.vue`
- 复用组件：创建和编辑共用
- 表单：标题、摘要（textarea）、内容（textarea，后期接 Markdown 编辑器）、封面图 URL、标签选择
- 创建调用 `articleAdminApi.createArticle()`
- 编辑调用 `articleAdminApi.updateArticle(id, ...)`
- 保存成功后跳转列表页
-
-#### 6.8 标签管理 `src/views/admin/TagListView.vue`
- 调用 `tagsApi.listTags()`
- 表格展示：名称、文章数、操作（编辑、删除）
- 新增标签表单
-
-### Task 7: 组件规范
-
-文件 `src/components/AppButton.vue`、`src/components/AppInput.vue` 等基础组件（可选，可用原生 HTML 先跑通）。
-
-**必须有的组件**：
- `src/components/ArticleCard.vue`：文章卡片，接收 `ArticleListItem` 类型 props
- `src/components/Pagination.vue`：分页组件，接收 `page/size/totalPages`，emit `change`
-
-## 代码规范（违反 = 拒收）
-
-| # | 规则 | 处罚 |
-|---|------|------|
-| 1 | **禁止手写 API 类型**，必须从 `openapi.yaml` 生成 | 重写 |
-| 2 | **禁止直接 `import axios`**，统一用 `src/api/client.ts` | 重写 |
-| 3 | 组件必须用 `<script setup lang="ts">` | 重写 |
-| 4 | API 响应必须用生成代码中的类型，禁止 `any` | 重写 |
-| 5 | 路由跳转用 `useRouter()`，禁止 `window.location`（除 401 跳转） | 重写 |
-| 6 | 异步操作必须 `try/catch`，错误用 `alert` 或控制台输出（后期接 Toast） | 重写 |
-| 7 | 图片上传用 `FormData`，Content-Type 让浏览器自动设置 | 重写 |
-| 8 | 集合字段默认 `[]`，禁止 `undefined` 作为列表值 | 重写 |
-| 9 | 路由参数用 `const route = useRoute()` 获取，类型安全 | 重写 |
-
-## 验收标准（全部通过才算完成）
-
- [ ] `npm run api:generate` 成功，生成 `src/generated/api/`
- [ ] `npm run dev` 正常启动，无 TypeScript 类型错误
- [ ] 首页能正确加载文章列表（后端需先启动）
- [ ] 点击文章卡片能进入详情页，内容正确渲染
- [ ] 搜索页输入关键词能返回结果
- [ ] 登录页能正常登录，Token 存入 localStorage，跳转管理后台
- [ ] 管理后台受路由守卫保护，未登录跳转登录页
- [ ] 文章列表页能展示文章，支持分页
- [ ] 文章编辑器能创建和编辑文章
- [ ] 标签管理页能展示和操作标签
- [ ] 关闭浏览器再打开，如果 Token 未过期，保持登录状态
-
-## 输出格式
-
-1. 按文件路径组织代码，每个文件用 markdown code block
-2. 如果修改 `package.json` 或 `vite.config.ts`，明确标注变更
-3. 最后附 `tree src/` 风格的文件清单
-4. 如有类型错误，贴出完整错误日志 + 修复方案
-
-## CDD 纪律
-
- 你**只修改前端代码**，禁止修改后端仓库任何文件
- 如果你发现 `openapi.yaml` 与实际后端返回不符，**停止开发，上报问题**，等 YAML 更新后再重新生成 API 代码
- 每次后端接口变更后，必须执行 `npm run api:generate` 重新生成类型
- 禁止为了"让代码跑通"而修改生成的 `src/generated/api/` 目录下的任何文件
-
-
---
-
-## 附录：Git 开发规范（必须遵守）
-
-> 远程仓库已配置完成，每次 commit 后立即 push。
-
-### 分支策略
- 直接在 `main` 分支上开发，不创建 feature 分支
- 每次 commit 后立即 `git push origin main`
-
-### Commit 格式（Conventional Commits）
-```
-type(scope): subject
-```
-
-**Type**: `feat` `fix` `refactor` `test` `docs` `chore` `style`
-
-**Scope（前端）**: `page` `component` `store` `api` `router` `type` `asset` `config` `contract`
-
-**示例**:
-```bash
-feat(page): implement article list with pagination
-feat(component): add ArticleCard and Pagination
-fix(api): handle 401 auto-refresh token correctly
-chore(api-gen): regenerate types from openapi.yaml v0.2
-style(component): fix indentation in AdminLayout
-```
-
-### 少量多次标准（核心）
- **单 commit 单意图**：一个 commit 只做一件事
- **文件数 ≤ 10**，**行数 ≤ 200**
- **每次 commit 前必须 `npm run build` 通过（无 TS 错误）**
- **commit 后 30 秒内必须 push**
- **提交信息用英文，祈使句，首字母小写，≤ 50 字符**
-
-### 与 CDD 结合的提交顺序
-1. 契约变更：`feat(contract): xxx`（由架构 Owner 发起）
-2. 后端实现：`feat(api): implement xxx endpoint`（Agent1 执行）
-3. 前端生成：`chore(api-gen): regenerate from openapi.yaml`
-4. 前端对接：`feat(page): xxx`
-
-### 禁止行为
- `git commit -m "update"` / `git commit -m "fix bug"`
- 一次性提交 20+ 个无关文件
- 提交有 TypeScript 类型错误的代码
- 本地 commit 后数小时不 push
- 绕过 openapi.yaml 直接手写 API 类型
-
-### 标准流程
-```bash
-git pull --rebase origin main    # 提交前同步
-git add -p                       # 交互式添加（推荐）
-git diff --cached                # 自我审查
-git commit -m "type(scope): subject"
-git push origin main             # 立即推送
-```
-
-### 提交信息自查清单（每次 commit 前）
- [ ] type 正确？
- [ ] scope 准确？
- [ ] subject 英文、祈使句、≤ 50 字符？
- [ ] 变更文件都与意图相关？
- [ ] `npm run build` 通过（无 TS 错误）？
- [ ] 已 push 到远程？
--- a/prompt-agent2-frontend-v0.4.md
+++ b/prompt-agent2-frontend-v0.4.md
@ -1,228 +0,0 @@
-# Agent2 Prompt: Mach-CMS Frontend Phase 2 Implementation
-
-## 你的角色
-你是前端开发 Agent，负责实现 Mach-CMS Phase 2 功能。你不是设计师，只按契约和规范实现功能。
-
-## 契约文件（唯一真理来源）
-后端仓库根目录下的 `openapi.yaml` 是你唯一的 API 规范。
-
-## 技术栈
- Vue 3.4+
- TypeScript 5.4+（严格模式）
- Vite 5.2+
- Vue Router 4.3+
- Pinia 2.1+
- Axios 1.7+
- OpenAPI Generator 7.6.0
- marked / markdown-it（Markdown 渲染）
- DOMPurify（XSS 防护）
- highlight.js 或 prismjs（代码高亮）
-
-## 项目状态
-Phase 1 已完成：
- OpenAPI 代码生成配置
- Axios 客户端封装（含 401 自动刷新）
- Pinia auth store
- Vue Router + 路由守卫
- 首页文章列表、文章详情、搜索页
- 登录页、管理后台布局、文章列表/编辑器、标签管理
-
-## 重要修正：basePath
-
-**`client.ts` 中所有 API 实例化时，basePath 必须传空字符串 `''`**：
-
-```typescript
-export const authApi = new AuthApi(config, '', axiosInstance)
-export const articlesApi = new ArticlesApi(config, '', axiosInstance)
-export const articleAdminApi = new ArticleAdminApi(config, '', axiosInstance)
-export const tagsApi = new TagsApi(config, '', axiosInstance)
-export const mediaApi = new MediaApi(config, '', axiosInstance)
-export const searchApi = new SearchApi(config, '', axiosInstance)
-// Phase 2 新增
-export const commentsApi = new CommentsApi(config, '', axiosInstance)
-export const commentAdminApi = new CommentAdminApi(config, '', axiosInstance)
-export const userAdminApi = new UserAdminApi(config, '', axiosInstance)
-```
-
-**原因**：Vite 代理已配置 `/api` → `localhost:8080`，生成代码的 `BASE_PATH` 也是 `/api`，若不覆盖会导致 `/api/api/xxx`。
-
-**纪律**：每次 `npm run api:generate` 后，检查 `client.ts` 中 basePath 是否为 `''`。
-
-## 你的任务（按顺序执行，逐项验收）
-
-### Task 1: 重新生成 API 代码
-
-后端更新 `openapi.yaml` 至 0.2.0 后，执行：
-```bash
-npm run api:generate
-```
-
-确认生成：
- `CommentResponse`, `CommentSubmitRequest`
- `UserInfo`, `UpdateRoleRequest`
- `CommentAdminApi`, `UserAdminApi`
- `StoredFile` 增加 `thumbnailUrl`
-
-### Task 2: 注册页面
-
-文件：`src/views/RegisterView.vue`
- 路由 `/register`
- 表单：用户名（3-50 字符）、密码（6-100 字符）、确认密码、邮箱（可选）
- 前端校验：密码与确认密码一致
- 调用 `authApi.register({ username, password, email })`
- 注册成功后自动调用 `authStore.login()` 并跳转 `/admin`
- 已登录用户访问 `/register` 自动跳转 `/admin`
-
-路由配置更新：`router/index.ts` 添加 `/register` 路由
-
-### Task 3: 评论组件
-
-文件：`src/components/CommentSection.vue`
- Props：`slug: string`
- 功能：
-  - 加载评论：`GET /api/articles/{slug}/comments`
-  - 展示评论列表（作者名、内容、时间）
-  - 评论提交表单：昵称（必填）、邮箱（可选）、内容（必填）
-  - 提交后提示"评论已提交，等待审核"
- 样式：简单即可，每条评论有分隔线
-
-文件：`src/views/ArticleDetailView.vue`
- 底部引入 `<CommentSection :slug="slug" />`
-
-### Task 4: Markdown 渲染 + XSS 防护
-
-```bash
-npm install marked dompurify highlight.js
-npm install -D @types/dompurify @types/marked
-```
-
-文件：`src/utils/markdown.ts`
-```typescript
-import { marked } from 'marked'
-import DOMPurify from 'dompurify'
-import hljs from 'highlight.js'
-import 'highlight.js/styles/github-dark.css'
-
-marked.setOptions({
-  highlight: (code, lang) => {
-    if (lang && hljs.getLanguage(lang)) {
-      return hljs.highlight(code, { language: lang }).value
-    }
-    return hljs.highlightAuto(code).value
-  }
-})
-
-export function renderMarkdown(content: string): string {
-  const rawHtml = marked.parse(content) as string
-  return DOMPurify.sanitize(rawHtml)
-}
-```
-
-文件：`src/views/ArticleDetailView.vue`
- 文章内容用 `v-html="renderMarkdown(article.content)"`
- 引入 `highlight.js` 样式
-
-### Task 5: 前台标签云
-
-文件：`src/components/TagCloud.vue`
- 调用 `tagsApi.listTags()`
- 展示所有标签，标签大小按 `articleCount` 比例（简单实现：用不同 font-size class）
- 点击标签跳转首页并过滤该标签文章（可选，先实现展示即可）
-
-文件：`src/views/HomeView.vue`
- 侧边栏或底部引入 `<TagCloud />`
-
-### Task 6: 管理后台增强
-
-#### 6.1 评论审核页
-文件：`src/views/admin/CommentReviewView.vue`
- 路由 `/admin/comments`
- 调用 `commentAdminApi.listPendingComments()`
- 表格：作者、邮箱、内容、文章标题、提交时间
- 操作：通过、拒绝、删除
- 通过后评论在前台显示
-
-#### 6.2 用户管理页
-文件：`src/views/admin/UserListView.vue`
- 路由 `/admin/users`
- 调用 `userAdminApi.listUsers()`
- 表格：用户名、邮箱、角色、状态、注册时间
- 操作：修改角色（下拉选择 ADMIN/EDITOR/VISITOR）、启用/禁用
- **只有 ADMIN 可见此菜单项**（路由守卫或菜单条件渲染）
-
-#### 6.3 菜单更新
-文件：`src/views/admin/AdminLayout.vue`
- 侧边栏新增：评论审核、用户管理
- 根据当前用户角色条件显示（先实现显示，权限由后端控制）
-
-### Task 7: 图片上传集成到编辑器
-
-文件：`src/views/admin/ArticleEditorView.vue`
- 封面图：点击上传按钮 → `mediaApi.upload()` → 返回 url 填入表单
- 内容区粘贴图片：监听 `paste` 事件，提取图片文件 → 上传 → 插入 Markdown 图片语法 `![alt](url)`
-
-## 代码规范（违反 = 拒收）
-
-| # | 规则 |
-|---|------|
-| 1 | **禁止手写 API 类型**，必须从 openapi.yaml 生成 |
-| 2 | **禁止直接 import axios**，统一用 `src/api/client.ts` |
-| 3 | 组件必须用 `<script setup lang="ts">` |
-| 4 | API 响应必须用生成代码中的类型，禁止 `any` |
-| 5 | 路由跳转用 `useRouter()`，禁止 `window.location`（除 401 跳转） |
-| 6 | 异步操作必须 `try/catch`，错误用 alert 或控制台输出 |
-| 7 | 图片上传用 `FormData`，Content-Type 让浏览器自动设置 |
-| 8 | 集合默认 `[]`，禁止 `undefined` 作为列表值 |
-| 9 | 路由参数用 `useRoute()` 获取 |
-
-## Git 规范（必须遵守）
-
- 直接在 `main` 分支开发，commit 后立即 `git push origin main`
- Conventional Commits：`type(scope): subject`
- **单 commit 单意图**，文件 ≤ 10，行数 ≤ 200
- **每次 commit 前 `npm run build` 通过（无 TS 错误）**
- 提交信息用英文、祈使句、首字母小写、≤ 50 字符
-
-**Scope（前端）**：`page` `component` `store` `api` `router` `type` `asset` `config` `contract`
-
-**示例**：
-```bash
-feat(page): add register view with form validation
-feat(component): add CommentSection for article detail
-feat(component): add TagCloud with article count sizing
-feat(page): add comment review page in admin
-feat(page): add user management page with role editing
-chore(api-gen): regenerate types from openapi.yaml v0.2.0
-fix(api): set basePath to empty string to avoid /api/api
-```
-
-## 与 CDD 结合的提交顺序
-
-1. `chore(api-gen): regenerate types from openapi.yaml v0.2.0`（契约更新后）
-2. `feat(page): add register view`
-3. `feat(component): add CommentSection with submit form`
-4. `feat(component): add markdown renderer with syntax highlight`
-5. `feat(component): add TagCloud component`
-6. `feat(page): add admin comment review page`
-7. `feat(page): add admin user management page`
-8. `feat(component): integrate image upload in article editor`
-
-## 验收标准
-
- [ ] `npm run api:generate` 成功，生成 Comment/User 相关类型
- [ ] `npm run build` 无 TS 错误
- [ ] `/register` 页面可用，注册后自动登录跳转
- [ ] 文章详情页显示评论区，可提交评论，提交后提示审核中
- [ ] Markdown 渲染正确，代码块有高亮，XSS 被过滤
- [ ] 标签云显示正常，大小按文章数变化
- [ ] 后台评论审核页可列出待审核评论，通过/拒绝/删除生效
- [ ] 后台用户管理页可查看用户列表，修改角色
- [ ] 文章编辑器可上传封面图，粘贴图片到内容区
- [ ] 所有 commit 符合 Conventional Commits 规范
-
-## CDD 纪律
-
- 只修改前端代码，禁止修改后端仓库
- 发现 openapi.yaml 与实际返回不符，停止开发，上报问题
- 每次后端接口变更后，必须重新生成 API 代码
- 禁止修改 `src/generated/api/` 目录下的任何文件