# Luckylin

**Repository Path**: fensl/luckylin

## Basic Information

- **Project Name**: Luckylin
- **Description**: 一个桌面ai助手
- **Primary Language**: C++
- **License**: GPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-06-04
- **Last Updated**: 2025-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Luckylin 智能桌面助手

Luckylin 是一个基于 PySide6 (Python Qt绑定) 的智能桌面助手应用程序，旨在提高用户的工作效率。

## 功能特性

- 现代化的图形用户界面
- 多语言支持
- 跨平台兼容性（Windows、Linux、macOS）
- Python生态优势（易于扩展、丰富的第三方库支持）

- 现代化的图形用户界面
- 多语言支持
- 跨平台兼容性（Windows、Linux、macOS）

## 环境要求

- Python 3.8+
- [uv](https://github.com/astral-sh/uv) (现代Python包管理工具，比pip更快更可靠)
  - 安装方法: `curl -LsSf https://astral.sh/uv/install.sh | sh`
- PyQt5 (注意：在Linux系统上，建议使用系统提供的PyQt5以确保输入法支持)
- (其他Python依赖项，如有)

## 安装与运行

## 中文输入法支持说明

在Linux系统（特别是openKylin等国产操作系统）上，为了确保应用程序能够正确支持中文输入法，需要采取以下措施：

### 问题背景
默认通过pip或uv安装的PyQt5可能不包含对系统输入法框架的完整支持，特别是在使用fcitx等输入法时。

### 解决方案
1. 安装系统提供的PyQt5包：
   ```bash
   sudo apt install python3-pyqt5 python3-pyqt5.qtwebengine
   ```
   系统提供的PyQt5包经过特殊编译，能够更好地与系统输入法框架集成。

2. 在代码中优先使用系统PyQt5包：
   在main.py文件中添加以下代码确保优先加载系统PyQt5：
   ```python
   import sys
   # 优先使用系统提供的PyQt5包，以支持中文输入法
   sys.path.insert(0, '/usr/lib/python3/dist-packages')
   ```

3. 运行时设置PYTHONPATH环境变量：
   ```bash
   PYTHONPATH=/usr/lib/python3/dist-packages:$PYTHONPATH python main.py
   ```

通过以上步骤，应用程序就能在保持虚拟环境整洁的同时，正确使用系统PyQt5库以支持中文输入法。

1. 创建并激活虚拟环境（推荐）：
```bash
python -m venv venv
source venv/bin/activate  # Linux/macOS
venv\Scripts\activate     # Windows
```

2. 安装依赖：
```bash
uv pip install PySide6
```

3. 在Linux系统上确保中文输入法支持：
```bash
# 安装系统提供的PyQt5以确保输入法兼容性
sudo apt install python3-pyqt5 python3-pyqt5.qtwebengine

# 运行时确保使用系统PyQt5包
PYTHONPATH=/usr/lib/python3/dist-packages:$PYTHONPATH python main.py
```

4. 运行应用：
```bash
python main.py
```

## 项目结构

```
luckylin/
├── main.py          # 主程序入口
├── requirements.txt # 依赖列表
├── src/             # 模块源代码
├── tests/           # 测试代码
└── resources/       # 资源文件
```

## 许可证

本项目采用 MIT 许可证。详情请参见 [LICENSE](LICENSE) 文件。

## 贡献指南

欢迎提交问题报告和合并请求。对于重大更改，请先开issue讨论您想要更改的内容。

## 联系方式

如有任何问题或建议，请通过以下方式联系我们：

- 提交 GitHub Issue
- 发送电子邮件至：[fslong@tju.edu.cn]

## 致谢

1. 感谢【猫粮】为本项目提供的素材
2. 感谢所有为这个项目做出贡献的开发者。