易读图文转换器

将复杂文字转化为以图文符号为核心的易读内容，提供双通道输出。

快速启动

• 输入 yd 启动
• 输入 y 启动
• 输入 d 启动

双通道输出

每次任务产生两份输出：

执行顺序：先完成对话显示内容的生成与展示，再生成Word文档。

通道一：对话显示（Markdown格式）

直接在对话中以Markdown格式输出易读内容，让用户无需下载即可阅读。

对话排版规范

• 图标系统：大量使用emoji作为图文符号（见下方符码库）
• 标题层级：用 ## 和 ### 分隔章节，标题前加emoji
• 重点标记：关键信息用 粗体 包裹
• 分段规则：每句不超过20字，一句一行（用换行符
或空行分隔）
• 色彩标记：使用Markdown不支持直接设置颜色，改用emoji色彩区分（🔴🟡🟢🔵）
• 列表化：步骤、选择、物品等用有序/无序列表呈现
• 分隔线：用 --- 分隔不同章节

对话输出示例

## 🏥 看病流程

🔴 **重要**：记得带身份证

📝 **步骤**：

1️⃣ 先到挂号处取号

2️⃣ 等待叫号
   🔊 听到名字去诊室

3️⃣ 医生看病后开药

4️⃣ 去药房拿药
   💊 核对药名和数量

✅ **检查**：你知道下一步要做什么吗？

核心符码库（对话版）

通道二：Word文档（.docx）

使用C# + OpenXML SDK生成，符合易读排版标准。

Word排版规范

• 字号：正文14pt以上（Val="28"），标题更大
• 字体：中文微软雅黑，英文Arial
• 无斜体/下划线/阴影，强调用粗体
• 行距1.5倍以上
• 靠左对齐
• 长句分段（每句不超过20字）
• 纯白背景，无水印

Word技术实现

核心设计：RunProperties模板复用

C#模板中预定义12个RunProperties工厂方法，通过CloneNode(true)安全复用：

使用方式：new Run(RpBody().CloneNode(true), new Text("内容"))

关键原则：Emoji和文字必须在不同Run中

• Emoji Run用RpEmoji()或RpEmojiColor()
• 文字Run用RpBody()、RpBoldBody()等

执行流程

第一步：文字提取

用户上传图片时用OCR提取文字，直接提供文字时跳过此步。

第二步：内容分析

识别需转化为符号的信息：动作、地点、时间、联络、物品、数量、警示、步骤、选择。

第三步：文字转化

• 词汇简化为小学四五年级程度
• 每句不超过20字，一句一段
• 主动语态，正面语气
• 每节最多2个重点
• 加入理解检查

第四步：生成对话显示内容

将转化后的内容按"对话排版规范"组装为Markdown格式。

必须遵循：

• 标题前加emoji图标（如 ## 🏥 看病流程）
• 关键信息用 粗体
• 每句一行，不超过20字
• 步骤用数字emoji编号（1️⃣2️⃣3️⃣...）
• 警示用🔴🟡，肯定用🟢✅
• 文末加入理解检查（✅ 检查：你知道...吗？）

输出：直接在对话界面展示完整的Markdown易读内容。

第五步：生成Word文档

以第四步的内容为基础，调用C#模板生成.docx文件。

构建命令：

./scripts/docx build <输出路径>

构建成功后会显示[SUCCESS]，失败会显示错误码和排查建议。

第六步：双通道交付

1. 对话显示内容已在第四步展示完成
2. 提供Word文档下载链接
3. 向用户说明："易读版已显示在上方，您也可以下载Word文档保存或打印。"

内容转化规则

词汇简化

结构简化

• 一个段落 = 一个意思
• 每段最多2句话
• 复杂流程拆成编号步骤
• 选择项用列表呈现
• 重要信息放在段落开头

理解检查

每份易读内容至少包含1-2个理解检查点：

• ✅ 检查：你知道下一步要做什么吗？
• ✅ 检查：你记得带什么证件吗？
• ✅ 检查：如果找不到地方，你可以问谁？

错误码与排查指南

Word生成错误

常见编译错误排查：

• CS1003：中文引号断裂字符串，用\"转义
• CS1056：中文标点出现在参数列表/分号位置，改用ASCII标点
• InvalidOperationException：RunProperties被重复Append到多个Run，改用CloneNode(true)
• missing tblGrid：TableGrid放在了TableProperties内部，应放在Table下作为并列子元素

参考资料