joeseesun / lexfridman-cn

# lexfridman-cn · Lex Fridman 播客中文站
**中文** | English
> 把 Lex Fridman Podcast 全部 506 期变成**可以读、可以搜、可以追**的中文站：AI 中文精读持续批产、官方音频/视频直链、中英双语标题、全文搜索——一期一个独立 URL，纯静态，一条命令全量构建。
>
> A Chinese companion to the Lex Fridman Podcast: all 506 episodes with AI deep-reads, official audio & video, bilingual titles, and full-text search — one URL per episode, built by a single Python script.
**在线阅读 →** · RSS 全文订阅 · 免责声明
**已验证（2026-10-19）**：`python3 tools/build.py` → 506 个单集页 / sitemap 508 条 / RSS 最新 20 期全文；本仓库截图即本地构建产物。
## 这是什么
Lex Fridman Podcast 每期三五个小时，英文听力门槛 + 找期困难，让大部分精彩访谈被埋没。这个项目做了三件事：
1. **每期一页**：官方音频播放器（倍速记忆、断点续听）、视频封面点击加载、中英双语标题与嘉宾简介、英文文稿时间戳跳播；
2. **中文精读**：AI 基于完整访谈改写的长文导读（463+ 篇，批产管线持续补齐），不是机器翻译，是「替你先听一遍」的深度转述；
3. **找得到**：全文搜索（`/` 或 `⌘K` 唤起，多词 AND、嘉宾>标题>简介加权、URL 同步可分享）、明暗主题、阅读进度记忆与「继续收听」。
非官方粉丝项目。本站不托管任何音频/视频/文稿文件，全部直链官方源，详见免责声明。
## 核心能力
| 能力 | 你得到什么 |
|---|---|
| 中文精读全文 | 463+ 篇 AI 深度改写导读，批产管线持续更新，RSS 全文可订阅 |
| 官方音频 + 视频 | 直链官方源播放：倍速记忆、±15s、断点续听、迷你播放条、视频缩略图点击加载 |
| 全文搜索 | 全半角/标点归一化、多词 AND、加权排序、期号精确命中、关键词高亮、`/` / `⌘K` 唤起 |
| 阅读体验 | 精读目录侧栏（滚动高亮）、阅读设置（黑体/宋体 + 15–21px 字号）、明暗主题、阅读进度记忆 |
| 英文文稿 | 三梯队供给：官方文稿 > 本地 Whisper ASR > 存档；时间戳点击跳播、文稿内 `Enter`/`↑↓` 逐处跳转 |
| 订阅与 SEO | RSS 最新 20 期精读全文（真实 enclosure 长度、ETag/304）、JSON-LD（含 SearchAction）、sitemap、llms.txt |
## 详情页一览
## 快速开始
### 最快路径：构建 + 本地预览
构建只用 Python 标准库，零第三方依赖：
 [code] 
成功标志：首页出现「506 期访谈 / 463+ 篇中文精读」统计与单集卡片，搜索、筛选、详情页、RSS（`/feed.xml`）全部可用。元数据（`tools/lex-master.json`、`translations.json`）与精读全文（`site/zh/`）已入库，clone 下来即是全量数据。
 完整管线：自动追新 + 精读批产（macOS） 
精读生成与自动追新依赖 Magpie LLM 网关（或任意 OpenAI 兼容端点，改 `tools/gen_zh.py` 顶部的 `BASE_URL`）与 macOS 钥匙串：
 [code] 
定时化：`crontab` 每日跑一次 `sync_new.py` 即可全自动追新；部署目标是脚本里的 `rsync` 目标，改成你自己的主机路径即可。solo 特别节目等 RSS 非标准条目需在 `lex-master.json` 手工补一条。
## 工作原理
 [code] 
- **sync_new.py** — 每日与官方 RSS 对账：补元数据、翻译标题、按三梯队补文稿、保证精读管线存活，最后构建 + rsync。
- **gen_zh.py --watch** — 精读批产：系统提示词驱动的长文改写，内置禁句式校验（机器翻译腔），不合格带反馈重试，多模型路由按质量动态排序。
- **build.py** — 全量静态构建：单集页（播放器/视频/tabs/JSON-LD/上下期）、首页数据、sitemap、llms.txt、RSS 全文订阅。
## 项目结构
 [code] 
## 内容与版权边界
- 代码以 MIT 授权——**仅限代码**；`site/zh/` 中文精读与元数据不适用 MIT。
- 中文精读是本项目 AI 辅助生成的二次创作，已在站点与 RSS 全文公开；如需转载请**署名并链接对应原文页面**。
- 英文文稿（官方 / 存档 / ASR）版权归 Lex Fridman、嘉宾及制作方所有，本仓库**不包含、不分发**，管线在本地自行获取或转写。
- 精读为 AI 生成、非官方翻译，可能存在偏差，表述以原始访谈为准；完整说明见免责声明。
## 已知限制
- 精读批产与自动追新依赖 macOS（钥匙串、`mlx-whisper`）；**仅构建站点**则任意平台的 Python 3 即可。
- 精读管线默认走乔木的 Magpie 私有网关，外部使用需换成自己的 OpenAI 兼容端点（改 `BASE_URL` 一行）。
- 官方文稿抓取依赖 lexfridman.com 的页面结构，站点改版时 `fetch_official.py` 需要跟进。
- 中文精读仍在批产补齐中（463+/506），新文稿由管线按天追加。
## 贡献
欢迎两类贡献：
- **精读纠错**：发现错别字、人名/数字错误或明显误读，开 Issue 并注明期号即可；
- **代码 PR**：构建、搜索、播放器、管线的问题修复与改进。
不接受与托管媒体文件相关的改动——这是项目的版权边界，见上文。
## 关于向阳乔木
- 博客：blog.qiaomu.ai · 主页：qiaomu.ai · tuijian.qiaomu.ai
- X：@vista8 · GitHub：@joeseesun
- 微信公众号：**向阳乔木推荐看**
---
# English
**中文** | English
A Chinese companion to the Lex Fridman Podcast — all 506 episodes on one static site, lex.qiaomu.ai, with AI-written Chinese deep-reads, official audio/video, bilingual titles, transcripts, and full-text search. One URL per episod