前言¶
DSH 可以通過插件擴展 Agent 能力。getnote-dsh-plugin 用於把得到大腦接入 DSH，讓 Agent 用自然語言搜索、保存和閱讀得到大腦筆記。它適合需要在 DSH 中直接查詢筆記、保存網頁鏈接、查看知識庫的開發者。
這是什麼¶
@getnote/dsh-plugin 是 iswalle 維護的 DSH 插件，採用 MIT 許可證。它把得到大腦的明確操作接入 DSH，使 Agent 可以調用筆記搜索、保存和查看能力，同時保留本地認證流程。
核心功能¶
- 檢查得到大腦登錄狀態
- 按自然語言語義搜索全部筆記
- 在指定知識庫內搜索
- 保存文字、網頁鏈接和本地圖片
- 保存時設置標題和標籤
- 查看最近筆記
- 按 ID 查看筆記詳情
- 查看知識庫列表
- 提供 DSH 引導 Skill，讓 Agent 優先選擇這些原生工具
安裝與啓用¶
- 確認本機 Node 版本滿足
>=20。 - 添加插件：
dsh plugin --profile web add @getnote/dsh-plugin
- 登錄得到大腦：
npx @getnote/cli@latest auth login
按頁面提示完成授權。得到大腦 OpenAPI 需要得到大腦會員。普通用戶不需要手工填寫 API Key，認證由 GetNote CLI 在本地管理。
- 重啓 DSH。
典型用法¶
重啓後，可以直接對 Agent 說：
幫我搜索得到大腦裏關於 Agent Harness 的筆記
把 https://example.com/article 保存到得到大腦，添加“待讀”標籤
列出最近 10 條筆記
打開筆記 1896830231705320746
列出我的知識庫
更新與卸載¶
維護插件時使用以下命令：
dsh plugin --profile web update @getnote/dsh-plugin
dsh plugin --profile web remove @getnote/dsh-plugin
配置說明¶
如需調整超時或輸出上限，可以在 profile 的 cordis.patch.yml 中覆蓋：
config:
timeoutMs: 120000
maxOutputBytes: 10485760
binaryPath 和 apiUrl 僅用於開發或聯調環境。
安全與注意¶
- 插件只開放明確的得到大腦操作，不提供任意 Shell 參數入口。
- 登錄狀態檢查不會把 API Key 或末尾字符寫入模型上下文。
- 刪除和批量修改等高風險能力尚未在首版開放。
- 插件在當前用戶權限下運行，請只從可信來源安裝。
- 如果本機已安裝更完整的 GetNote Skills，DSH 仍可正常發現和使用；插件不會複製相同 Skill 或覆蓋版本。
結尾¶
getnote-dsh-plugin 適合把得到大腦作爲 DSH 中的筆記能力使用，提供搜索、保存、查看和知識庫讀取等明確操作。
相關地址：
- GitHub：https://github.com/iswalle/getnote-dsh-plugin
- 目錄頁線索：https://www.skillhub.cn/plugins/iswalle/getnote-dsh-plugin
DSH 插件目錄用於發現第三方插件，不代表與 DeepSeek / 幻方存在官方從屬關係。
