ASCII表格渲染器Skill ascii-table-renderer

此技能用于将结构化数据渲染为对齐的ASCII表格,支持列宽调整、截断或换行、边框样式设置,生成紧凑或可读的表格变体,适用于终端输出、日志记录和电子邮件格式化。关键词:ASCII表格、对齐、列宽、截断、换行、终端、日志。

后端开发 0 次安装 0 次浏览 更新于 3/22/2026

名称: 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(宽度/截断/空值/对齐规则)

步骤

  1. 计算每列宽度:min(maxColWidth, max(contentWidth))
  2. 处理溢出:
    • ellipsis:一致使用...
    • wrap:在列宽内换行,同时保持行对齐
  3. 输出两种变体:
    • compact:最小化或较少分隔符
    • readable:更清晰的边框

脚本

  • scripts/render_table.py:从JSON标准输入渲染表格(紧凑/可读)

示例

  • examples/basic.md

质量检查清单

  1. 列对齐一致;每行不超过maxWidth
  2. 空值渲染为-
  3. 复制/粘贴安全(无尾随空格)

关键词

英语: ascii-table-renderer, ascii table, align, columns, rows, truncate, wrap, terminal, log 中文: ascii-table-renderer, ASCII 表格, 对齐, 列宽, 截断, 换行, 终端, 日志, 工单