docs: add AGENTS.md for coding agents and rewrite README in Vietnamese

Author: nhktmdzhg

AGENTS.md

@@ -0,0 +1,48 @@
+# AGENTS.md
+
+Trang landing của Fcitx5 Lotus — bộ gõ tiếng Việt cho Linux. SPA Vue 3 + Vite + TypeScript, UI tiếng Việt, theme Catppuccin, deploy lên GitHub Pages qua GitHub Actions.
+
+## Tech stack
+
+- Vue 3 (Composition API, `<script setup lang="ts">`)
+- Vite 7, TypeScript, vue-router 4
+- Element Plus (auto-import), oh-vue-icons (`<v-icon>`), Bun
+
+## Lệnh
+
+- Cài đặt: `bun install`
+- Dev: `bun dev`
+- Lint: `bun run lint` / `bun run lint:fix`
+- Type-check: `bun run type-check`
+- Build: `bun run build` / Preview: `bun run preview`
+
+Quan trọng: khi chỉ kiểm tra code, chạy `bun run lint` + `bun run type-check` là đủ — **KHÔNG build**. CI (`ci.yml`) chạy cả 3 khi push.
+
+## Cấu trúc
+
+- `src/views/Home.vue` — layout, chỉ render các section + `initTheme()`.
+- `src/components/` — 8 section (NavBar, HeroSection, FeaturesSection, InstallSection, UsageSection, UninstallSection, ContributorsSection, FooterSection) + reusable (FeatureCard, UsageTable, CodeBlock, UninstallItem, InteractiveInstaller).
+- `src/utils/` — `theme.ts` (useTheme), `github.ts` (useGitHubStats, cache localStorage 2h), `actions.ts` (openLink, copyToClipboard, scroll...).
+- `src/data/` — `installer.ts`, `usage.ts` (dữ liệu hiển thị).
+- `src/assets/shared.css` — reset, theme vars, class dùng chung (non-scoped, import ở main.ts).
+
+## Quy ước
+
+- Mọi text UI bằng tiếng Việt; import alias `@/`; icon qua `el-icon` hoặc `<v-icon name="...">`.
+- State dùng chung giữa section → composable singleton (useTheme/useGitHubStats); không props/emit giữa section.
+- CSS: riêng 1 section → `<style scoped>`; class dùng chung hoặc render bởi component con → `shared.css` (scoped của cha không áp dụng vào con). Override Element Plus dùng `:root .el-*` cho đủ specificity. Không tự thêm CSS mới cho class không có rule (`.flex`, `.mb-0`...).
+- Không sửa tay `components.d.ts` / `auto-imports.d.ts` (generated).
+- Project không có test suite; không thêm test nếu không được yêu cầu.
+
+## Git
+
+- Commit theo Conventional Commits: `feat(...)`, `fix(...)`, `refactor(...)`.
+- Chạy `bun run lint` + `bun run type-check` trước khi commit; chỉ commit khi được yêu cầu.
+
+## Không được làm
+
+- KHÔNG build khi chỉ kiểm tra code.
+- KHÔNG đổi logic/hành vi khi refactor (giao diện phải y hệt).
+- KHÔNG sửa text hiển thị trừ khi được yêu cầu.
+- KHÔNG thêm dependency mới mà chưa hỏi.
+- KHÔNG commit secrets.

README.md

@@ -1,42 +1,42 @@
-# fcitx5-lotus-landing
+# Fcitx5 Lotus — Trang chủ
 
-This template should help get you started developing with Vue 3 in Vite.
+Trang web giới thiệu và hướng dẫn cài đặt cho [Fcitx5 Lotus](https://github.com/LotusInputMethod/fcitx5-lotus) — bộ gõ tiếng Việt hiện đại, hiệu năng cao cho Linux.
 
-## Recommended IDE Setup
+Trang chủ trực tiếp tại: https://lotusinputmethod.github.io/
 
-[VS Code](https://code.visualstudio.com/) + [Vue (Official)](https://marketplace.visualstudio.com/items?itemName=Vue.volar) (and disable Vetur).
+## Tính năng trang web
 
-## Recommended Browser Setup
+- Hero động với terminal mockup + thống kê GitHub (stars, contributors, phiên bản).
+- Installer tương tác: chọn distro/DE/shell/init → hướng dẫn cài đặt tương ứng.
+- Hướng dẫn sử dụng (tabs): cài đặt nhanh, cài đặt nâng cao, chế độ gõ, mẹo hay.
+- Hướng dẫn gỡ cài đặt theo từng distro.
+- Danh sách contributor tải từ GitHub (cache 2 giờ).
 
-- Chromium-based browsers (Chrome, Edge, Brave, etc.):
-  - [Vue.js devtools](https://chromewebstore.google.com/detail/vuejs-devtools/nhdogjmejiglipccpnnnanhbledajbpd)
-  - [Turn on Custom Object Formatter in Chrome DevTools](http://bit.ly/object-formatters)
-- Firefox:
-  - [Vue.js devtools](https://addons.mozilla.org/en-US/firefox/addon/vue-js-devtools/)
-  - [Turn on Custom Object Formatter in Firefox DevTools](https://fxdx.dev/firefox-devtools-custom-object-formatters/)
+## Tech stack
 
-## Type Support for `.vue` Imports in TS
+Vue 3 · Vite · TypeScript · Element Plus · oh-vue-icons · Bun · GitHub Pages
 
-TypeScript cannot handle type information for `.vue` imports by default, so we replace the `tsc` CLI with `vue-tsc` for type checking. In editors, we need [Volar](https://marketplace.visualstudio.com/items?itemName=Vue.volar) to make the TypeScript language service aware of `.vue` types.
+## Phát triển
 
-## Customize configuration
-
-See [Vite Configuration Reference](https://vite.dev/config/).
-
-## Project Setup
+Yêu cầu: Node ≥ 20.19 (hoặc Bun).
 
 ```sh
-bun install
+bun install          # cài phụ thuộc
+bun dev              # chạy dev server
+bun run lint         # kiểm tra eslint
+bun run type-check   # kiểm tra TypeScript
+bun run build        # build production
+bun run preview      # xem bản build
 ```
 
-### Compile and Hot-Reload for Development
+## Triển khai
 
-```sh
-bun dev
-```
+Push lên nhánh `main` → GitHub Actions (`deploy.yml`) tự build và deploy lên GitHub Pages.
 
-### Type-Check, Compile and Minify for Production
+## Đóng góp
 
-```sh
-bun run build
-```
+Mọi đóng góp đều được hoan nghênh — xem [CONTRIBUTING](https://github.com/LotusInputMethod/fcitx5-lotus/blob/main/CONTRIBUTING.md) của dự án chính.
+
+## Giấy phép
+
+GNU General Public License v3.0 — xem [LICENSE](LICENSE).