new-litigation-visualization

Litigation visualization, made deterministic. Seven installable skills that turn case files and legal data into court-ready figures, charts and tables. The model only reads meaning; every coordinate, size and character budget is computed by deterministic scripts from the physical size of an A4 sheet. Text on a figure is always a subsequence of the source sentence, and every element traces back to the document and sentence it came from. MIT licensed, no network calls, works with any agent that reads SKILL.md.

为什么做这件事

诉讼可视化的价值，法官与当事人都验证过。 一页时间轴省下的是庭审上十分钟的口头梳理； 一张法律关系图让当事人第一次看懂自己案子的结构；一份大事记表让合议庭不必在几百页卷宗里 反复翻找。这些不是美工问题，是沟通效率问题。

法律 AI 的难点不在会不会画，而在能不能交。 大模型画图容易，问题是三条：改字（把 「不予支持」写成「予以支持」）、不可复现（同一份材料两次不一样）、不可追溯（图上一句话 问不出它出自哪一页）。法庭材料对这三条零容忍。

这个项目的做法是把作图拆成两段。 模型只做语义判断：哪一句是已经发生的事实、哪几句 属于同一件事、谁与谁成立何种关系。位置、尺寸、层数、每张卡片能写几个字，全部交给确定性 脚本，从 A4 纸的物理尺寸一路算到像素。难的那部分不在模型手里，所以同一份材料换谁跑、 跑几次，出来都是同一张图，换一个更弱的模型也一样。画图不是把法律变轻佻，而是把思考 变透明。

四条设计原则

原则 · 落点 确定性渲染 · 模型只出一份 JSON，几何全部由脚本算。布局可复现、可缓存、可逐字节比对 照录原文 · 图上每段文字必须是原句的子序列，只许删减、不许改写；改一个词都会在出图前被拦下 A4 是前提 · 版面从纸的物理尺寸算起，不是导出选项。插进 Word 直接能印，白描一档可交法院 判据先行 · 每条已修复的问题固化成守卫，且每条守卫都必须能失败：加守卫要先把代码改坏，确认它真报错

七个模块

· 模块 · 版本 · 回答什么问题 · 输入 · 交付物 · V1 诉讼可视化重画 · v1.1.0 · 这张图怎么画得能进卷宗 · 一张已有的图（手绘、截图、AI 生成、Mermaid），或一段纯文字 · SVG · PPTX（默认）；PNG · VSDX · drawio 可选 · V2 时间轴大师 · v2.1.0 · 案件经过是怎样的 · 判决书 · 起诉状 · 答辩状 · 合同 · 证据目录 · 流水 · 聊天记录（PDF、老式 .doc、扫描件、照片、口述） · 同上 + 溯源索引 · V3 法律关系图大师 · v1.0.0 · 谁与谁、就什么标的、成立何种关系 · 一批案件材料 · 同上 + 出处索引 · V4 大事记表大师 · v1.0.0 · 什么时候发生了什么 · 一批案件材料 · 案件大事记 Word · Excel 母表 · A4 简表（默认）；简表 PDF/PNG 可选 · V5 庭审对抗图大师 · v1.0.0 · 谁主张什么、对方怎么抗辩、法院审查什么 · 起诉状 · 答辩状 · 证据目录 · 代理意见 · 分析表 Excel · 对抗图 SVG（默认）；PNG 可选 · V6 法律图表大师 · v0.9.8 · 有多少、占几成、判了多少、钱流向哪里 · 一组法律数据（判决结果、案由、金额、天数、去向、资金流水） · SVG · PPTX（默认）；PNG 可选 · V7 法律课件大师 · v0.8.4 · 这些图怎么做成一页能上讲台的法律图表页，粘进自己的课件 · V1–V6 的图、法条与案例、一句想法、律所模板或截图（可选） · 可编辑 PPTX（整页或框选复制；图里每个元素各成一组，按读图编号自带讲课动画）

三组用法，V3 是交叠处。

