@be-link/smart-test 1.0.1-beta.7 → 1.0.1-beta.8

package/README.md

@@ -6,36 +6,17 @@
 
 ## ✨ 特性
 
-### 🤖 AI 视觉检查
-
-- 基于通义千问等视觉模型，智能检查页面是否符合预期
-- 支持自然语言描述测试预期
-- 自动识别页面问题并给出详细反馈
-
-### 🎯 零代码测试生成（开发中）
-
-- **CLI 工具**：一条命令自动生成测试代码
-- **录制模式**：访问页面自动录制接口和交互
-- **代码分析**：扫描项目代码自动生成 Mock 数据
-- **AI 生成**：基于自然语言描述生成完整测试
-
-### 🔧 灵活易用
-
-- 与 Playwright 无缝集成，零侵入设计
-- 支持全局配置和单次调用配置
-- 优雅降级：无 API Key 时自动跳过
-- 完整的 TypeScript 类型支持
-
-### 📸 自动化
-
-- 自动截图并保存
-- 自动生成 Mock 数据
-- 自动生成测试用例
+- 🤖 **AI 视觉检查**：基于通义千问等视觉模型，智能检查页面是否符合预期
+- 🎯 **零侵入设计**：与 Playwright 无缝集成，无需修改现有测试代码
+- 🔧 **灵活配置**：支持全局配置和单次调用配置
+- 📸 **自动截图**：自动保存测试截图，方便排查问题
+- 🚫 **优雅降级**：无 API Key 时自动跳过，不影响其他测试
+- 📦 **TypeScript**：完整的类型定义支持
 
 ## 📦 安装
 
 ```bash
-# 使用 pnpm（推荐）
+# 使用 pnpm
 pnpm add -D @be-link/smart-test
 
 # 使用 npm
@@ -47,56 +28,7 @@ yarn add -D @be-link/smart-test
 
 ## 🚀 快速开始
 
-### 方式一：使用 CLI 工具（推荐）⭐
-
-#### 1. 初始化配置
-
-```bash
-npx smart-test init
-```
-
-交互式配置向导会引导你完成设置：
-
-```
-━━━ 初始化 Smart Test 配置 ━━━
-
-? 请输入 AI API Key: sk-xxxxx
-? 选择 AI 模型: 通义千问 (qwen3-vl-plus)
-? 测试文件目录: ./tests/e2e
-? Helpers 目录: ./tests/helpers
-? Playwright Base URL: http://localhost:8080
-? 文件命名风格: kebab-case
-
-✓ 配置文件已创建: .smarttestrc.json
-```
-
-#### 2. 生成测试代码（开发中）
-
-```bash
-# 录制模式 - 访问页面自动录制
-npx smart-test record --url http://localhost:8080/coupon
-
-# 代码分析模式 - 扫描页面代码
-npx smart-test generate --page src/pages/coupon/index.tsx
-
-# 描述生成模式 - 基于自然语言
-npx smart-test generate --desc "优惠券列表页，有可用券和已用券两个 tab"
-
-# 交互式模式 - 引导式生成
-npx smart-test generate --interactive
-```
-
-#### 3. 运行测试
-
-```bash
-npx playwright test
-```
-
----
-
-### 方式二：手动编程
-
-#### 1. 配置 API Key
+### 1. 配置 API Key
 
 在项目根目录创建 `.env` 文件：
 
@@ -104,7 +36,7 @@ npx playwright test
 AI_API_KEY=sk-your-api-key-here
 ```
 
-#### 2. 初始化配置
+### 2. 初始化配置
 
 在 `playwright.config.ts` 中配置：
 
@@ -123,7 +55,7 @@ export default defineConfig({
 });
 ```
 
-#### 3. 在测试中使用
+### 3. 在测试中使用
 
 ```typescript
 import { test, expect } from '@playwright/test';
