OpenCode 延伸阅读
已发布指南中列出的 OpenCode 设计工作教程、文档和演练。
如何在 OpenDesign 中使用 OpenCode 设计界面:在生成任何内容之前绑定 design.md、你选择的提供商、一个从 brief 到审阅后文件的共享收件箱任务,以及开始前需要了解的限制。
一个完整的 OpenCode 设计任务
一个设计任务贯穿整个闭环:你交出去的需求简报与约束、返回给你的产物,以及在你宣布完成之前仍然需要做的检查。下方界面是为本页制作的示意性示例;它不是一次真实记录的 OpenCode 运行。
Brief设计一个共享团队收件箱:带负责人的会话列表、一个会话线视图,以及一条用于展示客户上下文的右侧栏。在生成之前绑定 design.md 系统。覆盖桌面端和手机端。
data-od-id 挂钩你撰写需求简报、选择设计系统,并设定验收标准。
OpenCode 规划布局,编写 HTML、CSS 和 JavaScript,然后在你提出要求时进行修改。
OpenDesign 提供设计系统与技能,渲染预览,并把每个版本都作为项目中的一个文件保留下来。
交接之前,检查视觉层级、8px 网格上的间距、两个断点,以及每一项交互。
三个面板对齐 8px 网格;上下文侧栏先于会话线折叠。
负责人和主题先行;强调色保留给“等我们处理”。
先列表,点按后进入会话线;上下文侧栏变成一个底部面板。
按负责人筛选、打开一个会话线、切换侧栏并发送一条回复。
Fit
兼容性
本页讲的是通过 OpenDesign 桌面应用连接使用 OpenCode 的情况。所引用的公开资料核对于 2026 年 9 月 6 日。
OpenCode 是一个开源(MIT)终端 AI 编码代理——带有 TUI 以及桌面端和 IDE 界面——由 Anomaly(SST 团队)在 github.com/anomalyco/opencode 维护。本页讲的是通过 OpenDesign 用 OpenCode 做界面设计,而不是 OpenCode 自身的界面。OpenDesign 的 配置说明 列出了可用的代理。
通过 OpenCode 配置提供方密钥(BYOK)。OpenCode 通过它自己的配置使用你的提供方密钥(BYOK)——不经过任何代理转发。本页不承诺任何额度或价格。
桌面版构建请查看下载页面。源快速开始中的 Node.js 和 pnpm 要求在从源码运行时适用,而不是在安装桌面安装包时适用。最低兼容的 OpenCode 版本:此处未核实。
使用你所安装版本显示的连接说明,然后运行一个小任务。确认 OpenCode 处理了该任务,并且产物可以打开。仅仅下载本身并不能构成可用的连接。
从桌面应用开始
先下载,针对你安装的版本完成 OpenCode 配置,然后检查一个小结果。走这条路径不需要从源码构建 OpenDesign。
选择适合你电脑的安装包,安装并打开应用。
下载 OpenDesign按照你安装版本随附的 OpenCode 说明操作。OpenCode 通过它自己的配置使用你的提供方密钥(BYOK)——不经过任何代理转发。
# 1. Install OpenCode
curl -fsSL https://opencode.ai/install | bash
# or: npm i -g opencode-ai@latest
# or: brew install sst/tap/opencode
# 2. Start the TUI in your project, then authenticate your provider
opencode # then run /login and pick your provider + paste your key摘自已发布指南中的 OpenCode 配置说明;当前命令请查阅厂商文档。
把需求简报控制得小一些,这样你才能评判整个闭环,包括一轮修改。
构建一个设置界面,包含个人资料表单和保存确认。遵循我的设计规则。在桌面端和移动端宽度下检查它。
如果你想从源码运行 OpenDesign,请改用 技术快速开始。
OpenCode 设计工作流
一个共享收件箱的示例贯穿始终,从写好的需求简报一直到经过检查的 HTML。每一步都包含:你的输入、OpenCode 的动作、OpenDesign 的贡献,以及你仍需承担的审阅。
保持平实简短:三到六行。说明谁使用这个界面、它完成什么任务,以及它必须适配哪些平台。
一套设计系统,外加一小组硬性规则。这种组合可以防止 OpenCode 退回千篇一律的外观。
OpenCode 写出一个自包含的 HTML 文件:布局、样式、交互和稳定的钩子。
OpenDesign 会按你指定的宽度预览文件。设计正是在这里接受评判。
data-od-id 目标,供评论和编辑使用。通过指向预览元素来提出更改。每次修订都作为新文件落地;不会在你未看到的情况下覆盖任何内容。
资源
已发布指南中列出的 OpenCode 设计工作教程、文档和演练。
限制
常见问题
# 1. Install OpenCode\ncurl -fsSL https://opencode.ai/install | bash\n# or: npm i -g opencode-ai@latest\n# or: brew install sst/tap/opencode\n\n# 2. Start the TUI in your project, then authenticate your provider\nopencode # then run /login and pick your provider + paste your key\n\n# 3. Generate project context\nopencode # inside your project, run /init to create AGENTS.md\n\n# 4. Pick your model (any provider, via models.dev)\n# set \"provider/model-id\" in opencode.json or switch in the TUI\n\n# 5. Add an MCP server (optional, e.g. for design handoff)\n# configure it under the \"mcp\" key in opencode.jsonopencode\n# in the TUI:\n> @reference-desktop.png @reference-mobile.png\n Implement this design in React + Vite + Tailwind + TypeScript.\n Reuse my existing design-system components and tokens from AGENTS.md.\n Match spacing, layout, and hierarchy; make it responsive.\n Run the dev server, open it in a browser, and iterate until the\n UI matches the references across breakpoints.