xparse-cli 2.4.0 → 2.4.1-beta.1

package/README.md

@@ -51,6 +51,24 @@ beta、精确版本以及国内镜像同样通过 `npm install --global` 管理
 WorkBuddy 集成、国内/海外 Connector 区别、beta 命名规则及完整发版步骤见
 [WorkBuddy Connector 概念与发版流程](docs/workbuddy_connector_release.md)。
 
+## Remote MCP 服务
+
+同一 Go module 还提供 `cmd/xparse-mcp`。它与 CLI 复用 `internal/client` 和
+`internal/parseflow`，因此解析参数、额度路由、顺序执行、一次重试和多段结果合并使用
+同一份实现。MCP 只接受服务端可访问的 `file_url` 或已上传的 `file_id`；本地文件由
+MCP Host 先调用 `prepare_file_upload`，按返回的通用上传会话直接上传到 TextIn。
+
+MCP 是独立容器产物，不进入 npm CLI 包：
+
+```bash
+make mcp-build
+make mcp-image MCP_IMAGE=registry.example/xparse-mcp:tag
+```
+
+服务通过 OAuth 验证 audience 绑定的 MCP Token，再使用通用 OAuth Token Exchange
+取得短时委托 Token 调用公开 xParse API；不会调用 workflow-backend 内部 MCP 路由，
+也不识别平台或维护 T币确认状态。
+
 ## 开发与发布 Make 命令
 
 仓库根目录的 `Makefile` 统一管理 WorkBuddy Connector 组包和 npm 发布。
@@ -173,10 +191,16 @@ Task Runtime 把上传、执行状态和结果交给服务端持久化。`task r
 xparse-cli task run --files 'contracts/*.pdf'
 xparse-cli task status <task-id> --run-id <run-id>
 xparse-cli task export <task-id> --run-id <run-id> --output ./task-output
+xparse-cli task export <task-id> --run-id <run-id> --view json --output ./task-json
 xparse-cli task read <task-id> contract-a.pdf --run-id <run-id>
 xparse-cli task debug <task-id> --run-id <run-id>
 ```
 
+`task export` 默认导出 Markdown；需要消费完整 xParse 结构化结果时显式使用
+`--view json`。两种视图都会生成 `task-manifest.json`，其中包含
+`total_count`、`completed_count`、`failed_count`、`exported_count` 以及每个文件的
+状态、输出文件名和失败恢复信息，调用方不得把部分成功静默当作全量完成。
+
 需要在同一个 Task 下创建新 Run 时，显式选择重跑范围：
 
 ```bash
@@ -312,7 +336,7 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
 | `xparse-cli task run` | 上传并执行多文件持久化 Task |
 | `xparse-cli task rerun` | 在现有 Task 下按 all/new-files/selected-files 创建新 Run |
 | `xparse-cli task status` | 查询 Task 和最新 Run 状态 |
-| `xparse-cli task export` | 批量导出成功结果和 manifest |
+| `xparse-cli task export` | 按 Markdown/JSON 视图批量导出成功结果和带汇总计数的 manifest |
 | `xparse-cli task read` | 读取单个文件结果 |
 | `xparse-cli task debug` | 查看逐文件错误与恢复证据 |
 | `xparse-cli task continue` | 补充逐文件密码并选择性续跑 |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xparse-cli",
-  "version": "2.4.0",
+  "version": "2.4.1-beta.1",
   "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.0",
-    "xparse-cli-darwin-arm64": "2.4.0",
-    "xparse-cli-linux-amd64": "2.4.0",
-    "xparse-cli-linux-arm64": "2.4.0",
-    "xparse-cli-windows-amd64": "2.4.0",
-    "xparse-cli-windows-arm64": "2.4.0"
+    "xparse-cli-darwin-amd64": "2.4.1-beta.1",
+    "xparse-cli-darwin-arm64": "2.4.1-beta.1",
+    "xparse-cli-linux-amd64": "2.4.1-beta.1",
+    "xparse-cli-linux-arm64": "2.4.1-beta.1",
+    "xparse-cli-windows-amd64": "2.4.1-beta.1",
+    "xparse-cli-windows-arm64": "2.4.1-beta.1"
   },
   "publishConfig": {
     "access": "public",
-    "tag": "latest"
+    "tag": "beta"
   }
 }