refactor(officefile): 按 md/latex/word 三层结构重组文档目录

将 Markdown 源文件移入 md/,LaTeX 工作目录保留在 latex/,
Word 导出移入 word/;删除临时脚本、调试截图和空 stub。

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
2026-05-29 14:25:21 +08:00
parent de7a47db9d
commit a90f7adfa1
64 changed files with 7 additions and 58 deletions
@@ -0,0 +1,198 @@
# 00.1 为什么要读这本书
## 核心问题
> 当AI能帮我们写代码、做分析、出方案时,我们为什么还要学习原理?
> 在技术快速迭代的当下,什么样的知识才值得投资时间?
---
## 概念讲解
### AI的"黑箱"问题
随着大模型(LLM)的普及,AI系统变得越来越强大,但也越来越不透明。这种现象被称为**黑箱化**:
```
输入 ──→ [ AI黑箱 ] ──→ 输出
↑ ↑
看不见 理解不了
```
**黑箱化的三个层次**
1. **算法黑箱**:神经网络内部数百万参数的决策过程难以解释
2. **工具黑箱**:封装好的API调用,不知道内部如何工作
3. **认知黑箱**:连问"为什么"的能力都丧失了
### 空间智能的特殊性
空间分析与一般的智能任务有几个关键区别:
| 维度 | 一般AI任务 | 空间AI任务 |
|-----|-----------|-----------|
| 数据结构 | 文本、图像为主 | 栅格、矢量、图 |
| 关系类型 | 语义关系 | 空间关系(拓扑、距离、方向) |
| 不确定性 | 语义歧义 | 位置误差、尺度效应、边界模糊 |
| 可视化 | 辅助理解 | 核心分析手段 |
| 领域知识 | 可迁移 | 强依赖地理学、生态学等 |
这些特殊性意味着:
- 通用AI模型不能直接解决空间问题
- 需要理解空间分析的本质才能有效设计AI系统
- 验证空间AI的结果需要空间思维
### 原理学习的持久价值
**技术迭代的两个速度**
```
易变层(命令、框架、API)── 半衰期:6-18个月
├─ 示例:QGIS 2.x → 3.x 界面大变
├─ 示例:LangChain → LangGraph 架构演进
└─ 示例:OpenAI API 格式频繁更新
稳定层(设计思想、原理、模式)── 半衰期:10-20年
├─ 示例:图算法在空间分析中的应用
├─ 示例:模块化设计原则
└─ 示例:Human-in-the-Loop理念
```
**投资回报分析**
| 知识类型 | 学习难度 | 过时风险 | 长期价值 |
|---------|---------|---------|---------|
| 具体命令操作 | 低 | 高 | 低 |
| 框架使用方法 | 中 | 中 | 中 |
| 设计原理 | 中 | 低 | 高 |
| 底层思想 | 高 | 极低 | 极高 |
---
## 设计原理
### 为什么选择Claude Code作为脚手架
Claude Code有几个特点使其成为学习AI原理的理想工具:
1. **透明性**:可以看到AI的思考过程(function call、tool use
2. **可扩展性**Skill、Agent、Hook的设计模式清晰
3. **工具中性**:不绑定特定平台,可迁移原理
### "脚手架"比喻的含义
```
┌─────────────────────────────────────┐
│ 建筑物的结构 │ ← 持久的原理知识
│ (空间智能的原理) │
├─────────────────────────────────────┤
│ ╔═════════╗ │
│ ║ 脚手架 ║ │ ← 临时的学习工具
│ ╚═════════╝ │ ← Claude Code
└─────────────────────────────────────┘
```
脚手架的作用:
- **支撑学习过程**:让你能到达原本够不到的高度
- **可拆卸**:学会后可以移除,知识已内化
- **可复用**:用于学习不同的知识领域
---
## 案例分析:ENAgent项目
ENAgent是一个生态网络分析智能体系统,用它来说明原理学习的重要性。
### 问题背景
生态网络分析包括多个步骤:
1. 生态源地识别
2. 阻力面构建
3. 最小累积阻力(MCR)分析
4. 生态廊道提取
5. 网络优化
6. 结果评估
传统做法:每个步骤用不同工具,手动操作,容易出错。
### AI解决方案
如果只关注"怎么做",可能会写:
```python
# 这种代码只会调用,不理解原理
def ecological_analysis(input_data):
result = some_ai_model.generate_analysis(input_data)
return result
```
**问题**
- 结果不对时不知道为什么
- 无法调整参数适应不同场景
- 换个模型就不会用了
### 理解原理的做法
理解每个步骤的原理后:
```python
def ecological_analysis_with_principles(
landcover: GeoDataFrame,
species_params: Dict,
resistance_weights: Dict,
checkpoints: List[str] = None
) -> AnalysisResult:
"""
基于原理的生态网络分析
原理1:生态源地识别基于多准则评估
原理2:阻力面反映物种移动的空间异质性
原理3:MCR本质是图上的最短路径问题
原理4:廊道提取需要考虑连接性和宽度
Args:
landcover: 土地利用覆盖数据
species_params: 目标物种的景观偏好参数
resistance_weights: 各土地类型的阻力权重
checkpoints: HITL审查点,人类介入的关键决策
"""
# 每一步都理解原理,知道为什么这样做
...
```
**优势**
- 可以解释每个决策的理由
- 能根据具体问题调整方法
- 工具变化时原理保持不变
---
## 反思与延伸
### 思考问题
1. **自我诊断**:你目前学习新技术的方式是什么?更偏向"怎么做"还是"为什么"
2. **知识审计**:列出你掌握的技能,哪些是易变层,哪些是稳定层?
3. **迁移测试**:如果从QGIS换成ArcGIS,从OpenAI换成Claude,你的哪些知识可以直接迁移?
4. **黑箱体验**:回想一次你使用AI但无法理解结果的经历,缺少什么知识才能理解?
### 延伸阅读
- **《如何解题》** (Polya) - 数学思维的本质
- **《系统化思维导论》** (Gerald Weinberg) - 理解复杂系统
- **《技术的本质》** (Brian Arthur) - 技术演进的规律
---
## 关键要点
1. **黑箱化是AI时代的普遍风险**,主动学习原理可以抵抗
2. **空间智能有独特性**,需要专门的理解,不能完全依赖通用AI
3. **投资稳定层知识**,半衰期长,迁移性强
4. **Claude Code是脚手架**,帮助理解原理而非替代思考
5. **ENAgent案例说明**:理解原理让你能设计、调试、改进系统
> "授人以鱼不如授人以渔。在AI时代,授人以AI不如授人以理解AI的能力。"