DeepSeek Harness 插件

getnote-dsh-plugin

在 DeepSeek Harness 中用自然语言搜索、保存和阅读得到大脑笔记(英文原文)

跳到安装方式

来源信息

GitHub 仓库
iswalle/getnote-dsh-plugin
最近更新
2026年8月17日
分类
文档与渲染
GitHub stars
0
载体类型
plugin
目录证据
上游声明已找到 dsh.bundle
证据路径
package.json#dsh.bundle
核对版本
0.1.0-rc.8
上游核对日期
2026-08-20

该证据由上游目录提供。本站没有安装、运行或安全审核这个插件。

安装

默认先复制一段 Prompt,让 Agent 读 GitHub 仓库和源码;需要自己装时再切到命令。

复制这段 Prompt,发给 DSH、Codex 或其他 Agent,让它先读 GitHub 仓库和源码。

请先不要安装或执行任何命令。阅读这个插件的 GitHub 仓库、README 和关键源码,然后用清楚、直接的方式回答以下问题,帮助我判断它是否适合我的需求:

1. 这个插件是什么,解决什么问题;
2. 适合哪些用户和典型使用场景;
3. 安装后如何使用,并给出一个最小使用示例;
4. 有哪些已知限制,以及隐私、安全、兼容性或维护风险;
5. 给出“推荐 / 有条件推荐 / 不推荐”的明确建议和理由。

请区分仓库明确说明、根据源码推断和未知信息。证据不足时请明确说明,不要猜测或照抄 README。

GitHub:https://github.com/iswalle/getnote-dsh-plugin
插件名:getnote-dsh-plugin
作者:iswalle

检查来源文件

安装前先看这个插件目录里的 README 和其他文件。

文件资源管理器3 个文件
README.md来源说明 · 只读预览

在 DeepSeek Harness 中使用得到大脑

把得到大脑接入 DeepSeek Harness(dsh)。安装后,你可以直接用自然语言搜索、 保存和阅读笔记,不需要复制 API 请求,也不需要单独配置 MCP。

开始使用

1. 安装插件

dsh plugin --profile web add @getnote/dsh-plugin

如果你通过 npx 使用 DSH:

npx @deepseek-ai/dsh plugin --profile web add @getnote/dsh-plugin

2. 登录得到大脑

npx @getnote/cli@latest auth login

命令会打开浏览器,请按页面提示完成授权。得到大脑 OpenAPI 需要得到大脑会员。

插件不要求你额外全局安装 CLI。运行笔记操作时,它会先使用本机 PATH 中已有的 getnote,再尝试插件环境中的 GetNote CLI;都没有时会自动通过 npx 调用兼容 版本。上面的登录授权也可以被其他支持 GetNote CLI 的 AI 工具复用。

3. 重启 DSH

重启 dsh web 后,就可以直接对 Agent 说:

帮我搜索得到大脑里关于 Agent Harness 的笔记
把 https://example.com/article 保存到得到大脑,添加“待读”标签
列出最近 10 条笔记
打开笔记 1896830231705320746
列出我的知识库

支持的能力

  • 检查得到大脑登录状态
  • 按自然语言语义搜索全部笔记
  • 在指定知识库内搜索
  • 保存文字、网页链接和本地图片
  • 保存时设置标题和标签
  • 查看最近笔记
  • 按 ID 查看笔记详情
  • 查看知识库列表

插件会提供一个轻量的 DSH 引导 Skill,让 Agent 优先选择这些原生工具。若你已经 在本机安装了更完整的 GetNote Skills,DSH 仍可正常发现并使用它们,插件不会再 复制一套相同 Skill,也不会覆盖你的版本。

常见问题

提示未登录怎么办?

重新执行:

npx @getnote/cli@latest auth login

完成授权后重启 DSH。如果仍然失败,可以运行:

npx @getnote/cli@latest doctor -o json

是否需要配置 API Key?

普通用户不需要手工填写 API Key。推荐使用浏览器授权,插件会复用 GetNote CLI 保存的登录状态。

插件会把凭据发给模型吗?

不会。认证由 GetNote CLI 在本地管理;插件只把笔记操作结果返回给 DSH。登录 状态检查也不会把 API Key 或末尾字符写入模型上下文。

为什么依赖 GetNote CLI?

GetNote CLI 负责浏览器授权、调用得到大脑 OpenAPI、处理异步任务和返回结构化 结果。插件负责把这些能力变成 DSH 原生工具。这样同一份授权可以跨终端和多个 AI 工具复用,也能避免重复维护两套得到大脑接口。

更新与卸载

更新:

dsh plugin --profile web update @getnote/dsh-plugin

卸载:

dsh plugin --profile web remove @getnote/dsh-plugin

卸载插件不会退出得到大脑账号。如需同时退出:

npx @getnote/cli@latest auth logout

高级配置

大多数用户不需要修改配置。需要调整长任务超时或输出上限时,可以在 profile 的 cordis.patch.yml 中覆盖插件配置:

- id: getnote-tools
  name: '@getnote/dsh-plugin'
  inject: [tools, skills]
  config:
    timeoutMs: 120000
    maxOutputBytes: 10485760

binaryPathapiUrl 仅用于开发或联调环境。

安全边界

  • 插件只开放明确的得到大脑操作,不提供任意 Shell 参数入口。
  • CLI 参数通过参数数组传递,不拼接 Shell 命令。
  • 删除和批量修改等高风险能力尚未在首版开放。
  • 插件与其他 DSH 插件一样,在当前用户权限下运行;请只从可信来源安装。

开发

npm install
npm run check
npm test
npm run build
npm pack --dry-run

项目通过 @getnote/cli 调用得到大脑能力,并随 npm 包提供一个只负责工具选择的 DSH 引导 Skill。推送与 package.json 版本一致的 v* tag 后,GitHub Actions 会执行检查、测试、构建并发布 npm 包。

License

MIT