AI trả về văn bản thay vì tệp
Sao chép riêng đối tượng JSON vào một tệp có đuôi .json rồi thử lại.
Hướng dẫn
Tạo tệp bài học mà không cần API key
Bạn tự dùng ChatGPT, Gemini hoặc Claude để đọc tài liệu. Hanzi Atelier không tích hợp AI API, không biết tài khoản AI và chỉ xử lý file trên thiết bị.
Sao chép prompt phân tích
Dùng prompt chuẩn của Hanzi Atelier để AI biết chính xác cấu trúc cần trả về.
Mở AI riêng bạn đang có
Mở ChatGPT, Gemini hoặc Claude. Hanzi Atelier không kết nối hay gửi dữ liệu tới các dịch vụ này.
Dán prompt và đưa tài liệu
Dán nguyên prompt, sau đó tải tài liệu gốc vào cuộc trò chuyện của bạn.
Ưu tiên yêu cầu tệp JSON
JSON là định dạng ưu tiên. Nếu dịch vụ chỉ trả PDF, PDF phải có văn bản chọn được và JSON nằm giữa hai marker chuẩn.
Tải tệp kết quả về máy
Tải file .json UTF-8, hoặc PDF văn bản có HANZI_ATELIER_DATA_START và HANZI_ATELIER_DATA_END.
Nhập vào Hanzi Atelier
Mở trang Nhập bài học, chọn file, xem lỗi chi tiết và chỉ lưu khi cấu trúc hợp lệ.
Lỗi thường gặp
AI chỉ cho tải PDF
PDF được chấp nhận nếu có lớp văn bản chọn được và đúng một khối JSON giữa HANZI_ATELIER_DATA_START và HANZI_ATELIER_DATA_END. PDF quét ảnh chưa được hỗ trợ.
JSON bị bọc trong markdown
Ứng dụng có thể bỏ một lớp code fence JSON. Nếu vẫn lỗi, chỉ giữ lại đối tượng JSON.
JSON thiếu dấu phẩy
Yêu cầu công cụ AI kiểm tra lại cú pháp JSON và xuất toàn bộ tệp mới.
Pinyin không có thanh điệu
Dữ liệu vẫn có thể xem trước, nhưng Hanzi Atelier sẽ hiển thị cảnh báo để bạn rà soát.
Từ vựng bị trùng
So sánh các mục có cùng chữ Hán và pinyin trước khi dùng dữ liệu về sau.
Định dạng được hỗ trợ
Có thể dán bảng từ Excel/Google Sheets hoặc nhập CSV, TSV và XLSX với ba cột bắt buộc hanzi, pinyin, meaning. Luồng nâng cao nhận JSON trực tiếp; TXT, DOCX và PDF văn bản được nhận khi chứa JSON thuần, một code fence JSON hoặc JSON giữa HANZI_ATELIER_DATA_START và HANZI_ATELIER_DATA_END. Ảnh và PDF quét chưa có OCR.