# SiteForge Enterprise V8.29.0-dev.1 — 主题与编辑器体验优化

**开发基线**：V8.28.0-dev.1 完整源码。此次保留原有后台、静态建站、WordPress 迁移、发布审批、四套移动端抽屉菜单与可选 Tabs、两层组件编辑、公共组件及历史版本。

## 这次有哪些实质变化？

1. 四套内置主题（汽车、工业、企业、简约）升级至 `1.2.0`：优化移动端留白、标题缩放、图片卡片比例、焦点反馈、动作幅度和小屏阅读。不会改变旧站 URL、SEO 数据或已发布内容。
2. 每套主题的原版 `1.1.0` 已保存到 `themes/<theme>/versions/1.1.0/`。**已固定 1.1.0 的网站仍能用相应旧主题构建**；升级到 1.2.0 需要明确应用新主题。
3. 编辑器新增「主题效果」：可比较四套主题 × 六种示例页面 × 三种设备宽度；仅用于比较最新主题示例，不会改动当前页面、主题锁定版本或正式站点。手机端可通过「更多 → 比较四套主题效果」进入。
4. 左侧「添加内容」改成按用途分类并搜索（常用内容 / 图片与展示 / 产品与业务 / 复杂布局），减少从一长串区块中查找的成本。
5. 右侧「样式」增加清爽白底、柔和浅底、重点深底三项快捷方案；基于现有受控的 `background`、`text_color` 和 `padding` 字段，支持撤销/保存草稿。
6. 顶部补充撤销、重做可见快捷入口；手机顶栏两行排布，修复 390px 宽度下「更多」按钮被挤出视口的问题。

## 用户操作路径

- 修改当前页面：进入编辑器 → 点击画布区块 → 右侧修改内容或快速外观 → 查看电脑/平板/手机 → 保存草稿 → 发布设计。
- 对比主题：点击「主题效果」→ 选择主题、页面类型与设备 → 确认后在网站管理中正式应用（预览不会替你更换主题）。
- 发布到正式网站：发布设计并不等于线上部署；仍需静态构建、审批、发布前检查、正式部署与公网核验。

## 执行检查

```bash
python -m compileall -q app
python scripts/verify_release.py
python scripts/http_end_to_end.py
node --test tests_js/*.test.cjs
node tests/test_nested_helpers_v823.cjs
python -m pytest -q tests/test_v829_theme_studio.py
python scripts/regression_v829.py --timeout 45 --group-size 2
# 隔离浏览器：使用真实 HTML/JS/CSS + 测试替身，不会操作真实用户数据
python scripts/browser_studio_v829.py
```

**浏览器验收范围**：真实 Chromium 测试使用编辑器本身的 DOM/CSS/JS，模拟 API 数据；能够验证组件搜索、主题弹窗打开/切换、外观预设、撤销、390px 手机布局，但不等于已登录正式服务器后的浏览器端到端验收。受当前环境管理员策略限制，本轮不能完整访问 localhost / 测试域名进行真实登录浏览器测试。另使用真实 FastAPI + Worker 做了 HTTP/ZIP/预览的独立集成验收。

**生产验收仍未关闭**：Art Design Pro 官方完整项目编译、真实 PostgreSQL/Redis、多 Worker 与远程发布/恢复需在对应实际环境测试；此次不宣称生产级完成。

- 原项目完整回归：**25 批，387 个 Python 用例通过，0 失败批次**（记录在 `reports/v829-regression/`）。
- Node.js 全部已配置测试：**39 项通过**（包含 4 项本轮新测试）。
- HTTP+Worker 隔离 E2E：通过。
- Chromium 隔离交互：桌面与 390px 手机通过，无脚本异常；本机 HTTP 直接访问由于浏览器策略受限，未通过该方式验收。

## 版本及兼容说明

现有 SQLite/PostgreSQL 业务 Schema、草稿结构、接口权限与构建/发布动作未改变。主题 v1.2.0 属于显式版本升级，用户可继续固定 v1.1.0；手动迁移主题后仍应逐页检查自定义内容、图片、移动端样式与 SEO。旧版本目录不得在部署升级时直接删除。