# password-manager-kotlin

**Repository Path**: gomes/password-manager-kotlin

## Basic Information

- **Project Name**: password-manager-kotlin
- **Description**: No description available
- **Primary Language**: Kotlin
- **License**: MPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Caddy - 密码管理器

一个使用 Kotlin Compose Multiplatform 构建的现代化桌面密码管理器。

![Kotlin](https://img.shields.io/badge/Kotlin-2.3.10-purple)
![Compose](https://img.shields.io/badge/Compose%20Multiplatform-1.10.0-blue)
![Platform](https://img.shields.io/badge/Platform-macOS-lightgrey)
![License](https://img.shields.io/badge/License-MIT-green)

## 功能特性

- 账号管理 - 添加、编辑、删除账号信息
- 快速搜索 - 支持网站名、用户名、邮箱模糊搜索
- 密码复制 - 一键复制密码到剪贴板
- 分页显示 - 每页 10 条记录，支持页码跳转
- 本地存储 - 数据保存在本地，安全可靠
- 现代界面 - 基于 Material Design 3 设计

## 技术栈

| 技术 | 版本 |
|------|------|
| Kotlin | 2.3.10 |
| Compose Multiplatform | 1.10.0 |
| Material 3 | - |
| JDK | 21 |
| Gradle | 9.2.1 |

## 项目结构

```
password-manager-kotlin/
├── build.gradle.kts          # 构建配置
├── settings.gradle.kts       # 项目设置
├── icon.icns                 # 应用图标
├── run.sh                    # 运行脚本
├── 技术博客.md               # 技术文档
└── src/main/kotlin/passwordmanager/
    ├── Account.kt            # 数据模型
    ├── AccountRepository.kt  # 数据存储层
    ├── Main.kt               # 应用入口
    ├── MainScreen.kt         # 主界面
    └── AccountDialog.kt      # 对话框组件
```

## 快速开始

### 环境要求

- JDK 21+
- Gradle 9.2.1+

### 运行项目

```bash
# 克隆项目
git clone https://gitee.com/gomes/password-manager-kotlin.git

# 进入目录
cd password-manager-kotlin

# 运行脚本
./run.sh

# 或使用 Gradle
gradle run
```

### 打包应用

```bash
# 构建 JAR
gradle build

# 打包 macOS 应用
gradle packageDmg
gradle packagePkg
```

## 使用说明

### 添加账号

1. 点击「添加账号」按钮
2. 填写网站、用户名、密码（必填）
3. 填写邮箱、备注（可选）
4. 点击保存

### 编辑账号

1. 在列表中选择要编辑的账号
2. 点击「编辑」按钮或双击列表项
3. 修改信息后保存

### 删除账号

1. 选择要删除的账号
2. 点击「删除」按钮
3. 确认删除

### 搜索账号

在搜索框输入关键词，支持搜索：
- 网站名称
- 用户名
- 邮箱

## 数据存储

账号数据保存在本地文件：
```
~/.password-manager/accounts.properties
```

## 界面预览

| 主界面 | 对话框 |
|--------|--------|
| 账号列表、搜索、分页 | 添加/编辑账号表单 |

## 开发计划

- [ ] 密码加密存储
- [ ] 密码生成器
- [ ] 分类管理
- [ ] 导入/导出功能
- [ ] Android/iOS 客户端
- [ ] 云同步支持


## 许可证

MIT License

## 作者

gomes

## 链接

- [Gitee 仓库](https://gitee.com/gomes/password-manager-kotlin)
- [Compose Multiplatform](https://www.jetbrains.com/lp/compose-multiplatform/)
- [Kotlin 官网](https://kotlinlang.org/)