在本机安装 Jupyter 工作台¶
已有在线 IDE 账号时可直接进入平台，无需重复安装。本节用于希望在自己电脑上运行 Notebook 的读者。
先取得配套安装包¶
向维护者取得 CASCAQit SDK 和 CASCAQit-Jupyter 的配套 wheel，以及对应的校验摘要和版本说明。私有仓库的 Release 下载需要访问权限。wheel 包含 Python 连接包和预构建的前端扩展，安装 wheel 不需要 Node.js；从源码构建前端才需要它。
不要仅凭 pip 能安装成功就认定两个版本兼容。独立 IDE 的版本锁使用 SDK 1.0.8a0、cascaqit-jupyter 0.2.0a1+ide.ee39d64.1、Bokeh 3.4.3。其中扩展包含对 SDK 操作接口的适配，不等同于直接安装上游 0.2.0a1。这组数字用于识别该发行组合，不代表所有线上环境都已安装相同版本。
本学习站构建所用的依赖锁也不应直接装进 Jupyter 环境：Jupyter 扩展要求 Python Bokeh 与随附 BokehJS 匹配，而站点构建是另一套运行环境。
安装到单独的虚拟环境¶
以下以 macOS/Linux 为例。先将维护者提供的一对 wheel 放入 wheelhouse；把命令中的大写文件名替换为实际文件名，不要使用来源不明的同名包。
python3.11 -m venv .venv
source .venv/bin/activate
python -m pip install ./wheelhouse/SDK_WHEEL.whl ./wheelhouse/JUPYTER_WHEEL.whl \
"jupyterlab>=4,<5" "notebook>=7,<8" ipykernel
python -m pip check
jupyter labextension list
jupyter lab
Windows PowerShell 可用 py -3.11 -m venv .venv，随后使用 .venv\Scripts\python.exe 和 .venv\Scripts\jupyter.exe 执行对应命令。检查扩展列表中 @cascaqit/jupyter 是否已启用且状态为 OK；在 Notebook 中再按版本检查确认内核。
Jupyter 启动后使用终端给出的本机地址及访问令牌。不要关闭认证来解决登录问题。Notebook 可以执行普通 Python，打开他人的文件后先阅读代码，再决定是否运行。
Code、补全和 Git¶
普通 Notebook、量子编辑器和结果展示不要求安装 code-server。需要 Code 页面时，再按 Jupyter 项目的安装说明安装 ide 可选依赖组和 code-server。项目安装脚本支持 macOS/Linux；Windows 用户可使用 Notebook，不能据此假定该 code-server 脚本支持原生 Windows。
ide 依赖组还提供 Python 语言服务和 Git 面板。代码补全可使用 Ctrl+Space 或 Jupyter 的 Tab；调试能力取决于当前 Jupyter 和 ipykernel。Code 与 Notebook 应选择同一 Python 环境，但不会共享内存变量。
GitHub Codespaces¶
上游提供 Codespaces 入口，需要账号能读取私有 Core 仓库。其配置下载固定的 SDK Release wheel，并不自动跟随学习站 dev。创建后从 PORTS 面板打开 JupyterLab，保持端口私有；需要查看令牌时在自己的 Codespace 终端运行 jupyter server list。
Codespaces 是另一种开发环境，不等于已获得独立 IDE 平台账号。使用前核对当前仓库说明、权限和可用额度。
下一步：第一个 Notebook 实验。出现依赖冲突时保留安装日志和版本清单，见排查问题。