SuperAPI AI 工具集

ascii-flow

通用与其它

查看项目

更新于 10-16 05:53

技能介绍

用途:把信息画成等宽字符图,使其在任何纯文本环境中原样可复制、保持对齐,无需渲染器或插件。适用于代码注释、README、终端、git diff、邮件、聊天框。参考资料基于 asciidiagrams.github.io 收录的分类与约 500 个真实案例(来自 Chromium、Linux 内核、LLVM、TensorFlow 等)。

主要能力:按内容选择编码——流程/控制流/状态机用有向图(自上而下),架构用无向框图,交互用时序图,层级用树(├─ └─),阶段用线性图,表格用网格,内存布局用嵌套框,几何/UI 用坐标图。流程与树自上而下,管道与时序自左向右。

字符层级:Tier 1 纯 ASCII(| - + = / \ < > ^ v . ' : * #),兼容性最高;Tier 2 Unicode 框线(─ │ ┌ ┐ └ ┘ ├ ┤ ┬ ┴ ┼ 等),现代等宽字体与终端支持,单格宽;Tier 3 箭头与块(→ ↓ ▶ ▼ █ ▌ ░ • ×)慎用,部分字符在 CJK 环境宽度歧义会破坏对齐。默认:源码内嵌用 Tier 1,独立文档/终端输出用 Tier 2;同一图中勿混用两级的线字符。

使用方式:在固定网格上构建,只用空格不用制表符;先定框位置与宽度,再画连接线;垂直连接线各行保持同一列;标签按统一框宽补齐;每框一概念,标签简短;行尾不留空白。画连接线前必须计算中心列:center_col = left_border_col + floor(total_box_width / 2),并优先奇数总宽。多路分支须先确定各目标框的左列与宽度,再画横线,使连接点落在目标中心列上。

输出封装:Markdown/聊天中放入围栏代码块;源码中每行加注释前缀并保持对齐;Tier 2/3 文件保存为 UTF-8;符号含义不明时补图例或说明。

限制:图较大或稠密(数十节点、交叉边)时 ASCII 可读性差,目标环境支持时应改用 Mermaid/Graphviz 或图片;制表符与 CJK 歧义字符会破坏对齐;其余细节未提供。