# 乌龟养鱼基础理论 v1：版本历史（CHANGELOG）

> 本文件是 [main.md](main.md) 的版本历史档案，仅记录每次升级的变化，不参与文章正文叙事。
> 最新版本：[main.md](main.md)（v1.1 / 2026-07-28）
> 母理论：[四把尺子理论 v26](../../四把尺子理论/v26/main.html)
> 参照蓝本：[健康理论 v1.12](../../健康理论/v1/main.html)（v1.x supplement + main.md P0/P1 修补模式）

---

## v1.1（2026-07-28）· 第一次跨理论专题整合：深水养龟安全

> **触发**：用户提交 [new/1.md](new/1.md)，内容是"深水养龟防溺亡机制与操作规范"——一个**完整的深水养龟安全操作框架**，含 3 大认知偏差纠偏 + 3 项硬指标 + 4 步善后流程。
>
> **整合判断**：v1 框架在 5 条养龟元规则中**完全没涉及"深水养龟安全"**这个具体场景——但这是养龟"溺亡"风险（特别是钻纹龟、地图龟等深水龟）最常见、最隐蔽、最容易被"有晒台=安全"误区掩盖的事故来源。
>
> **整合策略**：采用 v1 健康理论 v1.10/1.11/1.12 整合模式——**supplement + main.md 5 处 P0/P1 修补**。

**主要变化**：

1. **新建** `supplements/supplement-turtle-deep-water-safety.md`（约 10.7KB / 7 大节 / 含 3 大认知偏差纠偏 + 3 项硬指标 + 5 大物种差异 + 4 步善后）
2. **修改** `main.md`（v1.0 → v1.1）5 处 P0/P1 修补：
   - **P0 修补 1**：龟的 7 大红旗信号 → 扩展为 9 大，新增 2 个"溺亡"相关信号（浮水不能沉/挣扎爬晒台 + 沉底不动口鼻有血丝）
   - **P0 修补 2**：能力尺子·养龟特化，新增"深水养龟安全 3 项硬指标"（浸没式晒台 + 中间歇脚平台 + 分阶段水位管理）
   - **P0 修补 3**：养龟元规则 5 条 → 5+1 条，新增第 6 条"不可让'深水养龟'成为无设计的环境赌博"
   - **P1 修补 1**：常见质疑，新增质疑 7"深水养龟不会淹死？"
   - **P1 修补 2**：v1 边界声明，拆分为"v1.0 不覆盖"和"v1.1 新增覆盖"两个子节
3. **更新** `CHANGELOG.md`（本文新增 v1.1 节）
4. **重新编译** `main.html`（由 build_main_html.py 重新生成）

**v1.1 关键识别**：

- v1 之前认为"晒台 = 安全"是**基础常识**——v1.1 揭示这是一个错误的"认知默认值"
- v1 之前认为"深水龟 = 不会溺亡"——v1.1 揭示"深水龟"是相对概念，**不是直接 60cm 深水起步**
- v1 之前认为"状态正常 = 无风险"——v1.1 揭示**溺水是"急性事件"，但之前数周的"高频呛水"可能已经累积了肺损伤**
- v1 框架首次发现自己的盲区——这与 v1 健康理论 v1.10 自反性元评论一致

**3 项硬指标**（v1.1 框架的"操作金标准"）：

| # | 硬指标 | 具体要求 |
|---|--------|----------|
| **1** | **晒台必须浸没式** | 顶面低于水面 1-2cm（龟无需"冲出水面"）|
| **2** | **必须设置中间歇脚平台** | 深度 5-10cm（龟在任何深度都能换气）|
| **3** | **分阶段水位管理** | 幼龟 < 15cm，亚成 < 龟甲长度 × 1.5，成龟 < 龟甲长度 × 2 |

**3 大认知偏差纠偏**（v1.1 核心洞见）：

| # | 偏差 | 纠偏 |
|---|------|------|
| **1** | "有晒台即安全" | 晒台设计（位置/浸没度/中间平台）才是真正的安全决定因素 |
| **2** | "深水龟可免于溺亡" | "深水龟"是相对概念，自然栖息地有缓慢的浅滩过渡 |
| **3** | "状态正常即无风险" | 溺水是"急性事件"，但之前数周"高频呛水"可能已累积肺损伤 |

**物种特异性补充**（v1.1 细化）：

- **钻纹龟**：特别敏感——中间歇脚平台 ≥ 2 个，幼龟期水位 < 10cm
- **地图龟**：类似钻纹龟——多冗余设计
- **草龟/巴西龟**：适应性最强，按标准硬指标即可
- **鳄龟**：体型大、肺活量大，按标准硬指标即可（晒台必须承重）

