用途:在无渲染器的环境(如终端、纯文本文件)中生成由方框和箭头组成的 ASCII 流程图/框图,输出仅限 ASCII,不输出 Mermaid 或 PlantUML。
触发条件:仅当用户明确提到技能名 ascii-diagram-boxflow 时使用,例如“use ascii-diagram-boxflow”“用 ascii-diagram-boxflow 画 ASCII 流程图/框图”。
输入参数:nodes(节点列表,名称必填)、edges(连接,含 from/to)、direction(TB 或 LR,默认 TB)、width(默认 80)、boxWidth(默认 16)、numbering(默认 false)。
输出内容:diagram(纯 ASCII 图)、layoutRules(方框宽度与箭头/线条规则)、splitAdvice(复杂图的拆分建议)。
脚本与示例:scripts/boxflow.py 对线性流程和单向二路分支做尽力而为的布局;示例见 examples/login-flow.md。
限制:建议节点数不超过 12,超出应拆分为子图;自动布局仅对线性和简单分支尽力而为,复杂布局需手动排序或拆分;长节点名按 boxWidth 截断,如 boxWidth=16 时“Authentication Service”变为“Authenticati...”;行宽不超过 width,不留行尾空格;箭头方向需明确,避免交叉。
质量检查:箭头方向无歧义、避免交叉;行宽不超过 width 且无尾随空格;长节点名需一致地截断或换行。
适用场景:终端文档、纯文本说明、无图形渲染环境下的流程与结构示意。具体收费、价格、平台等信息暂未提供。