lihanghang InsightDoc 文档解析技能
基于 InsightDoc API (https://insightdoc.memect.cn/) 的文档解析技能，支持将 PDF 或图片转换为结构化数据。
API Key 配置（重要）
本技能需要 API Key 认证，按以下优先级获取：
- 环境变量（推荐）：
export INSIGHTDOC_API_KEY="sk-xxxxxxxxxxxx" .env文件：在项目根目录创建.env文件，写入INSIGHTDOC_API_KEY=sk-xxxxxxxxxxxx- 命令行参数：
--api-key sk-xxxxxxxxxxxx（临时使用）
⚠️ 禁止将 API Key 硬编码到代码或 SKILL.md 中。
.env文件已在.gitignore中排除。
核心能力
| 功能 | 说明 |
|---|---|
| 本地文件解析 | 上传本地 PDF/图片，等待解析完成，返回结果 |
| URL 文件解析 | 先下载远程 PDF，再上传解析 |
| 多格式输出 | md、html、block_md、docx（通用）；matrix、normalization（财报） |
| 多版本支持 | 通用解析支持 v1/v2 版本切换 |
| 结果导出 | 导出为指定格式文件 |
使用方式
1. 解析本地文件
python .cursor/skills/insightdoc/scripts/parse.py --file <文件路径> --type <任务类型> --format <输出格式> [--version <版本>]
2. 解析远程 URL 文件
python .cursor/skills/insightdoc/scripts/parse.py --url <PDF的URL> --type <任务类型> --format <输出格式>
3. 查询已有任务
python .cursor/skills/insightdoc/scripts/parse.py --task-id <任务ID> --format <输出格式>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
--file |
与 --url/--task-id 三选一 |
本地文件路径（PDF/JPG/PNG，≤50MB） |
--url |
与 --file/--task-id 三选一 |
远程 PDF 文件 URL |
--task-id |
与 --file/--url 三选一 |
已有任务 ID，直接查询结果 |
--type |
否 | docparse（默认）或 finance_ocr |
--format |
否 | 输出格式，见下表 |
--version |
否 | 解析版本（如 v1、v2），仅通用解析有效 |
--output |
否 | 结果保存路径（默认输出到 stdout） |
--api-key |
否 | 临时指定 API Key，覆盖环境变量 |
输出格式对照
| 任务类型 | 可选格式 |
|---|---|
docparse |
md（默认）、html、block_md、docx |
finance_ocr |
matrix、normalization |
智能体调用示例
当用户说：
- "解析这个 PDF" →
--file <路径> --type docparse --format md - "把这个财报转成矩阵格式" →
--file <路径> --type finance_ocr --format matrix - "解析这个链接的文档" →
--url <URL> --type docparse --format md - "用 v2 版本解析" → 加
--version v2 - "输出 JSON 到文件" → 加
--output result.json
进化机制
- 脚本运行异常时自动向下方追加经验记录
- 执行任务前请先查看"自动记录"部分
自动记录
[2026-02-12 11:57]
RuntimeError: API 请求失败 [400]: {"detail":"Unable to detect file type"}[2026-02-12 18:44]
RuntimeError: API 请求失败 [403]: {"detail":"Usage limit exceeded"}[2026-02-12 18:50]
RuntimeError: API 请求失败 [403]: {"detail":"Usage limit exceeded"}