tabtin-widget
渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。
- License 许可
- AGPL-3.0
- 所属仓库
- tabtin-ai/TabTin
- 最近更新
- 2026-10-08
- Stars
- ★ 454
- Forks
- 115
01 前言 Front Matter
- name
- tabtin-widget
- metadata
- { "tabtin": { "tags": [ "widget", "visualization", "svg", "html", "mermaid", "chart", "diagram", "mockup" ], "tools": [ "show_widget" ], "category": "media", "autoActivateFor": [] }, "version": "1.0.0" }
- description
- 渲染可视化组件——用 show_widget 编译 SVG / HTML(no-script) / Mermaid 图做自由可视化。内容能落 present_to_user 4 类 kind → 不用 widget;长期可编辑产物 → TabData/ TabDoc/TabSlide。
02 资源文件 12
- 参考文档decision-tree.md6.7 KB
- 参考文档design-tokens.md3.7 KB
- 参考文档examples/git-rebase-merge-mermaid.md1.1 KB
- 参考文档examples/html-stepper.md1.7 KB
- 参考文档examples/k8s-architecture-svg.md3.7 KB
- 参考文档examples/mermaid-er.md721 B
- 参考文档examples/purchase-journey-sendprompt.md3.3 KB
- 参考文档examples/sales-q3-mermaid-or-svg.md3.1 KB
- 参考文档examples/settings-page-html.md2.9 KB
- 参考文档failure-patterns.md4.5 KB
- 参考文档sandbox.md6.7 KB
- 参考文档sendPrompt-usage.md3.3 KB
03 SKILL.md 正文
tabtin-widget
show_widget 用来在 chat 内画一次性视觉内容:安全、美观、可下钻;不是文件、表格、文档或小应用。
资源导航
本 Skill 带有 examples/ 目录。遇到具体样式不确定、需要复用成熟图形模式,或用户要求“给我一个图/流程/架构/UI mockup”时,先按需读取对应示例:
- Mermaid / SVG 图:参考
examples/git-rebase-merge-mermaid.md、examples/sales-q3-mermaid-or-svg.md、examples/mermaid-er.md、examples/k8s-architecture-svg.md - HTML no-script mockup:参考
examples/settings-page-html.md、examples/html-stepper.md - 可点击追问:参考
examples/purchase-journey-sendprompt.md
先判定
- 现成 image/table_preview/resource_ref/file 能表达 → 用
present_to_user。 - 用户要长期编辑/复用 → 用 TabData / TabDoc / TabSlide。
- 一两段文字说得清 → 直接答。
- 空间关系、流程、数据洞察、UI mockup、可点击下钻 → 用
show_widget。详见decision-tree.md。
装饰图、普通总结、原始表格、已有图片 URL 不用 widget。
选格式
| format | 用它 | 别用它 |
|---|---|---|
svg |
架构图、柱状图、几何图、需要 sendPrompt 的节点 |
大量规则节点图 |
html |
静态设置页、stepper、卡片/网格 mockup | 脚本、真实表单、复杂滚动页 |
mermaid |
flowchart / sequence / ER / Gantt | 像素级 UI、点击交互 |
Mermaid 传源码,工具执行时编译成 SVG;不要自己加载 runtime。
工具输入
show_widget({
title?: string,
summary: string, // 必填:移动端 fallback + a11y
format: "svg" | "html" | "mermaid",
loading_message?: string, // 推荐放在 code 前输出
code: string, // ≤8KB
group_id?: string,
group_title?: string,
})
summary 不是标题,写成无图也能懂的一句话:Q3 区域销售柱状图:华东 320 万领先,华南 280 万次之,西部最低。 不要写 销售图。loading_message 写用户看得懂的短句:正在生成 Q3 销售对比图...。
sendPrompt
只有“点了会开启新一轮对话”的元素能用 sendPrompt(text, meta?)。text 是用户会说的话,建议 ≤200 字、硬上限 1000;meta 只放小 JSON,硬上限 4KB。必须有 cursor:pointer + hover/focus 反馈;不可点元素禁止装成交互。详见 sendPrompt-usage.md。
沙箱红线
HTML no-script;不要外链脚本/CDN、javascript:、iframe/object/embed、form、非 sendPrompt 事件、allow-same-origin。Mermaid 不用 click directive。SVG/HTML 一次写完整,不要多次调工具拼同一张图。
Tokens 速查
颜色只写 hsl(var(--token)),自动适配 light/dark:--background、--foreground、--muted-foreground、--primary、--border、--accent、--success、--warning、--destructive。字体用 system stack:-apple-system,BlinkMacSystemFont,system-ui,"PingFang SC","Microsoft YaHei",sans-serif。SVG 推荐 viewBox="0 0 680 H"、width="100%"、H≤480。
更多:design-tokens.md、sandbox.md、failure-patterns.md、examples/。
04 同仓库更多 Skills
tabtracker
管理自动化任务——创建、列出、暂停、恢复、立即触发(产品模块名「自动化」, 具体条目称「自动化任务」;CLI 命令仍为 tabtin tracker)。当用户表达"派活"意图时使用: 关键词包括"帮我..."、"以后..."、"每天..."、"工作日..."、 "提醒我..."、"定时..."、"每周..."。区分一次性指令(直接执行)和长期任务(创建 自动化任务,由调度器在指定时间唤起 Agent)。
tabtin-project
在 Project Task 执行会话中工作:先读取当前任务工作面,再优先修改既有中间产物。 当系统上下文表明当前会话是 Project Task,或用户要求继续修改过程中的中间产物时使用。
skill-market
管理 Skill 生命周期——列出已装、看详情、搜索市场、 安装、卸载、启用、禁用、更新。当用户表达"装个技能 / 卸载技能 / 看看有什么技能 / 启用禁用技能"意图时使用。
resource-link
插入资源链接——在 chat 文字流里给资源链接,markdown link 形态 [显示文本](tabtin://resource/<type>/<id>?hint=<carrierApp>), 用户点击直接在 Space 内打开。行业格式(http/https/ file/mailto)也兼容;不要写 file:// 让用户自己复制粘贴。
mcp-operations
操作本机 MCP 连接——通过 `tabtin mcp` CLI 查看当前 Space 已挂载的本机 MCP servers、tools/resources/ prompts,并用 `mcp_call_tool` 调用指定 MCP tool。 用户提到"使用 Playwright MCP""调用本机安装的 MCP 工具""读取某个 MCP resource""获取某个 MCP prompt"时激活。
file-generation
生成办公文件——在当前工作目录生成 Office / PDF 文件(xlsx / docx / pptx / pdf;用户说 ppt 时按 pptx 处理)并发布成聊天卡片。用户要"导出 / 生成 Excel 表格、Word 文档、PPT 演示、PDF 报告""做一份报表 / 合同 / 周报文件""把这些数据存成 xlsx"时激活。