SheNicest 2026 夏季千人烈变黑客松 · 正式赛题（选手分发版）
| 文件 / 目录 | 说明 |
|---|---|
LoomQ-赛题手册.pdf |
正式题面，用于官网发布与选手下载 |
LoomQ-赛题.html |
题面网页版（零依赖单文件：无 CDN、无外部字体、无框架），可直接作为活动官网赛题页部署 |
problem_statement.md |
题面 Markdown 源，与 PDF 内容一致，便于线上阅读与检索 |
LoomQ-赛题.docx |
题面 Word 版（由 Markdown 源生成，公式为 Word 原生对象），供组委会流转编辑 |
LoomQ-选手提交流程图.png |
最终提交流程信息图，适合单独转发给选手 |
starter_kit/ |
选手工具包 v1.1.0：提交清单、人工评分证据模板、L2 环境协议、公开自测、容器基线、RISC-V 模拟器、公开电路与上手资料 |
本 fork 已实现 L1、L2、L3 与自定义量子 RISC-V Bonus。完整设计、数据流、隐藏评测
应对方式和代码地图见 starter_kit/SOLUTION_ARCHITECTURE.md。
核心思路不是为三个平台分别硬编码电路，而是先把 OpenQASM 2.0 严格解析为统一的
LoomQCircuit，再发射为 SpinQ OpenQASM 2、本源 OriginIR 和 Braket OpenQASM 3；
Agent 负责把自然语言解释为结构化意图，最终正确性仍由本地解析、状态/分布验证和固定
能力快照决定；Hybrid-QASM 则被真正解析为有序量子流与可执行 RISC-V 汇编，并可进一步
编码为 LQ-Q32 32 位自定义指令。
Windows 与官方 Python 3.10 基线下，从仓库根目录运行一个命令：
.\scripts\start-ui.ps1首次运行会自动创建核心环境和三个互相隔离的厂商 SDK 环境，严格安装仓库中锁定的
SpinQit、pyQPanda 与 Amazon Braket 依赖，分别执行一次本地模拟验证，然后启动
http://127.0.0.1:8765。这些 .venv* 目录由 Git 忽略；可复现性来自已提交的安装脚本
和依赖锁文件，而不是开发者电脑上现成的虚拟环境。
只安装或修复环境而不启动网站：
.\scripts\setup.ps1Linux、macOS 或不希望在宿主机安装三个冲突 SDK 的用户，可使用
starter_kit/Dockerfile；该镜像同样从已提交的锁文件创建三个
隔离后端。
自动评分会直接运行 starter_kit/ 中的程序。若要申报人工评分或 Bonus，只需填写 starter_kit/evidence/README.md。截图、原始结果或图表可以统一放入 starter_kit/evidence/files/。
| 评分项 | 选手需要说明什么 | 可附材料 |
|---|---|---|
| L1 真机，最高 10 分 | 平台、job ID、运行时间、shots、实际执行的 QASM 和原始结果路径 | 任务页截图 |
| L2 交互体验，最高 10 分 | 界面或 CLI 的启动方法，以及 3 个用户体验任务 | 关键流程截图或演示视频 |
| 工程与产品复核，人工部分最高 5 分 | 构建和启动方法、主要模块、目标用户和完整使用流程 | 架构图、产品截图或已有项目文档 |
| 自定义量子 RISC-V，最高加 8 分 | 指令编码规格、模拟器实现位置和端到端测试命令 | 无需额外材料，三项齐全且测试通过即可 |
| 新手引导与视觉叙事，最高加 4 分 | 首次运行、概念解释、结果可视化、错误恢复或无障碍引导的位置 | 对应截图 |
已有项目 README 或文档可以直接引用，不必为了评分重复写一份。工作人员只核验截止时归档的 commit，不接受截止后补交。截图不能代替可追溯的 job ID、原始结果或可运行代码。不要提交 API Key、Token、Cookie 或个人隐私。完整归档不得超过 100 MiB，大视频请使用稳定只读链接。
不需要。这是线上比赛，不设置线下答辩、现场演示或到场环节。选手只需按提交流程在截止时间前完成线上提交；组委会将依据归档代码、自动评测结果和已提交的证据材料进行评分与复核。
不需要。每队指定一个 GitHub 提交账号，该账号的用户名就是本次比赛的 Team ID。fork 必须归该账号所有，最终提交 Issue 也必须由同一账号创建。
其他成员可以作为 fork 仓库的 collaborator、通过分支或 Pull Request 参与开发。只有最终提交动作需要由指定的 GitHub 提交账号完成。
统一放在 fork 的 starter_kit/ 中。组委会只把该目录提取为正式评测根目录。
证据包本身是可选的。若要申报 L1 真机、L2 交互体验、工程与产品化或 Bonus，直接填写 starter_kit/evidence/README.md 即可。需要的附件统一放进 starter_kit/evidence/files/。未申报某项或未提交对应证据，只影响该项人工分，不影响自动评分。
在 fork 根目录运行：
python3 starter_kit/prepare_submission.py --team-id <GITHUB_USERNAME>预检会确认工作区干净、HEAD 已推送、fork 所有者与 Team ID 一致，并输出可填写到 Issue Form 的仓库地址和 40 位 commit SHA。
最终提交 Issue 获得 submission:accepted 标签，并出现包含 commit、归档 SHA-256 和 Artifact ID 的自动回执，才算有效提交。仅创建 Issue 或通过本地预检不代表提交成功。
可以。修改代码并 push 后重新创建一个最终提交 Issue，不要编辑旧 Issue。截止前最后一次通过校验的提交生效。
截止时间是 2026-08-25 12:00 UTC+8，以 GitHub 服务器记录的 Issue created_at 为准，不看 commit 时间或本地电脑时间。
不会。赛前可使用自己的 DeepSeek Key 或其他 OpenAI-compatible 服务调试，但代码必须读取 LOOMQ_LLM_* 环境变量。正式评测由组委会统一注入 DeepSeek 模型服务和调用预算。
不建议。正式评测环境不保证能够访问模型服务以外的外部网络地址。
每次有效提交都会即时归档为 GitHub Actions Artifact。组委会截止后从归档收集，不依赖 fork 在评分时仍然存在；选手仍应保留 fork 便于复核。