---
name: vietphrase-novel-scan
description: Scan Chinese web-novel TXT text in the VietPhrase browser app, review detected names and terminology, and export Book Names or Book VietPhrase files. Use when a user wants a reusable Chinese-to-Vietnamese novel glossary before translation.
---

# VietPhrase Novel Scan

Use this skill when a user wants to extract and review recurring names or terms from a Chinese web novel before translating it.

## Entry point

Open <https://vietphrase.app/novel-scan>. Novel Scan is an interactive browser workflow; it does not expose a public server-side scan API.

## Workflow

1. Upload the user's `.txt` novel or paste Chinese text into the visible input, then start the scan.
2. If the page finds a saved result for the same filename, inspect its state before acting:
   - Use a fresh saved result directly.
   - If only the scan version differs, ask before choosing **Dùng kết quả cũ** or **Quét lại**.
   - If the content hash differs, use **Quét lại** only with the user's approval. Rescanning replaces pending terms shared with the file translator.
3. Review candidates in the terminology table. Check the Chinese surface, Vietnamese suggestion, category, occurrence count, verifier evidence, and optional NER evidence.
4. Correct the Vietnamese value, then approve useful terms or ignore noise. Do not treat pending terms as final glossary entries.
5. Optionally run local NER verification for ambiguous names. Report that a one-time model download may be required instead of silently switching to an online service.
6. Copy or download the approved **Book Names** and **Book VietPhrase** outputs. Identify which output was returned.

## Privacy and capability boundaries

- Novel text, review state, glossary output, analytics, and NER inference stay in the browser after required assets are downloaded.
- Do not describe Novel Scan as a public API, remote MCP server, OAuth resource, or A2A agent.
- Automate only the visible browser workflow or browser tools actually declared by the page.
- Never approve, ignore, or rescan shared pending terms without making that action clear to the user.

## Verification

- Confirm that exported lines use `Chinese=Vietnamese` format.
- Confirm that exports contain approved terms only.
- After an edit or status change, confirm the Book Names or Book VietPhrase count and text update.
- For a same-filename rescan, confirm the page showed the pending-term replacement warning.