# onetcli

**Repository Path**: LucasDot/onetcli

## Basic Information

- **Project Name**: onetcli
- **Description**: No description available
- **Primary Language**: Rust
- **License**: Apache-2.0
- **Default Branch**: dev
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-22
- **Last Updated**: 2026-04-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

<p align="center">
  <img src="logo.svg" alt="OnetCli" width="120" />
</p>

<h1 align="center">OnetCli</h1>

<p align="center">
  <strong>O</strong>ne <strong>Net</strong> <strong>Cl</strong>ient — 跨平台桌面客户端，数据库、SSH、终端与 AI 一站式管理。
</p>

<p align="center">
  基于 <a href="https://gpui.rs">GPUI</a> 构建 · GPU 加速渲染 · 原生性能
</p>

<p align="center">
  <a href="README.md">English</a> ·
  <a href="#安装">安装</a> ·
  <a href="https://github.com/feigeCode/onetcli/releases">发布</a> ·
  <a href="#功能特性">功能特性</a> ·
  <a href="#应用截图">截图</a> ·
  <a href="#支持作者">支持作者</a> ·
  <a href="CONTRIBUTING.md">参与贡献</a>
</p>

---

<!-- 替换为实际截图 -->
<p align="center">
  <img src="app.png" alt="OnetCli 概览" width="800" />
</p>

## 支持作者

支持作者 [SPONSOR.md](SPONSOR.md)。


## 功能特性

**多数据库管理** — 在同一界面连接 PostgreSQL、MySQL、SQLite、SQL Server、Oracle、ClickHouse 和 DuckDB。

**Redis** — 专用 Redis 视图，支持键浏览、值查看与集群连接。

**MongoDB** — MongoDB 浏览器，支持集合浏览、文档查看与查询。

**SSH、SFTP 与串口** — 在同一工作区集成 SSH 终端、SFTP 文件管理器与串口连接能力。

**本地终端** — 内置终端，支持多标签页工作流。

**AI 助手** — 应用内直接与 AI 对话，支持自然语言生成 SQL、查询解释、BI 数据分析与图表生成，基于流式 LLM 集成。

**云端同步** — 跨设备同步连接和设置，密钥加密存储（AES-GCM、Ed25519）。

**主题与国际化** — 亮色 / 暗色模式切换，支持 English、简体中文、繁体中文。

## 应用截图

| 数据库 | SSH |
|:-:|:-:|
| ![数据库](database.png) | ![SSH](ssh.png) |

| SFTP | Redis |
|:-:|:-:|
| ![SFTP](sftp.png) | ![Redis](redis.png) |

| MongoDB | AI 对话 |
|:-:|:-:|
| ![MongoDB](mongodb.png) | ![AI 对话](chatdb.png) |

**自带简易服务器监控，原生渲染的图表** 
![monitor.png](monitor.png)

**终端自带SFTP侧边栏，支持文件拖拽上传**
![sftp_sidebar.png](sftp_sidebar.png)

**直接在应用程序中编辑文件，具备语法高亮显示和自动完成功能。**
![remote_file_editor](remote_file_editor.png)

## 平台支持

| 平台 | 架构 | 渲染后端 |
|------|------|---------|
| macOS | aarch64, x86_64 | Metal |
| Linux | x86_64 | Vulkan |
| Windows | x86_64 | — |

### 前置条件

- Rust（2024 edition）
- 各平台系统依赖（见下方说明）

### 系统依赖

**macOS / Linux：**

```bash
./script/bootstrap
```

**Windows（PowerShell）：**

```powershell
.\script\install-window.ps1
```

### 构建与运行

```bash
cargo run -p main
```

### macOS 常见问题

如果 macOS 安装 DMG 后提示无法打开（"Apple 无法检查其是否包含恶意软件"），请执行：

```bash
sudo xattr -rd com.apple.quarantine /Applications/OnetCli.app
```

### Oracle 支持

使用 Oracle 连接需要先安装 [Oracle Instant Client](https://www.oracle.com/database/technologies/instant-client/downloads.html)（Basic 包）。请下载与你平台对应的版本，并确保库文件在系统的库搜索路径中。

## 开发

```bash
# 构建
cargo build

# 测试
cargo test --all

# Lint
cargo clippy -- --deny warnings

# 格式检查
cargo fmt --check
```

详细开发指南请参阅 [CONTRIBUTING.md](CONTRIBUTING.md)。

## 技术栈

| 类别 | 技术 |
|------|------|
| UI 框架 | [GPUI](https://gpui.rs)（来自 Zed 编辑器） |
| 数据库驱动 | tokio-postgres, mysql_async, rusqlite, tiberius, oracle, clickhouse, redis, mongodb |
| SSH/SFTP | russh, russh-sftp |
| 终端仿真 | alacritty_terminal |
| 文本编辑 | ropey, tree-sitter, sqlparser |
| AI | llm-connector（流式输出） |
| 加密 | aes-gcm, sha2, ed25519 |
| 国际化 | rust-i18n |

## 许可证

本项目基于 [Apache License 2.0](LICENSE-APACHE) 开源。

OnetCli 应用的分发与使用须同时遵守 [OnetCli 补充协议](ONETCLI_LICENSE)，该补充协议在 Apache 2.0 基础上增加了以下限制：

- 禁止二次分发、转售或将本软件作为独立产品再分发
- 禁止基于本软件代码创建竞争性产品或服务
- 禁止将本软件托管于未经授权的分发平台

如有许可证与版权相关问题，请联系 xiaofei.hf@gmail.com。