xparse-cli 2.4.6 → 2.5.0-beta.2

package/README.md

@@ -319,17 +319,6 @@ 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
@@ -364,7 +353,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 基础信息 |
@@ -532,6 +522,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
@@ -601,5 +593,74 @@ xparse-cli task retry <task-id> --resource-id <resource-id> --pending-result-id
 This settles the saved result without another model call. Replaying the same candidate is safe.
 The Task stays suspended; use `task result` or `task export` for delivered files. Explicit
 `task resume <task-id>` continues remaining Agent work and adds execution budget. Preserve its
-`command_id` and `checkpoint_version` for exact replay. Without a saved candidate, `task retry`
+`command_id` and `checkpoint_version` for exact replay. Without a saved candidate, `task retry --resource-id RESOURCE_ID`
 re-extracts the one resource; do not blindly replay an ambiguous response.
+
+## Extraction workspace commands
+
+The workspace commands below require a matching CLI build and backend. They do
+not create a replacement Task. Request JSON is read from `--input FILE` or stdin
+with `--input -`; values and version tokens are transmitted without reinterpretation.
+
+```bash
+xparse-cli task retry TASK_ID
+xparse-cli task retry TASK_ID --scope selected --resource-id RESOURCE_ID --field-id FIELD_ID
+xparse-cli task retry TASK_ID --only-outdated
+xparse-cli task spec get TASK_ID
+xparse-cli task spec set TASK_ID --input fields.json
+xparse-cli task spec clarify TASK_ID --input clarification.json
+xparse-cli task field set TASK_ID RESOURCE_ID FIELD_ID --input correction.json
+xparse-cli task field confirm TASK_ID RESOURCE_ID FIELD_ID --input confirmation.json
+xparse-cli task history TASK_ID RESOURCE_ID
+xparse-cli task preview TASK_ID RESOURCE_ID
+xparse-cli task copilot show TASK_ID
+xparse-cli task copilot steps TASK_ID --after 0
+xparse-cli task copilot send TASK_ID --text 'Recheck the contract amount'
+xparse-cli task copilot send TASK_ID --input reply.json
+xparse-cli task memory list TASK_ID
+xparse-cli task memory revoke TASK_ID MEMORY_ID
+xparse-cli task list --search contract --limit 20
+xparse-cli task page TASK_ID
+xparse-cli task add TASK_ID new.pdf
+xparse-cli task add TASK_ID --history-id 123
+xparse-cli task add TASK_ID --uploaded-file-id FILE_ID
+xparse-cli task add TASK_ID --reconcile
+```
+
+`retry TASK_ID` re-extracts every file using the current definition. File and field
+selectors intersect; with a field definition, only active fields are used. A Task
+without a field definition reruns its original instruction and cannot use field
+selectors or `--only-outdated`. Old results remain until replaced by new results.
+Legacy `retry TASK_ID --resource-id RESOURCE_ID` still recovers one failed file or
+settles its saved result; use `--scope selected` to force re-extraction of that file.
+`resume` continues suspended work and remains separate from re-extraction.
+
+`fields.json` is the complete active field list, not a partial patch. Omitting an
+existing field deletes it; use `restore_field_ids` to restore deleted fields:
+
+```json
+{"expected_version":7,"task_rules":"Extract contract data","fields":[{"field_id":"amount","name":"Amount","description":"Total including tax"}],"restore_field_ids":[],"apply_to_existing":false}
+```
+
+For clarification, send `expected_version`, `name`, and `description`.
+For field correction/confirmation, preserve the reviewed result and spec versions:
+
+```json
+{"base_result_version":3,"expected_spec_version":7,"request_id":"review-unique-id","value":{"value":"100.00"},"review":{"apply_to_future":false}}
+```
+
+Copilot supports all page interaction kinds, including edited definitions,
+confirm-only, confirm-and-rerun, answers and dismissals. Preserve the original
+identities and reviewed draft values. Example (replace all identifiers/versions):
+
+```json
+{"client_message_id":"reply-unique-id","kind":"confirm_and_rerun","text":"","expected_version":7,"draft_id":"draft-id","draft_revision":2}
+```
+
+A conflict is not retried with a silently refreshed version. After an ambiguous
+mutation response, query the same Task before any repeat. Managed local additions
+return upload identities for recovery and use the page's managed import pipeline.
+`task page` requires the backend's `page-session?result_page_url=true` support and
+returns the exact server-issued URL; never build grants in the client.
+
+Regional availability follows the page: task list, spec set/clarify, whole-task or scoped retry, preview and version history are domestic-only. Other operations retain their existing regional rules. These additions require a matching CLI/Connector build; check the installed CLI's command help before using them.

package/package.json

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