量子实验脚本执行

技能简介

该技能用于在预配置的Qiskit虚拟环境中执行quantum_lab仓库内的Python脚本和演示程序，支持数学实验、纯数学演练、应用子命令及Jupyter笔记本的运行。

业务背景

面向量子计算研究人员与算法工程师，提供开箱即用的Qiskit实验环境。无需手动配置Python虚拟环境与依赖，即可直接运行量子数学建模、算法验证及交互式演练脚本，大幅降低量子开发门槛，让团队专注于算法设计与业务创新而非环境运维。

落地案例：某研发团队需验证新量子优化算法，研究员通过「gl/ql self-tests」一键执行quant_math_lab.py完成基础数学校验；随后调用「gl/ql playground」启动交互环境调试参数，最终通过「gl/ql app」在本地8080端口启动quantumapp.server服务，供团队成员浏览器访问查看可视化结果。全程无需关心Qiskit版本兼容或依赖安装问题。

能做什么

• 执行quant_math_lab.py等核心量子计算脚本
• 运行quantum_app.py的子命令（自测、交互环境）
• 启动quantumapp.server本地服务
• 执行Jupyter笔记本文件
• 通过快捷指令gl/ql简化命令输入

使用说明

安装步骤：

1. 确保系统已安装bash环境
2. 克隆或放置技能到指定目录（如~/clawd/skills/quantum-lab）
3. 确认虚拟环境~/.venvs/qiskit存在，若缺失需手动创建并安装依赖
4. 如需安装依赖：bash <SKILL_DIR>/scripts/qexec.sh pip install -r requirements.txt

基本用法：

完整路径模式：bash <SKILL_DIR>/scripts/qexec.sh python quant_math_lab.py

快捷模式（推荐）：bash <SKILL_DIR>/scripts/gl self-tests

可用快捷指令：gl self-tests、gl playground、gl app、gl lab-tests、gl web 8000、gl notebook notebooks/xxx.ipynb

环境变量：QUANTUM_LAB_ROOT覆盖仓库路径（默认$HOME/work/quantum_lab），VENV_PATH覆盖虚拟环境路径（默认~/.venvs/qiskit）

输入与输出

见下方输入与输出表格。

风险提示

• 虚拟环境路径错误将导致脚本执行失败
• 依赖缺失时需手动运行pip安装
• web服务默认绑定127.0.0.1，公网暴露需额外配置
• notebook路径需相对于仓库根目录指定

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/bramdo/quantum-lab/SKILL.md
来源类型：GitHub仓库