前言¶
DeepSeek Harness 提供了插件化擴展能力。在處理文檔類任務時，常見的做法是將全文粘貼到提示詞中（受上下文窗口限制）或通過外部腳本調用。dsh-evidence 插件解決了這個問題：它允許在 Harness Web composer 中上傳文件，解析和索引過程在本地機器完成，模型通過工具檢索緊湊的證據，並在需要時展開版本化的精確座標。
插件簡介¶
dsh-evidence 是 DeepSeek Harness 的一個社區插件，由 Cooberped 維護。
核心價值：將文件作爲可檢索的證據，而不是作爲大段文本塞入上下文。解析和索引在本地進行，光柵圖像通過 Harness 原生視覺路徑處理。
功能特性¶
- 本地解析與索引：文件解析和索引過程在本地機器完成，不會將完整文檔發送到雲端。
- 版本化座標：檢索到的座標包含版本信息（源哈希 + 解析器/塊架構）。如果源文件發生變化，舊座標會失效。
- 緊湊證據檢索：模型調用工具查找證據，而不是複製整個文檔。
- 多格式支持：支持 PDF、DOCX、XLSX、PPTX 以及原生光柵圖像。
- 兩個核心工具：
search_documents：用於查找答案所在的“位置”。read_document：用於讀取特定座標的“內容”。
安裝與啓用¶
在安裝前，請確認環境滿足以下要求：
* DeepSeek Harness 版本 >= 0.1.7
* Node.js 版本 >= 22.13.0
使用 npm 安裝：
dsh plugin --profile web add @baseland/dsh-evidence@beta
安裝後，建議執行以下命令確認配置已生效，並重啓 Harness：
dsh --profile web --dump-config
dsh web
典型用法¶
- 打開 Harness Web composer。
- 添加文件：使用回形針進行多選，使用文件夾按鈕上傳目錄，或直接將文件拖拽到頁面。
- 確認每個文件都有自己的卡片顯示“AI-readable”。
- 提問。模型會自動調用工具進行檢索。
以下是一些有效的提示詞示例：
Index these three files first. Do not summarize them yet.
Across these files, find the definition and formula for the Q3 retention metric.
Give the source file and exact page, slide, line range, or Sheet!Range for every claim.
Compare the meeting decision with the workbook target.
If the documents do not contain enough evidence, say what is missing instead of guessing.
注意事項¶
- 版本標籤：該插件目前處於公共 npm beta 階段。安裝時建議顯式指定
@beta標籤。 - 座標版本：座標包含版本信息。如果源文件被修改，舊的座標將無法正確讀取，模型會收到錯誤提示。
- 零召回規則：當文件中找不到證據時，零召回並不意味着允許模型猜測。模型應報告證據缺失，或建議使用不同的檢索詞。
總結¶
dsh-evidence 插件通過本地解析和版本化座標，解決了模型讀取文件時的上下文管理和準確性問題。它將文件轉化爲結構化的、可追溯的證據，適合需要精確引用來源的文檔分析任務。
