# cc-window

**Repository Path**: xiaoyybb/cc-window

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-09
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# CC-Window

CC-Window 是一个基于 Tauri 构建的现代化桌面应用，为 Claude AI 提供优雅的命令行交互界面。项目融合了 Soft UI Evolution 和 Glassmorphism 设计风格，支持亮色/暗色主题，并具备完善的会话管理和工作区功能。

## 功能特性

- **现代化 UI 设计**: 采用 Soft UI Evolution 主风格 + Glassmorphism 辅助风格，提供流畅的视觉体验
- **双主题支持**: 内置亮色和暗色主题，自动适配系统设置
- **会话管理**: 支持会话历史记录、跨会话继续对话、对话恢复
- **工作区支持**: 多工作区管理，可选择不同目录进行 AI 交互
- **命令面板**: 内置命令系统，提供命令提示和快捷操作
- **流式响应**: 支持 Claude 响应流式输出，实时显示生成内容
- **代码高亮**: 集成 Markdown 渲染和代码块高亮功能
- **消息类型**: 支持多种消息格式，包括文本、代码、工具调用结果等
- **权限管理**: 内置权限确认机制，保障操作安全

## 技术栈

### 前端技术
- **Vue 3**: 渐进式 JavaScript 框架
- **TypeScript**: 类型安全的 JavaScript 超集
- **Vite**: 下一代前端构建工具
- **Pinia**: Vue 状态管理库
- **TailwindCSS**: 原子化 CSS 框架
- **i18n**: 国际化支持（中英文）

### 后端技术
- **Tauri**: 跨平台桌面应用框架
- **Rust**: 系统级编程语言，保证性能和安全性

## 项目结构

```
cc-window/
├── src/
│   ├── components/          # Vue 组件
│   │   ├── chat/           # 聊天相关组件
│   │   ├── command/        # 命令面板组件
│   │   ├── common/         # 公共组件
│   │   ├── layout/         # 布局组件
│   │   ├── session/        # 会话管理组件
│   │   └── workspace/      # 工作区组件
│   ├── stores/             # Pinia 状态管理
│   ├── locales/            # 国际化文件
│   ├── assets/             # 静态资源
│   └── main.ts             # 应用入口
├── src-tauri/              # Tauri 后端
│   ├── src/
│   │   ├── claude.rs      # Claude API 相关
│   │   ├── lib.rs         # 核心逻辑
│   │   └── main.rs        # 入口文件
│   └── icons/              # 应用图标
├── public/                 # 公共静态资源
└── package.json            # 项目配置
```

## 快速开始

### 环境要求

- Node.js 18+
- pnpm 包管理器
- Rust 工具链（1.70+）
- 系统依赖：
  - **Windows**: WebView2 运行时
  - **macOS**: Xcode 命令行工具
  - **Linux**: `webkit2gtk` 开发库

### 安装依赖

```bash
# 安装前端依赖
pnpm install

# 安装 Tauri 依赖
cd src-tauri
cargo fetch
```

### 开发模式

```bash
# 启动前端开发服务器（带热重载）
pnpm dev

# 在独立窗口中启动完整应用
pnpm dev:app
```

### 构建发布版本

```bash
# 构建前端资源
pnpm build

# 构建 Tauri 应用
cd src-tauri
cargo build --release
```

## 使用说明

### 基本交互

1. **新建会话**: 点击侧边栏的新建会话按钮或使用命令面板
2. **发送消息**: 在输入框中输入内容，按 Enter 或点击发送按钮
3. **继续对话**: 点击"继续"按钮可恢复上次会话
4. **切换工作区**: 通过工作区选择器切换不同项目目录

### 命令系统

支持以下内置命令：
- `/new` - 创建新会话
- `/clear` - 清除当前会话
- `/theme toggle` - 切换主题
- `/help` - 显示帮助信息

### 快捷键

| 快捷键 | 功能 |
|--------|------|
| `Ctrl/Cmd + Enter` | 发送消息 |
| `Ctrl/Cmd + K` | 打开命令面板 |
| `Ctrl/Cmd + /` | 切换主题 |

## 配置说明

### 应用设置

通过设置模块可配置以下选项：
- 主题模式（亮色/暗色/跟随系统）
- 字体大小
- 代码高亮主题
- 语言偏好

### 工作区配置

工作区支持以下功能：
- 目录浏览和选择
- 会话隔离存储
- 项目级上下文管理

## 开发计划

| 阶段 | 内容 |
|------|------|
| 阶段一 | 项目初始化和技术选型 |
| 阶段二 | 核心后端实现（CLI 交互、流式处理） |
| 阶段三 | 基础 UI 开发（布局、组件、主题） |
| 阶段四 | 功能完善（会话管理、命令系统、设置） |
| 阶段五 | 性能优化和测试 |

## 安全特性

- **进程安全**: 严格的进程调用权限控制
- **文件安全**: 工作区文件访问隔离
- **数据安全**: 会话数据本地加密存储

## 扩展性

项目设计支持以下扩展：
- 自定义命令支持
- 插件系统
- 更多 AI 提供商集成
- 主题自定义

## 许可证

本项目遵循 MIT 许可证开源。

## 贡献指南

欢迎提交 Issue 和 Pull Request，共同完善项目。