**4 步善后流程**（v1.1 应急操作）：

1. **立即捞出 + 头低脚高**（30 秒到 1 分钟）
2. **刺激应激反射**（轻拍四肢根部或后腿窝）
3. **28-30°C 保温 + 静置**（30-60 分钟，不用吹风机/热水袋）
4. **联系异宠医院**（6 小时内可能致死）

**v1.1 与 v1 健康理论的整合模式对照**：

| 维度 | 健康理论 v1.10-1.12 | 养龟养鱼 v1.1 |
|------|-------------------|--------------|
| **整合模式** | supplement + main.md P0/P1 修补 | ✅ 同样采用 |
| **supplement 数量** | 3 个（v1.10/1.11/1.12）| 1 个（v1.1）|
| **P0/P1 修补数量** | 5+2+2 = 9 处 | ✅ 5 处 |
| **是否扩展红旗信号** | v1.12 新增"OSA"画像 + 4 维症状 | ✅ v1.1 新增 2 个"溺亡"信号 |
| **是否新增元规则** | v1.10 升级元规则 12 为"自反性元规则" | ✅ v1.1 新增养龟元规则第 6 条 |
| **是否新增质疑** | v1.11 质疑 15→16，v1.12 新增质疑 17 | ✅ v1.1 新增质疑 7 |

**v1.1 边界补丁**：

- ✅ **v1.1 新增覆盖**：深水养龟安全（supplement 专题）
- ✅ **龟的 9 大红旗信号**（v1.1 扩展）

**v1.1 自反性**（v1.1 边界声明原文）：

> **v1 知道自己"不是一个完整的养龟养鱼理论"**——它只是**一个起点**。
> 如果你发现 v1 的哪条原则与你的实际经验冲突，**以你的经验为准**——但请先验证 4-6 周（生态系统的变化需要时间）。
> **v1.1 已落地**：通过 supplement + 5 处 P0/P1 修补补强"深水养龟安全"——这是 v1 框架首次系统性地补强自己的盲区。

---

## v1.0（2026-07-28）· 初版·两套独立框架 + 混养专章

> **触发**：用户问"模仿四把尺子生成一个乌龟，养鱼基础理论"，经评估决定采用"两套独立框架（养龟+养鱼）+ 混养专章"结构，**保留 v26 的 3 大公理 + 4 把尺子内核**，针对家庭养宠场景重新翻译。

**核心识别**：

- v1 框架**首次把"养龟"和"养鱼"作为两套独立但同源的框架呈现**——两套都基于同一套 4 把尺子，但有各自的公理特化、4 把尺子落地方式、5 条元规则
- v1 框架**首次明确"混养必须满足 5 个安全条件"**——龟鱼混养网上教程良莠不齐，v1 提供可操作的判断标准
- v1 框架**继承 v26 的"自反性"传统**——v1 知道自己是"新手操作手册"，不是"养龟养鱼圣经"

**主要变化**：

1. **新建** `main.md`（约 25KB / 9 大部分 / 含 3 大公理 + 4 把尺子 + 养龟框架 + 养鱼框架 + 混养专章 + 实践路径 + 与 v26 关系 + 6 个质疑 + 边界声明）
2. **新建** `build_main_html.py`（基于健康理论 v1 build_main_html.py 简化版，主题色用 #0d9488 青绿色）
3. **新建** `index.html`（总入口，含 9 卡片快速入口 + 4 把尺子速览 + 元规则清单 + 版本历史）
4. **新建** `README.md`（项目说明，含文件结构 + 4 把尺子 + 5+5 元规则 + 5 个混养条件 + 6 个质疑）
5. **新建** `CHANGELOG.md`（本文，v1.0 初始化）
6. **编译** `main.html`（由 build_main_html.py 生成）

**9 大部分结构**（与 v1 健康理论的 8 部分结构对比）：

