# OpenTerminal 官网

OpenTerminal 的产品介绍站点，部署在 GitHub Pages。
纯静态 HTML + CSS，**无构建步骤、无第三方依赖**，改完即可发布。

## 线上地址

- GitHub Pages: `https://billowliu2.github.io/OpenTerminal/`

## 目录结构

```
website/
├── index.html          # 单页站点：功能介绍 / 下载 / 更新日志
├── .nojekyll           # 让 GitHub Pages 原样托管（跳过 Jekyll 处理）
└── assets/
    ├── style.css       # 全部样式（深色默认 / 浅色可切换，主题令牌在 :root 与 html[data-theme='light']）
    ├── fonts/          # 自托管 woff2：Space Grotesk 400/500/600/700、JetBrains Mono 400/500/600
    ├── shot-terminal.jpg   # 主界面截图（三路分屏并行 AI 编程 Agent，含背景图个性化）
    ├── shot-agents.png     # 多路 AI Agent 分屏截图（无背景图版）
    ├── shot-sftp.png       # SFTP 文件面板：列头、排序、用户/组、字体缩放
    ├── shot-sftp-menu.png  # 文件列表空白处右键菜单
    ├── shot-themes.jpg     # 主题设置页截图（背景图/不透明度/压暗层）
    ├── shot-lock.png       # 锁屏界面截图
    └── icon.png            # 应用图标（来自仓库 build/icon.png）
```

## 发新版本时需要更新的地方

`index.html` 中搜索当前版本号，共 2 处下载链接（hero 主按钮、下载表格 exe）。
自 v1.0.22 起不再提供 MSI，只有 NSIS exe 一条直链：

```
https://github.com/billowliu2/OpenTerminal/releases/download/v<版本>/OpenTerminal-<版本>-setup.exe
```

注意：发布新版本时需同时把安装包资产上传到 GitHub release
（`HTTPS_PROXY=http://127.0.0.1:7897 node scripts/release.cjs <版本> --skip-gitea`），
否则直链 404。

同时更新「近期更新」小节（与 RELEASE_NOTES.md 内容保持一致）和下载表格里的文件大小。

## 部署方式

GitHub Actions 工作流 `.github/workflows/deploy-website.yml`：
push 到 `main` 且 `website/` 下有改动时，自动把 `website/` 目录发布到 GitHub Pages。
Gitea（git.codingplan.site）只同步代码，Pages 由 GitHub 侧托管。

首次部署需要在 GitHub 仓库设置里确认：Settings → Pages → Source 选择
"GitHub Actions"（工作流已声明 `pages: write` 与 `id-token: write` 权限）。

## 本地预览

无构建步骤，任选其一：

```bash
# Python
python -m http.server 8080 --directory website

# Node
npx serve website
```

然后访问 `http://localhost:8080`。直接双击 `index.html` 也可以（无跨域资源）。

## 设计约定

- **深色为主**：默认深色（`#0b0e12` 底 + 终端绿强调色），右上角按钮可切浅色；两套主题共用同一份令牌，新增样式一律走 CSS 变量，不要写死颜色
- 主题选择存 `localStorage['openterminal.theme']`，首帧前由 `index.html` 头部的内联脚本定好，避免闪白/闪黑
- 全站只用**一个强调色**：深底 `#3fb950`、浅底 `#1a7f37`（对比度 ≥ 4.5:1）
- 字体自托管（`assets/fonts/`），不依赖 Google Fonts：展示字体 Space Grotesk、等宽 JetBrains Mono；中文回落到系统栈
- 「核心能力」是横向滚动卡片轨道（箭头翻页 + 拖拽 + 键盘方向键），不再用三栏等高卡片
- 截图来自真实运行界面，与应用内设置一致；涉及 IP / 主机名等敏感信息的截图必须打码后再放入 `assets/`
- 中文为主要语言；文案保持具体、平实，避免营销套话