前言¶

DeepSeek Harness (DSH) 的插件機制允許開發者擴展其核心功能。dsh-workspace-api 旨在解決“如何將 DSH 的工作區內容與智能體任務能力暴露給外部系統”的問題。它不依賴複雜的向量數據庫或索引構建，直接利用 AI 代理的現場檢索能力，爲企業和開發者提供一個輕量級的企業知識問答入口。

這是什麼¶

這是一個企業知識問答 Agent 插件，由 liaoyonghong 維護，採用 MIT 許可證。

它的核心價值是將企業文檔（合同、手冊、制度等）轉化爲可對話的聊天機器人。系統無需預建索引，AI 代理會根據用戶的自然語言提問，實時檢索並閱讀文檔，給出準確的回答並附帶出處引用。同時，它提供了完整的 HTTP API 接口，支持文件目錄管理（列表、樹、搜索、讀取），方便第三方應用集成。

安裝與啓用¶

安裝該插件需通過 DSH CLI 執行以下命令：

dsh plugin --profile web add dsh-workspace-api

安裝完成後，重啓 dsh web 進程即可激活插件。

核心功能¶

插件主要提供兩類能力：
1. 知識問答：支持自然語言提問，並返回帶有文件名和行號的引用。
2. 文件管理：提供 HTTP 接口供外部系統查詢目錄樹、搜索文件或讀取文件內容。

典型用法¶

直接提問¶

在 DSH Web 界面的聊天框中直接提問，例如：

“根據企業文檔，酒店住宿報銷上限是多少？”

通過 API 提問¶

通過 HTTP 接口調用，插件默認運行在 DSH Web 端口（默認 127.0.0.1:3080），路徑前綴爲 /workspace-api。

同步請求示例（等待回答）：

curl -X POST -H "Content-Type: application/json" \
  -d '{"prompt":"根據企業文檔，酒店住宿報銷上限是多少？"}' \
  "http://127.0.0.1:3080/workspace-api/task?wait=1"

返回結果示例：

{
  "ok": true,
  "task": {
    "status": "done",
    "result": "酒店報銷上限：標準間每晚上限 HK$1200（出處：報銷政策.md 第 3 行）",
    "exitCode": 0
  }
}

配置與安全¶

插件提供以下環境變量用於配置和增強安全性：

• WORKSPACE_API_ROOT：指定文檔根目錄，默認爲當前 DSH 工作區。
• TOKEN：訪問令牌。默認僅監聽 127.0.0.1，若需對外開放，務必設置 TOKEN 並在請求頭中攜帶 Authorization: Bearer your-secret-token。

適用場景與注意¶

• 適用場景：內部知識庫問答、合同條款查詢、系統操作說明、入職培訓輔助等。
• 性能特點：基於 AI 代理現場檢索，無需索引。文檔數量在幾十份以內效果最佳，超大語料建議疊加 RAG 向量檢索。
• 文檔格式：支持 txt、md、PDF、Word、Excel。掃描版 PDF 需先轉成文字（OCR）才能被檢索。
• 安全性：所有路徑均經過真實路徑校驗，防止目錄遍歷攻擊；任務代理擁有 DSH 文件能力，僅限可信調用方使用。

結語¶

dsh-workspace-api 爲 DSH 插件生態提供了一個將文檔能力標準化輸出的方案。通過簡單的配置和 API 調用，可以快速搭建企業內部的智能問答助手。

• GitHub 倉庫
• 插件目錄頁