interactive-visualization-gptomics-bioskills

1. 基本信息

项目	内容
名称	interactive-visualization-gptomics-bioskills
项目自述名称	Interactive Visualization（SKILL.md 内部标题）
作者/维护者	GPTomics Organization
来源链接	https://github.com/GPTomics/bioSkills/tree/main/data-visualization/interactive-visualization
许可证	MIT（数据来源：GitHub API，仓库级）
GitHub Stars / Forks	所属合集仓库 bioSkills 整体 1,131 / 193（数据来源：GitHub API；⚠️ 为整个合集的数字，不代表本技能自身热度）
最新版本	本子技能内容最近一次提交于 2026-05-29（数据来源：GitHub API commits，按该子目录路径查询）
安装方式	复制 `data-visualization/interactive-visualization/` 整个目录（含 SKILL.md、examples/、usage-guide.md）到 agent 的 skills 目录

2. 功能介绍与亮点

覆盖 plotly（Python/R 双语言）、bokeh、altair、gganimate、htmlwidgets 生态，产出可缩放、可悬停、可平移的交互式 HTML 图表，用于笔记本探索、在线补充材料或看板
明确区分“交互输出”与“期刊投稿静态图”的定位——交互 HTML 是补充而非替代，始终建议同时导出静态版本
系统讲解 2025 年 plotly 静态导出链路的重大变化：orca 已终止维护、engine='orca' 参数在 plotly 6.2 后移除、Kaleido v1+ 成为新标准但不再自带 Chrome、且 v1 起不再支持 EPS 导出
6 类具体失败模式对照表（如静态导出静默失败、HTML 文件因大数据点膨胀至 10MB+ 导致浏览器卡死、gganimate 大帧数渲染耗时过长、交互图被误当作论文正式图表提交等），逐条给出触发条件、机制、症状与修复方法
附带 usage-guide.md 与可运行的 Python 示例脚本 examples/interactive_volcano.py（交互式火山图）

3. 适用场景

所属分类：数据分析与可视化

面向需要为数据探索、在线补充材料或分析看板制作交互式图表的生物信息学研究者与数据分析师——典型场景包括笔记本中的 PCA/降维散点探索（悬停显示样本信息）、期刊在线补充材料的可缩放图表、多时间点数据的动画展示、Streamlit/Dash 类看板的图表底层实现。用户可用自然语言描述需求（如“把这张 PCA 散点图改成 plotly 交互版，悬停显示样本 ID 和分组，超过 5000 个点时自动启用 WebGL 加速”），由 agent 直接产出可运行代码，并提醒同时导出符合期刊要求的静态版本，避免误把交互图当作正式图表提交。

4. 跨 Agent 兼容性

Claude Code：✅ 原生支持——标准 SKILL.md（YAML front matter + 指令正文），可直接复制进技能目录使用
Codex：✅ 遵循同一 Agent Skills 规范格式，可安装使用
OpenClaw：✅ 同上，格式通用
Hermes Agent：✅ 已获官方确认——Hermes Agent 生物信息学技能网关文档（docs/user-guide/skills/optional/research/research-bioinformatics）的「Data Visualization & Reporting」类目按目录名精确列出 interactive-visualization

5. 推荐理由

交互式图表是数据探索与在线补充材料的常见需求，但 plotly 生态在 2025 年经历了静态导出链路的重大变更（orca 终止、Kaleido v1 不再自带 Chrome、EPS 导出移除），沿用旧教程代码极易踩坑；同时“交互输出能否直接当论文图表”这类边界问题也容易被忽视。该技能把 plotly/bokeh/altair/gganimate 等多个交互绘图库整合进统一心智模型，明确交互与静态图表的分工边界，并系统列出真实高频报错的触发条件与修复方法，帮助 agent 一次产出既能用又符合投稿规范的交互式可视化代码。

6. 评分

