Outlook 日程内容富文本字段映射产品方案

版本：v2.0 结构化版本 | 更新日期：2026-07-09

需求来源：需求反馈 / 用户沟通 / 本地代码分析 / Outlook 官方资料

优先级：P1

文档状态：待产品 / 研发 / 测试评审

---

基础信息

需求变更记录

依赖需求 Story 列表

---

一、需求概述

1.1 客户反馈

客户反馈结论： Outlook 日程同步需要支持日程内容富文本与 Outlook 描述字段之间的双向映射，避免同步后正文内容、格式、链接、图片等信息丢失。

1.2 系统现状

1.2.1 现状结论

当前 Office 365 / Outlook 日程同步场景中，需要将纷享日程的「日程内容」与 Outlook 事件的「描述」进行字段映射。两个字段都属于富文本内容，但底层表达方式不同：

1. 纷享日程内容当前使用协同富文本 1.0，能力有限，且后续不再作为主要演进方向。
2. Outlook 事件描述通过 Microsoft Graph event.body 表达，官方支持 text 和 html 两种内容格式。
3. 如果继续基于富文本 1.0 做对接，既难以承接 Outlook 描述里的 HTML 富文本能力，也会把后续维护成本继续叠加在旧链路上。
4. 因此，本期建议以协同富文本 2.0 作为纷享日程内容字段的目标承载方式，再基于富文本 2.0 与 Outlook HTML 描述做映射。

本需求不是简单增加一个字段映射，而是需要先完成日程内容富文本承载方式升级，并明确「纷享富文本 2.0」和「Outlook HTML 描述」之间的共同能力。只有双方都具备的能力，才作为等价映射能力；单侧具备或语义不一致的能力，只能降级或不映射。

1.2.2 纷享本地代码依据

产品判断： 纷享日程内容不是普通字符串字段。当前字段既有明文摘要，也有协同富文本扩展结构；但日程当前仍处于富文本 1.0 形态，能力有限且不再演进。本期不建议继续基于 1.0 做 Outlook 描述对接，建议统一升级到协同富文本 2.0，再建设「富文本 2.0 ↔ HTML」转换能力。

1.2.3 现状截图

Outlook 描述字段	纷享日程内容现状

协同富文本 2.0 参考能力

1.3 竞品现状

1.3.1 Outlook 官方能力依据

1.4 产品价值

1. 支持日程内容在纷享与 Outlook 之间保持可读、可编辑、可同步。
2. 避免 Outlook 描述中的基础富文本格式在同步回纷享时丢失。
3. 以富文本 2.0 作为日程内容后续承载方式，减少继续维护富文本 1.0 旧链路的成本。

1.5 需求目标

1. 将日程内容字段升级到协同富文本 2.0。

- 新建 / 编辑日程时，日程内容使用富文本 2.0 编辑与存储能力。 - 原日程内容的基础展示、编辑、发布、详情展示能力保持可用。 - 存量富文本 1.0 内容需要兼容展示，并在编辑或同步时按规则转换。

1. 支持纷享日程内容与 Outlook 描述字段双向同步。

- 纷享创建 / 编辑日程后，同步到 Outlook 时，Outlook 描述可展示对应内容。 - Outlook 创建 / 编辑描述后，同步回纷享时，纷享日程内容可展示对应内容。

1. 以 HTML 作为双方富文本同步的中间格式。

- 纷享侧需要支持将富文本 2.0 内容转换为 Outlook 可识别的 HTML。 - Outlook 侧返回 HTML 时，纷享侧需要能转换为富文本 2.0 可展示 / 可编辑的内容。

1. 明确富文本 2.0 与 Outlook 描述之间的能力边界。

- 两端都具备且语义一致的能力，纳入等价映射。 - 两端都具备但表现有差异的能力，纳入有限映射或降级映射。 - 只有单端具备，或跨平台语义无法互通的能力，不作为等价映射能力。

1.6 范围与非目标

---

二、产品方案

2.1 整体产品方案

本期方案分两步：

1. 先完成日程内容字段的承载能力升级。 日程内容从当前富文本 1.0 升级到协同富文本 2.0，作为后续与 Outlook HTML 描述字段对接的基础。
2. 再建设富文本 2.0 与 Outlook HTML 描述的双向转换。 纷享同步到 Outlook 时，将富文本 2.0 转换为 HTML；Outlook 同步回纷享时，将 HTML 清洗并转换为富文本 2.0。

flowchart TD
  A[用户在纷享或 Outlook 编辑日程内容] --> B{同步方向}
  B -->|纷享到 Outlook| C[富文本 2.0 转 HTML]
  C --> D[写入 Outlook event.body]
  B -->|Outlook 到纷享| E[读取 Outlook HTML 描述]
  E --> F[安全清洗并转换为富文本 2.0]
  F --> G[写入纷享日程内容]
  D --> H[同步完成]
  G --> H

2.2 具体方案说明

