mqc-legal-relation-master v1.0.0A

Immutable. This exact content is served forever at /api/v1/blob/ac9eb600b59ffea7.

---
name: mqc-legal-relation-master
description: 法律关系图大师。把一批案件材料推成一张法律关系图：谁与谁、就哪份合同或哪段工程、发生了什么关系。主体与客体并存，使用者指定的要害以深红标出。布局与走线由索引表查出、判据回读产物验过，出 SVG / PNG / PPTX / VSDX / drawio 五种可继续编辑的源文件，三种风格（奇川风 / 白描 / 歸藏风）每次只出所选的一种。适用于诉前梳理、起诉与答辩的事实部分、庭前准备与向当事人汇报。
tags: [法律, 诉讼可视化, 律师, 法律关系, 制图, 庭前三大法宝]
metadata:
  version: 1.0.0
---

# 法律关系图大师

庭前三大法宝之一。前两件是大事记表大师（时间线）与庭审对抗图大师
（争点攻防），这一件回答的是**结构**：谁与谁、就哪份合同或哪段工程、
发生了什么法律关系。

## 一、这张图画什么

**主体与客体并存。**只画当事人是不完整的——法律关系要靠客体串起来：
「总承包人与发包人**就哪一份合同**」「那份合同**指向哪一段工程**」。
缺了合同与工程，那些线只能标在两个当事人之间，依据与指向全丢了。

```
主体　当事人：原告、被告、第三人、担保人、案外人……
客体　合同、工程、标的物、款项……
```

两者同为模块，靠底色深浅区分，形状一律圆角（奇川风不许直角边）。

## 二、怎么跑

```
数主体数、算最大度、认结构
  ↓
查索引表拿到全部决定（能不能画、用哪档模块、候选网格、各项参数）
  ↓
布局 → 端口规划 → 走线 → 标签
  ↓
渲染 → 判据回读产物 → 不过就换候选
  ↓
所选的一种风格 × 五格式 → 导出物回读
```

**运行时不做推导。**索引是离线跑出来的，运行时只查不算。
1 到 6 个主体查到的是**结果**（143 张图全部穷举过），直接取布局，
0.1 到 0.2 秒出图；7 到 9 查度序列特征组；10 到 16 查结构分档。

### 模型要做的只有三步

```
1　读材料，写 relations.json            格式见 references/relations-guide.md
2　python scripts/make.py relations.json --plan-only      规模判断，一秒内返回
3　两轮提问（见下）拿到 choice.json，然后
   python scripts/make.py relations.json --out 目录 --choice choice.json
```

第 3 步一条命令做完：布局、渲染、所选风格、五种格式、路线判据、
导出物判据、出处索引、交付说明。**不要读 scripts 里的源码，不要另写生成脚本。**
第一次运行前可以跑一次 `make.py --check` 查环境（PNG 渲染器等）。

布局是唯一耗时的环节，结果缓存在输出目录的 layout.json。主体与关系不变时，
改标题、改备注、换风格、导出失败后重来，都直接复用、不再重跑布局。
只有改了主体或关系才会重新布局。

references 目录里除 relations-guide.md 之外都是研发记录，出图时不需要读。

## 二之〇、模块不超过 9 个

**写 relations.json 时就只取要紧的，模块尽量不超过 9 个。**
超过 9 个，布局难度与耗时成倍上升：15 个模块在 Windows 上实测半小时以上，
线也明显更乱。同一个股权案，15 个模块时交叉 14 处；精简到 9 个模块、
12 条关系，6 秒出图、交叉 0 处。关系条数的影响同样大：同样 9 个模块，
17 条关系要 31 秒、交叉 12 处，所以关系也只取要紧的。

万一整理出来超过上限，`make.py` 会停下（退出码 4），先走第〇轮：

```
python scripts/ask.py trim relations.json                               打印问题，照抄给使用者
python scripts/ask.py trim relations.json --keep 编号 --out r9.json       定模块（超过 9 个时）
python scripts/ask.py trim r9.json --keep-edges 编号 --out r9.json        定关系（超过 12 条时）
```

