From c0cd3f8a62fa660418bc72fa1a998b677a13040b Mon Sep 17 00:00:00 2001
From: hblu <hblu1985@163.com>
Date: Sun, 4 Jan 2026 19:05:23 +0800
Subject: [PATCH] docs: update project documentation

---
 README.md | 22 ++++++++++++++++++++++
 1 file changed, 22 insertions(+)

diff --git a/README.md b/README.md
index 81b337f..0b57d08 100644
--- a/README.md
+++ b/README.md
@@ -138,6 +138,28 @@ uv --version      # 应显示 uv 0.x.x
     uv run main.py
     ```
 
+
+### 1.3.0 核心概念补课: DeepSeek 与 API
+
+#### 🦄 什么是 DeepSeek?
+DeepSeek 是 2026 年最耀眼的 **开源 AI 模型**。
+*   **代码天才**: 它的 Coding 能力在 2026 年稳居第一梯队，甚至超过了许多闭源模型。
+*   **性价比之王**: API 价格极低（几乎是免费的），非常适合学生党和初创项目。
+*   **开源精神**: "Open Weights" 让它成为全球开发者的宠儿。
+
+#### 🔌 什么是 API (Application Programming Interface)?
+想象你在去一家餐厅吃饭：
+*   **你 (User)**: 想要吃饭（比如"生成一段代码"）。
+*   **厨房 (LLM)**: 大厨负责做饭（生成内容），但你不能直接冲进厨房。
+*   **服务员 (API)**: 你把菜单（Prompt）给服务员，服务员把需求传给厨房，再把菜端给你。
+
+**API 就是那个"服务员"**。它让你的 Python 代码能优雅地和远端的 AI 大脑对话。
+
+#### 💡 为什么要用 LLM API？
+1.  **稳定性**: 网页版 ChatGPT 可能会封号、会变慢，API 则是为工业级应用设计的，稳定可靠。
+2.  **可集成 (Embeddable)**: 你不能把网页版 ChatGPT 塞进你的 Excel 里，但 API 可以。你可以把 AI 的"大脑"装进任何 APP、网页或脚本中。
+3.  **自动化 (Automation)**: 网页版一次问一个问题；API 可以写个循环，一分钟处理 1000 个 Excel 表格。
+
 #### DeepSeek API 快速入门 (主流推荐)
 
 DeepSeek API 完全兼容 OpenAI SDK，这意味着你可以直接使用最成熟的生态工具。