ai-engineering-init 1.12.1 → 1.13.0

package/.codex/skills/auto-test/references/api-conventions.md

@@ -0,0 +1,260 @@
+# 系统接口请求响应规范（详细参考）
+
+> 本文件定义了 leniu 系统的标准接口契约。生成测试用例时**必须严格匹配**这些模式。
+> 安装框架后可直接使用，无需额外学习。
+
+## 统一请求格式
+
+所有 POST 接口使用 `LeRequest<T>` 封装，业务参数放在 `content` 字段内：
+
+```json
+{
+  "content": { /* 业务参数 */ }
+}
+```
+
+## 统一响应格式
+
+```json
+{
+  "code": 10000,       // 业务码：10000=成功，其他=失败
+  "msg": "操作成功",    // 提示信息
+  "data": ...          // 业务数据（类型取决于接口）
+}
+```
+
+## 接口类型与响应模式速查
+
+根据 Controller 方法返回值类型，确定 data 的结构和对应断言：
+
+| Controller 返回类型 | data 类型 | 示例 | Hurl 断言模板 |
+|---------------------|----------|------|--------------|
+| `Long` | 雪花 ID | `$.data` = 1234567890 | `jsonpath "$.data" isInteger` |
+| `void` | null | `$.data` = null | `jsonpath "$.code" == 10000` |
+| `XxxVO` | 对象 | `$.data.id`, `$.data.name` | `jsonpath "$.data.id" exists` |
+| `PageVO<XxxVO>` | 分页对象 | `$.data.records[0]` | 见「标准分页」 |
+| `ReportBaseTotalVO<XxxVO>` | 分页+合计 | `$.data.resultPage` + `$.data.totalLine` | 见「报表分页」 |
+
+## 标准分页响应（PageVO）
+
+**适用于**：设置类 CRUD 分页查询（如凭证类型、凭证字）
+
+```json
+{
+  "code": 10000,
+  "data": {
+    "records": [ { "id": 1, "name": "..." }, ... ],
+    "current": 1,
+    "size": 10,
+    "total": 25
+  }
+}
+```
+
+**Hurl 断言模板**：
+
+```hurl
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.records" isCollection
+jsonpath "$.data.current" exists
+jsonpath "$.data.size" exists
+jsonpath "$.data.total" exists
+# VO 字段逐一验证
+jsonpath "$.data.records[0].id" exists
+jsonpath "$.data.records[0].typeName" isString
+```
+
+## 报表分页响应（ReportBaseTotalVO）
+
+**适用于**：报表类分页查询（凭证列表、科目明细、科目汇总），响应包含 `resultPage`（分页数据）+ `totalLine`（合计行）
+
+```json
+{
+  "code": 10000,
+  "data": {
+    "resultPage": {
+      "records": [ { ... }, ... ],
+      "current": 1,
+      "size": 10,
+      "total": 25
+    },
+    "totalLine": {
+      "debitAmount": 1285100,
+      "creditAmount": 1285000
+    }
+  }
+}
+```
+
+**Hurl 断言模板**：
+
+```hurl
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+# 分页结构
+jsonpath "$.data.resultPage" exists
+jsonpath "$.data.resultPage.records" isCollection
+jsonpath "$.data.resultPage.current" exists
+jsonpath "$.data.resultPage.size" exists
+jsonpath "$.data.resultPage.total" exists
+# VO 字段逐一验证（首条记录）
+jsonpath "$.data.resultPage.records[0].voucherDate" isString
+jsonpath "$.data.resultPage.records[0].areaName" isString
+jsonpath "$.data.resultPage.records[0].costTypeName" isString  # 关联字段不能为 null
+# 合计行（只有数值字段和方向字段，其余为 null 占位）
+jsonpath "$.data.totalLine" exists
+jsonpath "$.data.totalLine.debitAmount" exists
+jsonpath "$.data.totalLine.creditAmount" exists
+```
+
+## 各操作类型的请求与响应模式
+
+### 1. 新增（save）→ 返回 Long ID
+
+```hurl
+# Controller: Long save(LeRequest<XxxSaveParam>)
+POST {{base_url}}/report/finance/voucher/save
+Content-Type: application/json
+X-Token: {{x_token}}
+merchant-id: {{merchant_id}}
+Merchant-Id: {{merchant_id_auth}}
+{
+  "content": {
+    "areaId": {{area_id}},
+    "name": "auto-test数据，可删除",
+    "entries": [ ... ]
+  }
+}
+
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+[Captures]
+created_id: jsonpath "$.data"    # 捕获返回的 ID 供后续使用
+```
+
+### 2. 编辑（save 带 id / update）→ 返回 void
+
+```hurl
+# 方式一：save 带 id（delete-insert 模式，常用于主子表）
+POST {{base_url}}/report/finance/voucher/save
+{ "content": { "id": {{created_id}}, "name": "修改后", ... } }
+
+# 方式二：独立 update 接口
+POST {{base_url}}/report/finance/setting/voucher-type/update
+{ "content": { "id": {{type_id}}, "typeName": "修改后" } }
+
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+```
+
+### 3. 查详情（detail）→ 返回 XxxVO 对象
+
+```hurl
+# Controller: XxxDetailVO detail(LeRequest<Long>)
+# 注意：content 直接传 ID 值（Long），不需要包装对象
+POST {{base_url}}/report/finance/voucher/detail
+{ "content": {{created_id}} }
+
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+jsonpath "$.data.id" exists
+jsonpath "$.data.areaName" isString
+jsonpath "$.data.entries" isCollection      # 子表数据
+jsonpath "$.data.entries" count == 2
+jsonpath "$.data.entries[0].id" exists
+```
+
+### 4. 删除（delete）→ 返回 void
+
+```hurl
+# Controller: void delete(LeRequest<Long>)
+# 注意：content 直接传 ID 值（Long）
+POST {{base_url}}/report/finance/voucher/delete
+{ "content": {{created_id}} }
+
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+```
+
+### 5. 提交/审批等状态变更 → 返回 void
+
+```hurl
+# Controller: void submit(LeRequest<Long>)
+POST {{base_url}}/report/finance/voucher/submit
+{ "content": {{created_id}} }
+
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+```
+
+### 6. 分页查询（page）→ 返回 PageVO 或 ReportBaseTotalVO
+
+```hurl
+# 标准分页（设置类）
+POST {{base_url}}/report/finance/setting/voucher-type/page
+{
+  "content": {
+    "page": { "current": 1, "size": 10 }
+  }
+}
+
+# 报表分页（含合计行）
+POST {{base_url}}/report/finance/voucher/page
+{
+  "content": {
+    "page": { "current": 1, "size": 10 },
+    "startDate": "2026-03-01",
+    "endDate": "2026-03-31"
+  }
+}
+```
+
+### 7. 导出（export）→ 返回 void（异步）
+
+```hurl
+# Controller: void export(LeRequest<XxxPageParam>)
+# 异步导出，仅验证接口不报错
+POST {{base_url}}/report/finance/voucher/export
+{
+  "content": {
+    "page": { "current": 1, "size": 10 },
+    "startDate": "2026-03-01",
+    "endDate": "2026-03-31"
+  }
+}
+
+HTTP 200
+[Asserts]
+jsonpath "$.code" == 10000
+```
+
+### 8. 未授权测试 → 预期 HTTP 401
+
+```hurl
+# 去掉 X-Token 请求头
+POST {{base_url}}/report/finance/voucher/page
+Content-Type: application/json
+merchant-id: {{merchant_id}}
+Merchant-Id: {{merchant_id_auth}}
+{ "content": { "page": { "current": 1, "size": 10 } } }
+
+HTTP 401
+```
+
+## content 传值类型总结
+
+| 场景 | content 类型 | 示例 |
+|------|-------------|------|
+| 分页查询 | 对象（含 page + 查询条件） | `{"page":{"current":1,"size":10},"keyword":"xxx"}` |
+| 新增/编辑 | 对象（业务字段） | `{"name":"xxx","entries":[...]}` |
+| 查详情/删除/提交 | **裸 Long** | `{{id}}` （不是 `{"id": {{id}}}`） |
+
+> **关键区别**：detail/delete/submit 的 content 是**直接传 ID 值**，不需要包装成对象。这是最常见的错误。

