Mai-Vu Tran
116 lines
3.8 KiB
Markdown
116 lines
3.8 KiB
Markdown
# Công cụ sáng tác tiểu thuyết AI Pro v4.0 - Hướng dẫn sử dụng
|
|
|
|
## 📦 Bắt đầu nhanh
|
|
|
|
### Khởi động nhanh một chạm (Đề xuất)
|
|
|
|
1. Đảm bảo đã cài đặt Python 3.8+
|
|
2. Chạy lệnh sau trong thư mục gốc của dự án:
|
|
|
|
```bash
|
|
python start_venv.py
|
|
```
|
|
|
|
3. Script sẽ tự động:
|
|
- Kiểm tra phiên bản Python
|
|
- Tạo môi trường ảo (nếu cần)
|
|
- Cài đặt/cập nhật các thư viện phụ thuộc
|
|
- Khởi động ứng dụng
|
|
|
|
### Khởi động thủ công
|
|
|
|
1. Tạo môi trường ảo:
|
|
|
|
```bash
|
|
python -m venv venv
|
|
```
|
|
|
|
2. Kích hoạt môi trường ảo:
|
|
- Windows: `venv\Scripts\activate`
|
|
- Linux/Mac: `source venv/bin/activate`
|
|
3. Cài đặt các thư viện phụ thuộc:
|
|
|
|
```bash
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
4. Khởi động ứng dụng:
|
|
|
|
```bash
|
|
python app.py
|
|
```
|
|
|
|
## 📚 Thông tin bản quyền
|
|
|
|
Bản quyền © 2026 Công ty TNHH Công nghệ An ninh mạng Huyễn Thành Tân Cương (Công nghệ Huyễn Thành)
|
|
Tác giả: Huyễn Thành
|
|
|
|
## 🔗 Liên kết liên quan
|
|
|
|
- GitHub: <https://github.com/yangqi1309134997-coder/ai-novel-generator>
|
|
- Ghi chú đám mây Huyễn Thành: <https://hcnote.cn/>
|
|
|
|
## ❓ Câu hỏi thường gặp
|
|
|
|
### 1. Cổng (Port) bị chiếm dụng
|
|
|
|
**Vấn đề**: Khi khởi động báo cổng 7860 đã bị chiếm dụng.
|
|
**Cách giải quyết**: Script sẽ tự động tìm kiếm cổng khả dụng, không cần xử lý thủ công.
|
|
|
|
### 2. Cài đặt thư viện phụ thuộc thất bại
|
|
|
|
**Vấn đề**: Cài đặt pip thất bại.
|
|
**Cách giải quyết**:
|
|
|
|
- Nâng cấp pip: `python -m pip install --upgrade pip`
|
|
- Sử dụng mirror lân cận: `pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt`
|
|
|
|
### 3. Tạo môi trường ảo thất bại
|
|
|
|
**Vấn đề**: Module venv không khả dụng.
|
|
**Cách giải quyết**: Sử dụng virtualenv:
|
|
|
|
```bash
|
|
pip install virtualenv
|
|
virtualenv venv
|
|
```
|
|
|
|
### 4. Lỗi import module
|
|
|
|
**Vấn đề**: Khi khởi động báo không tìm thấy module.
|
|
**Cách giải quyết**: Đảm bảo đã cài đặt tất cả các thư viện phụ thuộc trong môi trường ảo.
|
|
|
|
### 5. Lỗi cấu hình API
|
|
|
|
**Vấn đề**: Không thể kết nối API.
|
|
**Cách giải quyết**:
|
|
|
|
1. Kiểm tra khóa API (API key) đã chính xác chưa.
|
|
2. Kiểm tra kết nối backend trong mục "Cài đặt hệ thống".
|
|
3. Xem file log: `logs/novel_tool_*.log`
|
|
|
|
## 📁 Cấu trúc dự án
|
|
|
|
```
|
|
ai-novel-generator-4.0/
|
|
├── app.py # Chương trình chính
|
|
├── start_venv.py # Script khởi động nhanh một chạm
|
|
├── requirements.txt # Danh sách thư viện phụ thuộc
|
|
├── config/ # Thư mục cấu hình
|
|
├── logs/ # Thư mục log
|
|
├── projects/ # Dữ liệu dự án
|
|
├── exports/ # File xuất ra
|
|
└── cache/ # Thư mục bộ nhớ đệm (cache)
|
|
```
|
|
|
|
## 📖 Tính năng nổi bật
|
|
|
|
- ✅ Sáng tác thông minh: Sáng tác tiểu thuyết dài kỳ từ con số không
|
|
- ✅ Viết lại thông minh: Hỗ trợ viết lại với 17 phong cách thiết lập sẵn
|
|
- ✅ Viết tiếp thông minh: Tự động viết tiếp tiểu thuyết hiện có
|
|
- ✅ Trau chuốt tiểu thuyết: 8 lựa chọn trau chuốt (đánh bóng) câu chữ
|
|
- ✅ Phân đoạn linh hoạt: Hỗ trợ phân đoạn tự động, theo số lượng chữ, hoặc theo văn bản cố định
|
|
- ✅ Quản lý dự án: Quản lý đa dự án, hỗ trợ tải lên tiếp tục (resume) tại điểm dừng
|
|
- ✅ Xuất ra nhiều định dạng: Word, TXT, Markdown, HTML
|
|
- ✅ Tự động thử lại khi lỗi: Tự động lặp lại các thao tác bị lỗi
|