🤖 AI 情报站

目标：屏幕打印出 hello。
① 装 Python（mac）

1. 苹果菜单 → 关于本机 → 记下芯片类型（Apple M 系列）；
2. 打开 python.org/downloads → 点黄色大按钮下载 .pkg；
3. 双击 .pkg → 一路「继续」→ 装完。

① 装 Python（Windows）

1. 打开 python.org/downloads → 下载 .exe；
2. 双击安装包，第一屏最底部务必勾选 Add python.exe to PATH；
3. 点 Install Now。

② 装 VS Code（两系统一致）

1. code.visualstudio.com → 下载安装；
2. 打开 VS Code → 左侧四个方块（扩展）→ 搜 Python → 安装微软官方那个。

③ 写并运行（mac）

1. 桌面新建文件夹 python学习；
2. VS Code → 文件 → 打开文件夹 → 选中它；
3. 左上角新建文件图标 → 命名 hello.py（.py 后缀必须）；
4. 输入 print("hello") → Cmd+S 保存；
5. 菜单 终端 → 新建终端 → 输入 python3 hello.py 回车；
6. 屏幕出现 hello = ✅。

③ 写并运行（Windows）

1. D 盘建文件夹，VS Code 打开；新建 hello.py 输入 print("hello")，Ctrl+S；
2. 终端 → 新建终端 → 输入 python hello.py（Windows 没有 3）；
3. 看到 hello = ✅。若提示「python 不是内部或外部命令」→ 回到①重装并勾选 PATH。

✅ 自测：不看教程，独立写一个打印自己名字的程序并跑通。

目标：写一个会判断、会重复的小脚本。

1. 新建 day2.py，逐行输入（注意 if/else 下一行要缩进 4 个空格，冒号不能少）：
   name = "我"
hour = 9
if hour < 12:
    print("早上好,", name)
else:
    print("下午好,", name)
for i in range(3):
    print("第", i, "遍提醒：该喝水了")
2. 运行 python3 day2.py（Windows: python）看输出；
3. 练习：range(3) 改 5；hour 改 20，判断改成 if hour > 18: 输出「晚上好」；
4. 报错 SyntaxError？→ 九成是缩进不齐或少了冒号，对照上面逐行检查。

✅ 自测：写程序判断一个数是奇数还是偶数（提示：% 2 == 0）。

什么是"装进函数"：上周的代码是一整段流水账；函数 = 给一段代码起名字打包，以后喊名字就能重复用，不用每次重写。

1. 新建 day3.py，输入并运行：
   def remind(name, hour):（def = 定义函数；括号里是"原料"参数）
       if hour < 12:
        print("早上好,", name)
    else:
        print("下午好,", name)

remind("妈妈", 9)（调用：喊名字+给原料）
   remind("老板", 15)（同一函数用两次——这就是函数的价值）
2. 列表 = 一排抽屉：todos = ["写周报", "开会", "健身"]；
   取第一个：print(todos[0])；
   加一个：todos.append("下班")；
   字典 = 带标签的抽屉：config = {"时间": "9点", "开关": True}；
   取值：print(config["时间"])
3. 综合练习：用 for 循环遍历 todos，把每件事传给提醒函数：
   for t in todos:
    print("待办：", t)
4. 产出：把第 2 周的提醒脚本改成"待办清单可配置版" ✅

✅ 自测：写一个函数 greet(name)，调用三次给三个不同的人问好。

目标：脚本关掉再开，配置还在。

1. 新建 day4.py：
   import json
config = {"时间": "9点", "提醒": "喝水"}
with open("config.json", "w", encoding="utf-8") as f:（⚠️ encoding 从本周起必写，Windows 不写必乱码）
       json.dump(config, f, ensure_ascii=False)
2. 运行后文件夹里多出 config.json → 用文本编辑器打开看一眼；
3. 读回来：with open("config.json", encoding="utf-8") as f: → c = json.load(f) → print(c["提醒"])；
4. 产出：把第 3 周的待办清单存进文件，启动时读出来 ✅

✅ 自测：把 {"名称": "我的脚本", "版本": 1} 存盘再读出打印。

目标：学会用别人写好的轮子，学会自己看病。

1. 终端/命令行输入：pip3 install requests（Windows: pip install requests）；
   国内慢加清华源：-i https://pypi.tuna.tsinghua.edu.cn/simple；
