try-works/dsh-paper-design

dsh-paper-design

Paper Design MCP 桥接，作为 DeepSeek Harness 捆绑包。

连接到 Paper Desktop MCP 服务器（http://127.0.0.1:29979/mcp），将每个 Paper 工具注册为原生 paper_ 工具并支持图像截图，注入与 Cursor 对等的设计指导，注册 Paper 技能，并暴露重连 + OAuth 认证命令。

它提供什么

- paper_ 工具 —— Paper Desktop MCP 公布的每个工具（get_basic_info、get_screenshot、write_html、update_styles……），原生注册到 ctx.tools。原始 MCP inputSchema 会被规范化为强制执行的 DSH JSON-Schema 子集（剥离 $schema/format/pattern/propertyNames/min/max，anyOf→oneOf）。
- 图像截图转发 —— get_screenshot 图像块会被解码，并通过 ctx.attachments（saveImage）持久化提交，然后作为附件支持的图像块发出（并作为插件来源的上下文延迟用于嵌套的 run_code 调度），从而使截图能够到达支持图像的模型。
- 与 Cursor 对等的指导 —— 作为系统提示词部分注入的常驻规则（顺序 150），外加在连接/重连后的前 2 个代理回合中注入完整的 paper-mcp-instructions 指南。paper_get_guide 也会缓存指南正文。
- 技能 —— code-to-design、design-to-code（Cursor Paper 插件正文逐字保留），以及 paper-design（渐进式披露的工具参考索引）。
- /paper-reconnect —— 重新初始化 MCP 会话，清除指南缓存，并重置早期回合的指南注入预算。
- MCP OAuth 认证（与 Cursor 对等）—— 一个发现驱动的 OAuth 2.1 客户端：RFC 8414/OIDC 发现探测 → RFC 7591 动态客户端注册 → 通过回环重定向进行 PKCE（RFC 7636）授权 → 令牌交换/刷新 → 附带 401/403 WWW-Authenticate 质询处理（RFC 9728）的持有者令牌附加。令牌持久化到 $DSH_HOME/paper-design/oauth.json。Paper Desktop 目前在 localhost 上以未认证方式运行（无发现/质询），因此桥接在那里保持休眠，认证层仅在服务器公布或质询认证时激活。命令：
- /paper-auth-status —— 显示模式（未认证 vs oauth）、已配置/已认证状态、过期时间、发现端点、上次质询/错误。
- /paper-auth-login —— 启动 OAuth 授权流程（打开浏览器；回退为打印 URL）。
- /paper-auth-logout —— 清除已存储的令牌。

要求

- Paper Desktop 正在运行并打开了一个文件（MCP 服务器位于桌面应用内部）。
- 一个捆绑了 @deepseek-ai/dsh-base（或其挂载的服务）的 DeepSeek Harness 配置文件：tools、systemPrompt、attachments（用于图像）、skills、commands、llm。
- 用于截图支持的具备图像能力的模型路由（文本工具可在任何路由上工作）。

安装

将此包添加到配置文件及其 bundles 列表中，例如在 ~/.dsh/profiles//package.json 中：

{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 进程。该桥接器直接附带其 src/.ts 源码（DSH 通过 tsx 加载它们），与 dsh-recursive-mode 保持一致。

主机/包变更需要重启：Web 客户端插件 HMR 只会重新构建 Web 外壳，而不会重新构建主机插件。

用法

- 让 agent 在 Paper 中读取或设计；它将使用 paper_get_basic_info、paper_open_file、paper_get_screenshot 等工具。
- /paper-reconnect 在重启 Paper Desktop 后重新同步。
- /paper-auth-status / /paper-auth-login / /paper-auth-logout 在服务器需要时管理 OAuth 认证。

开发
bash
pnpm install
pnpm run build                        # 类型检查（tsc -p tsconfig.build.json）
pnpm run verify                       # 实时 MCP 桥接验证（需要 Paper Desktop）
pnpm run verify:bridge                # 进程内插件启动 + 实时 paper_get_basic_info
pnpm run verify:parity                # Cursor/pi 技能主体一致性
pnpm run verify:injection             # 提示词分段标记/预算逻辑
pnpm run verify:auth                  # 针对模拟授权服务器的 OAuth 流程
pnpm test                             # 以上全部

布局

- src/index.ts — 包入口：连接、规范化、注册工具 + 提示词 + 技能 + 命令。
- src/mcp-client.ts — 最小化的 Streamable HTTP MCP 客户端（initialize/tools-list/tools-call、会话跟踪、SSE 解析、一次性重新初始化、bearer-token + challenge 钩子）。
- src/auth.ts — 基于发现的 MCP OAuth 2.1 客户端（RFC 8414/OIDC 发现、DCR、PKCE、回环重定向、令牌交换/刷新、持久化存储、challenge 处理）。
- src/schema.ts — 原始 Paper JSON Schema → 强制 DSH 子集规范化器。
- src/guide.ts — 常驻规则 + 早期轮次引导标记与构建器。
- src/skills.ts — 运行时技能注册。
- skills//SKILL.md — 磁盘上的技能主体（一致性产物）。
- cordis.patch.yml — 将桥接器插入 cordis:group 领域的加载器补丁。

许可证

MIT