apifox-workspace-mcp 1.0.0

package/CHANGELOG.md

@@ -0,0 +1,65 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [1.0.0] - 2024-12-04
+
+### 🎉 Initial Release
+
+#### ✨ Features
+- **Project Management**: Multi-project workspace support
+- **Interface Query**: Search and filter API interfaces
+- **Code Generation**: Generate TypeScript types, Mock data, request wrappers, and test scripts
+- **Natural Language Assistant**: AI-powered interface interaction
+- **Smart Context**: Automatic context memory (last project, interface list)
+- **URL Parser**: Intelligent parsing of Apifox share links
+
+#### 🏗️ Architecture
+- **Layered Design**: Server, Core, Lib, Types layers
+- **Modular Structure**: 27 modules for high cohesion and low coupling
+- **Type Safety**: 100% TypeScript, zero `any` types
+- **Test Coverage**: 11 unit tests with 100% pass rate
+
+#### 🛠️ Developer Experience
+- ESLint + Prettier code standards
+- Vitest testing framework
+- Comprehensive documentation
+- NPM scripts for common tasks
+
+#### 📦 Infrastructure
+- Unified logging system with log levels
+- Custom error classes for better error handling
+- Environment variable loading from MCP config
+- Automatic project root detection
+
+### 🔧 Configuration
+- MCP configuration via `~/.cursor/mcp.json` or `.cursor/mcp.json`
+- Support for custom API base URL
+- Automatic `apifox-mcp.json` initialization
+
+### 📚 Documentation
+- [Architecture Guide](docs/architecture.md)
+- [Setup Guide](docs/setup.md)
+- [Usage Guide](docs/usage.md)
+- [Refactoring Report](docs/refactoring-report.md)
+
+---
+
+## Release Notes
+
+### Breaking Changes
+None (initial release)
+
+### Upgrade Guide
+This is the first release. No upgrade needed.
+
+### Known Issues
+None
+
+---
+
+For more details, see the [README](README.md).
+

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Apifox Team
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,380 @@
+# Apifox Workspace MCP
+
+[![npm version](https://img.shields.io/npm/v/apifox-workspace-mcp)](https://www.npmjs.com/package/apifox-workspace-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node Version](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+
+> 🚀 工作空间级别的 Apifox MCP Server，为 Cursor AI 提供智能 API 文档集成能力
+
+## ✨ 核心特性
+
+### 🗂️ 多项目管理
+- 📋 统一管理工作空间中的所有 Apifox 项目
+- 🔗 一键解析分享链接，自动添加项目配置
+- 💾 智能维护项目配置文件（`apifox-mcp.json`）
+
+### 🔍 智能接口查询
+- 🔎 关键词搜索，快速定位目标接口
+- 🏷️ 标签筛选，按模块分类查看
+- 📄 完整接口详情（请求参数、响应结构、示例代码）
+
+### 🛠️ 代码自动生成
+- 📝 **TypeScript 类型定义** - 自动生成请求/响应类型
+- 🎭 **Mock 数据** - 基于接口规范生成测试数据
+- 🔌 **请求封装** - 生成类型安全的 API 调用函数
+- 🧪 **测试脚本** - 生成单元测试模板
+
+### 🤖 自然语言助手
+- 💬 自然语言交互，无需记忆命令
+- 🧠 智能上下文记忆（项目、接口列表）
+- 🎯 意图识别，自动路由到正确的功能
+
+## 📦 安装
+
+### 方式 1：通过 npx（推荐）
+
+最简单的使用方式，无需安装：
+
+```json
+{
+  "mcpServers": {
+    "apifox-workspace-mcp": {
+      "command": "npx",
+      "args": ["-y", "apifox-workspace-mcp"],
+      "env": {
+        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token",
+        "APIFOX_API_BASE_URL": "https://api.apifox.com"
+      }
+    }
+  }
+}
+```
+
+### 方式 2：全局安装
+
+```bash
+npm install -g apifox-workspace-mcp
+```
+
+配置示例：
+
+```json
+{
+  "mcpServers": {
+    "apifox-workspace-mcp": {
+      "command": "apifox-workspace-mcp",
+      "env": {
+        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token",
+        "APIFOX_API_BASE_URL": "https://api.apifox.com"
+      }
+    }
+  }
+}
+```
+
+### 方式 3：从源码运行
+
+```bash
+git clone https://github.com/apifox/apifox-workspace-mcp.git
+cd apifox-workspace-mcp
+npm install
+npm run build
+```
+
+配置示例：
+
+```json
+{
+  "mcpServers": {
+    "apifox-workspace-mcp": {
+      "command": "node",
+      "args": ["/path/to/apifox-workspace-mcp/dist/server/index.js"],
+      "env": {
+        "APIFOX_ACCESS_TOKEN": "your_apifox_access_token",
+        "APIFOX_API_BASE_URL": "https://api.apifox.com"
+      }
+    }
+  }
+}
+```
+
+## ⚙️ 配置说明
+
+### 必需配置
+
+- **`APIFOX_ACCESS_TOKEN`**（必需）
+  - 你的 Apifox Access Token
+  - 获取方式：Apifox → 个人设置 → Access Tokens
+
+### 可选配置
+
+- **`APIFOX_API_BASE_URL`**（可选）
+  - 自定义 API 基础地址
+  - 默认：`https://api.apifox.com`
+  - 私有部署时需要配置
+
+- **`LOG_LEVEL`**（可选）
+  - 日志级别：`debug` | `info` | `warn` | `error`
+  - 默认：`info`
+
+### 💡 工作原理
+
+使用 `npx apifox-workspace-mcp` 时的执行流程：
+
+1. ✅ npx 从 **npm 仓库**下载包（包含编译后的 `dist/` 目录）
+2. ✅ 执行 `dist/server/index.js`（无需构建）
+3. ✅ MCP Server 启动并连接到 Cursor
+
+**无需操心**：
+- ❌ 克隆 Git 仓库
+- ❌ 安装 TypeScript 或构建工具
+- ❌ 运行 `npm run build`
+
+> 📝 **说明**：`dist/` 目录不在 Git 仓库中（开发者不提交编译产物），但会自动包含在 npm 包中（用户下载即用）。详见 [分发机制说明](docs/distribution.md)
+
+详细配置指南：[📘 docs/setup.md](docs/setup.md)
+
+## 🚀 快速开始
+
+### 1️⃣ 添加项目
+
+```
+@apifox 添加项目：https://apifox.advai.net/apidoc/shared/xxx
+```
+
+### 2️⃣ 查询接口
+
+```
+@apifox 列出所有项目
+@apifox 搜索支付接口
+@apifox 查询 mboss-backend 项目的退款接口
+```
+
+### 3️⃣ 查看详情
+
+```
+@apifox 告诉我退款接口的详情
+@apifox 显示接口 api-12345 的完整信息
+```
+
+### 4️⃣ 生成代码
+
+```typescript
+// 生成 TypeScript 类型
+@apifox 帮我生成退款接口的 TypeScript 类型
+
+// 生成 Mock 数据
+@apifox 生成 Mock 数据
+
+// 生成请求封装
+@apifox 生成请求封装函数
+
+// 保存到文件
+@apifox 生成类型并保存到 src/api/types.ts
+```
+
+更多示例：[📗 docs/usage.md](docs/usage.md)
+
+## 🏗️ 项目架构
+
+采用**清晰的分层架构**，遵循 MCP Server 最佳实践：
+
+```
+src/
+├── server/         🟦 MCP Server 层（协议交互）
+│   ├── index.ts       ↳ Server 主入口（309 行，精简 68%）
+│   └── handlers/      ↳ 7 个工具处理器
+│
+├── core/           🟩 核心业务逻辑层（与 MCP 无关）
+│   ├── config/        ↳ 配置管理
+│   ├── client/        ↳ API 客户端（REST + MCP）
+│   ├── parser/        ↳ URL 解析器
+│   ├── generator/     ↳ 代码生成器
+│   └── ...            ↳ 上下文、意图识别
+│
+├── lib/            🟨 基础设施层（通用工具）
+│   ├── logger.ts      ↳ 日志系统
+│   ├── errors.ts      ↳ 错误类
+│   └── ...            ↳ 环境变量、工具函数
+│
+└── types/          🟪 类型定义层
+    └── index.ts       ↳ 所有共享类型
+```
+
+### 架构优势
+
+- ✅ **模块化**：27 个模块文件，职责清晰，易于维护
+- ✅ **类型安全**：100% TypeScript，零 `any` 类型
+- ✅ **可测试**：完整的单元测试覆盖（11 个测试）
+- ✅ **低耦合**：清晰的依赖方向，避免循环依赖
+
+详细架构：[📙 docs/architecture.md](docs/architecture.md)
+
+## 📚 可用工具
+
+| 工具 | 描述 | 使用场景 |
+|------|------|----------|
+| `list_projects` | 列出所有集成的项目 | 查看已配置的项目列表 |
+| `parse_and_add_project` | 解析分享链接并添加项目 | 快速集成新项目 |
+| `query_interfaces` | 查询项目接口列表 | 搜索、浏览接口 |
+| `get_interface_detail` | 获取接口详细信息 | 查看完整接口文档 |
+| `generate_artifacts` | 生成代码产物 | 自动生成类型、Mock、测试 |
+| `apifox_assistant` | 自然语言助手 | 对话式操作，更友好 |
+
+## 🧪 开发指南
+
+### 本地开发
+
+```bash
+# 克隆仓库
+git clone https://github.com/apifox/apifox-workspace-mcp.git
+cd apifox-workspace-mcp
+
+# 安装依赖
+npm install
+
+# 开发模式（监听文件变化）
+npm run dev
+
+# 构建项目
+npm run build
+
+# 运行测试
+npm run test
+
+# 代码检查
+npm run lint
+
+# 格式化代码
+npm run format
+
+# 类型检查
+npm run typecheck
+```
+
+### 添加新功能
+
+1. **添加新的 MCP 工具**
+   - 在 `src/server/handlers/` 创建 handler
+   - 在 `src/server/handlers/index.ts` 导出
+   - 在 `src/server/index.ts` 注册工具
+
+2. **添加核心功能**
+   - 在 `src/core/` 相应子模块中添加
+   - 在子模块 `index.ts` 中导出
+
+3. **添加工具函数**
+   - 在 `src/lib/` 中添加
+   - 在 `src/lib/index.ts` 中导出
+
+### 测试覆盖
+
+```bash
+# 运行测试
+npm run test
+
+# 监听模式
+npm run test:watch
+
+# 生成覆盖率报告
+npm run test -- --coverage
+```
+
+**当前测试状态**：
+- ✅ 11/11 测试通过
+- ✅ 3 个测试文件
+- ✅ 覆盖 logger、types、url-parser 模块
+
+## 📊 项目指标
+
+| 指标 | 数值 |
+|------|------|
+| **TypeScript 文件** | 30 个 |
+| **主入口行数** | 309 行（精简 68%）|
+| **模块数量** | 27 个 |
+| **单元测试** | 11 个（100% 通过）|
+| **类型安全** | 零 `any` 类型 |
+| **代码规范** | ESLint + Prettier |
+
+## 🛠️ 技术栈
+
+- **运行时**: Node.js >= 20
+- **语言**: TypeScript 5.3+
+- **协议**: Model Context Protocol (MCP) 0.5.0
+- **HTTP 客户端**: Axios 1.7+
+- **测试框架**: Vitest 2.1+
+- **代码规范**: ESLint 9+ + Prettier 3+
+- **UI 增强**: Playwright 1.57+
+
+## 📖 完整文档
+
+- 📘 [配置指南](docs/setup.md) - 详细的安装和配置步骤
+- 📗 [使用指南](docs/usage.md) - 各种使用场景和示例
+- 📙 [架构设计](docs/architecture.md) - 项目架构和设计原则
+- 📕 [发布指南](docs/publishing.md) - npm 发布流程
+- 🧪 [测试文档](tests/README.md) - 测试说明和测试用例
+
+## 🤝 贡献指南
+
+欢迎提交 Issue 和 Pull Request！
+
+### 开发流程
+
+1. Fork 本仓库
+2. 创建特性分支：`git checkout -b feature/amazing-feature`
+3. 提交更改：`git commit -m 'feat: add amazing feature'`
+4. 推送分支：`git push origin feature/amazing-feature`
+5. 提交 Pull Request
+
+### 提交规范
+
+遵循 [Conventional Commits](https://www.conventionalcommits.org/)：
+
+- `feat:` - 新功能
+- `fix:` - 修复 Bug
+- `docs:` - 文档更新
+- `style:` - 代码格式化
+- `refactor:` - 重构
+- `test:` - 测试相关
+- `chore:` - 构建/工具相关
+
+### 代码规范
+
+- ✅ 遵循 ESLint 规则
+- ✅ 使用 Prettier 格式化
+- ✅ 为新功能添加测试
+- ✅ 更新相关文档
+- ✅ 保持类型安全（避免 `any`）
+
+## 🐛 问题反馈
+
+遇到问题？请查看：
+
+1. [常见问题](docs/setup.md#常见问题)
+2. [Issues](https://github.com/apifox/apifox-workspace-mcp/issues)
+3. [测试文档](tests/README.md)
+
+## 📄 许可证
+
+[MIT License](LICENSE) - 自由使用、修改和分发
+
+## 🔗 相关资源
+
+- [Apifox 官网](https://apifox.com) - API 设计、开发、测试一体化平台
+- [MCP Protocol](https://modelcontextprotocol.io) - Model Context Protocol 官方文档
+- [Cursor AI](https://cursor.sh) - 智能 AI 代码编辑器
+- [GitHub Repository](https://github.com/apifox/apifox-workspace-mcp) - 项目源码
+
+## 🌟 Star History
+
+如果这个项目对你有帮助，请给我们一个 ⭐️ Star！
+
+---
+
+<div align="center">
+
+**Made with ❤️ by Apifox Team**
+
+[报告问题](https://github.com/apifox/apifox-workspace-mcp/issues) · [功能建议](https://github.com/apifox/apifox-workspace-mcp/issues) · [贡献代码](https://github.com/apifox/apifox-workspace-mcp/pulls)
+
+</div>

package/config/apifox-mcp.json.example

@@ -0,0 +1,5 @@
+{
+  "project-name": "project-id",
+  "payment-boss": "c2b11a34-d661-4a29-bbbe-04697b4f5de7"
+}
+

package/dist/__tests__/logger.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.test.d.ts.map

package/dist/__tests__/logger.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/logger.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/logger.test.js

@@ -0,0 +1,42 @@
+import { describe, it, expect, vi, beforeEach, afterEach } from 'vitest';
+import { logger } from '../lib/index.js';
+describe('logger', () => {
+    let consoleErrorSpy;
+    beforeEach(() => {
+        consoleErrorSpy = vi.spyOn(console, 'error').mockImplementation(() => { });
+    });
+    afterEach(() => {
+        consoleErrorSpy.mockRestore();
+        delete process.env.LOG_LEVEL;
+    });
+    describe('info', () => {
+        it('应该在默认级别下输出 info 日志', () => {
+            logger.info('测试信息');
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('测试信息'));
+        });
+    });
+    describe('warn', () => {
+        it('应该输出警告日志', () => {
+            logger.warn('警告信息');
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('警告信息'));
+        });
+    });
+    describe('error', () => {
+        it('应该输出错误日志', () => {
+            logger.error('错误信息');
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('错误信息'));
+        });
+    });
+    describe('debug', () => {
+        it('应该在 LOG_LEVEL=debug 时输出调试日志', () => {
+            process.env.LOG_LEVEL = 'debug';
+            logger.debug('调试信息');
+            expect(consoleErrorSpy).toHaveBeenCalledWith(expect.stringContaining('调试信息'));
+        });
+        it('应该在默认级别下不输出调试日志', () => {
+            logger.debug('调试信息');
+            expect(consoleErrorSpy).not.toHaveBeenCalled();
+        });
+    });
+});
+//# sourceMappingURL=logger.test.js.map

package/dist/__tests__/logger.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.test.js","sourceRoot":"","sources":["../../src/__tests__/logger.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AACzE,OAAO,EAAE,MAAM,EAAE,MAAM,iBAAiB,CAAC;AAEzC,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE;IACtB,IAAI,eAA4C,CAAC;IAEjD,UAAU,CAAC,GAAG,EAAE;QACd,eAAe,GAAG,EAAE,CAAC,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAC5E,CAAC,CAAC,CAAC;IAEH,SAAS,CAAC,GAAG,EAAE;QACb,eAAe,CAAC,WAAW,EAAE,CAAC;QAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IAC/B,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,oBAAoB,EAAE,GAAG,EAAE;YAC5B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,MAAM,EAAE,GAAG,EAAE;QACpB,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;YAClB,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACpB,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;YAClB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;QACrB,EAAE,CAAC,6BAA6B,EAAE,GAAG,EAAE;YACrC,OAAO,CAAC,GAAG,CAAC,SAAS,GAAG,OAAO,CAAC;YAChC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,eAAe,CAAC,CAAC,oBAAoB,CAAC,MAAM,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,iBAAiB,EAAE,GAAG,EAAE;YACzB,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YACrB,MAAM,CAAC,eAAe,CAAC,CAAC,GAAG,CAAC,gBAAgB,EAAE,CAAC;QACjD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/types.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.test.d.ts.map

package/dist/__tests__/types.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/types.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/types.test.js

@@ -0,0 +1,30 @@
+import { describe, it, expect } from 'vitest';
+import { createTextResponse, createErrorResponse } from '../types/index.js';
+describe('types', () => {
+    describe('createTextResponse', () => {
+        it('应该创建正常文本响应', () => {
+            const response = createTextResponse('测试消息');
+            expect(response).toEqual({
+                content: [{ type: 'text', text: '测试消息' }],
+                isError: false,
+            });
+        });
+        it('应该创建带错误标志的响应', () => {
+            const response = createTextResponse('错误消息', true);
+            expect(response).toEqual({
+                content: [{ type: 'text', text: '错误消息' }],
+                isError: true,
+            });
+        });
+    });
+    describe('createErrorResponse', () => {
+        it('应该创建错误响应', () => {
+            const response = createErrorResponse('发生错误');
+            expect(response).toEqual({
+                content: [{ type: 'text', text: '发生错误' }],
+                isError: true,
+            });
+        });
+    });
+});
+//# sourceMappingURL=types.test.js.map

package/dist/__tests__/types.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../src/__tests__/types.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAE5E,QAAQ,CAAC,OAAO,EAAE,GAAG,EAAE;IACrB,QAAQ,CAAC,oBAAoB,EAAE,GAAG,EAAE;QAClC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE;YACpB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC;YAC5C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,OAAO,EAAE,KAAK;aACf,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,cAAc,EAAE,GAAG,EAAE;YACtB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAClD,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,qBAAqB,EAAE,GAAG,EAAE;QACnC,EAAE,CAAC,UAAU,EAAE,GAAG,EAAE;YAClB,MAAM,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;YAC7C,MAAM,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC;gBACvB,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;gBACzC,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/__tests__/url-parser.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=url-parser.test.d.ts.map

package/dist/__tests__/url-parser.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/url-parser.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/url-parser.test.js

@@ -0,0 +1,27 @@
+import { describe, it, expect } from 'vitest';
+import { isValidApifoxUrl, ShareLinkType } from '../core/index.js';
+describe('url-parser', () => {
+    describe('isValidApifoxUrl', () => {
+        it('应该识别有效的 Apifox 分享链接', () => {
+            expect(isValidApifoxUrl('https://apifox.com/apidoc/shared/abc123')).toBe(true);
+            expect(isValidApifoxUrl('https://example.apifox.com/apidoc/shared/abc123')).toBe(true);
+            expect(isValidApifoxUrl('https://custom.example.com/apidoc/shared/xyz789')).toBe(true);
+        });
+        it('应该拒绝无效的 URL', () => {
+            expect(isValidApifoxUrl('https://google.com')).toBe(false);
+            expect(isValidApifoxUrl('not-a-url')).toBe(false);
+            expect(isValidApifoxUrl('')).toBe(false);
+            // 非 /apidoc/shared/ 格式的链接
+            expect(isValidApifoxUrl('https://app.apifox.com/project/123')).toBe(false);
+        });
+    });
+    describe('ShareLinkType', () => {
+        it('应该正确定义枚举值', () => {
+            expect(ShareLinkType.PROJECT).toBe('project');
+            expect(ShareLinkType.INTERFACE).toBe('interface');
+        });
+    });
+    // 注意: parseApifoxUrl 是异步函数，需要网络请求，
+    // 完整的集成测试应该使用 mock 或在集成测试中进行
+});
+//# sourceMappingURL=url-parser.test.js.map

package/dist/__tests__/url-parser.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.test.js","sourceRoot":"","sources":["../../src/__tests__/url-parser.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEnE,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,QAAQ,CAAC,kBAAkB,EAAE,GAAG,EAAE;QAChC,EAAE,CAAC,qBAAqB,EAAE,GAAG,EAAE;YAC7B,MAAM,CAAC,gBAAgB,CAAC,yCAAyC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/E,MAAM,CAAC,gBAAgB,CAAC,iDAAiD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvF,MAAM,CAAC,gBAAgB,CAAC,iDAAiD,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzF,CAAC,CAAC,CAAC;QAEH,EAAE,CAAC,aAAa,EAAE,GAAG,EAAE;YACrB,MAAM,CAAC,gBAAgB,CAAC,oBAAoB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAC3D,MAAM,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YAClD,MAAM,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzC,0BAA0B;YAC1B,MAAM,CAAC,gBAAgB,CAAC,oCAAoC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC7E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;QAC7B,EAAE,CAAC,WAAW,EAAE,GAAG,EAAE;YACnB,MAAM,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAC9C,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,mCAAmC;IACnC,6BAA6B;AAC/B,CAAC,CAAC,CAAC"}

package/dist/core/client/apifox.d.ts

@@ -0,0 +1,62 @@
+import { ApiRequestSpec, ApiResponseSpec } from '../../types/index.js';
+/**
+ * Apifox API 客户端
+ * 封装 Apifox REST API 调用
+ */
+export declare class ApifoxClient {
+    private client;
+    private accessToken;
+    constructor(accessToken: string, baseUrl?: string);
+    /**
+     * 获取项目信息
+     * @param projectId 项目 ID
+     * @returns 项目信息
+     */
+    getProjectInfo(projectId: string): Promise<{
+        id: string;
+        name: string;
+        description?: string;
+    }>;
+    /**
+     * 获取项目接口列表
+     * @param projectId 项目 ID
+     * @param keyword 搜索关键词（可选）
+     * @returns 接口列表
+     */
+    getInterfaces(projectId: string, keyword?: string): Promise<Array<{
+        id: string;
+        name: string;
+        method: string;
+        path: string;
+        description?: string;
+    }>>;
+    /**
+     * 获取接口详情
+     * @param projectId 项目 ID
+     * @param interfaceId 接口 ID
+     * @returns 接口详情
+     */
+    getInterfaceDetail(projectId: string, interfaceId: string): Promise<{
+        id: string;
+        name: string;
+        method: string;
+        path: string;
+        description?: string;
+        request?: ApiRequestSpec;
+        response?: ApiResponseSpec;
+    }>;
+    /**
+     * 搜索接口（根据关键词）
+     * @param projectId 项目 ID
+     * @param keyword 搜索关键词
+     * @returns 匹配的接口列表
+     */
+    searchInterfaces(projectId: string, keyword: string): Promise<Array<{
+        id: string;
+        name: string;
+        method: string;
+        path: string;
+        description?: string;
+    }>>;
+}
+//# sourceMappingURL=apifox.d.ts.map

package/dist/core/client/apifox.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apifox.d.ts","sourceRoot":"","sources":["../../../src/core/client/apifox.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAEvE;;;GAGG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,WAAW,CAAS;gBAEhB,WAAW,EAAE,MAAM,EAAE,OAAO,GAAE,MAAiC;IAY3E;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAC/C,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAYF;;;;;OAKG;IACG,aAAa,CACjB,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CACR,KAAK,CAAC;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CACH;IAiBD;;;;;OAKG;IACG,kBAAkB,CACtB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC;QACT,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE,cAAc,CAAC;QACzB,QAAQ,CAAC,EAAE,eAAe,CAAC;KAC5B,CAAC;IAYF;;;;;OAKG;IACG,gBAAgB,CACpB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,OAAO,CACR,KAAK,CAAC;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC,CACH;CAGF"}