OpenDesign：让编码 Agent 产出可交付的设计文件

把设计交给编码 Agent 的人多半遇到过同一件事：对话里生成的原型当时看着不错，关掉窗口就找不回来，交付时还得手工抄成 HTML 或 PPT。设计系统和最终产物之间隔着一层人工搬运，改一轮就要重来一遍。OpenDesign 想省掉这段搬运。

OpenDesign 是一个 TypeScript 写的本地优先设计 Agent 桌面应用，输入一段需求描述或一个设计系统，由本机编码 Agent 产出原型、幻灯片、图像与视频，落成可导出的真实文件。

它在仓库里给自己的定位是 Claude Design 的开源替代品，采用 Apache License 2.0，主要语言 TypeScript。适合已经在用 Claude Code、Codex、Cursor 这类命令行编码 Agent 的人：不用换工具，把设计任务接进原来的 Agent，产物留在同一个项目里，可以反复追问修改，再导出成 HTML、PDF、PPTX 或 MP4。

接入方式分两类。MCP、CLI 和 skills 让外部 Agent 调用 OpenDesign 提供的能力；native runtime adapter 则由 OpenDesign 自己把 Agent 拉起来。DeepSeek Harness 走的是第二条路，通过官方 dsh CLI 作为一等运行时接入，README 说它支持结构化思考、工具调用、模型发现、取消与会话恢复。平台兼容表里标为支持的有 Claude Code、Claude Desktop、Codex CLI、Cursor、VS Code + GitHub Copilot、DeepSeek Reasonix 和 Raven，对应的安装命令形如 od mcp install claude、od mcp install codex、od agent setup deepseek-harness。

它怎么做到的

一次任务从 brief 开始，可以是首页输入框里的一段话，也可以是一个现成示例。OpenDesign 把 brief、你选中的设计系统和模板，加上设置里配好的模型凭据，交给自己启动或外部接入的编码 Agent。Agent 在本地项目里生成 artifacts，Studio 一边生成一边给实时预览；产出的是真实文件，导出格式覆盖 HTML、PDF、PPTX 和 MP4。设计系统、媒体与原型统一收在 All projects 页里，可以回访；团队看到预览后在同一项目里提修改意见，Agent 接着改同一个项目，不另起一份。Agent 与文件系统之间的并发调度、运行状态具体落在哪块存储，仓库节选里没有展开说明。

几个关键设计

双轨接入：既能被 Agent 调用，也能拉起 Agent

OpenDesign 没有把自己绑死在一种 Agent 上。外部 Agent 通过 MCP 或 skills 消费 OpenDesign 的设计能力，这条路的安装命令是 od mcp install <agent>；OpenDesign 也可以按 native runtime 的方式直接启动 Agent，DeepSeek Harness 是它的一等原生运行时。README 说两条路径共享同一套工作流，生成的文件都留在 OpenDesign 里做实时预览和交付。好处是换 Agent 不必换工作区，代价是每条接入路径都要单独适配和维护，平台兼容表里每多一列，就多一份维护面。

设计系统、模板与插件以文件形式放在仓库里

顶层目录能看到 design-systems/、design-templates/、plugins/、figma-plugin/、clipper/ 和 craft/。设计系统、模板和能力包以普通文件存在，可以查看，也可以改；README 强调这些是团队能检视并改造成自己流程的东西。产品页里 Design Systems 用来查看品牌资产再用 Agent 细化，Plugins 页可以搜索官方 skills，并用 Try it 直接启动。

本地优先与 BYOK

本地优先指项目文件和产物落在这台机器上，不走先上传再取回的路。BYOK 是自带密钥，用自己的模型凭据接 20 多个 CLI 与模型厂商。这两条一起决定了运行成本结构。软件本身开源免费，模型调用按你自己选的服务商结算，数据留在本机。同时它也是 OpenDesign Go 这类订阅计划的入口，价格页显示 Go 套餐首月 8 美元，Plus 及以上最高 200 美元的赠送额度。

把一次 run 当成需要保命的东西