维度	分数	说明
受欢迎程度	6	所属合集仓库 GPTomics/bioSkills 整体 1,131 stars，该数字属整个合集，不代表本技能自身热度；本技能在 Hermes Agent 官方生物信息学技能网关的 Data Visualization & Reporting 类目中被按目录名精确收录
可用性	9	SKILL.md + 独立 usage-guide.md + 可运行 Python 示例脚本；`pip install plotly bokeh kaleido altair` 一条命令即可安装依赖；仓库最近一次推送为 2026-07-25，本技能所在路径最近一次提交为 2026-05-29；无付费依赖
安全性	9	纯提示词模板 + 本地绘图代码，无 shell 命令执行、无运行时联网外发、无需 API key 或凭据；MIT 许可证明确；通读全文与示例代码未见混淆逻辑或可疑指令

安全检查清单：①无 shell 命令执行，示例代码仅调用 Python 绘图库函数　②运行时不联网　③无需任何凭据　④SKILL.md 与示例脚本均为公开绘图代码，未见可疑指令　⑤GPTomics 为持续维护该开源生物信息学技能合集的组织账号，公开仓库活动未见刷星或误导性描述等造假迹象　⑥MIT 许可证清晰　⑦本技能所在路径最近一次提交为 2026-05-29

7. 跟同类 Skills 相比的优势

维度	interactive-visualization（本技能）	ggplot2-fundamentals（同合集静态图方案）	developing-with-streamlit（看板类技能）
输出形态	可缩放/悬停/平移的交互式 HTML	期刊发表级静态矢量图	完整交互式 Web 应用看板
覆盖库	plotly（Python/R）、bokeh、altair、gganimate、htmlwidgets	仅 ggplot2	仅 Streamlit 框架
核心痛点	交互与静态导出链路的版本变更（Kaleido/orca）	R 图形语法分层组合与期刊配色规范	应用级状态管理与组件布局

三者定位不重叠：静态发表图表首选 ggplot2-fundamentals，需要完整看板应用选 developing-with-streamlit，而单纯为某张图加悬停/缩放交互或做动画时间序列展示，本技能是更轻量的选择。

8. 用户评价

该技能目前在第三方平台尚无具名用户评价；所属仓库的公开 Issue 与 PR 记录中可见独立于维护者账号的外部贡献者，但未见针对本子技能的具名反馈。

9. 其他补充

SKILL.md 的「Related Skills」交叉引用同合集内的 reporting/quarto-reports（在报告中嵌入交互 HTML）、reporting/rmarkdown-reports（Rmd 中使用 htmlwidgets）、data-visualization/ggplot2-fundamentals（作为 ggplotly 转换的输入）、data-visualization/dimensionality-reduction-plots（交互式 UMAP/PCA 探索）与 data-visualization/network-visualization（PyVis 交互网络图），可见本技能是合集内多个可视化技能的交互层补充。

10. 安装使用方式

从 GitHub 下载或克隆仓库子目录：data-visualization/interactive-visualization/
复制整个目录（含 SKILL.md、examples/、usage-guide.md）到所用 agent 的 skills 目录（如 Claude Code 的 ~/.claude/skills/ 或项目内 .claude/skills/）
Python 侧依赖：pip install plotly bokeh kaleido altair；R 侧依赖：install.packages(c('plotly', 'gganimate', 'htmlwidgets', 'DT', 'leaflet'))
静态导出需额外确认系统已安装 Chrome/Chromium（Kaleido v1+ 不再自带）
无需重启 agent，安装后下次对话即可通过自然语言描述交互图表需求触发（如“把这张散点图转成 plotly 交互版，悬停显示样本 ID”）

11. 注意事项

Kaleido v1+ 不再自带 Chrome，静态导出前需自行确认系统已安装 Chrome/Chromium，否则导出会静默失败
交互式 HTML 不可作为期刊正式图表提交，仅可作为在线补充材料，正式图表仍需按 ggplot2-fundamentals 等静态方案单独导出
仓库为社区维护的生物信息学技能合集，非任何厂商官方出品，选用前建议自行核对示例代码与当前环境中的库版本是否匹配