# dotfiles-compose

**Repository Path**: zjarlin/dotfiles-compose

## Basic Information

- **Project Name**: dotfiles-compose
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2025-11-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Dotfiles Compose - 跨平台个人知识库管理器

一个现代化的跨平台dotfiles管理工具，不仅限于配置文件，还包括笔记、软件包列表等广义知识库的一键切换和同步解决方案。类似于[chezmoi](https://www.chezmoi.io/)，但提供图形化界面和更丰富的功能。

## 功能特性

- 🖥️ **跨平台支持**：完美支持Windows、macOS和Linux系统
- 📁 **多种配置类型管理**：
  - Shell配置（.bashrc, .zshrc等）
  - 环境变量文件
  - 编辑器配置（.vimrc等）
  - Git配置
  - SSH配置
  - XDG配置目录（nvim, alacritty等）
  - 自定义配置文件
- 📦 **包管理器集成**：
  - macOS: Homebrew支持
  - Windows: Chocolatey和Winget支持
  - Linux: Apt支持
- 🔄 **版本控制集成**：通过Git自动同步您的配置到云端
- 🎨 **现代化UI界面**：基于Compose Multiplatform构建的美观图形界面
- 🚀 **一键部署**：快速在新设备上恢复您的完整开发环境

## 应用界面

应用包含四个主要功能模块：

1. **配置文件管理**：查看和管理各种类型的dotfiles
2. **软件包管理**：安装、更新和管理软件包
3. **系统工具**：常用系统操作工具
4. **初始化任务**：自动化环境配置任务

## 快速开始

### 构建和运行桌面应用程序

使用IDE的运行配置或直接从终端运行：

#### macOS/Linux
```shell
./gradlew :composeApp:run
```

#### Windows
```shell
.\gradlew.bat :composeApp:run
```

### 构建独立可执行文件

#### macOS/Linux
```shell
./gradlew :composeApp:package
```

#### Windows
```shell
.\gradlew.bat :composeApp:package
```

构建产物将位于 `composeApp/build/compose/binaries/main-release/app` 目录下。

## 使用指南

1. 首次运行时，程序会引导您完成基本配置
2. 设置Git仓库URL以启用云端同步
3. 在不同设备间通过Git同步您的完整开发环境
4. 使用软件包管理功能一键安装常用软件

## 开发计划

请参阅 [FEATURE_PLAN.md](FEATURE_PLAN.md) 了解详细的功能开发路线图和未来规划。

## 技术栈

- [Kotlin Multiplatform](https://kotlinlang.org/docs/multiplatform.html)
- [Compose Multiplatform](https://www.jetbrains.com/lp/compose-mpp/)
- [Koin](https://insert-koin.io/) 依赖注入
- Git版本控制
- 平台原生API调用

---

*该项目受到[chezmoi](https://www.chezmoi.io/)启发，旨在提供更直观易用的跨平台dotfiles管理解决方案*