Skip to content

roxorlt/UEmaster / skills/flow-canvas

flow-canvas

Verified

把业务图渲染成横平竖直的规范 SVG:流程图(正交规范)、架构图(泳道分层)、ER 图、甘特图、时序图。触发:画流程图、业务流程图、架构图、ER 图、甘特图、时序图、把 mermaid 转规范图、流程图横平竖直、评审用图、render flowchart / orthogonal flowchart / architecture diagram / ER diagram / gantt / sequence diagram / draw a clean diagram from mermaid。不适用:只要 mermaid 源码文本、脑图、表格。

FileKindSize
LICENSEother1.0 KB
README.mdmarkdown3.7 KB
SKILL.mdskill md10.2 KB
agents/interface.yamlconfig1.4 KB
contract/archspec-v1.mdmarkdown2.1 KB
contract/archspec-v2.mdmarkdown3.0 KB
contract/archspec-v3.mdmarkdown5.1 KB
contract/archspec-v4.mdmarkdown5.0 KB
contract/archspec-v5.mdmarkdown3.5 KB
contract/blueprintspec-v1.mdmarkdown7.7 KB
contract/blueprintspec-v2.mdmarkdown4.0 KB
contract/blueprintspec-v4.mdmarkdown4.1 KB
contract/erspec-v1.mdmarkdown1.9 KB
contract/erspec-v2.mdmarkdown4.2 KB
contract/flowspec-v1.mdmarkdown3.0 KB
contract/ganttspec-v1.mdmarkdown1.9 KB
contract/seqspec-v1.mdmarkdown1.6 KB
examples/arch-3tier.mmdother289 B
examples/arch-logical.mmdother680 B
examples/arch-microservice.mmdother342 B
examples/arch-portal.mmdother262 B
examples/arch-skip.mmdother337 B
examples/blueprint-enterprise.mmdother2.0 KB
examples/blueprint-layered.mmdother794 B
examples/er-blog.mmdother324 B
examples/er-order.mmdother449 B
examples/er-school.mmdother409 B
examples/gantt-day-schedule.mmdother321 B
examples/gantt-infra.mmdother473 B
examples/gantt-release.mmdother483 B
examples/minimal.mmdother133 B
examples/pet-boarding.mmdother1.2 KB
examples/seq-login-auth.mmdother308 B
examples/seq-oauth-resource.mmdother386 B
examples/seq-order-pay.mmdother338 B
examples/seq-push-notify.mmdother414 B
manifest.jsonconfig288 B
scripts/flowcommon.pyexecutablescript21.3 KB
scripts/flowlayout.pyexecutablescript30.7 KB
scripts/layout_arch.pyexecutablescript60.6 KB
scripts/layout_blueprint.pyscript78.8 KB
scripts/layout_er.pyexecutablescript21.1 KB
scripts/layout_gantt.pyexecutablescript14.4 KB
scripts/layout_seq.pyexecutablescript13.5 KB
scripts/selftest.pyexecutablescript6.0 KB
scripts/selftest_arch.pyexecutablescript18.5 KB
scripts/selftest_blueprint.pyscript22.2 KB
scripts/selftest_er.pyexecutablescript10.5 KB
scripts/selftest_gantt.pyexecutablescript6.7 KB
scripts/selftest_seq.pyexecutablescript6.1 KB

scripts/selftest_er.py

View on GitHub
#!/usr/bin/env python3
# -*- coding: utf-8 -*-
"""er 布局 golden 自检(可独立运行;selftest.py 集成时调用 section(check, tmp, run))。"""
import json
import os
import re
import subprocess
import sys
import tempfile

if hasattr(sys.stdout, "reconfigure"):
    sys.stdout.reconfigure(encoding="utf-8")
    sys.stderr.reconfigure(encoding="utf-8")

HERE = os.path.dirname(os.path.abspath(__file__))
ROOT = os.path.dirname(HERE)
LAYOUT = os.path.join(HERE, "flowlayout.py")
if HERE not in sys.path:
    sys.path.insert(0, HERE)

