前言¶
DSH 插件生态强调「一切皆插件」。对于中文 DSH 用户来说，一个常见需求是把学习资料、文字转写和音频转写放进当前会话中复习，而不是额外搭建一套复杂的外部系统。
dsh-project-knowledge-review 是一个面向中文 DSH 用户的独立本地知识复习插件。它把文字、OCR 和 ASR 资料保存到本地资料库，在回答前优先检索本地 evidence；在 strict 模式下，如果证据不足会明确拒答。
这是什么¶
下面是这个插件的基本信息。
- 插件名：
dsh-project-knowledge-review - 定位：面向中文 DSH 用户的独立本地知识复习插件
- 维护者：HeWhenJay
- 许可证：MIT
- 生态位置：DSH 插件生态中的社区项目。社区目录是独立站点，与 DeepSeek / 幻方无官方从属关系。
核心功能¶
这个插件主要提供以下能力：
- 零配置本地资料库，首次使用时自动创建 v2 存储
- 证据优先问答：先检索本地 evidence，再根据 evidence 回答
- strict 模式下，证据不足时明确拒答
- 文字、OCR、ASR 入库后生成 Markdown 自动提要
- 可过滤导入元数据、RAG 模板和纯时间戳
- 两级分类：系统初分类与用户可调整的二次分类
- 侧栏知识库独立工作区，可查看详细摘要和原始内容
- 安全 Markdown 预览，支持渲染视图和 Markdown 源码视图，不执行 HTML 或脚本
- 可选 OCR / ASR，默认关闭
- 启用 OCR / ASR 时需要显式开启，并配置 DSH 凭据
- 轻量 JSONL 索引、单文档原文文件、游标分页和按需原文读取
- v1 旧库自动迁移到 v2，并保留原始备份
- 插件只提供检索 evidence 和系统约束，最终答案由当前会话模型生成
安装与启用¶
先安装插件。安装命令如下：
dsh plugin --profile web add dsh-project-knowledge-review
安装后，重新启动当前 DSH Web 进程并刷新页面。
首次使用时，插件会自动创建 v2 存储。默认本地存储路径是：
~/.dsh/project-knowledge-review/knowledge.json
默认不需要数据库、向量模型、账号登录或项目 Token。
如果使用 OCR 或 ASR，需要显式开启。步骤如下：
- 打开“设置 → 知识复习”
- 开启对应服务
- 配置 Base URL 与模型名称
- 将 API Key 保存到 DSH 凭据库
API Key 不写入插件设置 JSON，也不会回显。
典型用法¶
添加文字资料¶
在 DSH 对话中直接粘贴文字，并说明加入知识库的信息：
把下面内容加入知识库，标题是……，来源是……：
（粘贴你有权使用的文字）
这一步会把你提供的文字资料加入本地知识库。
基于知识库复习¶
在对话中直接提问：
根据我的知识库解释……
插件会先检索本地 evidence，再让当前会话模型根据 evidence 回答。
查询知识库概览¶
可以问下面这些问题：
我的知识库有多少份资料？
知识库资料保存在哪里？
知识库是否与当前项目共享？
这些查询用于查看资料数量、存储位置和共享范围。
在侧栏浏览资料¶
点击侧栏“知识库”，可以搜索本地资料，并按系统分类或个人分类浏览。
阅读时可以在下面几组视图之间切换：
- 摘要 / 原始内容
- 渲染 / Markdown 源码
安全 Markdown 预览不执行 HTML 或脚本。
切换回答策略¶
在“设置 → 知识复习”中，可以切换回答策略：
reference：允许当前会话模型补充通用知识，但需要区分知识库证据和模型补充strict：没有足够证据时明确拒答
适用场景与注意¶
这个插件适合这些场景：
- 你希望把中文学习资料、笔记、文字转写或音频转写放在本地知识库中复习
- 你希望回答前优先使用本地 evidence
- 你希望在 strict 模式下，避免当前会话模型在证据不足时给出知识结论
使用前需要注意：
- 插件以当前 DSH 进程权限运行，安装前应先检查源码和 MIT 许可证
- 请只导入自己编写、公开授权或已确认有权使用的资料
- 插件不会连接、安装或识别任何外部项目，
sharedWithCurrentProject始终为false - OCR / ASR 默认关闭，启用后只接受公开 HTTP(S) 图片 URL 或公开可直接下载的音频 URL
- OCR / ASR 会拒绝 URL 用户信息、非 HTTP(S) 协议、本机地址和私有网络地址
- 安全 Markdown 预览不执行 HTML 或脚本
- v1 旧库会自动迁移到 v2，并保留原始备份
结尾¶
dsh-project-knowledge-review 提供了一个较轻量的本地知识复习路径：本地资料库、证据优先问答、Markdown 预览和二次分类。
相关入口如下：
- 插件线索给出的目录页：https://www.skillhub.cn/plugins/HeWhenJay/dsh-project-knowledge-review
- GitHub：https://github.com/HeWhenJay/dsh-project-knowledge-review
