Skip to content

Latest commit

 

History

History
39 lines (29 loc) · 2.96 KB

CONTRIBUTING.md

File metadata and controls

39 lines (29 loc) · 2.96 KB

贡献指南

欢迎补充公开来源、纠正身份消歧或改进采集器。

  • 提交结构化事实和直接证据链接,不提交论文 PDF、微信公众号全文/截图、付费内容、头像或大段网页复制。
  • 不提交私人联系方式、薪资传闻、身份证明、家庭信息或从私人社交账号推断的关系。
  • 任职、导师、学生、人才称号、合作与去向必须分别证明;论文署名不能自动推导当前任职。
  • 新采集器应低频访问、尊重来源规则、设置明确 User-Agent,并在来源失败时退出而不是生成空数据。
  • 修改数据后运行:
python scripts/sanitize_public_data.py
python scripts/generate_research_advice.py
python scripts/validate_data.py

补面试题时不要直接手改 docs/data/interview-bank.json。先更新来源台账或受测试的生成规则;编程题实现放入 interview/solutions/,测试放入 tests/,然后运行:

python -m pip install -r requirements-interview.txt
python scripts/build_interview_bank.py
python -m unittest discover -s tests -v

每道题必须有完整题目、题解和来源映射,并在题目下方展示来源记录中的公司、部门/岗位方向、统计时间。不得把岗位方向推断成公司官方组织架构。题面完整的编程题必须有正常、边界和异常测试;题面残缺时只能明确标记缺失项,不能补猜测代码。论坛/社媒面经只能说明“有人公开报告遇到过这类题”,不能写成公司官方固定题库。

GPU 代码的模拟器结果只能标为 CI 回归。要标记为真实设备通过,必须在 NVIDIA H20 上执行、保存硬件与环境、测试范围、作业号和源码/测试哈希,并明确区分正确性证据与性能结论。

纯编程题专题由 scripts/build_coding_foundations_full.py 生成并嵌入 interview-bank.json,不要直接改生成后的 JSON。当前固定快照是《剑指 Offer(专项突破版)》119 条 + 左程云牛客 OJ 188 条,共 307 条来源映射、291 道保守语义去重后的独立题。变更题目必须同步维护来源目录、规范映射、逐题分析、coding_catalog_*.cpp 标记区间和来源级断言;不能退化成抽取代表题。只有书籍或公开 OJ 依据的题必须明确标为“公司不适用”,不能从“名企面试题”书名反推出公司或部门。

要给纯编程题增加 CUDA 实现,必须更新 coding_catalog_cuda.cuh/.cu 和 tests/test_coding_catalog_h20.cu,在 H20 上与同题意 C++17 结果对拍,再把环境、作业号、原始数字和哈希写入 docs/data/coding-catalog-h20-benchmarks.json。只完成理论分析的题保持 analysis-only,不得为了凑数量生成未经验证的 kernel。提交前至少运行:

python scripts/build_interview_bank.py
python -m unittest tests.test_coding_foundations -v
bash scripts/run_coding_catalog_tests.sh
python scripts/validate_data.py
node --check docs/assets/app.js