# FRAMEWORK · 读书知识网

## 站点定位

`book.mimilulu.com` 是**多书读书知识网**（Book · mimilulu），不是股东信专站。

- **书库首页** `index.html`：列出已上架与待上架的书。
- **第 1 本**：伯克希尔致股东信 → `books/berkshire/`。
- **留言簿**：全站共用（任何书的阅读问题）。
- 后续书按同一模式加目录：`books/<slug>/`。

## 设计目标

用**框架**而非年表消化经典：带宽友好、渐进披露、引文可回溯。

全站阅读路径：

```
书库（index.html）
  → 一本书的主题地图（books/<slug>/index.html）
    → 主题页：要点 + 带出处的关键引文
      → 「更深一层」（可选）
        → 原文目录
```

## 第 1 本：伯克希尔致股东信（九主题）

对齐公开整理的 Buffett 思维结构（结构参考，非运行依赖），覆盖信件中反复出现的硬核概念：

| ID | 中文 | 回答的问题 |
|----|------|------------|
| thinking | 思维框架 | 怎么想？边界在哪？ |
| philosophy | 投资哲学 | 买什么？以什么身份买？ |
| moat | 护城河 | 为何能持久赚钱？ |
| management | 管理层 | 和谁一起做？ |
| financials | 财务指标 | 看哪些数才不被会计骗？ |
| valuation | 估值与资本配置 | 付多少？钱怎么用？ |
| risk | 风险与行为 | 如何避免死掉与发疯？ |
| industry | 行业与案例 | 框架如何落地？ |
| timeline | 年表精华 | 关键表述出现在哪一年？ |

依赖直觉（简图）：

```mermaid
flowchart TB
  thinking --> philosophy
  thinking --> risk
  philosophy --> moat
  philosophy --> management
  moat --> financials
  management --> financials
  financials --> valuation
  valuation --> risk
  moat --> industry
  valuation --> timeline
```

## 引文纪律（各书通用）

1. **引文必须来自原书/原信**，不杜撰、不「补全」缺损段落。
2. 标注**出处**（股东信为年份），并链接到对应文件。
3. 中文为**译文辅助**，页面标明「译文」；争议处以原文为准。
4. 源文件缺损时：**宁缺毋补**。
5. 示意图（Mermaid）是阅读辅助，**不是**原作附图。

## 渐进披露细则

| 层级 | 内容 | 体积意图 |
|------|------|----------|
| L0 书库 | 书目卡片 | 极小 |
| L1 书主题地图 | 该书九宫格/主题卡 | 极小 |
| L2 主题 | 短句要点 + 1–2 引文 | 小 |
| L3 deeper | 补充判据、交叉出处 | 仍小 |
| L4 原文 | PDF/HTML 全文 | 按需 |

## 留言簿与回复节奏

- 存储：`comments.json`（数组）。
- 字段：`id`, `ts`（ISO8601，Asia/Shanghai 偏移写入）, `nick`（可选）, `question`, `replied`（bool）, `reply`（string）。
- 后端：`server/guestbook_app.py`（stdlib HTTP），默认监听 **127.0.0.1:8091**（避开 8080）。
- 前端：`guestbook.html` + `assets/guestbook.js`：`GET/POST /api/comments`。
- **回复节奏（用户选定）**：每日两次，Asia/Shanghai **早约 8:00–9:00**、**晚约 20:00–21:00**。

## 目录结构

```
buffett-kb/                    # 本地工程名；站点品牌为「读书知识网」
  index.html                   # 书库首页
  framework.html
  FRAMEWORK.md
  guestbook.html
  comments.json
  README.md
  assets/
  books/
    berkshire/
      index.html               # 第 1 本主题地图
      themes/*.html
      letters/                 # 官方信函（部署时实体拷贝）
  themes/*.html                # 旧 URL 重定向桩
  letters/index.html           # 旧 URL 重定向桩
  server/guestbook_app.py
  deploy/
```

## 多书路线图

1. **已上架**：伯克希尔致股东信（1977–2025）。
2. **计划**：聪明的投资者、林奇选股、投资最重要的事、期权经典（麦克米伦/纳坦恩伯格）等——一起读完再按同一 IA 上架。
3. 选股漏斗等实战框架，从多本书的主题中长出来，不绑死在股东信 alone。

## 已知数据瑕疵（股东信）

- 部分早期 `.html` 在归档中呈二进制损坏。
- `1999.html` 体积异常偏小；优先其他年份 PDF。
- 第三方 Markdown 仅作核对辅助；对外链接一律指向 `books/berkshire/letters/` 官方文件名。

## 非目标

- 不做投资建议或荐股。
- 不部署进 `/opt/satoshi`。
- 不把 guestbook 绑在 8080。
- 不把全站品牌写成「股东信专站」。