ascii-table-renderer

适用场景

关键触发规则

• 仅当用户明确提及技能的确切名称：ascii-table-renderer 时，才使用此技能。

触发短语包括：

• "ascii-table-renderer"
• "使用 ascii-table-renderer"
• "用 ascii-table-renderer 把列表打印成表格"
• "使用 ascii-table-renderer 生成 ASCII 表格（对齐/列宽）"

使用边界

• 不要获取数据（DB/API）。仅渲染和格式化输出。
• 默认边框仅使用 ASCII 字符：+ - |。
• 不在适用范围内：合并单元格、多行表头、复杂跨列布局。

如何使用此技能

输入

• headers（必填）
• rows（必填）
• maxWidth（默认值为 80）
• maxColWidth（默认值为 20）
• borderStyle（light | minimal，默认值为 light）
• overflow（ellipsis | wrap，默认值为 ellipsis）
• align（left | right | center，默认值为 left）

输出（必填）

• tableCompact（适合日志）
• tableReadable（适合交互阅读）
• rules（宽度/截断/null/对齐规则）

步骤

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

脚本

• scripts/render_table.py：从 JSON stdin 渲染表格（compact/readable）

示例

• examples/basic.md

质量检查清单

1. 各列对齐一致；每行长度不超过 maxWidth
2. Null 值显示为 -
3. 复制/粘贴安全（末尾不带空格）

关键词

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

常见陷阱 (Gotchas)

1. 版本兼容性：注意框架版本与依赖库的兼容性，不同版本 API 可能有差异
2. 配置文件格式：配置文件格式错误是最常见的问题，建议使用编辑器的语法检查
3. 环境变量：确保所有必要的环境变量已正确设置，敏感信息不要硬编码
4. 依赖冲突：多版本共存时注意依赖冲突，使用 lock 文件锁定版本
5. 性能陷阱：大数据量场景下注意性能优化，避免 N+1 查询等常见问题

使用流程

第 1 步：环境准备

确保开发环境已安装必要的依赖和工具。

第 2 步：配置初始化

根据项目需求进行基础配置。

第 3 步：使用核心功能

按照示例代码实现核心功能。

第 4 步：测试验证

运行测试确保功能正常。

第 5 步：部署上线

完成开发后进行部署和监控。