SuperAPI AI 工具集

notebook-cli

通用与其它

查看项目

更新于 10-16 06:21

技能介绍

用途:用 nb 命令行工具统一处理所有 .ipynb 操作,不建议在 nb 能完成时直接读写或修补笔记本 JSON。

主要能力:读取与检查笔记本(nb read,默认 AI 优化 Markdown,可用 --json 获取 nbformat JSON);按单元格 ID 或索引编辑(支持负数索引);添加/删除单元格;搜索内容(nb search);执行单元格并调试(nb execute,可指定 --cell-index、--start/--end、--allow-errors);管理输出(nb read --limit --output-dir、nb output clear、nb output clean);在连接模式下与 JupyterLab 同步(nb connect、nb status、nb disconnect);创建笔记本 (nb create,可选 --kernel、--markdown、--uv)。

使用方式:编辑前先检查,如 nb read <notebook> --no-output;优先单元格 ID 做持久编辑,索引适合快速定位;多行内容用 stdin(--source -)避免转义错误;创建含多节的笔记本时按逻辑每批约 3–5 个单元格添加并逐批执行验证;markdown 单元格需含标题和至少一句说明;依赖第三方包时在导入前加安装单元格,有 uv 用 !uv pip install ...,否则用 %pip install ...;语法不确定时运行 nb <command> --help 或 nb cell <subcommand> --help;若用户指定 uv 或工作区明显是 uv 项目,用 --uv。非笔记本 Python 命令可用 nb status --python 获取前缀。

限制与安全:nb 是外部可执行文件,首次使用前应验证(command -v nb、nb --version),只使用仓库构建或文档指定的 nb-cli;若路径或版本异常应停止。连接模式复用 nb connect 保存的连接,不要在命令、提示、日志或示例中写入令牌。若沙盒策略禁止运行 nb,需请用户授权相应命令前缀。

适用场景:笔记本的读取、编辑、执行、调试、输出清理及与 JupyterLab 协作。关于收费、价格、平台及未在此提供的细节,资料暂未提供。