前言¶
在构建基于大模型的智能体时，让模型能够读取和操作设计工具的数据是一个常见需求。如果只是通过 MCP（Model Context Protocol）做透传，控制粒度有限，且需要编辑器侧提供 MCP 服务。对于需要深度集成设计平台的场景，更直接的方式是让模型通过原生工具访问设计平台的后端 API。
dsh-penpot 插件在 DeepSeek Harness 中以原生插件的形式提供了这种能力：通过 13 个 penpot_* 工具直接调用 Penpot 的 REST/RPC 命令 API，同时内置了设计评审、设计交付和设计生成三个技能。这种方式不需要 MCP，也不嵌入编辑器 UI，适合需要精细控制设计数据流的智能体工作流。
是什么¶
dsh-penpot 是由 AlbertZJ 维护的一个 DeepSeek Harness 原生插件，它将 Penpot 设计平台的数据访问能力直接暴露给 Harness 模型。插件通过 Harness 的工具系统注册了 13 个面向模型的原生工具，以及三个预定义的技能，使模型能够在不依赖 MCP 的情况下读取和写入设计数据。
它支持 Penpot 的 SaaS 版本（penpot.app）或任何自托管的 Penpot 实例。
核心能力¶
13 个 penpot_* 工具¶
插件提供了一系列工具，覆盖 Penpot 的 REST/RPC 命令 API 的读写操作：
penpot_whoami：检查连接与个人资料- 团队 → 项目 → 文件遍历
- 文件搜索
- 文件概览（页面 + 设计令牌集合）
- 页面画板树
- 打开评论线程
- 二进制
.penpot归档导出 - 创建项目
- 创建文件
- 导入
.penpot归档 - 上传生成的 SVG/PNG/JPEG/WebP 资产到文件
所有工具都通过 Authorization: Token 方式进行认证，使用与 Penpot 官方 Web 应用相同的后端 API。
3 个内置技能¶
插件同时提供了三个预定义技能：
penpot-design-review：从实时数据出发进行结构化设计评审penpot-design-handoff：生成设计资产清单、令牌、评论以及便携式归档，供开发团队使用penpot-design-generate：创建项目/文件，并将模型生成的 SVG 画板交付为 Penpot 资产（写入路径，不使用 MCP，不涉及画布自动化）
安装与启用¶
安装前需要准备一个 Penpot 个人访问令牌：在 Penpot 的 Settings → Access tokens 中生成。
在终端中执行以下命令：
export PENPOT_TOKEN=<your-token> # Windows PowerShell: $env:PENPOT_TOKEN="..."
dsh plugin --profile web add github:AlbertZJ/dsh-penpot
安装后，插件会自动注册 13 个 penpot_* 工具和三个技能。
可选配置¶
默认配置如下，可以在 Harness 的 Plugins 页面编辑插件的配置行，或在 cordis.patch.yml 中为关联安装设置：
config:
baseUrl: https://design.penpot.dev # 或自托管地址
tokenRef: PENPOT_TOKEN # 持有令牌的环境变量
timeoutMs: 30000
验证安装¶
在 Harness 会话中，让模型运行 penpot_whoami，它应该返回你的 Penpot 个人资料。然后尝试说“review the design draft named X”，penpot-design-review 技能会接管后续操作。
开发与构建¶
插件代码使用 TypeScript 编写，构建产物 lib/ 已提交，安装时不需要构建权限。如需修改源码，可以执行：
pnpm install
pnpm run build # tsc + tsdown -> lib/
pnpm run verify # 结构性检查（无依赖）
与其他方案的对比¶
与 qunanchang/dsh-penpot 相比，这个插件不把 Penpot 编辑器 UI 嵌入到 Harness 侧边栏，也不使用 Penpot 的 MCP。它专注于数据与工具集成：模型通过原生 dsh 工具读取并导出设计数据。两种方案可以组合使用：用 dsh-penpot 处理智能体工作流，用另一个插件在 Harness 中嵌入可视化编辑器。
适用场景¶
适合需要在智能体工作流中直接读写设计数据的场景，例如：
- 自动生成设计资产并交付到 Penpot
- 从现有设计文件中提取信息进行评审或交付
- 构建设计管理、设计系统维护或设计协作的自动化流程
注意：插件以当前 Harness 进程的权限运行，安装前建议检查源码与许可证。
总结¶
dsh-penpot 为 DeepSeek Harness 提供了与 Penpot 设计平台的原生集成能力，通过原生工具而非 MCP 实现了对设计数据的精细控制，并内置了设计评审、交付和生成三个常用工作流。如果你需要在智能体中处理设计数据，这是一个可以直接落地的方案。
- 目录页：https://www.skillhub.cn/plugins/AlbertZJ/dsh-penpot
- GitHub：https://github.com/AlbertZJ/dsh-penpot
