DeepSeek Harness plugin

getnote-dsh-plugin

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

Jump to install

Source facts

Repository
iswalle/getnote-dsh-plugin
Latest update
Aug 17, 2026
Category
Docs & Rendering
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/iswalle/getnote-dsh-plugin
Plugin: getnote-dsh-plugin
Author: iswalle

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

在 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