xparse-cli 2.3.1-beta.1 → 2.3.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 +54 -15
- package/bin/xparse-cli.js +0 -0
- package/package.json +7 -7
package/README.md
CHANGED
|
@@ -37,7 +37,7 @@ npm install --global xparse-cli@beta
|
|
|
37
37
|
为了获得可复现的测试环境，应安装精确版本：
|
|
38
38
|
|
|
39
39
|
```bash
|
|
40
|
-
npm install --global xparse-cli@2.3.
|
|
40
|
+
npm install --global xparse-cli@2.3.0-beta.5
|
|
41
41
|
```
|
|
42
42
|
|
|
43
43
|
### 升级
|
|
@@ -51,6 +51,58 @@ beta、精确版本以及国内镜像同样通过 `npm install --global` 管理
|
|
|
51
51
|
WorkBuddy 集成、国内/海外 Connector 区别、beta 命名规则及完整发版步骤见
|
|
52
52
|
[WorkBuddy Connector 概念与发版流程](docs/workbuddy_connector_release.md)。
|
|
53
53
|
|
|
54
|
+
## 开发与发布 Make 命令
|
|
55
|
+
|
|
56
|
+
仓库根目录的 `Makefile` 统一管理 WorkBuddy Connector 组包和 npm 发布。
|
|
57
|
+
`REGION` 未设置或为空时默认生成国内包。
|
|
58
|
+
|
|
59
|
+
生成国内、海外或双区域的 Connector 正式审核包：
|
|
60
|
+
|
|
61
|
+
```bash
|
|
62
|
+
make connector-review
|
|
63
|
+
make connector-review REGION=global
|
|
64
|
+
make connector-review-all
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
生成指定环境的 Connector 测试安装包。`VERSION` 为需要测试的精确 CLI 版本，
|
|
68
|
+
`ENVIRONMENT` 支持 `test`、`pre` 和 `prod`：
|
|
69
|
+
|
|
70
|
+
```bash
|
|
71
|
+
make connector-test VERSION=2.3.1-beta.1 ENVIRONMENT=test
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
如需使用其他通用 xParse Skill 目录，可显式传入：
|
|
75
|
+
|
|
76
|
+
```bash
|
|
77
|
+
make connector-test \
|
|
78
|
+
VERSION=2.3.1-beta.1 \
|
|
79
|
+
ENVIRONMENT=test \
|
|
80
|
+
SKILL_DIR=/path/to/xparse-skills/skills/xparse-parse
|
|
81
|
+
```
|
|
82
|
+
|
|
83
|
+
同步 npm 持久版本。该命令会更新主包版本、六个平台依赖版本、npm tag 和
|
|
84
|
+
`release-lock.json` 的基础版本：
|
|
85
|
+
|
|
86
|
+
```bash
|
|
87
|
+
make set-version VERSION=2.3.1-beta.1
|
|
88
|
+
```
|
|
89
|
+
|
|
90
|
+
执行七个 npm 包的完整打包与发布 dry-run，不会上传包：
|
|
91
|
+
|
|
92
|
+
```bash
|
|
93
|
+
make npm-publish-dry-run VERSION=2.3.1-beta.1
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
正式发布七个 npm 包必须同时指定精确版本和确认开关：
|
|
97
|
+
|
|
98
|
+
```bash
|
|
99
|
+
make npm-publish VERSION=2.3.1-beta.1 CONFIRM_PUBLISH=1
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
`npm-publish` 和 `npm-publish-dry-run` 都会先同步版本，并校验命令版本、源码
|
|
103
|
+
manifest、staging 目录和七个待发布包完全一致。stable 版本发布到 `latest`，
|
|
104
|
+
`-beta.*` 版本发布到 `beta`。
|
|
105
|
+
|
|
54
106
|
## 快速开始
|
|
55
107
|
|
|
56
108
|
### 1. 零配置解析（自动使用免费额度）
|
|
@@ -94,20 +146,7 @@ export XPARSE_SECRET_CODE=your_secret_code
|
|
|
94
146
|
xparse-cli parse report.pdf --api paid
|
|
95
147
|
```
|
|
96
148
|
|
|
97
|
-
### 3.
|
|
98
|
-
|
|
99
|
-
Remote MCP 不能直接读取本地路径。先上传一个本地文件取得 File Asset `file_id`，
|
|
100
|
-
再将该 ID 交给 Remote MCP 的 `parse_document`。上传命令不会创建或运行 Task。
|
|
101
|
-
|
|
102
|
-
```bash
|
|
103
|
-
xparse-cli file upload report.pdf --auth-method oauth
|
|
104
|
-
xparse-cli file upload secret.pdf --auth-method oauth --password open-password
|
|
105
|
-
```
|
|
106
|
-
|
|
107
|
-
命令只接受一个文件，stdout 返回一份 File Asset JSON。上传和 Remote MCP 必须授权为
|
|
108
|
-
同一个 TextIn 账号。
|
|
109
|
-
|
|
110
|
-
### 4. 多文件 Task Runtime（Agent 推荐）
|
|
149
|
+
### 3. 多文件 Task Runtime（Agent 推荐）
|
|
111
150
|
|
|
112
151
|
Task Runtime 把上传、执行状态和结果交给服务端持久化。`task run` 默认在提交 Run
|
|
113
152
|
成功后立即返回 `operation_id`、`task_id` 和 `run_id`；Agent 后续锁定该 Run 查看进度，完成后再按需读取或导出结果，不需要把全部结果放进上下文。WorkBuddy 下 stderr 输出 `xparse_event.v1` JSONL：服务端接受 Run 后立即输出 `run_accepted`，后续状态变化输出 `run_status`；stdout 始终只输出一份最终提交 JSON。
|
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.3.1-beta.
|
|
3
|
+
"version": "2.3.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.3.1-beta.
|
|
23
|
-
"xparse-cli-darwin-arm64": "2.3.1-beta.
|
|
24
|
-
"xparse-cli-linux-amd64": "2.3.1-beta.
|
|
25
|
-
"xparse-cli-linux-arm64": "2.3.1-beta.
|
|
26
|
-
"xparse-cli-windows-amd64": "2.3.1-beta.
|
|
27
|
-
"xparse-cli-windows-arm64": "2.3.1-beta.
|
|
22
|
+
"xparse-cli-darwin-amd64": "2.3.1-beta.2",
|
|
23
|
+
"xparse-cli-darwin-arm64": "2.3.1-beta.2",
|
|
24
|
+
"xparse-cli-linux-amd64": "2.3.1-beta.2",
|
|
25
|
+
"xparse-cli-linux-arm64": "2.3.1-beta.2",
|
|
26
|
+
"xparse-cli-windows-amd64": "2.3.1-beta.2",
|
|
27
|
+
"xparse-cli-windows-arm64": "2.3.1-beta.2"
|
|
28
28
|
},
|
|
29
29
|
"publishConfig": {
|
|
30
30
|
"access": "public",
|