TextIn xParse 插件

前言¶

插件 intsig-textin/dsh-plugin-xparse 是为 DeepSeek Harness 提供的 TextIn xParse 文档解析工具和技能。它用于在 Harness 环境中调用 TextIn 服务对文档数据进行解析。

安装与启用¶

安装命令如下：

dsh plugin --profile web add @intsig-xparse/dsh-xparse

安装前请确保环境满足以下要求：
- DeepSeek Harness 版本需为 0.1.1-rc.2
- Node.js 版本需在 22.19 或更高
- 操作系统支持 Linux 或 macOS (x64/arm64)

核心功能¶

该插件安装后提供 xparse Tool、xparse-parse Skill 以及嵌入的 xparse CLI 二进制文件。支持的操作包括：

• parse：解析文档
• quota：查询配额
• get_doc_info：获取文档信息
• get_outline：获取大纲
• search_text：搜索文本
• read_pages：读取页面
• read_content：读取内容
• task_run / task_rerun：提交或重运行任务
• task_status：查询任务状态
• task_read / task_export / task_debug：读取、导出或调试任务
• task_resume：恢复任务

使用说明¶

解析文档时，数据会发送至 TextIn 服务。结果以工作区工件的形式写入，而不是作为 Tool 返回的长文本。任务提交或重运行操作会立即返回 Task/Run 标识、状态、进度计数器和终端状态。后续检查进度应使用紧凑的 task_status 响应。

执行机制¶

Tool 始终执行该包内嵌入的二进制文件。它不依赖 PATH、全局 xparse-cli、安装脚本或运行时下载。

认证与配置¶

插件通过浏览器卡片在 Settings > Plugins > Plugin configuration > TextIn xParse 中配置凭证。

• AppKey：凭证默认引用环境变量 XPARSE_APP_ID 和 XPARSE_SECRET_CODE。App ID 非敏感，会被镜像到 xparse 配置命名空间；Secret Code 为写操作，永远不会出现在插件设置、Tool 参数或对话中。
• OAuth：支持设备登录。OAuth 访问令牌默认在过期前 5 分钟进入刷新窗口 (oauthRefreshSkewMs: 300000)。

当根 Agent 调用网络操作且无可用凭证时，Tool 会启动设备 OAuth 并打开专门的登录卡片。沙盒是文件访问的权威。

注意事项¶

• 付费授权：任务自动路由和重运行不会因为可能需要付费容量而预先批准。服务会先返回 waiting_paid_authorization 或 waiting_funds，只有针对后续 task_resume 操作才会请求批准。一个批准覆盖该 Task Run。
• 安全：请勿在对话或 Tool 调用中粘贴 App ID、Secret Code、OAuth 令牌或文档密码。
• 凭证要求：每次网络操作都需要 OAuth 或完整的 AppKey。

状态与产物¶

• 会话状态目录位于 <workspace>/.xparse/sessions/
• 解析产物目录位于 <workspace>/.xparse/calls/

生态链接¶

• GitHub: https://github.com/intsig-textin/dsh-plugin-xparse
• 目录: https://www.skillhub.cn/plugins/intsig-textin/dsh-plugin-xparse