# 录制资源包导航

> 你刚拿到这个文件夹，10 分钟内看懂怎么用——本文档就是干这个的。

## 包里有什么

```
AMD-录制资源包/
├── 00-从这里开始读.md          ← 你现在看的这份
├── 01-脚本.md                 ← 视频脚本 v2 修订版（核心产出）
├── 02-录制Best-Practice.md     ← 性能调优 + Windows 操作 + 户外拍摄
├── 03-演示Prompt速查.md         ← 录制时直接复制粘贴的 prompt
├── skills/                    ← 两个 skill 本体
│   ├── huashu-data-pro/        （数据分析，§4 用）
│   └── huashu-doc-reviewer/    （合同批注，§5 用）
├── 演示数据/                   ← Skill 跑演示用的样本
│   ├── sample_finance.xlsx     （财务数据）
│   ├── sample_contract.docx    （合同样本）
│   ├── decisions_demo.json     （兜底救命）
│   └── expected_output.docx    （预录成品）
└── Windows安装/               ← 4 份装机指南
    ├── 1-Python依赖.txt
    ├── 2-Node依赖.txt
    ├── 3-环境变量配置.txt
    └── 4-Skill安装到Claude-Code.txt
```

---

## Windows 笔记本第一次开机要做的事（按顺序）

**预计耗时 1-2 小时（首次安装），熟手 30 分钟内**

### 阶段 1：装基础环境（30 分钟）
- [ ] 装 Python 3.11+ → 看 `Windows安装/1-Python依赖.txt`
- [ ] 装 Node.js 18+ → 看 `Windows安装/2-Node依赖.txt`
- [ ] 装 Ollama → https://ollama.com/download/windows（这次演示主用）
- [ ] 装 Claude Code → `npm install -g @anthropic-ai/claude-code`

### 阶段 2：配性能（30 分钟）
- [ ] 按 `02-录制Best-Practice.md` §1.3 设 AMD Software 专用显存 64GB
- [ ] Ollama 拉 gpt-oss:120b 和 qwen3.6:35b-a3b（约 85 GB，建议夜里挂着）
- [ ] 设 Ollama 关键环境变量（`OLLAMA_NUM_GPU=999`、`OLLAMA_MAX_LOADED_MODELS=3` 等，详见 `3-环境变量配置.txt`）
- [ ] Windows 电源计划改「最佳性能」+ 处理器 100%

### 阶段 3：装 skill（15 分钟）
- [ ] 按 `Windows安装/4-Skill安装到Claude-Code.txt` 把 skills 拷到 .claude\skills\
- [ ] 进入 huashu-data-pro\scripts 跑 `npm install`
- [ ] 装 playwright chromium

### 阶段 4：配本地模型（10 分钟）
- [ ] 按 `Windows安装/3-环境变量配置.txt` 永久设 LOCAL_LLM_BASE_URL 等环境变量
- [ ] 重启 PowerShell
- [ ] curl 测试 server 通不通

### 阶段 5：演示数据预跑（30 分钟，最关键）
- [ ] 把 `演示数据/sample_finance.xlsx` 复制到工作目录
- [ ] Claude Code 跑 `03-演示Prompt速查.md` §4 的主 Prompt
- [ ] 跑通 → 删除产物 → **再跑一次**确认稳定性
- [ ] 同样流程跑 §5 的合同审查
- [ ] **拔掉网线再跑一次**——这是录制时的真实场景

---

## 录制当天工作流（按顺序）

| 时段 | 看哪份文档 |
|---|---|
| 起床第一件事 | `02-录制Best-Practice.md` §6 录制现场 Checklist（贴墙）|
| 户外拍摄 | `02-录制Best-Practice.md` §4 户外笔记本镜头拍法 |
| 室内演示前 | `02-录制Best-Practice.md` §1 性能调优全套设置（验证生效）|
| 演示开始 | `03-演示Prompt速查.md`（边录边复制 Prompt）|
| 演示翻车 | `03-演示Prompt速查.md` 兜底救命方案 |
| 口播朗读 | `01-脚本.md`（按段念，✏️ v2 修订标记是依据，不要念出来）|

---

## 三件最容易翻车的事

### 1. Ollama GPU 没用上
症状：120B 跑到每秒 2 个 token
解决：环境变量 `OLLAMA_NUM_GPU=999` 设了吗？AMD Software 专用显存 64G 设了吗？
详见：`02-录制Best-Practice.md` §1.4

### 2. 户外不接电源跑大模型
症状：模型直接报错或超慢
解决：演示全部室内做，户外只拍空镜
详见：`02-录制Best-Practice.md` §2

### 3. 环境变量没生效
症状：skill 报「LOCAL_LLM_BASE_URL not set」
解决：永久写入 Windows 环境变量，重启 PowerShell
详见：`Windows安装/3-环境变量配置.txt`

---

## 如果你只有 1 小时调试

按这个顺序快过一遍：
1. 接电源、关后台、设最佳性能模式（5 分钟）
2. AMD Software 专用显存设 64GB + 重启（10 分钟）
3. LM Studio 加载 120B，GPU Offload 64（15 分钟，含模型首次加载）
4. PowerShell 设环境变量（5 分钟）
5. Claude Code 跑一次合同审查 demo（15 分钟）
6. 跑通后**拔网线再跑一次**（5 分钟）
7. 任务管理器开「始终在最前」（5 分钟）

跑通就开录。跑不通看 `Windows安装/4-Skill安装到Claude-Code.txt` 的常见问题。

---

## 联系/问题

录制现场遇到包里没覆盖的问题，记下来发给花叔（我），我远程看。
不要在录制时硬调试，**直接走兜底方案**（`03-演示Prompt速查.md` 兜底救命）保住进度。

祝录制顺利。