refactor: 重组项目目录结构
以讲义内容为骨架迁移到标准目录格式： - officefile/ 主内容（12章 + 附录 + CC4SI补充） - dofile/ 代码示例（11个Python脚本） - data/ 图片资源 - output/ 生成输出（忽略） - Archive/ 归档旧目录（忽略） - .claude/skills/ 保留markdown-to-docx工具链 - .pandoc/ 保留CSL和本地化配置 Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
This commit is contained in:
@@ -0,0 +1,237 @@
|
||||
# Claude Code for Spatial Intelligence and Autonomous Design
|
||||
## 空间智能与自主设计：AI原理与实践手册
|
||||
|
||||
**目标定位**：面向空间研究与设计领域的混合读者，以Claude Code为脚手架，帮助理解AI背后的思想、原理和方法，在技术快速迭代的当下建立持久的认知框架。
|
||||
|
||||
**核心原则**：
|
||||
- 重原理轻操作——关注不变的设计思想，而非易变的命令语法
|
||||
- 理论与实践均衡——50%概念讲解 + 50%实践案例
|
||||
- 面向混合读者——兼顾研究者和设计者的不同需求
|
||||
|
||||
---
|
||||
|
||||
## 目录结构
|
||||
|
||||
```
|
||||
CC4SI/
|
||||
├── README.md # 丛书说明
|
||||
├── BOOK.md # 主入口（整合目录）
|
||||
├── 00-introduction/ # 第一部分：导论
|
||||
├── 01-foundations/ # 第二部分：基础原理
|
||||
├── 02-spatial-intelligence/ # 第三部分：空间智能
|
||||
├── 03-autonomous-design/ # 第四部分：自主设计
|
||||
├── 04-practice/ # 第五部分：综合实践
|
||||
├── 05-reflection/ # 第六部分：反思与展望
|
||||
├── references/ # 参考资料
|
||||
└── examples/ # 可运行代码示例
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 内容概览
|
||||
|
||||
### 第一部分：导论 (00-introduction)
|
||||
|
||||
建立读者对AI在空间领域应用的宏观认知
|
||||
|
||||
| 章节 | 标题 | 核心内容 |
|
||||
|-----|------|---------|
|
||||
| 00.1 | 为什么要读这本书 | AI的"黑箱"问题；空间智能的特殊性；原理学习的持久价值 |
|
||||
| 00.2 | 空间智能是什么 | 空间认知的层次；从GIS到空间智能；空间推理的本质 |
|
||||
| 00.3 | 自主设计的含义 | Human-in-the-Loop；自动与自主的区别；设计智能的演进 |
|
||||
| 00.4 | Claude Code作为脚手架 | 为什么选择Claude Code；Agent、Skill、Hook的概念；工具中性原则 |
|
||||
|
||||
**实践案例00**：搭建你的第一个空间AI助手
|
||||
|
||||
---
|
||||
|
||||
### 第二部分：基础原理 (01-foundations)
|
||||
|
||||
理解现代AI系统的核心设计原理，超越具体工具
|
||||
|
||||
| 章节 | 标题 | 核心内容 |
|
||||
|-----|------|---------|
|
||||
| 01.1 | 智能的模块化视角 | 为什么需要模块化；函数式组合思想；技能即能力封装 |
|
||||
| 01.2 | 状态与状态机 | 状态是什么；为什么状态管理是核心；LangGraph的设计哲学 |
|
||||
| 01.3 | 概率与不确定性 | 空间分析中的不确定性；AI如何处理未知；置信度的概念 |
|
||||
| 01.4 | 反馈与学习 | 强化学习直觉；奖励函数设计；探索与利用的权衡 |
|
||||
| 01.5 | 人机协同的原理 | HITL的理论基础；何时需要人类介入；信任校准 |
|
||||
|
||||
**实践案例01**：用LangGraph构建一个简单的空间决策工作流
|
||||
|
||||
---
|
||||
|
||||
### 第三部分：空间智能 (02-spatial-intelligence)
|
||||
|
||||
理解AI如何"理解"和操作空间
|
||||
|
||||
| 章节 | 标题 | 核心内容 |
|
||||
|-----|------|---------|
|
||||
| 02.1 | 空间表征 | 栅格 vs 矢量；图表示；多尺度表征；空间索引原理 |
|
||||
| 02.2 | 空间推理 | 邻近性分析；连通性；空间关系推理；图算法在空间中的应用 |
|
||||
| 02.3 | 多准则决策 | 权重的本质；标准化方法；敏感性分析；专家知识编码 |
|
||||
| 02.4 | 空间优化 | 什么可优化；目标函数设计；约束处理；启发式搜索 |
|
||||
| 02.5 | 不确定性量化 | 空间不确定性来源；传播分析；可视化；决策稳健性 |
|
||||
|
||||
**实践案例02**：构建生态系统服务评估Skill
|
||||
**实践案例03**：最小累积阻力(MCR)分析的自动化
|
||||
|
||||
---
|
||||
|
||||
### 第四部分：自主设计 (03-autonomous-design)
|
||||
|
||||
理解自主系统的设计模式和工作流编排
|
||||
|
||||
| 章节 | 标题 | 核心内容 |
|
||||
|-----|------|---------|
|
||||
| 03.1 | 工作流编排原理 | DAG（有向无环图）；节点与边；条件分支；错误处理模式 |
|
||||
| 03.2 | Agent设计模式 | Reflex Agent；Model-based Agent；Goal-based；Utility-based |
|
||||
| 03.3 | 技能组合与复用 | 技能抽象；接口设计；组合模式；技能发现 |
|
||||
| 03.4 | 记忆与上下文 | 短期/长期记忆；状态持久化；检索机制；知识库构建 |
|
||||
| 03.5 | 规划与执行 | 前向/后向搜索；分层规划；执行监控；重规划 |
|
||||
|
||||
**实践案例04**：设计一个自主空间分析Agent
|
||||
**实践案例05**：实现Human-in-the-Loop审查机制
|
||||
|
||||
---
|
||||
|
||||
### 第五部分：综合实践 (04-practice)
|
||||
|
||||
通过完整项目将所学整合
|
||||
|
||||
| 项目 | 描述 | 涉及章节 |
|
||||
|-----|------|---------|
|
||||
| 项目A | 生态源地自动识别与优先级排序 | 02.1, 02.3, 03.1 |
|
||||
| 项目B | 生态阻力面的多准则构建 | 02.3, 02.5, 03.3 |
|
||||
| 项目C | 生态网络的自主分析与优化 | 02.2, 02.4, 03.4 |
|
||||
| 项目D | 带HITL的完整工作流设计 | 全部章节 |
|
||||
|
||||
---
|
||||
|
||||
### 第六部分：反思与展望 (05-reflection)
|
||||
|
||||
培养批判性思维，建立长期视角
|
||||
|
||||
| 章节 | 标题 | 核心内容 |
|
||||
| ---- | --------- | --------------------------- |
|
||||
| 05.1 | AI的局限与幻觉 | 空间AI可能出错的地方；如何验证；人类专家的不可替代性 |
|
||||
| 05.2 | 伦理与责任 | 空间决策的伦理维度；可解释性；问责机制 |
|
||||
| 05.3 | 技术迭代与持久知识 | 什么在变；什么不变；如何持续学习 |
|
||||
| 05.4 | 空间AI的未来方向 | 空间大模型；多模态；具身智能 |
|
||||
| 05.5 | 个人知识体系 | 建立自己的AI工具箱；文档化策略；社区参与 |
|
||||
|
||||
---
|
||||
|
||||
## 如何使用本书
|
||||
|
||||
### 面向研究者
|
||||
如果你是空间研究领域的学者或学生，建议：
|
||||
1. 先完成00-introduction，建立宏观认知
|
||||
2. 重点阅读01-foundations，理解AI设计原理
|
||||
3. 根据研究需要选择性深入02和03部分
|
||||
4. 通过04-practice的项目验证理解
|
||||
|
||||
### 面向设计者
|
||||
如果你是设计实践者或技术实现者，建议：
|
||||
1. 快速浏览00-introduction
|
||||
2. 重点关注03-autonomous-design的工作流编排
|
||||
3. 边读边做，每个实践案例都亲手运行
|
||||
4. 使用examples目录中的代码作为起点
|
||||
|
||||
### 面向教学者
|
||||
如果你使用本书作为教学材料：
|
||||
1. 每章节预留2-3课时（理论+实践）
|
||||
2. 使用"核心问题"引发讨论
|
||||
3. 鼓励学生完成"反思与延伸"中的问题
|
||||
4. 项目A-D可作为期末综合项目
|
||||
|
||||
---
|
||||
|
||||
## 环境准备
|
||||
|
||||
### 基础要求
|
||||
- Python 3.10+
|
||||
- Claude Code CLI
|
||||
- QGIS 3.x（可选，用于空间分析）
|
||||
|
||||
### 安装Claude Code
|
||||
```bash
|
||||
npm install -g @anthropic/claude-code
|
||||
```
|
||||
|
||||
### Python依赖
|
||||
```bash
|
||||
pip install langgraph langchain-anthropic geopandas rasterio networkx matplotlib
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 写作规范
|
||||
|
||||
### 内容原则
|
||||
1. **原理优先**：先讲"为什么"，再讲"怎么做"
|
||||
2. **中英双语**：专业术语保留英文，解释用中文
|
||||
3. **代码示例**：完整可运行，有注释，说明设计意图
|
||||
4. **图示辅助**：架构图、流程图、概念图优先于纯文字
|
||||
5. **案例真实**：基于ENAgent等实际项目，避免玩具示例
|
||||
|
||||
### 文件命名规范
|
||||
```
|
||||
XX-category/
|
||||
├── README.md # 章节导读
|
||||
├── XX.1-chapter-name.md
|
||||
├── XX.2-chapter-name.md
|
||||
└── practice/ # 本章节的实践
|
||||
└── practice-name/
|
||||
```
|
||||
|
||||
### Markdown模板
|
||||
每章节遵循以下结构：
|
||||
```markdown
|
||||
# 章节标题
|
||||
|
||||
## 核心问题
|
||||
（用1-2个问题引导读者思考）
|
||||
|
||||
## 概念讲解
|
||||
（原理阐述，配合图示）
|
||||
|
||||
## 设计原理
|
||||
（为什么这样设计，权衡是什么）
|
||||
|
||||
## 代码示例
|
||||
```python
|
||||
# 可运行代码，有详细注释
|
||||
```
|
||||
|
||||
## 案例分析
|
||||
（真实项目的相关代码解析）
|
||||
|
||||
## 反思与延伸
|
||||
（启发思考的问题）
|
||||
|
||||
## 参考资料
|
||||
（相关阅读）
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 贡献指南
|
||||
|
||||
本书是开源项目，欢迎贡献：
|
||||
|
||||
1. **报告问题**：在Issues中指出错误或改进建议
|
||||
2. **提交内容**：Fork后创建分支，提交PR
|
||||
3. **讨论案例**：分享你的实践经验和案例
|
||||
|
||||
---
|
||||
|
||||
## 许可证
|
||||
|
||||
CC BY-NC-SA 4.0 - 允许非商业使用和修改，需署名并以相同方式共享
|
||||
|
||||
---
|
||||
|
||||
## 版本历史
|
||||
|
||||
- v0.1.0 (2025-01) - 初始版本，框架搭建完成
|
||||
Reference in New Issue
Block a user