# cool-red-ai-client

**Repository Path**: Dzreal_admin/cool-red-ai-client

## Basic Information

- **Project Name**: cool-red-ai-client
- **Description**: 这是一个小红书运营工具，简称：口红
- **Primary Language**: TypeScript
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-07-25
- **Last Updated**: 2025-08-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cool Red AI - 小红书运营管理系统

一个现代化的小红书运营管理系统，支持账号管理、竞品分析、内容管理、发布管理等核心功能。

## 功能特性

### 🎯 核心功能
- **账号管理**: 多账号管理，状态监控，数据同步
- **竞品分析**: 竞品账号跟踪，数据分析，趋势监控
- **内容管理**: 素材管理，草稿箱，分类存储
- **发布管理**: 定时发布，任务管理，状态跟踪
- **数据分析**: 数据统计，图表展示，趋势分析
- **系统设置**: 配置管理，代理设置，存储路径

### 💾 数据持久化
- **SQLite数据库**: 轻量级本地数据库
- **文件存储**: 分类存储素材文件
- **状态管理**: Zustand状态管理
- **数据备份**: 支持数据导入导出

### 🎨 现代化UI
- **Ant Design**: 企业级UI组件库
- **响应式设计**: 适配不同屏幕尺寸
- **主题定制**: 支持主题切换
- **交互友好**: 直观的操作界面

## 技术栈

### 前端
- **React 18**: 现代化前端框架
- **TypeScript**: 类型安全的JavaScript
- **Ant Design**: 企业级UI组件库
- **Zustand**: 轻量级状态管理
- **React Router**: 路由管理

### 数据存储
- **SQLite**: 本地数据库
- **better-sqlite3**: SQLite驱动
- **文件系统**: 本地文件存储

### 开发工具
- **Vite**: 快速构建工具
- **Tauri**: 桌面应用框架
- **ESLint**: 代码规范检查

## 项目结构

```
cool-red-ai-client/
├── src/
│   ├── components/          # 通用组件
│   ├── pages/              # 页面组件
│   │   ├── Accounts.tsx    # 账号管理
│   │   ├── Competitor.tsx  # 竞品分析
│   │   ├── Content.tsx     # 内容管理
│   │   ├── Publish.tsx     # 发布管理
│   │   ├── Analytics.tsx   # 数据分析
│   │   └── Settings.tsx    # 系统设置
│   ├── stores/             # 状态管理
│   │   ├── index.ts        # 全局状态
│   │   ├── accountStore.ts # 账号状态
│   │   ├── materialStore.ts # 素材状态
│   │   ├── draftStore.ts   # 草稿状态
│   │   ├── publishStore.ts # 发布状态
│   │   ├── competitorStore.ts # 竞品状态
│   │   └── settingStore.ts # 设置状态
│   ├── database/           # 数据库
│   │   ├── db.ts          # 数据库连接
│   │   └── init.ts        # 数据库初始化
│   ├── utils/              # 工具函数
│   │   └── fileUpload.ts  # 文件上传工具
│   ├── layouts/            # 布局组件
│   └── App.tsx            # 主应用
├── data/                   # 数据库文件
├── storage/                # 文件存储
│   ├── image/             # 图片文件
│   ├── video/             # 视频文件
│   ├── audio/             # 音频文件
│   ├── text/              # 文本文件
│   └── markdown/          # Markdown文件
└── package.json
```

## 安装和运行

### 环境要求
- Node.js 16+
- npm 或 pnpm

### 安装依赖
```bash
npm install
```

### 开发模式
```bash
npm run dev
```

### 构建应用
```bash
npm run build
```

### Tauri桌面应用
```bash
npm run tauri dev
```

## 数据库初始化

系统首次运行时会自动创建SQLite数据库和必要的表结构：

### 数据表
- `accounts`: 账号信息
- `competitors`: 竞品账号
- `materials`: 素材文件
- `drafts`: 草稿内容
- `publish_tasks`: 发布任务
- `settings`: 系统设置
- `proxies`: 代理配置

### 文件存储结构
```
storage/
├── image/
│   ├── 产品图/
│   ├── 生活照/
│   ├── 美食图/
│   └── ...
├── video/
│   ├── 产品视频/
│   ├── 生活视频/
│   └── ...
├── audio/
│   ├── 背景音乐/
│   ├── 语音解说/
│   └── ...
├── text/
│   ├── 文案模板/
│   ├── 标题模板/
│   └── ...
└── markdown/
    ├── 文章模板/
    ├── 教程模板/
    └── ...
```

## 状态管理

使用Zustand进行状态管理，每个功能模块都有独立的store：

### 全局状态 (GlobalStore)
- 加载状态
- 错误处理
- 通知管理
- 存储路径

### 功能状态
- **AccountStore**: 账号管理
- **MaterialStore**: 素材管理
- **DraftStore**: 草稿管理
- **PublishStore**: 发布管理
- **CompetitorStore**: 竞品分析
- **SettingStore**: 系统设置

## 配置说明

### 系统设置
在"系统设置"页面可以配置：

1. **常规设置**
   - 自动登录
   - 自动同步
   - 同步间隔
   - 最大重试次数
   - 请求超时
   - 界面语言

2. **代理设置**
   - 代理服务器配置
   - 代理状态管理

3. **素材管理**
   - 文件存储路径
   - 素材分类配置

4. **通知设置**
   - 邮件通知
   - 浏览器通知
   - 通知事件配置

### 文件存储
- 支持多种文件类型：图片、视频、音频、文本、Markdown
- 按类型和分类自动组织文件
- 支持文件预览和下载
- 文件大小和类型验证

## 开发指南

### 添加新功能
1. 创建页面组件
2. 创建对应的store
3. 添加数据库表
4. 更新路由配置

### 数据库操作
```typescript
import db from '../database/db';

// 查询数据
const stmt = db.prepare('SELECT * FROM table_name');
const data = stmt.all();

// 插入数据
const stmt = db.prepare('INSERT INTO table_name (col1, col2) VALUES (?, ?)');
stmt.run(value1, value2);

// 更新数据
const stmt = db.prepare('UPDATE table_name SET col1 = ? WHERE id = ?');
stmt.run(newValue, id);
```

### 状态管理
```typescript
import { useAccountStore } from '../stores/accountStore';

const { accounts, loading, fetchAccounts, addAccount } = useAccountStore();

useEffect(() => {
  fetchAccounts();
}, [fetchAccounts]);
```

## 注意事项

1. **数据备份**: 定期备份数据库和文件
2. **存储空间**: 注意文件存储空间的使用
3. **性能优化**: 大量数据时注意性能优化
4. **安全考虑**: 敏感信息需要加密存储

## 许可证

MIT License

## 贡献

欢迎提交Issue和Pull Request来改进这个项目。