# OpenDesign 融合记录

日期：2026-10-17。

本次融合保留 EAC 的 Node、FFmpeg、Playwright 和 Harness 插件结构，导入 OpenDesign 的内容库并接通设计工程、隔离预览、导出及原生右侧画布。没有把上游完整桌面应用嵌套在插件中。

## 已接入

- 152 套设计体系：说明、令牌、真实 CSS、字体栈、组件示例和预览资源。
- 517 个模板条目：188 个示例、115 个设计模板、63 个视频模板、45 个图片模板、58 个视频提示词、48 个图片提示词。
- 169 项创作技能、13 个基础组件、14 个场景，总计 865 个条目。另保留 EAC 原有 17 个视频选项。
- 正常、剪辑、Design 三种模式；Design 下有网站/原型、动效、幻灯片、文档、图片类型。
- 输入框下方推荐区与完整模板库；选择只写入草稿，不发送消息。正常→剪辑→正常→剪辑能恢复推荐。
- 会话模式、模板和设计体系保存，并按当前会话组装 AI 上下文；提供 `library_list`、`library_read`、设计工程和成品保存工具。
- 使用 Harness 官方 `sidebar.right.pane.tab` 注册 `eac-canvas` 页面；复用宿主分栏、停靠和全屏机制。没有会话侧栏存储时使用可关闭的临时面板。
- 视频输出、HTML 网页、HTML 幻灯片分页、SVG、Markdown 的作品画布，按版本保存与读取。
- HTML/SVG 实时预览、不可变修订、并发冲突保护、中文文件名下载。
- PDF、PNG 导出；HTML 幻灯片的 PPTX 整页图像导出，原 HTML 保留文字/图形编辑能力。
- 制作工作台的多轨时间线编辑：开始时间、素材入点、时长、音量、轨道、添加/删除和修订检查。
- 设置页工作台改用顶部导航；编辑器提供预览、源码、并排三种显示方式，窄面板默认预览。

## 视频运行适配

确定性渲染支持原有 `renderAt(t)` / `__seek(t)`、OpenDesign 的 `window.__timelines`（包括多个 GSAP 时间线）和 CSS 动画时间定位。渲染前暂停自动播放，保留同一时刻复现检查和 FFmpeg 技术质检。

已实际将 `od-vt-frame-bold-poster` 渲染为 2 秒、12fps、480×270 的 H.264 MP4：24 帧，确定性检查像素完全一致，无缺失素材，技术质检通过。它是模板原示例验证，不是按用户简报定制的交付视频。

源文件包含 `__VIDEO_SRC__` 等占位符或 `data-composition-src` 子合成的条目会标记依赖，不能直接被当成可用成片。远程 Seedance/Veo/图像模型与 HyperFrames Electron 子合成引擎没有整体搬入。

## 来源和许可证

来源：<https://github.com/nexu-io/open-design>，包版本 `0.25.1`。导入内容摘要记录在 `vendor/open-design/PROVENANCE.json`。快照没有 `.git`，不宣称已独立验证某个 git commit；导入器以文件内容摘要固定本地材料。

上游仓库 Apache-2.0，具体条目包含 MIT、Apache-2.0、CC-BY-4.0 等独立条款。原始许可、作者和来源保留在 `catalog.json` 与目录内说明。两项仅引用原始社交帖子、没有标准许可的内容标记为不可再分发参考，不赋予其媒体再分发权。更多说明见 `THIRD_PARTY_NOTICES.md`。部分源文件内含 GSAP，继续遵循源文件保留的 GreenSock 标准许可；不将这部分一概称作 MIT 或 Apache。

## 验证

- `npm run build`。
- `npm test`：完整回归 101 项通过；随后新增的宿主上下文隔离测试及最终 50 项设计/导出/内容库/插件测试通过。覆盖视频解码、剪辑、混音、旁白、转录、字幕、取消与恢复，以及设计工程、内容路径、许可、模式、宿主注册、导出。
- 最终构建通过，独立预览服务 `http://127.0.0.1:4174` 返回 534 个模板（原有 17 + 导入 517）、152 套设计体系和 169 项技能。
- `node scripts/verify-open-design.mjs`：使用真实目录数据验证搜索、体系 CSS 起始文件、实时预览、修订保存、600px 排版、画布和剪辑模式恢复。模式验收使用 `tests/fixtures/composer.html` 模拟官方槽位，脚本自行启动与关闭独立端口的 Vite 服务。
- `tests/design-export.test.mjs`：生成真实 PDF、PNG 与两页 PPTX，核查文件头和 PPTX 内部幻灯片结构。
- 结果与界面截图在 `artifacts/open-design-qa/`。宿主实际桌面调试端口不可用，因此未把模拟槽位验收表述成实际桌面点验。

## 启用与当前边界

现有 4173 服务由 Harness 桌面进程持有，旧 Node 模块不会因为磁盘文件更新自动热重载。本次未结束或重启用户桌面进程。构建产物已更新；重新加载本插件/桌面客户端后会加载新增后端和侧栏依赖。验证服务使用独立端口，未覆盖用户生产项目。

- HTML 幻灯片可以分页预览并导出 PPTX；任意现有二进制 PPTX 的逐元素解析、编辑和预览尚未接入。
- 模板目录中的存在数量不等于所有项目均已执行验收。205 项需要外部生成，其余还可能需要用户素材、子合成运行时或外部资源。
- 未搬入 OpenDesign 的全部远程模型供应商、账户、插件市场运行时、数据库、终端和 Electron 基础设施。
- 本次未提交 git、推送或发布；工作区原本没有提交基线，不能用普通 git diff 代表本次全部改动。