feat: Establish core services, utilities, and internationalization for TiniX Story 1.0, and update project documentation and configuration.

locales/VI/huong_dan_su_dung.md

@@ -0,0 +1,111 @@
+# TiniX Story 1.0 - Hướng dẫn sử dụng toàn tập
+
+Chào mừng bạn đến với **TiniX Story 1.0**, hệ thống AI hỗ trợ sáng tác tiểu thuyết và nội dung dài kỳ cấp chuyên nghiệp. Tài liệu này sẽ hướng dẫn bạn chi tiết từ cách cài đặt, cấu hình ban đầu cho đến cách tận dụng tối đa các tính năng của phần mềm.
+
+---
+
+## 📦 1. Bắt đầu nhanh & Cài đặt
+
+### Yêu cầu hệ thống
+- Hệ điều hành: Windows 10/11, macOS, hoặc Linux.
+- Python: Phiên bản 3.8 trở lên (Khuyến nghị 3.11).
+
+### Cài đặt và Khởi động
+Nếu bạn đã tải mã nguồn về máy:
+
+1. **Tạo và kích hoạt môi trường ảo (Virtual Environment):**
+   ```bash
+   python -m venv venv
+   
+   # Kích hoạt trên Windows:
+   venv\Scripts\activate
+   
+   # Kích hoạt trên Mac/Linux:
+   source venv/bin/activate
+   ```
+
+2. **Cài đặt thư viện phụ thuộc:**
+   ```bash
+   pip install -r requirements.txt
+   ```
+   *Lưu ý: Nếu bạn muốn upload và xử lý file PDF hoặc EPUB, hãy cài thêm các thư viện hỗ trợ:*
+   ```bash
+   pip install PyMuPDF ebooklib beautifulsoup4
+   ```
+
+3. **Khởi động ứng dụng:**
+   ```bash
+   python app.py
+   ```
+   Sau khi màn hình console báo thành công, hãy mở trình duyệt và truy cập vào đường link được hiển thị (thường là `http://127.0.0.1:7860`).
+
+---
+
+## ⚙️ 2. Cấu hình Hệ thống & API (Bước quan trọng đầu tiên)
+
+Trước khi bắt đầu sáng tác, bạn **bắt buộc** phải cấu hình API để AI có thể hoạt động.
+
+1. Chuyển sang thẻ **⚙️ Cài đặt hệ thống**.
+2. Tại tab **🌐 Quản lý giao diện (Interface Management)**, tiến hành thêm cấu hình API mới:
+   - **Tên giao diện:** Đặt tên bất kỳ (Ví dụ: `My OpenAI`, `Gemini Pro`).
+   - **Loại giao diện:** Chọn nhà cung cấp phù hợp (OpenAI, Anthropic, v.v.). Nếu dùng API tương thích OpenAI, hãy điền đúng Base URL.
+   - **Tên mô hình:** Nhập chính xác mã mô hình (VD: `gpt-4o`, `claude-3-5-sonnet-20240620`, `gemini-1.5-pro`).
+   - **API Key:** Nhập mã khóa bí mật của bạn (Sẽ không được lưu dưới dạng văn bản thuần túy).
+   - Hãy tích chọn **Sử dụng làm mặc định** nếu đây là API chính của bạn.
+3. Nhấp **➕ Thêm giao diện**. Hệ thống sẽ thông báo thành công.
+4. Chuyển qua tab **📝 Tham số tạo** để tinh chỉnh:
+   - **Temperature (Độ sáng tạo):** Mặc định 0.7. Mức cao (>0.8) cho văn phong sáng tạo, bay bổng. Mức thấp (<0.5) cho văn phong logic, nhất quán.
+   - **Mục tiêu chữ mỗi chương:** Thiết lập số chữ bạn mong muốn cho một chương (Mặc định thường là 1500 - 2000 chữ).
+
+---
+
+## ✍️ 3. Các tính năng sáng tác cốt lõi
+
+### 3.1. Sáng tác từ con số không (Create from Scratch)
+Chức năng này dành cho việc xây dựng một bộ tiểu thuyết hoàn toàn mới.
+- Điền các thông tin cơ bản: Tên tiểu thuyết, Thể loại, Chủ đề phụ.
+- Nhấp **✨ Nhận cảm hứng trí tuệ nhân tạo** để gợi ý Tên sách, Tuyến nhân vật, Thế giới quan.
+- Sau khi có đủ Thiết lập, nhấp **Tạo dàn ý**. Phải đảm bảo dàn ý tuân thủ cấu trúc mỗi dòng một chương để hệ thống nhận diện đúng.
+- Bấm **Bắt đầu tạo / Tiếp tục** để AI bắt đầu viết từng chương. Hệ thống tự động ghi nhớ bối cảnh (context) từ các chương trước.
+
+### 3.2. Chế độ Viết lại (Rewrite Mode)
+Chức năng dùng để thay đổi văn phong của một đoạn văn bản có sẵn.
+- Tải tệp lên (TXT, DOCX, v.v.) hoặc dán trực tiếp.
+- Lựa chọn cách phân đoạn để AI không bị quá tải: Tự động, theo số lượng chữ, hoặc theo biểu thức/cụm từ tùy chỉnh (VD: Phân tách theo "Chương").
+- Chọn một trong **17 phong cách văn học** (Tiên hiệp, Lãng mạn đô thị, Kinh dị, Khoa học viễn tưởng, Hardcore...).
+- Bấm **Bắt đầu viết lại**. Hệ thống sẽ chạy và bạn có thể theo dõi trực tiếp.
+
+### 3.3. Chế độ Viết tiếp (Continue Mode)
+Dành cho trường hợp bạn viết dở hoặc có một tác phẩm đang dang dở.
+- Điền các thiết lập nhân vật, thế giới quan (nếu có, để AI nắm bắt tốt hơn).
+- Cung cấp nội dung văn bản phần trước.
+- AI sẽ phân tích văn phong, giọng văn và tự động viết tiếp cốt truyện một cách logic.
+
+### 3.4. Trau chuốt tiểu thuyết (Novel Polish)
+Giống như một biên tập viên chuyên nghiệp rà soát lại tác phẩm của bạn.
+- Cung cấp văn bản thô.
+- Chọn loại hình trau chuốt: 
+  - **Comprehensive:** Trau chuốt toàn diện.
+  - **Find Errors:** Tìm lỗi chính tả, ngữ pháp, logic.
+  - **Remove AI Tone:** Làm cho câu chữ tự nhiên và "giống người viết" hơn.
+  - **Enhance Details:** Phóng to các chi tiết miêu tả cảm quan, bối cảnh.
+  - **Optimize Dialogue:** Làm mượt mà và cá nhân hóa lời thoại.
+
+---
+
+## 📂 4. Quản lý Dự án & Xuất file
+
+- **Thẻ Quản lý Dự án:** Mọi dự án bạn tạo (Sáng tác, Viết lại, Viết tiếp) đều được tự động lưu trữ tại đây. Bạn có thể xem **Tiến độ hoàn thành**, số lượng chương. Nếu bạn muốn tạm ngưng, cứ tắt app; sau đó vào đây chọn dự án và bấm **Viết tiếp (Continue)** để khôi phục tiến trình.
+- **Thẻ Xuất (Export):** Cho phép bạn xuất dự án hoàn chỉnh ra nhiều định dạng chuyên nghiệp như `.docx` (Word), `.txt`, `.md` hoặc `.html`. Rất tiện lợi để gửi cho tòa soạn hoặc đăng tải lên các nền tảng đọc truyện online.
+
+---
+
+## 🛠 5. Khắc phục sự cố (Troubleshooting)
+
+| Vấn đề | Nguyên nhân & Cách giải quyết |
+|--------|------------------------------|
+| **Không thể tải (load) API** | Kiểm tra lại kết nối mạng hoặc API Key có chính xác không. Nhấn "Test" trong phần cài đặt Backend để xem lỗi phản hồi từ máy chủ trả về. |
+| **API trả về 0 chữ** | Hệ thống TiniX Story sẽ **tự động thử lại** tối đa 3 lần. Nếu vẫn thất bại, hãy giảm "Max Tokens" hoặc kiểm tra lại prompt thiết lập xem có vi phạm chính sách của nhà cung cấp API không. |
+| **Lỗi cài thư viện DOCX** | Nếu xuất file Word báo lỗi, hãy chạy thủ công lệnh `pip install python-docx` trên Terminal. |
+| **Cổng 7860 bị từ chối** | App sẽ tự tìm một cổng khác (ví dụ 7861, 7862...). Hãy để ý thông báo URL ở Terminal. |
+| **Giao diện hiển thị tiếng Anh**| Đảm bảo thiết lập `set APP_LANGUAGE=VI` (Windows cmd) trước khi chạy `python app.py` nếu bạn không muốn thấy giao diện mặc định. |