• 三大主力（V1 到 V3）· 日常出图：把手上已有的图重画干净、把案件经过画成时间轴、

把当事人与标的之间的关系画成一张网。

• 庭前三大法宝（V3 到 V5）· 开庭之前：回答开庭前必须回答的三个问题：结构（V3）、时序（V4）、

争点（V5）。V4 出的案件事实底稿是另两件的上游，三者读同一份底稿，同一件事在三张图上 指向同一个编号。V3 同属两组，既是日常出图的主力，也是庭前准备的一件。

• 课件组合（V6、V7）· 讲课与汇报：V6 只画数字（有多少、占几成、判了多少），主要去处是课件、

讲座与汇报；V7 不画新图，把 V6 的图表与 V1–V5 的图排成课件，只读它们，不改它们一个字节。

各模块在做什么

V1 诉讼可视化重画。 先做源图预检：矢量原件与有文字层的 PDF 直接放行，位图与扫描件 会先说明代价再问你是否继续（读图慢、贵、易读错）。七种版式按判据自动落档，事件多到横向 排不下时自动改用 A4 竖版。三种风格：奇川风（当事人）、歸藏风（讲课与公众号）、白描（法院）。

V2 时间轴大师。 直接读材料：有文字层的 PDF、老式 .doc 一条命令读入，扫描件走读图三步。 逐句判定哪些是已经发生的事实，按四轮勾选收窄范围，再由代码算形态与每张卡的字数容量。 出图同时写溯源索引，图上每一项对得回材料的哪一句。

V3 法律关系图大师。 主体与客体并存的关系网，走线全部正交、判据 15 条（穿节点、共线 重叠、圆角方向、文字越出画布、图名被压、文字互相压……），不合格的布局在候选阶段就被换掉。

V4 大事记表大师。 一次出三件：Word 交付版（宋体加新罗马、页边距与列宽按规范定死）、 Excel 母表（律师在里面填争点）、A4 简表（呈报用）。事实行走封闭动词表，不合规的写法出表前 被拦。它同时生成案件事实底稿，供 V3 与 V5 复用。

V5 庭审对抗图大师。 按要件审判九步法与请求权基础，把案件推成左中右三栏：提出请求的 一方、法院审查、抗辩的一方，深红标出决定性要件。图与表同源，一致性由判据核验。

V6 法律图表大师。 九种精炼的统计图：竖柱、横条、百点方阵、南丁格尔玫瑰、哑铃、逐件分布、 桑基、汇入图（资金流向）、逐级加减，图种由数据形状决定。背后是一个按领域、场景、意图、画法索引的 场景库（34 个领域、410 个场景、63 种画法；现在能画的场景 170 个，其余标「待建」），用时按关键词检索，只取用得上的几条。 前五件厚重严谨，这一件广泛灵动：旅程、倒计时、冰山、拼图、金句卡……灵动在表达，严谨在数据。 丢一批判决给它，走类案编码：逐份编码、类别取封闭表、每个值附原文引句，一次出编码母表和一组图。图上的数只许算、不许编：标题里写的百分比与件数，脚本都会从数据里 算一遍；没有 n、口径与来源的图不出。

V7 法律课件大师。 法律垂类的磁吸课件编辑器。一页 12 栏 × 6 行的网格，法条、裁判要旨、案例、争议焦点、风险提示、 证据、要点、大数字、金句等卡片，和 V1–V6 的图（案情时间轴、法律关系图、争点对抗图、大事记简表、类案数据图），拖进页面就吸到 格子上，同类卡片自动连成一组（学自 M3E Canvas 的磁吸连接）。律所名片录一次，一键生成律所介绍页、律师简介页、结束页， 每页页脚可放 Logo。用户点「AI 生成」写一句想法，由对话里的 AI 生成封面、整页、单张卡片，或调用 V1–V6 出图；用户拖一拖、 改一改，导出每个元素都能改的 PPTX（只有 Logo 是图片）。上传律所自己的 PPT 模板，系统读懂它的主色、字体、Logo，生成律所风格，图表也跟着换成律所主色。法条与要旨照录原文、案号不编、大数字要能由图表推出；导出后回读审计。

