前言¶
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 正文支持標題、列表、代碼塊等，寫操作自動分塊。
