前言¶

在 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