Appearance
使用说明：这套材料怎么用
这是一套只给自己看的面试准备材料，目标岗位 Python Agent 开发工程师（杭州）。 住在独立私有仓库 interview-prep-site（已从 fullstack-road 公开仓库物理拆出）。
和公开知识站（fullstack-road）的 guide 教程不一样：这里可以写真实公司、真实项目细节、真实数据， 也可以写「这个数其实是估的」这种话。前提是它不会被发布出去（见文末「这个私有仓库的红线」）。
开始之前，先做这一件事：核实数字
先去 11-数字口径待核实，把简历上每一个数字过一遍。
现在的简历是「示例填充版」，顶部还留着你自己写的那句标注：项目规模、评测结果、效率数据都是成稿效果示例。 这件事必须排在所有准备工作之前，原因有三个：
- 面试官必追问口径。 只要
86%、1,500 次/天这种数写在简历上，被追问的概率接近 100%。 问题永远是那三个：分母是什么、样本怎么标的、什么时候测的。 - 编的数字撑不过两轮追问。 第一轮还能圆，第二轮要口径，第三轮要证据链和当时的实验记录，三层之内一定露。
- 一旦被识破，整场信任崩塌。 面试官不会只怀疑那一个数字，他会开始重新怀疑你所有的技术描述， 包括你真做过、真能讲清楚的那部分。这是唯一一种「一个点错、全场归零」的失误。
先把数字变成能站住的表述，再练怎么讲。这个顺序不能反。
这套材料的分工
一句话原则：原理只在公开知识站的 guide 页写一遍，本仓库只写「我的项目怎么落地 + 这题怎么答」。
| 本仓库（notes/） | 公开知识站 guide/ | |
|---|---|---|
| 读者 | 只有你 | 公开访客、GitHub Pages |
| 内容 | 我的四个项目怎么做的、被追问怎么答、数字怎么核 | 通用原理、代码示例、可复用实现 |
| 公司/项目名 | 写真名 | 不出现 |
| 量化数字 | 一律 <待核实> 占位，真值只在 11 号文件里维护 | 不出现个人数字 |
| 是否发布 | 不发布 | 发布 |
所以看到「LangGraph 的 State 到底是怎么合并的」这类原理问题，不要在本仓库重复解释， 直接跳到对应的公开知识站 guide 页（文中的原理补课链接可直接点）；本仓库里只留一句「我的项目里为什么这么设计」。
建议的准备顺序
假设从今天开始到第一场正式面试，按这个节奏走。时间是净投入，不含摸鱼。
| 阶段 | 时间 | 做什么 | 产出物 |
|---|---|---|---|
| 0 · 核实数字 | 0.5 - 1 天 | 逐条填 11 号文件 主表的「真实值」列；查不到的直接改成降级表述 | 一份数字能站住的简历终稿 |
| 1 · 通读项目稿 | 1 天 | 读完 01 02 03 04，每个项目在白纸上默画一遍架构图 | 四张能徒手画的架构图 |
| 2 · 补原理短板 | 2 - 3 天 | 拿 12 号文件 自测，答不上的顺链接去公开知识站的 guide 页补，补完回来复述一遍 | 12 号文件里被标记的弱项清零 |
| 3 · 练口述 | 1 天 | 10 号文件：自我介绍三档 + 四个项目的 2 分钟版，全部录音回听 | 30 秒 / 1 分钟 / 2 分钟都能脱稿 |
| 4 · 模拟追问 | 每轮 0.5 天 | 找人（或自己扮演面试官）只问「为什么」和「怎么算的」，专挑 11 号文件里的数字打 | 三层追问不慌 |
时间不够怎么砍
只剩一天：阶段 0 + 阶段 3 的自我介绍和 2 分钟项目版。 数字站不住 + 讲不利索，是唯一两个会直接挂掉的问题；原理短板顶多是答不全，不至于崩。
要按「一天速成」的节奏走，直接用 20 · 速成总览： 它带时刻表、四项目一页对照、20 个数字的口径总表和易混点辨析， 每个项目对应一份压缩版技术方案（21 22 23 24）。 速成稿里的数字口径以它为练习版；核实出的真实值仍然只回填 11 号文件。
面试问什么 → 翻哪份文件
| 面试官问的 | 主文件 | 补充 |
|---|---|---|
| 自我介绍一下 | 10 · 口述稿 §1 | 三档：30 秒 / 1 分钟 / 3 分钟 |
| 挑一个你最熟的项目讲讲 | 10 · 口述稿 §2 的 5 分钟版 | 对应的 01-04 项目稿 |
这个 <待核实>% 是怎么算的 | 11 · 数字口径 | §2 口径详解、§3 降级表述 |
| 知识库怎么做入库、权限、引用 | 01 · 企业知识库 RAG | rag-pipeline、rag-citation |
| Text2SQL 怎么防字段幻觉和危险 SQL | 02 · BI 数据分析 | agent-text2sql |
| 多 Agent 怎么拆、HITL 怎么做 | 03 · 智能客服 | agent-multi-agent、agent-tool-calling |
| 混合检索、RRF、内网私有化部署 | 04 · AI 政务助手 | rag-retrieval |
| 你怎么评测一个 Agent | 11 · 数字口径 §2 | agent-eval |
| asyncio / Pydantic / FastAPI / pgvector 八股 | 12 · 高频问答 | python-engineering、fastapi-advanced |
| 前端怎么接 SSE、流式怎么渲染 | 12 · 高频问答 §7 | agent-streaming |
| 为什么离职 / 职业规划 / 你的不足 | 10 · 口述稿 §4 | — |
| 你有什么想问我的 | 10 · 口述稿 §5 | — |
自测清单
面试前一晚拿这个清单过一遍。每一条都要「张嘴说出来」验证，心里觉得会不算会。
定位与叙事：
- [ ] 30 秒定位能不脱稿讲完，且落点是「Python Agent 开发」而不是「什么都会一点」
- [ ] 「前端 → 全栈 → Agent」这条主线能讲成一条主动选择的路径，而不是被动跳槽
- [ ] 物联网专业和前端出身能讲成优势（懂交互、能做流式界面、能对齐前后端协议），不带一句自我贬低
- [ ] 工作时间线能对得上：品茗 2019.07-2022.04、掌奇 2022.06-2025.03、亿达 2025.04-2026.06、目前离职
项目：
- [ ] 四个项目的架构图都能徒手画出来（节点、数据流、存储、失败分支）
- [ ] 每个项目能说出三个「为什么不用 X」（例如为什么不用纯向量检索、为什么不让模型直接拼 SQL、为什么不用 Celery）
- [ ] 每个项目能说出一个失败案例 + 你怎么定位怎么修的
- [ ] 每个项目能说清「哪部分是我写的、哪部分是别人写的」——边界含糊是大忌
数字：
- [ ] 简历上每一个数字，都能说清分子、分母、样本量、测量时间
- [ ] 记不精确的数字，有一句准备好的、不掉分的降级说法
- [ ] 没有任何一个数字是「感觉差不多就这样」——这种一律改成定性表述
怎么用网页看这套材料
这套材料住在一个独立私有仓库里，本身就是个 VitePress 站点。
方式一：本地网页站（推荐，mermaid 图、侧边导航、全文搜索都有）
bash
npm install # 首次
npm run docs:dev # 浏览器打开 http://localhost:5173方式二：VS Code 预览——打开任意 .md 按 Cmd+Shift+V，零配置，适合单篇细读和改动。
方式三：手机 / 多设备——把仓库推到 GitHub 私有仓库（README 里有命令）： 电脑 git pull 后 npm run docs:dev；手机用 GitHub App 直接看 Markdown 渲染版。 想要带密码的在线网页，走 Cloudflare Pages + Access（见 README），不要开 GitHub Pages。
⚠️ 这个私有仓库的红线
这套材料已经从 fullstack-road 公开仓库物理拆出，原来「prep/ 靠 .gitignore 和 srcExclude 双保险」的日子结束了——现在是独立仓库，安全完全取决于这个仓库本身的可见性。三条红线：
- 仓库永远保持 Private。GitHub 设置里一键就能转公开，不要碰。
- 不要开启 GitHub Pages。Free 计划开不了；Pro 计划能开，但站点是公开的——文件名、页面标题、URL 全部可被搜索引擎收录。这份材料里有真实公司名、真实分工边界（哪些是同事做的）、时间线问题和「数字是示例值」的自证内容，任何一种形式落到公网都是求职事故。想要带密码的在线访问，用 Cloudflare Pages + Access（见 README）。
- 离职证明、他人简历（收集的简历/、同事的简历/ 等）永远不要放进这个仓库。他人简历是第三方个人信息，上云是合规风险；本仓库只装 notes/ 里的面试材料。
另外两条老规矩仍然有效：
- 永远不要
git add -f任何不想公开的文件——-f是专门用来绕过 ignore 的。 - 仓库一旦转公开过，即使马上改回私有，期间的快照、fork、爬虫缓存都可能已经存在——权限收紧救不回已经泄出去的内容。