前言¶
在 DeepSeek Harness（DSH）里做智能体或长对话，常见问题是资料散在下载目录、各项目 docs/、手写的 library.js 和对话里临时存的链接里，模型要读文件得靠你点名路径，自己搜重、入库也没有统一入口。把文件夹当「知识库」用，预览格式不一，论文还得另开检索站。
dsh-ai-library（资料馆）是维护者 Instant-KING 发布的客户端类 DSH 插件：把本地多源资料合并后，用 Harness 原生面板展示（左侧三级分类、中间卡片、右侧预览），并注册一批 library_* 工具，让 AI 能搜、读、入库而不用你每次贴路径。数据默认留在本机；除论文检索、可选的市场同步与存网页快照外，插件自述不主动联网。
这是什么¶
- 名称：dsh-ai-library（npm 包名同名）
- 维护者：Instant-KING
- 分类：客户端（
dsh.client.platform: web） - 当前版本（package.json）：0.3.54，MIT 许可证，要求 Node.js >= 20
- 社区目录：SkillHub 插件页
- 源码：GitHub · Instant-KING/dsh-ai-library
一句话：本地资料库的「面板 + 预览 + 检索 + 给 AI 用的工具层」，而不是远程托管的知识 SaaS。
面板与预览能做什么¶
装好后第一次打开会自动建空库；把文件放进 <下载目录>/ai-library/items/（或由 config.json 的 root / itemsDir 指定的目录），在条目里写相对路径即可被预览。
README 与包描述中写明的能力包括：
- 自带 pdf.js 4.10.38，不依赖外网 CDN
- 11 种预览器（含 PDF、Markdown 现场渲染、代码高亮、3D、表格、字体、压缩包、音频等；Office 经 LibreOffice 转 PDF 后预览）
- 卡片拖拽改分组、多选批量改分组 / 加标签 / 删除；新建、编辑、删除条目（面板写入
user-items.json，不直接改你的library.js） - 可选与 dsh-meme 联动：左栏「表情包图集」列出内置与用户导入图集，可写
~/.dsh/dsh-expression.json启用
多数据源按固定顺序合并，后写覆盖先写；user-items.json 优先级最高，编辑器里的修改始终生效。
论文检索与可选 API Key¶
内置 十个免 key 学术源（arXiv、OpenAlex、Crossref、DOAJ、Europe PMC、INSPIRE、Zenodo、HAL、DataCite、OpenAIRE），实现位于 lib/paper.js，不需要 Python。
可选付费/受限源不配 key 只是查不到对应结果，不会报错；语义检索（RAG）仅支持 Sciverse，未配 paperKeys.sciverse 时面板会提示需要 key。Key 可在面板「论文检索 → 配置 key」填写，或写入插件目录 config.json 的 paperKeys 字段（亦支持环境变量，详见 README 密钥说明）。
给 AI 的工具与系统提示¶
toolsEnabled 默认为 true 时，插件向宿主注册 16 个工具，例如：
| 方向 | 工具名 | 作用（摘要） |
|---|---|---|
| 只读 | library_search / library_get / library_read / library_stats |
搜条目、取详情、抽文本、统计 |
| 写入 | library_add / library_update / library_import / library_autocapture / library_repo_build / library_save_url / library_paper_add |
新建、改字段、批量入馆、增量扫描、从仓库建库、存网页、论文入库 |
| 检索 | library_paper_search / library_web_search |
论文多源检索；网页检索（可走 DeepSeek 官方 Search 或 AnySearch） |
| 维护与长任务 | library_web_cache / library_translate / library_job |
清 Fetch 缓存；PDF 翻译任务与进度 |
同时注入 ai-library 系统提示词片段（order 160），约定本机新建/修改的文件应在回话前入库，并提示先 library_search 查重、不要把密钥写进库。
联网分工：网页检索/抓取可优先用 DeepSeek 官方 /v1/tools/search 与 /v1/tools/fetch（桌面版登录后常可从 ~/.dsh/.credentials.yaml 读到 DEEPSEEK_API_KEY），或由 DSH 的 read_page 等工具抽正文；资料馆侧重落盘与下次复用。
安装与启用¶
三种方式任选一种，装完重启 DSH：
# ① npm（推荐）
dsh plugin --profile desktop add dsh-ai-library
# ② 直接从 GitHub
dsh plugin --profile desktop add github:Instant-KING/dsh-ai-library
本地开发可在 profile 的 cordis.patch.yml 里用绝对路径 insert 指向 lib/index.js（见 README 注释示例）。
典型用法：数据放哪、条目怎么写¶
默认数据根为 <下载目录>/ai-library，可用 config.json 的 root 或环境变量 AILIB_ROOT 修改。手写库文件示例（library.js）：
window.LIBRARY = {
title: '我的资料库',
items: [
{
id: 'k-1',
kind: 'paper',
status: 'available',
title: '一维谐振子',
summary: '升降算符解法',
source: 'arXiv',
tags: ['量子力学'],
files: ['items/papers/harmonic.pdf'],
preview: {
variants: [
{ label: '原文', src: 'papers/harmonic.pdf' },
{ label: '笔记', src: 'notes/harmonic.md' },
],
},
},
],
groups: { 'k-1': '力学' },
}
面板操作：右上「＋ 新建」、卡片上编辑/删除、拖到左栏改分组；删 user-items.json 可回到仅 library.js 的状态。
可选能力（均需你在 config.json 中显式打开或配置路径）：
watchDirs+workspaceDir：自动入库监听与扫描marketEnabled：从默认https://api.dshmk.com/同步插件市场条目（默认关闭）translateUrl：对接 PDFMathTranslate（默认http://127.0.0.1:11008）
主题主色可通过 config.json 的 accent 或 AILIB_ACCENT 设置，否则跟随 DSH 品牌色变量，再否则为默认金色 #e6c16f。
适用场景与注意¶
适合：希望在 DSH 里统一管理本地 PDF/文档/代码片段/插件市场卡片/论文元数据，并让这些内容对对话里的 AI 可见、可检索；需要离线预览 PDF、不想预览依赖 CDN 的环境。
注意：
- 插件以当前 DSH 进程权限读写本机目录；安装前请自行查看源码与 MIT 许可证，确认
itemsDir只读范围与自动入库目录是否符合你的安全策略。 config.json中的paperKeys、webKeys等以明文保存在插件目录时，需限制目录权限；共享机器可考虑环境变量。- SkillHub 等为社区目录，与 DeepSeek / 幻方无官方从属关系；市场同步的是目录元数据，是否安装仍由你在 DSH 里决定。
结尾¶
dsh-ai-library 把「多源本地资料 + 统一预览 + 论文/网页检索 + AI 工具」收进一个 Harness 面板，减少在对话里反复贴路径和重复抓网页。进一步了解实现与更新日志见 GitHub 仓库，在 SkillHub 目录页 可查看社区收录信息。
