xparse-cli 2.3.0-beta.6 → 2.3.0-beta.8
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 +28 -2
- 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
|
|
@@ -138,7 +161,9 @@ xparse-cli task run a.pdf b.jpg c.pdf \
|
|
|
138
161
|
|
|
139
162
|
若服务端仍返回 `40423`，CLI 会扫描完本批次并一次性返回所有缺失或错误密码文件；使用返回的
|
|
140
163
|
selector 和同一 `operation_id` 补充 `--password selector=password` 后重试。已经知道的密码不依赖
|
|
141
|
-
`40423`
|
|
164
|
+
`40423` 发现。显式复用同一 `operation_id` 时，CLI 会先解析已 ready 的上传资产，仅重新传输尚未
|
|
165
|
+
成功的文件；旧服务端不支持解析接口时自动回退到原上传流程。对于已经创建的 Task，可只更新失败
|
|
166
|
+
Resource 并新建一个 selected-files Run：
|
|
142
167
|
|
|
143
168
|
```bash
|
|
144
169
|
xparse-cli task continue <task-id> \
|
|
@@ -212,6 +237,7 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
|
|
|
212
237
|
|------|------|
|
|
213
238
|
| `xparse-cli parse` | 解析文档，输出 Markdown / JSON |
|
|
214
239
|
| `xparse-cli task run` | 上传并执行多文件持久化 Task |
|
|
240
|
+
| `xparse-cli task rerun` | 在现有 Task 下按 all/new-files/selected-files 创建新 Run |
|
|
215
241
|
| `xparse-cli task status` | 查询 Task 和最新 Run 状态 |
|
|
216
242
|
| `xparse-cli task export` | 批量导出成功结果和 manifest |
|
|
217
243
|
| `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.8",
|
|
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.8",
|
|
23
|
+
"xparse-cli-darwin-arm64": "2.3.0-beta.8",
|
|
24
|
+
"xparse-cli-linux-amd64": "2.3.0-beta.8",
|
|
25
|
+
"xparse-cli-linux-arm64": "2.3.0-beta.8",
|
|
26
|
+
"xparse-cli-windows-amd64": "2.3.0-beta.8",
|
|
27
|
+
"xparse-cli-windows-arm64": "2.3.0-beta.8"
|
|
28
28
|
},
|
|
29
29
|
"publishConfig": {
|
|
30
30
|
"access": "public",
|