# code-assistant

**Repository Path**: kbtit/code-assistant

## Basic Information

- **Project Name**: code-assistant
- **Description**: 代码协作助手，让代码更好的融入AI
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-09-26
- **Last Updated**: 2026-01-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 代码协作助手 (Code Assistant)
[后端地址](https://github.com/lvfushun168/code-assistant-backend)

一款专为开发者设计的现代化、轻量级桌面应用，使用 Java Swing 构建。它不仅是一个高效、简洁的代码阅读和编辑环境，还集成了用户账户、云端同步和多种实用的开发工具。

## ✨ 主要功能

- **☁️ 云端同步与账户系统**:
  - 支持用户注册和登录，实现跨设备的数据访问。
  - 安全连接到后端服务器，可实现文件和设置的云端同步。

- **🗂️ 文件浏览器**:
  - 树状视图展示文件和文件夹。
  - 支持前进、后退、向上一级等快速导航。
  - 右键菜单提供丰富的文件操作：新建、重命名、删除、复制、粘贴。
  - 自动记忆上次访问的目录。

- **📝 多标签页编辑器**:
  - 支持同时打开和编辑多个文件。
  - 每个标签页都可以独立关闭。
  - 自动检测并使用特定编辑器打开不同类型或大小的文件。

- **⚡ 高性能大文件查看器**:
  - 内置为查看超大文件优化的虚拟滚动模式，可以秒开GB级别的文件。
  - 加载过程带有进度条，避免UI卡顿。

- **✍️ 核心编辑功能**:
  - 显示行号，方便代码定位。
  - 支持撤销/重做 (Undo/Redo)。
  - 内置查找与替换对话框 (Find/Replace)。
  - 支持只读模式打开文件。

- **🚀 项目辅助工具**:
  - **获取代码内容**: 遍历整个项目目录，将所有（可配置的）源码文件内容合并到一个视图中，便于整体分析或提交给AI模型。
  - **获取项目结构**: 一键生成项目的目录树结构文本。
  - **JSON/Java 互转**: 
    - **Java对象转JSON**: 将Java类中的字段声明转换为JSON格式的文本。
    - **JSON转Java对象**: 将JSON文本转换为Java类的字段声明，支持嵌套对象和数组。
  - **DDL转Java对象**: 将数据库DDL语句转换为Java实体类声明。

- **🔒 安全与加密**:
  - 内置加密服务 (`CryptoService`)，用于保护本地和传输中的敏感数据。
  - 利用系统密钥库 (`SystemKeyStoreService`) 安全地管理用户凭据。

- **🎨 现代化UI**:
  - 基于 [FlatLaf](https://www.formdev.com/flatlaf/) 库，提供干净、现代的跨平台外观。
  - 自动保存窗口最后的位置和大小。

## 🛠️ 技术栈

- **核心框架**: Java 11
- **用户界面**: Java Swing, FlatLaf
- **网络通信**: 内置 HTTP 客户端，用于与后端 API 通信
- **项目构建**: Apache Maven
- **打包**: jpackage-maven-plugin (用于生成macOS .app应用)

## 🚀 如何构建和运行

本项目使用 Maven进行构建。

1.  **克隆仓库**
    ```bash
    git clone <your-repository-url>
    cd code-assistant
    ```

2.  **使用Maven打包**
    在项目根目录下运行以下命令，将项目打包为可执行的 `jar` 文件和特定平台的应用程序（例如 macOS 的 `.app`）。
    ```bash
    mvn clean package
    ```

3.  **运行程序**
    - **通过 JAR 文件运行**:
      打包成功后，在 `target` 目录下会生成一个 `code-assistant-*.jar` 文件。通过以下命令运行：
      ```bash
      java -jar target/code-assistant-*.jar
      ```
    - **运行原生应用 (macOS)**:
      打包后，在 `dist` 目录下会生成 `代码协作助手.app`。直接双击运行即可。

**注意**: 构建原生应用需要 JDK 14 或更高版本。

## 🗺️ 路线图 (待实现功能)

- [ ] **语法高亮**: 为主流编程语言（如 Java, Python, JavaScript, SQL 等）提供代码语法高亮。
- [ ] **扩大选择**: 支持快捷建扩大选择范围，类似于 VSCode 中的 `Shift + Alt + Right`。
- [ ] **列编辑**: 支持快捷键列编辑。
- [ ] **代码自动补全**: 基于当前文件内容和语言特性提供简单的代码提示。
- [ ] **Git 集成**: 在文件浏览器中以不同颜色标识出文件的 Git 状态 (新增, 修改, 未跟踪)。
- [ ] **主题支持**: 提供浅色 (Light) 和深色 (Dark) 两种UI主题，并支持切换。
- [ ] **Markdown实时预览**: 实现一个分屏编辑器，左侧编写Markdown，右侧实时预览渲染效果。
- [ ] **插件系统**: 设计一个简单的插件架构，允许社区扩展更多功能。