iswalle/getnote-dsh-plugin

Name: iswalle/getnote-dsh-plugin
Author: iswalle

Plugin插件 Native原生 ⭐ 5 MIT Memory & Knowledge记忆与知识库

DeepSeek Harness插件，适用于得到大脑（Get笔记）

Project Overview项目介绍

Edited by Zhiwei Agent (zhiwei)由知微Agent(zhiwei)编辑

This is a native plugin built exclusively for DeepSeek Harness (DSH) that integrates the GetNote knowledge base service into the DSH agent workflow. To install the plugin, if you have a local DSH instance, run the command dsh plugin --profile web add @getnote/dsh-plugin in your terminal. If you use DSH via npx, you can run the equivalent npx-prefixed command to add the plugin to your DSH web profile. Once installed, the plugin adds a lightweight guided skill for DSH that lets the agent prioritize using the GetNote tools for any relevant requests. If you already have a full GetNote skill set installed locally, DSH will still detect and use your existing version without overwriting it.

After installing the plugin, you need to complete the authorization step by running npx @getnote/cli@latest auth login to log into your GetNote account. This command will open a browser window where you can follow the on-screen prompts to finish granting access. To use GetNote's OpenAPI, you need an active GetNote paid membership, which is a requirement from GetNote's side, not the plugin. After logging in, you need to restart your DSH instance to activate the plugin. Once restarted, you can start using natural language commands to interact with your GetNote notes directly through the DSH agent.

The plugin does not require a separate global installation of the GetNote CLI. When you run a note operation, it will first check for an existing GetNote CLI in your local system PATH, then check the version bundled with the plugin, and if neither is found, it will automatically pull a compatible version via npx. All authentication credentials are managed locally by the GetNote CLI, and the plugin never shares your API keys or login information with the DSH agent or the underlying LLM. High-risk features like note deletion and bulk editing are not available in this initial release, and the plugin follows strict security boundaries to prevent arbitrary command execution. The project is released under the MIT license.

这是一款原生适配 DeepSeek Harness（DSH）的插件，作用是将「得到大脑」接入 DSH 工作流。安装完成后，用户可以直接使用自然语言搜索、保存和阅读笔记，无需手动编写 API 请求，也不需要额外配置 MCP 服务。插件可通过 DSH 官方命令安装，本地安装的 DSH 可执行 dsh plugin --profile web add @getnote/dsh-plugin，通过 npx 使用 DSH 的用户可执行对应的 npx 安装命令。

安装完成后，用户需要先通过 GetNote CLI 完成浏览器授权登录，得到大脑 OpenAPI 需要开通得到大脑会员，授权信息可被其他支持 GetNote CLI 的 AI 工具复用。重启 DSH 后，用户就可以直接让 Agent 执行搜索笔记、保存网页链接、查看最近笔记、获取笔记详情等操作。这款插件适合习惯使用得到大脑记录管理笔记、同时使用 DSH 作为 AI Agent 工作流的用户。

插件本身不要求用户全局安装 GetNote CLI，执行操作时会优先调用本地已有的 CLI，其次调用插件自带版本，都不存在则自动通过 npx 调用兼容版本。插件目前暂未开放删除、批量修改等高风险能力，遵循最小权限安全边界，仅开放明确允许的笔记操作。项目采用 MIT 许可证开源，用户可以自由修改使用，仅需遵循许可证要求。

View on GitHub在 GitHub 查看

Send to your DSH发给你的 DSH 安装

请帮我安装这个 DSH 插件。安装前先完成【兼容性检查 + 安全性检查】，检查通过再动手。

插件：getnote-dsh-plugin（iswalle/getnote-dsh-plugin）
仓库：https://github.com/iswalle/getnote-dsh-plugin
本站详情页：https://www.yhbd.top/plugins/iswalle-getnote-dsh-plugin/
本站登记：类型 plugin · 归类 原生 DSH 插件 · 许可证 MIT · ⭐ 5 · 最近提交 2026-08-17 · 主语言 TypeScript

按下面顺序执行，每步先把结论告诉我，再进入下一步：

【1 兼容性检查】
① 我这边：DSH 版本、Node 版本、操作系统、当前 profile（web / desktop）。
② 读它的 README、package.json、插件 manifest，列出它要求的 DSH 版本 / Node 版本 / 操作系统 / 外部依赖 / 需要另外先装的运行时。
③ 逐条比对，结论只写「满足 / 不满足 / 未知」三种；不满足的给出可行替代方案。
④ 检查是否和我已装的插件冲突：命令名重复、skill / tool 重名、端口占用、重复注册的 MCP server。

【2 安全性检查】
① 仓库可信度：和上面「本站登记」是否一致；star / fork 数、创建时间、最近提交，是否归档或长期停更。
② 安装脚本：逐行看 package.json 的 preinstall / install / postinstall，以及 install.sh、setup.ps1 之类脚本。出现 curl|bash、下载后直接执行、混淆代码、访问与插件功能无关的域名，立刻停下来告诉我，不要继续装。
③ 依赖：列出新增依赖，标出无人维护、或与知名包拼写近似的可疑包（typosquatting）。
④ 权限与副作用：它会读写哪些目录、访问哪些域名、需要哪些 DSH 权限（filesystem / network / shell / clipboard 等），以及怎么卸载和回滚。
⑤ 如果它要求 sudo / 管理员权限，或权限明显超出功能所需，先停下来问我。

【3 安装】
上面两步没有「不满足」和「高危项」时才执行；用官方推荐方式安装，不要自行提权。

【4 汇报】
用表格输出：检查项 / 结论 / 依据 / 是否需要我决策。拿不准的一律写「未知」并说明要我怎么确认——不要猜，也不要替我决定。

Send this message to DSH in your current session: it verifies compatibility and security first (answering met / not met / unknown item by item) and only installs once everything checks out — it will stop and ask you if it finds a high-risk item. The box scrolls; the copy is the full prompt. CLI install commands may not be accurate across systems, so DSH is the safer route.把上面这条消息直接发给当前会话里的 DSH：它会先核对兼容性与安全性（逐条给「满足 / 不满足 / 未知」），确认没问题再安装，有高危项会停下来问你。框内可滚动，复制到的是完整提示词；安装命令不一定准确，发给 DSH 更稳。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意

Only 5 stars - very few users, little community feedback星标只有 5，几乎没人在用，遇到问题缺少社区反馈

DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时（Electron / Python / Docker 等）是否齐备
Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突：命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致，是否归档或长期停更
Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需（filesystem / network / shell / clipboard）
Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限，以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照，不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装（适合开发者）

CLI Install命令行安装

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

把 iswalle/getnote-dsh-plugin 加入你的 DSH 配置（web profile）即可启用。

READMEREADME

4.0 KB · 缓存于 2026-08-29 05:30:38 · 4.0 KB

在 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

binaryPath 和 apiUrl 仅用于开发或联调环境。

安全边界

插件只开放明确的得到大脑操作，不提供任意 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

渲染基于仓库 iswalle/getnote-dsh-plugin 的 README.md。在 GitHub 查看原文 →