# 部署说明文档 (deploy-guide.md)

**维护人：工程师 A** | 最后更新：2026-04-07  
**适用版本：** 期权策略训练系统 V3.0

---

## 项目概述

本项目是**纯静态 HTML/CSS/JS 教育网站**，零后端依赖，零 API 依赖。  
可部署在任何支持静态文件托管的平台，也可以直接在本地浏览器打开（离线使用）。

**外部依赖（仅一项）：** Google Fonts CDN（Noto Sans SC + JetBrains Mono）  
- 离线使用时字体将降级为系统默认字体，不影响功能，仅影响视觉

---

## 文件结构（以 `options-strategy/` 为站点根目录）

```
options-strategy/
├── index.html            # P00 首页（工程师A）
├── path.html             # P01 学习路径总览（工程师E）
├── basics.html           # P02 期权基础知识（工程师C）
├── strategies.html       # P03 策略操作全手册（工程师B）
├── market.html           # P04 市场环境与策略选择（工程师B）
├── module-01.html        # P05 模块①（工程师C）
├── module-02.html        # P06 模块②（工程师C）
├── module-03.html        # P07 模块③（工程师C）
├── module-04.html        # P08 模块④（工程师C）
├── module-05.html        # P09 模块⑤（工程师C）
├── tickers.html          # P10 标的档案库（工程师D）
├── matrix.html           # P11 决策矩阵速查（工程师D）
├── dashboard.html        # P12 策略逻辑仪表盘（工程师E）
├── tools.html            # P13 常用工具指南（工程师D）
├── practice.html         # P14 实战案例练习（工程师E）
├── page-template.html    # 页面模板（开发用）
├── css/
│   ├── style.css         # 主样式表（工程师A）
│   └── components.css    # 通用组件库（工程师A）
├── js/
│   ├── nav.js            # 导航组件（工程师A）
│   ├── dashboard.js      # 仪表盘规则引擎（工程师E）
│   ├── practice.js       # 练习题逻辑（工程师E）
│   ├── tickers.js        # 标的筛选逻辑（工程师D）
│   └── strategies.js     # 策略筛选逻辑（工程师B）
├── anchor-map.md         # 锚点命名规范（开发用）
└── deploy-guide.md       # 本文件（开发用）
```

---

## 方式一：GitHub Pages（推荐，免费）

1. 把 `options-strategy/` 作为站点根目录提交到仓库（保持目录结构不变）。
2. 在 GitHub 仓库中进入 Settings → Pages
3. Source 选择：`Deploy from a branch`
4. Branch 选择：`main` / `/ (root)`（如果你把站点放在仓库根目录）  
   - 如果你的仓库根目录不是站点根目录，而站点在子目录 `options-strategy/`，则建议：
     - 建一个单独的发布仓库只放站点文件；或
     - 使用 GitHub Actions 把 `options-strategy/` 发布到 `gh-pages`（进阶做法）

---

## 方式二：Netlify（推荐，操作简单）

### 拖拽上传（最快）

1. 登录 Netlify
2. 选择「Deploy manually」
3. **把 `options-strategy/` 目录内的站点文件整体拖拽上传**（确保包含 `css/`、`js/` 与 `index.html`）

---

## 方式三：本地离线运行（推荐用于验收）

直接双击打开 `index.html` 通常也能用，但部分浏览器对 `file://` 会有更多限制。建议启动本地 HTTP 服务：

```bash
cd options-strategy
python -m http.server 8080
```

浏览器访问：`http://localhost:8080`

---

## 性能/上线前检查清单（V3.0）

- 首屏加载时间：≤ 3 秒（正常网速）
- 资源类型：**禁止位图图片**（图表/流程图用 SVG 或 CSS）
- CSS/JS：尽量单文件小于 100KB（需要时做 minify）
- 三断点：桌面（≥1200）/ 平板（768~1199）/ 手机（<768）显示正常
- 导航：所有页面跳转正常，锚点跳转不被导航遮挡（已在 `css/style.css` 设置 `scroll-margin-top`）
- 移动端：汉堡菜单可开关，点击遮罩/关闭按钮/Esc 均可关闭

---

*部署说明最后更新：2026-04-07 | V3.0*