SuperAPI AI 工具集

streamlit-app

通用与其它

查看项目

更新于 10-16 09:49

技能介绍

用途:在 OWID 的 Wizard 环境中创建或修改 Streamlit 应用,适用于构建新的 Wizard 应用、添加 Streamlit 页面,以及处理 apps/wizard/ 目录下的代码。

主要能力与结构:应用位于 apps/wizard/app_pages/ 目录。新建应用需创建 apps/wizard/app_pages/your_app/app.py,并在 apps/wizard/config/config.yml 的对应区块 apps 列表中注册,字段包括 title、alias、entrypoint、description、maintainer、icon。

运行方式:可用 make wizard 或 .venv/bin/etlwiz <alias> 启动。

提供的工具:st_cache_data 支持缓存(含 ttl、show_time,也可在 Streamlit 之外使用);url_persist 提供 URL 同步的可分享组件状态(注意布尔值以 "True"/"False" 字符串存储在 URL 中);grapher_chart 与 grapher_chart_from_url 用于渲染 OWID 图表;load_variables_in_dataset、load_variable_data 用于加载数据;OWID_ENV 与 get_engine、Session 用于环境与数据库访问。组件层还包含 st_horizontal、Pagination、st_wizard_page_link、st_tag、tag_in_md、st_toast_success、st_toast_error、preview_file 等。

规则:st.set_page_config() 必须是首个 Streamlit 命令;耗时操作应使用 @st_cache_data;可分享的组件状态应使用 url_persist();Material 图标使用 :material/icon_name: 格式;HTTP 请求必须设置 timeout=30 并调用 .raise_for_status()。