import layout_er  # noqa: E402  直接调用布局产物做网格断言

GOLDENS = ["er-order", "er-blog", "er-school"]


def run(args):
    return subprocess.run([sys.executable, LAYOUT] + args,
                          capture_output=True, text=True, encoding="utf-8")


def _block(name, *attrs):
    return ["  %s {" % name] + ["    %s" % a for a in attrs] + ["  }"]


def _mmd(edges, entities):
    """entities: [(name, [attr_lines...]), ...]"""
    lines = ["erDiagram"] + ["  %s" % e for e in edges]
    for name, attrs in entities:
        lines += _block(name, *attrs)
    return "\n".join(lines) + "\n"


def _canvas_scan(svg):
    """解析 SVG 所有坐标/尺寸/points 数值,返回越出 [0,W]×[0,H] 的列表。"""
    m = re.search(r'viewBox="0 0 ([\d.]+) ([\d.]+)"', svg)
    if not m:
        return [("no-viewBox", 0)]
    W, H = float(m.group(1)), float(m.group(2))
    bad = []

    def chk(v, lo, hi, what):
        if v < lo - 1e-6 or v > hi + 1e-6:
            bad.append((what, v))

    for mm in re.finditer(r'\b(x|y|x1|y1|x2|y2|cx|cy|width|height)="(-?[\d.]+)"', svg):
        attr, val = mm.group(1), float(mm.group(2))
        if attr in ("x", "x1", "x2", "cx", "width"):
            chk(val, 0, W, attr)
        else:
            chk(val, 0, H, attr)
    for mm in re.finditer(r'points="([^"]+)"', svg):
        for pair in mm.group(1).split():
            x, y = map(float, pair.split(","))
            chk(x, 0, W, "px")
            chk(y, 0, H, "py")
    return bad


