前言¶
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 插件通过本地解析和版本化坐标，解决了模型读取文件时的上下文管理和准确性问题。它将文件转化为结构化的、可追溯的证据，适合需要精确引用来源的文档分析任务。
