前言¶
在 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 为准。
