SuperAPI AI 工具集

ascii-draw-comments

编程与开发

查看项目

更新于 10-16 07:20

技能介绍

用途:把用户的想法转成可复制粘贴进代码注释或纯文本文档的 ASCII 图,适合框线箭头图、流程图、表格、树等结构。

主要能力:先确定目标注释风格,再生成简单 ASCII 布局并做美化;保持等宽安全,默认只用 ASCII 字符,除非用户要求 Unicode 框线;优先使用 +---+、|、-、>、v 和空格,避免制表符,保持行宽一致,标签简短。

使用方式:需要时先确认注释风格,如 JavaScript、TypeScript、C、Java、Kotlin、Swift 用 /* ... */ 块注释,shell、Ruby、Python 用 # 行注释,Markdown 用纯文本围栏。若用户想用 GUI 应用,可指向 ascii-draw 作为手动绘图工具:在 ASCII Draw 中画图,复制结果文本,粘贴到目标注释块内。若用户要直接在聊天或文件中生成,则自行产出可直接放入注释的 ASCII。

已有 ASCII 图需要包裹为源码注释且不破坏对齐时,使用捆绑脚本 scripts/wrap_ascii_comment.py,例如: python3 scripts/wrap_ascii_comment.py --style block < diagram.txt python3 scripts/wrap_ascii_comment.py --style line --prefix "# " < diagram.txt python3 scripts/wrap_ascii_comment.py --style markdown < diagram.txt

检查要点:图应比文字更快说明流程或结构;每个箭头方向清晰;框内标签不溢出;注释前缀不扭曲对齐;除非要求 Unicode,否则使用纯 ASCII。

限制:资料未提供该技能的安装方式、收费、平台支持或效果保证;具体注释模板和脚本行为以实际资料为准。