前言¶
在 DeepSeek Harness（DSH）里做 Agent 开发时，上下文往往来自当前工作区或单次粘贴，网页文章、字幕、零散 Markdown 很难长期沉淀，也更难在对话里稳定引用到具体段落。常见做法是自建笔记或向量库，但与 Harness 侧栏、默认模型和对话流程割裂，采集与整理还要另开工具链。
拾页（npm 包名 dsh-knowledge-library）是社区维护的 DSH 插件，把采集、本地目录分类、全文检索和知识笔记放在同一套本地优先的流程里，并通过原生 Agent 工具供对话引用。下面介绍它的定位、能力、安装方式与典型用法；事实以 GitHub 仓库 README 为准。
这是什么¶
拾页是本地优先的 DeepSeek Harness 资料库插件，维护者为 Alan-dong-dong。它把网页、文字、文件和视频字幕保存到本机，按分类与专题整理，再让 Agent 检索、引用并形成带来源的知识笔记。
插件已声明 dsh 原生加载配置，通过 dsh plugin add 安装后自动加载，无需另行注册账号或申请插件 ID。它是社区插件，与 DeepSeek 官方没有隶属关系；发布到 npm 不代表已收录进官方或第三方插件目录。在 SkillHub 目录 中归类为「记忆」。
兼容基线（README 写明）：DeepSeek Harness 0.2.1-rc.2、Cordis 4.0.5、Node.js 22.23.0；使用 Node 内置 SQLite，最低 Node 22.13.0。DSH 仍处于预览阶段，其他版本需自行验证。原生界面已针对本机 DSH Web 验证；桌面发行版、远程部署尚未验证。
核心功能¶
界面与数据落盘¶
- dsh 原生侧栏「资料库」，跟随宿主深浅主题、字体与按钮样式，支持窄窗口阅读。
- 默认资料目录为当前用户主目录下的
Documents/DSH-Knowledge-Library，不是插件安装目录或聊天工作区。卸载插件、删除聊天都不会删除该资料目录。
采集与导入¶
- 网页正文提取、原始 HTML 保存、来源地址与作者记录。
- 可选的网页正文图片识别（
0.3.0起）：保留原图、图中文字、图示解读及来源，参与搜索与知识整理；默认关闭，开启后可能产生模型费用。 - 文本 / Markdown 收集；UTF-8 文本、HTML、SRT、VTT 文件导入。
- 视频、音频、PDF 等文件原样归档，并明确标记「仅归档」。
- 网页采集任务持久化，失败可重试，重启后恢复中断任务。
普通采集、本地归档与检索不调用模型，也不监听剪贴板。
组织与检索¶
- 分类对应本地目录；标签与专题用于跨分类组织。
- 中文全文与短词搜索、类型筛选、资料去重。
- 稳定资料 ID、段落引用、字幕时间戳、带来源的知识笔记；点击引用可定位原段落。
模型相关能力¶
- 逐篇分析、零散资料智能分组、确认后本地归类与按组生成独立知识草稿；复用 Harness 默认模型。
- 对比相关已有知识笔记，建议追加补充、新建笔记或仅关联来源，审核后保存；旧正文及段落引用保持不变。
0.3.0起，知识整理和识图的输出额度统一沿用当前模型配置，不另设 token 上限。- 10 个原生 Agent 工具，直接使用 dsh 的模型与对话，包含知识整理与进度查询。
主动发起知识整理，或让 Agent 读取资料时，相应正文与图片识别补充文字会进入所配置模型的上下文；若模型在云端，相应内容会发送到模型服务商。
维护与导出¶
- 导出单份 Markdown，下载原始附件。
- 列表与详情删除资料、回收站查看与恢复，以及确认后永久清空回收站。
- 从原始资料目录重建 SQLite 索引；校验正文和段落文件，避免外部修改静默改变引用。
安装与启用¶
先安装 DeepSeek Harness，确保终端可以运行 dsh。在 PowerShell 或其他终端执行下面命令，从 npm 安装已构建好的插件（当前文档版本 0.3.0）：
dsh plugin --profile web add dsh-knowledge-library@0.3.0 --registry=https://registry.npmjs.org/
重启 DSH Web，在浏览器中按 Ctrl+Shift+R 刷新，点击侧栏 资料库。示例使用 web profile；若你使用其他 profile，请先确认宿主版本与界面兼容性后替换 profile 名。已验证宿主为 0.2.1-rc.2。
也可安装 GitHub Release 中的同一版本：
dsh plugin --profile web add "https://github.com/Alan-dong-dong/dsh-knowledge-library/releases/download/v0.3.0/dsh-knowledge-library-0.3.0.tgz" --registry=https://registry.npmjs.org/
安装后若无入口：确认安装的 profile 与启动的 profile 相同，重启并刷新，再用 dsh --profile web --dump-config 检查是否存在启用的 knowledge-library。
卸载：
dsh plugin --profile web remove dsh-knowledge-library
已保存的资料保留在独立资料目录。
配置要点¶
在 dsh 配置中修改 knowledge-library 项，或通过界面 设置 → 选择目录 切换资料库。手动 patch 示例：
- id: knowledge-library
config:
root: D:/KnowledgeLibrary
allowProxyFakeIp: false
加载方式：
dsh --profile web --patch ./library.patch.yml
root 必须是绝对路径。切换目录不会自动搬迁旧资料；迁移时需先关闭 Harness，复制整个资料库（含 .system）到新目录后再切换。
若网页采集提示检测到 198.18.*，且本机使用 Clash/Mihomo 的 TUN fake-IP 模式，可在 资料库设置 → 网页采集 中启用代理兼容，或将 allowProxyFakeIp 设为 true。该开关默认关闭，仅针对 fake-IP DNS 场景。
典型用法¶
在 Harness 内使用资料库¶
安装并刷新后，在侧栏打开 资料库，与 Agent 工具共享同一份本地数据：收集网页或导入文件，用分类、标签与搜索定位内容，在对话中通过 Agent 工具检索与引用。
知识整理流程（0.2.0 起）¶
README 描述的整理路径为：资料 → 逐篇分析 → 智能分组 → 确认归类 → 各组知识草稿 → 知识笔记，并支持对比、补充已有知识。列表侧可点击 智能整理，勾选最多 10 份资料后执行 智能分析分组，再按界面引导确认归类与草稿。升级 npm 插件后需重启 Harness 并刷新页面。
网页正文图片识别（0.3.0 起）¶
- 在 Harness 中选择声明支持图片输入的默认模型；插件从宿主模型信息核对能力。
- 打开 资料库设置 → 正文图片识别，开启自动识别并保存设置；仅对后续网页链接采集生效。
- 正常收集网页；队列先保存正文，再处理正文图片。完成后图中文字与图示解读进入搜索与知识整理，并标注为模型输出。
图片处理完成或停止后，才能生成知识笔记。
独立预览（可选）¶
不需要模型密钥也可单独打开资料库界面：
npm run build
npm start
访问 http://127.0.0.1:4317。同一资料库只能由一个写入实例打开；使用 dsh 插件前，请关闭使用同一目录的独立预览。
适用场景与注意¶
适合谁： 需要在 DSH 本机 Web 中长期沉淀网页与文件、按目录与标签管理、并在 Agent 对话里引用段落或整理知识笔记的开发者与个人用户。
权限与安全： 插件以当前 dsh 进程权限运行，会读写你指定的资料目录并进行网页采集。安装前应查看 源码与 MIT 许可证，并理解云端模型调用时的数据出站范围。
网络与站点限制： 微信公众号等链接可能因环境或站点策略超时或要求浏览器验证；任务会标记 需浏览器验证，可通过 打开原网页 与 粘贴正文 等方式补救。兼容 fake-IP 不保证目标站点本身可访问。
生态说明： DSH 理念是「一切皆插件」；SkillHub 等社区目录为独立站点，与 DeepSeek / 幻方无官方从属关系。
结尾¶
拾页把本地采集、分类检索与可追溯知识笔记接到 DSH 原生侧栏和 Agent 工具上，适合把「读过的网页和文件」变成可搜索、可引用的本地资料库，而不是散落在聊天历史里。
