Thesis Diagram Rules

Thesis Diagram Rules

毕业论文配图统一规则与画法。所有为论文输出的架构图、流程图、模块协同图、实体关系图、权限分级图、部署图，全部按本文件执行；任何与本文件冲突的"AI 默认审美"一律放弃。

触发条件：用户提到"画图 / 重画 / 出图 / 架构图 / 流程图 / RAG 图 / Dify 图 / 部署图 / 模块图 / ER 图"或要求"更新论文配图、生成图片包、对照规则检查图片"。

1. 配色规范（强制）

绝对禁止：彩色混搭、淡灰、半透明、渐变、阴影、外发光、立体效果。

2. 文字规范（强制）

1. 横纵双向居中：所有文本框内文字必须横向居中且纵向居中。多行时按行高 + line_spacing = 10px 整体居中。
2. 字号下限：默认 40px bold；面板小框最低 34px bold。绝不出现 30px 以下文字。
3. 字体：微软雅黑（msyh.ttc / msyhbd.ttc），加载失败回落 ImageFont.load_default()。
4. 多行表达：用 \n 显式换行，不依赖自动 wrap。手动换行的目的是让每行长度相近，看起来对齐。
5. 图内绝不写标题：题注由正文 **图 X-X xxx** 行承担，图内不重复任何标题文字。

3. 线段与箭头规范（强制）

这一条是历次反馈中最常翻车的，必须逐项核对。

1. 起止点必须落在文本框边的中点：
   • 顶边中点 = (x_center, y_top)
   • 底边中点 = (x_center, y_bottom)
   • 左边中点 = (x_left, y_center)
   • 右边中点 = (x_right, y_center)
   • 不允许从角点、从靠边偏移位置、从框内部出线。
2. 能用直线绝不用折线：
   • 两个框上下对齐（x_center 相等）→ 走垂直直线。
   • 两个框左右对齐（y_center 相等）→ 走水平直线。
   • 起止点不在同一行/同一列时，优先调整框位（移动其中一个框，让它对齐），调完仍不对齐再考虑折线。
3. 所有线段一律正交：只能水平或垂直，绝不允许任何斜线。1 对 1 连线用 1 个 L 形直角；扇入 / 扇出（1 对多 / 多对 1）允许用 Z 形（2 次直角）汇聚到一个"水平 / 垂直母线"上，再统一进/出共同端点；母线必须穿过空白区域，不得叠在文本框上。
4. 线段绝不与文本框重叠：
   • 折线水平/垂直段在选择位置时，必须确保经过路径不穿过任何文本框矩形。
   • 若不可避免，重新规划框位，宁可改布局也不要压字。
5. 线宽：统一 width = 5，颜色 #2563eb。
6. 箭头：实心三角，size = 18，方向由最后一段决定（不要画在中间）。

检查列表（每画完一张图必跑一遍）

• 每条线两端点是否分别等于某个框的边中点？
• 是否存在本可直线却用了折线的情况？
• 是否存在折线穿过文本框？
• 是否存在斜线？
• 是否存在 2 次以上转折？
• 同层级文本框横向是否对齐？

4. 文本框布局规范（强制）

1. 同层级横向对齐：同一层次（同一行角色）的文本框必须 top 一致或 bottom 一致，宽高一致。例如"学生端 / 教师端 / 管理员端"三个框，三者 y1, y2 必须相等。
2. 纵向位置可灵活：不同层级之间纵向间距可按内容紧凑度调整，没有强制等距要求。
3. 统一圆角：所有文本框 radius = 18，统一边线 width = 4。
4. 尺寸建议：
   • 中心顶层节点：高 ≥ 140px。
   • 业务模块节点：宽 ≥ 380px。
   • 多行节点：高度按 line_count * 60 估算，保证文字四周留白。

5. 画布规范（强制）

1. 画布大小：单图宽 ≤ 2100px，长边按内容比例适配，常用 (1800,1080) / (2100,1180) / (1800,980)。
2. 外框：在画布四周留 24px 边距，画圆角外框 radius=24, outline=#dbeafe, width=4，不写任何标题文字。
3. 背景：纯白 #ffffff。
4. 导出：PNG，无压缩损失。

