76 lines
3.0 KiB
Markdown
76 lines
3.0 KiB
Markdown
# PPT 页面术语改造经验
|
||
|
||
## 背景
|
||
|
||
PPT 编辑场景中，底层实现沿用了 `Frame` 容器模型，但客户看到 `Frame` 会产生理解成本。面向客户的界面应统一使用「PPT 页面」或「PPT」概念，代码层模型仍保留 `Frame`，避免扩大改造范围。
|
||
|
||
## 经验原则
|
||
|
||
1. 客户术语和技术模型分层。
|
||
- UI、tooltip、空状态、确认弹窗、命令面板、图层类型、导出错误等客户可见内容使用「PPT 页面」。
|
||
- 类型名、文件名、函数名、`frameId`、插件内部注释和日志可以继续保留 `Frame`。
|
||
|
||
2. 不做全局替换。
|
||
- 仓库里还有视频首帧/尾帧、`requestAnimationFrame`、内部 Frame 绑定关系等语义。
|
||
- 只改白板容器/PPT 编辑路径，避免误伤视频和浏览器动画逻辑。
|
||
|
||
3. 默认名要兼容旧数据。
|
||
- 旧画布可能已经保存了 `Frame 1` / `Slide 1`。
|
||
- 展示层应把默认名映射为 `PPT 页面 1`，同时保留用户自定义名称。
|
||
|
||
4. 新建默认值应使用新术语。
|
||
- 新建页面默认命名为 `PPT 页面 N`。
|
||
- 重新编号、插入前后页也应继续使用「PPT 页面」命名。
|
||
|
||
5. 空状态图标要匹配业务隐喻。
|
||
- 列表类 icon 容易让用户误解为普通列表。
|
||
- PPT 编辑空状态更适合使用演示/页面图标，并将文案拆成主状态和创建建议两行。
|
||
|
||
## 检查清单
|
||
|
||
- 抽屉页签：显示「PPT 编辑」并使用演示类图标。
|
||
- 搜索框：`搜索 PPT 页面...`。
|
||
- 操作按钮：添加、播放、导出、排列都使用 PPT 页面语义。
|
||
- 空状态：说明当前没有 PPT 页面，并引导用「生成完整PPT」Skill 创建。
|
||
- 右键菜单和确认弹窗：删除、插入、复制等提示使用「PPT 页面」。
|
||
- 图层面板：Frame 类型标签显示为「PPT 页面」。
|
||
- 命令面板：`PPT 页面`、`自适应 PPT 页面`。
|
||
- 工具栏 i18n：`PPT 页面 — F`、`自适应 PPT 页面`。
|
||
- PPT 导出错误：没有可导出内容时提示「PPT 页面」。
|
||
- 画布标题：默认 Frame 标题展示为 `PPT 页面 N`。
|
||
|
||
## 验证建议
|
||
|
||
1. 搜索客户可见旧文案：
|
||
|
||
```bash
|
||
rg -n 'Frame 容器|添加 Frame|搜索 Frame|没有 Frame|匹配的 Frame|可导出的 Frame|自适应 Frame|Fit Frame|Frame Container|当前画布没有 Frame' packages/drawnix/src --glob '!generated/**'
|
||
```
|
||
|
||
2. 保留内部技术语义：
|
||
|
||
```bash
|
||
rg -n 'requestAnimationFrame|targetFrameId|frameId|isFrameElement' packages/drawnix/src
|
||
```
|
||
|
||
3. 做轻量校验：
|
||
|
||
```bash
|
||
git diff --check
|
||
```
|
||
|
||
## 提交备注模板
|
||
|
||
```text
|
||
问题描述:
|
||
- PPT 编辑界面暴露 Frame 技术概念，客户理解成本高。
|
||
|
||
修复思路:
|
||
- 保留底层 Frame 数据模型，仅将客户可见文案、展示名和入口改为 PPT 页面概念。
|
||
- 增加默认名展示映射，兼容旧的 Frame/Slide 默认标题。
|
||
|
||
更新代码架构:
|
||
- 新增统一显示名入口，避免散落硬编码。
|
||
- PPT 编辑面板、命令面板、图层面板和导出提示共享「PPT 页面」用户语言。
|
||
```
|