lemoncat7/dsh-knowledge

Plugin插件 Native原生 ⭐ 14 MIT Memory & Knowledge记忆与知识库

可安装的DeepSeek Harness知识库插件

Project Overview项目介绍

dsh-knowledge is a native RAG knowledge base plugin built exclusively for DeepSeek Harness (DSH). It does not alter DSH’s core agent loop, and it supports both local SQLite storage for standalone use and connections to a remote centralized knowledge base. It includes core features like collapsible knowledge document groups, drag-and-drop batch sorting, mandatory grouping for new documents, and granular permission controls for mounting, projects, tags, and review access. You can install it via DSH’s plugin registry or directly from npm, and it has been fully validated on DSH 0.1.5-rc.1 with over 180 passing automated tests.

This plugin is designed for DSH users who need to systematically accumulate and manage project or domain-specific knowledge. The typical workflow starts with mounting the relevant knowledge base to your project or session, then the plugin automatically pulls relevant knowledge snippets before the agent generates a response. After the agent finishes answering, it extracts valid new knowledge in the background and writes it back to the knowledge base following the configured rules. Users can create multiple separate knowledge bases, customize grouping, extraction strategies and access permissions, and get a dedicated interface to manage backwrite tasks.

dsh-knowledge is released under the open-source MIT license, and it requires Node.js version 22.19 or newer, or Node.js 24 or newer to run and develop. To connect to a remote knowledge base, you need a valid HTTPS endpoint and a client access token generated by the central instance. All local knowledge data is persisted to your DSH data directory, and you must create a backup of your database before upgrading; you need to restore this backup if you plan to downgrade the plugin later. A Docker build workflow is provided for source builds that output a production-ready tarball.

dsh-knowledge 是专为 DeepSeek Harness (DSH) 开发的原生 RAG 知识库插件,不修改 DSH 的核心 Agent 运行逻辑。插件同时支持本地 SQLite 存储和连接远程中央知识库,提供知识文档折叠分组、拖拽批量归类、新文档强制分组等功能,支持挂载、项目、标签和审核权限管控。

它面向需要沉淀和管理领域/项目知识的 DSH 用户,典型工作流程是先挂载对应知识库,回答前自动召回相关知识摘要辅助生成回答,回答结束后在后台提取有效知识,按规则回写到知识库中。用户可创建多个知识库,自定义分组、提取策略和权限,支持管理回写任务队列,方便处理失败和重试。

本插件基于 MIT 许可证开源,运行和开发要求 Node.js 22.19+ 或 24+,支持通过 npm 或 DSH 插件市场安装,也提供 Docker 源码编译方案。使用远程知识库需要 HTTPS 地址和客户端令牌,本地数据持久化在 DSH 数据目录,数据库升级前需备份,降级需恢复备份。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 14 stars - an early-stage project星标 14,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add @lemoncat7/dsh-knowledge

把 lemoncat7/dsh-knowledge 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-knowledge

当前版本 2.13.1,已验证宿主 DSH 0.2.0-rc.2(宿主仍为 RC)。Node.js ^22.19.0 或 >=24.0.0。详见 兼容说明 和 发布说明。

npm GitHub Release awesome · DSH plugin

dsh-knowledge 是面向 DeepSeek Harness 的知识库插件。它不修改 DSH Agent Loop,同一个插件既能使用本地 SQLite,也能连接远程中央知识库。

兼容性

2.11.1 DSH 0.1.7 适配

插件正式版,已在 DSH 0.1.7-rc.2 构建与测试验证,覆盖 0.1.6-alpha.2 起的宿主破坏性变更:图标渲染崩溃、回合尾回写状态条注册抛错、停靠侧栏「待打开」恒被取消、连接设置卡片静默消失、会话消息 source 校验失败(共五项),逐一修复;开发依赖 11 个客户端包升至 0.1.7-rc.2。0.1.5 及更早宿主请继续使用 2.10.1(图标改名为单向迁移)。数据库无变更。本次 Linux / Node.js 22 验证 186 项测试全部通过,宿主实际回写、召回与设置注册已补充验证。详见 更新说明 和 DSH 0.1.7 兼容说明。

2.10.0 知识文档分组与会话工具

插件正式版,已在 DSH 0.1.5-rc.1 本地构建部署验证。知识文档支持折叠分组、拖拽及批量归类,新文档必选分组,自动回写优先复用已有分组。普通会话和伙伴会话共用分组查询与修改工具,并遵守挂载、项目、标签和审核权限。

186 项自动测试及浏览器分组回归通过。远程模式需同时升级知识服务;数据库升级至 schema 15,回退前应恢复升级前备份。详见 更新说明 和 分组使用说明。

2.9.6 新版宿主适配

插件正式版,已在 DSH 0.1.5-rc.1 验证,保留旧版回退。支持笔记选文摘录到知识库、来源引用和按目录浏览目标文档。详见 更新说明。

2.9.0 知识库分组

正式版,适配 DSH 0.1.2-rc.1。163 项测试及分组、挂载的桌面与手机浏览器回归通过。

“知识库与挂载 → 我的知识库”支持按家里助手、工作、个人等自定义分组。 点击“新建分组”选择知识库并命名;组标题可折叠、重命名,知识库编辑里的“所属分组”可选择已有名称、输入新名称或留空移回“未分组”。同名分组合并显示,空分组自动消失,搜索支持分组名并展开匹配项。 分组持久化在知识服务,独立于标签、内容及挂载权限;折叠偏好保存在当前浏览器。远程模式需要同时升级知识服务。数据库自动升级至 schema 14,回退旧插件前应恢复升级前备份。

挂载列表、设置弹窗及批量挂载确认统一显示“分类 / 知识库名”;列表先按分类、再按库名自然排序,未分组置后,搜索支持分类名,选择状态与挂载配置不受影响。

2.8.1 更新

  • 回写执行失败自动重试 4 次,间隔 5、15、60、180 秒,不再依赖错误关键词。
  • 重试耗尽后保留失败快照和写入计划,放行后续回写;旧失败记录也不再阻塞队列。
  • 重试沿用幂等和版本冲突检查,重启保留尝试次数与计划;158 项测试通过。

2.8.0 更新

正式版,适配 DSH 0.1.2-rc.1。

  • 当前知识文档和笔记自动检查版本,未编辑时刷新,编辑中保留草稿并提示新版本;提供差异和手动合并入口。
  • 页面保存、AI 笔记正文工具和关注记录增加版本校验,防止过期写入覆盖新内容;保存中继续输入仍保留为未保存草稿。
  • 保留指定笔记记录接口及普通会话的引用笔记权限,清理未使用的临时观察会话挂载逻辑。
  • 155 项测试及桌面、手机深浅主题浏览器回归通过。远程模式请同时升级知识服务;AI 笔记正文更新需携带读取结果中的 expectedVersion。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-docs 下一个 Next dsh-scholar →