dsh-notion-connector

by zhengjy01

0 记忆github 检测到 manifest package.json#dsh 社区精选 收录于 08-16

Notion connector for DeepSeek Harness: agent tools + Web settings page · DSH 的 Notion 连接插件

安装

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

GitHub 源码安装:首次需按提示配置 allowBuilds 构建授权后重试

安装与环境配置指引、插件开发教程见 DSH 中文社区文档 ↗

安装即在你的机器上以你的权限运行第三方代码——它可读写文件、使用凭据、访问网络,DSH 的工具审批不会为插件代码加沙箱。「检测到 manifest」仅代表发现 dsh.bundle / dsh.plugin 清单,不构成兼容性或安全审查;安装前请审阅源码,不熟悉的插件先在不含密钥的环境试用。

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: https://github.com/zhengjy01/dsh-notion-connector/blob/main/README.zh.md ↗