Bill
5602949a4f
- 全站深色（#0b0e12 + 终端绿），右上角可切浅色；两套主题共用 CSS 令牌 - 自托管字体：Space Grotesk（展示）+ JetBrains Mono（等宽），不再依赖系统栈 - 「核心能力」改为横向滚动卡片轨道（箭头翻页 / 拖拽 / 键盘方向键） - 新增 SFTP 文件面板截图（含空白处右键菜单），IP 已打码 - 补 og:image / theme-color / skip-link / 焦点环 / 导航当前位置高亮
75 lines
3.5 KiB
Markdown
75 lines
3.5 KiB
Markdown
# 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/`
|
||
- 中文为主要语言；文案保持具体、平实，避免营销套话
|