前言¶

在 DeepSeek Harness（DSH）里用 Agentero 读论文时，划词、高亮往往能看见，但多行文字评论却经常读不全。Agentero DSH 0.1.5 把评论卡片放在 PDF 页面右边界之外；默认「适应宽度」下 PDF 占满阅读区，评论容易落到视口外。下面介绍社区客户端插件 yellkiin/dsh-agentero-annotations（当前 package 版本 0.1.3，MIT），它把评论放进独立、可折叠的栏，并支持按页筛选、搜索与页码跳转。

这是什么¶

dsh-agentero-annotations 由维护者 yellkiin 发布，分类为 客户端。Agentero 负责文献库、PDF 与阅读标注，DSH 提供对话与插件界面；本插件不改文献库逻辑，在 Agentero 的 DSH PDF 阅读器上增加完整文字批注栏。它读取 Agentero 已配置的知识库，不调用模型。Zotero 等保存在数据库里的批注，需先导入 Agentero 或导出为带批注的 PDF 后才能在阅读流程里统一看到。

仓库：https://github.com/yellkiin/dsh-agentero-annotations
社区目录页：https://www.skillhub.cn/plugins/yellkiin/dsh-agentero-annotations

核心功能¶

下列能力均来自项目 README 的功能说明与已验证环境描述。

宽阅读区域下批注栏与 PDF 并排；窄区域可使用可关闭的侧栏浮层。长评论可全文滚动、选择和复制。

实现上，插件使用 DSH 的 dsh.bundle、dsh.client、Cordis 生命周期与 sidebar.right.pane.tab 槽位，在 agentero-dsh-pdf 键上提供优先级为 -100 的增强页体，复用 Agentero 的数据接口与文献入口。

安装与启用¶

这是需要在本机 下载源码、构建后再安装 的组合插件，不是仅用一条 dsh plugin add github:… 即可完成。安装前请自行审阅源码与许可证；插件在 当前 DSH 进程权限 下运行，会访问本机 Agentero 文献库路径。

已验证环境（README 记载）： DeepSeek Harness 0.2.2-rc.1、Agentero DSH 0.1.5、Node.js 24.22.2（package.json 要求 >=24.9.0）、esbuild 0.28.2、DSH web profile、Chrome 156。package.json 中 engines.dsh 为 >=0.2.1-rc.5 <0.3.0，peerDependencies 指向 @poco-ai/agentero-dsh ^0.1.5。

1. 准备 Agentero¶

先在 DSH 中安装 Agentero 并配置文献库：

dsh plugin --profile web add @poco-ai/agentero-dsh

2. 下载并构建本插件¶

从 GitHub 获取源码后安装依赖并构建。构建会从固定提交拉取上游阅读器，并使用本机 DSH profile 中的阅读器依赖；需要 Node.js、系统 tar，构建期间需能访问 GitHub。

git clone https://github.com/yellkiin/dsh-agentero-annotations.git
cd dsh-agentero-annotations
npm install --legacy-peer-deps
npm run build

默认依赖目录为 $HOME/.dsh/profiles/web/node_modules。若使用其他 profile 或自定义 DSH 目录，构建时指定实际路径，例如：

DSH_PROFILE_NODE_MODULES="$HOME/.dsh/profiles/my-profile/node_modules" npm run build

3. 安装到 DSH¶

node install.mjs --profile web

刷新 DSH 网页，重新打开论文，在界面上方通过「文字批注」展开或收起侧栏。插件管理页可查看启用状态，并按界面提示刷新或重启。

更新源码后 README 建议依次执行：git pull、npm install --legacy-peer-deps、npm run build、node install.mjs --profile web。不使用时在插件管理中停用 dsh-agentero-annotations 即可。

典型用法¶

经过上面的安装步骤后，可按 README 中的使用流程操作：

1. 从 Agentero 文献库打开论文。
2. 展开「文字批注」栏。
3. 选择「当前页」或「整篇」。
4. 输入关键词筛选评论，点击页码跳转到对应页。
5. 需要更大 PDF 显示区域时收起批注栏，或将 DSH 阅读区域切换为全屏。

PDF 内嵌评论按两页一批读取，与 Agentero 已有评论按页码和正文去重；文字内容保留在本机文献库，不经过本插件上传。

适用场景与注意¶

适合谁： 已在 DSH web profile 中使用 Agentero 读 PDF、且批注以 Agentero 文献库或带批注 PDF 为主的研究或开发场景。README 记载曾在真实 DSH 页面验证 2042 字长评论、当前页/整篇切换、搜索、页码跳转、收起展开及宽窄布局；单独屏蔽位置索引响应时，阅读器仍能从 PDF 读取文字评论。

注意：

• 必须先有 Agentero 与正确配置的文献库，再构建安装本插件。
• 迁移机器时，需复制或同步 Agentero 文献库，在新环境中重新配置知识库后，再重复构建与 install.mjs 步骤。
• 公开仓库与源码发行包不包含个人文献、批注正文、会话或账号；安装与构建仍建议检查 NOTICE.md 中上游阅读器来源说明。

结尾¶

dsh-agentero-annotations 针对 Agentero 默认布局下「看得见高亮、看不见全文评论」的问题，用独立批注栏补齐阅读体验，并与 PDF 内嵌评论、Agentero 索引合并展示。DSH 生态主张「一切皆插件」；SkillHub 等社区目录独立于 DeepSeek / 幻方，本插件以开源仓库为准进行安装与审阅。

• 目录页：https://www.skillhub.cn/plugins/yellkiin/dsh-agentero-annotations
• GitHub：https://github.com/yellkiin/dsh-agentero-annotations