核心用法
ZenTable 是一款专注于表格可视化的本地渲染工具，核心能力是将原始文本表格、JSON 结构或 OCR 提取数据转化为精美 PNG 图片。采用 Headless Chrome (CSS) 与 PIL 双引擎架构，CSS 为默认主路径（推荐 minimal_ios_mobile 主题），PIL 作为无 Chrome 环境的安全降级方案。
典型工作流：
1. 接收文本/JSON/图片 OCR 数据
2. 通过 table_renderer.py 解析并应用主题、宽度、分页等参数
3. 输出 PNG（可选 --both 同步生成 ASCII 文本备用）
关键特性：
- 智能参数系统：
--width、--per-page、--sort、--filter等丰富的语法糖，支持Zx快捷指令直接渲染 - 分页与范围：
page_spec支持单页、连续范围（2-5）、开放结尾（3-）及all全量输出 - 主题与自适应：内置 iOS 风移动主题，自动列宽计算与智能换行 (
smart_wrap) - 双模输出：
--both同时生成 PNG+TXT，应对图片发送失败场景
显著优点
1. 视觉决策友好：将密集数据转为可读性强的移动端优先图片，适合 Discord/社交分享
2. 降级鲁棒性：PIL 纯 Python 实现确保无浏览器环境仍可用
3. 参数语义丰富：支持列/行级过滤、多键排序、阈值高亮、矩阵转置等进阶操作
4. 平台适配意识：针对 Discord 移动端 450px 宽度优化，内置 Unicode 空格防折叠处理
潜在缺点与局限性
- 本地依赖重：必须预装
python3与google-chrome，跨平台部署成本较高 - ASCII 输出不稳定：受系统字体回退与空白字符处理差异影响，不同平台对齐可能漂移
- 无编辑能力：输出为静态图片，无法提供 CSV/Excel 等可编辑格式
- Beta 验证局限：ASCII 模式与部分功能仅在 Discord 环境充分测试，其他聊天平台可能需要额外适配
- OCR 为辅助：图片输入依赖外部 OCR，非内置能力
适合人群
- 需要将结构化数据快速可视化、用于聊天分享或报告插入的社区运营者、数据分析师
- Discord 等支持富媒体消息平台的重度用户
- 能接受本地运行 Python 脚本与浏览器依赖的技术用户
常规风险
| 风险维度 | 说明 |
|---------|------|
| 本地执行风险 | 运行用户本地 Python 脚本，需审查 `table_renderer.py` 及依赖库 |
| 浏览器供应链 | Headless Chrome 涉及外部二进制，需确保来源可信 |
| 数据隐私 | 敏感数据经本地 Chrome 渲染，虽不上传云端，但临时文件需留意清理 |
| 跨平台一致性 | 字体、DPI 差异可能导致同参数输出在不同设备视觉效果不一致 |
| 维护可持续性 | 当前为 beta 版本，API 与主题系统可能迭代变化 |
建议：在敏感环境首次使用前，执行验证清单中的最小化测试（py_compile 与 smoke test）。