怎么配合

从手上的材料、要办的事出发：左边是手上有什么，中间用哪几个模块，右边拿到什么。

要办的事 · 手上有 · 用 · 拿到 图要交得出去 · 手绘、截图、AI 生成的图 · V1 · 可编辑的 SVG、PPTX；白描一档可交法院 理清案件经过 · 判决书、合同、流水、聊天记录 · V2 · 时间轴，加溯源索引（每一项对得回原句） 理清法律关系 · 判决书、合同、工商登记 · V3 · 关系图，加出处索引 整理案件事实 · 整套卷宗 · V4 · Word 交付版、Excel 母表、A4 简表 推演庭审攻防 · 诉辩材料与证据 · V4 → V5 · 对抗图，加 Excel 分析表 庭前全面准备 · 整套卷宗 · V4 → V3 + V5 · 大事记、关系图、对抗图，同一套编号 用数据说话 · 判决、案由、金额、流水 · V6 · 一页统计图，标题里的数都算得出 做一堂课 · 一组数据，加画好的图 · V6 → V7（V1–V5 的图也排进来） · 一套课件，导出可编辑 PPT 向委托人汇报 · 一个案件的卷宗 · V4 → V3 + V5 → V7 · 一套汇报 PPT

箭头只表示读谁的产物：下游模块读上游写好的文件（事实底稿、图、出处记录），不改上游一个字节。 每个模块也都能单独用，不必按顺序装齐。

装在哪都行。 七个模块都是标准的 SKILL.md 目录，没有产品特定的胶水代码：Claude Code、 Codex、DeepSeek Harness、Cursor、Gemini CLI、Copilot、Cline、Aider 都装得上。同一份仓库， 不维护两套。

快速开始

Claude Code：

/plugin marketplace add MiaoQichuan/new-litigation-visualization
/plugin install mqc-nlv@mqc-nlv

装完跑一次环境自检，它逐项告诉你缺什么、缺了会退化成什么样（没有一项是装不上， 都是少一种格式）：

python3 plugins/mqc-nlv/skills/mqc-litigation-visual-redraw/scripts/doctor.py

然后把材料丢给 agent，用中文说一句要什么即可，例如：

用时间轴大师，把这份判决书画成案件经过时间轴，交当事人看

DeepSeek Harness：挂目录即可，不必构建（它的技能发现是扁平的，指到 skills/ 这一层，会扫到下面每一个 /SKILL.md）：

skills:
  local:
    customSkillDirs:
      - "./new-litigation-visualization/plugins/mqc-nlv/skills"

dsh 的发现优先级（先命中先生效）：项目 .dsh → 项目 .agents → customSkillDirs → 用户 .dsh → 用户 .agents。它把 allowed-tools / disallowed-tools 当未知字段处理， 技能内的工具约束需要在 harness 层自行保证。

桌面办公智能体（WorkBuddy、千问、Codex、Claude 等）：在「技能」页选「上传技能」， 把技能包拖进去。仓库 plugins/mqc-nlv/skills/ 下的每个文件夹就是一个技能包，按需打包上传。

技能市场：在 缪奇川的 SkillHub 主页 找到要装的技能， 复制技能页上的安装提示词，发给能执行命令的智能体。

其他 agent：把模块目录放进它们各自的 skills 目录，SKILL.md 是通用格式。

各种装法的演示见 项目主页。

环境与依赖

能力 · 需要什么 · 缺了会怎样 出 SVG 与 PPTX · Python 3，零第三方依赖 · 不会缺 —— 这也是默认交付的两种 出 PNG · Inkscape / rsvg-convert / LibreOffice / resvg-js / Playwright 任一 · 跳过 PNG 并说明怎么补，其余格式照出 流程图与关系图定位 · graphviz 可选 · 没装时由内置分层排布算坐标，实测画布相差 2 像素 Excel 母表与分析表 · openpyxl · 出表那一步开跑前就提示，不会跑到一半崩 大事记的 Word 交付版 · node 与 docx 包 · 改出同内容的 Markdown，Excel 与简表照出 读扫描件 · poppler 的 pdftoppm · 明说无法读图，不静默跳过

