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