| # | 部分 | 备注 |
|---|------|------|
| 1 | 第一部分：为什么需要一套"养龟养鱼理论" | 3 大常见误区 + 为什么靠个人意志不够 |
| 2 | 第二部分：四把尺子（养龟养鱼通用版） | 3 大公理 + 4 把尺子 |
| 3 | 第三部分：养龟独立框架 | 养龟公理 + 4 把尺子特化 + 5 条元规则 |
| 4 | 第四部分：养鱼独立框架 | 养鱼公理 + 4 把尺子特化 + 5 条元规则 |
| 5 | 第五部分：混养专章 | 3 大冲突 + 5 个安全条件 + 3 种推荐组合 + 3 层生态 |
| 6 | 第六部分：从理论到行动 | 个人/家庭/社区/制度 4 层 |
| 7 | 第七部分：与四把尺子理论的关系 | 继承 + 适配 + 边界 + 与 v1 健康理论对照 |
| 8 | 第八部分：常见质疑与回应 | 6 个常见质疑 |
| 9 | 第九部分：v1 的边界声明 | 不覆盖 + 假设 + 后续计划 + 自反性声明 |

**4 把尺子的养龟养鱼版翻译**：

| 尺子 | v26 原文 | v1 养龟养鱼版 |
|------|----------|---------------|
| 兜底 | 生存价值 | 水生态安全（5 大参数） |
| 激励 | 创新价值 | 生态循环自我运转（硝化系统） |
| 能力 | 识别人才/机会 | 识龟辨病（7 大红旗）+ 识鱼辨病（6 大红旗） |
| 意义 | 守护什么值得活 | 微型生态艺术（陪伴/责任/审美/生态理解 4 层） |

**5+5 条元规则**（v1 框架的核心反直觉保护）：

养龟 5 条：
1. 不可让龟"长期饿到营养不良"
2. 不可让龟"完全晒不到 UVB"
3. 不可让"养龟经验"脱离龟本身
4. 不可让龟"长期单独养"而被忽视
5. 不可让"商家推荐"替代"龟的真实需求"

养鱼 5 条：
1. 不可让鱼"长期处于氨氮中毒"
2. 不可让鱼"在缺氧水中勉强活着"
3. 不可让"养鱼经验"脱离水本身
4. 不可让"美丽"替代"健康"
5. 不可让"商家推荐鱼种"替代"你的缸能不能养"

**5 个混养安全条件**（v1 框架的原创判断）：

1. 龟必须是大龟（> 15cm）🔴 必需
2. 鱼必须是中大型鱼（> 10cm）🔴 必需
3. 鱼必须游速快 🟡 推荐
4. 缸必须足够大（100L+）🔴 必需
5. 过滤必须强（2-3 倍）🔴 必需

**3 种推荐混养组合**：

| 龟 | 鱼 | 原因 |
|----|----|------|
| 草龟/巴西龟（> 15cm） | 锦鲤/金鱼（> 10cm） | 鱼游速不算慢，龟不容易抓到 |
| 草龟/巴西龟（> 15cm） | 麦穗鱼/鲫鱼（> 10cm） | 本地鱼耐受强，适应性高 |
| 大鳄龟（> 20cm） | 不推荐混养 | 鳄龟捕食能力太强 |

**配套文件清单**：

```
v1/
├── main.md              # 9 大部分，约 25KB
├── main.html            # 编译后
├── index.html           # 总入口
├── README.md            # 项目说明
├── build_main_html.py   # 编译脚本
└── CHANGELOG.md         # 本文件
```

**v1 与 v26 / v1 健康理论的关系**：

- v1 继承 v26 的 3 大公理 + 4 把尺子 + 元规则（在场之尺/隔离层/化冰费流向）
- v1 参照 v1 健康理论的 8 部分结构，但扩展为 9 部分（增加"养龟独立框架"和"养鱼独立框架"两章）
- v1 与 v1 健康理论是 v26 母理论的**两个平行子理论**

**v1 的自反性声明**（v1 第九部分原文）：

> **v1 知道自己"不是一个完整的养龟养鱼理论"**——它只是**一个起点**。
> 如果你发现 v1 的哪条原则与你的实际经验冲突，**以你的经验为准**——但请先验证 4-6 周（生态系统的变化需要时间）。
> 如果你发现 v1 的某条原则有明显错误，欢迎在补充文章中提出——v1.0.x 系列会保留错误并标注，作为"自我审视"的证据。

**v1 的边界**：

- 不覆盖海水鱼
- 不覆盖大型鱼缸（> 500L）
- 不覆盖商业养殖、稀有品种、龟/鱼繁殖
- 只识别红旗信号，不开药方
- 以家庭养宠为基本场景

---

## v1.0.x 后续计划

- **v1.1**：补充常见疾病图鉴（待补）
- **v1.2**：补充水草缸的完整配置
- **v1.3**：补充 3 种推荐混养缸的实战案例
- **v1.4**：v1 AI 讨论专用版（精简 50%）
- **v2.0**：扩展到"半水龟""陆龟""海水鱼"