# Notes 知识库说明

这是当前笔记站点与本地知识库的根目录。

- 根目录：`/root/notes`
- 用途：统一存放持续沉淀的 Markdown 笔记、研究整理、专题文章与项目资料
- 访问方式：文档站默认直接暴露该目录内容
- 当前重心：AI 研究、Hermes Agent 相关拆解、宜居城市调研、教育/亲子、长期阅读与少量创作内容

## 当前内容概览

目前知识库已经形成了几条比较清晰的内容主线：

1. AI 与大模型研究
2. Hermes Agent 与工具调用机制
3. 宜居城市与家庭定居调研
4. 教育与亲子启蒙
5. 软件工程师 / AI 从业者长期阅读材料
6. 小说创作、圆桌讨论、旅行与 VPS 等专题归档

如果把最近新增内容压缩成一句话，可以概括为：

> 这个目录已经从“零散文档集合”逐步演化成一个以 AI、工程认知、家庭决策与长期成长为主轴的个人知识库。

---

## 最近更新的重点内容

### 1. AI 研究
最近新增的 AI 主题集中在“开源大模型如何理解、如何本地运行、如何真正部署起来”这条链路上：

- [本地部署一个开源大模型的完整链路](./ai_research/本地部署一个开源大模型的完整链路.md)
- [ChatGPT、Claude、Ollama、llama.cpp、Hugging Face 之间是什么关系](./ai_research/ChatGPT、Claude、Ollama、llama.cpp、Hugging%20Face%20之间是什么关系.md)
- [大模型的存在形式与运行方式](./ai_research/大模型的存在形式与运行方式.md)
- [LLM 工具调用确认机制整理](./ai_research/llm-tool-calling-confirmation.md)

这一组内容适合回答几类高频问题：

- 大模型到底是什么形式存在的
- ChatGPT、Claude、Ollama、llama.cpp、Hugging Face 分别处在哪一层
- 本地部署一个开源模型，从目标、硬件、模型格式到运行时、服务化，到底会经过哪些步骤
- Agent 里的 tool call 是怎么被确认、执行和回填的

### 2. Hermes Agent 相关
围绕 Hermes 的资料，已经不只是“使用说明”，而是开始进入源码与机制层：

- [Hermes 源码视角：工具调用实现拆解](./hermes_about/hermes-tool-calling-source-walkthrough.md)
- [Hermes Skills 分类总览与个人助理优先级地图](./hermes_about/hermes-skills-personal-map-2026-04-15.md)
- [AI 时代的笔记软件，会长成什么样？Hermes Agent 离这个方向还有多远](./hermes_about/ai-note-software-and-hermes-article.md)

### 3. 定居与家庭决策调研
当前较新的另一条主线，是围绕宜居城市与家庭长期生活选择的调研：

- [宜居城市调研总结与个性化建议](./city_livability/livable_cities_summary_and_personalized_recommendation_2026-04-26.md)
- [中国宜居城市前20调研与评分（2024版）](./city_livability/china_livable_cities_top20_2024.md)
- [10个城市宜居度对比：烟台、威海、南通、台州、绍兴、漳州、汕头、惠州、北海、大连](./city_livability/10_cities_livability_compare_yantai_weihai_nantong_taizhou_shaoxing_zhangzhou_shantou_huizhou_beihai_dalian.md)

这部分更偏生活决策：结合软件工程师、有孩子、重视教育、不喜欢寒冷等约束，做长期定居选择。

### 4. 教育与长期成长
- [小孩逻辑学入门方案](./education/儿童逻辑学入门方案.md)
- [软件工程师与 AI 从业者书单（10 本）](./articles/软件工程师与AI从业者书单-10本.md)
- [软件工程师与 AI 从业者书单知识图谱](./articles/软件工程师与AI从业者书单-知识图谱.md)

这部分内容开始把“个人成长”扩展到“家庭教育 + 职业成长 + 认知升级”。

---

## 当前目录结构

### `ai_research/`
AI、大模型、Agent、Prompt、运行时与本地部署相关研究。

近期代表内容：
- 开源大模型本地部署完整链路
- ChatGPT / Claude / Ollama / llama.cpp / Hugging Face 关系梳理
- 大模型存在形式与运行方式
- LLM 工具调用确认机制
- Anthropic Managed Agents 深度解读

### `hermes_about/`
Hermes Agent 相关说明、源码机制拆解与定位分析。

### `city_livability/`
宜居城市研究、候选城市对比、个性化定居建议。

### `education/`
亲子教育、儿童认知启蒙、学习方法等内容。

### `articles/`
相对完整的主题文章、书单整理、结构化拆解稿。

### `noval/`
小说章节草稿与创作内容归档。

### `roundtables/`
圆桌讨论类输出，适合保留多视角观点碰撞过程。

### `travel/`
旅行研究、路线安排与出行准备资料。

### `vps/`
VPS、工具选型与基础设施相关专题。

---

## 推荐阅读入口

如果第一次进入这个知识库，建议按下面顺序阅读：

### 想快速了解最近在研究什么
1. [本地部署一个开源大模型的完整链路](./ai_research/本地部署一个开源大模型的完整链路.md)
2. [ChatGPT、Claude、Ollama、llama.cpp、Hugging Face 之间是什么关系](./ai_research/ChatGPT、Claude、Ollama、llama.cpp、Hugging%20Face%20之间是什么关系.md)
3. [宜居城市调研总结与个性化建议](./city_livability/livable_cities_summary_and_personalized_recommendation_2026-04-26.md)

### 想从机制层理解 Agent / Hermes
1. [LLM 工具调用确认机制整理](./ai_research/llm-tool-calling-confirmation.md)
2. [Hermes 源码视角：工具调用实现拆解](./hermes_about/hermes-tool-calling-source-walkthrough.md)
3. [Hermes Skills 分类总览与个人助理优先级地图](./hermes_about/hermes-skills-personal-map-2026-04-15.md)

### 想看生活与家庭决策方向
1. [宜居城市调研总结与个性化建议](./city_livability/livable_cities_summary_and_personalized_recommendation_2026-04-26.md)
2. [小孩逻辑学入门方案](./education/儿童逻辑学入门方案.md)
3. [10个城市宜居度对比](./city_livability/10_cities_livability_compare_yantai_weihai_nantong_taizhou_shaoxing_zhangzhou_shantou_huizhou_beihai_dalian.md)

---

## 文件与命名约定

优先保证：可读、可排序、可检索。

常见格式：

- `YYYYMMDDTHHMMSS--主题名称.md`
- `YYYYMMDDTHHMMSS--圆桌-议题名__roundtable.md`
- `YYYYMMDDTHHMMSS--旅行研究-地点名__travel.md`
- `chapter-xx.md`

命名原则：

1. 文件名尽量能直接表达主题
2. 时间戳命名适合过程性输出与归档材料
3. 长期会复用、会被引用的内容，优先使用语义化文件名

---

## 使用与维护约定

1. 新内容默认继续写入 `/root/notes`
2. 能归类进稳定主题的，优先进入对应子目录
3. 如果某条主线持续增长，再拆更细的子目录
4. 首页 `index.html` 只放导航、重点推荐和目录入口，不承载全部内容
5. `README.md` 负责解释这个知识库当前在研究什么、结构如何、优先看什么

---

## 页面访问

常见访问方式：

- 首页：`http://127.0.0.1/`
- 根目录说明：`http://127.0.0.1/README.md`

只要文档写入 `/root/notes`，通常就可以继续通过当前文档站访问。

---

最后更新：已根据当前最新笔记主题，重新整理首页与根目录说明。