xparse-cli 2.5.0-beta.1 → 2.5.0-beta.3

package/README.md

@@ -168,6 +168,15 @@ xparse-cli parse report.pdf --api paid
 
 解析与抽取统一使用 `task run`：省略 `--task-type` 时仍为解析，原有参数兼容。
 
+独立上传可先取得原始 File Asset ID，不会启动解析或抽取；同一操作重试请保留 `--operation-id`：
+
+```bash
+xparse-cli upload contract.pdf --operation-id <OPERATION_ID>
+xparse-cli task run --task-type extract --instruction '抽取甲乙方' --file-id <UPLOADED_FILE_ID>
+```
+
+创建抽取任务时，服务端复用已有解析结果；尚未解析的文件进入现有付费托管解析。解析费与抽取费分别按现有规则结算。创建响应的 `document_count` 仅计已接入抽取的文件，未解析文件可能尚未计入；CLI 的 `submitted_file_count` 是本次提交的 ID 数。
+
 ```bash
 xparse-cli task run --task-type parse a.pdf
 xparse-cli task run --task-type extract --instruction '抽取编号与金额' --file-id <FILE_ID>
@@ -178,7 +187,7 @@ xparse-cli task result <TASK_ID> --limit 50
 xparse-cli task export <EXTRACTION_TASK_ID> --format json --output ./results
 ```
 
-顶层 `extract` 已移除。创建抽取只接受已解析的 File Asset，解析专用参数不能用于抽取。
+顶层 `extract` 已移除。创建抽取接受刚上传或已解析的 File Asset，解析专用参数不能用于抽取；追加文件的 `task add --file-id` 仍只接受已解析文件。
 追加根据服务端类型分发；解析会追加输入并请求新一轮处理，抽取沿用既有任务要求。
 解析追加若绑定后启动失败，应保留 `operation_id`、`task_id` 并按错误提示恢复。
 
@@ -319,6 +328,17 @@ xparse-cli --profile workbuddy parse report.pdf --api paid --auth-method oauth
 该 Profile 的凭证保存在 `~/.xparse-cli/profiles/workbuddy/`，其登录和登出不会影响
 终端中默认的 `~/.xparse-cli` 凭证；请求会自动携带 `X-From: workbuddy`。
 
+Larkoffice 使用相同的认证和 Task 命令行为，凭证保存在独立的
+`~/.xparse-cli/profiles/larkoffice/`。OAuth 默认使用国内公开客户端
+`cli_textin_xparse_larkoffice`，仍遵循 `--client-id`、环境变量和配置文件的覆盖顺序；
+AppKey 回退与 WorkBuddy 相同。请求自动携带 `X-From: larkoffice`。
+
+```bash
+xparse-cli --profile larkoffice auth device --open-browser=always --output=jsonl
+xparse-cli --profile larkoffice auth status --output=json
+xparse-cli --profile larkoffice parse report.pdf
+```
+
 EasyClaw 使用独立的 OAuth-only Profile：
 
 ```bash
@@ -338,6 +358,7 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
 | 命令 | 说明 |
 |------|------|
 | `xparse-cli parse` | 解析文档，输出 Markdown / JSON |
+| `xparse-cli upload` | 单文件上传，返回原始 File Asset ID，不启动解析 |
 | `xparse-cli task run` | 上传并执行多文件持久化 Task |
 | `xparse-cli task rerun` | 在现有 Task 下按 all/new-files/selected-files 创建新 Run |
 | `xparse-cli task status` | 查询 Task 和最新 Run 状态 |
@@ -353,7 +374,8 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
 | `xparse-cli auth status` | 只读查看登录状态 |
 | `xparse-cli auth logout` | 删除指定认证方式的本地凭证 |
 | `xparse-cli config` | 管理配置（show / set / reset / path） |
-| `xparse-cli quota` | 查看免费 API 额度 |
+| `xparse-cli quota` | 查看解析与抽取免费额度 |
+| `xparse-cli quota --service manipulation_detection --output json` | 查看国内篡改检测免费套餐次数；不会发起检测 |
 | `xparse-cli download` | 下载解析结果中 elements 的图片 |
 | `xparse-cli cache` | 查看或清理本地文档缓存 |
 | `xparse-cli get_doc_info` | 读取本地 PDF 基础信息 |
@@ -521,6 +543,8 @@ OAuth 参数优先级：
 认证选择顺序为：显式 `--auth-method` / 环境或配置选择 > OAuth > 完整 AppKey >
 匿名（仅可选认证接口）。自动选择 OAuth 时若刷新失败，会先回退完整 AppKey；两者都
 不可用时，quota、免费解析与 telemetry 才匿名继续。显式选择 OAuth 失败不会切换身份。
+篡改检测的命名 quota 查询需要认证，返回的 `free_package.free_remain_count`
+与默认 quota 中的解析套餐和抽取每日额度无关；未返回套餐时额度为未知。
 
 本地 PDF 会使用服务端返回的 `max_pages_per_request` 和 `max_file_size_mb` 预检。
 仅页数超限且原文件体积合规时使用页范围分段；文件体积超限时生成真实临时 PDF

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xparse-cli",
-  "version": "2.5.0-beta.1",
+  "version": "2.5.0-beta.3",
   "description": "TextIn xParse command-line client for document parsing",
   "license": "MIT",
   "repository": {
@@ -19,12 +19,12 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "xparse-cli-darwin-amd64": "2.5.0-beta.1",
-    "xparse-cli-darwin-arm64": "2.5.0-beta.1",
-    "xparse-cli-linux-amd64": "2.5.0-beta.1",
-    "xparse-cli-linux-arm64": "2.5.0-beta.1",
-    "xparse-cli-windows-amd64": "2.5.0-beta.1",
-    "xparse-cli-windows-arm64": "2.5.0-beta.1"
+    "xparse-cli-darwin-amd64": "2.5.0-beta.3",
+    "xparse-cli-darwin-arm64": "2.5.0-beta.3",
+    "xparse-cli-linux-amd64": "2.5.0-beta.3",
+    "xparse-cli-linux-arm64": "2.5.0-beta.3",
+    "xparse-cli-windows-amd64": "2.5.0-beta.3",
+    "xparse-cli-windows-arm64": "2.5.0-beta.3"
   },
   "publishConfig": {
     "access": "public",