# kui

**Repository Path**: Youik/kui

## Basic Information

- **Project Name**: kui
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Artistic-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-14
- **Last Updated**: 2026-05-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# KUI - Kubernetes UI

一个基于 GPUI 构建的现代化 Kubernetes 管理界面。

## 功能特性

- **多集群管理** - 支持 kubeconfig 中的多个 context，也支持手动添加集群
- **资源浏览** - 查看 Pods、Deployments、Services、ConfigMaps、Secrets 等资源
- **详情面板** - YAML 查看、日志查看、事件追踪
- **资源操作** - Deployment 扩缩容、重启、删除资源
- **国际化** - 支持中文/英文切换
- **主题切换** - 深色/浅色主题
- **自定义标题栏** - 原生窗口拖拽体验

## 技术栈

| 组件 | 技术 |
|------|------|
| UI 框架 | [GPUI](https://github.com/zed-industries/zed) (Zed 的 GPU 加速 UI 框架) |
| K8s 客户端 | [kube-rs](https://github.com/kube-rs/kube) |
| 异步运行时 | Tokio |
| 序列化 | serde, serde_json, serde_yaml |

## 项目结构

```
src/
  main.rs              # 入口：TokioRuntime 初始化、窗口创建
  app.rs               # 应用核心：KuiApp 结构体 + 业务逻辑
  views/
    titlebar.rs        # 标题栏
    sidebar.rs         # 侧边栏导航
    header.rs          # 内容区头部
    overview.rs        # 概述页
    table.rs           # 资源表格
    detail.rs          # 详情面板
    dialog.rs          # 添加集群对话框
    dropdown.rs        # 下拉菜单
    footer.rs          # 底部状态栏
    misc.rs            # 辅助组件
  k8s/                 # K8s 客户端 API
  state/               # 应用状态
  i18n.rs              # 国际化
  theme.rs             # 主题
  settings.rs          # 设置
```

## 安装与运行

### 前置要求

- Rust 1.75+
- 可访问的 Kubernetes 集群（通过 kubeconfig）

### 运行

```bash
# 克隆仓库
git clone https://gitee.com/Youik/kui.git
cd kui

# 运行
cargo run

# 或构建发布版本
cargo build --release
```

## 使用说明

1. **连接集群** - 启动后点击右上角"连接"按钮，或从下拉菜单选择集群
2. **添加集群** - 点击"添加集群"按钮，支持三种认证方式：
   - Bearer Token
   - Basic Auth
   - Kubeconfig 文件
3. **浏览资源** - 左侧导航栏选择资源类型
4. **查看详情** - 点击资源行查看 YAML、日志、事件
5. **操作资源** - 在详情面板中执行扩缩容、重启、删除等操作

## 截图

> 待添加

## 开发

```bash
# 检查代码
cargo check

# 运行测试
cargo test

# 格式化
cargo fmt
```

## License

MIT