feishu-cli-visual
飞书可视化载体:画板(架构图、流程图、SVG/Mermaid/PlantUML 转可编辑节点、取回 Mermaid 源码、克隆、质检与导出)、飞书 Slides 演示文稿(从 XML 创建、按页增删改、截图)、文档内妙笔 HTMLBox 动态组件(ECharts、地图、3D、动画、交互大屏)、妙搭 HTML 应用发布与访问范围,以及数据图表形式与配色规范。用户要在飞书里画图、做幻灯片/PPT、嵌入会动或可交互的图表、发布 HTML 应用时使用。不用于:只产出本地 SVG/PPTX/HTML 文件;消息卡片(feishu-cli-messaging);HTML 邮件(feishu-cli-mail);随 Markdown 导入的图表(feishu-cli-docs);多维表格仪表盘(feishu-cli-data)。
How do I install this agent skill?
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-visualIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is a comprehensive toolkit for managing visual content in Feishu (Lark), including whiteboards, slides, and interactive document components. It uses well-known visualization libraries (ECharts, Three.js) via trusted CDNs and interacts with the platform using legitimate CLI tools. No malicious patterns were detected.
- Socketwarn
1 alert: gptSecurity
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
飞书可视化与展示
加载工作流后,将其中 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析;执行脚本时使用解析后的实际路径,不要依赖当前 shell 目录。
仅在目标是飞书产物时选择下列载体;用户只要本地文件时保留原交付方式。 飞书载体尚未确定时先读 dataviz;已明确载体时直接读取对应工作流。
路由
| 意图 | 读取文件 |
|---|---|
| 未指定载体的数据图表、配色和形式选择 | references/workflows/dataviz/workflow.md |
| 静态画板:SVG/Mermaid/PlantUML 导入、手写节点、取回源码、克隆、质检、导出 | references/workflows/board/workflow.md |
| Slides 幻灯片/PPT:创建、读 XML、按页增删改、截图预览、上传图片、历史版本与回滚 | references/workflows/slides/workflow.md |
| 文档内动态、交互、CSS/JS、ECharts、3D、window.magic 小程序 | references/workflows/htmlbox/workflow.md |
| 妙搭 HTML 应用:创建、修改(含图标)、删除、发布与按分支发布、查发布状态、功能开关、访问范围 | references/workflows/apps/workflow.md |
载体边界
- 飞书文档内动态或交互:htmlbox。
- 飞书静态画板且节点可编辑:board。
- 飞书演示文稿:slides。
- 用户要求发布为妙搭 HTML 应用:apps。
- 要消息通知卡片:
feishu-cli-messaging的 card 工作流。
执行规则
- 身份:board、slides 写命令默认 Bot,可用
--as user|auto或--user-access-token改用本人身份(操作用户已有的画板或 演示文稿时加--as user);doc htmlbox写命令默认 Bot,只认显式--user-access-token(或FEISHU_USER_ACCESS_TOKEN)。Slides 新建优先用 User:应用未开通 tenant 的slides:presentation:create时 Bot 创建报 99991672(exit 3)。apps全部命令必须 User Token + spark scope。 - 破坏性操作先问用户:
board delete、slides delete-slide、slides history revert(整份演示文稿回到历史版本)、apps delete、把妙搭应用设为--scope public前先向用户确认。board import/update/create-notes --overwrite会清空整张画板(含其他图表),board update --overwrite先加--snapshot old.json留备份;board delete没有确认门禁、立即执行,先--dry-run看要删的节点。 演示文稿误改用slides history revert回滚(需确认,非交互环境加--yes)。删除类命令以退出码 10 返回时是在等确认, 不要自行补--yes,先取得用户同意。 - 不重复写入:画板写入结果不明时,
board update/svg-import/create-notes/import --engine local用同一个--client-token重跑;服务端board import不接受 client token(CLI 自动重试前会回读去重), 命令失败后要重跑先用board nodes确认上次没有落地。 - 妙搭发布需用户明确同意:先
apps html-publish --dry-run,确认would_block=false;--wait或apps release get看到finished才算发布完成,online_url默认仅创建者可见。 - 落地后自检:画板用
board image看缩略图(写入后可能滞后 10–20 秒)、Slides 用slides screenshot、 HTMLBox 落库前跑verify.sh;改动色板或底色后运行 dataviz 校验脚本,原样使用已校验色板无需重复验证。
主题和风格是默认选项,优先满足用户指定的品牌色、明暗主题和载体,并验证可读性。
删除、覆盖类命令返回退出码 10 时,向用户确认目标与影响后追加全局 --yes 重跑,不要自行添加。身份或 scope 报错(如 99991663/99991668/99991672/99991679)读取 ../feishu-cli-platform/references/workflows/auth/references/identity.md;判断成败、编写脚本或处理确认门禁读取 ../feishu-cli-platform/references/workflows/auth/references/agent-contract.md。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/riba2534/feishu-cli/feishu-cli-visual">View feishu-cli-visual on skillZs</a>