Labradoc CLI

Labradoc 是一个AI文档智能平台，可将电子邮件、文档和照片统一整合到一个可搜索的系统中。它支持对您自己的数据进行自然语言搜索和上下文问答，集成了Gmail和Google Drive，支持邮件转发和手动上传，并强调在德国进行符合GDPR标准的托管，具有强大的隐私控制功能。

使用此技能通过API令牌认证来操作labradoc-cli命令行工具。它涵盖了配置和所有可用命令。

安装

从GitHub Releases页面获取最新的预构建二进制文件，然后将其放置在您的PATH环境变量中：

https://github.com/zamedic/labradoc-cli/releases

配置

CLI将API令牌作为X-API-Key请求头发送。

首选认证方式： 来自您的Labradoc个人资料的API令牌，地址为 https://labradoc.eu/profile

使用以下方式之一设置令牌（优先级从高到低）：

text
--api-token 标志
API_TOKEN 环境变量
labrador.yaml (api_token)

可选的base URL覆盖：

text
--api-url 标志
API_URL 环境变量
labrador.yaml (api_url)

配置文件优先级：

text
labrador.yaml
labrador..yaml
环境变量（点号变为下划线）

全局标志

text
--api-url API基础URL（默认 https://labradoc.eu）
--api-token API令牌（X-API-Key）
--timeout HTTP超时时间（默认30秒）

认证（OAuth）

API令牌认证是首选方式，但也支持OAuth：

bash

通过浏览器登录

检查认证状态

获取当前令牌

刷新令牌

退出登录

使用OAuth时，请向API命令传递--use-auth-token，而不是--api-token。

原始请求

bash
labradoc-cli api request /api/tasks --method GET
labradoc-cli api request /api/tasks --method POST --body {name:Example}
labradoc-cli api request /api/tasks --method POST --body-file ./payload.json

任务

bash
labradoc-cli api tasks list
labradoc-cli api tasks close --id
labradoc-cli api tasks close --ids --ids

文件

bash
labradoc-cli api files list --status New --status completed --page-size 50
labradoc-cli api files upload --file ./document.pdf
labradoc-cli api files get --id
labradoc-cli api files content --id --out content.txt
labradoc-cli api files ocr --id --out ocr.txt
labradoc-cli api files download --id --out original.pdf
labradoc-cli api files fields --id
labradoc-cli api files related --id
labradoc-cli api files reprocess --id
labradoc-cli api files tasks --id
labradoc-cli api files image --id --page 1 --out page-1.png
labradoc-cli api files preview --id --page 1 --out page-1-preview.png
labradoc-cli api files archive --id
labradoc-cli api files archive --ids --ids
labradoc-cli api files question --id --body {question:What is the due date?}
labradoc-cli api files search --body {question:Find all invoices from Acme}

有效的--status值：New、multipart、googleDocument、CheckDuplicate、detectFileType、htmlToPdf、preview、ocr、processimage、embedding、namepredictor、documenttype、extraction、task、completed、ignored、notsupported、onhold、duplicated。

注意：files search返回服务器推送事件（SSE）流。

API密钥

bash
labradoc-cli api apikeys list
labradoc-cli api apikeys create --name CI token --expires-at 2026-06-01T00:00:00Z
labradoc-cli api apikeys revoke --id

用户

bash
labradoc-cli api user credits
labradoc-cli api user stats
labradoc-cli api user language get
labradoc-cli api user language set --language en

电子邮件

bash
labradoc-cli api email addresses
labradoc-cli api email request --description Inbound invoices
labradoc-cli api email list
labradoc-cli api email body --id --index 1 --out body.eml

集成

有关Google Drive、Gmail和Microsoft Outlook的命令，请参阅 references/integrations.md。

计费（Stripe）

bash
labradoc-cli api stripe checkout
labradoc-cli api stripe pages-checkout
labradoc-cli api stripe webhook --body-file ./stripe-event.json

包装脚本

在 scripts/run-labradoc.sh 提供了一个便捷的包装脚本。它会检查 labradoc-cli 二进制文件是否在PATH中，并转发所有参数：

bash
./scripts/run-labradoc.sh api tasks list

故障排除

text
缺少令牌：请提供 --api-token、APITOKEN 或 labrador.yaml 中的 apitoken
401/403：请确认 API 令牌和 --api-url