通过实时 Jupyter 内核给你一个有状态的 Python REPL。变量在执行间持久化。当你需要增量构建状态、探索 API、检查 DataFrame 或迭代复杂代码时使用此工具。
| 工具 | 何时使用 |
|---|---|
| 此 skill | 迭代探索、跨步骤状态、数据科学、ML、"让我试试这个并检查" |
execute_code | 需要 hermes 工具访问的一次性脚本。无状态。 |
terminal | Shell 命令、构建、安装、git、进程管理 |
经验法则：如果任务你会想要 Jupyter notebook，用此 skill。
which uv）uv tool install jupyterlabhamelnb 脚本位置：
SCRIPT="$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
如未找到服务器，启动一个：
jupyter-lab --no-browser --port=8888 --notebook-dir=$HOME/notebooks
--IdentityProvider.token='' --ServerApp.password='' > /tmp/jupyter.log 2>&1 &
sleep 3
所有命令返回结构化 JSON。始终使用 --compact 节省 token。
uv run "$SCRIPT" servers --compact
uv run "$SCRIPT" notebooks --compact
uv run "$SCRIPT" execute --path --code '' --compact
状态在执行调用间持久化。变量、导入、对象都存活。
多行代码用 $'...' 引用：
uv run "$SCRIPT" execute --path scratch.ipynb --code $'import osnfiles = os.listdir(".")nprint(f"Found {len(files)} files")' --compact
uv run "$SCRIPT" variables --path list --compact
uv run "$SCRIPT" variables --path preview --name --compact
# 查看当前单元格
uv run "$SCRIPT" contents --path --compact
# 插入新单元格
uv run "$SCRIPT" edit --path insert
--at-index --cell-type code --source '' --compact
# 替换单元格源代码
uv run "$SCRIPT" edit --path replace-source
--cell-id --source '' --compact
# 删除单元格
uv run "$SCRIPT" edit --path delete --cell-id --compact
仅在用户要求干净验证或你需要确认 notebook 从上到下运行时使用：
uv run "$SCRIPT" restart-run-all --path --save-outputs --compact
execute。--path 放在子子命令前。ename 和 evalue 字段。脚本每次执行有 30 秒默认超时。对于长时间运行操作，传递 --timeout 120。
评论区