用途：让 agent 在用户正在运行的实时 marimo notebook 中工作，运行 Python、检查状态并提交持久改动。
主要能力：通过 execute_code 在用户的同一内核中执行代码；读取单元格、变量与数据流图；创建、编辑、删除、运行单元格；管理依赖包；设置 mo.ui.* 控件值；检查实时变量与控件状态。
使用方式：会话开始时必须先单独执行 import marimo._code_mode as cm 与 help(cm)，确认成功后再调用其他 cm API；所有持久化改动必须经由 marimo._code_mode（cm）完成，直接编辑磁盘 .py 文件不会到达实时内核，且可能被覆盖。持久化通过 async with cm.get_context() as ctx 排队操作，队列在上下文正常退出时应用，异常则丢弃；控件方法为同步调用，不要 await。包管理使用 ctx.packages.add()/remove()。
适用场景：在代码编辑器内辅助用户开发、调试和改进 marimo notebook，检查数据流与实时状态，持久化新增或调整的单元格。
限制：marimo 要求无循环依赖、公共名称不可跨单元格重复定义、禁止通配符导入；cm 为私有不稳定 API，仅限 scratchpad 使用，不得写入 notebook 单元格或库代码。create_cell 目前默认 hide_code=True。更深入的陷阱与可视化指南需通过 load_capability 加载对应能力文档。