前言¶
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
