前言¶
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 / 幻方存在官方从属关系。
