🤖 AI 情报站

目标：屏幕上打印出 hello，你就入门了。

① 装 Python（mac）

1. 点屏幕左上角 → 关于本机 → 确认芯片：Apple M 系列或 Intel；
2. 浏览器打开 python.org/downloads → 点黄色大按钮下载；
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 → 装第一个（微软官方）。

③ 写并运行 hello.py（mac）

1. 桌面建文件夹 python学习；
2. VS Code → 文件 → 打开文件夹 → 选它；
3. 左上角新建文件 → 输入 hello.py 回车（.py 后缀是关键）；
4. 输入一行：print("hello") → 按 Cmd+S 保存；
5. VS Code 顶部菜单 终端 → 新建终端 → 输入 python3 hello.py 回车；
6. 看到 hello = ✅ 完成！

③ 写并运行 hello.py（Windows）

1. D 盘或桌面建文件夹 python学习；VS Code 打开它；
2. 新建 hello.py，输入 print("hello")，Ctrl+S 保存；
3. 终端 → 新建终端 → 输入 python hello.py 回车（Windows 是 python 不是 python3）；
4. 看到 hello = ✅ 完成！

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

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

1. 新建 day2.py，逐行输入并运行（每行都试试改改）：
   name = "我"（变量：存东西）
   hour = 9
if hour < 12:（条件：if 后面缩进 4 个空格）
       print("早上好," + name)
else:
    print("下午好," + name)
for i in range(3):（循环：重复 3 次）
       print("第", i, "遍提醒：喝水")
2. 练习：把 range(3) 改成 5，把判断改成 hour > 18 输出"晚上好"；
3. 产出：每日提醒小脚本 ✅

卡点自查：报错 SyntaxError = 缩进或冒号问题，对齐教程检查。

把上周代码装进函数：def remind(name, hour): → 学列表 ["a","b"]、字典 {"时间": "9点"} → 产出：提醒脚本可配置版。详细步骤解锁后展开。

学 open(文件, "w", encoding="utf-8")（⚠️ encoding 从本周起必写）→ 配置存进 JSON → 产出：脚本会存读配置。

终端跑 pip install requests → 学会看报错最后两行 → 产出：用第三方库做事。

用 requests 抓一个网页 → 提取标题 → 🎉 这就是本情报站 P1 的雏形！

B 阶段：API 调用 → Prompt → Function Calling → MCP → RAG → 里程碑1（AI 版简报）。
C 阶段：ReAct 循环 → 框架 → 规划记忆 → 多 Agent → 里程碑2（额度监控 Agent）。
D 阶段：定时任务/日志 → Web 界面 → 里程碑3（跨平台打包）。每阶段解锁后此处展开手把手教程。

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

1. 打开终端：启动台 → 搜「终端」→ 打开（黑底白字窗口）；
2. 进入你的项目文件夹：输入 cd + 空格 + 把文件夹从访达拖进终端窗口（自动填路径）→ 回车。例：cd ~/Desktop/日常文件/AI/竞品采集台/源码-Mac。之后所有命令都在这个文件夹里生效，不用再管路径；
3. pip freeze > requirements.txt：让 Python 把「本项目装过哪些库」列成清单存进 requirements.txt（Windows 端要照着装）。敲完回车无报错即成功；
4. find . -name __pycache__ -exec rm -rf {} +：删缓存垃圾（可不执行，无害）；
5. cd ..（退到上一层文件夹）然后 zip -r 源码.zip 源码-Mac：把整个文件夹压成一个 zip。⚠️ 把「源码-Mac」换成你的实际文件夹名；
6. 自检：用 VS Code 搜代码里有没有 /Users/你的用户名 这种写死的路径，有就告诉我来改。

② 传到 Windows：微信文件传输助手 / U盘 / 网盘 → 右键 zip → 全部解压到 D:\竞品采集台。

③ Windows 装环境（仅第一次）

1. python.org/downloads → 下载 → 安装时勾选 Add python.exe to PATH；
2. 验证：Win+R → 输 cmd → 回车 → 输 python --version → 显示版本号即成功。

④ 装依赖 + 创建双击启动器（手把手）

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：cmd 里 pip install pyinstaller，再 pyinstaller -F -n 程序名 main.py，成品在 dist 文件夹里。

场景：公司 Windows 电脑上的代码/改动要带回家里 mac。

1. Windows 打包：进项目文件夹 → 地址栏输 cmd 回车 → del /s /q __pycache__ 清缓存（可选）→ 如果装了压缩软件就右键文件夹压缩成 zip；没装就用文件资源管理器选中文件夹 → 右键 → 发送到 → 压缩文件夹；
2. 传回 mac：微信文件传输助手 / U盘，把 zip 拷到 mac 下载文件夹；
3. mac 解压：双击 zip（用系统自带的「归档实用工具」就行）→ 得到文件夹；
4. 装依赖重跑：终端 cd 进项目文件夹（拖文件夹进终端的技巧同上）→ python3 -m pip install -r requirements.txt → python3 main.py；
5. mac 上打 .app（想给 mac 双击图标的话）：pip install pyinstaller → pyinstaller -w main.py → dist 里有 app。注意：--add-data 参数 mac 上用冒号 ui:ui，Windows 上用分号 ui;ui。

两个方向共同的铁律：代码里不写死路径、open() 都带 encoding="utf-8"、依赖清单随代码走。

ModuleNotFoundError → pip install 报错的那个名字（cmd/终端里）；
UnicodeDecodeError → 代码里 open(...) 加 encoding="utf-8"；
「python 不是内部或外部命令」→ 重装 Python 勾选 Add to PATH；
双击 exe 闪退 → 地址栏输 cmd 回车，在黑窗口里运行 exe 看真实报错；
exe 被拦 → 「更多信息」→「仍要运行」（未签名正常现象）。