6. 函数实现约定

本项目已有可直接复用的工具函数集合（位于 docs/build_thesis_final.py）：

DIAGRAM_COLORS 字典已定义全部配色，新写图统一引用它。

新增图不要复制粘贴自己写的画图函数：先 import 上面的工具函数（或在临时脚本中直接复用同样定义），保证多张图风格一致。

7. 中点连接的代码套路（务必背下来）

def midpoint(box, side):
    x1, y1, x2, y2 = box
    cx, cy = (x1 + x2) / 2, (y1 + y2) / 2
    return {
        "top":    (cx, y1),
        "bottom": (cx, y2),
        "left":   (x1, cy),
        "right":  (x2, cy),
    }[side]

# 两个框上下相对：直线
start = midpoint(box_a, "bottom")
end   = midpoint(box_b, "top")
draw_arrow(draw, start, end)

# 两个框水平相对：直线
start = midpoint(box_a, "right")
end   = midpoint(box_b, "left")
draw_arrow(draw, start, end)

# 不得已折线：从 A 底边中点出 → 走垂直 → L 拐到 B 顶边中点
sx, sy = midpoint(box_a, "bottom")
ex, ey = midpoint(box_b, "top")
mid_y  = (sy + ey) / 2  # 选择不会压到任何框的位置
draw_polyline_arrow(draw, [(sx, sy), (sx, mid_y), (ex, mid_y), (ex, ey)])

# 扇入：3 个源 → 1 个目标（target_top 中点）。每条都是 Z 形 + 母线在 bus_y。
# 最后一段必须垂直，确保进入目标的方向正交。
tx, ty = midpoint(target, "top")
bus_y = (max(s.bottom for s in sources) + ty) / 2
for src in sources:
    sx, sy = midpoint(src, "bottom")
    draw_polyline_arrow(draw, [(sx, sy), (sx, bus_y), (tx, bus_y), (tx, ty)])

实现新图时优先按"中点 + 直线"先把所有线列出来，发现需要折线就反过来调框位，让它们能直线连通。

8. 图的语义层次约定

为了让全篇配图风格一致，按角色分配颜色：

辅助说明文字（如"反馈教师治理"）允许极少量贴在线段旁，颜色固定 #334155，字号比框内文字小一档。

9. 题注与正文配合规则

1. 题注放图下方，独立成段，格式：**图 X-Y 标题文字**，居中。
2. 图与图之间空一行，下一段为正文引用。
3. 正文必须显式引用图号：例如"图 3-2 给出了……"或"如图 4-3 所示"，不允许只插图不引用。
4. 图号与正文章节配套：第二章配图为图 2-X，第三章为图 3-X，第四章为图 4-X，以此类推。
5. 同一图号在全文中只能出现一次。

10. 输出物组织

每次"画图任务"产出一组文件，命名套路：

绝不直接覆盖 docs/饶纯含--毕业论文_*.docx 原稿，所有图、文字修改一律新发一份。

11. 自检流程（每张图收尾前必做）

1. 把图缩放到 30% 看整体：文字是否居中、颜色是否实蓝白、是否有压字。
2. 放大到 200% 看每条线：起止点是否落在边中点、是否存在斜线、是否存在多余折线。
3. 把所有同层级框的 top 抠出来比对：是否完全相等。
4. 把图丢进 docx 看缩放后效果，文字是否仍清晰可读。

只有 11 步全部通过，图才允许进入交付包。

12. 反例（绝对禁止）

• 内嵌标题如"图 3.1 系统总体架构与模块划分"画在画布上。
• 用渐变蓝、深蓝、浅灰、紫色等花哨配色。
• 文字左对齐 / 偏上 / 偏下，没居中。
• 连线起点是文本框的"右上角"、"右下角"或框内部。
• 明明两框对齐却画成 Z 字折线。
• 折线穿过文本框、压住框内文字。
• 学生端、教师端、管理员端三框 top 各不相同（视觉上参差）。
• 给图加阴影、外发光、立体效果。

13. 历次约定汇总（来源记录）

新一轮如果有补充约定，追加到本表，再同步更新对应章节正文。