HYTA - API Test

面向接口测试的 VS Code 扩展，结合 LLM 自动化生成 API 测试文档、动作与用例，并提供可视化的测试执行面板，帮助测试人员更高效地完成接口测试流程。

核心能力

• 初始化标准项目结构与运行配置
• 原始文档转 Markdown（支持 PDF/Word/HTML/URL）
• 大型需求文档智能切分为 API 文档
• API 文档摘要与接口依赖关系分析
• 生成 API 动作示例代码（支持批量）
• 生成测试用例文档（支持批量）
• 由单条用例生成可执行 JS 测试代码
• Webview 测试面板：请求/响应日志、LLM 流式输出、复制/删除/折叠
• 测试用例导出 Excel（单文件/目录多 Sheet）

快速开始

1. 命令面板执行 hytaExt.InitHytaProject 初始化项目。
2. 编辑生成的 hyta-apitest-llm-server.js，填写 baseURL 与 apiKey。
3. （可选）编辑 hyta-apitest-runtime-cfg.js，配置 proxy_url、base_url 等运行参数。
4. 将原始需求文档放入 _original-docs/，右键转换为 Markdown。
5. 使用“切分原始需求文档”生成 api-docs/。
6. 生成 API 文档概述与依赖总结（_API_OVERVIEW.json、_API_DEPENDENCIES.json）。
7. 生成 API 动作文档 test-actions/ 与测试用例 test-cases/。
8. 在用例文档中选择单条用例，生成测试代码并在面板中运行。

推荐工作流

1. 原始文档 → Markdown → 切分为 api-docs/
2. 生成依赖总结，提升后续用例/代码生成质量
3. 生成 API 动作文档（test-actions/）
4. 生成测试用例（test-cases/）
5. 从单条用例生成测试代码并执行

主要命令与入口

参考使用文档 HYTA API Test - 使用文档 获取详细命令列表与操作说明。

测试面板与执行

• “API Tester”面板展示请求/响应详情、测试日志与 LLM 流式输出
• 运行代码支持自动记录请求/响应、Cookie 与代理
• 代码块支持通过 CodeLens 或命令执行（沙盒 VM 环境）

项目结构

• _original-docs/ 原始需求文档
• api-docs/ 切分后的 API 文档
• test-actions/ API 动作文档
• test-cases/ 测试用例文档
• hyta-apitest-llm-server.js LLM 接口配置
• hyta-apitest-runtime-cfg.js 运行配置（代理、基础 URL 等）
• hyta-apitest-runtime-lib.js 运行时工具库（供生成代码调用）

文档转换说明

• 依赖 Python 3.10+ 与 markitdown 库
• 扩展会自动检测并引导创建虚拟环境与安装依赖

版本记录

0.0.5

• 初始版本：API 文档处理、AI 生成、执行面板与导出功能