先定模块，再定关系，每一步都只在超限时才问。

模块清单：★ 标出建议保留的，先保当事人，再从相连的里面按关系多少补齐，
保证留下的图连通。关系清单：★ 先保每个模块至少挂一条，其余按
relations.json 里的先后补满（所以关系要按重要性从高到低写）。

同一方向、同一对模块之间的多条关系先自动合并成一条，关系名用「；」
连起来、一个字不删，合并后常常就不超限了。

使用者报编号；**不回答就按 ★**；回答「全部」则不删，照出但会很慢。
留下的某个模块若一条关系都没有，脚本直接报错，不出孤立的模块。
没留下的模块与关系写进出处索引的「未入图」一节，不会凭空消失。

## 二之一、交互：第〇轮（仅超限时）加两轮

**先问，再出图。风格没定之前不渲染任何一种。**不问就动手，
模型会把三种风格全出一遍，额度直接翻三倍，这是实测出来的问题。

问题的措辞由脚本打印，照抄给使用者，不要自己改写：

```
python scripts/ask.py round1                      第一轮
python scripts/ask.py round2 relations.json       第二轮
python scripts/ask.py resolve relations.json --style 编号 --mark 编号
```

**第一轮：交付给谁。**交付对象与风格放在同一个问题里，报一个编号：

```
1　法官（开庭、提交法院、打印）→ 白描
2　当事人与客户（当面讲、微信发）→ 奇川风
3　同行、讲课、公众号（线上展示）→ 歸藏风
4　让我定（按奇川风出，接着问重点）
```

不回答就按奇川风。**每次只出所选的一种风格**，
使用者没有另外开口要，就不出另外两种。

**第二轮：强调标在哪里。选奇川风时才问。**
主体、客体、关系一起编号列出，使用者报至多两个编号，0 为不标。
不回答就一处都不标。本 skill 把强调的选择放在奇川风里：选白描或歸藏风时
不设第二轮，按选入制视同使用者未指定，图上不标强调。

`resolve` 会把回答变成确定的选择，越界一律报错、不猜：
多选风格、白描或歸藏风却带了强调、强调超过两处、编号不在清单里。
出口处还有一道：`export_all` 收到白描或歸藏风的 SVG 却带着强调标记
或深红，直接拒绝导出。

其余的一律不问：模块大小、网格、走线、分页，那些是算出来的。

## 二之二、照录原文，不替当事人改写

这是 V1 定下的铁则，三大法宝一体适用：**主体名与关系名照录源文件**，
只准断行与调整视觉层次，不准改写、缩写、归纳。
「北京某某科技发展有限公司」不能自作主张写成「某某公司」——
当事人的准确名称本身就是法律事实的一部分。

放不下就换行、就加大模块，不靠删字解决。实在放不下的，
写进 provenance 交由人工在渲染前确认，不要静默截断。

**强调是选入制，这是 V1 定下的规矩。**要害由使用者指定，全图至多两处，
节点与关系都算；使用者跳过、说「直接出图」或没回答，这张图就**一处都不标**，
不得由模型自行挑一个来填空。强调在奇川风里是深红实底；本 skill 只在奇川风里
提供指定强调的机会，选白描或歸藏风即视同未指定。

## 三、画不出来的情形要先说

拿到案件先算最大度。**关系最多的那个主体超过 12 条就画不出来**——
单个模块的端口容量是 12（高档模块）或 10（矮档）。这时应当告诉使用者
需要拆图或把几条关系合并表述，而不是硬画一张读不懂的。

超过 16 个主体同理：超出已验证范围，建议按争点拆成两张。

## 四、判据必须回读产物

索引只保证交叉与拐弯的指标，**不保证不穿主体、不贴边、箭头到位**——
那些必须读最终 SVG 的坐标才知道。十三条判据（`scripts/route_guard.py`）
在出图之后跑一遍，不过就换下一个候选网格。

