dsh-paper-design: Paper Design MCP 橋接插件

前言

DeepSeek Harness (DSH) 的核心設計理念是插件化,旨在通過統一的接口接入各類外部能力。DSH 本身不直接集成桌面設計工具,但通過 MCP 協議,開發者可以將本地應用(如 Paper Desktop)的能力接入 DSH。dsh-paper-design 正是這個橋樑,它將 Paper Desktop 的 MCP 工具註冊爲 DSH 原生工具,並提供了截圖轉發、設計指導和 OAuth 認證等能力。

插件簡介

  • 插件名:dsh-paper-design
  • 維護者:try-works
  • 定位:Paper Design MCP bridge as a DeepSeek Harness bundle
  • 分類:趣味換裝
  • 許可證:MIT

安裝與啓用

安裝該插件需要修改 DSH Profile 的 package.json 配置文件,將包添加到依賴列表和 Bundle 列表中。

在 ~/.dsh/profiles/<name>/package.json 中添加以下內容:

{
  "dependencies": {
    "@try-works/dsh-paper-design": "^0.1.4"
  },
  "dsh": {
    "profile": {
      "bundles": [
        "@deepseek-ai/dsh-base",
        "@try-works/dsh-paper-design"
      ]
    }
  }
}

配置完成後,在 Profile 目錄下運行 pnpm install 安裝依賴,並重啓正在運行的 DSH 進程。修改配置後必須重啓進程才能生效。

核心功能

該插件主要提供以下能力:

  1. 原生工具映射:將 Paper Desktop MCP 的工具(如 get_basic_info, get_screenshot, write_html 等)註冊爲 DSH 原生的 paper_* 工具。MCP 的輸入 Schema 會被規範化爲 DSH 強制的 JSON-Schema 子集。
  2. 圖片截圖轉發:get_screenshot 生成的圖片塊會被解碼並通過 ctx.attachments 持久化保存。圖片隨後會被髮送給支持圖片的模型路由,確保截圖能被識別和處理。
  3. Cursor 風格設計指導:插件會注入類似 Cursor 的設計指導規則作爲系統提示的一部分,並在連接/重連後的前兩個 Agent 回合中注入完整的 paper-mcp-instructions。
  4. 技能註冊:提供三個技能模塊:
    • code-to-design
    • design-to-code
    • paper-design(提供漸進式披露的工具參考索引)

命令與認證

插件提供命令行接口以管理連接和認證狀態。

  • 重連命令:/paper-reconnect
    • 用於在重啓 Paper Desktop 後重新初始化 MCP 會話,清除指南緩存並重置早期回合的注入預算。
  • 認證管理:
    • /paper-auth-status:查看當前認證模式(未認證/OAuth)、配置狀態、過期時間及錯誤信息。
    • /paper-auth-login:啓動 OAuth 2.1 授權流程。
    • /paper-auth-logout:清除存儲的令牌。

插件支持 MCP OAuth 認證(基於 RFC 8414/OIDC 等標準),令牌會持久化存儲在 $DSH_HOME/paper-design/oauth.json 中。

注意事項

  1. 運行環境:必須確保 Paper Desktop 正在運行且已打開文件,因爲 MCP 服務器運行在桌面應用內部。
  2. DSH 依賴:DSH 配置必須包含 @deepseek-ai/dsh-base 及其掛載的服務(tools, systemPrompt, attachments, skills, commands, llm, agent, scope, session)。
  3. 圖片支持:截圖功能依賴於支持圖片的模型路由,純文本模型無法處理截圖。
  4. 重啓要求:修改任何配置後必須重啓 DSH 進程。

參考資料

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