前言¶
DeepSeek Harness (DSH) 的核心理念是“一切皆插件”。对于使用 loci 作为本地知识库的用户，管理知识通常需要在 CLI 工具和 Web 界面之间切换。loci-dsh 插供了一个纯 UI 层的解决方案，将 loci 的记忆功能集成到 DSH 的 Web UI 侧边栏中。通过这个插件，你可以在不离开对话界面的情况下，搜索、提问、记录和可视化你的本地知识库。
介绍¶
loci-dsh 是 IvenKooLab 维护的一个 Memory 类插件。它不涉及 Python 嵌入或核心分叉，仅作为 DSH Web 服务器的一层 UI 挂载。插件将侧边栏标签页与本地运行的 loci HTTP 服务器连接，实现了本地知识库的混合检索、LLM 回答引用以及知识图谱浏览。
核心功能¶
插件提供以下核心视图与能力：
- Search（搜索）：支持混合检索，可调整结果数量，支持仅检索记忆（
tag=memory）及路径过滤。 - Ask（提问）：基于本地知识库回答问题，并在答案中生成引用芯片（citation chips）。
- Memories（记忆）：展示按时间倒序排列的全景时间线，支持直接快速记录记忆。
- Graph（图谱）：浏览 loci 的知识图谱（需 loci ≥ 0.6.0），支持点击实体过滤关系。
- Status（状态）：显示连接状态、存储摘要及各来源的块计数。
安装与启用¶
在安装前，请确保环境满足以下依赖：
- Node.js ≥ 24（DSH 的启动器使用了
import.meta.main，Node 20/22 会在静默状态下退出）。 - DeepSeek Harness (dsh)：通过
npm i -g @deepseek-ai/dsh安装。 - dsh-better-sidebar：用于提供侧边栏基础支持，执行安装命令以挂载侧边栏。
- loci ≥ v0.6.2：确保其 HTTP 服务器正在运行，并在配置文件中设置固定 Token。
1. 安装插件¶
执行以下命令将插件添加到 Web 配置文件中：
dsh plugin --profile web add github:IvenKooLab/loci-dsh
2. 配置 loci¶
在 loci 的 config.toml 中配置 HTTP 服务器的 Token：
[http]
token = "<a random string>"
启动 loci 的 HTTP 服务端（默认端口 8765）：
loci serve-http
3. 配置 DSH 插件¶
编辑 ~/.dsh/profiles/web/cordis.patch.yml。由于 DSH 的补丁机制是“全量替换”而非“深度合并”，你需要编写一个针对 loci-dsh 的覆盖行。注意不要使用 insert，因为插件安装时已挂载。
- id: loci-dsh
config:
baseUrl: 'http://127.0.0.1:8765'
token: '<与 loci config.toml 中 [http] token 相同的值>'
配置说明¶
插件支持通过环境变量或配置文件进行微调。主要配置项如下：
- baseUrl: loci serve-http 的地址，默认为
http://127.0.0.1:8765。 - token: Bearer 认证令牌，必须与 loci 配置一致。
- timeoutMs: 默认 20000ms，控制健康检查、搜索和记录等短请求的超时时间。
- askTimeoutMs: 默认 180000ms，控制
/ask接口超时，该接口涉及完整的 LLM 交互。 - graphPath: 绝对路径，用于启用 Graph 视图（默认读取
<store>/graph.json）。 - memoriesPath: 绝对路径，用于启用 Memories 视图的时间线功能（默认读取
memories/目录）。
注意事项¶
- 纯 UI 层：插件不包含 Python 运行时，也不修改 DSH 或 loci 的核心逻辑。
- 配置替换：在
cordis.patch.yml中配置时，必须列出所有希望覆盖的键值对。插件不会自动合并旧配置。 - 版本依赖：严格依赖 Node.js ≥ 24 和 loci ≥ v0.6.2。旧版本可能存在兼容性问题。
总结¶
loci-dsh 通过轻量级的 UI 挂载，解决了本地知识库在 DeepSeek Harness 中的接入问题。它提供了从搜索、问答到图谱可视化的完整链路，适合需要在浏览器中直接操作本地 RAG 知识库的开发者和用户。
插件目录：https://www.skillhub.cn/plugins/IvenKooLab/loci-dsh
源码地址：https://github.com/IvenKooLab/loci-dsh
