用途:用可视化方式逐步解释概念,通过手绘 ASCII 图呈现状态推进,每个中间状态都展示,不跳过步骤。
主要能力:可选择多种风格自由组合,多数解释同时用 2-3 种。视觉追踪用于算法的逐步状态变化、机械循环、信号流;块状图用于结构或布局(内存、电路、架构、解剖);对比表用于对比两种以上事物(方案、取舍、前后变化);公式推导用于从第一性原理构建公式或规则;概念拆解用于向零基础者解释某事。
工作流程:先判断适合的风格(多数需要追踪加总结表);从最小可用例子入手,不从抽象开始;画出带全部标注的初始状态图;逐步展示每个中间状态,每步一张图,标注变化内容与原因;最后用表格、公式或关键结论总结,并连接回更大的图景或实际应用。
格式规则:图形使用 Unicode 制表符,指针用 ↓↑←→ 和 ↕↔,指针名放箭头上方、值注释放下方;每步独立成图,用 ^^^^^ 或 written/moved/swapped 高亮变化;变换用前/后对照;多阶段用重分隔线;对比表用具体数值;公式推导可视化地搭建,展示技巧而非仅结果;概念拆解时不做未定义术语,用物理直觉类比,从已知推向未知。
图形工具选择:手绘 ASCII 为默认,适合状态推进、数组遍历、指针移动等中间状态重要的场景;doc-mermaid-ascii 可作为配套技能,用于算法流程图、决策树、状态机、时序图、实体关系等结构概览,可一起使用,先总览后逐步。调用 doc-mermaid-ascii 时:--ascii 用于内联终端输出;-o file.svg --theme <name> 用于主题化 SVG 文件。
限制:要展示每个中间状态,用最小例子(5-8 个元素而非 20 个),决策注解放图右侧,结尾给总结表或关键结论,可适配任意领域;不要从理论开始、不要用未定义术语、不要只展示最终结果、图宽不要超过约 80 字符、不要用 Mermaid 做逐步追踪。可加载 references/style-guide.md 查看完整字符参考与可复用模式,加载 references/examples.md 查看各风格示例。适用范围、安装方式、收费等信息暂未提供。