# weapp-celestial

**Repository Path**: JasonOblivion/weapp-celestial

## Basic Information

- **Project Name**: weapp-celestial
- **Description**: No description available
- **Primary Language**: JavaScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-08
- **Last Updated**: 2025-09-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# StarHub 

基于 React 18 + TypeScript + Ant Design

## 功能模块

### 1. 模型管理
- 大语言模型（LLM）配置
- 向量模型配置
- 重排序模型配置
- 模型参数设置
- 模型状态监控

### 2. 函数管理
- 函数创建与编辑
- 函数类型管理（工具、API、插件）
- 函数版本控制
- 函数状态管理
- 函数权限控制

### 3. 提示词管理
- 提示词模板管理
- 系统提示词配置
- 用户提示词管理
- 提示词版本控制
- 提示词标签管理

### 4. 智能体管理
- 智能体配置
- 模型选择
- 函数调用配置
- 提示词配置
- 流式输出设置

### 5. 流程管理
- 流程设计器
- 节点配置
- 条件设置
- 流程监控
- 执行日志

## 技术栈

- **前端框架**：React 18
- **开发语言**：TypeScript
- **UI 组件库**：Ant Design 5.x
- **状态管理**：MobX
- **路由管理**：React Router 6
- **HTTP 客户端**：Axios
- **构建工具**：Vite
- **代码规范**：ESLint + Prettier

## 项目结构

```
src/
├── apis/              # API 接口定义
├── assets/            # 静态资源
├── components/        # 公共组件
│   ├── common/        # 通用组件
│   └── layout/        # 布局组件
├── pages/             # 页面组件
│   ├── backhub/       # 后台管理
│   │   ├── agent/     # 智能体管理
│   │   ├── function/  # 函数管理
│   │   ├── model/     # 模型管理
│   │   ├── prompt/    # 提示词管理
│   │   └── flowpath/  # 流程管理
│   └── auth/          # 认证相关
├── store/             # 状态管理
│   ├── mobx/          # MobX store
│   └── types/         # 类型定义
├── styles/            # 全局样式
├── utils/             # 工具函数
└── App.tsx            # 应用入口
```

## 开发规范

### 1. 代码规范
- 使用 TypeScript 进行类型检查
- 遵循 ESLint 和 Prettier 配置
- 使用函数组件和 Hooks
- 组件文件使用 PascalCase 命名
- 工具函数使用 camelCase 命名

### 2. 组件开发
- 遵循单一职责原则
- 使用 Props 类型定义
- 实现适当的错误处理
- 添加必要的注释
- 确保组件可复用性

### 3. 状态管理
- 使用 MobX 进行状态管理
- 遵循响应式编程原则
- 合理划分 Store 模块
- 实现适当的数据缓存
- 处理异步操作

### 4. 样式规范
- 使用 CSS Modules
- 遵循 BEM 命名规范
- 实现响应式设计
- 保持样式可维护性
- 避免样式冲突

## 开发指南

### 1. 环境要求
- Node.js >= 16.0.0 (推荐到v18.x，可以装nvm切换版本。我本地用的18.20.8。v16.x是依赖react18的推荐)
- npm >= 7.0.0（匹配nodejs即可）
- Git

### 2. 安装依赖
```bash
# 安装项目依赖
npm install

# 安装特定依赖
npm install package-name
```

### 3. 开发命令
```bash
# 启动开发服务器
npm run dev

# 启动开发服务器（指定端口）
npm run dev -- --port 3000

# 检查代码规范
npm run lint

# 格式化代码
npm run format
```

### 4. 构建部署
```bash
# 构建生产版本
npm run build

# 预览生产版本
npm run preview

# 分析构建产物
npm run analyze
```

### 5. 调试技巧
- 使用 React DevTools 进行组件调试
- 使用 Redux DevTools 进行状态调试
- 使用 Chrome DevTools 进行性能分析
- 使用 VSCode 调试器进行断点调试
- 使用 console.log 进行日志输出

## 注意事项

1. **性能优化**
   - 使用 React.memo 优化组件渲染
   - 使用 useMemo 和 useCallback 优化计算
   - 实现代码分割和懒加载
   - 优化图片和静态资源
   - 监控性能指标

2. **安全性**
   - 实现适当的权限控制
   - 处理敏感数据
   - 防止 XSS 攻击
   - 使用 HTTPS
   - 定期更新依赖

3. **可维护性**
   - 编写清晰的文档
   - 保持代码简洁
   - 遵循设计模式
   - 进行代码审查
   - 定期重构

4. **测试**
   - 编写单元测试
   - 进行集成测试
   - 实现端到端测试
   - 监控测试覆盖率
   - 自动化测试流程