文档(载体默认换代批·用户裁): 图优先载体默认 HTML+SVG——AGENTS.md 载体句换代(默认 visualize 技能 HTML/SVG 内联渲染·流程结构图与空间对比像素示意同一通道·无内联渲染退 Mermaid·再退字符画)+doc-conventions §3 流程行换代(默认文档内嵌 HTML/SVG 表现力优先·图体行数计入节点篇幅·过滤型网页端改 Mermaid·无渲染环境字符画)+节点内顺序句随改;2026-10-31 用户裁,理由=表现效果更好,接受网页端过滤内嵌 SVG 与 git diff 可读性代价

design/engineering/doc-conventions.md

@@ -30,11 +30,11 @@
 |---|---|---|
 | 规则的来龙去脉、行为逻辑 | 散文段 | 每段 ≤240 字，一段一件事 |
 | 枚举、数值、边界、依赖 | 表格 | 表格只放可列举的事实；禁把需要解释的内容塞进单元格让读者自己拼 |
-| 流程、状态流转、结构关系 | 字符画或 Mermaid 代码块 | 禁用散文逐步描述流程；多分支状态机、实体关系、模块依赖这类复杂结构图优先 Mermaid（源码即文本，查看端不渲染也可读可改），简单线性流程与无渲染查看环境用字符画 |
+| 流程、状态流转、结构关系 | 文档内嵌 HTML/SVG（默认）· Mermaid（网页发布保底）· 字符画（无渲染环境保底） | 禁用散文逐步描述流程；默认在文档内嵌 HTML/SVG（表现力优先，本地预览即渲染，图体行数计入节点篇幅）；发布到会过滤内嵌 HTML 的网页端时改 Mermaid；无渲染查看环境用字符画 |
 | 公式 | 结论先行 | 先一行加粗结论，再放公式代码块、变量表与验算表 |
 | 体验锚点 | 关键词表 | 支柱/关键词/机制承诺 三列表，禁长篇情绪描述 |
 
-节点内顺序：先人话，再表格枚举，再流程图（字符画或 Mermaid），最后公式举证。**规则两段式**：先写"人话阶段"（作用于哪个系统、什么情况下、谁触发、触发后发生什么），再写"举证阶段"（逐效果给出计算方法；纯流程规则明写"无计算"）。规则名禁止纯名词短语（反面例："获取路由"）。
+节点内顺序：先人话，再表格枚举，再流程图（内嵌 HTML/SVG 或字符画），最后公式举证。**规则两段式**：先写"人话阶段"（作用于哪个系统、什么情况下、谁触发、触发后发生什么），再写"举证阶段"（逐效果给出计算方法；纯流程规则明写"无计算"）。规则名禁止纯名词短语（反面例："获取路由"）。
 
 ## 4. 用语纪律（见名知意 · 所见即所得 · 禁自造黑话）