名称: ascii-table-renderer 描述: 将结构化数据渲染为对齐的ASCII表格(列宽规则、截断/换行、边框样式、紧凑/可读变体),适用于终端/日志/电子邮件。 许可证: 完整条款在LICENSE.txt中 依赖项:
- python>=3.8
何时使用此技能
关键触发规则
- 仅当用户明确提及确切的技能名称
ascii-table-renderer时使用此技能。
触发短语包括:
- “ascii-table-renderer”
- “use ascii-table-renderer”
- “用 ascii-table-renderer 把列表打印成表格”
- “使用 ascii-table-renderer 生成 ASCII 表格(对齐/列宽)”
边界
- 不获取数据(数据库/API)。仅渲染和格式化输出。
- 默认边框仅使用ASCII字符:
+ - |。 - 超出范围:合并单元格、多行表头、复杂跨布局。
如何使用此技能
输入
- headers(必需)
- rows(必需)
- maxWidth(默认80)
- maxColWidth(默认20)
- borderStyle(light | minimal,默认light)
- overflow(ellipsis | wrap,默认ellipsis)
- align(left | right | center,默认left)
输出(必需)
- tableCompact(日志友好)
- tableReadable(交互友好)
- rules(宽度/截断/空值/对齐规则)
步骤
- 计算每列宽度:
min(maxColWidth, max(contentWidth)) - 处理溢出:
- ellipsis:一致使用
... - wrap:在列宽内换行,同时保持行对齐
- ellipsis:一致使用
- 输出两种变体:
- compact:最小化或较少分隔符
- readable:更清晰的边框
脚本
scripts/render_table.py:从JSON标准输入渲染表格(紧凑/可读)
示例
examples/basic.md
质量检查清单
- 列对齐一致;每行不超过maxWidth
- 空值渲染为
- - 复制/粘贴安全(无尾随空格)
关键词
英语: ascii-table-renderer, ascii table, align, columns, rows, truncate, wrap, terminal, log 中文: ascii-table-renderer, ASCII 表格, 对齐, 列宽, 截断, 换行, 终端, 日志, 工单