仓库结构

new-litigation-visualization/
├── assets/                                  仓库封面、模块图标与配合图
├── .claude-plugin/marketplace.json          插件市场清单
├── .github/workflows/checks.yml             每次 push 与 PR 跑七个模块的回归
└── plugins/mqc-nlv/
    ├── .claude-plugin/plugin.json           插件清单（插件版本只在这里声明）
    └── skills/
        ├── mqc-litigation-visual-redraw/    V1 · 共享内核所在
        │   ├── SKILL.md                     技能主文档
        │   ├── references/                  规程与标准（含 5 KB 速查页 quick-map.md）
        │   ├── scripts/                     确定性渲染管线
        │   │   ├── render*.py               七种版式 + 纵向形态
        │   │   ├── export_{pptx,vsdx,drawio}.py   可编辑格式导出
        │   │   ├── source_check.py          源图预检（位图先说明代价）
        │   │   ├── layout_fallback.py       没有 graphviz 时的内置分层排布
        │   │   ├── raster_fallback.py       没有转图工具时的 resvg-js / Playwright
        │   │   └── checkpoint.py doctor.py  确认清单与环境自检
        │   └── schemas/ examples/ assets/ tests/
        ├── mqc-timeline-master/             V2
        │   ├── references/                  约束表（69 条编号约束，条条有实测数字）
        │   ├── scripts/                     四轮勾选 → 逐句判定 → 形态与容量 → 出图
        │   │   ├── read_source.py read_doc.py   材料读取（PDF 文字层 / 老式 .doc）
        │   │   ├── render_multiband.py render_vcolumns.py  横向多泳道 / 纵向
        │   │   └── pipeline.py              管线入口，含计时账
        │   └── docs/adr/ schemas/ examples/ assets/ tests/
        ├── mqc-legal-relation-master/       V3
        │   ├── scripts/                     布局求解 · 正交走线 · 15 条路线判据
        │   ├── assets/                      度序列查表（代码用，模型不必读）
        │   └── vendor/v1/                   单独分发时随包带的共享内核
        ├── mqc-chronicle-master/            V4
        │   ├── scripts/                     摄入 · 校验 · Word/Excel/简表
        │   └── references/ docs/adr/ examples/ tests/
        ├── mqc-trial-confrontation-master/  V5
        │   ├── scripts/                     要件推演 · 三栏出图 · 光栅
        │   └── references/ examples/ tests/
        ├── mqc-legal-chart-master/          V6
        │   ├── scripts/                     校验与派生数 · 九种图 · 守卫
        │   └── references/ docs/adr/ examples/ schemas/ tests/
        └── mqc-legal-courseware-master/     V7
            ├── scripts/                     拼页 · 图导入 · PPTX 导出与审计 · 编辑器
            ├── web/                         磁吸编辑器（单文件）
            └── references/ docs/adr/ examples/ tests/

共享内核只有一份。 几何、字体、换行、导出这些多模块共用的代码放在 V1，别的模块引用 它、不许各自分叉。单独分发时按各自约定随包带一份，并由守卫逐字节比对，防止两边走偏。

两个模块的细节

V1 诉讼可视化重画

把一张凌乱、或者一眼「AI 味」的诉讼图，重画成克制、专业、可直接进诉讼材料的图， 源文件一并交给你，回头还能接着改。律师只做两件事：上传原图，说一句提示词。

三类七种布局

时间、流程、关系。诉讼里要画的东西基本都落在这三类里，图种不由你选，由材料的性质决定。

七种布局 × 三种风格

同一份语义地图，换一个风格标志就换一套表达，几何一个数都不动。

