SuperAPI AI 工具集

jupyter-notebook

编程与开发

查看项目

更新于 10-16 02:32

技能介绍

用途:通过实时 Jupyter 内核提供有状态的 Python REPL,变量、导入和对象在多次执行间持续存在。适合需要逐步累积状态、探索 API、检查 DataFrame 或迭代复杂代码的场景;若任务适合用 Jupyter notebook,就应使用本技能。一次性脚本且需访问 hermes 工具(如 web_search、文件操作)应改用 execute_code,Shell 命令、构建、安装、git 和进程管理应使用 terminal。

主要能力:发现服务器与 notebook;执行代码(核心操作,状态跨调用保留);查看实时变量列表与预览;查看、插入、替换、删除 notebook 单元格;通过 restart-run-all 重启并全量运行以验证。所有命令返回结构化 JSON,建议始终加 --compact 节省 token。

使用方式:前置条件为已安装 uv(which uv 检查)和 JupyterLab(uv tool install jupyterlab),并运行 Jupyter 服务器。脚本路径为 $HOME/.agent-skills/hamelnb/skills/jupyter-live-kernel/scripts/jupyter_live_kernel.py,未克隆时执行 git clone https://github.com/hamelsmu/hamelnb.git ~/.agent-skills/hamelnb。用 uv run "$SCRIPT" servers --compact 检查服务器,无则启动 jupyter-lab --no-browser --port=8888 --notebook-dir=$HOME/notebooks --IdentityProvider.token='' --ServerApp.password=''。纯 REPL 可创建 scratch.ipynb 并通过 REST API 启动内核会话。执行示例:uv run "$SCRIPT" execute --path <notebook.ipynb> --code '<python code>' --compact。注意子命令标志如 --path 要放在子子命令之前。

限制:首次执行可能因内核初始化超时,重试即可;内核 Python 是 JupyterLab 的 Python,额外包需装到该环境;默认每次执行 30 秒超时,长任务可传 --timeout 120;无活动内核会话时无法执行;错误以 JSON 加 traceback 返回,可读 ename 与 evalue;偶发 websocket 超时,可重试一次,持续失败可改用 --transport zmq;REST 专用新服务器需加 --ServerApp.disable_check_xsrf=True。