前言¶
DeepSeek Harness (DSH) 的理念是「一切皆插件」。在構建基於 DSH 的智能體時，往往需要讓 AI 讀取公司內部的知識庫。如果依賴手動檢索，效率低下且難以保持上下文連貫。dsh-outline-auto 插件解決了這一需求，它將 Outline 知識庫與 DSH 對話直接打通。
這是什麼¶
這是一個 DeepSeek Harness Web 插件，由 huangfuren 維護。它的核心作用是允許用戶在 DSH 對話中通過關鍵詞搜索 Outline 知識庫，並獲取文檔的全文內容（Markdown 格式）。
核心功能¶
該插件提供了 13 個工具，涵蓋搜索、讀取和文檔管理：
- 搜索與上下文搜索：支持按作者名篩選（作者感知搜索），上下文搜索返回文檔片段以便引用。
- 文檔操作：包括讀取、計數、列出集合、列出用戶、解析路徑、列出子項、返回模板。
- 本地保存：支持將文檔保存爲本地 Markdown 文件，支持合併目錄並生成目錄。
- 文檔管理：已批准的寫入工具支持創建、更新和刪除文檔，每次寫入前會有批准提示。
其他特性包括：
- 可點擊結果：文檔鏈接會自動解析爲絕對路徑。
- 可配置讀取緩存：默認 TTL 爲 60 秒，可配置上限。
- 容錯機制：遇到 429 速率限制自動重試最多 3 次（支持退避策略）。
- HTTPS 強制執行：除本地地址外，強制使用 HTTPS，防止 API Token 明文傳輸。
- GUI 配置卡片：每個用戶在 GUI 卡片中填寫憑證，無需修改配置文件。
- 安全性：未配置時插件正常加載，工具返回清晰的錯誤信息；寫入操作需用戶單獨批准。
安裝與啓用¶
1. 安裝
在終端中執行以下命令安裝指定版本：
dsh plugin --profile web add git+https://github.com/huangfuren/dsh-outline.git#v0.8.1
2. 重啓服務
安裝完成後，重啓 dsh web 服務使插件生效。
3. 啓用插件
在 DSH 的設置界面中，進入「插件」->「插件列表」，找到該插件並啓用。
典型用法¶
搜索文檔
直接在對話中給出一個關鍵詞。插件會返回匹配文檔的標題、片段和鏈接。
讀取全文
在返回的結果中詢問其中一個文檔（例如“請讀取第一個文檔”），插件會返回該文檔的完整 Markdown 內容。
寫入文檔
如果已配置寫入權限，已批准的寫入工具可以創建、更新或刪除文檔。每次執行寫入操作前，系統會彈出批准提示。
適用場景與注意¶
系統要求
- 平臺：Windows / macOS / Linux
- Node.js：22.19 或更新版本
- DSH 基線：0.1.5-rc.2
安全與權限
- 讀取無需寫入權限：讀取操作不需要寫入權限；寫入操作需要用戶在每次執行時單獨批准。
- 用戶憑證隔離：每個用戶在 GUI 卡片中填寫自己的 API Token，存儲於本地，不會提交到 Git。
- HTTPS 強制：確保 API Token 在傳輸過程中是加密的。
配置細節
- 緩存：默認讀取緩存 TTL 爲 60 秒，可配置範圍 1000ms - 300000ms。
- 重試：速率限制請求會自動重試最多 3 次。
短結尾¶
該插件爲 DSH 用戶提供了連接 Outline 知識庫的標準接口，具備完善的容錯、緩存和權限控制機制。適合需要在對話中集成企業知識庫的場景。
- 目錄頁：huangfuren/dsh-outline-auto
- GitHub 倉庫：huangfuren/dsh-outline-auto
