前言¶
DeepSeek Harness（DSH）采用插件化架构。在开发或使用智能体时，每次对话和项目产出的文档、表格、图片等往往散落在各处，难以检索和统一管理。dsh-library 是一个本地资料库插件，旨在将所有产出收拢到一处，供人浏览、检索，并让助手通过路径引用。
核心能力¶
- 三栏布局：左侧为目录树，中间为文件列表（支持网格与列表切换），右侧为内容预览。整体视觉与 DSH 原生页面保持一致。
- 整库检索：支持按文件名、路径、标签、备注进行全文搜索。同时提供类型、目录、标签三组筛选 Chip，计数随口径实时变化。
- 文档直接预览：支持 Markdown、Excel (.xlsx/.csv/.tsv)、Word (.docx)、JSON 与代码文件在页内直接查看，无需下载。
- 标签与备注：每条资料可打标签、写备注，支持批量标注（一次最多 2000 条）。
- 多种入库：支持拖拽进页面、系统文件选择、新建文档/文件夹、从目录导入。
- 助手权限控制：助手可把新产出存进库，但不可修改/移动/删除已有资料，整理权由人掌握。
- 零第三方依赖：运行时只依赖 Node 内置模块与 DSH 自身提供的平台件。xlsx/docx 解析基于 node:zlib 手写最小 zip 读取器。
安装与启用¶
- 安装插件
& 'F:\DSH\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop add 'D:\dsh-library'
-
编辑
package.json
编辑插件目录下的package.json，完成以下两步：- 将依赖规格从
link:改成file:（file:让 pnpm 复制成实体目录，解析链才完整）。 - 把
dsh-library加进dsh.profile.bundles数组 —— 不加这一行，插件不会进组合配置树。
- 将依赖规格从
-
运行安装
& 'F:\DSH\resources\runtime\cli\bin\dsh.cmd' plugin --profile desktop install
- 重启 DSH
重启后侧边栏出现「资料库」入口即成功。
使用示例¶
- 收集产出：把每次对话、每个项目产出的东西收进一处：文档、表格、图片、音视频、链接、附件。
- 配置插件：编辑
package.json，调整 bundle 配置。 - 运行测试：运行
npm test进行五套离线测试。
注意事项¶
- 助手权限限制：助手只能把新产出存进库，不可修改/移动/删除已有资料。
- 运行时依赖：运行时只依赖 Node 内置模块与 DSH 自身提供的平台件。
- 文档解析：xlsx/docx 解析基于 node:zlib 手写最小 zip 读取器。
- 入库策略：入库四端点只新增不覆盖。
插件地址¶
- GitHub：https://github.com/Hnqhj/dsh-library
- 目录：https://www.skillhub.cn/plugins/Hnqhj/dsh-library
