aio-epub-quality

EPUB Quality — Translation Quality Report

Check translation quality across a book or specific chapter to find issues.

Khi nào dùng: Sau khi dịch xong bằng aio-epub-translate, chạy quality check trước khi xuất bằng aio-epub-export.

API Setup

import json, urllib.request, os

BASE = "https://read-api.aiocean.dev/ListBooks.v1.BookService"
KEY = os.environ.get("AIO_EPUB_API_KEY", "")

def api(method, body):
    data = json.dumps(body).encode('utf-8')
    req = urllib.request.Request(f"{BASE}/{method}", data=data, headers={
        "Content-Type": "application/json",
        "X-License-Key": KEY
    })
    with urllib.request.urlopen(req) as resp:
        return json.loads(resp.read())

Workflow

1. Run Quality Report

# Check a specific chapter
report = api("GetTranslationQualityReport", {
    "bookId": BOOK_ID,
    "filePath": FILE_PATH  # leave empty to check entire book
})

print(f"Quality Score: {report['qualityScore']:.1f}%")
print(f"Total Items: {report['totalItems']}")
print(f"Issues Found: {report['issuesCount']}")

for issue in report.get("issues", []):
    print(f"\n  [{issue['issueType']}] {issue['contentId'][:12]}")
    print(f"  Detail: {issue['detail']}")
    if issue.get("originalText"):
        print(f"  Original: {issue['originalText'][:100]}")
    if issue.get("translatedText"):
        print(f"  Translated: {issue['translatedText'][:100]}")

2. Issue Types

Type	Meaning	Action
mixed_language	>50% words still in English	Re-translate
empty_translation	Translation element is empty	Translate
too_short	Translation <30% of original length	Review & re-translate
untranslated	Translation identical to original	Re-translate
missing_translation_element	ID referenced but element missing	Re-mark or re-translate

2b. Literary Quality Evaluation (Đánh giá văn học sâu)

Dùng khi mechanical score cao (>90%) nhưng bản dịch "nghe như dịch máy" hoặc "đọc không tự nhiên".