项目知识复习插件

一个面向 DeepSeek Harness（DSH）的中文知识复习插件。它将知识类提问严格绑定到指定项目的私有 RAG：有证据才回答；资料缺失时不猜测、不东拼西凑，而是提醒用户提供有权用于学习的公开视频 URL。视频完成 RAG 索引后，再依据新的 evidence 回答。

解决的问题

通用模型在回答知识问题时容易混入训练语料、常识或不相关内容。这个插件将“解释 / 学习 / 复习知识”变成一个可审计流程：

1. 先调用项目 RAG 检索。
2. 只有 ANSWERED 且存在 evidences 时才能回答。
3. 资料没有足够证据、资料仍在处理或 RAG 不可用时，明确拒答。
4. 用户提供并确认可用于学习的公开视频 URL 后，插件调用项目视频入库接口创建索引任务。
5. 索引完成后重新检索；仍缺证据则继续拒答。

插件不替代项目的 RAG。它复用项目既有的递归切块、Multi-Query、BM25、pgvector、RRF/RAG-Fusion、重排和 evidence guard。

前置条件

• DSH Web profile。
• 项目 Python API 正在运行，默认地址为 http://127.0.0.1:8090。
• 需要使用视频时，项目已配置对应公开平台的视频转写能力，并且用户对该 URL 具有学习使用授权。

安装

从 GitHub 安装到 Web profile：

dsh plugin --profile web add github:HeWhenJay/dsh-project-knowledge-review

本地开发安装：

dsh plugin --profile web add .\tools\dsh-project-knowledge-review

安装后刷新现有 DSH Web 页面。该插件不会自动启动 RAG 服务。

配置

插件默认配置如下：

- insert:
    - id: project-knowledge-review
      name: dsh-project-knowledge-review
      config:
        ragBaseUrl: http://127.0.0.1:8090
        projectName: 学迹智配 Agent
        requestTimeoutMs: 120000

在 DSH profile 的 cordis.patch.yml 中覆盖即可修改 RAG 地址、项目名称和超时。插件直接复用当前 DSH 会话的模型完成最终回答；项目 RAG 的 embedding、rerank、ASR 等密钥仍由 Python 服务自己的环境配置提供，不需要在插件中重复设置。

供模型调用的工具

• project_knowledge_search：从项目私有 RAG 检索知识问题。证据不足时返回结构化 REFUSED。
• project_knowledge_import_video：把用户已确认可用于学习的公开视频 URL 提交给项目 RAG；只入队，不伪造“已学会”或“已完成索引”。

隐私与边界

• 插件仅请求配置的项目 RAG API，不会自行联网搜索知识答案。
• 视频仅在用户提供 URL 并确认其可用于学习后才会提交给项目服务。
• 插件不保存、不读取、不传递项目登录令牌；本机接口通过回环地址限制访问，并使用独立的 DSH_PLUGIN_RAG_USER_ID 资料分区。
• 插件不单独配置模型或 API Key。检索所需 embedding、rerank、ASR 等能力继续使用项目 Python 服务已经配置的环境变量；最终回答由当前 DSH 会话中用户选择的模型完成。
• 可通过 RAG_DSH_PLUGIN_ENABLED=false 关闭本机插件 RAG 路由。
• 这是一个严格证据回答模式，不适合需要通用百科、新闻或开放网络检索的提问。

开发验证

pnpm install
pnpm run typecheck
pnpm run build

许可证

MIT