chore: initialize qiming workspace repository
This commit is contained in:
104
qiming-mobile/README.md
Normal file
104
qiming-mobile/README.md
Normal file
@@ -0,0 +1,104 @@
|
||||
# Qiming Mobile
|
||||
|
||||
[中文文档](./README_CN.md)
|
||||
|
||||
A cross-platform AI agent mobile application built with UniApp X, supporting H5 and WeChat Mini Program.
|
||||
|
||||
## Features
|
||||
|
||||
- 🤖 **AI Agent Platform** - Browse, search, and interact with AI agents
|
||||
- 💬 **Intelligent Chat** - Real-time streaming conversations with AI agents
|
||||
- 📝 **Markdown Rendering** - Rich text display with code highlighting and LaTeX support
|
||||
- 🎙️ **Voice Input** - Voice-to-text input capability
|
||||
- 📁 **File Preview** - Support for various document formats (DOCX, XLSX, PPTX, PDF, images)
|
||||
- 🔐 **Multiple Login Methods** - Phone, WeChat authorization, and more
|
||||
|
||||
## Tech Stack
|
||||
|
||||
- **Framework**: [UniApp X](https://uniapp.dcloud.io/) (Vue 3)
|
||||
- **Build Tool**: Vite
|
||||
- **Languages**: UTS (UniApp TypeScript), Vue
|
||||
- **Platforms**: H5, WeChat Mini Program
|
||||
|
||||
## Project Structure
|
||||
|
||||
```
|
||||
├── pages/ # Main pages
|
||||
│ ├── index/ # Home page
|
||||
│ ├── agent-list/ # Agent list
|
||||
│ └── ...
|
||||
├── subpackages/ # Subpackages (lazy loading)
|
||||
│ └── pages/
|
||||
│ ├── chat-conversation-component/ # Chat interface
|
||||
│ ├── agent-detail/ # Agent details
|
||||
│ ├── login/ # Login pages
|
||||
│ └── ...
|
||||
├── components/ # Reusable components
|
||||
│ ├── markdown-renderer/
|
||||
│ ├── voice-recorder-button/
|
||||
│ └── ...
|
||||
├── utils/ # Utility functions
|
||||
├── types/ # TypeScript definitions
|
||||
├── static/ # Static assets
|
||||
└── docs/ # Documentation
|
||||
```
|
||||
|
||||
## Getting Started
|
||||
|
||||
### Prerequisites
|
||||
|
||||
- [Node.js](https://nodejs.org/) >= 16
|
||||
- [HBuilderX](https://www.dcloud.io/hbuilderx.html) (recommended for UniApp X development)
|
||||
- [WeChat DevTools](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html) (for Mini Program)
|
||||
|
||||
### Installation
|
||||
|
||||
```bash
|
||||
# Clone the repository
|
||||
git clone https://github.com/qiming-ai/qiming-mobile.git
|
||||
|
||||
# Install dependencies
|
||||
pnpm install
|
||||
# or
|
||||
yarn install
|
||||
```
|
||||
|
||||
### Development
|
||||
|
||||
#### H5 Development
|
||||
|
||||
Run the H5 development server via HBuilderX:
|
||||
1. Open the project in HBuilderX
|
||||
2. Click "Run" → "Run to Browser" → "Chrome"
|
||||
|
||||
The H5 version is deployed at `{domain}/m/` path.
|
||||
|
||||
#### WeChat Mini Program
|
||||
|
||||
1. Run to Mini Program via HBuilderX:
|
||||
- Click "Run" → "Run to Mini Program Simulator" → "WeChat DevTools"
|
||||
2. Open the generated project in WeChat DevTools
|
||||
|
||||
### Build
|
||||
|
||||
#### H5 Production Build
|
||||
|
||||
Via HBuilderX: "Release" → "Website-H5"
|
||||
|
||||
#### WeChat Mini Program Build
|
||||
|
||||
Via HBuilderX: "Release" → "Mini Program-WeChat"
|
||||
|
||||
## Configuration
|
||||
|
||||
- `manifest.json` - App configuration, platform-specific settings
|
||||
- `pages.json` - Page routing and navigation configuration
|
||||
- `platformConfig.json` - Platform-specific configurations
|
||||
|
||||
## Documentation
|
||||
|
||||
Additional documentation can be found in the [docs](./docs) directory.
|
||||
|
||||
## License
|
||||
|
||||
This project is licensed under the [Apache License 2.0](./LICENSE).
|
||||
Reference in New Issue
Block a user