01 前端界面改造：Launcher 增加 DeepAnalyze + 自定义布局

目标：

1. 在 JupyterLab 的 Launcher 页面增加一个入口：DeepAnalyze。
2. 点击后进入 “DeepAnalyze 模式”：创建一个新目录作为工作区，并打开一个自定义主界面：
   • 左侧：保持原生文件浏览器（不需要你重写，只需要切换工作目录）。
   • 中间：一个 Notebook（用于展示模型输出）。
   • 右侧：上下两栏，上栏是终端（运行交互式 CLI，例如类 Claude Code），下栏是 Notebook（用于实时运行代码）。

你需要改哪些文件

• src/index.ts：扩展入口，注册命令、向 Launcher 注入入口、构建并打开自定义主界面。
• 未来建议新增：src/deepanalyze/widget.tsx（或 src/deepanalyze/widget.ts）：把 UI 组合逻辑从 index.ts 拆出来，便于维护。

关键 JupyterLab API（你会用到）

• Launcher 注入：ILauncher（@jupyterlab/launcher）
• 打开主区域 Tab：MainAreaWidget（@jupyterlab/apputils）
• Notebook 组件：NotebookPanel/NotebookActions（@jupyterlab/notebook）
• 终端组件：Terminal（@jupyterlab/terminal）
• 文件系统/目录：app.serviceManager.contents（@jupyterlab/services），文件浏览器 IFileBrowserFactory（@jupyterlab/filebrowser）
• 布局容器：SplitPanel（@lumino/widgets）

步骤 A：在 Launcher 增加 DeepAnalyze 入口

在 src/index.ts 的 plugin 里：

1. 注入依赖：ILauncher、IFileBrowserFactory（至少这两个）。
2. 注册一个命令（command id 示例：deepanalyze:open）。
3. 调用 launcher.add({ command, category, rank }) 把命令放进 Launcher。

建议的插件骨架（结构要点，按需增减依赖）：

const plugin: JupyterFrontEndPlugin<void> = {
  id: 'deepanalyze:plugin',
  autoStart: true,
  requires: [ILauncher, IFileBrowserFactory],
  activate: (app, launcher, browserFactory) => {
    const command = 'deepanalyze:open';
    app.commands.addCommand(command, {
      label: 'DeepAnalyze',
      execute: () => openDeepAnalyze(app, browserFactory)
    });
    launcher.add({ command, category: 'Other', rank: 50 });
  }
};

步骤 B：点击后创建工作区目录，并切换左侧文件浏览器目录

建议策略：每次进入模式时创建一个唯一目录，例如 DeepAnalyze-YYYYMMDD-HHMMSS/，并切到该目录。

关键调用（示意）：

const { contents } = app.serviceManager;
const dir = await contents.newUntitled({ type: 'directory', path: '' });
await browserFactory.defaultBrowser.model.cd(dir.path);

步骤 C：构建“中间 Notebook + 右侧上下分栏”的主界面

思路：用 Lumino 的 SplitPanel 组合三个区域：

• 外层 SplitPanel（水平）：[ 中间Notebook | 右侧SplitPanel ]
• 右侧 SplitPanel（垂直）：[ 终端 | 右下Notebook ]

关键点：

• “中间 Notebook”和“右下 Notebook”建议都用 docManager.newUntitled 创建 .ipynb，再用 docManager.openOrReveal 打开为 NotebookPanel，这样自带 kernel/session 生命周期。
• “终端”建议创建一个新 terminal session：app.serviceManager.terminals.startNew()，再用 Terminal widget 绑定。
• 最后把外层容器塞进 MainAreaWidget 并 app.shell.add(widget, 'main')。

补充：终端依赖 Jupyter Server 允许 terminals（有些部署会禁用）。如果你发现终端不可用，优先检查服务器配置与权限；或临时用自定义“聊天面板”替代真实终端 widget。

你可能要补齐的知识

• JupyterLab 4 扩展机制：插件（JupyterFrontEndPlugin）、命令系统（app.commands）、Shell 区域（app.shell）。
• Lumino 布局：SplitPanel、BoxPanel、widget 生命周期（dispose()）。
• Notebook 模型与渲染：NotebookPanel.content.model、cell/outputs 结构。
• JupyterLab 服务：Contents/Terminal/Kernel/Session（@jupyterlab/services）。

验证与调试

• 本地开发：jlpm watch + jupyter lab（见仓库 README.md）。
• 单元测试：jlpm test
• 集成测试：参考 ui-tests/README.md