UI DESIGN LAB
  • Home
  • Community
  • Library
  • Knowledge
  • Docs
ZHLogin

Docs

Platform
Site OverviewDevelopment LogCollaboration Guide
Template Library
Prompt BoardStyle Board
Agent Workflow
Agent Deep DiveProject Workflow AgentAgent Output PathPrompt Agent EvalsDesign System PanelsKnowledge Base GuideDeepSeek Agent Incident Notes
UI DESIGN LABDocumentation

Read public Markdown docs; admins can maintain them in editor pages.

Development Log

Development Log

Feature work, version updates, important fixes, permission changes, and release notes.

Back to docs

Chapter preview

记录规则记录模板Unreleased2026-05-17 Project Creation And Community Publishing2026-05-16 DeepSeek Agent StabilityChangedAddedChangedFixedNotes2026-05-10 MVP 基线AddedNotes

UI DESIGN LAB 功能开发与版本更新记录

Last updated: 2026-05-17

这是一份用于实时维护的网站开发日志。它记录 UI DESIGN LAB 的功能开发、版本更新、重要修复、权限变化、文档变化和待发布事项。

记录规则

  • 每次完成一个可见功能、路由、权限、数据结构、生成流程或重要 UI 调整，都在 Unreleased 中追加记录。
  • 每次准备发布时，把 Unreleased 内容归档到新的版本号下，并补充发布日期。
  • 记录应写清楚“用户能看到什么变化”和“维护者需要知道什么变化”。
  • 不记录纯临时代码尝试、失败实验或未落地的想法；这些内容放到 issue、计划或临时笔记。

记录模板

## Unreleased

### Supabase Maintenance

- 2026-05-14: Applied remote Supabase migrations through local CLI for project `dsqoqmslquexewtqimyw` (`ui-design-lab`).
- Future schema changes should be committed as SQL files in `supabase/migrations`, then applied from the repo root with `npx supabase db push --dry-run --yes` followed by `npx supabase db push --yes`.
- CLI login uses a Supabase Personal Access Token on the developer machine. Never commit or paste `sbp_...` tokens; revoke any exposed token immediately.
- Remote migration history had to be repaired because older schema existed while migration records were incomplete. The final remote history is aligned through `202605140001`.
- The workflow Agent migration added `workflow_runs`, `workflow_run_assets`, `workflow_run_versions`, and the private `workflow-assets` Storage bucket with owner-only RLS policies.

### Documentation

- Added `docs/PROJECT_WORKFLOW_AGENT.md` to document the current project creation page and Agent workflow: inputs, modes, realtime SSE events, node routing, revision flow, persistence, Supabase objects, and maintenance rules.
- Added `project-workflow-agent` to the public docs hub and article route.
- Added a Maintenance Memory rule binding the project creation page, Agent workflow implementation, and `docs/PROJECT_WORKFLOW_AGENT.md`; these must be updated together when the workflow changes.

### Added
- 新增内容。

### Changed

- 调整内容。

### Fixed
- 修复内容。

### Notes
- 维护者注意事项。

Unreleased

