前言¶
DeepSeek Harness (DSH) 的 Agent 在处理任务时，常需要直接操作 Notion 工作区。dsh-notion-skill 通过 Notion 官方 REST API，为 DSH Agent 提供了与工作区交互的能力，使其能直接读写你的工作区。
这是什么¶
dsh-notion-skill 是一个 DSH 插件，由 Zhiyi-Zhao 维护，属于「联网工具」类别。它让 DSH Agent 能够通过 Notion 官方 REST API，搜索页面/数据库、读取页面属性、读取页面全部内容（递归转 markdown），以及创建/更新页面和数据库条目。
安装与启用¶
通过以下命令安装插件：
dsh plugin --profile web add github:Zhiyi-Zhao/dsh-notion-skill
核心功能¶
插件支持以下操作：
- 凭据验证：验证 Notion Token 是否有效。
- 搜索：按关键词搜索页面或数据库。
- 页面操作：读取页面属性、读取全部内容（递归转 markdown）、创建子页面、更新页面标题、追加内容块。
- 数据库操作：查询数据库、创建数据库、新增数据库条目、更新数据库条目。
配置与安全¶
- 获取 Token：在 Notion 集成页面创建集成并复制 Token。
- 配置 Token：将 Token 写入配置文件
~/.dsh/notion/token，或设置环境变量NOTION_TOKEN。 - 授权页面：在 Notion 中，对需要访问的页面/数据库进行授权（Connections）。
- 安全机制：
- Token 存放在本机配置文件，不写入代码或仓库。
- 写操作（创建/更新/追加）由 Agent 先展示内容摘要，经用户确认后执行。
- Notion 页面内容被视为不可信输入，防止 Prompt 注入。
使用示例¶
在 DSH 中直接输入以下指令即可：
- “读一下我 Notion 里的 xxx 页面”
- “把这段话存成一篇新页面”
- “在 xxx 数据库里新增一条记录”
技术细节¶
- 纯 Python 标准库实现，零第三方依赖。
- 支持 Windows / macOS / Linux。
- Markdown 正文支持标题、列表、代码块等，写操作自动分块。
