需通过 vscode Notebook API 实现自定义交互：一、注册 NotebookProvider 管理读写执行；二、实现 KernelProvider 处理代码执行与输出；三、注册 CellRenderer 接管单元格渲染；四、绑定上下文命令；五、监听生命周期 事件。
如果您在使用 VSCode 的 Notebook 功能时希望扩展其行为、添加专属单元格类型或控制执行流程，则需要通过 Notebook API 进行编程式干预。以下是实现自定义交互式体验的具体方式：
本文运行环境：MacBook Pro，macos Sequoia。
一、注册自定义 Notebook 提供程序
VSCode 通过 NotebookProvider 接口 允许扩展声明并管理一种 Notebook 类型，包括读取、写入、执行和保存逻辑。该提供程序是所有自定义行为的入口点，必须在激活扩展时注册。
1、在 extension.ts 中调用 vscode.notebooks.registerNotebookProvider 方法。
2、传入唯一 字符串 标识符（如 ‘myCustomNotebook’）作为 viewType 参数。
3、实现 resolveNotebookContent 方法，从文件路径加载原始内容并转换为 NotebookData 对象。
4、实现 saveNotebook 方法，将 NotebookData 序列化为指定格式（如 jsON 或自定义二进制结构）并写入磁盘。
二、定义可执行单元格内核
要使 Notebook 支持代码执行，需实现 KernelProvider 并返回一个 Kernel 实例，该实例负责处理单元格的编译、运行与输出渲染。内核决定了语言支持、执行上下文及错误反馈机制。
1、创建类 MyKernel 实现 vscode.NotebookKernel 接口。
2、在 kernel 的 executeCells 方法中，遍历传入的 cell 元素，提取 source 字段内容。
3、调用子进程或语言服务（如 python 的 Pyodide、javaScript 的 QuickJS）执行代码片段。
4、将执行结果 封装 为 NotebookCellOutput，并通过 onDidChangeOutputs 事件触发 UI 更新。
三、注入自定义单元格渲染器
默认情况下，VSCode 使用内置 markdown 和代码渲染器。通过注册 NotebookCellRenderer，可完全接管某类单元格的视觉呈现，例如嵌入图表控件、实时预览区或富文本编辑器。
1、在 package.json 的 contributes.notebookCellRenderers 字段中声明 renderer ID。
2、实现 vscode.NotebookCellRenderer 接口，重写 render 方法。
3、在 render 方法中创建 iframe 或 WebviewPanel，加载独立 html/css/JS 资源。
4、通过 postMessage 向渲染器传递 cell metadata 和 outputs，并监听用户交互事件。
四、添加上下文感知的命令操作
VSCode Notebook 支持为特定单元格类型绑定右键菜单项或快捷键命令。这些命令可根据当前选中单元格的语言、metadata 或执行状态动态启用或禁用。
1、在 package.json 的 contributes.menus 字段中配置 notebook/cell/context 菜单项。
2、设置 when 条件表达式，例如 notebookEditorFocused && notebookCellType == ‘code’。
3、在 extension.ts 中注册对应 command，使用 vscode.window.activeNotebookEditor 获取当前编辑器。
4、调用 editor.selections 获取选中单元格索引，再通过 editor.notebook.getCells() 提取目标 cell 对象。
五、监听 Notebook 生命周期事件
VSCode 提供了 notebookDocument.onDidOpen、onDidChangeContent、onWillSave 等事件钩子，可用于在文档状态变化时触发逻辑，例如自动格式化、版本快照或权限校验。
1、在扩展激活函数中获取 vscode.workspace.notebookDocuments 数组。
2、对每个已打开的 NotebookDocument 调用 onDidChangeContent 注册监听器。
3、在回调中检查 Event.contentChanges 是否包含 cell source 修改。
4、若检测到关键字段变更，调用 vscode.window.showInformationMessage 显示 内容已修改，建议保存 提示。
