Files
cms-SiteForge/README_V8_29.md
T
浅念 8884e100f9 upgrade: adopt V8.31.1 (theme 1.3/1.4 redesigns, editor deep-canvas, guided launch, component library)
Overlay 190 upstream items (V8.22→8.31) preserving trade-pro theme,
registry tests, and design docs. Re-applied full patch set on identical
anchors (discovery/env_for/blocks.css/type-mapping/locale-override/
theme_color/frontend entries/test_theme_pro_v3 mods) plus compose pins.

Verified: theme suites 35/35; dual-baseline full run 415 passed vs
pristine 386+29 ours, FAILED-set diff EMPTY (same 10 Windows env fails).
Live: container 8.31.1-dev.1 healthy, hesupipe 192 entries intact,
trade-pro build 203 pages 0 errors.

Co-Authored-By: Claude Code <noreply@anthropic.com>
2026-10-26 09:43:17 +08:00

46 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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。旧版本目录不得在部署升级时直接删除。