快速上手

开始之前

你不需要安装任何东西 —— Ztract 完全在浏览器里运行，地址是 app.ztract.com。下面这些步骤不需要 CLI、SDK 或 API；等 API 上线后我们会单独写一篇文档。你只需要一份想抽取数据的文档 —— PDF、Word、Excel 表格、扫描件，或者一张手机照片 —— 再加一个邮箱地址。

第一步 —— 注册账号

打开 app.ztract.com。填邮箱，我们会发一封一次性验证码 邮件 —— 不用记密码，没有单独的注册表单，也不用绑信用卡。（更喜欢用 Google？ Continue with Google 就在邮箱输入框下面。）登录之后，你的账号会自动获得 30 页免费额度。你可以放心用这些额度跑引擎，没有任何承诺；我们不会偷偷把你 切到某个套餐，也不会发营销邮件烦你。

第二步 —— 创建你的第一个项目

Ztract 里的项目，是一组共享同一个 schema 的相关文档。大多数团队会按文档类型 建一个项目 —— “供应商发票”、“报销收据”、“客户合同” —— 再加一个项目放杂七杂八 的零散文件。项目数量没有上限。

在 dashboard 点 新建项目，给它取个名字，然后选一个起始 schema（下一步会 解释这是什么意思）。

第三步 —— 定义你的 schema

Schema 就是你希望 Ztract 从每份文档里抽出的字段列表。对发票来说可能是 发票号、供应商、日期、合计，以及一个明细行表格。对收据来说，是商家、日期、商品。 对护照来说，是姓名、证件号、有效期。

你可以用三种方式定义：

• 选一份模板。 我们为发票、收据、合同、身份证件等常见文档类型准备了 现成模板。点开一份，按团队的术语改名或删字段，保存。
• 用大白话描述。 写一句话，比如 “每张发票抽出发票号、供应商、合计，以及 含描述、数量、单价的明细行。” 引擎会根据描述起草一份 schema；你确认或微调 就行。
• 丢一份样本文档进来。 如果你不看到一份实际文档就不知道里面有哪些字段， 传一份样本上去。引擎读完后，会给出一份带正确字段名、类型和嵌套结构的 schema 建议。你在这个基础上调整。

设计你的 schema 这篇文章讲了每种方式各自适合什么场景。

第四步 —— 上传一份文档

保存好 schema 后，进入项目的 文档 标签，把一份或多份文件拖进去。Ztract 支持 PDF、Word（.doc / .docx）、Excel（.xls / .xlsx）、PowerPoint （.ppt / .pptx）、HTML（包括 .mhtml）、TXT、CSV、RTF、OFD，以及 JPG、PNG、 WebP、TIFF、BMP 图片 —— 单文件最大 500 MB。详细的体积上限、批量上传、文件失败 时会发生什么，看 上传文档 这篇文章。

Dashboard 会在每份文件到达时立即处理，并实时显示进度。一页的文档通常几秒就完成； 50 页的合同会久一些。

第五步 —— 审核并改正

文档处理完之后，在 并排查看器 里打开。原文档在左边，所有抽出的字段在右边。 点任意字段，源文档上对应区域立刻亮起来。反过来，点源文档上任意区域，对应字段 会滚动到右侧视野里。

引擎不太确定的字段会带一个置信度提示。要改一个错值，点它、输入正确值、保存。 改动即时生效 —— 你不用为重跑付费，下次导出也会自动用改正后的值。完整说明看 审核与改正。

第六步 —— 导出

数据核对完之后，打开项目的 解析数据 标签，点 导出。选 Excel、CSV 或 JSON，按需要按解析日期范围筛一下，确认。导出在后台跑；准备好后，到 导出记录 标签下载。JSON 会保留完整的嵌套结构（当事人、明细行等等）； CSV 和 Excel 会把明细行铺平成单独的行或 sheet。用你顺手的工具打开 —— Sheets、Excel、你的会计软件、你的数仓 —— 就完事了。

第一天值得知道的几个小细节

• Dashboard 支持你的母语。 默认是英文，但你可以从右上角的头像菜单切到 中文、日本語、한국어、Français、Deutsch、Español 或 Português。Schema 模板也会跟着本地化。
• 剩余页数在导航栏里看得到。 右上角琥珀色的”充值”标记会实时显示你的页数 余额，快用完时颜色会变得更醒目。点它就能跳到套餐选择页。
• 重新抽取会重新扣页数。 在查看器里改一个字段是免费的，但在同一份文档上 重跑引擎（因为你改了 schema、修了源文件、或者只是想再跑一遍）会按正常的 每页费率扣页数。详见 审核与改正。

接下来呢

30 页免费额度用完之后，你可以买一个页数套餐 —— 一次性购买，12 个月内有效， 没有订阅。具体怎么算看 计费、套餐与退款。有问题就发邮件到 support@ztract.com —— 一个收件箱、一支团队， 工作日内回复。