@@ -146,95 +78,7 @@ test.describe('优惠券页面', () => {
 });
 ```
 
-## 📖 CLI 命令参考
-
-### `smart-test init`
-
-初始化配置文件，交互式设置 AI API Key、模型、输出目录等。
-
-```bash
-smart-test init
-```
-
-### `smart-test generate` (开发中)
-
-生成测试代码。
-
-```bash
-# 基础用法
-smart-test generate
-
-# 指定页面（代码分析模式）
-smart-test generate --page <path>
-
-# 指定 URL（录制模式）
-smart-test generate --url <url>
-
-# 基于描述（自然语言模式）
-smart-test generate --desc <description>
-
-# 交互式模式
-smart-test generate --interactive
-
-# 指定输出目录
-smart-test generate --page <path> --output tests/custom
-
-# 预览模式（不写入文件）
-smart-test generate --page <path> --dry-run
-```
-
-**选项：**
-
-| 选项                   | 简写 | 说明                         |
-| ---------------------- | ---- | ---------------------------- |
-| `--page <path>`        | `-p` | 页面文件路径（代码分析模式） |
-| `--url <url>`          | `-u` | 页面 URL（录制模式）         |
-| `--desc <description>` | `-d` | 页面描述（自然语言模式）     |
-| `--output <dir>`       | `-o` | 输出目录                     |
-| `--interactive`        | `-i` | 交互式模式                   |
-| `--dry-run`            |      | 预览模式，不写入文件         |
-
-### `smart-test record` (开发中)
-
-录制模式的快捷命令（`generate --url` 的别名）。
-
-```bash
-# 基础录制
-smart-test record --url http://localhost:8080/coupon
-
-# 手动操作模式
-smart-test record --url http://localhost:8080/coupon --manual
-
-# 交互式引导
-smart-test record --url http://localhost:8080/coupon --interactive
-```
-
-**选项：**
-
-| 选项             | 简写 | 说明                     |
-| ---------------- | ---- | ------------------------ |
-| `--url <url>`    | `-u` | 要录制的页面 URL（必需） |
-| `--output <dir>` | `-o` | 输出目录                 |
-| `--manual`       |      | 手动操作模式             |
-| `--interactive`  |      | 交互式引导               |
-
-### `smart-test config`
-
-查看当前配置。
-
-```bash
-smart-test config
-```
-
-### 全局选项
-
-| 选项        | 简写 | 说明                 |
-| ----------- | ---- | -------------------- |
-| `--version` | `-V` | 显示版本号           |
-| `--verbose` | `-v` | 详细输出（调试模式） |
-| `--help`    | `-h` | 显示帮助信息         |
-
-## 📖 编程 API 文档
+## 📖 API 文档
 
 ### `configure(config)`
 
@@ -247,6 +91,8 @@ configure({
   apiKey: 'sk-xxx', // AI API 密钥
   baseURL: 'https://...', // AI 服务地址（可选）
   model: 'qwen3-vl-plus', // AI 模型（可选）
+  screenshotDir: './screenshots', // 截图保存目录（可选）
+  saveScreenshots: true, // 是否保存截图（可选）
   timeout: 30000, // 超时时间（可选）
 });
 ```
