量子计算与工程文献库：汇总 IEEE QCE 会议（2020–2026） 与 IEEE TQE 期刊（2020–2026, Vol. 1–7） 的 2338 条研究条目（另有 173 条封面/索引等前置页），统一为 13 类研究方向，附中文创新点说明与英文摘要，支持检索/筛选/CSV 导出，亮暗双主题，每周自动增量更新。
- 在线站点：https://xiaoshecode.github.io/paper4qi/
- 数据快照：2026-09-24（QCE 2020–2025 论文集 1523 篇 + QCE26 官方日程 372 篇 + TQE 443 篇）
- 统一 schema：QCE 论文集（DOI 口径）、QCE26 官方日程（Track/Session 口径）、TQE 期刊三来源归一为同一
Paper结构，前端只需一套渲染逻辑（src/scripts/types.ts）。 - 检索：空格分词 AND 语义，匹配标题 / 作者 / 中文说明 / 摘要 / DOI / arXiv / 标签 / 会议名；命中处
<mark>高亮，/聚焦搜索框、Esc清空。 - 筛选：年份 × 13 类方向 chips 可任意叠加，chip 上实时显示计数；「只看论文」开关可显示封面、版权页、索引等前置页。
- CSV 导出：导出当前筛选结果为 22 列 CSV（含中文说明与摘要），带 UTF-8 BOM，Excel 直接可读。
- URL hash 分享：筛选状态写入地址栏
#q=ldpc&y=2024,2025&c=QEC,ALG&fm=0，复制链接即还原视图。 - 暗色模式：
auto / light / dark三态，跟随prefers-color-scheme，首屏内联脚本注入主题避免闪烁。 - 统计页：年 × 类堆叠柱状图、两源逐年论文数折线、TQE 被引 Top 20（OpenAlex）、QCE26 Track 分布，图表为纯 SVG 组件，无图表库。
- 周更管线：Crossref 增量抓取 + OpenAlex 补摘要/被引 + arXiv 标题匹配；单个数据源失败只发 warning，保留旧数据、任务不红。
- QCE26 日程过渡：论文集正式出版后按标题（精确 + Jaccard 模糊）匹配，用 DOI 记录替换日程记录，避免双计，Track / Session / 获奖信息保留。
| 层 | 选型 |
|---|---|
| 站点框架 | Astro 5（output: 'static'，构建期 SSG） |
| 语言 | TypeScript（astro/tsconfigs/strict，tsconfig.json 继承） |
| 交互 | 零 UI 框架；vanilla TS（src/scripts/paper-browser.ts、highlight.ts）+ 纯 SVG 组件 |
| 样式 | 唯一来源 src/styles/global.css，CSS 变量双主题，无预处理器、无 Tailwind |
| 数据管线 | Python 纯标准库（urllib），不依赖第三方包，Windows 裸解释器与 Actions 均可运行 |
| 依赖 | 版本 | 说明 |
|---|---|---|
| Node.js | ≥ 20（建议 24） | CI 使用 24 |
| pnpm | ≥ 10（建议 11） | CI 使用 11；pnpm-lock.yaml 已锁定 |
| Python | ≥ 3.10（建议 3.13） | CI 使用 3.13；仅需标准库 |
git clone https://github.com/xiaoshecode/paper4qi.git
cd paper4qi
pnpm install
# 1) 生成数据（public/data/*.json，已被 .gitignore 忽略）
PYTHONIOENCODING=utf-8 python scripts/build_data.py # 等价于 pnpm data
# 2) 开发服务器：http://localhost:4321/paper4qi/
pnpm dev
# 3) 生产构建 + 本地预览（同样在 4321，注意 URL 必须带 /paper4qi/）
pnpm build && pnpm preview- 必须先跑
build_data.py：public/data/不进版本库，而src/pages/index.astro与stats.astro在构建期直接readFileSync('public/data/stats.json')—— 数据缺失时pnpm build会直接失败，不是页面空白。 - pnpm 11 的构建脚本白名单：
pnpm-workspace.yaml中的allowBuilds: {esbuild: true, sharp: true}是必需的，否则 esbuild/sharp 的 postinstall 不执行，pnpm build报二进制缺失。升级 pnpm 后如遇Ignored build scripts提示，检查该文件。 - Windows 控制台编码：GBK 环境下 Python 打印非 ASCII 会抛
UnicodeEncodeError，所有 Python 命令前置PYTHONIOENCODING=utf-8（脚本内部也有sys.stdout.reconfigure兜底）。 base是/paper4qi：本地必须访问http://localhost:4321/paper4qi/；所有站内链接/资源在源码中都经import.meta.env.BASE_URL拼接，新增页面时不要漏。
paper4qi/
├─ astro.config.mjs site / base=/paper4qi / trailingSlash: always
├─ pnpm-workspace.yaml allowBuilds（esbuild、sharp 的 postinstall 白名单）
├─ data_src/ 源数据快照（唯一事实源，随 git 提交）
│ ├─ qce/ QCE 2020–2025 论文集：data_20xx.json + zh2_20xx.json
│ │ （中文说明，按 1-based 序号）+ abs_20xx.json + cats.json
│ │ （主题标签）；replaced_qce26.json 由 reconcile 生成
│ ├─ qce26/ QCE26 官方日程 papers_data.py（372 条，9 Track）
│ │ + arxiv_matches.json（arXiv 标题匹配与摘要）
│ ├─ tqe/ TQE 期刊：tqe_merged.json（465 条，已分类）
│ │ + zh_20xx.json（中文说明，按全局序号）
│ ├─ overrides/ zh_new.json：中文说明覆盖层（对三来源统一生效）
│ └─ .update_state.json 周更状态：各源上次成功运行日期
├─ scripts/ Python 数据管线（纯标准库）
│ ├─ build_data.py data_src → public/data/{qce,tqe,stats}.json（本地与 CI 共用）
│ ├─ update_data.py 每周增量：TQE 按 ISSN diff DOI、OpenAlex 补摘要/被引、QCE 新年度探测
│ ├─ reconcile_qce26.py 日程 ↔ 论文集标题匹配，写 replaced_qce26.json
│ ├─ lib_taxonomy.py 13 类分类法（关键词表、FORCE 规则、QCE 标签映射、QCE26 Track 映射）
│ └─ lib_fetch.py HTTP 封装（UA、指数退避、Crossref/OpenAlex 游标分页、arXiv 限速）
├─ public/data/ 构建产物（gitignored，由 build_data.py 生成）
├─ src/
│ ├─ data/meta.ts 站点常量：SITE、CATEGORIES（13 类）、SOURCES
│ ├─ data/cs4q.ts CS4Q 导读数据（33 条，手工策展，不在周更范围）
│ ├─ data/venues.ts 期刊会议投稿指南数据（49 刊 + 27 会 + CFP 截止日期，
│ │ 2026-10-08 手工核验，不在周更范围）
│ ├─ layouts/BaseLayout.astro HTML 骨架、主题首屏脚本、页脚
│ ├─ components/ SiteHeader（导航）/ PaperBrowser（浏览器壳）/
│ │ CategoryBar / StackedBars / LineChart / Timeline / ThemeToggle
│ ├─ pages/ index（总览）、qce、tqe、cs4q（导读）、venues（投稿指南）、
│ │ stats、about（数据说明）
│ ├─ scripts/ paper-browser.ts（检索/筛选/渲染/CSV/hash）、highlight.ts、types.ts
│ ├─ styles/global.css 唯一样式来源（CSS 变量双主题）
│ └─ content/ trajectory-{qce,tqe}.md 叙述素材（供文案参考，未被构建引用）
└─ .github/workflows/ deploy.yml（push main 部署 Pages）+ update.yml（每周数据更新）
PYTHONIOENCODING=utf-8 python scripts/build_data.py处理顺序与输出：
- QCE 2020–2025：逐年读取
data_20xx.json（{d,t,a[],p}）与按序号对齐的zh2_20xx.json、abs_20xx.json，用cats.json标签 + 关键词回退打分得到 13 类之一，产出qce:前缀条目（1674 条 → 1523 论文 + 151 前置页）。 - QCE 2026：动态 import
qce26/papers_data.py，按 9 个 Track 展开 372 条日程论文，叠加 arXiv 匹配的摘要与预印本号，中文说明自动生成为「QCE26 官方日程 · {Track 中文}（{Session}）」，产出qce26:前缀条目。 - TQE 2020–2026：读
tqe_merged.json与zh_20*.json，FRONT类（封面/索引）归入OTHER并置front_matter: true，按 年 → 类优先级 → 文章号 → 标题 排序。 - 中文覆盖层：最后应用
overrides/zh_new.json（{"paper_id": "中文说明"}）；未命中的 id 只打印提示，不报错。 - 输出：
public/data/qce.json（2046 条）、tqe.json（465 条）、stats.json（年 × 类矩阵、两源逐年增长、被引 Top 20、QCE26 Track 分布、总计），同时打印年×类矩阵与分类分布报告。
断言基线：脚本顶部 EXPECT 记录了初次导入时的数量基线。数量漂移（新增论文、新年度）只 warn 不 fail —— 周更会持续追加论文，硬失败会卡死部署管线；请不要改回 raise。真正会 raise 的是数据一致性问题：QCE 记录数与中文说明数不匹配、DOI 为空或重复、TQE DOI 重复或缺失、QCE26 Track 集合变化、中文说明 key 重复。
PYTHONIOENCODING=utf-8 python scripts/update_data.py- TQE：按 ISSN
2689-1808+from-pub-date（上次运行日 − 2 天，默认回溯 14 天）从 Crossref 拉取新 DOI，与tqe_merged.json现有 DOI 求差集，逐条用 OpenAlex 补摘要/被引/关键词后追加；随后做一次 OpenAlex 源全量爬取（sourceS4210182817）刷新所有记录的cited_by（同一 DOI 多条记录取最大值）。非10.1109/tqe.前缀的 DOI 会被跳过并 warning。 - QCE 新年度探测：用
container-title:<年> IEEE International Conference on Quantum Computing and Engineering (QCE)过滤 Crossref，记录数 ≥ 50 才认定该年度已出版，写出data_{Y}.json+zh2_{Y}.json（占位「待补充」，不能以「【」开头）+ 空abs_{Y}.json。 - QCE26 reconcile：调用
reconcile_qce26.reconcile()，幂等；论文集未出版时不做任何事。 - 容错设计：每个数据源包裹在独立 try/except 中，失败发
::warning::并以退出码 0 结束；所有写入走临时文件 +os.replace原子替换；刷新窗口与上次运行重叠 2 天，避免漏抓边界 DOI。
python scripts/reconcile_qce26.py --dry-run # 预览匹配结果，不写盘
python scripts/reconcile_qce26.py --year 2026标题归一化（HTML 反转义、小写、去标点）后先做精确匹配，再做 token Jaccard ≥ 0.9 的模糊匹配；arXiv 标题作为别名参与匹配（已发表标题可能与日程 PDF 有出入）。产出 data_src/qce/replaced_qce26.json = {"{TRACK}-{row}": "<doi>"}，build_data.py 读取后丢弃对应的日程条目，保证同一篇论文只出现一次。
-
推送到
main触发.github/workflows/deploy.yml，三个 job 串行：- data：Python 3.13 跑
build_data.py，校验qce.json/tqe.json/stats.json存在且非空，上传site-dataartifact。 - build：Node 24 + pnpm 11
pnpm install --frozen-lockfile，下载数据 artifact 到public/data/，pnpm build，校验dist/index.html与dist/data/qce.json存在，上传 Pages artifact。 - deploy：
actions/deploy-pages发布到 GitHub Pages。
- data：Python 3.13 跑
-
站点地址：https://xiaoshecode.github.io/paper4qi/；Pages 的 Source 已设为 GitHub Actions（workflow 模式），不是
gh-pages分支。换仓库/首次开通时执行：gh api repos/xiaoshecode/paper4qi/pages -X POST -f build_type=workflow
-
concurrency: pages且cancel-in-progress: true：连续 push 只保留最后一次部署。
.github/workflows/update.yml：每周一 03:14 UTC cron + 支持手动 Run workflow。
- Python 3.13 执行
update_data.py（timeout-minutes: 25，PYTHONIOENCODING=utf-8）。 - 若
data_src/有变更，以github-actions[bot]身份提交data: weekly update <日期>并 push；push 反过来触发deploy.yml重新构建站点。无变更则直接结束，不产生空提交。
新论文的中文说明补全流程：自动抓取的新条目中文说明为「【待补充】」，在 data_src/overrides/zh_new.json 中按 {"论文id": "中文说明"} 补写（论文 id 形如 tqe:10.1109/tqe.2026.xxxxxxx，可从 CSV 导出的 id 列直接取），提交后下次构建自动覆盖；id 未命中只打印提示，不会中断构建。
- 加数据源：在
scripts/lib_taxonomy.py补分类关键词/映射，在build_data.py加一段读取 +paper(...)组装 + 统计并入（stats.json的matrix/growth/totals），必要时在lib_fetch.py加取数函数。 - 加/改分类：改
lib_taxonomy.py的CAT_ORDER/CATS/CAT_NAMES，同时改src/data/meta.ts的CATEGORIES（顺序必须与CAT_ORDER一致）与src/styles/global.css的--c-{KEY}（亮暗两套），否则 chips 与图例会掉色。 - 加页面：在
src/pages/新建.astro，用BaseLayout包裹，并在src/components/SiteHeader.astro的links中登记导航（注意import.meta.env.BASE_URL前缀）。 - 改主题色/间距：只改
src/styles/global.css的 CSS 变量（--bg/--surface/--ink/--muted/--line/--accent/--c-*），亮暗两套都要改；组件里不要写死色值。 - 提交前自检：
python -m py_compile scripts/*.py→PYTHONIOENCODING=utf-8 python scripts/build_data.py→pnpm build→ 亮/暗两主题目视确认关键页面无 404。