docs: update project documentation

This commit is contained in:
hblu 2026-01-04 19:05:23 +08:00
parent 09fb29c382
commit c0cd3f8a62

View File

@ -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这意味着你可以直接使用最成熟的生态工具。