xparse-cli 2.5.0-beta.5 → 2.5.1-beta.1

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.
Files changed (2) hide show
  1. package/README.md +21 -3
  2. package/package.json +7 -7
package/README.md CHANGED
@@ -325,8 +325,11 @@ xparse-cli --profile workbuddy auth device --open-browser=always
325
325
  xparse-cli --profile workbuddy parse report.pdf --api paid --auth-method oauth
326
326
  ```
327
327
 
328
- 该 Profile 的凭证保存在 `~/.xparse-cli/profiles/workbuddy/`,其登录和登出不会影响
329
- 终端中默认的 `~/.xparse-cli` 凭证;请求会自动携带 `X-From: workbuddy`。
328
+ 该 Profile 默认将凭证保存在 `~/.workbuddy/xparse/`,文档状态保存在
329
+ `~/.workbuddy/xparse/state/`,无需任务 Shell 继承连接器环境变量。
330
+ `XPARSE_CONFIG_DIR` 与 `XPARSE_STATE_DIR` 分别优先覆盖对应目录,互不改变对方的默认值。
331
+ 旧目录中的凭证和缓存不会自动迁移;仅在旧目录登录的用户需要重新连接 WorkBuddy 连接器。
332
+ 其登录和登出不会影响终端中默认的 `~/.xparse-cli` 凭证;请求会自动携带 `X-From: workbuddy`。
330
333
 
331
334
  Larkoffice 使用相同的认证和 Task 命令行为,凭证保存在独立的
332
335
  `~/.xparse-cli/profiles/larkoffice/`。OAuth 默认使用国内公开客户端
@@ -389,7 +392,7 @@ xparse-cli --profile easyclaw parse report.pdf --api paid --auth-method oauth
389
392
 
390
393
  全局参数 `--profile workbuddy` 或 `--profile easyclaw` 可放在子命令前后,用于选择隔离凭证。
391
394
 
392
- 文档解析缓存和 `doc_id` 元数据默认保存在 `~/.xparse-cli/cache` 与
395
+ 除 WorkBuddy profile 外,文档解析缓存和 `doc_id` 元数据默认保存在 `~/.xparse-cli/cache` 与
393
396
  `~/.xparse-cli/docinfo`。Harness 或其他受沙箱管理的宿主可以为每个 session 设置绝对路径
394
397
  `XPARSE_STATE_DIR`,此时两类状态分别写入该目录下的 `cache/` 与 `docinfo/`。
395
398
  该变量只改变文档状态目录,不改变 AppKey、OAuth 或 CLI 配置位置;相对路径会被拒绝。
@@ -685,3 +688,18 @@ return upload identities for recovery and use the page's managed import pipeline
685
688
  returns the exact server-issued URL; never build grants in the client.
686
689
 
687
690
  Regional availability follows the page: task list, spec set/clarify, whole-task or scoped retry, preview and version history are domestic-only. Other operations retain their existing regional rules. These additions require a matching CLI/Connector build; check the installed CLI's command help before using them.
691
+
692
+ ### OAuth 状态与保存诊断
693
+
694
+ `xparse-cli auth status --output json` 默认仅检查本地凭证,不联网、不刷新,
695
+ `logged_in=true` 不代表服务端验证成功。需要在线验证时运行
696
+ `xparse-cli auth status --verify --output json`;该命令仅检查 OAuth,必要时刷新并保存,
697
+ 不回退 AppKey 或匿名身份。`verification` 区分 `verified`、`failed` 和 `unknown`;
698
+ 后两者退出非零。当前访问成功不保证未来 refresh token 有效。
699
+
700
+ 认证错误保留 `AUTHENTICATION_FAILED`,在 `details` 中区分凭证读取、锁、刷新请求和保存阶段,
701
+ 提供安全的 OAuth 错误、HTTP 状态或文件操作、路径、errno。缓存写入错误保留 `OUTPUT_FAILED`,
702
+ 并说明服务端解析是否已经完成。不要在缓存失败后盲目重复解析,先检查目录权限。
703
+ WorkBuddy profile 默认使用 `~/.workbuddy/xparse/` 凭证目录和
704
+ `~/.workbuddy/xparse/state/` 状态目录;两个目录均可由对应环境变量独立覆盖。
705
+ 后续导航命令需使用同一 profile 和目录。
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "xparse-cli",
3
- "version": "2.5.0-beta.5",
3
+ "version": "2.5.1-beta.1",
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.5.0-beta.5",
23
- "xparse-cli-darwin-arm64": "2.5.0-beta.5",
24
- "xparse-cli-linux-amd64": "2.5.0-beta.5",
25
- "xparse-cli-linux-arm64": "2.5.0-beta.5",
26
- "xparse-cli-windows-amd64": "2.5.0-beta.5",
27
- "xparse-cli-windows-arm64": "2.5.0-beta.5"
22
+ "xparse-cli-darwin-amd64": "2.5.1-beta.1",
23
+ "xparse-cli-darwin-arm64": "2.5.1-beta.1",
24
+ "xparse-cli-linux-amd64": "2.5.1-beta.1",
25
+ "xparse-cli-linux-arm64": "2.5.1-beta.1",
26
+ "xparse-cli-windows-amd64": "2.5.1-beta.1",
27
+ "xparse-cli-windows-arm64": "2.5.1-beta.1"
28
28
  },
29
29
  "publishConfig": {
30
30
  "access": "public",