闲社服务运行正常AI智能体自动化平台
z

表格渲染

技能标识:zentable

Render structured table data as high-quality PNG images using Headless Chrome. Use when: need to visualize tabular data for chat interfaces, reports, or social media. NOT for: simple text tables that don't need visualization.

作者:admin | 来源记录:ClawHub
登记来源
ClawHub
版本
V 0.9.2
检测标记
后台标记通过
免费
免费获取
1
收藏
来源与检测标记为平台登记信息,并不代表已展示可复核的检测报告。使用前请核对版本、依赖和所需权限,建议先在隔离环境中运行。
概述
安装方式
版本历史

表格渲染

ZenTable 技能

将结构化表格数据渲染为高质量PNG图像。

概要

ZenTable将杂乱的表格类内容转化为可读性强、便于决策的表格输出,适用于移动端(优先适配Discord)和桌面端。

可接受的输入

  • - 文本内容(原始文本表格、长篇幅智能体响应)
  • 结构化JSON
  • 截图/实拍照片(必要时通过OCR辅助提取)

核心能力

  • - CSS + PIL渲染
  • 排序/筛选/分页
  • 基于阈值的突出显示
  • 可选的PNG + TXT双输出(--both)

运行时与安全说明

本技能运行本地脚本,依赖本地运行时二进制文件(python3、google-chrome)。
在敏感环境中运行前,请审查代码及依赖项。

命名规范

  • - 规范代码名称:zentable(小写)
  • UI/品牌标签:ZenTable
  • zeble / zenble 为旧版兼容别名
  • 参考文档:NAMING_MIGRATION.md(仓库文档)

使用时机

✅ 以下情况应使用本技能:

  • - 需要可视化表格图像而非纯文本
  • 需要为聊天/报告/社交分享生成精美输出
  • 数据集较大,纯文本难以阅读
  • 需要特定视觉主题(iOS风格、深色、紧凑等)

❌ 以下情况不应使用本技能:

  • - 表格很小,纯文本已足够
  • 用户明确要求不输出图像
  • 用户需要可编辑的电子表格格式(CSV/Excel)

能力矩阵(SkillHub版本)

能力状态备注
CSS输出✅ 稳定主要发布路径;默认minimaliosmobile + width=450
PIL输出
✅ 稳定 | Chrome不可用时的安全回退方案 | | ASCII输出 | ⚠️ 测试版/实验性 | 可用,但因字体和空白符行为,跨平台时对齐可能偏移 |

已知限制

  • - ASCII输出对平台字体回退和空白符处理敏感。
  • 需为每个平台创建独立的校准配置文件,不可盲目共享。
  • --both 在无文本主题时已包含回退至default文本主题。
  • Discord纯文本会折叠重复的普通空格;可能需要使用Unicode间距字符来保持间距。
  • 本测试版主要在Discord上验证;其他聊天平台可能需要智能体端进行输出适配(图像/消息格式差异)。

Zx速记策略(项目规则)

当用户输入为Zx时,视为强渲染意图:

  1. 1. 默认直接执行渲染(无需初步问答)。
  2. 默认路径:CSS + minimaliosmobile + width=450。
  3. 仅在高度不确定时追问:
- 当前/上下文中无可用源数据, - 意图看起来不像是表格渲染, - 关键字段缺失且输出很可能错误。
  1. 4. 若平台支持图像,直接返回图像(而非仅链接)。

Zx的数据源优先级:
1) 当前消息图像OCR
2) 当前消息文本转表格
3) 上一条消息图像OCR
4) 上一条消息文本转表格

语法糖 → 规范映射

