feat(manual): add the illustrated Web Blender HTML user manual

A single-page 28-chapter manual generated from manual.json covers the
11 workspaces, all React editors, OPFS save/reopen, explicit local
downloads, import/export routes, preferences/keymap and the capability
matrix. It reuses verified course screenshots and adds 14 fresh
Chromium captures for shell, storage, area, camera, preferences, IO and
troubleshooting chapters.

Manual-driven fixes: Save As now states OPFS-only, GLTF import is
restored, quick toolbar honors its preference, startup workspace is
applied, Properties tabs jump to sections, Outliner fallback search
filters, and the editor-header ⋮ opens the area menu. Help and the
tutorial landing link the new manual; the PDF remains as an archive.

Co-Authored-By: Claude Code <noreply@anthropic.com>
This commit is contained in:
mes123456
2026-11-13 11:58:40 +08:00
parent aa8cc1313e
commit b932db7642
37 changed files with 1996 additions and 16 deletions

View File

@@ -231,9 +231,29 @@
- 线上验证(冷缓存):课程页 15 模块/15 模块视频,M01/M15 视频 200;应用 166 s 进入 SceneIR,
4 个区域切换器、区域 ⋮ 菜单可见;服务 active。
### 15. 完整 HTML 用户手册与手册驱动的缺口修复
- 新单页手册 `web/app/public/manuals/index.html`(`manual.css`/`manual.js`/`manual-search.json`/`images/`),
28 章 + 6 部分 + 附录 A/B/C/D;侧栏目录、全文搜索、章节锚点、上一/下一章、打印样式;无内联脚本/样式/远程 URL。
- 源数据 `user-manual/WEB_Blender_Web_Manual_20261113/manual.json` 与 `tools/web/manual/feature-matrix.json`
(31 项可用/部分/仅原生/不可用能力矩阵);生成器/检查器/截图脚本:
`tools/web/manual/{generate-manual.mjs,check-manual.mjs,capture-manual.mjs}`。
- 截图:新增 14 张真实 Chromium 截图(保存 OPFS、最近项目、恢复点、Area ⋮/分割、相机视图、Outliner、
Properties 标签、物理、导入/导出菜单、Preferences/键位、帮助),复用课程/PBR 截图 33 张。
- 手册驱动修复:另存为文案、恢复 `.gltf` 导入、快捷栏开关、启动工作区、Properties 标签跳转、
Outliner fallback 搜索、区域头 ⋮ 菜单;新增/扩展测试:
`user-manual-smoke`, `web-save-download-semantics`, `web-manual-ui-gaps`, `web-preferences`, `web-camera-view`。
- 验证:`node tools/web/manual/generate-manual.mjs` PASS(28 章、14 新图,无缺失);
`node tools/web/manual/check-manual.mjs` PASS(28 章、31 能力、7 gap、无过时下载表述);
组合 E2E **12/12 PASS(1.1m)**。
- 入口:Help 第一项“使用手册(网页版)” → `/manuals/index.html`,保留 PDF 旧版下载;
`TutorialLanding` 同步加入网页版/PDF 两个入口;手册页顶部提供打开 Web Blender、全站课程、PDF 旧版链接。
- 待发布到线上 release。
## 待实现
1. Preferences 仍只覆盖高价值设置;主题/系统/完整键位配置未实现(已在 UI 标注不支持及原因)。
1. 发布包含 HTML 手册与手册驱动缺口修复的新 release,并线上验证 Help 入口/搜索/图片。
2. Preferences 仍只覆盖高价值设置;主题/系统/完整键位配置未实现(已在 UI 标注不支持及原因)。
## 已知限制 / 未验证