def section(check, tmp, run):
    for name in GOLDENS:
        src = os.path.join(ROOT, "examples", name + ".mmd")
        svg = os.path.join(tmp, name + ".svg")
        p = run([src, "--type", "er", "-o", svg])
        check("er %s 布局器运行" % name, p.returncode == 0, p.stderr.strip()[:120])
        if p.returncode == 0:
            rep = json.loads(p.stdout.splitlines()[0])
            check("er %s 报告字段齐全" % name,
                  all(k in rep for k in ("nodes", "edges", "crossings", "overlaps", "textOverflow", "warnings", "canvas")))
            check("er %s 零交叉" % name, rep.get("crossings") == 0, str(rep.get("crossings")))
            check("er %s 零重叠" % name, rep.get("overlaps") == 0, str(rep.get("overlaps")))
            check("er %s 零文字溢出" % name, rep.get("textOverflow") == 0, str(rep.get("textOverflow")))
            check("er %s 画布尺寸为整数" % name,
                  all(isinstance(v, int) for v in rep.get("canvas", [])), str(rep.get("canvas")))
            svg_text = open(svg, encoding="utf-8").read()
            check("er %s SVG 带 data-erspec 契约版本" % name, 'data-erspec="2"' in svg_text)
            check("er %s SVG 含 class=entity" % name, 'class="entity"' in svg_text)
            check("er %s SVG 含乌鸦脚记号" % name, 'class="er-card"' in svg_text)
            check("er %s 画布越界扫描为 0" % name, not _canvas_scan(svg_text),
                  str(_canvas_scan(svg_text)[:3]))
            emoji = [ch for ch in svg_text if 0x1F000 <= ord(ch) <= 0x1FAFF or 0x2600 <= ord(ch) <= 0x27BF]
            check("er %s 产物无 emoji" % name, not emoji, "".join(emoji[:5]))
        p2 = run([src, "--type", "er", "--check"])
        check("er %s --check 通过" % name, p2.returncode == 0, p2.stderr.strip()[:120])
        if p2.returncode == 0:
            rep2 = json.loads(p2.stdout)
            check("er %s --check 报告字段齐全" % name,
                  all(k in rep2 for k in ("nodes", "edges", "crossings", "overlaps", "textOverflow", "warnings", "canvas")))
            check("er %s --check 三项全 0" % name,
                  rep2["crossings"] == 0 and rep2["overlaps"] == 0 and rep2["textOverflow"] == 0)

    html = os.path.join(tmp, "er-golden.html")
    p = run([os.path.join(ROOT, "examples", "er-order.mmd"), "--type", "er", "-o", html, "--html"])
    check("er HTML 画布模式生成", p.returncode == 0 and "setZoom" in open(html, encoding="utf-8").read() and "pointerdown" in open(html, encoding="utf-8").read())

    # ── 乌鸦脚记号断言:o{ 与 |{ 关系 → circle + fork 线段,er-card 分组数量正确 ──
    crow = os.path.join(tmp, "er-crow.mmd")
    with open(crow, "w", encoding="utf-8") as f:
        f.write(_mmd(['A ||--o{ B : "x"', 'C ||--|{ D : "y"'],
                     [("A", ["int id PK"]), ("B", ["int id PK"]),
                      ("C", ["int id PK"]), ("D", ["int id PK"])]))
    crow_svg = os.path.join(tmp, "er-crow.svg")
    p = run([crow, "--type", "er", "-o", crow_svg])
    ok = p.returncode == 0
    csvg = open(crow_svg, encoding="utf-8").read() if ok else ""
    check("er 乌鸦脚:2 边 4 组 er-card", ok and csvg.count('class="er-card"') == 4, str(csvg.count('class="er-card"') if ok else -1))
    check("er 乌鸦脚:o{ 含 circle 记号", ok and 'data-card="o{"' in csvg and csvg.count('class="er-circle"') == 1)
    check("er 乌鸦脚:|{ 含 fork 三叉(3 线段)", ok and 'data-card="|{"' in csvg and csvg.count('class="er-fork"') == 6)
    check("er 乌鸦脚:画布越界扫描为 0", ok and not _canvas_scan(csvg), str(_canvas_scan(csvg)[:3]) if ok else "run-failed")

    # ── 网格断言:4 实体呈多行多列结构(y 取值 ≥ 2 种,不再单行)──
    grid_mmd = _mmd(['A ||--o{ B : "x"', 'A ||--o{ C : "y"', 'A ||--o{ D : "z"'],
                    [("A", ["int id PK"]), ("B", ["int id PK"]),
                     ("C", ["int id PK"]), ("D", ["int id PK"])])
    try:
        spec = layout_er.parse_mermaid(grid_mmd)
        glay = layout_er.layout(spec)
        ys = sorted(set(round(n["y"]) for n in glay["nodes"].values()))
        xs = sorted(set(round(n["x"]) for n in glay["nodes"].values()))
        check("er 网格:实体 y 取值 ≥ 2 种(不再单行)", len(ys) >= 2, str(ys))
        check("er 网格:实体 x 取值 ≥ 2 种(不再单列)", len(xs) >= 2, str(xs))
        check("er 网格:三项全 0", not glay["crossings"] and not glay["overlaps"] and not glay["textOverflow"])
    except SystemExit as e:
        check("er 网格:布局未降级", False, str(e))

    # ── 形态超限降级 ──
    bad1 = os.path.join(tmp, "er-bad-card.mmd")
    with open(bad1, "w", encoding="utf-8") as f:
        f.write(_mmd(['A ||--xx B : "x"'], [("A", ["int id PK"]), ("B", ["int id PK"])]))
    p = run([bad1, "--type", "er", "--check"])
    check("er 降级:非法基数记号明确报错", p.returncode != 0 and "形态超限" in (p.stderr or ""), (p.stderr or "").strip()[:80])

    bad2 = os.path.join(tmp, "er-bad-attr.mmd")
    with open(bad2, "w", encoding="utf-8") as f:
        f.write(_mmd([], [("A", ["int id !!"])]))
    p = run([bad2, "--type", "er", "--check"])
    check("er 降级:非法属性字符明确报错", p.returncode != 0 and "形态超限" in (p.stderr or ""), (p.stderr or "").strip()[:80])

    # 无引号注释 + 中文注释 + 引号注释 均能解析
    cmt = os.path.join(tmp, "er-comment.mmd")
    with open(cmt, "w", encoding="utf-8") as f:
        f.write(_mmd(['A ||--o{ B : "下单"'],
                     [("A", ["int id 主键", "string name PK \"姓名\""]), ("B", ["int id PK"])]))
    p = run([cmt, "--type", "er", "--check"])
    check("er 注释:无引号/引号注释均可解析", p.returncode == 0, (p.stderr or "").strip()[:80])

    # 三实体两两交叉:网格布局可绕行消除 → 应成功 + 三项全 0 + 含乌鸦脚
    bad3 = os.path.join(tmp, "er-triangle.mmd")
    with open(bad3, "w", encoding="utf-8") as f:
        f.write(_mmd(['A ||--o{ B : "x"', 'B ||--o{ C : "y"', 'A ||--o{ C : "z"'],
                     [("A", ["int id PK"]), ("B", ["int id PK"]), ("C", ["int id PK"])]))
    tri_svg = os.path.join(tmp, "er-triangle.svg")
    p = run([bad3, "--type", "er", "-o", tri_svg])
    ok = p.returncode == 0
    if ok:
        trep = json.loads(p.stdout.splitlines()[0])
        tsvg = open(tri_svg, encoding="utf-8").read()
        check("er 三角关系:网格布局运行成功", ok, p.stderr.strip()[:120])
        check("er 三角关系:三项全 0", trep["crossings"] == 0 and trep["overlaps"] == 0 and trep["textOverflow"] == 0)
        check("er 三角关系:SVG 含乌鸦脚记号", 'class="er-card"' in tsvg)
    else:
        check("er 三角关系:网格布局运行成功", ok, p.stderr.strip()[:120])

    # 绕行边数 > 6 的密集图 → 形态超限降级
    dense = os.path.join(tmp, "er-dense.mmd")
    with open(dense, "w", encoding="utf-8") as f:
        f.write("erDiagram\n")
        for i in range(8):
            for j in range(i + 1, 8):
                f.write("  E%d ||--o{ E%d : \"\"\n" % (i, j))
        for i in range(8):
            f.write("  E%d {\n    int id PK\n  }\n" % i)
    p = run([dense, "--type", "er", "--check"])
    check("er 降级:绕行边 > 6 明确报错", p.returncode != 0 and "形态超限" in (p.stderr or ""), (p.stderr or "").strip()[:80])

    # 完全重复关系边 → 形态超限
    dup = os.path.join(tmp, "er-dup-edge.mmd")
    with open(dup, "w", encoding="utf-8") as f:
        f.write(_mmd(['A ||--o{ B : "x"', 'A ||--o{ B : "y"'],
                     [("A", ["int id PK"]), ("B", ["int id PK"])]))
    p = run([dup, "--type", "er", "--check"])
    check("er 降级:完全重复关系边明确报错", p.returncode != 0 and "形态超限" in (p.stderr or ""), (p.stderr or "").strip()[:80])

    # ── emoji 拒绝 ──
    bad4 = os.path.join(tmp, "er-emoji.mmd")
    with open(bad4, "w", encoding="utf-8") as f:
        f.write(_mmd([], [("A", ["int id PK"]), ("B", ["int 数量🚀"])]))
    p = run([bad4, "--type", "er", "--check"])
    check("er emoji 输入被拒绝", p.returncode != 0, (p.stderr or "").strip()[:80])


if __name__ == "__main__":
    results = []

    def check(name, ok, detail=""):
        results.append((name, bool(ok), detail))
        print("%s %s%s" % ("PASS" if ok else "FAIL", name, ("  [%s]" % detail) if detail and not ok else ""))

    tmp = tempfile.mkdtemp(prefix="flowcanvas-er-")
    section(check, tmp, run)
    fails = [r for r in results if not r[1]]
    print("\n%d/%d 通过" % (len(results) - len(fails), len(results)))
    sys.exit(1 if fails else 0)
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 198kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall