大肥鱼测试 Utaoki-henji/dsh-plugin-big-fat-fish

测试工程师 大肥鱼 · Test Engineer Big Fat Fish

面向 DeepSeek Harness 的黑盒功能测试插件：接口、页面、前后端一致性，用对话驱动。

中文 · English

中文说明

它是什么

dsh-plugin-big-fat-fish 是 DeepSeek Harness（DSH）Host 组合包：注册 3 个执行工具 + 1 个方法论技能。

| 类型 | 名称 | 作用 |
| 工具 | ft_http_run | 批量发 HTTP 请求（套件或内联用例），断言 status / jsonPath / headers / latencyMs，提取变量，落盘证据 |
| 工具 | ft_ui_run | 用 playwright-core 驱动本机 Chrome/Edge：页面流程、选择器、等待、断言、截图、收集控制台报错与失败请求 |
| 工具 | ft_report | 从已落盘的 run 重新生成人读报告（单个或汇总，支持标记已知失败） |
| 技能 | functional-testing | 方法论：需求 → 接口/UI 入口摸底 → 用例设计 → 数据确认 → 执行 → 归因 → 每轮档案与报告 |

技能负责「测什么、期望是什么、失败算谁的」——是产品缺陷、用例缺陷还是环境问题；工具只负责执行和留证据，不猜。

它擅长：

- 通过真实接口、真实页面做版本/模块验收与回归（不 mock、不改项目源码）；
- 每项目复用登录档案：登录接口探明一次后，之后每轮默认「登录 + 本轮功能」联合测试；
- 每轮留下可复现的档案：目标 / 覆盖范围 / 测试数据 / 异常复现方式；
- 前后端一致性：同一份数据经接口与页面分别读取，逐字段比对。

安装

需要带插件管理器的 DSH（Host bundle 支持）与 Node 22+；UI 测试还需要本机装有 Chrome 或 Edge。

从 GitHub 安装（建议固定 tag 或 commit）：

dsh plugin add github:Utaoki-henji/dsh-plugin-big-fat-fish#v0.1.1

桌面端：打开 设置 → 插件 → 安装，填上面的 spec（或 https://github.com/Utaoki-henji/dsh-plugin-big-fat-fish），然后重启 Harness。

离线 / 对话安装：拿到发布包 dsh-plugin-big-fat-fish-v<version>.zip，让助手安装即可——发布包自带 node_modules/playwright-core，安装时不需要联网。

安装后插件显示为 测试工程师 大肥鱼，并带 functional-testing 技能。

用法

在对话里说「开始测试」/「开始测试接口」/「开始测试页面」，或英文 "start testing"。

技能会按顺序确认：项目 → 测试类型（接口 / 页面 / 模块）→ 入口地址或路由 → 登录档案（需要令牌时不猜路径）→ 只读代码得出契约与分支清单 → 多接口执行逻辑（顺序/分支/并行 + 具体顺序）→ 测试数据确认卡 → 先冒烟再全量 → 每轮档案与报告。

工作区状态

所有状态都在当前工作区的 .ft/ 下（不写你的项目源码）：

.ft/
config.json # 接口/UI 基址、允许的主机、写操作放行、响应体上限 credentials.local.json # 本地凭据库（被 gitignore，环境变量优先） logins/<project>.json # 登录档案：接口、令牌路径、鉴权头、凭据环境变量名 suites/ # 可复用测试套件（凭据保留 ${env:...} 占位符） runs/<runId>/ # results.jsonl、证据、截图、报告

ensureWorkspaceState 会写入 .ft/.gitignore，避免 run、凭据、鉴权产物进入你的仓库。

环境要求

- 带插件管理器的 DSH（Host bundle 支持）；
- Node.js 22+（ESM）；
- ft_ui_run 需要本机 Chrome 或 Edge（直接驱动已装浏览器，不下载浏览器内核）；
- 能访问你要测的目标地址。

安全与隐私

- 对项目只读：不改源码、不插桩、不跑你的构建；
- 只写工作区 .ft/；
- 凭据来自环境变量或 .ft/credentials.local.json，日志/证据/套件按敏感键脱敏，落盘保留 ${env:...} 占位符；
- 无遥测：只访问你给的目标地址；
- 写操作需显式授权：非 GET 用例必须标 destructive: true 且被 .ft/config.json 放行；
- UI 自动化使用独立浏览器上下文，不碰你日常浏览器的配置档。

边界

- 执行层只有黑盒：HTTP 请求 + 真实浏览器 UI；没有单测执行、没有覆盖率、没有断点插桩；
- 白盒只读静态：第 5 步允许只读 Java/Spring Controller、DTO、@Valid、Service 分支、Vue 路由与 API 层来推导期望，不执行任何代码；
- concurrency 固定为 1，并行请求按确认顺序串行；
- ft_ui_run 使用本机 Chrome/Edge，支持无头模式与登录态注入（storageState / cookies）。

许可证

MIT，见 LICENSE。

Black-box functional testing for DeepSeek Harness — HTTP APIs, Vue/Web pages, and front-end/back-end consistency, driven by conversation.

What it is

dsh-plugin-big-fat-fish is a DSH Host bundle. It adds three executor tools and one methodology skill:

