前言¶
在 DeepSeek Harness（DSH）里做项目时，文档、表格、图片往往散落在仓库各处；把整份文件贴进对话既占上下文，又难按工作区区分。通用 RAG 或外部知识库可以检索片段，但不一定保留「原件」在本机、也不一定能和 DSH 的工作区一一对应。dsh-library 是社区插件 wuzeno/dsh-library，面向「每个项目一份资料库、本地存原文件、聊天时再决定是否交给模型看」这一用法。下面介绍它的定位、能力与安装使用方式。
这是什么¶
dsh-library（GitHub：wuzeno/dsh-library）是 DeepSeek Harness 的资料库插件：在你指定的本机目录按工作区管理项目文件的原件副本，在对话里开启资料库模式后，AI 可在授权范围内查找并按需打开相关原文件。资料默认 local-first，导入时复制到库内，来源文件夹里的原件不被修改。
维护者为 wuzeno；在 SkillHub 社区目录中归类为记忆。当前正式版 1.0.0，代码采用 MIT 许可；与 DeepSeek / 幻方无官方从属关系，DSH 生态以「一切皆插件」为主，社区目录为独立站点。
核心功能¶
工作区与资料库¶
新工作区会自动建立独立资料库；已有工作区也可创建或关联资料库。在 DSH 侧栏「资料库」统一管理页中，可按库名、工作区或存储路径查找，按更新时间、名称或文件数排序。
存储位置与导入¶
首次使用需在本机选择一个绝对路径作为资料存储根目录。支持点击选择或拖入多个文件、整个文件夹；导入前在弹窗核对清单，确认后复制入库，同名文件分别保存。支持任意格式原文件存储，文件夹可递归导入。
对话中的参考方式¶
在对话中切换到资料库模式后，模型可查找已授权文件并按需打开原件（具体读取能力取决于宿主、当前模型与可用工具）。默认使用当前工作区关联的资料库；也可为单次会话额外授权其他库。日常闲聊可切回通用模式。每个文件可单独纳入或排除 AI 参考。
回收区与删除¶
支持文件移入回收区、恢复、下载原件；库详情可「全部移入回收区」（需输入完整库名确认）。回收区支持永久删除单个文件或清空；删除资料库前需先停用，再输入库名确认，仅删除库内副本，来源目录原件保留。
格式与边界（文档声明）¶
单文件默认上限 50 MiB，可在设置中调整为 1–200 MiB；每库最多 2000 个文件（含回收区）。支持保存的格式与模型实际能读取的格式可能不一致，见项目文档说明。
安装与启用¶
适配 DeepSeek Harness 接口 >=0.2.1-rc.3 <0.3.0（README 写明适配 0.2.1-rc.3），需要 Node.js ≥22.13.0。安装步骤以 README 为准，勿凭插件名自行拼接命令行安装串。
- 从 Releases 下载
dsh-library-1.0.0.tgz。 - 打开 DSH「插件」管理器，通过本地安装包入口安装并启用；若宿主提供链接本地目录，则先解压安装包，再选择内含
package.json的package目录。 - 完整退出 DSH（含托盘后台进程），重新启动并刷新页面；侧栏出现「资料库」即表示可用。
升级前建议备份资料存储目录与 DSH profile，再安装新版本并完整重启。
典型用法¶
经过上面的安装步骤后，可按 README「首次使用」顺序操作：
- 打开「资料库 → 存储与隐私」，选择或填写本机绝对路径作为存储目录，保存。
- 在同一页确认是否允许模型按需使用整份原文件。
- 在新工作区自动建库，或为已有工作区创建/关联资料库，拖入文件或文件夹并确认导入。
- 在对话中开启资料库模式，确认参考范围后提问。
示例问法（来自 README）：
- 「项目里有哪些参考文档？」
- 「请根据库里的需求文档，整理这次要做的功能。」
适用场景与注意¶
适合：希望按 DSH 工作区整理项目文档与附件、在本机保留原件副本、仅在部分对话中让 AI 按需打开已授权文件的场景。
隐私与权限：资料先存本机；开启授权后，使用云端模型时打开文件可能将整份原件送入模型并留在会话附件与历史中。关闭授权可停止后续交付，已发送内容仍保留在原会话。敏感资料请谨慎授权，存储目录宜放在 Git 仓库外。插件以当前 DSH 进程权限运行，安装前应查看 SECURITY.md 与源码、许可证。
备份：需同时保留资料存储目录与 DSH profile，才能恢复原件及库关联、授权等设置。
链接¶
- 社区目录：wuzeno/dsh-library
- 仓库与文档：github.com/wuzeno/dsh-library
- 问题反馈：Issues
dsh-library 把「项目资料」从散落的文件夹收拢到按工作区划分的本地库，并在对话层用模式与授权控制模型是否、以及如何接触原件——若你的 DSH 版本在 0.2.1-rc.3 至 0.3.0 兼容范围内，可按 Release 包本地安装试用。
