# TermBuds

**Repository Path**: FullStackDamon/TermBuds

## Basic Information

- **Project Name**: TermBuds
- **Description**: 更新一个 terminal 终端工具，跨平台使用。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-06-20
- **Last Updated**: 2026-11-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TermBuds

TermBuds 是面向 Windows、Android 和 HarmonyOS 的跨平台终端软件。三端使用同一份 Web 界面；Windows 由 Electron 承载，Android 由 WebView 承载，HarmonyOS 由 ArkWeb 承载。界面采用顶部主机/会话/SFTP 标签布局，侧栏可折叠；宽窗口显示本地与远端双栏 SFTP，窄窗口显示远端单栏并使用系统文件选择器传输。侧栏可选择浅色或深色主题，均以 `#0D597F` 为主色。系统能力由各端外壳提供。

当前 **0.1.0 预览版**提供三端构建产物与同一套响应式界面。Windows 支持 SSH 密码/私钥连接、主机指纹确认、多标签、ConPTY 本地 PowerShell/cmd/WSL 和 SFTP 文件浏览、上传、下载。Android 已接入 SSH 密码/私钥连接、指纹确认、终端尺寸调整和 SFTP；模拟器上已验证密码连接、指纹变化、终端字节往返、目录列表和下载，真机及私钥认证仍待验收。HarmonyOS 已接入 libssh2/NAPI 密码 SSH、指纹确认、终端收发、尺寸调整及 SFTP 浏览/上传/下载/取消，原生与 ArkTS 编译通过，但没有设备进行运行验证；私钥认证尚未接入。端口转发、跳板机、同步等高级能力仍未实现。调研文档区分 Termius 安装包的静态观察、公开实现与 TermBuds 自己的设计。

## 开发与构建

需要 Node.js 24+。Windows 开发环境运行：

```powershell
npm install
npm start
npm test
npm run smoke
```

`npm run sync:ui` 将 `packages/ui/src/` 的页面同步到三个外壳，`npm run check:ui` 检查副本一致。构建命令为 `npm run dist:win`、`npm run build:android`、`npm run build:harmony`，或 `npm run build:all`。Android 需要 Android Studio JBR/SDK，HarmonyOS 需要 DevEco Studio；脚本允许通过环境变量覆盖默认安装位置。Windows 安装包与便携版在 `release/Windows/`，Android 调试 APK 在 `release/Android/`，HarmonyOS 未签名 HAP 在 `release/HarmonyOS/`。HAP 需要开发者签名和目标设备验证后才能作为可安装交付版使用。

`release/` 只保留上述三个系统目录及当前版本的四个交付文件。Windows 打包中间文件写到忽略的 `build/windows-packaging/`，不会进入 `release/`；截图、日志和校验记录也不得写入 `release/`。运行 `npm run check:release` 可检查目录规则。具体约束见 [AGENTS.md](AGENTS.md)。

如果 Electron 官方下载在当前网络超时，可在安装前设置 `$env:ELECTRON_MIRROR='https://npmmirror.com/mirrors/electron/'`，然后重新运行 `npm install`。

主机资料保存在各端应用私有目录。密码只在连接时输入，不写入主机列表；Windows 私钥保留在用户选择的原文件路径，Android 通过系统文件选择器读取私钥。首次 SSH 连接必须核对并确认服务器 SHA-256 指纹。SFTP 上传默认拒绝覆盖远端已有文件，下载由系统保存对话框选择本地位置。

## 文档

- [Termius 与开源项目调研](docs/research.md)
- [跨平台架构与界面设计](docs/architecture.md)
- [实施阶段与验收标准](docs/implementation-plan.md)
- [构建与验证记录](docs/validation.md)
- [HarmonyOS 原生依赖与许可证](docs/third-party.md)

## 分支约定

`master` 是初始化基线；后续修改和提交在 `dev` 分支完成。不手工合并分支。远程仓库为 `allarge` 和 `gitee`。