IDE 排查问题¶
先判断问题发生在哪里：控制台负责账号和环境，Notebook 内核负责执行，Jupyter 扩展负责画布和结果显示。记录失败步骤和原始提示，比反复刷新更容易找到原因。
| 现象 | 先检查什么 | 下一步 |
|---|---|---|
| 无法登录或验证码失效 | 账号是否开通、密码和验证码是否正确 | 刷新验证码；忘记密码请管理员重置 |
| 创建环境不可用 | 最高规格和保留环境上限 | 请管理员确认权限和规格；停止环境不会释放保留名额 |
| 一直等待资源 | 同时运行上限、环境卡片的原因提示 | 停止不用的运行环境；仍失败时请管理员检查机器容量 |
| “进入 IDE”没有打开页面 | 环境是否运行、浏览器是否拦截新窗口 | 允许该站点弹出窗口，再从控制台进入 |
| 工作区提示无权限或会话失效 | 是否改过密码、账号是否被停用或权限变更 | 回控制台重新登录；不要复制另一用户的工作区地址 |
| 没有 Digital/Analog 按钮 | 是否打开 Notebook、扩展是否启用 | 本机运行 jupyter labextension list；平台环境请管理员检查镜像 |
ModuleNotFoundError |
当前内核路径和包版本 | 运行版本检查，确认没有选错内核 |
| 属性或操作名称不存在 | SDK 与扩展是否配套 | 比较版本说明，保留异常文字，请维护者确认 |
| Bokeh 图空白或版本报错 | Python Bokeh 是否与扩展自带 BokehJS 匹配 | 恢复配套版本；不要只升级其中一侧 |
| 画布改了但结果没变 | 是否只同步了代码，未执行；结果是否过期 | 执行生成单元格或编辑器 Run |
| 显示 Detached | 是否手工修改或删除生成单元格 | 保留原代码，选择“生成到新单元格” |
| 内核重启后变量不存在 | 之前的状态是否只在内存里 | 从头运行定义单元格，或读取导出的结果文件 |
| 保存或写入失败 | 磁盘额度、目录是否属于工作区、权限状态 | 导出可保留内容，检查用量；不要重复执行大规模实验 |
| Code 不可用 | 是否安装 code-server，是否具有终端权限 | 本机参考上游安装说明；平台环境请管理员检查 |
任务长时间运行¶
先确认模拟规模、shots、时间步数和资源限制。资源预算指南说明了如何在扩大规模前估算开销。编辑器允许输入某个原子数量，不保证该环境有足够内存执行。
取消是请求，不代表数值任务已立即终止；以实际任务终态为准。必要时可中断或重启内核，但内存变量会丢失。先保存文件，再考虑停止整个环境。机器离线时让管理员检查原机器，不要通过删除环境尝试恢复文件。
提交问题时保留这些信息¶
- 发生问题的页面、步骤、时间和环境 ID。
- 当前内核的 Python、CASCAQit、CASCAQit-Jupyter 和 Bokeh 版本。
- 原始错误文本、诊断代码，以及能重现问题的最小代码。
- 预期结果和实际结果；画布操作问题可附去除敏感信息的截图。
不要提交密码、token、一次性进入票据、完整认证请求或带敏感输出的 Notebook。实验本身的数值或 API 问题可继续查阅 SDK 排查指南。