SuperAPI AI 工具集

positron-notebooks

编程与开发

查看项目

更新于 10-16 03:44

技能介绍

用途:为开发 Positron Notebooks(Positron 中基于 React、由功能开关控制的笔记本编辑器)提供专门知识与工作流程。它与 VS Code 标准笔记本体验并存;涉及单元格行为(执行、渲染、编辑)、选择与焦点管理、上下文键系统、单元格操作命令与菜单、笔记本与内核集成、输出渲染与 webview、E2E 或单元测试以及问题调试时可加载。

必要用法:启用前需设置功能开关,在 settings.json 中加入 "positron.notebook.enabled": true 与 "workbench.editorAssociations": { "*.ipynb": "workbench.editor.positronNotebook" },修改后重启 Positron。开发前可运行 ./scripts/validate_setup.sh 校验构建守护进程与路径,或用 ps 检查 watch 进程。测试用 ./scripts/test_notebooks.sh(可带用例模式),或直接执行 npx playwright test test/e2e/tests/notebook/<test-name>.test.ts --project e2e-electron --reporter list。搜索代码可用 ./scripts/find_notebook_code.sh "executeCell" 或 "selectionMachine"。

主要能力与核心文件:命令注册与编辑器解析在 src/vs/workbench/contrib/positronNotebook/browser/positronNotebook.contribution.ts;核心逻辑与状态管理在 PositronNotebookInstance.ts;React 根组件在 PositronNotebookEditor.tsx;单元格组件在 notebookCells/;选择状态机在 selectionMachine.ts;上下文键在 ContextKeysManager.ts;单元格模型在 PositronNotebookCells/。架构上基于 observable 驱动 React UI,复用 VS Code 笔记本模型、内核与执行服务;每个输出各用一个 webview;上下文键作用于单元格 DOM 子树。

架构要点与限制:功能开关控制,与 VS Code 笔记本并存;优先新增文件而非改动 VS Code 既有文件以保持上游兼容;无虚拟化,所有单元格均渲染,大笔记本需考虑性能;每个输出独立 webview,需谨慎协调挂载生命周期。文件路径若失效应先用 ls 或 find 核实再更新。更详细内容见随附 references/architecture.md、references/debugging-guide.md、references/common-patterns.md 及 src/vs/workbench/contrib/positronNotebook/docs/positron_notebooks_architecture.md。具体支持平台、收费与 License 信息资料未提供。