前言¶
在 DeepSeek Harness（DSH）里做文献调研时，常见做法是手动打开 arXiv、复制标题和摘要，再逐篇决定是否精读。Agent 虽然能联网，但缺少针对论文检索和结构化解读的专用工具时，仍容易在「找论文」和「判断值不值得读」之间反复切换。
下面介绍社区插件 dsh-plugin-knowra：把 Knowra 接到 DSH，让 Agent 按主题、作者或日期窗口检索 arXiv，并在需要时读取 Scout 报告——用方法、证据与局限帮你筛出值得精读的篇目。插件由 Rexopia 维护，在 SkillHub 目录中归类为「联网工具」；仓库 Rexopia/dsh-plugin-knowra 当前版本为 0.2.2，许可证 MIT。
这是什么¶
dsh-plugin-knowra 是 DSH 主机插件：安装后向 Cordis 注入一个名为 knowra 的 MCP 服务，远端 endpoint 为 https://mcp.knowra.app/mcp。Knowra 收到的是 Agent 发起的工具请求，而不是完整对话内容；隐私说明见 Knowra 隐私政策。
插件还包含 Desktop/Web 上的账户连接页，通过 OAuth（PKCE）把 Scout 读报告能力绑定到你的 Knowra 账号；令牌由 DSH 凭证服务本地保存并自动刷新，不写入 profile 配置或聊天参数。
核心功能¶
启用插件后，Agent 可使用三个 MCP 工具（命名空间前缀为 mcp__knowra__）：
| 工具 | 作用 | 是否需要登录 Knowra |
|---|---|---|
search_papers |
检索 arXiv 标题、作者与摘要；可选 UTC 日期窗口（自 2025-08-01 起） | 否 |
get_scout |
读取检索结果中某篇论文的 Scout 报告 | 是 |
get_usage |
查看 Scout 额度与重置时间 | 是 |
检索装好即可用，无需账号。Scout 需要先连接 Knowra 账号；连接后额度与授权在 DSH 重启后仍有效。
安装与启用¶
DSH 版本须为 0.2.1-rc.3 或更新的 0.2.x（package.json 中 engines.dsh 为 >=0.2.1-rc.3 <0.3.0）。
图形界面：DSH → Plugins → Add plugin，输入 dsh-plugin-knowra，安装并启用。
命令行（Web profile 示例）：
dsh plugin --profile web add dsh-plugin-knowra
启用后，若要读 Scout：打开 Plugins → Knowra → Connect Knowra，在浏览器中完成登录与授权，再返回 DSH。浏览器未自动打开时，使用插件页显示的授权链接。浏览器与 DSH 须在同一台电脑上，以便本机 OAuth 回调；本版本面向 Desktop 与同机 Web UI，不包含远程/无头登录流程。
从 0.1.x 升级：删除此前在 ~/.dsh/cordis.patch.yml 或 profile patch 中手动添加的 mcp-knowra 覆盖项；新版仅 OAuth，不再读取 KNOWRA_API_KEY。若旧 personal key 已无他用，可在 Knowra 账户页 撤销。
断开连接：可取消进行中的登录或移除本地连接并撤销授权；若断开时服务端不可达，插件页会提示你到 Knowra 账户页手动撤销。
典型用法¶
README 给出的示例提示（可直接在 DSH 对话中尝试）：
Find papers on memory for LLM agents from the past week, shortlist the relevant ones and read their Scout reports.
中文场景下可改写为类似意图：让 Agent 检索过去一周内与「LLM Agent 记忆」相关的 arXiv 论文，先筛出相关条目，再对 shortlisted 篇目调用 get_scout 阅读 Scout 报告。
典型流程可以是：
- 用自然语言描述主题、作者或日期范围，由 Agent 调用
search_papers。 - 根据摘要与元数据缩小列表。
- 已连接 Knowra 时，对候选论文调用
get_scout；需要确认额度时调用get_usage。
适用场景与注意¶
适合：在 DSH 里做 arXiv 定向检索、快速对比多篇论文的方法与局限，再决定精读哪几篇的研究者与 Agent 开发者。
权限与安全：插件以当前 DSH 进程权限运行；安装前建议浏览 GitHub 源码 与 MIT 许可证。默认凭证存储为当前 OS 用户可读的文件，并非系统钥匙串；Disconnect 会撤销本地授权，必要时在 Knowra 账户侧再确认。
生态说明：DSH 采用「一切皆插件」的扩展方式；SkillHub 插件目录 为社区站点，与 DeepSeek / 幻方无官方从属关系。
问题反馈：GitHub Issues，或邮件 support@knowra.app。
结尾¶
经过上面的步骤，你可以在 DSH 内完成「检索 arXiv → 读 Scout 筛文献」的闭环：检索免登录，Scout 通过 OAuth 安全连接。目录页：dsh-plugin-knowra @ SkillHub；源码与 README：github.com/Rexopia/dsh-plugin-knowra。