package/.codex/skills/lanhu-design/SKILL.md

@@ -0,0 +1,99 @@
+---
+name: lanhu-design
+description: |
+  蓝湖设计稿与 Axure 原型分析。通过 lanhu MCP Server 直接读取蓝湖项目的原型页面、设计图、切图资源。
+
+  触发场景：
+  - 需要从蓝湖获取 Axure 原型页面进行需求分析
+  - 需要查看蓝湖 UI 设计图和设计参数
+  - 需要提取蓝湖设计稿中的切图资源
+  - 需要通过蓝湖团队留言板协作
+  - 收到蓝湖邀请链接需要解析
+
+  触发词：蓝湖、lanhu、设计稿、原型图、蓝湖链接、设计图、切图
+---
+
+# 蓝湖设计稿分析
+
+## 前置条件
+
+lanhu MCP Server 已注册在 `.claude/settings.json`。首次使用需配置蓝湖 Cookie：
+
+1. 浏览器登录蓝湖 → F12 开发者工具 → Network → 复制请求头中的 Cookie
+2. 填入 `.claude/settings.json` 的 `lanhu.env.LANHU_COOKIE`
+
+## MCP 工具清单
+
+| 工具 | 用途 | 输入 |
+|------|------|------|
+| `lanhu_resolve_invite_link` | 解析蓝湖邀请链接 | 邀请链接 URL |
+| `lanhu_get_pages` | 获取原型文档页面列表+截图 | 含 docId 的蓝湖 URL |
+| `lanhu_get_ai_analyze_page_result` | AI 分析原型页面（开发/测试/探索视角） | 含 docId 的 URL + 页面名 + 模式 |
+| `lanhu_get_designs` | 获取 UI 设计图列表 | 不含 docId 的蓝湖 URL |
+| `lanhu_get_ai_analyze_design_result` | AI 分析设计图（含尺寸/颜色/CSS） | 不含 docId 的 URL + 设计图名 |
+| `lanhu_get_design_slices` | 提取设计稿切图资源 | 不含 docId 的 URL + 设计图名 |
+| `lanhu_say` | 发送团队留言 | URL + 内容 |
+| `lanhu_say_list` | 查询留言列表 | URL 或 'all' |
+| `lanhu_say_detail` | 查看留言详情 | 消息 ID |
+| `lanhu_say_edit` | 编辑留言 | URL + 消息 ID + 新内容 |
+| `lanhu_say_delete` | 删除留言 | URL + 消息 ID |
+| `lanhu_get_members` | 获取项目成员 | URL |
+
+## URL 类型区分（重要）
+
+| URL 类型 | 特征 | 用于 |
+|---------|------|------|
+| **原型文档 URL** | 含 `docId` 参数 | `lanhu_get_pages`、`lanhu_get_ai_analyze_page_result` |
+| **设计项目 URL** | 不含 `docId` | `lanhu_get_designs`、`lanhu_get_design_slices` |
+| **邀请链接** | `lanhuapp.com/link/#/invite?sid=xxx` | 先用 `lanhu_resolve_invite_link` 解析 |
+
+## 典型工作流
+
+### 1. 需求分析（与 analyze-requirements 联动）
+
+```
+收到蓝湖链接
+  │
+  ├─ 邀请链接？ → lanhu_resolve_invite_link → 获取真实 URL
+  │
+  ├─ 含 docId？（原型文档）
+  │   ├─ lanhu_get_pages → 获取页面列表和截图
+  │   └─ lanhu_get_ai_analyze_page_result(mode="development") → 获取字段/逻辑/流程
+  │
+  └─ 不含 docId？（设计项目）
+      ├─ lanhu_get_designs → 获取设计图列表
+      └─ lanhu_get_ai_analyze_design_result → 获取尺寸/颜色/CSS
+```
+
+### 2. 前端开发（获取设计参数）
+
+```
+lanhu_get_designs → 查看设计图列表
+  → lanhu_get_ai_analyze_design_result → 获取精确设计参数（尺寸/间距/颜色/字体）+ HTML+CSS 代码
+  → lanhu_get_design_slices → 提取切图/图标资源
+```
+
+### 3. 分析模式选择
+
+`lanhu_get_ai_analyze_page_result` 支持 3 种模式：
+
+| 模式 | 关注点 | 适用场景 |
+|------|--------|---------|
+| `development` | 字段规则、业务逻辑、全局流程图 | 后端/前端开发 |
+| `testing` | 测试场景、用例、边界值、校验规则 | 测试编写 |
+| `exploration` | 核心功能概览、模块依赖、评审要点 | 需求评审 |
+
+## 与其他技能联动
+
+| 场景 | 先用 lanhu-design | 再用 |
+|------|-------------------|------|
+| 需求分析 | 获取原型截图和页面结构 | `analyze-requirements` 输出开发任务清单 |
+| 前端开发 | 获取设计参数和切图 | `ui-pc` 实现页面 |
+| 接口开发 | 从原型推导接口字段 | `api-development` / `crud-development` |
+
+## 注意
+
+- 蓝湖 Cookie 有效期有限，过期需重新获取
+- 原型文档和设计项目使用不同的 URL 格式，工具不能混用
+- 大型原型建议分页面分析，避免单次请求过大
+- 与 `analyze-requirements` 的区别：本技能负责**从蓝湖获取数据**，`analyze-requirements` 负责**分析数据输出任务**

