宽数题库
用途
当你需要查看、运行、扩展或部署“宽数题库”这个多来源量化题库项目时，使用这个技能。
适合这些场景：
- 需要快速理解项目是什么、当前公开站点是什么
- 需要确认仓库中已经接入了哪些题库来源
- 需要知道原始抓取、标准化数据和页面代码分别放在哪里
- 需要重新抓取、构建或检查部署前置条件
项目资源
当前接入的题库来源
- OpenQuant：
openquant.co/questions - Brainstellar：
brainstellar.com/puzzles - QuantQuestion：
quantquestion.com - Jane Street：
janestreet.com/puzzles - MyntBit：
myntbit.com
当前总题量：1454 道。
目录结构
data/raw/说明：五套来源的原始索引与详情数据data/translations/说明：中文翻译与分批翻译产物src/data/questions.json说明：OpenQuant 标准化数据src/data/brainstellar-questions.json说明：Brainstellar 标准化数据src/data/quantquestion-questions.json说明：QuantQuestion 标准化数据src/data/janestreet-questions.json说明：Jane Street 标准化数据src/data/myntbit-questions.json说明：MyntBit 标准化数据src/pages/index.astro说明：首页src/pages/questions/[slug].astro说明：统一详情页scripts/说明：抓取、构建、翻译和部署检查脚本
常用命令
安装依赖：
npm install
抓取与构建：
npm run data:index
npm run data:details
npm run data:brainstellar:index
npm run data:brainstellar:details
npm run data:brainstellar:build
npm run data:quantquestion:fetch
npm run data:quantquestion:build
npm run data:janestreet:index
npm run data:janestreet:details
npm run data:janestreet:translate
npm run data:janestreet:build
npm run data:myntbit
npm run data:validate
npm run data:build
本地开发与验证：
npm run dev
npm run test
npm run check
npm run build
托管与发布
- GitHub 仓库保持 private
- 公网托管走 Vercel
- 生产域名为
https://quantics-bank.vercel.app
Vercel 常用命令：
npx vercel whoami
npx vercel deploy dist --prod --yes
工作建议
如果你是第一次接手这个项目，建议按这个顺序：
- 读
README.md - 跑
npm run data:validate - 跑
npm run build - 看
src/pages/index.astro与src/pages/questions/[slug].astro - 如果改抓取链，再读
scripts/
公式渲染约束
OpenQuant 原题和中文翻译中的 TeX source 必须保持原样。渲染器只做安全分隔符归一化，不做语义改写；不要把 \operatorname、\textrm、\mod、\dbinom 或 equation 环境改成其他命令来“修正”显示。若页面显示 KaTeX 错误，应先检查源数据本身，而不是在渲染层做猜测性替换。
什么时候用这个技能
- 想快速知道这个项目现在有哪些题库来源
- 想确认某道题属于哪个来源
- 想重新拉取 Brainstellar / Jane Street / MyntBit 等来源
- 想把本地最新内容重新部署到 Vercel