2. 新建 day5.py：import requests 不报错 = 装好了；
3. 读报错三步法：① 看最后一行（错误类型）② 往上看文件名和行号 ③ 把报错整段复制去问 AI——这本身就是 Agent 时代的基本功；
4. 故意制造一次报错（删个引号运行），练习定位。

✅ 自测：成功安装任意一个库并 import 使用。

目标：抓一个网页并提取标题——这就是本站 P1 的雏形。

1. 新建 day6.py：
   import requests
r = requests.get("https://www.qbitai.com/feed", timeout=15)（向网站发请求，像在浏览器输网址）
   r.encoding = "utf-8"
text = r.text（网页源码全在这了）
2. 提取标题（网页标题包在 <title> 标签里）：
   import re
m = re.search(r"<title>(.*?)</title>", text)
print(m.group(1))
3. 运行，看到「量子位 | 让AI...」之类的标题 = 成功；
4. 进阶：把网址换成 https://www.jiqizhixin.com/rss 再跑一次；
5. 产出：一个能抓任意网站标题的小脚本 ✅ 🎉 六周通关！

✅ 自测：抓两个不同网站的标题。

B：API 调用 → Prompt → Function Calling → MCP → RAG → 里程碑1（AI 版简报）。
C：ReAct 循环 → LangChain/LangGraph（配合 P2 的免费 Agent 实战）→ 规划记忆 → 多 Agent → 里程碑2（额度监控 Agent）。
D：定时任务/日志 → Web 界面 → 里程碑3（跨平台打包，接 P4）。
每周同样会有逐步骤教程：敲什么、看什么、报错怎么办。

① mac 出发前（每条命令在哪敲、啥意思）

1. 开终端：启动台搜「终端」（黑底窗口）；
2. 进项目文件夹：输入 cd + 空格 + 把文件夹从访达拖进终端 → 回车（路径自动填好，不用手打）；
3. pip freeze > requirements.txt：把"本项目用过哪些库"列成清单存成文件（Windows 端照着装）。
4. cd .. 退到上一层 → zip -r 源码.zip 源码-Mac（把「源码-Mac」换成你的文件夹名）→ 压缩包出现；
5. 自检：VS Code 里 Cmd+Shift+F 全局搜 /Users/，搜到写死路径就告诉我改。

② 传 Windows + 装环境

1. 微信传输助手/U盘 传 zip → Windows 右键全部解压到 D:\竞品采集台；
2. python.org 装 Python（勾 Add to PATH）→ Win+R 输 cmd → python --version 验证。

③ 装依赖 + 建 bat（手把手）

1. 打开 D:\竞品采集台 → 点一下地址栏空白，输入 cmd 回车（黑窗口自动定位本文件夹）；
2. 输入 pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple 回车等待装完；
3. 创建 run.bat：文件夹空白处右键 → 新建 → 文本文档 → 打开它粘贴：
   @echo off
chcp 65001 >nul
cd /d %~dp0
python main.py
   → 记事本菜单 文件 → 另存为 → 文件名 run.bat，保存类型「所有文件」，编码 UTF-8 → 保存 → 双击即运行；
4. 打 exe：同窗口 pip install pyinstaller → pyinstaller -F -n 竞品采集台 main.py → dist 文件夹里就是成品。

1. Windows 打包：项目文件夹内右键 → 发送到 → 压缩文件夹（生成 zip）；
2. 传回 mac：微信传输助手/U盘 → mac 下载文件夹 → 双击解压；
3. mac 重跑：终端 cd 进文件夹（拖拽技巧）→ python3 -m pip install -r requirements.txt → python3 main.py；
4. mac 打 .app：pip install pyinstaller → pyinstaller -w main.py → dist 里有 app；
   ⚠️ 数据文件参数：mac 用冒号 --add-data "ui:ui"，Windows 用分号 "ui;ui"。

铁律：不写死路径、open() 带 encoding="utf-8"、requirements.txt 随代码走。

ModuleNotFoundError → pip install 报错的名字；
UnicodeDecodeError → open() 加 encoding="utf-8"；
「python 不是内部或外部命令」→ 重装勾 PATH；
exe 闪退 → 地址栏输 cmd 回车，黑窗口运行看报错；
被拦截 → 更多信息 → 仍要运行（未签名正常）。