2026-05-17 Project Creation And Community Publishing

  • /zh/create/new 保持固定左侧 Agent 面板，右侧画布重新布局为 Preview 大窗口优先：Overview、Skills、Design System、网站架构、内容输入、约束和 Full Prompt 围绕 Preview 展开，Code 收进 Preview 内的 代码 / Preview tabs。
  • 网站架构卡片改为 section builder：默认通过加号新增 section，每个 section 可以选择 Hero、Feature、Gallery、Pricing、FAQ、CTA、Footer 等常见类型，并向左连接对应内容输入卡片。
  • Skill 选择从左侧 composer 按钮迁移到右侧 Skills 推荐卡片，Agent 推荐和用户手动选择在同一卡片中合并。
  • Design System 和 Full Prompt 节点改为默认分区块展示；技术栈信息移入 Overview，原技术栈与约束节点改为 Constraints。
  • Agent 对话长文本新增折叠显示，链接在气泡内换行，避免 URL 冲出对话框。
  • 模型选择改为弹出选择器，模型名称统一使用 Pro 后缀。
  • Canvas 连线改为默认可见状态：未生成时半透明，生成中播放输送动画，完成后为纯白色；主线从 Overview/Skills/Design System/网站架构/约束汇入 Full Prompt，再进入 Preview。
  • /zh/account 的 My Projects 新增删除项目和发布到社区操作。发布会创建或更新 community-<generatedPageId> 模板，并复制 HTML、Prompt、Design.md、技能关联和推断标签。
  • /zh/account 调整为账号空间的第一访问入口，专注 My Projects；账号设置拆到独立 /zh/account/settings 页面，右侧提供资源库入口；/zh/admin 入口仅 admin 可见，用于邀请码生成、注册用户权限和内容管理。
  • 社区、首页、Skill、Design System、模板详情、作品和 Agent 预览 iframe 统一为 sandbox="allow-scripts" 且不开放 same-origin，修复 React/Vite、WebGL 和动效类作品发布到社区后的黑屏或效果丢失。
  • 同步更新 README、Progress、Roadmap、Site Concept、Project Workflow Agent 和 Agent Deep Dive 文档，记录新的发布、预览和工作流边界。

2026-05-16 DeepSeek Agent Stability

  • Refactored /[locale]/create/new into an infinite-canvas workflow: left Agent panel remains fixed, right-side cards are created dynamically by SSE node:create, cards can be dragged/resized in React Flow, and card edges only appear when the Agent emits edge:activate.
  • Reworked /[locale]/create/new into Website mode first: the Agent panel now has 网站 / PPT / 移动应用, with Website enabled and PPT/Mobile App disabled as future workflows.
  • Website mode initializes a canvas framework with Overview, Skills, Design System, 网站架构, section-level 内容输入, 约束, Full Prompt, and Preview. Manual right-click card creation and manual handle-to-handle connections were removed from the user path; later 2026-05-17 refinements made Code a tab inside Preview, and made default edges visible, translucent, animated during generation, and solid when complete.
  • Unified the composer so text, links, code, file upload, drag-and-drop files, and pasted images enter through one input area. Uploaded assets render as removable chips.
  • Added workflow artifacts and persistence for site_architecture, content_input, site_template, and workflow_graph on both workflow versions and generated pages, plus PATCH /api/generate/workflow/canvas for debounced canvas-state saves.
  • Reframed Full Prompt as the user-facing Website Generation Template: long production prompts are converted into SiteGenerationTemplate first, then compiled into the final React/Vite code-generation prompt.
  • Documented the DeepSeek long-prompt failure chain in docs/DEEPSEEK_WORKFLOW_INCIDENT.md: provider mismatch, empty JSON responses, oversized direct HTML requests, invalid JSON brief parsing, and root-only blank previews.
  • Added the DeepSeek incident note to the public Docs hub and article navigation so future Agent fixes have a stable maintenance record.
  • Current mitigation keeps using the selected DeepSeek model, avoids JSON parsing in the direct brief step, splits full-prompt output into CSS/body/script, and records the next quality/performance architecture: render QA, model repair loops, fast/high-fidelity modes, background jobs, and per-step telemetry.
  • Optimized the direct full-prompt path: CSS/body model calls run in parallel, static prompts can skip JS generation, prompt font links and must-preserve visible copy/media are carried into assembled HTML, and direct-path SSE nodes start before model generation finishes.
  • Upgraded DeepSeek full-prompt generation to a real React/Vite artifact path: the model returns project files, the server builds them with fixed whitelisted dependencies, inlines the Vite output into html_code, stores project_files / build_log / qa_report, and repairs once on build or static QA failure. The default first pass now uses smaller Hero/Content/CSS stage calls from the full prompt to avoid one oversized empty DeepSeek response.

