Interface Lab 功能开发与版本更新记录

Last updated: 2026-05-17

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

记录规则

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

记录模板

## Unreleased

### Supabase Maintenance

- 2026-05-14: Applied remote Supabase migrations through local CLI for project `dsqoqmslquexewtqimyw` (`interface-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。