前言¶

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 进程。

参考资料¶

• GitHub 仓库
• 社区目录