跳到正文
dsh-market 浏览插件 GitHub EN

zhengjy01/dsh-notion-connector

配置一次 Notion Integration Token,Agent 即可搜索、读取、查询、创建、更新、追加 Notion 页面与数据库内容,并提供 Web 设置页。

Star 数 ★ 0 分类 记忆 收录于 2026-08-16 npm dsh-notion-connector

安装

在 DeepSeek Harness 里通过 dsh-market 安装

dsh plugin --profile web add dshmarket

或使用命令行

dsh plugin --profile web add dsh-notion-connector

装任何插件都等于在你的机器上跑第三方代码,权限和你本人一样大——能读你的文件、用你的凭据、访问网络。请先审阅源码,并尽量锁定 commit(github:owner/repo#sha)。

README

English | 中文

DeepSeek Harness 的 Notion 连接插件。配置一次 Integration Token 后,agent 与 Web GUI 设置页都可以操作你的 Notion 工作区。

功能

  • Agent 工具(配置后自动可用):
    • notion_search — 搜索页面/数据库
    • notion_read_page — 读取页面标题、属性、内容块(嵌套递归,最多 200 块)
    • notion_query_database — 查询数据库条目(filter / sorts / 翻页)
    • notion_create_page — 创建页面(页面或数据库下)
    • notion_update_page — 更新属性 / 归档
    • notion_append_blocks — 追加内容块
  • Web 设置页:设置 → Notion — 连接状态、Token 粘贴(保存时自动校验并读取工作区名)、清除配置、三步指引
  • 存储:Token 存 ~/.dsh/notion.json(权限 0600);通过 loopback-only 的 /api/dsh-notion-connector/* 与浏览器半交互;API 调用走 Node 原生 fetch,无 shell 依赖

安装

dsh plugin --profile web add github:zhengjy01/dsh-notion-connector

重启 dsh web 后生效。

使用

  1. 打开 https://www.notion.so/my-integrations 创建内部集成,复制 secret_ 开头的 Internal Integration Secret
  2. 在 Notion 中把要访问的页面/数据库 Share 给该集成
  3. GUI 设置 → Notion 粘贴并保存
  4. 之后对 agent 说「搜索 Notion 里的 XX」「把这段内容存进 Notion」即可

开发

pnpm install        # esbuild / typescript / 类型依赖
pnpm build          # esbuild: lib/index.js (host) + lib/client.js (browser)
pnpm typecheck      # tsc --noEmit
pnpm install:local  # 本地开发快速安装(复制到 ~/.dsh/profiles/node_modules/dsh-notion-connector)

限制

  • 页面/数据库必须分享给该 Integration 才能访问
  • Token 以明文保存在用户主目录私有文件(权限 0600)
  • 插件是第三方代码:安装前请审阅源码,只在信任的来源使用

License

MIT

内容来自项目 README(GitHub)↗