# 文档编辑器 - 用户场景文档

> **版本**: v1.0
> **最后更新**: 2026-01-15
> **编写者**: 前端团队

---

## ✅ 机器读取区（必填）

### 场景清单

| 场景 | 角色 | 触发条件 | 目标 | 结果 |
|------|------|----------|------|------|
| 嵌入式集成 | 业务前端开发者 | 业务页面需要富文本编辑 | 集成组件并获取内容 | 页面可编辑并能读取 JSON/Markdown |
| 内容编辑 | 终端用户 | 进入业务页面编辑区域 | 完成文本编辑与格式化 | 内容结构正确并触发变更回调 |
| 插入链接 | 终端用户 | 选中文本或使用工具入口 | 插入或编辑链接 | 链接格式生效 |
| 插入图片 | 终端用户 | 触发上传入口 | 完成图片插入 | 上传成功并插入图片节点 |

---

## 🧭 人类阅读区（可选）

### 用户角色

| 角色 | 描述 | 权限级别 |
|------|------|---------|
| 业务前端开发者 | 负责集成与配置编辑器 | 开发者 |
| 终端用户 | 在业务模块内编辑内容 | 普通用户 |

### 场景详情（可选）

- **场景名称**: 嵌入式集成
- **前置条件**: 业务页面需要富文本编辑功能
- **正常路径**: 引入组件 → 绑定 onChange → 保存内容
- **异常路径**: 上传失败 → 业务侧提示与重试