package/.cursor/hooks/cursor-skill-eval.js

@@ -218,6 +218,10 @@ const skillMap = [
   },
 
   // ========== 通用技能 ==========
+  {
+    name: 'auto-test',
+    keywords: ['自动测试', 'auto-test', '接口测试', 'API测试', 'Hurl', '测试报告', '回归测试']
+  },
   {
     name: 'crud-development',
     keywords: ['CRUD', '增删改查', 'Entity', 'Service', 'Controller', '业务模块开发']
@@ -342,6 +346,10 @@ const skillMap = [
     name: 'banana-image',
     keywords: ['生成图片', 'AI图片', '产品图', '海报', '缩略图', '4K图片', '高清图', '制作图片', '/image']
   },
+  {
+    name: 'lanhu-design',
+    keywords: ['蓝湖', 'lanhu', '设计稿', '蓝湖链接', '设计图', '切图', 'lanhuapp']
+  },
   {
     name: 'codex-code-review',
     keywords: ['代码审查', 'code review', 'review代码', '代码检查', 'codex审查']

package/.cursor/rules/skill-activation.mdc

@@ -83,12 +83,14 @@ alwaysApply: true
 | 头脑风暴/方案设计/怎么设计/有什么办法 | `.cursor/skills/brainstorm/SKILL.md` |
 | 工作流/审批流/Flowable/WarmFlow | `.cursor/skills/workflow-engine/SKILL.md` |
 | 单元测试/@Test/JUnit5/Mockito | `.cursor/skills/test-development/SKILL.md` |
+| 自动测试/auto-test/接口测试/API测试/Hurl/测试报告/回归测试 | `.cursor/skills/auto-test/SKILL.md` |
 | JSON/序列化/反序列化/JsonUtils/BigDecimal精度 | `.cursor/skills/json-serialization/SKILL.md` |
 | Redis/缓存/@Cacheable/@CacheEvict/分布式锁/RLock | `.cursor/skills/redis-cache/SKILL.md` |
 | 定时任务/SnailJob/@Scheduled/@JobExecutor | `.cursor/skills/scheduled-jobs/SKILL.md` |
 | WebSocket/SSE/实时推送/消息通知/双向通信 | `.cursor/skills/websocket-sse/SKILL.md` |
 | 短信/邮件/SMS/验证码/MailUtils | `.cursor/skills/sms-mail/SKILL.md` |
 | 第三方登录/微信登录/OAuth/JustAuth/扫码登录 | `.cursor/skills/social-login/SKILL.md` |
+| 蓝湖/lanhu/设计稿/蓝湖链接/设计图/切图 | `.cursor/skills/lanhu-design/SKILL.md` |
 | 多租户/租户隔离/TenantEntity/tenantId/SaaS | `.cursor/skills/tenant-management/SKILL.md` |
 | Element UI/前端组件/el-table/el-form/管理页面 | `.cursor/skills/ui-pc/SKILL.md` |
 | Vuex/store/mapState/mapActions/状态管理 | `.cursor/skills/store-pc/SKILL.md` |