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

package/README.md

@@ -11,7 +11,7 @@ Textin xParser 文档解析命令行工具，基于 [TextIn xParse API](https://
 需要 Node.js 18 或更高版本。Beta 版本必须显式安装，不会被普通安装或升级自动选中：
 
 ```bash
-npm install -g xparse-cli@2.2.1-beta.1
+npm install -g xparse-cli@2.2.1-beta.3
 ```
 
 安装后可运行 `xparse-cli version` 检查版本。
@@ -308,7 +308,9 @@ OAuth 参数优先级：
 
 不传 `--api` 时使用 `auto`：CLI 先读取现有 quota 接口，在匿名每日免费额度与登录
 用户的免费套餐额度之间制定执行计划。显式 `--api free` 固定调用免费 Agent 接口，
-显式 `--api paid` 固定调用现有付费接口，不参与自动额度路由。
+显式 `--api paid` 固定调用现有付费接口，不参与自动额度路由，但仍会读取 quota 中的
+`standard_max_file_size_mb`，在上传本地文件前执行标准接口大小预检。旧服务端未下发
+该字段时使用 500MB 兼容值；URL 输入仍由服务端检查。
 
 认证选择顺序为：显式 `--auth-method` / 环境或配置选择 > OAuth > 完整 AppKey >
 匿名（仅可选认证接口）。自动选择 OAuth 时若刷新失败，会先回退完整 AppKey；两者都
@@ -320,42 +322,29 @@ OAuth 参数优先级：
 
 ## 退出码与错误处理
 
-| 码 | 含义 | stderr 格式 |
-|----|------|-------------|
-| 0 | 成功 | — |
-| 1 | 一般错误 / 网络异常 | 纯文本 + `> [tag] suggestion` |
-| 2 | 参数错误 | 纯文本 + `> [tag] suggestion` |
-| 3 | API 返回错误 | `api_code：message` + `> [tag] suggestion` |
+`xparse-cli parse` 默认向 stderr 输出一行 JSON；stdout 仍只承载解析结果。退出码保持兼容：
 
-每条错误输出到 stderr，格式：
+| 码 | 含义 |
+|----|------|
+| 0 | 成功 |
+| 1 | 一般错误 / 网络异常 |
+| 2 | 参数错误 |
+| 3 | API 返回错误 |
 
-```
-<错误信息>
-> <建议操作>
-  (request_id: xxx, contact Textin support if unresolved)   ← 部分 API 错误额外输出
-```
-
-第二行以 `>` 开头，包含 `[tag]` 标签指示处理方式：
-
-| 标签 | 含义 |
-|------|------|
-| `[fix]` | 修正参数后重新执行 |
-| `[retry]` | 自动重试（带退避） |
-| `[fallback]` | 尝试替代方案 |
-| `[ask human]` | 需要人工介入 |
+基础字段为 `schema_version`、`error_code`、`message`、`actual_value`、`limit`、
+`retryable` 和 `next_action`；需要时还会包含 `upgrade_url`、`request_id`、`task_id`
+和 `details`。`actual_value` 与 `limit` 不可确认时为 `null`，不会使用过期的本地固定值。
 
-示例：
-
-```
-invalid --view value, must be 'markdown' or 'json'
-> [fix] use --view markdown or --view json
+```json
+{"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..."}
 ```
 
-```
-40306：服务暂时不可用
-> [retry] wait 3s then retry, max 2 retries
-  (request_id: 644e2efdb..., contact Textin support if unresolved)
-```
+稳定错误码至少包括：`FILE_NOT_FOUND`、`EMPTY_FILE`、`UNSUPPORTED_FILE_TYPE`、
+`FILE_TOO_LARGE`、`PAGE_LIMIT_EXCEEDED`、`PAID_QUOTA_REQUIRED`、
+`CAPABILITY_QUERY_FAILED`、`SPLIT_FAILED`、`MERGE_FAILED` 和 `RETRY_EXHAUSTED`。
+
+人工调试或兼容旧脚本时可使用 `--error-format=text`，恢复原有的多行文本与建议格式。
+其他子命令继续使用原有文本错误格式。
 
 > stdout 仅输出文档内容，stderr 仅输出错误信息，exit code 严格为 0/1/2/3。
 > 完整的错误和建议枚举见 [suggestion.txt](suggestion.txt)。
@@ -374,7 +363,7 @@ invalid --view value, must be 'markdown' or 'json'
 
 | 限制项 | 免费 API | 付费 API |
 |--------|----------|----------|
-| 文件大小 | 由 quota 的 `max_file_size_mb` 下发，PDF 可自动分片 | 500MB |
+| 文件大小 | 由 quota 的 `max_file_size_mb` 下发，PDF 可自动分片 | 由 quota 的 `standard_max_file_size_mb` 下发，旧服务端回退 500MB |
 | PDF 页数 | 由 quota 的 `max_pages_per_request` 下发，支持自动分段 | 1000 页 |
 | XLS/XLSX/CSV | — | 每 sheet ≤ 2000 行 × 100 列 |
 | TXT | — | ≤ 100KB |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xparse-cli",
-  "version": "2.2.1-beta.1",
+  "version": "2.2.1-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.2.1-beta.1",
-    "xparse-cli-darwin-arm64": "2.2.1-beta.1",
-    "xparse-cli-linux-amd64": "2.2.1-beta.1",
-    "xparse-cli-linux-arm64": "2.2.1-beta.1",
-    "xparse-cli-windows-amd64": "2.2.1-beta.1",
-    "xparse-cli-windows-arm64": "2.2.1-beta.1"
+    "xparse-cli-darwin-amd64": "2.2.1-beta.3",
+    "xparse-cli-darwin-arm64": "2.2.1-beta.3",
+    "xparse-cli-linux-amd64": "2.2.1-beta.3",
+    "xparse-cli-linux-arm64": "2.2.1-beta.3",
+    "xparse-cli-windows-amd64": "2.2.1-beta.3",
+    "xparse-cli-windows-arm64": "2.2.1-beta.3"
   },
   "publishConfig": {
     "access": "public",