语法糖规范键规范化最终渲染参数
--width N / --w Nwidth正整数--width N
--transpose / --cc
transpose | 布尔值 | --transpose | | --tt | keepthemealpha | 布尔值 | --tt | | --per-page N / --pp N | per_page | 正整数 | --per-page N | | --page ... / --p ... | pagespec | N / A-B / A- / all | 由tablerenderer.py展开 | | --all | pagespec | 等同于all | 由tablerenderer.py展开 | | --text-scale V / --ts V | text_scale | 枚举/比例 | --text-scale V | | --sort SPEC | sort_spec | 单键/多键 | --sort SPEC | | --asc / --desc | sortdefaultdir | 默认方向 | --asc / --desc | | --f SPEC / --filter SPEC | filters | 可重复筛选 | --f SPEC | | --smart-wrap | smart_wrap | true | --smart-wrap | | --no-smart-wrap / --nosw | smart_wrap | false | --no-smart-wrap | | --theme NAME / -t NAME | theme | 主题ID | --theme NAME | | --both / --bo | output_both | 布尔值 | --both | | --pin KEYS | pin_keys | 持久化默认值 | --pin | | --pin-reset | pin_reset | 重置持久化默认值 | --pin-reset |

持久化默认基线:

  • - theme=minimaliosmobile
  • width=450
  • smartwrap=true
  • perpage=15

page_spec规则

  • - N:仅第N页
  • A-B:包含A到B的范围
  • A-:从A到最后一页
  • all:所有页
  • 若省略:默认预览页1-3

规范负载示例

json
{
theme: minimaliosmobile,
width: 900,
transpose: false,
keepthemealpha: false,
per_page: 15,
page_spec: 2-,
sort_spec: score:desc,name:asc,
sortdefaultdir: asc,
filters: [col:!note,attachment, row:status!=disabled;score>=60],
text_scale: auto,
smart_wrap: true,
output_both: false
}

命令示例

bash

从仓库根目录运行

基础CSS输出

python3 skills/zentable/tablerenderer.py - /tmp/out.png --theme minimalios_mobile --width 900 --text-scale large --page 1

转置 + 禁用智能换行

python3 skills/zentable/tablerenderer.py - /tmp/out.png --theme compactclean --transpose --no-smart-wrap --page 1

页码范围展开(2-4)

python3 skills/zentable/table_renderer.py - /tmp/out.p2.png --per-page 12 --page 2 python3 skills/zentable/table_renderer.py - /tmp/out.p3.png --per-page 12 --page 3 python3 skills/zentable/table_renderer.py - /tmp/out.p4.png --per-page 12 --page 4

PNG + ASCII侧边输出

python3 skills/zentable/tablerenderer.py - /tmp/out.png --theme mobilechat --both

验证清单(最低要求)

  • - python3 -m pycompile scripts/zentablerender.py
  • CSS冒烟测试输出成功
  • PIL冒烟测试输出成功
  • --pin、--pin-reset、--both已验证
  • 相关黄金测试通过

发布定位

当前渠道:测试版。
ASCII在SkillHub版本中仍为测试版/实验性。

支持/联系

  • - GitHub Issues:https://github.com/con2000us/zenTable/issues
  • 维护者:@con2000us(Discord)
  • 错误报告清单:
- 输入类型(文本/截图/照片/JSON) - 预期输出与实际输出 - 平台(Discord/移动端/桌面端) - 使用的命令/选项

标签

skill ai

通过对话安装

以下为平台配置的接入选项,并非逐项实测通过。能否安装取决于客户端支持、技能来源和运行环境:

OpenClaw WorkBuddy QClaw Kimi Claude

方式一:安装 SkillHub 和技能

帮我安装 SkillHub 和 zentable-1776287118 技能

方式二:设置 SkillHub 为优先技能安装源

设置 SkillHub 为我的优先技能安装源,然后帮我安装 zentable-1776287118 技能

通过命令行安装

skillhub install zentable-1776287118

下载

⬇ 下载 zentable v0.9.2(免费)

文件大小: 6.3 KB | 发布时间: 2026-4-16 16:51

v0.9.2 最新 2026-4-16 16:51
No functional or documentation changes in this release.

- Version bump to 0.9.2 with no changes detected in source files or documentation.
返回顶部