0 Fork 0

Files

T

Bill 77fd241b43 chore(dev): give dev builds their own userData and single-instance lock

A dev instance shared the installed build's userData directory and lock, so
starting it demanded killing the real app and it wrote test settings and
session snapshots into the live profile. Dev now uses OpenTerminal-dev and
tags its window title '(dev)'; both instances run side by side.

2026-09-15 01:02:10 +08:00

3.4 KiB

Raw Permalink Blame History

OpenTerminal 开发备忘

Electron + electron-vite + React 终端工具（本地终端 / SSH / SFTP）。

常用命令

开发：npm run dev（主进程改动不热重建，需重启）
dev 实例使用独立用户数据目录 %APPDATA%\OpenTerminal-dev 与独立单实例锁（src/main/index.ts 顶部 !app.isPackaged 分支），窗口标题带 (dev)：可与已安装的正式版同时运行，互不干扰，也不会把测试设置/会话写进真实配置
类型检查：npx tsc --noEmit -p tsconfig.web.json
打包：npm run dist，产物在 release/（msi + exe + latest.yml + blockmap）
- 国内网络需镜像：ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/ ELECTRON_BUILDER_BINARIES_MIRROR=https://npmmirror.com/mirrors/electron-builder-binaries/ npm run dist

仓库与远程

origin = Gitea https://git.codingplan.site/admin/OpenTerminal.git（主仓库 + 更新通道）
github = https://github.com/billowliu2/OpenTerminal.git（镜像 + 备用更新源）
⚠️ Gitea 的 upload-pack 有故障，git fetch origin 会报 bad pack header；查询远端状态用 API 或 git ls-remote。推送正常。
2026-09：远端 main 旧历史（M3–M8，至 v0.8.0 d3a628f）被 force-push 覆盖为当前历史，旧提交仍由 tag v0.6.0 / v0.7.0 / v0.8.0 保留。

凭据

.env（已 gitignore）：GIT_TOKEN（Gitea）、GH_TOKEN（GitHub）等。git 推送通过 credential helper 使用该令牌。

发布新版本

package.json 版本号 +1，写 RELEASE_NOTES.md（仓库根，已 gitignore）
npm run dist 构建
node scripts/release.cjs <版本号>，例如 node scripts/release.cjs 1.0.2
- 依次完成：Gitea release（含 msi/exe 资产）→ Gitea 更新通道（api/packages/admin/generic/openterminal-update/stable，更新 latest.yml/blockmap/exe/release-notes.md）→ GitHub release
- 可用 --skip-github / --skip-gitea 跳过某步
- 访问 GitHub API 不通时，设 HTTPS_PROXY=http://127.0.0.1:7897 再走代理
验证更新通道：curl https://git.codingplan.site/api/packages/admin/generic/openterminal-update/stable/latest.yml 应返回新版本号
git tag v<版本号> 并推送两个远程

更新机制

检查更新：先 Gitea 更新通道（强制直连，不走系统代理），失败回退 GitHub（走系统代理）。 electron-updater 用独立 session（partition electron-updater），代理模式在 useFeed 里按源切换
更新日志：Gitea 仓库是私有的（匿名 API 404），改为从更新通道的 release-notes.md 读取（直连 session openterminal-update-direct），再回退 Gitea/GitHub releases API
electron-updater 不支持 MSI 自动更新，自动更新只走 NSIS exe

主题机制

终端主题由 xterm 主题派生 UI 配色：src/renderer/src/theme/chrome.ts 的 applyChromeTheme 写入 --chrome-bg/-bg-deep/-border/-hover CSS 变量，antd token 在 main.tsx ThemedConfigProvider 派生
标签强调色：settings.tabAccentColor（默认 #3fb950），经 --tab-accent CSS 变量生效

终端尺寸同步

TerminalView.scheduleFit：fit 后去抖 100ms 再把 cols/rows 发给 PTY，并跳过与上次相同的尺寸。每次 ResizeObserver 都戳 PTY 会让全屏 TUI（Claude Code 等）在最大化/还原的中间尺寸上反复重绘，留下重复帧
拖动窗口期间 xterm 网格立即更新，PTY 尺寸在停止后 100ms 生效

3.4 KiB Raw Permalink Blame History Unescape Escape

OpenTerminal 开发备忘

常用命令

仓库与远程

凭据

发布新版本

更新机制

主题机制

终端尺寸同步

3.4 KiB

Raw Permalink Blame History