locales/VI/messages.json

@@ -1,9 +1,9 @@
 {
     "app": {
-        "title": "Công cụ sáng tác tiểu thuyết AI Pro",
-        "window_title": "Công cụ sáng tác tiểu thuyết AI Pro - Phiên bản chuyên nghiệp",
-        "subtitle": "_Hệ thống sáng tác tiểu thuyết thông minh cấp chuyên nghiệp v4.0 chính thức_",
-        "startup_log": "Công cụ sáng tác tiểu thuyết AI Pro v4.0 chính thức khởi động",
+        "title": "Công cụ sáng tác tiểu thuyết TiniX Story 1.0",
+        "window_title": "Công cụ sáng tác tiểu thuyết TiniX Story 1.0 - Phiên bản chuyên nghiệp",
+        "subtitle": "_Hệ thống sáng tác tiểu thuyết thông minh cấp chuyên nghiệp v1.0 chính thức_",
+        "startup_log": "Công cụ sáng tác tiểu thuyết TiniX Story 1.0 chính thức khởi động",
         "port_in_use": "Cổng {port} đã bị chiếm, sử dụng cổng {new_port}",
         "backends_loaded": "Đã tải {count} backend",
         "no_backends_warning": "⚠️  Không có backend nào được bật! Vui lòng thêm cấu hình API trong phần cài đặt",
@@ -482,7 +482,7 @@
         "sub_genre_err_delete": "Xóa thất bại!"
     },
     "about": {
-        "content": "# Công cụ sáng tác tiểu thuyết AI Pro v4.0 chính thức\n## Hệ thống sáng tác tiểu thuyết thông minh cấp chuyên nghiệp\n\n### 🌟 Tính năng chính\n- **Sáng tác thông minh**: Sáng tác tiểu thuyết dài kỳ từ đầu, hỗ trợ tùy chỉnh dàn ý\n- **Tiếp tục từ điểm dừng**: Hỗ trợ tạm dừng rồi viết tiếp, mỗi chương tự động lưu\n- **Viết lại thông minh**: Tải lên văn bản tiểu thuyết, viết lại chất lượng cao với 17 phong cách\n- **Viết tiếp thông minh**: Tải lên tiểu thuyết viết dở, AI tự động viết tiếp\n- **Trau chuốt tiểu thuyết**: Hỗ trợ 8 loại trau chuốt bao gồm toàn diện, tìm lỗi, gợi ý cải thiện, loại bỏ phong cách AI\n- **Phân tích tệp linh hoạt**: Hỗ trợ tùy chỉnh mẫu chương, nhận dạng nhiều định dạng tệp tiểu thuyết\n- **Xuất đa định dạng**: Word, TXT, Markdown, HTML - tải trực tiếp\n- **Quản lý dự án**: Quản lý nhiều dự án sáng tác, hỗ trợ viết tiếp từ điểm dừng\n- **Cấu hình linh hoạt**: Hỗ trợ nhiều API backend, Ollama key tùy chọn\n- **Tự động thử lại**: Khi tạo chương bị lỗi sẽ tự động thử lại\n- **Tự động tìm cổng**: Khi cổng mặc định bị chiếm sẽ tự động tìm cổng khả dụng\n\n### 🔧 Đặc điểm kỹ thuật\n- **Phục hồi lỗi**: Hệ thống xử lý lỗi và ghi log hoàn chỉnh\n- **Cơ chế bộ nhớ đệm**: Bộ nhớ đệm thông minh tránh gọi API trùng lặp\n- **Giới hạn tốc độ**: Thuật toán token bucket tích hợp chống giới hạn API\n- **Cân bằng tải**: Tự động luân chuyển nhiều backend\n- **Giám sát hiệu suất**: Thống kê và phân tích hiệu suất thời gian thực\n- **An toàn luồng**: Thiết kế an toàn đồng thời hoàn toàn\n\n### 📋 Yêu cầu hệ thống\n- Python 3.8+\n- Phụ thuộc: gradio, pandas, openai, python-docx\n- Tùy chọn: PyMuPDF (hỗ trợ PDF), ebooklib+beautifulsoup4 (hỗ trợ EPUB)\n\n### 📞 Hỗ trợ kỹ thuật\n- Xem tệp log: thư mục `logs/`\n- Vị trí lưu dự án: thư mục `projects/`\n- Vị trí tệp xuất: thư mục `exports/`\n- Vị trí bộ nhớ đệm: thư mục `cache/`\n- GitHub: [GitHub](https://github.com/yangqi1309134997-coder/ai-novel-generator)\n\n### ⚖️ Giấy phép\nMIT License"
+        "content": "# Công cụ sáng tác tiểu thuyết TiniX Story v1.0 chính thức\n## Hệ thống sáng tác tiểu thuyết thông minh cấp chuyên nghiệp\n\n### 🌟 Tính năng chính\n- **Sáng tác thông minh**: Sáng tác tiểu thuyết dài kỳ từ đầu, hỗ trợ tùy chỉnh dàn ý\n- **Tiếp tục từ điểm dừng**: Hỗ trợ tạm dừng rồi viết tiếp, mỗi chương tự động lưu\n- **Viết lại thông minh**: Tải lên văn bản tiểu thuyết, viết lại chất lượng cao với 17 phong cách\n- **Viết tiếp thông minh**: Tải lên tiểu thuyết viết dở, AI tự động viết tiếp\n- **Trau chuốt tiểu thuyết**: Hỗ trợ 8 loại trau chuốt bao gồm toàn diện, tìm lỗi, gợi ý cải thiện, loại bỏ phong cách AI\n- **Phân tích tệp linh hoạt**: Hỗ trợ tùy chỉnh mẫu chương, nhận dạng nhiều định dạng tệp tiểu thuyết\n- **Xuất đa định dạng**: Word, TXT, Markdown, HTML - tải trực tiếp\n- **Quản lý dự án**: Quản lý nhiều dự án sáng tác, hỗ trợ viết tiếp từ điểm dừng\n- **Cấu hình linh hoạt**: Hỗ trợ nhiều API backend, Ollama key tùy chọn\n- **Tự động thử lại**: Khi tạo chương bị lỗi sẽ tự động thử lại\n- **Tự động tìm cổng**: Khi cổng mặc định bị chiếm sẽ tự động tìm cổng khả dụng\n\n### 🔧 Đặc điểm kỹ thuật\n- **Phục hồi lỗi**: Hệ thống xử lý lỗi và ghi log hoàn chỉnh\n- **Cơ chế bộ nhớ đệm**: Bộ nhớ đệm thông minh tránh gọi API trùng lặp\n- **Giới hạn tốc độ**: Thuật toán token bucket tích hợp chống giới hạn API\n- **Cân bằng tải**: Tự động luân chuyển nhiều backend\n- **Giám sát hiệu suất**: Thống kê và phân tích hiệu suất thời gian thực\n- **An toàn luồng**: Thiết kế an toàn đồng thời hoàn toàn\n\n### 📋 Yêu cầu hệ thống\n- Python 3.8+\n- Phụ thuộc: gradio, pandas, openai, python-docx\n- Tùy chọn: PyMuPDF (hỗ trợ PDF), ebooklib+beautifulsoup4 (hỗ trợ EPUB)\n\n### 📞 Hỗ trợ kỹ thuật\n- Xem tệp log: thư mục `logs/`\n- Vị trí lưu dự án: thư mục `projects/`\n- Vị trí tệp xuất: thư mục `exports/`\n- Vị trí bộ nhớ đệm: thư mục `cache/`\n- GitHub: [GitHub](https://github.com/yangqi1309134997-coder/ai-novel-generator)\n\n### ⚖️ Giấy phép\nMIT License"
     },
     "messages": {
         "no_content_polish": "Không có nội dung để trau chuốt",

locales/VI/使用说明.md

@@ -1,115 +0,0 @@
-# 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