判据本身也踩过坑，记在 `references/INDEX-README.md`：
判据说「有问题」的时候，先确认它查的是不是该查的东西。

## 五、三风格

| 风格 | 用途 | 要点 |
|---|---|---|
| 奇川风 | 彩色母版 | 深红实底标要害，全图至多两处 |
| 白描 | 法庭与打印 | 黑线白底；不提供强调选项，按选入制不标 |
| 歸藏风 | 线上与讲课 | 浅灰点阵底、无衬线、大字轻标题；不提供强调选项，按选入制不标 |

后两种是对奇川风产物的确定性变换，**位置、尺寸、走线一字不差**。
详见 `references/label-spec.md`。

## 六、五种格式

```
svg     母版，可继续编辑
png     交付与插图，规范指定用 Noto Serif CJK SC 栅格化
pptx    每个元素都是原生形状，不是图片，颜色大小位置文字都能改
vsdx    ProcessOn / Visio / WPS 导入编辑
drawio  可在 draw.io 里继续编辑，走线逐点照搬 SVG，配色跟随所选风格
```

一次出齐用 `exports.export_all(svg, base, style=所选风格)`；要看导出物判据明细，加 `return_guard=True`。

PPT 的字体档默认 `safe`（宋体 / 微软雅黑 / Consolas），
交付给律师的文件要在他自己的机器上直接能开。

**导出物也要回读。**三种可编辑格式都从同一份最终 SVG 取几何，
导出后由 `scripts/export_guard.py` 逐个拆开读回、与 SVG 对照：
条数一致（E1）、横平竖直（E2）、拐点逐点对上（E3）、
虚实与箭头一致（E4）、主体块位置尺寸一致（E5）、文字齐全（E6）。

**交付规则**：pptx 与 vsdx 两者都过判据才交；任一未过，
两者一起撤下，只交 svg、png、drawio，并在交付说明里写明未交付的原因。
drawio 未过同样撤下。不拿一份歪线的文件糊弄过去。

改动之后跑三套自检，全过才算没改坏：

```
python tests/export_checks.py      导出物判据、改坏验证、交互边界
python tests/make_checks.py        一条命令出图、缓存、拒绝错误输入、长名称、第〇轮
python tests/layout_regression.py  17 个 6 到 9 主体的案例，与改动前的原版逐例比，不许有一例更差
```

踩过的坑：本 skill 的 SVG 拐角是圆弧（A 命令）、虚线属性用单引号，
而 V1 的解析器只认 M / L / Q 与双引号，直接交过去会让每个拐角
歪成斜线、虚线全成实线。所以交给 V1 之前先经 `svg_geom.normalize` 规整，
V1 本身不动。

## 六之二、交付说明

每次交付都按同一格式写明，由 `scripts/delivery.py` 生成：

```
交付：svg、png、pptx、vsdx、drawio
风格：奇川风
强调：无（使用者未指定）
规模：9 个主体 11 条关系
判据：全部通过
```

四行按重要性排，不写寒暄、不写过程。**强调那一行不能省**——
使用者没指定要害时要明说「无」，这是红色选入制的落实处：
写了「无」，就等于承认这张图一处红都没有，而不是悄悄挑了一个。

## 七、参考

```
references/relations-guide.md  relations.json 的写法（出图时唯一需要读的参考）
references/INDEX-README.md   索引的分段、归并依据与踩过的坑
references/label-spec.md     标注机制：字号、字体、标题、标签、强调
references/scale-table.md    5 到 16 主体、四种结构的基准实测
references/route-plan.md     生成路径的成本结构与参数依据
references/layout-study.md   布局目标函数的研究（含若干负面结论）
references/feasibility.md    索引能做到什么程度的数学边界
```

负面结论也写进去了，省得以后重走：布局目标函数对交叉的相关系数只有
+0.36、格位上预估交叉与实际负相关、双核的平面画法在端口约束下不成立。