PennyLane Demos 使用入门:demo CLI 工具从创建到构建 HTML 完整教程

发布时间:2026/10/24 6:15:09

PennyLane Demos 使用入门:demo CLI 工具从创建到构建 HTML 完整教程 PennyLane Demos 使用入门demo CLI 工具从创建到构建 HTML 完整教程【免费下载链接】demosIntroductions to key concepts in quantum programming, as well as tutorials and implementations from cutting-edge quantum computing research.项目地址: https://gitcode.com/gh_mirrors/qml/demosPennyLane Demos 是一个开源量子计算演示合集收录了量子编程核心概念与前沿研究的教程。本教程将带你一步步使用内置的 demo CLI 工具完成“创建演示 → 编写代码 → 构建 HTML”的完整流程让你用几条命令就能把自己的量子程序发布成演示网页。为什么需要 demo CLI 工具手写演示项目涉及不少繁琐工作建目录、填元数据 JSON、管理依赖版本、跑 Sphinx 构建……demo CLI 工具把整个过程封装成了 3 条命令命令作用demo new交互式创建新演示项目自动生成 3 个标准文件demo build把演示构建为 HTML / JSON可执行代码生成输出demo help查看全部命令的帮助信息CLI 的入口实现位于 lib/demo/app/app.py命令解析基于typer框架。第一步一分钟一键安装 demo CLICLI 要求Python 3.11见 pyproject.toml建议使用虚拟环境安装# 获取代码 git clone https://gitcode.com/gh_mirrors/qml/demos cd demos # 创建并激活虚拟环境 python3.11 -m venv .venv source .venv/bin/activate # 安装并验证 CLI 工具 pip install . demo看到包含help/new/build的命令面板即安装成功。Windows 用户用\.venv\Scripts\activate激活环境即可。 完整的安装说明与命令参考见 documentation/demo-cli.md。第二步用 demo new 创建你的第一个演示执行demo new按提示依次回答几个问题Title演示标题不能为空Custom directory name目录名会按标题自动生成下划线格式可修改Description一句话简介用作网站 SEO 描述Author(s)你的 pennylane.ai 用户名可添加多位作者Thumbnail / Large Thumbnail可选的缩略图路径留空会使用占位图确认后CLI 会在demonstrations_v2/下生成标准三件套文件用途demo.py演示主体Markdown 导语 可执行代码metadata.json标题、作者、分类、日期等元数据requirements.in该演示额外依赖清单文件模板的生成逻辑在 lib/demo/lib/template.py标题校验与目录名 slug 化规则在 lib/demo/app/app.py。第三步编写 demo 代码与 metadata 元数据demo.py采用“文本 代码”混合写法顶部 docstring 是可渲染的 Markdown 正文代码按顺序执行中间可加注释块把代码切分成独立单元格。可直接参考官方模板 documentation/reference_demo/demo.py。metadata.json决定演示在站点的展示效果字段说明见 demonstrations_metadata.md改动前可对照最新校验规则 metadata_schemas/demo.metadata.schema.0.1.10.json。两个字段尤其重要executable_stable/executable_latest构建时是否真正执行代码。旧演示的目录名以tutorial_开头时缺省也视为可执行previewImages站点头像图需放在_static/demo_thumbnails/下全局公共依赖统一放在 dependencies/ 目录管理你只需在requirements.in里补充自己额外的依赖。第四步用 demo build 构建 HTML 输出代码写好后一条命令即可构建# 构建指定演示为 HTML并执行代码生成图表与输出 demo build --execute --format html your_demo_name # 不指定名称则构建全部演示 demo build常用参数速查参数作用--format html/--format json输出格式默认 JSON--execute执行代码生成输出仅对元数据标记可执行的演示生效--dev/--no-dev使用开发版 / 稳定版依赖默认稳定版--venv name指定安装构建依赖的虚拟环境默认.venv-build--quiet/--keep-going静默输出 / 某个演示失败时继续构建其余演示构建成功后HTML 产物在_build/html/demos/demo_name/直接用浏览器打开预览JSON 产物在_build/pack/demo_name/注意修改源文件后需重新构建且本地构建不含完整样式与公式渲染构建核心逻辑创建虚拟环境、安装依赖、调用 sphinx-build在 lib/demo/lib/demo.py仓库根目录、构建目录等路径常量定义于 lib/demo/context.py。常见构建问题速查demo命令找不到确认已激活虚拟环境且pip install .执行成功构建后没有代码输出--execute只对executable_stable/executable_latest为 true 的演示生效缩略图不显示图片必须放在regular_demo_thumbnails/或large_demo_thumbnails/目录且metadata.json中的路径以/开头依赖版本冲突用--venv指定独立环境或在requirements.in中锁定版本下一步去哪到demonstrations_v2/浏览上百个现成演示模仿其结构与写法阅读 CONTRIBUTING.md 了解演示提交规范分类命名规则见 demonstrations_categories.md掌握 demo CLI 工具后“写量子程序 → 发布成网页”从繁琐的多步流程缩短为几条命令。现在就敲下demo new创建属于你的第一个量子演示吧【免费下载链接】demosIntroductions to key concepts in quantum programming, as well as tutorials and implementations from cutting-edge quantum computing research.项目地址: https://gitcode.com/gh_mirrors/qml/demos创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/21 5:47:20

