SuperAPI AI 工具集

export-ml-site

通用与其它

查看项目

更新于 10-16 05:42

技能介绍

用途:把其他技能产出的文件整理为一个离线 MkDocs 站点,生成 report.html 并用 file:// 地址打开,无需服务器。

主要能力:Markdown 即报告,内嵌图表、TableReport HTML 及由 export-ml-notebook 通过 notebook convert --html 生成的转换笔记本(<stem>.nb.html)。每个实验设计笔记含一个 ## Notebooks 小节,顺序为先 evaluation 后 audit;audit 查看器为 audit/<stem>.nb.html,缺失文件则省略,不使用 <!-- results-embed: audit -->。scratch/results/<stem>/ 下派生的 HTML 与 PNG 查看器可复制进暂存文档;Core Results 标题为 Report overview / Checks / Metrics;额外 slug 通过 <!-- results-embed: <slug> --> 放在 ## Results 或 ## Method 下。桌面端页面在顶栏(实验为可滚动下拉),内容在可折叠左栏旁,报告列宽 1200px;移动端用抽屉。

使用方式:先运行 python -m skore_skills status 读取 policy.site。为 null 时先执行 python -m skore_skills policy set site true,再加载 add-python-package 安装 mkdocs-material,然后 python -m skore_skills site init,最后 python -m skore_skills site build。为 false 时提示站点已关闭并询问是否开启;只有为 true 才可初始化与构建。首次站点轮次运行 site init(仅 gitignore),之后仅 site build。若 site build 报错 mkdocs-material is required,经 add-python-package 安装后再次构建,不要用 pixi add / uv add。工作流检查点使用 site build --if-stale,输入未变则跳过 MkDocs。仅在 policy.site 为 true 时启用自动构建。

限制:不要手工组装站点;不要在此流程中执行 notebook convert、git commit 或 git end-turn;不要转换或执行 # %% 脚本;不要复制或链接 gitignored reports/ 下的序列化文件;构建未成功前不得声称网站已更新。资料未说明具体收费、平台支持或其他功能。