讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

剧云
剧云

中文短剧剧本制作平台

updream

一键生成高质量推广成片

立刻MV
立刻MV

低成本歌曲 MV、视频生成

pdf-fin-parse

Polar Sponsor
爱发电 赞助
.NET 9.0

解析金融行业 PDF 文档(A股年报、港股财报、美股10-K、招股说明书等)为结构化 Markdown + JSON。专为跨页表格、无边框表格、多级表头、密集数值、多栏排版等金融场景设计。底层调用火山 LAS las_pdf_parse_doubao 算子做通用解析,再经 6 层金融后处理(HTML 表格解析 /...

PDF 财务 帕尔瑟·斯基尔 PDF + 马克当 + JSON + 拉斯 pdf parse doubao + , 6 + 资产/输出 schema.json

功能概述

PDF 财务 帕尔瑟·斯基尔 PDF + 马克当 + JSON + 拉斯 pdf parse doubao + , 6 + 资产/输出 schema.json 是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。

核心要点

  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
  • 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;

结果检查与注意事项

涉及批量任务时,还应保存进度,避免中断后重复操作。该技能适合用于一次性任务,也可以接入自动化工作流,与其他技能或上层代理配合完成更完整的业务链路;在组合使用时,应明确每一步的输入输出关系,并避免不同步骤之间出现参数冲突。

PDF Finance Parser Skill

金融场景 PDF → 结构化 Markdown + JSON。底层调用火山方舟 LAS 算子 las_pdf_parse_doubao 做通用解析,再经 6 层金融后处理还原为符合 assets/output_schema.json 的业务 JSON(含 value/unit/source_page/validation)。

设计模式

  • Engine + Post-process 解耦:LAS 是通用解析引擎(黑盒),金融业务规则是独立后处理层,引擎可替换、业务可独立迭代
  • Pipeline:输入归一化 → LAS submit/poll → HTML 表解析 → 多级表头 → 跨页合并 → 数值规整 → 财务术语对齐 → 业务校验 → schema-compliant 输出
  • Inversion:调用前先与用户确认解析模式(normal / detail);不私自决定
  • Best-effort 校验:业务规则违反时标 warning 而非修改原值;保留可追溯性

Gotchas

  • 必须配置 LAS_API_KEY(火山方舟 LAS)
  • 本地 PDF 上传 LAS 必须先经过 TOS(火山对象存储),所以也必须配置 TOS_ACCESS_KEY / TOS_SECRET_KEY / TOS_BUCKET
  • 若 TOS 桶 region 不是 cn-beijing(LAS 默认 region),需要 export TOS_REGION="" 单独指定(tos:// 协议跨 region 由 LAS 解析)
  • TOS 对象 key 不能含中文字符(LAS 后端 URL parser 不接受),本 skill 已在 tos_uploader.py 做 ASCII sanitize
  • LAS 并发限制 1 QPM,多文档批跑会自动退避;不要并行 spawn 多个进程
  • 长报告(>200 页)建议用 --pages 1-50 分段
  • 财报跨页表格("(续)" 标志)由后处理层 cross_page_merger.py 自动合并;想关掉后处理传 --no-postprocess

工作流

复制此清单并跟踪进度:

解析进度:
- [ ] 步骤 0:确认解析模式(normal / detail)
- [ ] 步骤 1:环境就绪(venv + env.sh 凭证)
- [ ] 步骤 2:执行 parse-las
- [ ] 步骤 3:检查 meta.json.postprocess + output.json.validation
- [ ] 步骤 4:按"结果回复模板"汇报

第 0 步:确认解析模式(必须先执行)

请选择 PDF 解析模式:

| 模式   | 说明                                          | 价格      |
|--------|-----------------------------------------------|-----------|
| normal | 默认,单次推理,速度更快,适用于结构清晰的文档 | 0.02 元/页 |
| detail | 深度分析,对复杂表格/扫描件/印章精度更高       | 0.04 元/页 |

推荐:A股/港股标准年报选 normal;财报附注、合并报表跨页、扫描合同选 detail。
  • 用户未明确指定 → 默认 normal

第 1 步:环境就绪(仅首次)

cd {skill_directory} && 
  (test -d .venv || (python3 -m venv .venv && 
   .venv/bin/pip install -r ../../requirements.txt)) && 
  .venv/bin/python3 scripts/skill.py info

info 命令验证 VLM 配置(仍用于 v0.2 fallback 路径的健康检查)。

首次使用必须先填好 env.sh —— 把 LAS_API_KEY / TOS 凭证替换成你自己的值。 框架会在 skill 目录自动加载 env.sh,无需手动 source。

第 2 步:执行解析

.venv/bin/python3 scripts/skill.py parse-las 
  --input  
  --output  
  --parse-mode normal
  • stdout 输出一行 JSON:{"status":"COMPLETED","task_id":"...","page_count":N,"table_count":N,"postprocess":{...},"preview":"..."}
  • stderr 输出过程日志(TOS 上传、LAS submit/poll、后处理进度、validator warnings)
  • 默认开启金融后处理;传 --no-postprocess 跳过(通用文档场景)

第 3 步:检查 meta.json + output.json.validation

meta.json 必读字段:

字段 含义 处理
status COMPLETED / FAILED FAILED 时看 error_msg
page_count / table_count LAS 解析的页数 / 表格数 对比 GT 检查漏抽
postprocess.merged_table_count 跨页合并后的表数 通常 < raw_table_count 表示有合并
postprocess.validation_warning_count 业务规则不一致计数 > 0 时看 output.json 的 tables[].validation
wall_time_seconds 端到端耗时 评测对比用

output.json 关键 sub-field(v0.3 新增):

  • tables[].statement_type:balance_sheet / income_statement / cash_flow / equity_change
  • tables[].declared_unit:从表头声明文本中识别的单位(如 "百万元")
  • tables[].column_paths:每列多级表头展平的 path(如 "本集团 / 2026年3月31日(未经审计)")
  • tables[].source_pages:跨页合并后的源页号数组
  • tables[].validation:业务规则校验结果(warnings 列表)

第 4 步:结果回复模板

✅ 解析完成

📄 文档信息
- 文件:{filename}
- 页数:{page_count} | 表格:{table_count}(合并后 {postprocess.merged_table_count})
- 模式:{parse_mode} | 耗时:{wall_time}s

📁 输出
- 业务 JSON:{output_dir}/output.json(符合 assets/output_schema.json)
- 整篇 Markdown:{output_dir}/output.md
- LAS 原始响应:{output_dir}/result.full.json
- 单页 markdown:{output_dir}/pages/p{N}.md

⚠️ 注意(若有)
- 业务规则 {N} 处不一致:查看 output.json.tables[].validation.warnings

输出目录结构

{output_dir}/
├── output.json          # ★ 金融业务 JSON(cells 含 value/unit/source_page/validation)
├── output.md            # 整篇 markdown(≈ result.md)
├── meta.json            # task_id / wall_time / postprocess 摘要
├── result.md            # LAS 原始 markdown(表格为 HTML )
├── result.full.json     # LAS 完整响应(含 detail[].text_blocks / bbox)
└── pages/
    ├── p1.md            # 单页 markdown(评测 / 对比用)
    ├── p2.md
    └── ...

金融后处理 6 层

层 模块 职责
1 html_table_parser.py BS4 解析 LAS 的 ,rowspan/colspan 展开为网格
2 multi_header_detector.py 数 header_rows + 计算每列 column_path
3 cross_page_merger.py (续) 关键词 + 列结构匹配 → 多张分页表合一
4 numeric_normalizer.py 千分位 / (负数) / 万/亿/百万元 / percent / -→null
5 finance_terms_aligner.py statement_type 识别 + group / subtotal / grand_total 关键词
6 finance_validator.py 资产 = 负债 + 权益、Σ明细 = subtotal(best-effort,标 warning 不修值)

异常处理决策树

现象 来源 处理
LAS_API_KEY 未配置 env.sh 缺失或未加载 检查 skill 目录下 env.sh 是否存在、值是否非占位符
TOS_BUCKET 未配置 TOS 凭证缺失 同上;如桶在非 LAS region,再 export TOS_REGION
NoSuchBucket / 404 桶名拼错 / region 不一致 用 clawhub auth whoami 或 TOS 控制台确认桶 region,更新 TOS_REGION
Url.Invalid TOS key 含特殊字符 / 跨 region 拉不到 tos_uploader.py 已 sanitize;若仍出现,检查 TOS 桶是否在 LAS region
LAS task 持续 RUNNING 不返回 单次大文档 已自动退避;超过 max-poll-attempts (60×30s) 仍未返回 → 拆分页范围
validation_warning_count > 0 业务规则不一致 看 output.json.tables[].validation.warnings;不阻塞流程,best-effort
Url.Invalid: invalid url tos://... 含中文 中文路径未 sanitize 已修,若复现请上报

进阶用法

仅解析某些页(连续范围)

.venv/bin/python3 scripts/skill.py parse-las 
  --input  --output  --pages 1-10

LAS 仅支持连续页范围(start_page + num_pages),不支持 1,3,5 离散页。

强制使用 detail 模式(2× 价,更精细)

.venv/bin/python3 scripts/skill.py parse-las 
  --input  --output  --parse-mode detail

跳过金融后处理(通用文档场景)

.venv/bin/python3 scripts/skill.py parse-las 
  --input  --output  --no-postprocess

只生成 result.md / result.full.json / pages/,不生成 output.json。适合非金融场景或想观察 LAS 原始输出。

与评测脚本对接

# 批量预测(仓库内 evaluation/scripts/)
python3 evaluation/scripts/run_lasbench_predictions.py 
  --images-dir /images --out-dir 

# 一键算指标
python3 evaluation/scripts/run_omnidocbench_eval.py 
  --gt  --pred-dir 
 --out 

# 渲染 HTML 报告
python3 evaluation/scripts/render_omnidocbench_report.py 
  --input  --output 

重要约束

  1. 业务层与解析层解耦:金融后处理只接受 LAS 已结构化的输入;不要在后处理里塞 VLM 提示词 / 渲染逻辑
  2. 不修改原始 PDF:只读,TOS 上传也是只读复制
  3. 不做数值"创意修正":原文 1,234 → value=1234(去千分位 + 按声明单位归一化到 yuan),但不做上下文猜测
  4. 保留可追溯性:每个 cell 带 source_page,跨页合并表带 source_pages[]
  5. 业务规则 best-effort:不一致只标 warning,不改写 value;评测层负责打分

参考资料

  • 命令参数详解
  • API 与提示词约定
  • 配置说明
  • 常见问题 FAQ
  • 输出 JSON Schema
  • 财务术语词表
  • 常见财报表格模板
目录

热门AI工具

更多
切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

UP简历
UP简历 Hot

一款AI办公效率工具,主要用于基于AI技术的免费在线简历制作工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
Postman身份认证怎么配置
Postman身份认证怎么配置

本专题从实际API接口调试场景出发,讲解Postman身份认证的完整配置流程,包括常见认证协议介绍、授权参数设置、访问令牌填写、OAuth 2.0授权及认证失败排查,帮助用户正确完成接口授权与访问验证。

0

2026.11.06

Postman请求头Headers怎么设置
Postman请求头Headers怎么设置

围绕Postman HTTP请求头配置展开,讲解Headers选项的具体使用方式,包括Key和Value参数填写、请求头信息添加、常见Header字段设置及请求头修改方法,帮助用户解决接口调试过程中遇到的请求头配置问题。

0

2026.11.06

Postman接口请求发送教程
Postman接口请求发送教程

详细介绍Postman接口请求的创建与发送方法,涵盖GET和POST请求、URL配置、请求参数、Headers请求头、Body请求体设置以及响应结果查看,帮助用户掌握Postman接口请求的完整操作流程。

0

2026.11.06

DBeaver怎么导入数据
DBeaver怎么导入数据

DBeaver数据导入专题,整理Excel、CSV、SQL、TXT等常见文件的数据导入方法,涵盖目标数据库选择、数据表创建、字段映射、数据类型设置及导入参数配置等操作,帮助用户将本地文件中的数据写入数据库,并了解批量导入、重复数据处理和导入失败等常见问题的解决方法。

0

2026.11.05

DBeaver安全防护教程大全
DBeaver安全防护教程大全

DBeaver安全防护专题,围绕数据库连接安全、账号密码保护和访问权限管理展开,整理SSL/TLS加密连接、SSH隧道、数据库凭据保存及证书验证等配置方法,同时介绍敏感信息保护、远程连接风险和高权限账号使用等注意事项,帮助用户提高数据库日常管理的安全性。

0

2026.11.05

DBeaver连接创建与配置教程
DBeaver连接创建与配置教程

本专题聚焦DBeaver数据库连接配置与管理,覆盖从新建连接、选择数据库类型到填写连接参数和验证连接的完整流程。针对MySQL、PostgreSQL、SQL Server等常见数据库,整理相应的连接设置方法,并提供驱动缺失、认证失败和连接异常等问题的排查方向。

0

2026.11.04

XORM框架结构体映射与表结构同步
XORM框架结构体映射与表结构同步

本专题围绕XORM框架的结构体映射展开,说明表名与字段的命名策略、xorm标签常用属性、主键自增与时间字段自动填充,并演示Sync2自动建表、增量字段升级、索引声明与反向生成结构体的完整流程。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

XORM框架安装配置与数据库连接
XORM框架安装配置与数据库连接

本专题聚焦XORM框架的配置与连接环节,拆解MySQL、PostgreSQL、SQLite、SQL Server的DSN写法与驱动选择,讲清连接池参数、多数据源拆分、读写分离与超时重连的处理方式,并补充容器与兼容数据库的适配经验。

0

2026.11.04

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn