Skip to content
sxh313Public

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Design2Code

本地启动

在项目根目录配置已有的 .env(不要提交),运行 .\Start-Design2Code.ps1; 停止运行 .\Stop-Design2Code.ps1。所有服务仅供本机使用。

当前交付状态(2026-11-12)

  • 中文统一入口已整合 screenshot-to-code 的输入、store、历史、CodeMirror 和预览组件;通过工程 Run 适配官方 Agent,原生 App/WebSocket 已单独实测对照。
  • FigmaToCode 原转换与共享导出链已接入项目包和 Desktop Bridge;截图、Figma、Spec 七种输入模式均有真实记录,支持同一任务联合生成、一次修改、构建与源码导出。
  • 当前 Python 全量测试 419 通过 / 2 跳过,pyright 0 错误 / 54 个原有警告,额外真实资源构建测试 1 通过;前端 lint / build 通过。下文各阶段旧数字是当时结果。
  • 已验证工作台停止、重启恢复、原候选预览与下载、请求额度保持,以及 Figma 自动重连。默认由代理主动连接并核实实际状态,只有必须人工登录或授权时提示用户。
  • 视觉满意度仍需人工复核;完整 Agent 工具反馈闭环受单阶段一次请求限制,未执行;Bridge 全量类型检查仍有 99 个上游错误。具体首轮失败、未执行项和对照差异见下文,不将它们计为通过。

FigmaToCode 接入(2026-11-11)

  • 项目包:导入真实插件导出的 ZIP,保存原包和源码/图片哈希,生成统一 FigmaCodeArtifact。旧 ZIP 没有转换版本时标记未知,不伪造来源。
  • 直连:在 Figma Desktop 中运行本项目的 Bridge 插件,选中链接对应的一个画板。工作台默认调用 figma_code;保留勾选“仅读取节点/截图参考”的旧路径。
  • 原插件的下载功能与 Bridge 共用 FigmaToCode/apps/plugin/plugin-src/projectExport.ts,沿用 nodesToJSON、HTML 转换、图片导出和 generateProjectZip;不是用普通节点 JSON 模拟转换。
  • ZIP 与直连结果都进入同一 SourceSet。官方 Agent 收到实际转换源码、图片引用、Spec 和用户指令;原始 ZIP 可以独立下载,包内脚本不执行。
  • 直连校验请求 ID、文件会话和选区,返回空选区、无会话、超时、转换失败、资源失败等状态,不自动重试。

构建 Bridge(先安装各目录依赖及 FigmaToCode 工作区依赖):

cd figma-mcp-bridge/server
npm run build
cd ../plugin
npm run build

在 Figma Desktop 导入 figma-mcp-bridge/plugin/manifest.json。插件重新启动后,若开发环境无真实 fileKey,按现有 Bind-FigmaBridge.ps1 流程绑定当前文件。

转换工程保留与本次验证(2026-11-11)

  • React/Vite Figma Artifact 作为可运行的 TSX 多文件工程起点。官方 Agent 的 create_file / edit_file 依原工具算法修改指定源码文件,未修改的文件保留;原始 ZIP 单独保存。
  • 单独 Figma 且没有附加指令时直接构建,模型调用为 0 次。图片 URL 为本地嵌套预览规范化,依赖、入口和构建配置使用受控 React 18 / Vite / Tailwind 3 模板。Tailwind 4 样式暂不支持,HTML/Next 包仍为参考输入,不能声称兼容所有上游输出。
  • 保存 Artifact → 工程源码 → 候选的文件关系与文本哈希;导出报告另含候选实际文件字节哈希,以识别历史 Windows 换行差异。新候选源码直接以 UTF-8 字节写入。
  • 每 Run 最多 2 次模型请求、1 次修复、无自动重试。首轮与修复分别最多一次供应商请求,关闭会额外调用供应商的工具;文件工具执行后未追加模型读取反馈,完整 Agent 反馈闭环标记未执行。
  • 真实保存的插件包零调用构建:run_084fe1b0dfa3437db6e626982826938f。
  • 真实图片 + 保存的插件包 + Spec 联合生成:run_2c121f0a34df4291bfa86e263b209b12,使用官方 Agent 和配置模型,首轮 1 次、修复 1 次。首轮缺样式且弹窗存在同名关闭按钮,唯一一次修复后构建、搜索与弹窗检查通过。
  • 上述联合工程导出到干净目录,实际执行 pnpm install --frozen-lockfile --ignore-scripts、pnpm build 和本地 Vite preview。实际操作搜索、状态筛选、组合筛选空状态、空值错误、有效提交和弹窗关闭通过;桌面和手机视口无横向溢出,图片已加载。依赖安装复用了本机 pnpm 缓存,不等于全新机器验证。
  • 已自行启动 Figma Desktop 和现有 Bridge 开发插件,绑定真实文件并从工作台完成选区直连:run_b8bf8b28ba9344fb859d5925d9d10485。来源为 plugin_execution、传输为 desktop_bridge,带本次 request_id 和原转换器版本;该 Run 0 次模型请求,构建和导出后干净目录安装/构建通过。这次选区是单图画板,不代表多节点设计的完整验收。
  • 上述直连原始布局实际显示为空白,不能仅凭构建通过认定视觉通过。原因是百分比高度缺少父级高度;现在为缺少全局 CSS 的导入工程补齐高度链,保留原 App 源码并记录规范化警告。重建同一真实 Artifact 的 run_d8abacdca0824bda89165c13ed43a520 使用 0 次模型请求,浏览器确认 1000×700 原图可见,导出工程的原 ZIP、图片字节、文本/文件哈希和干净目录安装/构建通过;响应式还原仍需检查。
  • 本次实时直连 Artifact + 导出截图 + Spec 的联合 Run 为 run_d2b6a8ebf6f34ea5a9d373def603bcda,共 2 次模型请求、1 次修复,实际工具分别修改 src/App.tsx 与 src/index.css。独立目录安装、构建、启动后,真实搜索、状态筛选、组合空状态、表单错误、有效提交和关闭弹窗通过,桌面/手机图片加载及横向溢出检查通过。视觉还原和通用交互冒烟仍不能标为全部通过。

Python 全量测试本阶段 404 通过、2 跳过;前端 lint 和生产构建通过。FigmaToCode 原 ZIP 测试历史为 10 项通过。 Bridge 全量类型检查仍报告 99 个上游 backend 源码类型错误;Python 全量类型检查也有历史测试文件错误,不能宣称全量静态检查通过。 本阶段 Python 全量类型检查为 6 个错误、54 个警告,工程适配核心改动的定向检查为 0 错误、0 警告。

当前首页由中文 Workbench.tsx 编排,输入、项目状态、候选版本、预览和编辑已适配 screenshot-to-code 原生组件及 store。工程任务通过统一 REST Run 接口执行官方 Agent;原生 App 的 WebSocket 对照在独立诊断入口完成,范围见下文。七模式和多节点本次验证见下文;构建成功不等于视觉还原通过。

原生前端增量整合

  • 结果区实际复用上游 PreviewPane、PreviewComponent、Tabs 和 CodeMirror。预览适配本地构建 URL,使用 1440×900 / 390×844 固定视口,支持适应面板、原始尺寸及重新加载。
  • 构建工程继续使用隔离 iframe 和已校验的选取元素消息;上游单 HTML 的同源 DOM 编辑路径保持独立。没有把多文件工程伪装为单 HTML commit。
  • CodeMirror 展示本次候选的真实文件并支持文件切换;现支持“编辑源码”→“构建手写修改”,提交前候选哈希校验、浏览器 IndexedDB 草稿、刷新恢复与幂等提交。手写修改不调用模型,与模型修复共用每 Run 一次修改额度;重新构建/检查后导出,保留修改前工程。当前只允许修改现有源码文件,TSX/CSS 使用纯文本编辑模式。
  • 浏览器实测:恢复真实任务、元素选取、桌面/手机搜索与弹窗、缩放后的真实鼠标点击、文件内容一致、只读、重载及导出入口通过;本次验证未新增模型请求。前端 lint / build 通过;后端全量 404 通过、2 跳过,pyright 仍为 6 个历史错误、54 个警告。

多节点与无图输入实测

  • 实时转换 Catalog / normal / 390 的 49 个节点(21 个文字节点):run_696afb0d76434805a78268ced67dd5dd,0 次模型请求。转换工程保留 9979 字节 App 源码,构建及导出干净目录安装/构建/启动通过;390×1100 浏览器中为真实 DOM 和文字。该画板没有独立图片资源,图片资产检查不适用;静态转换没有自动生成搜索或弹窗行为,视觉仍待复核。
  • 无图 Spec 首轮 run_73907551e9174770af8c9a2f657988fb 暴露 HTML 包装器的实际缺陷:动态内联脚本被本地 CSP 拦截,且模型引用了不存在的图片。该首轮为失败结果。
  • HTML 适配现将经典脚本及静态事件处理器编译进本地 JS bundle,保留 script-src 'self'。支持挂载后的 DOMContentLoaded 回调及 StrictMode 单次初始化;外部/module 脚本明确拒绝。仍是上游 HTML 的工程包装,不代表已转换为原生 React 组件。
  • 同一 Spec Run 使用唯一一次修复,累计 2 次请求、1 次修复,移除虚构图片并修正按钮命名。导出干净目录真实验证搜索、空状态/清除、名称升降序、商品详情与关闭、桌面/手机无横向溢出均通过。视觉无参考图,不适用图片还原对照;页面样式仍待人工复核。
  • 本次后端全量测试 409 通过、2 跳过;全量 pyright 为原有 6 个错误、54 个警告,HTML 适配及对应改动的定向检查 0 错误、0 警告。另有同 CSP 的合成回归验证,不将其作为真实模型生成证据。

本次七模式矩阵与原生对照

使用同一真实多节点画板的转换 Artifact、独立登记的截图及商品目录 Spec;以下为本次实时结果,代码版本 ccc9579。模型均为 openai/gpt-6-luna。

输入 Run ID 实际请求 / 修复 结果
Figma run_696afb0d76434805a78268ced67dd5dd 0 / 0 静态转换、构建、导出通过;业务交互未执行
截图 run_2233e9dcd9ff4949bb10c98128c840f5 2 / 1 首轮关闭按钮被遮挡;唯一修复后通过
Spec run_73907551e9174770af8c9a2f657988fb 2 / 1 首轮脚本/图片/命名失败;唯一修复后通过
截图 + Figma run_ee802c4d57854dc5973457446fd93df4 1 / 0 通过
Figma + Spec run_acf82bc38fed4157bda42af602326e05 1 / 0 通过
截图 + Spec run_3449cf2ed0294e46ab222f9bc5014bb7 2 / 1 首轮缺指定详情按钮;唯一修复后通过
截图 + Figma + Spec run_07f80e37eeb54a599a9b17e6a6836815 1 / 0 通过
  • 六种生成模式在独立导出工程中实际操作搜索、空状态恢复、名称双向排序和详情弹窗打开/关闭通过;有 Spec 的模式另检查清除按钮。桌面 1440 与手机 390 无横向溢出。每个导出都在新目录安装、构建和启动,核验源码、来源关系及文件哈希;复用本机 pnpm 缓存。
  • 此画板无独立图片资产,不能据此认定图片资产通过;图片链路使用上文带图直连联合 Run 单独验证。视觉还原仍为 MANUAL_REVIEW。完整 Agent 工具反馈闭环受单阶段一次请求约束,仍为 NOT_RUN。
  • 原生对照实际调用官方 AgenticGenerationStage.process_variants 与文件工具,采用相同截图、指令、模型、端点和首轮 1 次请求 / 0 修复,在 390×1100 视口比较。原生与集成均呈现四件商品;文字颜色/位置、卡片间距、SVG 外形及桌面列数存在差异,集成页竖向滚动条导致有效内容宽度少 15px。两者首轮均有 Close 被遮挡的问题;原生搜索、排序、打开详情与 Escape 关闭通过,Close 点击失败,未修复。
  • 此阶段对照仅覆盖官方生成执行层;原生 App/WebSocket 浏览器流程另在下文补测。集成包含来源上下文及 React/Vite 包装,原生直接输出 HTML,不能宣称完全等价或计算“还原率”。失败日志、首轮产物和截图保留在本地 runtime/verification-project-phase 与 output/playwright,不推送运行数据。

手写源码本次实测

  • run_c5e8543ce48d4667a6bb374f1953f8a7 专用于新编辑功能验收,使用真实多节点 Artifact,不续跑已耗尽的生成任务;0 次模型请求、1 次手写修改。
  • 在真实浏览器编辑 CSS,切换预览/源码及刷新后草稿保留,提交后重新构建成功,候选源码与本地 CSS bundle 含本次修改;修改后编辑器锁定,不能追加第二次修改。测试 CSS 使用 h1 选择器,但此原转换标题为 div,因此没有证明可见改色效果,不将其标为视觉通过。
  • 原始 Artifact 关系与修改文件哈希保留;当前源码、原始工程及修改前导出分别核验。导出在新目录安装、构建和启动通过,复用本机 pnpm 缓存。
  • 并发手写/模型修改争用同一额度、重复提交幂等、旧候选拒绝、非法路径、构建失败后保留原版等定向测试通过。此阶段后端全量 419 通过、2 跳过;全量 pyright 仍为原有 6 错误 / 54 警告,新增编辑模块及其测试为 0 错误 / 0 警告,前端 lint / build 通过。

原生输入与版本工作流本次整合

  • UnifiedInputPane 新增工程输入模式,截图、Spec、Figma 分标签整理并联合提交;上传复用 UploadTab 的共享文件读取、Dropzone 和粘贴处理,保留截图校验、缩略图、中文草稿、来源优先级与验收规则。
  • useProjectStore 统一持有实际截图、指令、当前 Run 和工程候选版本;原生 HTML commit 路径继续保留。HistoryDisplay 的版本选择、展开和媒体组件抽为共用 HistoryTimeline,工作台版本直接映射服务端候选快照,切换后源码、预览和下载对应同一版本。
  • 独立浏览器上下文实测真实 PNG 文件上传、携带实际图片的 DataTransfer 拖放及系统剪贴板 Ctrl+V;前两者字节哈希与源图相同,剪贴板重新编码导致字节不同,三者解码像素哈希一致。拖放覆盖浏览器事件路径,未覆盖 Windows 文件管理器鼠标拖动。组合资料刷新恢复、原生 store 状态、键盘选择版本、修改前/后源码与下载、390px 页面无横向溢出均通过,未改动用户原浏览器草稿。
  • 新输入界面真实提交 run_5a5c5fed545b4c8ea134aa0025ffa6ec:截图和 Spec 进入官方 Agent,首轮构建与干净目录导出通过。首轮弹窗的 aria-labelledby 覆盖了 Spec 指定的无障碍名称;通过同一界面提交唯一修复后,累计 2 次模型请求 / 1 次修复。修复后的导出再次在干净目录安装、构建和启动,实测搜索、空状态清除、名称双向排序、详情弹窗名称及打开/关闭、1440px/390px 无横向溢出均通过;保留首轮失败证据。
  • 本阶段前端 lint / build 通过,后端全量再次为 419 通过 / 2 跳过;全量 pyright 仍为原有 6 错误 / 54 警告。视觉人工复核仍未完成,完整 Agent 工具反馈闭环在请求约束下保持未执行。

原生 App/WebSocket 补充对照(2026-11-12)

  • 在本机独立诊断入口加载项目中的真实 App.tsx,实际上传同一截图、填写同一指令、选择 HTML/CSS,经过原生 generateCode、/generate-code 参数解析、提示构造、官方 Agent、工具及流式事件,完成预览和下载。诊断进程只适配单候选、配置模型和请求策略;未将无独立计数的原路由开放到产品后端。
  • 本次基线 native_ui_20261112,Agent 记录 run_20261112_081702_b59724b7:实际 1 次请求 / 0 修复 / 0 重试,create_file 成功,收到 102 个 setCode 事件及完成事件。独立 SQLite 记录保留已占用请求,诊断服务重启后未发起第二次生成。
  • 原生 iframe 中搜索、空结果过滤及恢复、名称升降序、打开详情通过;Close 点击被遮挡失败,Escape 可关闭。该首轮没有独立空状态说明和弹窗无障碍名称。保留这些结果,不用集成修复版本冒充同预算原生结果。完整工具反馈闭环依然 NOT_RUN。
  • 原生 HTML 下载字节哈希与最终流式产物一致;补齐诊断入口遗漏的原生导出路由后,真实 ZIP 下载通过。原生导出器会重新序列化 HTML,ZIP 内 HTML 字节不同;脚本、样式、标签结构及文字一致。初次诊断配置错误和导出回退日志保留,均未重发模型请求。
  • 与集成截图任务首轮(1 请求 / 0 修复)分别在 390×1100、1440×900 比较:本次两者均为双列商品;手机首张卡宽分别为 167px / 159.33px,集成页滚动条占 15px;标题位置、眉题颜色、商品示意 SVG、卡片高度存在差异。原生输出与之前执行层基线也不同,说明单次输出存在变化;不据此计算还原率或宣称效果相同。
  • 代码版本 1e54c1f 再次运行前端 lint / build 均通过。根目录停止、启动脚本实测通过;重启后首页 HTTP 200、浏览器中文工作台恢复原任务及预览,Figma 自动重连为 1 个真实会话。上述结果见本地 native-ui-*.log、release-contract.json 和 release-1e54c1f-*.log,视觉满意度仍待人工检查。