3 分钟拿到全量成就数据:YaeAchievement 原神成就导出实战指南

3 分钟拿到全量成就数据:YaeAchievement 原神成就导出实战指南 【免费下载链接】YaeAchievement 更快、更准的原神数据导出工具 项目地址: https://gitcode.com/gh_mirrors/ya/YaeAchievement 上周末清完新地区的成就,我想看看自己的总体完成度&a…

2026/10/24 17:15:28

多Agent协作框架agency-agents:如何让大模型团队有序工作

1. 为什么我会做一个叫 agency-agents 的智能体协作框架事情得从一次让我印象深刻的翻车现场说起。当时我在某个内部演示项目里用多个大语言模型 Agent 并行处理一批文档:有的负责摘要、有的负责分类、有的负责提取关键词。理想很丰满,结果却是一场混乱—…

2026/10/24 17:15:28

多智能体协作框架:注册中心+任务路由+智能体网关实战解析

在AI应用落地的圈子里,“多智能体”这个概念最近热度一直很高,但很多人做着做着就发现,单纯把几个模型接口封装成Agent并不难,难的是让这些Agent像一支团队一样有序工作、互相配合、随时扩展。我这次想聊的项目叫“agency-agents”…

2026/10/24 17:15:28

Trae AI实战:7条经验帮你守住AI编程的边界与质量

起初我以为,使用 Trae AI 开发,最难的环节是写提示词、学各种技巧。直到第一个项目被它生成的代码坑到崩溃,我才意识到:真正的问题不在工具,而在使用者对边界的理解。那次我接手一个内部工具,想着有 AI 帮忙…

2026/10/24 17:15:28

星期五下午的骨骼绑定:当旋转四元数遇到万向节死锁的幽灵

周五下午四点,是一周里空气中最容易发酵出焦躁与倦怠的时刻。 斜射进来的金色阳光把窗边白板上密密麻麻的状态机连线染上了一层微红。会议室的玻璃门虚掩着,里面传来战斗动作策划小林与动画组长老赵争执的声音。 “老赵,你看看这个大招的单手…

2026/10/24 17:15:28

Robocup仿真救援代码拆解:多智能体协同策略验证环境

简介:Robocup仿真救援代码面向参加Robocup Rescue仿真竞赛的学生、AI与机器人方向开发者,提供一套可自主决策、搜索、导航与危险评估的救援软件参考实现。压缩包共43个文件,以42个Java源码及1个备份文件为主,整体约74KB&#xff0…

2026/10/24 17:10:28

Windows LSP注入实战:从协议栈劫持到INF注册全链路解析

简介:本资源是一份深入解析LSP(Language Service Provider)注入原理与实现的实战型技术资料,面向Windows底层开发、安全研究及逆向工程学习者,聚焦COM组件机制下的文件操作拦截与扩展技术。压缩包共38个文件&#xff0…

2026/10/23 22:56:35

金融AI落地指南:从调研报告到技术选型与工程实践

简介:这份PDF报告聚焦2025年金融服务业中国AI现状与趋势,面向金融科技从业者、AI战略规划人员及关注行业数字化转型的研究者,帮助读者把握生成式AI在银行、支付、交易等场景中的落地路径与投资方向。资源包内含1个PDF文件,大小约1…

2026/10/24 0:02:40

MATLAB缩进快捷键与批量格式化实战指南

1. 被自动缩进折磨的那些年如果你写过MATLAB代码,大概率经历过这种场景:从某个文档、网页或者聊天记录里复制了一段代码,粘贴进编辑器之后,每一行前面都带着莫名其妙的空格,有的行首是四个空格,有的是一个T…

2026/10/24 0:02:40

用Poco实现Qt风格信号与槽的跨平台C++方案

简介:本资源是一份面向C中级开发者的技术实践工程,聚焦于在非Qt框架环境下模拟实现Qt核心通信机制——信号与槽,借助Poco网络库的事件系统完成解耦式对象通信。适用于需在跨平台C项目中引入松耦合回调机制、但受限于无法集成Qt依赖的开发场景…

2026/10/24 0:02:40

ESXi裸机虚拟化安装指南:从硬件兼容到虚拟机部署

1. 为什么还要折腾ESXi:从一台闲置机器说起手里攒了几台淘汰下来的迷你主机,配置不算差,i5加16G内存,扔了可惜,装个桌面系统又觉得浪费。这种场景下,ESXi就成了一个绕不开的选择。它是一套裸机虚拟化平台&a…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