xparse-cli 2.3.1-beta.3 → 2.3.1-beta.4

package/README.md

@@ -103,6 +103,24 @@ make npm-publish VERSION=2.3.1-beta.1 CONFIRM_PUBLISH=1
 manifest、staging 目录和七个待发布包完全一致。stable 版本发布到 `latest`，
 `-beta.*` 版本发布到 `beta`。
 
+## DeepSeek Harness
+
+仓库同时包含 `@intsig-xparse/dsh-xparse` Bundle 的实现。当前 Harness RC
+依赖要求 Node.js 22.19 或更高版本。开发构建和 Docker 验证命令为：
+
+```bash
+python3 scripts/prepare-dsh-xparse.py \
+  --skill-dir /path/to/xparse-skills/skills/xparse-parse
+npm run dsh:typecheck
+npm run dsh:test
+npm run dsh:build
+```
+
+正式装配要求外部 Skill 仓库位于 `release-lock.json` 锁定的 commit 且工作树干净，
+并要求当前 xparse-client 工作树干净。本地开发可以显式使用
+`--allow-snapshot --allow-dirty`。Bundle 的详细安装、凭据、安全边界和已知限制见
+`packages/dsh-xparse/README.md`。
+
 ## 快速开始
 
 ### 1. 零配置解析（自动使用免费额度）
@@ -155,16 +173,10 @@ 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
@@ -300,7 +312,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` | 按 Markdown/JSON 视图批量导出成功结果和带汇总计数的 manifest |
+| `xparse-cli task export` | 批量导出成功结果和 manifest |
 | `xparse-cli task read` | 读取单个文件结果 |
 | `xparse-cli task debug` | 查看逐文件错误与恢复证据 |
 | `xparse-cli task continue` | 补充逐文件密码并选择性续跑 |
@@ -326,6 +338,11 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
 
 全局参数 `--profile workbuddy` 或 `--profile easyclaw` 可放在子命令前后，用于选择隔离凭证。
 
+文档解析缓存和 `doc_id` 元数据默认保存在 `~/.xparse-cli/cache` 与
+`~/.xparse-cli/docinfo`。Harness 或其他受沙箱管理的宿主可以为每个 session 设置绝对路径
+`XPARSE_STATE_DIR`，此时两类状态分别写入该目录下的 `cache/` 与 `docinfo/`。
+该变量只改变文档状态目录，不改变 AppKey、OAuth 或 CLI 配置位置；相对路径会被拒绝。
+
 ## parse 命令参数
 
 | 参数 | 默认值 | 说明 |
@@ -343,6 +360,7 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
 | `--include-title-tree` | `true` | 文档标题层级目录树 |
 | `--include-char-details` | `false` | 返回字符级坐标和置信度 |
 | `--table-view` | `html` | 表格视图：`html`、`markdown` |
+| `--export` | | 额外导出格式：`docx`、`pdf`、`xlsx`，支持逗号分隔或重复传递；需配合 `--api paid --output <目录>` |
 | `--list` | | 从文件读取输入列表（需配合 `--output`） |
 | `--output` | _(stdout)_ | 输出文件路径或目录（目录不存在时自动创建） |
 | `--error-format` | `json` | 错误输出格式：`json`、`text` |
@@ -375,6 +393,17 @@ CLI 默认开启以下能力，Agent 无需额外配置：
 
 ## 使用示例
 
+### 导出其他格式
+
+```bash
+# 自动下载 DOCX、PDF 和 XLSX 到输出目录
+xparse-cli parse report.pdf --api paid --export docx,pdf,xlsx --output ./results/
+```
+
+`xlsx` 会自动使用 `config.scope=table`。CLI 使用付费解析的 AppKey 或 OAuth 身份
+下载导出文件，输出为 `<basename>.docx`、`<basename>.pdf` 和 `<basename>.xlsx`。
+若目标文件会覆盖输入原文，则改用 `<basename>.export.<format>`。
+
 ### 管道组合
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xparse-cli",
-  "version": "2.3.1-beta.3",
+  "version": "2.3.1-beta.4",
   "description": "TextIn xParse command-line client for document parsing",
   "license": "MIT",
   "repository": {
@@ -19,12 +19,12 @@
     "node": ">=18"
   },
   "optionalDependencies": {
-    "xparse-cli-darwin-amd64": "2.3.1-beta.3",
-    "xparse-cli-darwin-arm64": "2.3.1-beta.3",
-    "xparse-cli-linux-amd64": "2.3.1-beta.3",
-    "xparse-cli-linux-arm64": "2.3.1-beta.3",
-    "xparse-cli-windows-amd64": "2.3.1-beta.3",
-    "xparse-cli-windows-arm64": "2.3.1-beta.3"
+    "xparse-cli-darwin-amd64": "2.3.1-beta.4",
+    "xparse-cli-darwin-arm64": "2.3.1-beta.4",
+    "xparse-cli-linux-amd64": "2.3.1-beta.4",
+    "xparse-cli-linux-arm64": "2.3.1-beta.4",
+    "xparse-cli-windows-amd64": "2.3.1-beta.4",
+    "xparse-cli-windows-arm64": "2.3.1-beta.4"
   },
   "publishConfig": {
     "access": "public",