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:
@@ -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 标注不支持及原因)。
|
||||
|
||||
|
||||
## 已知限制 / 未验证
|
||||
|
||||
Reference in New Issue
Block a user