# LiSteward

**Repository Path**: laolishu/LiSteward

## Basic Information

- **Project Name**: LiSteward
- **Description**: Development environment configuration tool
- **Primary Language**: Go
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-28
- **Last Updated**: 2025-12-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

**[English](README.md) | [中文](README_CN.md)**

---

LiSteward — 开发环境配置切换工具
================================

概述
----
LiSteward 是一款轻量级的开发环境配置切换工具，提供可视化的 `hosts` 管理和 NVM（Node 版本）配置管理。它通过集中管理多个环境的配置来简化开发工作流。未来计划接入 AI 功能以提供智能建议与自动化操作。

核心特性
----------

### Hosts 配置管理
LiSteward 为管理系统 hosts 文件提供了全面的解决方案：

- **可视化编辑器** - 使用清晰易用的界面编辑 hosts 条目，无需手动修改文本文件
- **配置方案管理** - 为不同环境创建和管理多套 hosts 配置，一键快速切换
- **备份与恢复** - 自动备份保护配置安全，可随时恢复到任何历史版本
- **导入导出** - 跨机器共享配置，或将配置纳入版本控制
- **条目启用/禁用** - 快速启用或禁用单个条目，无需删除
- **搜索和过滤** - 在大量 hosts 条目中快速定位所需内容

#### 使用场景
- 前端开发：管理本地域名映射和测试环境配置
- 多环境管理：为开发、测试、生产环境维护不同的 hosts 配置
- 网络管理：快速切换不同的网络设置和防火墙规则

### Node 版本管理 (NVM)
轻松管理系统上的多个 Node.js 版本：

- **版本检测和显示** - 自动检测已安装的版本，清晰显示当前激活版本
- **快速版本切换** - 一键切换到任意已安装的 Node.js 版本，立即生效
- **交互式安装指引** - 快速查看可用 Node.js 版本并启动安装流程
- **环境管理** - 支持传统 nvm（Unix/Linux/macOS）和 nvm-windows 环境
- **跨平台支持** - 在 Windows、macOS 和 Linux 系统上无缝工作

#### 使用场景
- 多项目开发：不同项目可能要求不同的 Node.js 版本
- 兼容性测试：快速在不同 Node.js 版本上测试代码表现
- 版本升级管理：平稳地从旧版本迁移到新版本

快速开始
----------

### 系统要求
- **Go**: 1.23 或更高版本
- **Node.js**: 16 或更高版本（用于前端开发）
- **Wails CLI**: 编译原生应用所需（运行 `go install github.com/wailsapp/wails/v2/cmd/wails@latest` 安装）

### 安装

从 [Releases](../../releases) 页面下载最新版本，或从源代码编译（参见下方说明）。

### 首次运行

1. 启动应用
2. 主界面展示两个核心模块：
   - **Hosts 管理器**：左侧侧栏显示配置方案，主区域允许编辑 hosts 条目
   - **Node 管理器**：在已安装的 Node.js 版本间切换，访问版本管理工具
3. 浏览两个模块以了解可用的功能

构建与运行（开发）
----------
启动前端开发服务器并运行 Go 后端以便快速迭代：

**终端 A**（前端开发服务器）：
```bash
cd frontend
npm install
npm run dev
```

**终端 B**（后端）：
```bash
cd ..
go run .
```

然后在浏览器中打开 http://localhost:34115（应该会自动打开）。

构建（发布）
----------
生成前端生产资源并使用 `wails` 打包原生应用：

**前置条件**：
- "快速开始"部分中的所有要求
- 全局安装 `wails` CLI

**构建步骤**：
```bash
cd frontend
npm install
npm run build

# 在仓库根目录执行
wails build
```

编译后的应用位于 `build/bin/` 目录（根据平台区分）。

**仅构建后端二进制文件**（不打包为原生应用）：
```bash
go build -o LiSteward
```

许可证
------
本项目采用 GNU 通用公共许可证 v3.0（GPL-3.0）。详见 `LICENSE` 文件。

赞赏
----
如果本项目对你有帮助，欢迎用小额赞助支持我们：

![赞赏](/res/wechat-qr.png)

参与贡献
--------
欢迎通过 GitHub Issue 和 Pull Request 参与贡献。请保持改动聚焦，并附带必要的测试或验证步骤。