Changed

  • /zh/create/new 左侧 Agent 栏改成折叠式聊天布局：模型/模式、Skills、素材默认收进底部小图标按钮，中央区域优先留给对话内容。
  • /zh/create/new Agent 工作流改为显式保存：生成结果先作为 workflow version 草稿存在，用户点击 Save work 后才进入“我的作品”；从分析页回到 workflow 后可选择更新同一作品或发布新作品。
  • Agent 生成链路改为 Brief JSON 与 HTML 文本分离：结构化字段先以小 JSON 返回，HTML 单独生成，降低长 HTML 导致 JSON 截断、空响应或解析失败的概率。
  • 文档中心的站点说明文档更新为“网站概述”，正文改为当前版本的功能入口、核心资产、Agent 工作流、权限模型和版本边界总览。
  • 网站概述新增当前网站架构图和核心流程图，并为文档文章页增加 Mermaid 图表渲染支持。
  • 网站概述图表优化为信息架构、创作主流程、服务与数据流三张分层图，并调整 Mermaid 显示为自然尺寸和横向滚动，提升可读性。
  • Prompt Board 和 Style Board 增加独立中文源文件，站点会按 /zh 或 /en 语言路由读取对应版本，并同步文档中心中文标题为 Prompt 看板和 Style 看板。
  • 新增独立 Agent 深度解析 文档，面向零基础读者复盘项目创作 Agent 的界面、SSE 事件、生成链路、素材处理、版本保存、数据模型和项目 review 结论。
  • Agent 深度解析 文档补充后续开发计划，按阶段说明真实风格闸门、QA/自我修复、素材理解、版本回滚、额度账本和评测体系的推进顺序。
  • 文档文章页新增正文左侧自动章节预览，从当前 Markdown 的 H2/H3 标题生成锚点目录，并在空文档时显示空状态。
  • 文档中心和文章页的文档菜单改为分组层级，Template 库下收纳 Prompt 看板和 Style 看板，Agent 文档独立成组。
  • 文档分组菜单增加折叠交互；文章页默认展开当前文档所在分类，文档中心默认展开全部分类。
  • Template 库分组移除重复的 Template 库子菜单项，只保留 Prompt 看板和 Style 看板作为下级文档，并调整二级菜单外框与一级菜单对齐。

Added

  • 新增站内文档页 /[locale]/docs，用于说明网站概述、核心工作流、权限模型和输出结构。
  • 新增网站概述源文件 docs/SITE_CONCEPT.md，作为平台介绍和当前版本说明的长期维护文档。
  • 新增 admin-only 文档编辑页 /[locale]/docs/edit，可直接编辑 docs/SITE_CONCEPT.md。
  • 新增本开发日志 docs/DEVELOPMENT_LOG.md，用于记录功能开发、版本更新和维护事项。
  • 新增 admin-only 开发日志编辑页 /[locale]/docs/edit/development-log，可直接编辑本文件。
  • 新增 POST /api/generate/workflow/save，负责将 workflow version 发布为 generated_pages 或更新已关联作品。

Changed

  • Header 主导航增加 文档 / Docs 入口，并保持现有社区风格。
  • 移动端文档页调整为正文优先、索引随后，和 Skill / Design System 页面体验保持一致。

Fixed

  • 文档页移动端布局经过 Playwright 检查，避免侧栏索引先于正文出现。
  • 长 prompt 多轮追问后会保留最长/最新用户消息；用户明确授权“你设计一套就可以”时跳过重复 intent 追问，直接进入生成。
  • Brief JSON 解析失败时会自动重试一次只返回合法 JSON 的请求，减少 Model response was not valid JSON 的中断。

Notes

  • 文档编辑能力沿用当前权限模型：只有 admin 可以进入编辑页并写入 Markdown 文件。
  • 当前文档写入发生在本地/部署运行环境的文件系统。若未来部署到只读环境，应迁移到数据库、CMS 或 GitHub-backed 编辑流。

2026-05-10 MVP 基线

Added

  • Next.js + Supabase MVP 基础能力完成。
  • 公开模板库、Skill 库、设计系统页、账号页、登录页和后台入口可用。
  • Pro/admin 权限用于解锁完整 Prompt Skill、下载和生成能力。
  • Agent 项目创作工作流初版上线，支持 brief、设计系统、Skills、完整 prompt、代码和预览输出。

Notes

  • 详细历史可参考 docs/PROGRESS.md 和 docs/PROJECT_HISTORY.md。