0.24.0 的代号是 Every Run, Kept Intact，发布说明写着这个版本用了 26 个 PR、13 位贡献者、1 天完成。它处理的是重载页面、追问、预览变更和首次启动这几个时刻，这些时刻以前最容易让正在进行的活儿丢掉位置，现在被保住。0.23.0 的代号是 Home, Rebuilt，用 10 天合了 73 个 PR，把首页、最近项目、运行状态和项目对话合成一条进入工作的路径，不再分散在几个地方。

这样设计的代价

仓库体积是绕不开的一项。事实表里的 size_kb 是 3510014，换算下来约 3.4 GB，克隆这个仓库本身就是一次不轻的操作，本地还要给生成的设计产物留出空间。

它把依赖压在外部 Agent 和模型密钥上。没有可用的 CLI 或 API key，应用能打开但产不出东西。Issue 里有一条问「How to install CLI's」，说按 README 的说明 CLI 应当自动装到 PATH 上，实际没找到，重装也没用。用内部 LLM 代理或 Ollama 的团队也踩过限制，一条待解决的 Issue 要求允许 BYOK 指向内部代理，不要拦私有 IP。

平台覆盖目前不完整。0.22.2 这个补丁专门修 macOS 和 Windows 的更新可靠性，Linux 桌面版还没有，一条标题为「Please bring the linux app as well」的 Issue 仍在待解决状态，评论 41 条，reactions 39。另有一条已解决的 Issue 提到登录变成强制、不能跳过，评论 48 条。

稳定性是它自己承认的短板。一条待解决的 Issue 把「把 chat run 的失败率从约 15% 降到不超过 8%，并且让每次失败都能解释」列为目标，评论 67 条，是这份清单里讨论最多的一条。其他待解决的有：切换标签页会中断上一个标签页正在流式输出的生成；用 Ollama Cloud 的 BYOK 会产出半成品 artifacts。仓库当前开放 Issue 数是 1162。

几个同类项目的取舍

搭一套完整的桌面工作区，换来的是仓库体积、平台限制和密钥配置成本。只想要「在 Claude Code 里查一下设计规范」这一件事的，marvkr/better-design 这类 MCP 服务更合适，它不用下载桌面应用，也不用登录账号；把设计推理流程本身当重点的，oh-my-design 的方向更贴。反过来说，这两者在多格式成品导出和项目级统一管理上都不如 OpenDesign，你要的是交付出文件，还是过程中的设计约束，决定了该往哪边走。

对你的实际影响

3.4 GB 的仓库体积配上桌面应用形态，意味着你需要一台日常开发机来跑它，而不是丢在 1 核 1G 的小服务器上。

BYOK 决定了成本上限由你自己控制，也决定了上手第一步不是点几下按钮，而是先准备好一路可用的模型凭据，并确认网络环境允许直连。用内网代理的团队在这一点上会遇到阻碍。

平台方面，macOS 和 Windows 用户现在能装，Linux 用户只能等；如果团队机器以 Linux 为主，这个项目目前不在名单里。

1162 个开放 Issue 和约 15% 的运行失败率落到日常使用里，就是复杂、多轮的设计任务有概率中断，你要接受偶尔重跑，并留意它在每个项目里留下的中间产物。

后期维护上，接的 Agent 越多，升级时受影响的面越大。平台表里每个 od mcp install 命令背后都是一份适配，换 Agent 或改用自己的模型服务时，需要重走一遍配置。

已经在用命令行编码 Agent、并且需要把原型、幻灯片或视频交付成文件的团队适合用它；设计系统和产物必须留在本机、不接受上传到第三方服务的场景也合适。反过来，只想在编辑器里加一个设计 skill、不想装桌面应用和登录账号的人，用 MCP 形态的轻量设计服务更省事；以 Linux 为主要开发平台的团队目前用不上；不愿意自己管模型密钥和额度的人，这套 BYOK 结构会把配置成本直接压在你身上。

焚评：这个项目的量化评分

本项目的选题来自 焚.com（一个按公开公式给 GitHub 项目打分的站）。焚评当前总分 9.9 分（满分 10）。下表是各维度的得分：

评分口径、权重与计算方式见焚.com 的评分方法页；数据随 GitHub 指标刷新，具体数值以焚.com 当前页面为准。本文正文为诀.com 独立撰写，评分数据由焚.com 授权引用。