菜单
文件解包、文本抽取与排版样式画像基座。给一个 URL 或本地路径，返回压缩包内全部材料的结构化文本——zip 递归解压（修复中文文件名乱码）、PDF 抽文本、Word（docx）连表格一起抽，图片与扫描件本机联网时走 rapidocr、离线时交回平台识别。脚本零第三方依赖，离线环境直接可跑。另可产出排版样式画像（字体、字号、行距、缩进、页边距）并比对两份文件的差异。单个文件解析失败不影响其余材料，失败原因逐条如实报出。当用户提到压缩包解析、zip 解压、批量文件提取、PDF 文本提取、Word 文本提取、扫描件识别、图片 OCR、排版格式对比、字体字号提取、附件材料整理时触发。
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/mhaibaraai/movk-skills --skill file-extract命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
合同辅助审查。给一个「合同 + 签约依据」压缩包，解析出合同正文与全部依据材料（含扫描件、会议纪要截图），逐条对照公司标准合同模板，产出结构化 Markdown 审查报告——覆盖基础文本审查（金额、标点、错别字）、排版格式核对（正文字体字号、行距、页边距、条款编号连续性）、条款缺失与模板差异、与签约依据的一致性、风险合规提示。当用户提到合同审查、合同审核、合同比对、条款缺失、合同风险、签约依据、合同模板校验、排版格式检查、字体字号核对、起草合同把关时触发。
检索中国石化、中国石油、中国海油等国内石化企业，埃克森美孚、壳牌、BP 等国际油气巨头，以及 IEA、OPEC、伍德麦肯兹、中国石油和化学工业联合会等研究机构的公开报告（年报、可持续发展报告、月度报告、研究报告），按核心数据、关键结论、市场趋势、投资动态、风险、产业链影响六个维度提炼洞察，输出深度分析 / 行业动态速览 / 多机构观点对比三类报告。当用户提到石化报告、能源研报、油气行业研究、石化市场洞察、炼化行业分析、油气企业年报解读、行业动态摘要时触发。
面向发改委、工信部、应急管理部三大核心部委及国务院、生态环境部、市场监管总局、能源局、财政部等关联部委，自动检索政策原文（含 PDF 附件全文）并解读，提炼政策层级、核心条款、适用范围、时间节点与处罚责任，评估企业合规影响，输出深度解读 / 要点速览 / 多政策对比三类报告。全流程零 API Key。当用户提到政策解读、法规分析、合规管理、发改委政策、工信部政策、应急管理部政策、政策总结、法规要点、政策影响分析时触发。
正在显示 SKILL.md
| name | file-extract |
| description | 文件解包、文本抽取与排版样式画像基座。给一个 URL 或本地路径，返回压缩包内全部材料的结构化文本——zip 递归解压（修复中文文件名乱码）、PDF 抽文本、Word（docx）连表格一起抽，图片与扫描件本机联网时走 rapidocr、离线时交回平台识别。脚本零第三方依赖，离线环境直接可跑。另可产出排版样式画像（字体、字号、行距、缩进、页边距）并比对两份文件的差异。单个文件解析失败不影响其余材料，失败原因逐条如实报出。当用户提到压缩包解析、zip 解压、批量文件提取、PDF 文本提取、Word 文本提取、扫描件识别、图片 OCR、排版格式对比、字体字号提取、附件材料整理时触发。 |
把「一个压缩包 / 一个文件」变成模型可读的结构化文本材料。设计动机：宿主环境的解析节点只吃单独上传的文件，压缩包内部的材料进不去；沙箱每轮全新，也不能依赖上一轮留下的中间产物——解包与抽取必须内化进脚本本身，一次调用拿全。
运行约定：
scripts/x.py；被其他技能调用时它们用 ../file-extract/ 前缀。执行时给命令加上技能根目录前缀，不要 cd 进技能目录——输出文件要落在当前工作目录。前缀取宿主加载技能时告知的 Base directory；拿不到就用 find / -name extract.py -not -path '*__pycache__*' 2>/dev/null | head -1 定位，取其上两级为技能根目录。python3 调用。只有本机 OCR（scripts/ocr.py）还需要 uv run 装依赖，离线环境装不上是正常的，见下文 OCR 一节。uv run 命令不要加 timeout 参数，沙箱后端不支持 per-command timeout override，加了必定报错。python3 scripts/extract.py --url https://<域名>/api/file/<id>
python3 scripts/extract.py --path ./材料.zip --ocr off
--url 与 --path 二选一。压缩包会递归展开（嵌套深度 2 层），非压缩包按单文件处理。一次调用处理完整个包，不要逐个文件反复调——OCR 依赖首次加载有固定开销，拆开调是在重复付费。
支持的扩展名：文档 pdf / docx / txt / md / csv，图片 jpg / jpeg / png / gif / bmp / webp / tif / tiff。其余（doc、xlsx、ppt 等）进 errors 的 unsupported_ext，不静默丢弃。
常用参数：--ocr auto|on|off、--max-chars（单文件文本上限，默认 40000）、--max-bytes（下载体积上限，默认 50MB）、--out-dir（把解出的原始文件落盘，供后续处理）。
输出 JSON 分五段：source（来源与体积）、files（成功抽到文本的材料）、skipped（系统噪音，无需关心）、pending_ocr（待识别的图片与扫描件）、errors（逐条失败原因）。字段全表与 errors[].kind 取值见 references/format.md。
pending_ocr 与 errors 必须读、必须如实转达给用户，它们是「这份材料我没看到」的唯一凭据。把没抽到的文件当成不存在，会让下游拿着残缺材料下结论。
纯文本里没有字体字号，排版审查只能从原始文件取。独立入口 scripts/styles.py 把一份 docx / pdf 归纳成一份样式画像，给了 --template 就顺带算出两者的差异：
python3 scripts/styles.py --path 合同.pdf --template 标准模板.docx
输出 contract、template 两份画像（正文字体字号、行距、首行缩进、页边距、页面尺寸、按字号推断的疑似标题、顶层条款序号连续性）、diffs（逐项比对，match 为 false 的才是问题，带容差与口径 note）、not_comparable（这次核不了的项及原因）。
两条来源的能力不同，not_comparable 必须如实转达：docx 的样式是精确读出来的；PDF 只有字体、字号是直读，行距靠相邻基线差实测，左/上边距按文字起始位置推算，首行缩进、对齐、右/下边距根本取不到。
图片没有别的路可走，一律走 OCR；PDF 只在抽不出文本层（疑似扫描件）时才回落识别，有文本层的直接用文本层，快且准。
识别有两条路，按环境自动选：
scripts/ocr.py（rapidocr，约 150MB 依赖，由 uv run 现装）。只在真的遇到图片或扫描件时才被拉起，--ocr off 的运行完全不碰它。模型权重打包在 wheel 内，运行时不联网拉模型。python3 scripts/extract.py --path ./材料.zip \
--platform-base https://<域名> --platform-token <token>
扫描件 PDF 由平台直接解析成正文写回 files；图片上传后换成公开 URL 放进 pending_ocr，由调用方的下游节点交给视觉模型识别。两条路都走不通的材料留在 pending_ocr 里，uploaded 为 false。
--parse-remote force 让文档也走平台解析，off 则完全不出网。token 只用于请求头，不会出现在任何输出里。
部署到新环境先探一次：
python3 scripts/extract.py --check-env
输出 docx / pypdf / ocr 三项可用性。离线环境里 ocr 必然不可用，图片走平台那条路——这是设计好的降级，不是故障。
errors 与 skipped 原样转述，不猜测失败原因、不替用户美化--ocr off 时进 pending_ocr；auto 时先试本机栅格化 OCR，再试平台解析，都不成会回退到文本层那点残留内容并在 detail 里注明too_large 并停在该条目，已处理的材料照常返回parse_failed（解密要 cryptography，零依赖环境装不了）download_failed（取不到）、too_large（超限）、bad_archive（不是有效压缩包）。此时脚本退出码非零，stdout 是 {"error": {...}}；其余失败都是单文件级别，不中断其余材料