xparse-cli 2.2.1-beta.1 → 2.2.1-beta.2
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 +19 -32
- package/bin/xparse-cli.js +0 -0
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -11,7 +11,7 @@ Textin xParser 文档解析命令行工具，基于 [TextIn xParse API](https://
|
|
|
11
11
|
需要 Node.js 18 或更高版本。Beta 版本必须显式安装，不会被普通安装或升级自动选中：
|
|
12
12
|
|
|
13
13
|
```bash
|
|
14
|
-
npm install -g xparse-cli@2.2.1-beta.
|
|
14
|
+
npm install -g xparse-cli@2.2.1-beta.2
|
|
15
15
|
```
|
|
16
16
|
|
|
17
17
|
安装后可运行 `xparse-cli version` 检查版本。
|
|
@@ -320,42 +320,29 @@ OAuth 参数优先级：
|
|
|
320
320
|
|
|
321
321
|
## 退出码与错误处理
|
|
322
322
|
|
|
323
|
-
|
|
324
|
-
|----|------|-------------|
|
|
325
|
-
| 0 | 成功 | — |
|
|
326
|
-
| 1 | 一般错误 / 网络异常 | 纯文本 + `> [tag] suggestion` |
|
|
327
|
-
| 2 | 参数错误 | 纯文本 + `> [tag] suggestion` |
|
|
328
|
-
| 3 | API 返回错误 | `api_code：message` + `> [tag] suggestion` |
|
|
323
|
+
`xparse-cli parse` 默认向 stderr 输出一行 JSON；stdout 仍只承载解析结果。退出码保持兼容：
|
|
329
324
|
|
|
330
|
-
|
|
325
|
+
| 码 | 含义 |
|
|
326
|
+
|----|------|
|
|
327
|
+
| 0 | 成功 |
|
|
328
|
+
| 1 | 一般错误 / 网络异常 |
|
|
329
|
+
| 2 | 参数错误 |
|
|
330
|
+
| 3 | API 返回错误 |
|
|
331
331
|
|
|
332
|
-
|
|
333
|
-
|
|
334
|
-
|
|
335
|
-
(request_id: xxx, contact Textin support if unresolved) ← 部分 API 错误额外输出
|
|
336
|
-
```
|
|
337
|
-
|
|
338
|
-
第二行以 `>` 开头，包含 `[tag]` 标签指示处理方式：
|
|
339
|
-
|
|
340
|
-
| 标签 | 含义 |
|
|
341
|
-
|------|------|
|
|
342
|
-
| `[fix]` | 修正参数后重新执行 |
|
|
343
|
-
| `[retry]` | 自动重试（带退避） |
|
|
344
|
-
| `[fallback]` | 尝试替代方案 |
|
|
345
|
-
| `[ask human]` | 需要人工介入 |
|
|
332
|
+
基础字段为 `schema_version`、`error_code`、`message`、`actual_value`、`limit`、
|
|
333
|
+
`retryable` 和 `next_action`；需要时还会包含 `upgrade_url`、`request_id`、`task_id`
|
|
334
|
+
和 `details`。`actual_value` 与 `limit` 不可确认时为 `null`，不会使用过期的本地固定值。
|
|
346
335
|
|
|
347
|
-
|
|
348
|
-
|
|
349
|
-
```
|
|
350
|
-
invalid --view value, must be 'markdown' or 'json'
|
|
351
|
-
> [fix] use --view markdown or --view json
|
|
336
|
+
```json
|
|
337
|
+
{"schema_version":"xparse_error.v1","error_code":"FILE_TOO_LARGE","message":"file exceeds the current service limit","actual_value":{"file_size_mb":12.5},"limit":{"source":"service","max_file_size_mb":8},"retryable":false,"next_action":"REDUCE_FILE","request_id":"644e2efdb..."}
|
|
352
338
|
```
|
|
353
339
|
|
|
354
|
-
|
|
355
|
-
|
|
356
|
-
|
|
357
|
-
|
|
358
|
-
|
|
340
|
+
稳定错误码至少包括：`FILE_NOT_FOUND`、`EMPTY_FILE`、`UNSUPPORTED_FILE_TYPE`、
|
|
341
|
+
`FILE_TOO_LARGE`、`PAGE_LIMIT_EXCEEDED`、`PAID_QUOTA_REQUIRED`、
|
|
342
|
+
`CAPABILITY_QUERY_FAILED`、`SPLIT_FAILED`、`MERGE_FAILED` 和 `RETRY_EXHAUSTED`。
|
|
343
|
+
|
|
344
|
+
人工调试或兼容旧脚本时可使用 `--error-format=text`，恢复原有的多行文本与建议格式。
|
|
345
|
+
其他子命令继续使用原有文本错误格式。
|
|
359
346
|
|
|
360
347
|
> stdout 仅输出文档内容，stderr 仅输出错误信息，exit code 严格为 0/1/2/3。
|
|
361
348
|
> 完整的错误和建议枚举见 [suggestion.txt](suggestion.txt)。
|
package/bin/xparse-cli.js
CHANGED
|
File without changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "xparse-cli",
|
|
3
|
-
"version": "2.2.1-beta.
|
|
3
|
+
"version": "2.2.1-beta.2",
|
|
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.2.1-beta.
|
|
23
|
-
"xparse-cli-darwin-arm64": "2.2.1-beta.
|
|
24
|
-
"xparse-cli-linux-amd64": "2.2.1-beta.
|
|
25
|
-
"xparse-cli-linux-arm64": "2.2.1-beta.
|
|
26
|
-
"xparse-cli-windows-amd64": "2.2.1-beta.
|
|
27
|
-
"xparse-cli-windows-arm64": "2.2.1-beta.
|
|
22
|
+
"xparse-cli-darwin-amd64": "2.2.1-beta.2",
|
|
23
|
+
"xparse-cli-darwin-arm64": "2.2.1-beta.2",
|
|
24
|
+
"xparse-cli-linux-amd64": "2.2.1-beta.2",
|
|
25
|
+
"xparse-cli-linux-arm64": "2.2.1-beta.2",
|
|
26
|
+
"xparse-cli-windows-amd64": "2.2.1-beta.2",
|
|
27
|
+
"xparse-cli-windows-arm64": "2.2.1-beta.2"
|
|
28
28
|
},
|
|
29
29
|
"publishConfig": {
|
|
30
30
|
"access": "public",
|