@deepstorm/cli 0.10.2 → 0.11.1

package/dist/skills/reef-style-backend/variants/java/quick-reference.md

@@ -5,6 +5,7 @@
 > 已安装子维度的规范，通过该维度的 `{value}.md` 文件阅读。本页只包含语言通用的核心规范。
 >
 > **跨维度规范（适用所有后端代码）：**
+>
 > - [API 规范](api-spec.md) — RESTful 命名、统一响应体、OpenAPI、版本策略
 > - [依赖管理规范](dependency-management.md) — Version Catalog、版本一致性、CVE
 > - [异常处理深度规范](exception-handling.md) — 异常层次、错误码、全局处理
@@ -12,17 +13,17 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 字符串格式化 | 用 `formatted()`，不用 `+` 拼接 |
-| 类型分发 | 用多态，不用 `instanceof` 链 |
-| 控件能力查询 | 基类声明 `abstract boolean supportsXxx()`，子类按能力返回 `true/false` |
-| 领域事件 / POJO | `@Getter @AllArgsConstructor`，不手写 getter/constructor |
-| 参数顺序 | `appId` → 父级 ID → 自身 ID → name/描述 |
-| 字段注释 | Model/Entity/Event 加 `/** */`，DTO/Record 不加 |
-| 日志实体 | 继承 `LogEntry`（SINGLE_TABLE），不直接继承基类 |
-| 弃用 API | 编译警告中的 `@Deprecated` API 在同一次 PR 中替换为新 API |
-| 多行字符串 | 用 Text Block `"""..."""` + `formatted()` 嵌入 JSON/SQL/XML，禁止 `+` 拼接 |
+| 场景            | 决策                                                                       |
+| --------------- | -------------------------------------------------------------------------- |
+| 字符串格式化    | 用 `formatted()`，不用 `+` 拼接                                            |
+| 类型分发        | 用多态，不用 `instanceof` 链                                               |
+| 控件能力查询    | 基类声明 `abstract boolean supportsXxx()`，子类按能力返回 `true/false`     |
+| 领域事件 / POJO | `@Getter @AllArgsConstructor`，不手写 getter/constructor                   |
+| 参数顺序        | `appId` → 父级 ID → 自身 ID → name/描述                                    |
+| 字段注释        | Model/Entity/Event 加 `/** */`，DTO/Record 不加                            |
+| 日志实体        | 继承 `LogEntry`（SINGLE_TABLE），不直接继承基类                            |
+| 弃用 API        | 编译警告中的 `@Deprecated` API 在同一次 PR 中替换为新 API                  |
+| 多行字符串      | 用 Text Block `"""..."""` + `formatted()` 嵌入 JSON/SQL/XML，禁止 `+` 拼接 |
 
 ## 代码风格
 
@@ -39,14 +40,15 @@
 
 ### Lombok 使用规范
 
-| 组件类型 | 必用注解 | 说明 |
-|---------|---------|------|
-| 领域事件 / POJO | `@Getter @AllArgsConstructor` | `private final` 不可变，不手写 getter/constructor（见下方示例） |
-| JPA Entity | `@Getter @NoArgsConstructor(access = PROTECTED)` + `@SuperBuilder`（按需） | 详见 [Hibernate 规范](hibernate.md) |
-| Service / Controller | `@AllArgsConstructor` / `@RequiredArgsConstructor` | 构造函数注入，不用 `@Autowired` 字段注入 |
-| 只读 DTO / Record 替代 | `@Value` | 不可变对象，自动生成 equals/hashCode/toString。Record 更简洁时优先用 record |
+| 组件类型               | 必用注解                                                                   | 说明                                                                        |
+| ---------------------- | -------------------------------------------------------------------------- | --------------------------------------------------------------------------- |
+| 领域事件 / POJO        | `@Getter @AllArgsConstructor`                                              | `private final` 不可变，不手写 getter/constructor（见下方示例）             |
+| JPA Entity             | `@Getter @NoArgsConstructor(access = PROTECTED)` + `@SuperBuilder`（按需） | 详见 [Hibernate 规范](hibernate.md)                                         |
+| Service / Controller   | `@AllArgsConstructor` / `@RequiredArgsConstructor`                         | 构造函数注入，不用 `@Autowired` 字段注入                                    |
+| 只读 DTO / Record 替代 | `@Value`                                                                   | 不可变对象，自动生成 equals/hashCode/toString。Record 更简洁时优先用 record |
 
 **禁止事项：**
