ShowDoc 自动化工具集

从 ShowDoc 自动获取 API 文档数据，并生成 Android 代码的 Python 工具集。

项目结构

fengli/
├── core/                   # 核心模块：ShowDoc 客户端、验证码识别
├── android_codegen/        # Android 代码生成工具（Entity、Repository、Retrofit）
├── api_docs/              # API 文档示例和预研文档
├── mcp_showdoc_android/   # MCP 服务器实现
└── pyproject.toml         # 项目配置

核心功能

1. ShowDoc 数据获取 (core/)

• 自动登录（支持密码或 Cookie 认证）
• Cookie 自动保存和复用（类似浏览器会话管理）
• 验证码识别（基于 ddddocr，识别准确率高）
• 结构化数据解析（分类、页面、API 定义）
• 支持按节点筛选数据
• 支持多种 URL 格式（标准格式和登录页面格式）

2. Android 代码生成 (android_codegen/)

• Entity 实体类生成
• Repository 数据仓库生成
• Retrofit 接口生成
• OkHttp 配置生成

3. MCP 服务器 (mcp_showdoc_android/)

• 提供 MCP 协议接口
• 支持通过 MCP 调用代码生成功能

快速开始

安装依赖

# 安装所有依赖
pip install -r requirements.txt

# 或安装完整项目（包括 MCP 服务器）
pip install -e .

基本使用

from core import ShowDocClient

# 初始化客户端
base_url = "https://doc.cqfengli.com/web/#/90/"
client = ShowDocClient(base_url, password="123456")

# 获取所有接口数据
api_tree = client.get_all_apis()

# 获取指定节点的数据
api_tree = client.get_all_apis(node_name="订单")

# 转换为字典格式
data = api_tree.to_dict()

测试

# 运行核心模块测试
cd core
python test.py

# 或从项目根目录运行
python -m core.test

模块说明

• core/: ShowDoc 客户端核心实现，详见 core/README.md
• android_codegen/: Android 代码生成工具，详见 android_codegen/README.md
• mcp_showdoc_android/: MCP 服务器，详见 mcp_showdoc_android/README.md
• api_docs/: API 文档示例，详见 api_docs/README.md

依赖要求

• Python >= 3.9
• 核心依赖：requests, opencv-python, numpy, ddddocr

开发规范

本项目遵循以下规范：

• 使用简体中文进行注释和文档
• 优先使用现代 Python 特性（类型注解、dataclass 等）
• 模块化设计，保持单一职责
• 详细的异常处理和错误提示

许可证

本项目为内部工具，仅供团队使用。