前言¶
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 進程。修改配置後必須重啓進程才能生效。
核心功能¶
該插件主要提供以下能力:
- 原生工具映射:將 Paper Desktop MCP 的工具(如
get_basic_info,get_screenshot,write_html等)註冊爲 DSH 原生的paper_*工具。MCP 的輸入 Schema 會被規範化爲 DSH 強制的 JSON-Schema 子集。 - 圖片截圖轉發:
get_screenshot生成的圖片塊會被解碼並通過ctx.attachments持久化保存。圖片隨後會被髮送給支持圖片的模型路由,確保截圖能被識別和處理。 - Cursor 風格設計指導:插件會注入類似 Cursor 的設計指導規則作爲系統提示的一部分,並在連接/重連後的前兩個 Agent 回合中注入完整的
paper-mcp-instructions。 - 技能註冊:提供三個技能模塊:
code-to-designdesign-to-codepaper-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 中。
注意事項¶
- 運行環境:必須確保 Paper Desktop 正在運行且已打開文件,因爲 MCP 服務器運行在桌面應用內部。
- DSH 依賴:DSH 配置必須包含
@deepseek-ai/dsh-base及其掛載的服務(tools, systemPrompt, attachments, skills, commands, llm, agent, scope, session)。 - 圖片支持:截圖功能依賴於支持圖片的模型路由,純文本模型無法處理截圖。
- 重啓要求:修改任何配置後必須重啓 DSH 進程。