xparse-cli 2.3.0-beta.6 → 2.3.0-beta.9
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +33 -4
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -97,7 +97,7 @@ xparse-cli parse report.pdf --api paid
|
|
|
97
97
|
### 3. 多文件 Task Runtime（Agent 推荐）
|
|
98
98
|
|
|
99
99
|
Task Runtime 把上传、执行状态和结果交给服务端持久化。`task run` 默认在提交 Run
|
|
100
|
-
成功后立即返回 `operation_id`、`task_id` 和 `run_id`；Agent 后续锁定该 Run 查看进度，完成后再按需读取或导出结果，不需要把全部结果放进上下文。WorkBuddy 下 stderr 输出 `xparse_event.v1` JSONL
|
|
100
|
+
成功后立即返回 `operation_id`、`task_id` 和 `run_id`；Agent 后续锁定该 Run 查看进度，完成后再按需读取或导出结果，不需要把全部结果放进上下文。WorkBuddy 下 stderr 输出 `xparse_event.v1` JSONL：服务端接受 Run 后立即输出 `run_accepted`，后续状态变化输出 `run_status`；stdout 始终只输出一份最终提交 JSON。
|
|
101
101
|
|
|
102
102
|
```bash
|
|
103
103
|
xparse-cli task run --files 'contracts/*.pdf'
|
|
@@ -107,6 +107,24 @@ xparse-cli task read <task-id> contract-a.pdf --run-id <run-id>
|
|
|
107
107
|
xparse-cli task debug <task-id> --run-id <run-id>
|
|
108
108
|
```
|
|
109
109
|
|
|
110
|
+
需要在同一个 Task 下创建新 Run 时，显式选择重跑范围：
|
|
111
|
+
|
|
112
|
+
```bash
|
|
113
|
+
# 重跑 Task 已绑定的全部 Resource
|
|
114
|
+
xparse-cli task rerun <task-id> --mode all
|
|
115
|
+
|
|
116
|
+
# 上传新文件、绑定到现有 Task，并仅处理新 Resource
|
|
117
|
+
xparse-cli task rerun <task-id> --mode new-files --files 'new-docs/*.pdf'
|
|
118
|
+
|
|
119
|
+
# 只重跑指定的已有 Resource；--resource-id 可重复
|
|
120
|
+
xparse-cli task rerun <task-id> --mode selected-files \
|
|
121
|
+
--resource-id <resource-id> --resource-id <resource-id>
|
|
122
|
+
```
|
|
123
|
+
|
|
124
|
+
`new-files` 不创建替代 Task；返回结果沿用原 `task_id` 并生成新的 `run_id`。
|
|
125
|
+
若新文件受密码保护，使用可重复的 `--password`，多文件时按
|
|
126
|
+
`selector=password` 绑定。
|
|
127
|
+
|
|
110
128
|
若提交响应丢失，使用进度事件或错误详情中的同一 `operation_id` 重试：
|
|
111
129
|
|
|
112
130
|
```bash
|
|
@@ -121,6 +139,11 @@ xparse-cli task run --files 'contracts/*.pdf' --operation-id <operation-id>
|
|
|
121
139
|
xparse-cli task run --files 'contracts/*.pdf' --wait --output ./task-output
|
|
122
140
|
```
|
|
123
141
|
|
|
142
|
+
`--wait` 只是在客户端持续轮询同一个 `run_id`，不会把服务端 Task 变成同步任务。达到
|
|
143
|
+
`--timeout` 时 CLI 正常退出并返回当前状态、原 `task_id` / `run_id`、
|
|
144
|
+
`wait_timed_out: true` 和 `next_action: "POLL_STATUS"`；它不会取消或重建 Run。之后使用
|
|
145
|
+
`task status` 继续查询同一个 Run。Agent 流程默认不使用 `--wait`，也不要自动附加较短的固定超时。
|
|
146
|
+
|
|
124
147
|
单个文件的密码与 `parse` 一样直接使用 `--password`，CLI 会在第一次上传时携带密码：
|
|
125
148
|
|
|
126
149
|
```bash
|
|
@@ -136,9 +159,14 @@ xparse-cli task run a.pdf b.jpg c.pdf \
|
|
|
136
159
|
--password c.pdf=open-c
|
|
137
160
|
```
|
|
138
161
|
|
|
139
|
-
|
|
140
|
-
selector 和同一 `operation_id` 补充 `--password selector=password
|
|
141
|
-
`
|
|
162
|
+
如果上传阶段返回 `PASSWORD_INPUT_REQUIRED`，CLI 会扫描完本批次并一次性返回所有缺失或错误
|
|
163
|
+
密码文件。使用返回的 selector 和同一 `operation_id` 补充 `--password selector=password`，然后
|
|
164
|
+
重放原始命令：首次提交重放 `task run`，`task rerun --mode new-files` 增加文件时则重放原 rerun。
|
|
165
|
+
显式复用同一 `operation_id` 时，CLI 会复用已 ready 的上传资产。此时即使错误中已有 `task_id`，
|
|
166
|
+
尚未成功上传的新文件也不是 Task Resource，不能使用 `task continue`。
|
|
167
|
+
|
|
168
|
+
只有 Task Run 已经接受、`task debug` 确认现有 Resource 在执行阶段返回密码错误时，才更新该
|
|
169
|
+
Resource 的访问密码并创建 selected-files Run：
|
|
142
170
|
|
|
143
171
|
```bash
|
|
144
172
|
xparse-cli task continue <task-id> \
|
|
@@ -212,6 +240,7 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
|
|
|
212
240
|
|------|------|
|
|
213
241
|
| `xparse-cli parse` | 解析文档，输出 Markdown / JSON |
|
|
214
242
|
| `xparse-cli task run` | 上传并执行多文件持久化 Task |
|
|
243
|
+
| `xparse-cli task rerun` | 在现有 Task 下按 all/new-files/selected-files 创建新 Run |
|
|
215
244
|
| `xparse-cli task status` | 查询 Task 和最新 Run 状态 |
|
|
216
245
|
| `xparse-cli task export` | 批量导出成功结果和 manifest |
|
|
217
246
|
| `xparse-cli task read` | 读取单个文件结果 |
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "xparse-cli",
|
|
3
|
-
"version": "2.3.0-beta.
|
|
3
|
+
"version": "2.3.0-beta.9",
|
|
4
4
|
"description": "TextIn xParse command-line client for document parsing",
|
|
5
5
|
"license": "MIT",
|
|
6
6
|
"repository": {
|
|
@@ -19,12 +19,12 @@
|
|
|
19
19
|
"node": ">=18"
|
|
20
20
|
},
|
|
21
21
|
"optionalDependencies": {
|
|
22
|
-
"xparse-cli-darwin-amd64": "2.3.0-beta.
|
|
23
|
-
"xparse-cli-darwin-arm64": "2.3.0-beta.
|
|
24
|
-
"xparse-cli-linux-amd64": "2.3.0-beta.
|
|
25
|
-
"xparse-cli-linux-arm64": "2.3.0-beta.
|
|
26
|
-
"xparse-cli-windows-amd64": "2.3.0-beta.
|
|
27
|
-
"xparse-cli-windows-arm64": "2.3.0-beta.
|
|
22
|
+
"xparse-cli-darwin-amd64": "2.3.0-beta.9",
|
|
23
|
+
"xparse-cli-darwin-arm64": "2.3.0-beta.9",
|
|
24
|
+
"xparse-cli-linux-amd64": "2.3.0-beta.9",
|
|
25
|
+
"xparse-cli-linux-arm64": "2.3.0-beta.9",
|
|
26
|
+
"xparse-cli-windows-amd64": "2.3.0-beta.9",
|
|
27
|
+
"xparse-cli-windows-arm64": "2.3.0-beta.9"
|
|
28
28
|
},
|
|
29
29
|
"publishConfig": {
|
|
30
30
|
"access": "public",
|