前言¶
在 DeepSeek Harness（DSH）裏做智能體，經常要把知識庫、會議記錄、數據庫設計和文檔流程接到對話裏。單獨寫腳本調用 Notion API 可以工作，但要自己維護 OAuth、令牌刷新，還要把「搜頁面、讀庫、建頁、改塊」封裝成 Agent 能調用的工具。Notion 官方爲類似場景提供了 MCP 與 Cookbook 技能；社區維護者 craigary 將官方 claude-code-notion-plugin 移植爲 DSH 可用的 Cordis bundle，即 dsh-notion-plugin：託管 MCP 連接、12 個 Notion 技能，以及多工作區設置界面。
這是什麼¶
dsh-notion-plugin（GitHub：craigary/dsh-notion-plugin）是面向 DSH 的 Notion 工作區插件，分類上屬於聯網工具。當前 package.json 版本爲 0.1.4，許可證 MIT。插件不通過公開 registry 分發，需以本地目錄作爲 bundle 安裝。
一句話定位：通過 Notion 託管 MCP 服務器（https://mcp.notion.com/mcp）在本地完成 OAuth 與代理，讓 Agent 搜索、讀取、創建和編輯頁面與數據庫，並輔以 12 個預置技能與自然語言協作（DSH 在本地執行命令，不把 slash command 發給模型）。
核心功能¶
Notion MCP 工具¶
連接成功後，Agent 可通過 MCP 使用 Notion 的搜索、讀頁、創建與編輯頁面和數據庫等能力。流量經本地代理轉發，由插件注入並刷新當前活動賬號的令牌。
12 個技能¶
技能位於倉庫 skills/ 目錄，各含 SKILL.md。README 舉例包括：
notion-database-designernotion-meeting-intelligencenotion-research-documentationnotion-knowledge-capture
package.json 說明支持按技能單獨開關（per-skill toggles）。DSH 側沒有 slash commands；用技能加自然語言替代原 Claude Code 插件裏的命令式交互。
多工作區¶
可連接多個 Notion 工作區，同一時刻只有一個爲活動工作區。Agent 可通過 notion_list_workspaces、notion_use_workspace 列出並切換。
與桌面側欄瀏覽器協作¶
notion_open_page：在桌面右側邊欄瀏覽器（或其他環境的新標籤）中打開頁面。notion_current_page：返回側欄當前頁的 URL 與 page id，便於 Agent 回答「這一頁寫了什麼」；反映通過 Notion 工具打開的頁面。
安裝與啓用¶
該插件未發佈到 registry。安裝方式爲通過 DSH 的 plugin_manager 對本地目錄執行 install_bundle，目標路徑爲本插件所在文件夾。請勿憑插件名拼接 dsh plugin add github:owner/repo；以 README 描述爲準。
安裝前建議閱讀倉庫源碼與 cordis.patch.yml，確認與本機 DSH / Cordis 版本兼容。package.json 聲明的 peer 依賴包括 @deepseek-ai/cordis（約 4.1.0）、@deepseek-ai/dsh-mcp-client（≥0.2.0）、@deepseek-ai/schemastery（約 3.19.0）。
連接工作區¶
- 打開插件 Settings 頁面，點擊 Connect。
- 插件在本地回調地址執行 Notion OAuth（動態客戶端註冊 + PKCE）：
http://localhost:53682/callback
- MCP 請求經本地代理轉發，地址爲：
http://localhost:53683/mcp
代理爲活動賬號注入並刷新令牌。使用 Open Notion 可在側欄瀏覽器中完成一次登錄。
說明：在 Notion UI 裏創建的普通「login」連接不能作爲 MCP 客戶端；僅動態註冊的客戶端會被接受。
典型用法¶
連接並選定活動工作區後，可用自然語言讓 Agent 檢索或維護 Notion 內容，例如按會議場景啓用 notion-meeting-intelligence，或按庫表設計啓用 notion-database-designer。需要對照側欄里正在看的頁面時，先通過工具打開頁面，再詢問當前頁內容，Agent 會結合 notion_current_page 與 MCP 讀頁能力作答。多工作區時，先讓 Agent 調用 notion_list_workspaces / notion_use_workspace 再操作目標空間內的頁面或數據庫。
適用場景與注意¶
適合誰：已在 DSH 中開發 Agent、希望複用 Notion 官方 MCP 與 Cookbook 技能、並需要多工作區切換的開發者。
運行權限：插件以當前 DSH 進程權限運行，安裝前應檢查源碼、許可證（MIT）及 OAuth 本地端口占用情況。
已知限制：桌面側欄瀏覽器使用非持久會話，應用每次重啓後需在 Notion 再次登錄；若要持久登錄，需要宿主使用 persist: 會話分區（README Known limitation）。
生態說明：DSH 主張「一切皆插件」；SkillHub 目錄頁 爲社區站點，與 DeepSeek / 幻方無官方從屬關係，不等同於官方應用商店。
技能與 MCP 能力歸屬 Notion；本倉庫爲移植到 DSH 的 Cordis bundle，維護者爲 craigary。
結尾¶
dsh-notion-plugin 把 Notion 託管 MCP、OAuth 本地代理、12 個技能和多工作區設置收進一個 DSH bundle，適合把文檔與數據庫 workflow 直接交給 Harness 裏的 Agent。查閱簡介與分類可參考 SkillHub 插件頁，安裝與細節以 GitHub 倉庫 README 爲準。