| Kind | Name | What it does |
| 工具 | ft_http_run | 发送 HTTP 请求（用例套件或内联用例），校验 status / jsonPath / headers / latencyMs 断言，提取变量，留存证据 |
| 工具 | ft_ui_run | 通过 playwright-core 驱动本地 Chrome/Edge：页面流程、选择器、等待、断言、截图、控制台与失败请求捕获 |
| 工具 | ft_report | 从已存储的运行记录重建可读报告（单次或聚合，支持标记已知失败） |
| 技能 | functional-testing | 方法论：需求 → 接口/UI 入口评审 → 用例设计 → 数据确认 → 执行 → 归因 → 每轮记录与报告 |

技能负责测什么、「预期」指什么、失败到底是产品缺陷、用例缺陷还是环境问题。工具只负责执行和留存证据——从不猜测。

它擅长的事：

- 通过真实接口和真实页面对某个版本或模块做验收/回归测试（不打桩，不改源码）。
- 按项目复用登录配置档：登录接口探测一次后，之后每轮都跑「登录 + 功能」。
- 写每轮记录：目标、覆盖范围、测试数据、异常复现——让别人也能照着复现报告。
- 前后端一致性检查：同一份数据分别从 API 读取、从页面渲染，逐字段比对。

安装

需要带插件管理器的 DSH 构建，以及 Node 22+。UI 测试还需要本地 Chrome 或 Edge。

从 GitHub 安装（为可复现性，请固定 tag 或 commit）：

dsh plugin add github:Utaoki-henji/dsh-plugin-big-fat-fish#v0.1.1

桌面应用：打开 Settings → Plugins → Install，填入上面的 spec（或 https://github.com/Utaoki-henji/dsh-plugin-big-fat-fish）。然后重启 Harness。

离线 / 对话安装：下载发布包（dsh-plugin-big-fat-fish-v<version>.zip），让助手安装——发布包自带 node_modules/playwright-core，安装过程无需联网。

安装完成后，插件显示为 测试工程师 大肥鱼，带 functional-testing 技能。

使用

用下面任一句开启对话轮次：

- 「开始测试」 / 「开始测试接口」 / 「开始测试页面」
- "start testing", "test this API", "test this page"

技能随后按以下步骤推进，遇到它不知道的信息就问你：

1. 确认项目（名称 / 仓库 / 服务）。
2. 选择测试类型：仅接口 · 仅 UI · 模块（API + UI + 前后端一致性）。
3. 给出入口：API base URL 和路径（或 Controller/API 文档）或 UI 路由；环境与凭据来源。
4. 登录配置档：接口需要 token 时，读取 .ft/logins/<project>.json；没有配置档就问你要登录接口，而不是猜路径。
5. 读代码（只读）推导契约与分支清单——绝不修改，绝不插桩。
6. 确认多个接口的执行逻辑：顺序、分支还是并行，以及具体顺序（不会从代码结构推断调用链）。
7. 准备测试数据，写任何东西之前先给你看一张数据确认卡。
8. 执行：先跑 3–5 条冒烟用例，再跑全量；每个主题跑一轮。
9. 记录并汇报：每轮的目标、覆盖范围、测试数据、异常复现，外加一份汇总报告。

工作区状态

插件保存的所有内容都放在当前工作区的 .ft/ 下（绝不放进你的项目源码）：

.ft/
config.json # api/ui base URLs, allowed hosts, destructive rules, size limits
credentials.local.json # local credential store (gitignored; env vars override it)
logins/<project>.json # login profile: endpoint, token path, auth header, env var names
suites/ # reusable test suites (credentials stay as ${env:...} placeholders)
runs/<runId>/ # results.jsonl, evidence, screenshots, report

ensureWorkspaceState 会写一个 .ft/.gitignore，让运行结果、凭据和认证产物永远不会泄漏进你的仓库。

环境要求

- 带插件管理器的 DSH（支持 Host bundle）。
- Node.js 22+（ESM）。
- 本地 Chrome 或 Edge，供 ft_ui_run 使用（它驱动你已安装的浏览器，无需下载浏览器）。
- 能访问你要测试的目标。

安全与隐私

- 对你的项目只读：插件从不修改项目源码，从不注入埋点，从不运行你的构建。
- 写入范围受限：只写工作区的 .ft/ 状态目录。
- 密钥：凭据来自环境变量或 .ft/credentials.local.json。日志、证据和持久化的测试套件会脱敏密钥字段（authorization、cookie、password、token、……），并保留 ${env:...} 占位符而不是真实值。
- 无遥测：工具只与你提供的 base URL 通信。
- 破坏性调用需显式开启：非 GET 调用必须在用例里标记 destructive: true，并由 .ft/config.json 放行。
- UI 自动化会启动一个隔离的浏览器上下文，不碰你日常使用的浏览器配置档。

范围与限制

- 只做黑盒执行：HTTP 请求加真实浏览器 UI 流程。不执行单元测试，不做代码覆盖率，不设断点，不注入埋点。
- 白盒只读且静态：第 5 步中，助手可以读 Java/Spring 的 controller、DTO、校验逻辑和服务分支，或 Vue 路由与 API 层，用来推导预期结果。这些阅读不会执行任何代码。
- concurrency 固定为 1；并行请求按确认后的顺序依次执行。
- ft_ui_run 使用本地 Chrome/Edge 通道。支持无头模式和登录态（storageState / cookies）。

许可证

MIT —— 见 LICENSE。