2.2.1 富文本 1.0 与 2.0 取舍

推荐结论：本期应以「日程内容升级协同富文本 2.0」作为前置方案，再建设富文本 2.0 与 Outlook HTML 描述字段的映射能力。

2.2.2 字段映射方案

2.2.2.1 字段关系

2.2.2.2 能力映射原则

1. 共同能力优先。 只有纷享富文本 2.0 和 Outlook 描述都支持，且用户可感知语义一致的能力，才进入等价映射。
2. 内容优先于样式。 当双方表现不完全一致时，优先保证文字、链接、段落层级等核心内容不丢失，再尽量保留样式。
3. 单侧能力不强行映射。 纷享独有的 @ 人、CRM 对象、话题、业务卡片等，不反向生成 Outlook 语义；Outlook 独有的 Office HTML、Loop 组件等，不反向生成纷享语义。
4. 不能映射时必须有降级策略。 降级顺序为：保留可读文本和链接 > 保留为附件 / 链接 > 写入提示文本 > 不写入目标端富文本。

2.2.2.3 双方共同支持，可做等价映射的能力

序号	能力	纷享富文本 2.0	Outlook 描述	映射结论
1	普通文本	支持 text 节点	支持正文文本	双向等价映射，必须保留。
2	段落 / 换行	支持 paragraph / text	支持 HTML 段落、换行	双向等价映射，保留段落和换行。
3	加粗	支持基础文本样式	Outlook 编辑器支持加粗，HTML 支持表达	双向等价映射。
4	斜体	支持基础文本样式	Outlook 编辑器支持斜体，HTML 支持表达	双向等价映射。
5	删除线	支持基础文本样式	Outlook 编辑器支持删除线，HTML 支持表达	双向等价映射。
6	字号	富文本 2.0 工具栏支持字号	Outlook 描述支持字号 / HTML 字号表	待定 双向映射常见字号；无法匹配的字号按相近字号或默认字号展示。
7	字体颜色	富文本 2.0 工具栏支持字体颜色	Outlook 描述支持字体颜色 / HTML 颜色表达	双向映射常见颜色；不要求色值完全一致。
8	有序 / 无序列表	富文本 2.0 支持列表能力	Outlook 描述支持列表	双向映射基础列表；复杂多级样式可降级为基础列表。
9	超链接	富文本 2.0 支持链接能力	Outlook 描述支持链接 / HTML 链接	双向等价映射，只同步链接 URI
10	普通 emoji	支持普通字符输入的 emoji	Outlook 描述支持普通 emoji 字符	双向等价映射 Unicode emoji。
11	图片	富文本 2.0 支持 image 节点	Outlook 描述可承载 HTML 图片，但访问和权限受限	有条件映射：仅在图片可被目标端访问时映射；否则降级为附件或链接。
12	文件	富文本 2.0 支持 file 节点	Outlook 事件支持附件，但不属于描述正文能力	不作为正文等价映射；如已有附件同步能力，则走附件同步。

2.2.2.4 单侧支持或语义不一致，需要降级的能力

序号	能力	支持差异	降级规则
1	下划线	Outlook 支持；当前本地富文本 2.0 代码依据只确认到段落、加粗、斜体、删除线，截图可见工具栏能力但需研发确认模型支持	若富文本 2.0 模型支持则纳入等价映射；否则 Outlook -> 纷享时降级为普通文本。
2	对齐 / 缩进	两端工具栏均可见相关能力，但模型层支持范围需研发确认	支持则映射；不支持时保留段落和文本，不强保留对齐样式。
3	高亮 / 背景色	纷享 2.0 截图可见高亮能力；Outlook HTML 可表达，但 Outlook 客户端表现可能有差异	可做有限映射；失败时降级为普通文本或字体颜色。
4	表格	纷享 2.0 截图可见表格能力；Outlook HTML 可表达表格，但客户端兼容差异大	仅支持基础表格；复杂表格降级为纯文本段落或保留为截图 / 附件。
5	图片	双方都能表达图片，但文件访问权限、临时文件转正式、外部图片加载策略不同	图片可访问时映射；不可访问时降级为附件或链接。
6	附件/网盘	纷享富文本 2.0 有 file 节点；Outlook 附件不是描述正文能力	不写入描述正文；走附件同步或在描述中保留文件名 / 链接。
7	@ 人 / @ 部门	纷享有组织身份语义；Outlook 描述正文没有等价身份对象	降级为可读文本，例如@张三；Outlook 回传不反向识别为纷享人员。
8	话题	纷享有 topic 节点；Outlook 描述没有等价话题语义	降级为普通文本，例如#主题#。
9	CRM 对象链接	纷享侧业务语义强；Outlook 侧没有等价 CRM 对象语义	降级为【对象名称 + 数据名称】的普通文本；
10	音频	纷享旧链路已处理音频；Outlook 描述正文不适合作为音频承载	不做正文映射；降级为附件或文本说明。