+
 - `@Data` — 自动生成 `@Setter` 破坏不可变性，且 `@EqualsAndHashCode` 在有 JPA 代理时行为不可预期
 - `@Setter` on Entity — 破坏封装，业务状态变更应通过行为方法表达
 - `@Autowired` 字段注入 — 必须用构造函数注入
@@ -72,13 +74,13 @@ public abstract boolean supportsImporting();
 
 ## 注释规则
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **Entity** | 类 Javadoc `/** 实体描述 */`；每个字段 `/** 字段含义 */` |
-| **DTO / Record** | 类 Javadoc `/** 用途说明 */`；字段不加 `/** */` 注释 |
-| **Repository** | 自定义查询方法加 `/** 查询意图、参数含义 */`；简单 CRUD 方法可不加 |
-| **Service** | 每个 public 方法加 Javadoc `/** 功能、@param、@return */` |
-| **Controller** | 每个端点加 `@Operation(summary=, description=)` 或等价 Javadoc |
+| 文件类型         | 注释要求                                                           |
+| ---------------- | ------------------------------------------------------------------ |
+| **Entity**       | 类 Javadoc `/** 实体描述 */`；每个字段 `/** 字段含义 */`           |
+| **DTO / Record** | 类 Javadoc `/** 用途说明 */`；字段不加 `/** */` 注释               |
+| **Repository**   | 自定义查询方法加 `/** 查询意图、参数含义 */`；简单 CRUD 方法可不加 |
+| **Service**      | 每个 public 方法加 Javadoc `/** 功能、@param、@return */`          |
+| **Controller**   | 每个端点加 `@Operation(summary=, description=)` 或等价 Javadoc     |
 
 ## 领域事件 / POJO
 