Python 类型检查收尾(2026-11-12)

  • 修复两个 Design2Code 测试文件的 6 个类型错误:真实构建测试使用完整 Settings,先断言资料和资源匹配存在,再读取结果,文件响应路径显式转为 Path。未关闭诊断规则或扩大排除范围。
  • 全量 poetry run pyright 为 0 错误 / 54 个原有警告,退出码 0;全量 poetry run pytest 为 419 通过 / 2 跳过。改动涉及的默认跳过测试另以 D2C_REAL_BUILD_TEST=1 单独执行,真实 Vite 构建、嵌套预览 CSS 图片请求和图片字节一致均通过,1 项通过。
  • 该构建测试使用合成 ZIP 与代码,只证明工程处理回归;真实插件、七模式和模型生成证据仍使用前文各自 Run。该阶段未新增模型请求,未修改工作台运行逻辑或用户数据;日志为本地 type-gate-*.log。

当前官方 Agent 停止与重启恢复(2026-11-12)

  • 专项 Run run_6a9bf36a2b4146c995aa14c50df957d4:先用真实多节点 Artifact 零请求构建,再经工作台发起唯一修复;实际观察到 REPAIRING 和 1 次请求后点击“停止当前任务”,状态变为 UNKNOWN_EXTERNAL,累计 1 请求 / 1 修复。
  • 官方 Agent 记录 run_20261112_083842_e21d36da 的入口为 design2code,实际模型 openai/gpt-6-luna;有一次 llm_call_start,后续收到流式响应和工具事件。停止等待不等于供应商停止处理或未计费;迟到结果没有覆盖原候选,不宣称本次修复成功。
  • 实际执行根目录停止/启动脚本后,通过隔离浏览器恢复同一任务:结果未知提示、原页面内容、工程下载及不再提供修复均通过;请求事件仍只有 1 次,原结果和导出源码/项目文件哈希保持一致。Figma 自动重连为 1 个真实会话,未改用户原浏览器草稿。
  • 本次只验证界面取消后重启;请求进行中强制崩溃未执行。恢复脚本初次误用画板名 Catalog 查找页面标题,超时后按实际源码标题修正;未重发模型请求。证据保留于本地 resilience-*.log/json 与恢复截图,运行数据不推送。

上游来源与许可

  • screenshot-to-code:MIT,保留 screenshot-to-code/LICENSE,基线 a8139779f7c5ae231b7f2a86fa7f83ddc5f7badc。
  • FigmaToCode:GPL-3.0,保留完整 FigmaToCode/LICENSE,基线 f5c4831d5de6cffc19a73fe2823c56b4bb551281。
  • 本次新增的 Bridge 转换适配及提取出的共享导出模块按 GPL-3.0 分发;包含该转换器的插件组合构建不能仅标为 MIT。源码、构建入口和修改说明随仓库保留,原组件版权声明不删除;不提交生成的插件二进制。
  • Bridge 原项目的 MIT 声明保留于 figma-mcp-bridge/LICENSE;内嵌 HTML renderer 的 MIT 声明保留于 figma-mcp-bridge/plugin/src/html-figma/NOTICE。二者从原 Markdown 声明逐字保留为无扩展名文件,满足本仓库仅提交 README Markdown 的规则。
  • 修改范围:从 FigmaToCode 原插件入口提取共享导出函数,原下载功能继续调用同一函数;新增 Bridge 调用、后端产物契约、工作台入口与回归测试。未更改旧 platform 审批流程。

示例对比

以下是使用工作台截图生成 React 页面的一次真实结果。两张图的视口尺寸不同,布局、文字和间距存在差异。

输入截图 生成页面
输入的设计截图 根据截图生成的页面

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages