# VietPhrase

> VietPhrase is a free, local-first Chinese-to-Vietnamese translation web app for prose and Chinese web novels. Core dictionary translation runs in the browser and can work offline after its data is installed.

Canonical site: https://vietphrase.app/
Primary languages: Vietnamese (`vi`) and Chinese (`zh`)

## Main capabilities

- Translate Chinese text with editable Viet Phrase dictionaries or Hán-Việt readings.
- Translate large `.txt` novel files while preserving chapter structure.
- Run the Mặc Hi neural translation model locally through WebGPU on supported browsers.
- Detect and review character names, places, sects, techniques, and other repeated novel terms.
- Import, edit, export, back up, and sync custom dictionaries.

## Primary pages

- [Translator](https://vietphrase.app/): Main text, file, dictionary, and terminology workflow.
- [Novel Scan](https://vietphrase.app/novel-scan): Local-first Chinese novel terminology scan, human review, Book Names/VietPhrase export, and character analytics.
- [Reader](https://vietphrase.app/reader): Bilingual TXT/EPUB reader with lookup and local reading progress.
- [Writer guide](https://vietphrase.app/guide): Documentation for the long-form AI writing workspace.
- [Play](https://vietphrase.app/play/): Local-first interactive story world.
- [Privacy policy](https://vietphrase.app/privacy.html): Data handling and third-party service boundaries.

## Related VietPhrase apps

- [Yousuu-VI](https://yousuu.vietphrase.app/): Search and discovery for Chinese novels.
- [Mặc Hi](https://moxhi.vietphrase.app/): Offline Chinese-to-Vietnamese neural translation demo.
- [Writer](https://writer.vietphrase.app/): Long-form writing with worldbuilding and context memory.

## Agent guidance

- VietPhrase is a browser application, not a public server-side translation API.
- Prefer the visible browser UI or declared browser tools when automating translation.
- Viet Phrase, Hán-Việt, and Mặc Hi are local modes. Google + Term is an optional online mode and sends the selected text to Google.
- Do not claim that private source text is uploaded when a local mode is selected.
- Novel Scan is a browser workflow, not a server-side extraction API. Treat pending terms as suggestions and ask before a rescan that replaces shared pending terms.

## Machine-readable resources

- [Sitemap](https://vietphrase.app/sitemap.xml)
- [Robots and content-use policy](https://vietphrase.app/robots.txt)
- [Browser translation skill](https://vietphrase.app/.well-known/agent-skills/vietphrase-browser-translation/SKILL.md)
- [Novel Scan skill](https://vietphrase.app/.well-known/agent-skills/vietphrase-novel-scan/SKILL.md)