@@ -335,48 +181,26 @@ test.describe('商品页面测试', () => {
 });
 ```
 
-## 🔧 配置文件
-
-### `.smarttestrc.json`
-
-使用 `smart-test init` 命令生成的配置文件：
-
-```json
-{
-  "version": "1.0.0",
-  "ai": {
-    "model": "qwen3-vl-plus",
-    "apiKey": "${AI_API_KEY}",
-    "baseURL": "https://dashscope.aliyuncs.com/compatible-mode/v1",
-    "timeout": 30000
-  },
-  "output": {
-    "testsDir": "./tests/e2e",
-    "helpersDir": "./tests/helpers",
-    "naming": "kebab-case"
-  },
-  "templates": {
-    "mock": "default",
-    "test": "default"
-  },
-  "playwright": {
-    "baseURL": "http://localhost:8080",
-    "viewport": {
-      "width": 375,
-      "height": 667
-    },
-    "browser": "chromium"
+### 批量检查多个元素
+
+```typescript
+test('检查多个区域', async ({ page }) => {
+  const checks = [
+    { selector: '.header', expected: '顶部导航栏应显示 logo 和菜单' },
+    { selector: '.main-content', expected: '主内容区应显示文章列表' },
+    { selector: '.sidebar', expected: '侧边栏应显示热门标签' },
+  ];
+
+  for (const check of checks) {
+    const element = await page.locator(check.selector);
+    const screenshot = await element.screenshot();
+
+    // 这里可以扩展为单独检查某个元素的功能
+    // 当前版本检查整页，后续可以增强
   }
-}
+});
 ```
 
-### 支持的配置格式
-
-- `.smarttestrc.json`
-- `.smarttestrc.js`
-- `smarttest.config.js`
-- `package.json` 中的 `smarttest` 字段
-
 ## 🔧 高级配置
 
 ### 支持多种 AI 模型
@@ -408,8 +232,6 @@ configure({
 // 单次调用自定义
 const result = await aiReviewScreenshot(page, {
   expected: '...',
-  screenshotPrefix: 'my-feature',
-  screenshotDir: './feature-screenshots',
 });
 ```
 
@@ -437,17 +259,9 @@ A: 理论上支持所有兼容 OpenAI Chat Completions API 的视觉模型，包
 - OpenAI GPT-4 Vision
 - 其他兼容的模型服务
 
-### Q: CLI 生成的测试代码需要手动修改吗？
-
-A: 生成的代码是可以直接运行的，但建议根据实际需求进行调整。AI 会尽量生成合理的测试用例，但可能无法覆盖所有业务场景。
-
-### Q: 录制模式如何处理需要点击才能触发的接口？
-
-A: 录制模式支持三种方式：
+### Q: 截图保存在哪里？
 
-1. **手动操作**：`--manual` 参数，用户手动操作浏览器
-2. **交互式引导**：`--interactive` 参数，AI 引导用户操作
-3. **脚本引导**：`--actions` 参数，提供操作脚本自动执行
+A: 默认保存在 `./test-results/ai-screenshots/` 目录，可以通过 `screenshotDir` 配置修改。
 
 ### Q: 如何查看 AI 的原始响应？
 
@@ -458,55 +272,6 @@ const result = await aiReviewScreenshot(page, '...');
 console.log('AI 原始响应:', result.rawResponse);
 ```
 
-### Q: 生成的代码文件如何组织？
-
-A: 默认按页面分组：
-
-- `tests/helpers/mock-{页面名}.ts` - Mock 数据
-- `tests/e2e/{页面名}.spec.ts` - 测试用例
-
-可以通过 `--output` 参数自定义输出目录。
-
-## 🗺️ 开发路线图
-
-### ✅ 已完成
-
-- [x] AI 视觉检查核心功能
-- [x] CLI 基础架构
-- [x] 配置系统
-- [x] 交互式初始化
-
-### 🚧 开发中
-
-- [ ] 录制模式（Phase 2）
-  - [ ] 网络请求录制
-  - [ ] HAR 文件解析
-  - [ ] AI 生成 Mock 代码
-  - [ ] 交互操作录制
-
-### 📅 计划中
-
-- [ ] 代码分析模式（Phase 3）
-  - [ ] TypeScript AST 解析
-  - [ ] API 调用提取
-  - [ ] 类型定义分析
-
-- [ ] 描述生成模式（Phase 4）
-  - [ ] 自然语言理解
-  - [ ] 交互式问答
-  - [ ] 代码生成
-
-- [ ] 增强功能（Phase 5+）
-  - [ ] 增量更新
-  - [ ] 自定义模板
-  - [ ] 测试覆盖率分析
-  - [ ] VS Code 插件
-
-## 📄 文档
-
-- [CLI 设计文档](./docs/CLI_DESIGN.md) - 完整的 CLI 工具设计方案
-- [使用示例](./examples/) - 更多使用示例
-
 ## 📝 License
 
 MIT
@@ -518,7 +283,3 @@ MIT
 ## 📮 联系方式
 
 如有问题，请在 [GitHub Issues](https://github.com/snowmountain-top/be-link/issues) 中提出。
-
----
-
-**版本**：v1.0.0 | **最后更新**：2025-12-30

package/dist/core/ai-assistant.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ai-assistant.d.ts","sourceRoot":"","sources":["../../src/core/ai-assistant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAgE7G"}
+{"version":3,"file":"ai-assistant.d.ts","sourceRoot":"","sources":["../../src/core/ai-assistant.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAkB,MAAM,SAAS,CAAC;AAI7E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,GAAG,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CA2E7G"}

package/dist/core/config.d.ts

@@ -11,6 +11,7 @@ import type { AiVisionConfig } from './types';
  * configure({
  *   apiKey: process.env.AI_API_KEY,
  *   model: 'qwen3-vl-plus',
+ *   screenshotDir: './screenshots',
  * });
  * ```
  */

package/dist/core/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAiB9C;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,CAK/F"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/core/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAmB9C;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,cAAc,CAAC,GAAG,IAAI,CAK/D;AAED;;;;GAIG;AACH,wBAAgB,SAAS,IAAI,QAAQ,CAAC,cAAc,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAgB,WAAW,IAAI,IAAI,CAElC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,WAAW,GAAE,OAAO,CAAC,cAAc,CAAM,GAAG,QAAQ,CAAC,cAAc,CAAC,CAK/F"}

package/dist/core/types.d.ts

@@ -16,6 +16,16 @@ export interface AiVisionConfig {
      * @default 'qwen3-vl-plus'
      */
     model?: string;
+    /**
+     * 截图保存目录
+     * @default './test-results/ai-screenshots'
+     */
+    screenshotDir?: string;
+    /**
+     * 是否保存截图到文件
+     * @default true
+     */
+    saveScreenshots?: boolean;
     /**
      * AI 请求超时时间（毫秒）
      * @default 30000

package/dist/core/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,OAAO,CAAC;IAEZ;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,cAAc,CAAC;IAC7D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;;OAGG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAE1B;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;OAEG;IACH,EAAE,EAAE,OAAO,CAAC;IAEZ;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,OAAO,CAAC,cAAc,CAAC;IAC7D;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,IAAI,EAAE,OAAO,CAAC;IAEd;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB"}

package/dist/index.esm.js

@@ -1,4 +1,6 @@
 import { OpenAI } from 'openai';
+import * as fs from 'fs';
+import * as path from 'path';
 
 /**
  * 默认配置
@@ -7,6 +9,8 @@ const DEFAULT_CONFIG = {
     apiKey: '',
     baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
     model: 'qwen3-vl-plus',
+    screenshotDir: './test-results/ai-screenshots',
+    saveScreenshots: true,
     timeout: 30000,
 };
 /**
@@ -25,6 +29,7 @@ let globalConfig = { ...DEFAULT_CONFIG };
  * configure({
  *   apiKey: process.env.AI_API_KEY,
  *   model: 'qwen3-vl-plus',
+ *   screenshotDir: './screenshots',
  * });
  * ```
  */
@@ -61,6 +66,25 @@ function mergeConfig(localConfig = {}) {
     };
 }
 
+/**
+ * 保存截图到文件
+ *
+ * @param screenshot - 截图 Buffer
+ * @param dir - 保存目录
+ * @param prefix - 文件名前缀
+ * @returns 截图文件的绝对路径
+ */
+async function saveScreenshot(screenshot, dir, prefix = 'ai-review') {
+    // 确保目录存在
+    await fs.promises.mkdir(dir, { recursive: true });
+    // 生成文件名（使用时间戳避免冲突）
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `${prefix}-${timestamp}.png`;
+    const screenshotPath = path.resolve(dir, filename);
+    // 写入文件
+    await fs.promises.writeFile(screenshotPath, screenshot);
+    return screenshotPath;
+}
 /**
  * 将截图转换为 base64 编码
  *
@@ -114,6 +138,12 @@ async function aiReviewScreenshot(page, options) {
         const screenshot = await page.screenshot({
             fullPage: opts.fullPage !== false,
         });
+        // 保存截图（如果启用）
+        let screenshotPath;
+        if (config.saveScreenshots) {
+            screenshotPath = await saveScreenshot(screenshot, config.screenshotDir);
+            console.log(`[smart-test] 截图已保存: ${screenshotPath}`);
+        }
         // 构建 AI 请求
         const prompt = buildPrompt(opts.expected);
         const openai = new OpenAI({
@@ -144,15 +174,18 @@ async function aiReviewScreenshot(page, options) {
         // 解析 AI 响应
         const content = completion?.choices[0]?.message?.content || '';
         const result = parseAiResponse(content);
-        console.log('[smart-test] AI 检查结果:', result);
-        return { ...result, rawResponse: content };
+        return {
+            ...result,
+            screenshotPath,
+            rawResponse: content,
+        };
     }
     catch (error) {
         console.error('[smart-test] AI 检查失败:', error);
         return {
             ok: true,
             skipped: true,
-            reason: `[smart-test] AI 检查失败: ${error instanceof Error ? error.message : String(error)}`,
+            reason: `AI 检查失败: ${error instanceof Error ? error.message : String(error)}`,
         };
     }
 }

package/dist/index.js

@@ -1,6 +1,28 @@
 'use strict';
 
 var openai = require('openai');
+var fs = require('fs');
+var path = require('path');
+
+function _interopNamespaceDefault(e) {
+    var n = Object.create(null);
+    if (e) {
+        Object.keys(e).forEach(function (k) {
+            if (k !== 'default') {
+                var d = Object.getOwnPropertyDescriptor(e, k);
+                Object.defineProperty(n, k, d.get ? d : {
+                    enumerable: true,
+                    get: function () { return e[k]; }
+                });
+            }
+        });
+    }
+    n.default = e;
+    return Object.freeze(n);
+}
+
+var fs__namespace = /*#__PURE__*/_interopNamespaceDefault(fs);
+var path__namespace = /*#__PURE__*/_interopNamespaceDefault(path);
 
 /**
  * 默认配置
@@ -9,6 +31,8 @@ const DEFAULT_CONFIG = {
     apiKey: '',
     baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
     model: 'qwen3-vl-plus',
+    screenshotDir: './test-results/ai-screenshots',
+    saveScreenshots: true,
     timeout: 30000,
 };
 /**
@@ -27,6 +51,7 @@ let globalConfig = { ...DEFAULT_CONFIG };
  * configure({
  *   apiKey: process.env.AI_API_KEY,
  *   model: 'qwen3-vl-plus',
+ *   screenshotDir: './screenshots',
  * });
  * ```
  */
@@ -63,6 +88,25 @@ function mergeConfig(localConfig = {}) {
     };
 }
 
+/**
+ * 保存截图到文件
+ *
+ * @param screenshot - 截图 Buffer
+ * @param dir - 保存目录
+ * @param prefix - 文件名前缀
+ * @returns 截图文件的绝对路径
+ */
+async function saveScreenshot(screenshot, dir, prefix = 'ai-review') {
+    // 确保目录存在
+    await fs__namespace.promises.mkdir(dir, { recursive: true });
+    // 生成文件名（使用时间戳避免冲突）
+    const timestamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const filename = `${prefix}-${timestamp}.png`;
+    const screenshotPath = path__namespace.resolve(dir, filename);
+    // 写入文件
+    await fs__namespace.promises.writeFile(screenshotPath, screenshot);
+    return screenshotPath;
+}
 /**
  * 将截图转换为 base64 编码
  *
@@ -116,6 +160,12 @@ async function aiReviewScreenshot(page, options) {
         const screenshot = await page.screenshot({
             fullPage: opts.fullPage !== false,
         });
+        // 保存截图（如果启用）
+        let screenshotPath;
+        if (config.saveScreenshots) {
+            screenshotPath = await saveScreenshot(screenshot, config.screenshotDir);
+            console.log(`[smart-test] 截图已保存: ${screenshotPath}`);
+        }
         // 构建 AI 请求
         const prompt = buildPrompt(opts.expected);
         const openai$1 = new openai.OpenAI({
@@ -146,15 +196,18 @@ async function aiReviewScreenshot(page, options) {
         // 解析 AI 响应
         const content = completion?.choices[0]?.message?.content || '';
         const result = parseAiResponse(content);
-        console.log('[smart-test] AI 检查结果:', result);
-        return { ...result, rawResponse: content };
+        return {
+            ...result,
+            screenshotPath,
+            rawResponse: content,
+        };
     }
     catch (error) {
         console.error('[smart-test] AI 检查失败:', error);
         return {
             ok: true,
             skipped: true,
-            reason: `[smart-test] AI 检查失败: ${error instanceof Error ? error.message : String(error)}`,
+            reason: `AI 检查失败: ${error instanceof Error ? error.message : String(error)}`,
         };
     }
 }

package/dist/utils/screenshot.d.ts

@@ -1,3 +1,12 @@
+/**
+ * 保存截图到文件
+ *
+ * @param screenshot - 截图 Buffer
+ * @param dir - 保存目录
+ * @param prefix - 文件名前缀
+ * @returns 截图文件的绝对路径
+ */
+export declare function saveScreenshot(screenshot: Buffer, dir: string, prefix?: string): Promise<string>;
 /**
  * 将截图转换为 base64 编码
  *

package/dist/utils/screenshot.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/utils/screenshot.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D"}
+{"version":3,"file":"screenshot.d.ts","sourceRoot":"","sources":["../../src/utils/screenshot.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAE,MAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAanH;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAE7D"}

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "@be-link/smart-test",
-  "version": "1.0.1-beta.7",
-  "type": "module",
+  "version": "1.0.1-beta.8",
   "description": "AI-powered visual testing for Playwright - 基于 AI 视觉模型的 Playwright 测试工具",
   "homepage": "https://github.com/snowmountain-top/be-link",
   "author": "shian",
@@ -9,9 +8,6 @@
   "main": "dist/index.js",
   "module": "dist/index.esm.js",
   "types": "dist/index.d.ts",
-  "bin": {
-    "smart-test": "./bin/smart-test.js"
-  },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
@@ -23,29 +19,16 @@
   },
   "files": [
     "dist",
-    "bin",
-    "templates",
     "README.md"
   ],
   "dependencies": {
-    "@faker-js/faker": "^10.1.0",
-    "chalk": "^5.3.0",
-    "commander": "^12.0.0",
-    "cosmiconfig": "^9.0.0",
-    "handlebars": "^4.7.8",
-    "inquirer": "^9.2.0",
-    "openai": "^6.15.0",
-    "ora": "^7.0.0",
-    "prettier": "^3.0.0",
-    "typescript": "^5.9.3"
+    "openai": "^6.15.0"
   },
   "peerDependencies": {
     "@playwright/test": "^1.40.0"
   },
   "devDependencies": {
-    "@playwright/test": "^1.50.0",
-    "@types/inquirer": "^9.0.0",
-    "@types/node": "^20.0.0"
+    "@playwright/test": "^1.50.0"
   },
   "publishConfig": {
     "access": "public"