SuperAPI AI 工具集

export-ml-notebook

数据与分析

查看项目

更新于 10-16 05:42

技能介绍

用途:export-ml-notebook 将 jupytext 百分号格式(# %%)的 Python 源文件写出为派生的 .ipynb,.py 始终是唯一来源;该技能不根据 notebook 反写 .py,也不以 cells run 代替导出。

主要能力:执行 python -m skore_skills notebook fill data_analysis/data_analysis.py 进行填充,默认文件为 data_analysis/data_analysis.py(用户未指定时)。experiments/<stem>.py 与 audit/<stem>.py 以同样方式填充。填充不执行文件,代码单元的输出保持为空,依赖 jupytext 和 nbformat,不需要 nbclient、ipywidgets 或 IPython。可选 --out path.ipynb。除非用户要求由 setup-git 跟踪,*.ipynb 保持被 gitignore 忽略。

用法与策略:python -m skore_skills status 查看状态并读取 policy.notebooks。若为 null,则先 python -m skore_skills policy set notebooks true,再加载 add-python-package 获取 jupytext 与 nbformat。若为 false,说明 notebook 功能已关闭并提供开启选项,开启前不填充。用户要求 HTML 或站点查看器时加 --html(需 nbconvert,写出与 .py 同目录的自包含 <stem>.nb.html);若 policy.site 为 true 且已安装 export-ml-site,运行 python -m skore_skills site build --if-stale,仅在用户要求 HTML 或站点查看器时执行。内核 notebook convert 仅用于本身即执行的源(未拟合实验快照)并注入 %matplotlib inline,转换后剥离该设置单元;不要把它写入 .py。

适用场景:需要把分析、实验或审计的百分号 Python 文件生成 notebook,或进一步生成 HTML 查看器时。

限制:不执行代码、不产生代码单元输出;缺少 jupytext/nbformat/nbconvert 时仅一行跳过;不执行 git commit;不使用 pixi add / uv add,而是加载 add-python-package。填充失败不应报错为整体失败,也不得声称网站已更新。文档未说明收费、价格或具体运行平台。