· :--: · :--: 日期型时间轴 · 期间型时间轴 编号型时间轴 · A/B 对比表 关系网络（密集） · 层级树 关系网络 · 流程图 · 流程图（合同审查）

三种视觉风格 · 点开看完整对照（奇川风 · 白描 · 歸藏风）

三种风格共用同一套几何：圆角多大、连线多粗、卡片怎么错开、字号怎么分层，全都 一模一样，变的只是表达。所以换风格不会改变图的结构，也不会让某一版排得更松或 更挤。下面三张长图分别是三套完整的视觉规范，每一个数值都写在上面。

奇川风 — 灰阶为底，一处深红标重点，向委托人与法官呈现。

白描 — 纯黑白线稿，专为打印与卷宗，复印、传真都不失真。

歸藏风 — 克莱因蓝，用于对外传播、讲课与分享。

模块完整说明见 它自己的 README。

V2 时间轴大师

不用你先画。把判决书、起诉状、答辩状、合同、证据目录、流水、聊天记录、扫描件、 手机照片、甚至一段口述丢给它，它读完最多问你五个问题，然后出图。

时间轴大师，用数学，画准一张时间轴。

用数学算清楚一张时间轴怎么画

一张 A4 有多宽是定死的。时间轴上有几个时点，轴就被分成几段，每一段的长度决定了 模块落在哪里；位置定住才知道相邻两块之间还剩多少空，剩多少空决定一块能有多宽， 宽度定了才知道这一块能写几个字。先定位置，再定尺寸，最后才定能写多少字。 下面这张长图把这条链路和两道几何门禁逐步拆开讲了一遍。

02 画准 · 前端负责读懂，后端负责算准（点开看长图）

一张图画不准，无非两件事出错：该画的事没抽对，或者抽对了却排不下。所以这里分成 两段各管一件，中间只交接一个数。前端从材料里把有法律含义的事实抽出来，交出一份 事项清单；后端按这一档的几何算出每一块能写多少字，把这个数交回去；前端再按这个 数把字写到位。反过来先写好再排，就只剩两条路：把字截掉，或者把版面挤坏。

这张长图还讲了忠实性怎么验：卡片上每一段文字都必须是原句删掉一些字之后剩下的 样子，换一个词、调一次词序、补一个字，都会在出图之前被拦住。

03 使用手册 · 材料怎么给、它问什么、你拿到什么（点开看长图）

材料怎么顺手怎么给，不用先整理、不用改格式、不用自己先画一张。它读完最多问你五个 问题，该问的才问：只有一份材料就不问第一问，日期不足八个就不问第二问，风格不是 奇川风就不问标红。问完就出图，之后不再打断你。

这张长图逐一列出了它吃哪些材料、三种形态各自用在什么场合、泳道怎么分、五种交付 格式分别用什么软件打开，以及那份 Word 溯源索引长什么样。

模块完整说明见 它自己的 README。

常见问题

装与跑

我不会写代码，能用吗？ 能。你只需要把材料丢给 agent、用中文说一句要什么。全程不写代码、不改配置、 不学任何语法。

它要联网吗？我的案卷会不会传出去？ 七个模块都不联网、不调外部接口、不需要任何凭据，只读你给它的材料，只往你指定的 目录写文件。你的材料本身去了哪里，取决于你用的那个 agent 怎么处理， 与这些模块无关。

要装什么？会不会很麻烦？ 重画与时间轴大师：Python 3（零第三方依赖，graphviz 也不再必需 —— 没装时由内置 分层排布算坐标，实测画布与装了的版本相差 2 像素）。庭前三大法宝另需少量第三方库（如 openpyxl、cairosvg，大事记表出 Word 还需 node），各自的 SKILL.md 列明；法律关系图大师可以先跑 python scripts/make.py --check 查环境。出 PNG 需要 LibreOffice 或 poppler，读扫描件需要 poppler 的 pdftoppm，溯源索引需要 node。跑一次 doctor.py 它会逐项告诉你缺 什么、缺了会退化成什么样。没有一项是装不上，都是少一种格式。

材料怎么给