@@ -102,8 +104,8 @@ public class FormDeletedEvent {
 
 ## 常见坑
 
-| 场景 | 问题 | 正确做法 |
-|------|------|---------|
-| `instanceof` 分发 | Service 层用 `instanceof` 链判断所有子类型 | 优先在实体/领域模型中用多态 |
-| 控件能力硬编码 | 用 `if (control instanceof TextControl)` 判断是否支持某能力 | 基类加 `abstract boolean supportsXxx()`，子类按能力覆盖 |
-| 弃用 API | 编译出现 `@Deprecated` 警告但不处理 | 同一次 PR 中替换为新 API |
+| 场景              | 问题                                                        | 正确做法                                                |
+| ----------------- | ----------------------------------------------------------- | ------------------------------------------------------- |
+| `instanceof` 分发 | Service 层用 `instanceof` 链判断所有子类型                  | 优先在实体/领域模型中用多态                             |
+| 控件能力硬编码    | 用 `if (control instanceof TextControl)` 判断是否支持某能力 | 基类加 `abstract boolean supportsXxx()`，子类按能力覆盖 |
+| 弃用 API          | 编译出现 `@Deprecated` 警告但不处理                         | 同一次 PR 中替换为新 API                                |

package/dist/skills/reef-style-backend/variants/nodejs/examples/module-example.md

@@ -22,10 +22,7 @@ export class UsersModule {}
 
 ```typescript
 // users.controller.ts
-import {
-  Controller, Get, Post, Body, Param, Put, Delete,
-  ParseIntPipe,
-} from '@nestjs/common';
+import { Controller, Get, Post, Body, Param, Put, Delete, ParseIntPipe } from '@nestjs/common';
 import { ApiTags, ApiOperation, ApiBearerAuth } from '@nestjs/swagger';
 import { UsersService } from './users.service';
 import { CreateUserDto } from './dto/create-user.dto';
@@ -57,10 +54,7 @@ export class UsersController {
 
   @Put(':id')
   @ApiOperation({ summary: '更新用户信息' })
-  update(
-    @Param('id', ParseIntPipe) id: number,
-    @Body() updateUserDto: UpdateUserDto,
-  ) {
+  update(@Param('id', ParseIntPipe) id: number, @Body() updateUserDto: UpdateUserDto) {
     return this.usersService.update(id, updateUserDto);
   }
 

package/dist/skills/reef-style-backend/variants/nodejs/quick-reference.md

@@ -3,6 +3,7 @@
 按需加载。仅当你需要编写对应组件类型时阅读相关章节。
 
 > 跨维度规范（适用所有后端代码）：
+>
 > - [API 规范](api-spec.md) — RESTful 命名、统一响应体、OpenAPI、版本策略
 > - [依赖管理规范](dependency-management.md) — 版本一致性、CVE
 > - [异常处理深度规范](exception-handling.md) — 异常层次、错误码、全局过滤
@@ -10,18 +11,18 @@
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 模块结构 | 每个业务模块一个 NestJS Module，独立 Controller/Service/DTO/Entity |
-| 依赖注入 | 构造函数注入，`@Injectable()` 装饰器，禁止 `@Inject()` 字段注入 |
-| 参数验证 | DTO 使用 `class-validator` 装饰器（`@IsNotEmpty`、`@IsString`） |
-| 响应格式 | 统一使用 Controller 返回值，禁止在 Service 中直接返回 Response 对象 |
-| 异步处理 | 所有数据库/IO 操作用 `async/await`，禁止裸 `.subscribe()` 或 `.then()` |
-| 配置管理 | 使用 `@nestjs/config` 的 `ConfigService`，禁止 `process.env` 直读（测试不可 mock） |
-| 异常处理 | 使用 NestJS 全局异常过滤器（`ExceptionFilter`），禁止在 Controller 中 try-catch 吞异常 |
-| 日志 | 使用 `@nestjs/common` 的 `Logger`，构造函数中注入：`private readonly logger = new Logger(XxxService.name)` |
-| 类型安全 | 禁止 `any` 类型，优先用 `unknown` + 类型守卫 |
-| 模块注册 | 动态模块用 `forRoot()/forFeature()` 模式，禁止在 Module 中直接 `new Provider()` |
+| 场景     | 决策                                                                                                       |
+| -------- | ---------------------------------------------------------------------------------------------------------- |
+| 模块结构 | 每个业务模块一个 NestJS Module，独立 Controller/Service/DTO/Entity                                         |
+| 依赖注入 | 构造函数注入，`@Injectable()` 装饰器，禁止 `@Inject()` 字段注入                                            |
+| 参数验证 | DTO 使用 `class-validator` 装饰器（`@IsNotEmpty`、`@IsString`）                                            |
+| 响应格式 | 统一使用 Controller 返回值，禁止在 Service 中直接返回 Response 对象                                        |
+| 异步处理 | 所有数据库/IO 操作用 `async/await`，禁止裸 `.subscribe()` 或 `.then()`                                     |
+| 配置管理 | 使用 `@nestjs/config` 的 `ConfigService`，禁止 `process.env` 直读（测试不可 mock）                         |
+| 异常处理 | 使用 NestJS 全局异常过滤器（`ExceptionFilter`），禁止在 Controller 中 try-catch 吞异常                     |
+| 日志     | 使用 `@nestjs/common` 的 `Logger`，构造函数中注入：`private readonly logger = new Logger(XxxService.name)` |
+| 类型安全 | 禁止 `any` 类型，优先用 `unknown` + 类型守卫                                                               |
+| 模块注册 | 动态模块用 `forRoot()/forFeature()` 模式，禁止在 Module 中直接 `new Provider()`                            |
 
 ## 代码风格
 
@@ -37,13 +38,13 @@
 
 ### TypeScript Decorator 使用规范
 
-| 组件类型 | 必用装饰器 | 说明 |
-|---------|-----------|------|
-| Controller | `@Controller('prefix')`、`@Get()`/`@Post()`/`@Put()`/`@Delete()` | 路由定义 |
-| DTO | `@ApiProperty()`、`@IsString()`/`@IsNumber()`/`@IsOptional()` | 验证 + Swagger |
-| Service | `@Injectable()` | DI 可注入 |
-| Module | `@Module()` | NestJS 模块定义 |
-| Entity (Prisma) | 使用 Prisma Schema 定义，不额外装饰 | TypeScript 类型由 `prisma generate` 生成 |
+| 组件类型        | 必用装饰器                                                       | 说明                                     |
+| --------------- | ---------------------------------------------------------------- | ---------------------------------------- |
+| Controller      | `@Controller('prefix')`、`@Get()`/`@Post()`/`@Put()`/`@Delete()` | 路由定义                                 |
+| DTO             | `@ApiProperty()`、`@IsString()`/`@IsNumber()`/`@IsOptional()`    | 验证 + Swagger                           |
+| Service         | `@Injectable()`                                                  | DI 可注入                                |
+| Module          | `@Module()`                                                      | NestJS 模块定义                          |
+| Entity (Prisma) | 使用 Prisma Schema 定义，不额外装饰                              | TypeScript 类型由 `prisma generate` 生成 |
 
 ### 控件能力声明模式
 
@@ -59,22 +60,20 @@ export interface ToolCapability {
 
 // 注册 Provider
 @Module({
-  providers: [
-    { provide: 'TOOL_CAPABILITIES', useClass: TextToolCapability, multi: true },
-  ],
+  providers: [{ provide: 'TOOL_CAPABILITIES', useClass: TextToolCapability, multi: true }],
 })
 export class ToolsModule {}
 ```
 
 ## 注释规则
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **Entity / Prisma Schema** | Prisma Schema 中每个 model 加 `/// 注释`；生成类型不修改 |
-| **DTO** | 类 JSDoc `/** 用途说明 */`；字段装饰器自带文档（`@ApiProperty({ description: '...' })`） |
-| **Service** | 每个 public 方法加 JSDoc `/** 功能、@param、@returns */` |
-| **Controller** | 每个端点加 `@ApiOperation({ summary: '...', description: '...' })` |
-| **Module** | 类 JSDoc `/** 模块职责 */`；`@Module({})` 中 imports/providers/exports 按字母排序 |
+| 文件类型                   | 注释要求                                                                                 |
+| -------------------------- | ---------------------------------------------------------------------------------------- |
+| **Entity / Prisma Schema** | Prisma Schema 中每个 model 加 `/// 注释`；生成类型不修改                                 |
+| **DTO**                    | 类 JSDoc `/** 用途说明 */`；字段装饰器自带文档（`@ApiProperty({ description: '...' })`） |
+| **Service**                | 每个 public 方法加 JSDoc `/** 功能、@param、@returns */`                                 |
+| **Controller**             | 每个端点加 `@ApiOperation({ summary: '...', description: '...' })`                       |
+| **Module**                 | 类 JSDoc `/** 模块职责 */`；`@Module({})` 中 imports/providers/exports 按字母排序        |
 
 ## 项目目录结构
 
@@ -108,10 +107,10 @@ server/src/
 
 ## 常见坑
 
-| 场景 | 问题 | 正确做法 |
-|------|------|---------|
-| 循环依赖 | Module A imports Module B，Module B imports Module A | 用 `forwardRef(() => ModuleB)` |
-| 异步初始化 | Service 的 `constructor` 中 await Prisma 连接 | 实现 `OnModuleInit` 接口，在 `onModuleInit()` 中初始化 |
-| 环境变量直读 | `process.env.DB_URL` 在代码中硬编码 | 通过 `ConfigService.get('DB_URL')` 读取 |
-| DTO 缺少装饰器 | `class-validator` 装饰器缺失导致验证不生效 | 每个 DTO 字段同时加 `@ApiProperty()` 和验证装饰器 |
-| 事务边界 | 事务内调用外部 HTTP 服务 | Prisma `$transaction` 中禁止非数据库操作 |
+| 场景           | 问题                                                 | 正确做法                                               |
+| -------------- | ---------------------------------------------------- | ------------------------------------------------------ |
+| 循环依赖       | Module A imports Module B，Module B imports Module A | 用 `forwardRef(() => ModuleB)`                         |
+| 异步初始化     | Service 的 `constructor` 中 await Prisma 连接        | 实现 `OnModuleInit` 接口，在 `onModuleInit()` 中初始化 |
+| 环境变量直读   | `process.env.DB_URL` 在代码中硬编码                  | 通过 `ConfigService.get('DB_URL')` 读取                |
+| DTO 缺少装饰器 | `class-validator` 装饰器缺失导致验证不生效           | 每个 DTO 字段同时加 `@ApiProperty()` 和验证装饰器      |
+| 事务边界       | 事务内调用外部 HTTP 服务                             | Prisma `$transaction` 中禁止非数据库操作               |

package/dist/skills/reef-style-backend/variants/python/quick-reference.md

@@ -5,6 +5,7 @@
 > 已安装子维度的规范，通过该维度的 `{value}.md` 文件阅读。本页只包含 Python 语言通用的核心规范。
 >
 > **跨维度规范（适用所有后端代码）：**
+>
 > - [API 规范](api-spec.md) — RESTful 命名、统一响应体、OpenAPI、版本策略
 > - [依赖管理规范](dependency-management.md) — pyproject.toml、版本声明、CVE
 > - [异常处理深度规范](exception-handling.md) — AppError 层次、错误码、全局处理
@@ -28,17 +29,17 @@ app/
 
 ## 速查
 
-| 场景 | 决策 |
-| --- | --- |
-| 字符串格式化 | 用 f-string（`f"Hello {name}"`），不用 `％` 或 `.format()` |
-| 类型分发 | 用多态 / Protocol，不用 `isinstance()` 链 |
-| 类型注释 | 都标注返回类型和参数类型（mypy 检查通过） |
-| 参数顺序 | 路由可见参数 → body → query → dependency |
-| 模块名 | snake_case，禁止驼峰 |
-| 弃用 API | mypy / ruff 警告中的废弃 API 在同一次 PR 中替换为新 API |
-| 类命名 | PascalCase（如 `UserService`、`CreateUserRequest`） |
-| 函数/变量命名 | snake_case（如 `get_user()`、`user_service`） |
-| 常量命名 | UPPER_SNAKE_CASE（如 `MAX_RETRY_COUNT`） |
+| 场景          | 决策                                                       |
+| ------------- | ---------------------------------------------------------- |
+| 字符串格式化  | 用 f-string（`f"Hello {name}"`），不用 `％` 或 `.format()` |
+| 类型分发      | 用多态 / Protocol，不用 `isinstance()` 链                  |
+| 类型注释      | 都标注返回类型和参数类型（mypy 检查通过）                  |
+| 参数顺序      | 路由可见参数 → body → query → dependency                   |
+| 模块名        | snake_case，禁止驼峰                                       |
+| 弃用 API      | mypy / ruff 警告中的废弃 API 在同一次 PR 中替换为新 API    |
+| 类命名        | PascalCase（如 `UserService`、`CreateUserRequest`）        |
+| 函数/变量命名 | snake_case（如 `get_user()`、`user_service`）              |
+| 常量命名      | UPPER_SNAKE_CASE（如 `MAX_RETRY_COUNT`）                   |
 
 ## 代码风格
 
@@ -76,23 +77,23 @@ class NumberControl(FormControl):
 
 ## 注释规则
 
-| 文件类型 | 注释要求 |
-|---------|---------|
-| **Model (SQLAlchemy)** | 类 docstring 说明表含义；复杂字段用 `comment=` 行内注释 |
-| **Schema (Pydantic)** | 类 docstring 说明用途；关键字段用 `Field(description=...)` |
-| **Service** | public 函数加 docstring，说明功能、参数和返回值 |
-| **Router** | 每个端点加 `summary=`/`description=` 参数 |
-| **Migration** | 每个 revision 加 docstring 说明变更意图 |
+| 文件类型               | 注释要求                                                   |
+| ---------------------- | ---------------------------------------------------------- |
+| **Model (SQLAlchemy)** | 类 docstring 说明表含义；复杂字段用 `comment=` 行内注释    |
+| **Schema (Pydantic)**  | 类 docstring 说明用途；关键字段用 `Field(description=...)` |
+| **Service**            | public 函数加 docstring，说明功能、参数和返回值            |
+| **Router**             | 每个端点加 `summary=`/`description=` 参数                  |
+| **Migration**          | 每个 revision 加 docstring 说明变更意图                    |
 
 ## 类型注释规则
 
-| 声明位置 | 需要类型注释 |
-|---------|-------------|
-| 函数参数 | ✓ 是 |
-| 函数返回值 | ✓ 是（`-> None` 也必须标注） |
-| 模块级变量 | ✓ 是 |
-| 类属性 / Pydantic Field | ✓ 是 |
-| 循环变量 / 列表推导 | ✗ 否 |
+| 声明位置                | 需要类型注释                 |
+| ----------------------- | ---------------------------- |
+| 函数参数                | ✓ 是                         |
+| 函数返回值              | ✓ 是（`-> None` 也必须标注） |
+| 模块级变量              | ✓ 是                         |
+| 类属性 / Pydantic Field | ✓ 是                         |
+| 循环变量 / 列表推导     | ✗ 否                         |
 
 ## 错误处理模式
 
@@ -113,9 +114,9 @@ class UserNotFoundError(AppError):
 
 ## 常见坑
 
-| 场景 | 问题 | 正确做法 |
-|------|------|---------|
-| `isinstance()` 分发 | Service 层用 `isinstance()` 链判断所有子类型 | 优先在基类中用抽象方法 / Protocol |
-| 裸 `async` 阻塞 | `async` 函数内调了同步 IO 操作 | 用 `httpx.AsyncClient`、`asyncio.to_thread`、异步 ORM |
-| N+1 查询 | 循环内访问关联对象的属性，逐条 SELECT | 用 `selectinload()` / `joinedload()` 主动预加载 |
-| 类型不兼容 | mypy strict 模式通不过 | 所有函数标注类型，`None` 必须显式声明 |
+| 场景                | 问题                                         | 正确做法                                              |
+| ------------------- | -------------------------------------------- | ----------------------------------------------------- |
+| `isinstance()` 分发 | Service 层用 `isinstance()` 链判断所有子类型 | 优先在基类中用抽象方法 / Protocol                     |
+| 裸 `async` 阻塞     | `async` 函数内调了同步 IO 操作               | 用 `httpx.AsyncClient`、`asyncio.to_thread`、异步 ORM |
+| N+1 查询            | 循环内访问关联对象的属性，逐条 SELECT        | 用 `selectinload()` / `joinedload()` 主动预加载       |
+| 类型不兼容          | mypy strict 模式通不过                       | 所有函数标注类型，`None` 必须显式声明                 |

package/dist/skills/reef-style-frontend/fragments/css/tailwind/quick-reference.md

@@ -34,9 +34,9 @@
 ```html
 <!-- 内边距 -->
 <div class="p-4 px-6 py-2 pt-0">
-
-<!-- 外边距 -->
-<div class="m-4 mt-2 mx-auto">
+  <!-- 外边距 -->
+  <div class="m-4 mt-2 mx-auto"></div>
+</div>
 ```
 
 ### 颜色
@@ -44,27 +44,29 @@
 ```html
 <!-- 使用 Tailwind 色板 -->
 <div class="bg-blue-500 text-white hover:bg-blue-600">
-<button class="text-gray-700 border border-gray-300 rounded">
+  <button class="text-gray-700 border border-gray-300 rounded"></button>
+</div>
 ```
 
 ### 圆角与阴影
 
 ```html
 <div class="rounded-lg shadow-sm">
-<button class="rounded-full shadow-md">
+  <button class="rounded-full shadow-md"></button>
+</div>
 ```
 
 ### 暗色模式
 
 ```html
-<div class="bg-white dark:bg-gray-900 text-black dark:text-white">
+<div class="bg-white dark:bg-gray-900 text-black dark:text-white"></div>
 ```
 
 ## 自定义配置
 
 ```css
 /* app.css — 仅添加 Tailwind 不支持的全局样式 */
-@import "tailwindcss";
+@import 'tailwindcss';
 
 @theme {
   --color-primary: #3b82f6;

package/dist/skills/reef-style-frontend/fragments/test/vitest/examples/testing.md

@@ -38,7 +38,7 @@ describe('FormService', () => {
   });
 
   it('should GET forms', () => {
-    service.list(1).subscribe(res => expect(res.items.length).toBe(2));
+    service.list(1).subscribe((res) => expect(res.items.length).toBe(2));
     const req = httpMock.expectOne('/api/v1/apps/1/forms');
     expect(req.request.method).toBe('GET');
     req.flush({ items: [{ id: 1 }, { id: 2 }], totalItems: 2 });
@@ -97,7 +97,10 @@ describe('ButtonComponent', () => {
 describe('UserListComponent（异步加载）', () => {
   it('加载完成后应显示用户列表', async () => {
     const mockService = {
-      getUsers: vi.fn().mockResolvedValue([{ id: 1, name: 'Alice' }, { id: 2, name: 'Bob' }]),
+      getUsers: vi.fn().mockResolvedValue([
+        { id: 1, name: 'Alice' },
+        { id: 2, name: 'Bob' },
+      ]),
     };
     await render(UserListComponent, {
       componentProviders: [{ provide: UserService, useValue: mockService }],
@@ -108,7 +111,9 @@ describe('UserListComponent（异步加载）', () => {
 
   it('加载失败时应显示错误提示', async () => {
     await render(UserListComponent, {
-      componentProviders: [{ provide: UserService, useValue: { getUsers: vi.fn().mockRejectedValue(new Error('fail')) } }],
+      componentProviders: [
+        { provide: UserService, useValue: { getUsers: vi.fn().mockRejectedValue(new Error('fail')) } },
+      ],
     });
     expect(await screen.findByText(/加载失败/i)).toBeTruthy();
   });
@@ -130,7 +135,7 @@ describe('UserService（httpResource）', () => {
 
   it('应发送带 appId 的 GET 请求', () => {
     const httpMock = TestBed.inject(HttpTestingController);
-    service.getUsers(1).subscribe(res => expect(res.items.length).toBe(1));
+    service.getUsers(1).subscribe((res) => expect(res.items.length).toBe(1));
     const req = httpMock.expectOne('/api/v1/apps/1/users');
     expect(req.request.method).toBe('GET');
     req.flush({ items: [{ id: 1, name: 'Alice' }], totalItems: 1 });

package/dist/skills/reef-style-frontend/fragments/test/vitest/quick-reference.md

@@ -22,10 +22,10 @@ import { render, screen, fireEvent } from '@testing-library/angular';
 
 ## 测试类型
 
-| 测试类型 | 范围 | 工具 | 关键关注点 |
-|---------|------|------|-----------|
-| 单元测试 | 单个函数/方法 | Vitest | 逻辑正确性、边界条件 |
-| 组件测试 | 单个组件 | Testing Library | 渲染、交互、事件 |
+| 测试类型 | 范围          | 工具            | 关键关注点           |
+| -------- | ------------- | --------------- | -------------------- |
+| 单元测试 | 单个函数/方法 | Vitest          | 逻辑正确性、边界条件 |
+| 组件测试 | 单个组件      | Testing Library | 渲染、交互、事件     |
 
 ## 基本模式