2.2.2.5 不纳入本期的能力

2.2.3 产品规则

2.2.3.1 日程内容升级规则

1. 新建日程：日程内容使用富文本 2.0 编辑器。
2. 编辑存量日程：
   • 若原内容是富文本 1.0，进入编辑时转换为富文本 2.0 可编辑内容；
   • 转换失败时保留明文内容，避免内容丢失。
3. 日程详情 / 列表 / Feed 展示：展示效果以富文本 2.0 渲染结果为准；不支持的旧格式按明文展示。
4. 存量数据不做一次性批量迁移，避免影响历史日程；以编辑和同步触发转换。

2.2.3.2 纷享同步到 Outlook

1. 用户在纷享创建或编辑日程内容。
2. 系统将纷享富文本 2.0 内容转换为 HTML。
3. 同步到 Outlook 时，写入 event.body.contentType = HTML 和 event.body.content。
4. 转换过程中遇到不支持的元素时：
   • 文本必须保留；
   • 可读链接优先保留；
   • 不支持的协同语义按降级规则处理；
   • 不允许因为某个格式不支持导致整条日程同步失败。

2.2.3.3 Outlook 同步到纷享

1. Outlook 事件描述为空时，纷享日程内容为空。
2. Outlook 事件描述为 text 时，按普通文本写入纷享日程内容。
3. Outlook 事件描述为 HTML 时：
   • 先进行安全清洗，过滤脚本、外部样式、不可控嵌入内容；
   • 再转换为纷享日程富文本 2.0 内容；
   • 不支持的样式降级为普通文本或基础段落。

2.2.3.4 编辑与覆盖规则

1. 用户在任一端编辑描述 / 日程内容后，按现有同步方向和更新时间规则同步到另一端。
2. 若 Outlook 描述中包含 Teams 会议、在线会议等系统自动生成内容，同步覆盖时不能直接清空或破坏该内容，需保留或合并处理。
3. 若转换失败，系统应保留原始可读文本，不应把目标端字段置空。

2.2.3.5 存量数据兼容

1. 存量日程内容仍按当前方式展示，不做强制批量迁移。
2. 存量日程发生编辑或触发 Outlook 同步时，再按富文本 2.0 规则转换。
3. 若存量 content__e 缺失，应使用 content 明文作为兜底内容。
4. 富文本 1.0 中无法等价转换为 2.0 的内容，按「允许降级」规则处理。

2.3 待确认事项

---

三、规范检查项

3.1 业务文案多语言 Key

无。本需求核心是字段承载与同步映射，不涉及新增业务文案多语言 Key。

3.2 需求埋点

无。当前未提出新增产品埋点要求。

3.3 沙盒 / 更改集能力

不涉及。本需求不新增 PaaS 配置对象。

3.4 PaaS 国际化兼容检查

3.5 新对象 / 新字段 BI 分析申请

不涉及新增对象或 BI 分析字段。若研发评审确认需要新增扩展字段或同步状态字段，再补充申请口径。

3.6 操作日志说明

本期暂不新增用户可见操作日志。后台建议保留富文本转换失败、图片 / 附件降级、HTML 清洗失败等同步异常日志，具体日志字段由研发评审确认。

3.7 需求风险点检测

1. 日程从富文本 1.0 升级到 2.0 可能影响存量展示。 需要优先保证历史日程内容可读，不做不可逆批量迁移。
2. 富文本 2.0 与 Outlook HTML 不完全等价。 本期应保证高频格式和内容可读，不承诺完全还原 Outlook 编辑器效果。
3. 图片和附件边界容易混淆。 用户感知上图片可能在正文中，但技术上可能属于附件或临时文件，需要产品和技术明确口径。
4. Outlook HTML 内容不完全可控。 Office 客户端可能生成复杂 HTML，需要清洗后再进入纷享。
5. 在线会议正文可能被覆盖。 Outlook 自动生成的会议加入链接、Teams 信息等需要保护，避免因纷享编辑描述导致丢失。

3.8 上线策略

3.8.1 收费标准

• [x] 不收费
• [ ] 收费

3.8.2 上线节奏

• [ ] 全网
• [x] 灰度

3.8.3 适用版本

待评审确认。

---

附录：本期结论摘要

1. 本需求应按「富文本字段能力映射」处理，不应只作为普通字段映射处理。
2. 日程内容当前富文本 1.0 能力有限且不再演进，本期推荐升级到协同富文本 2.0。
3. Outlook 侧以 HTML 描述作为主要同步格式。
4. 纷享侧需要支持富文本 2.0 与 HTML 的双向转换。
5. 本期重点保证文本、段落、基础样式、列表、链接、普通 emoji 等高频能力。
6. 图片、附件、@ 人、业务卡片等能力允许降级，不做跨平台语义完全还原。
7. Office 专有 HTML、Loop 组件、脚本、iframe、像素级样式一致不纳入本期。