diff --git a/README.md b/README.md
index 9d1a730..c80eb2a 100644
--- a/README.md
+++ b/README.md
@@ -1,30 +1,81 @@
-# Frontend 2FA tool
+# 2FA Authenticator / 两步验证器
 
-*Automatically synced with your [v0.app](https://v0.app) deployments*
+一个纯前端的 TOTP 两步验证工具，支持多种添加令牌方式，数据完全存储在本地浏览器中。
 
-[![Deployed on Vercel](https://img.shields.io/badge/Deployed%20on-Vercel-black?style=for-the-badge&logo=vercel)](https://vercel.com/kdaugh14-4907s-projects/v0-frontend-2-fa-tool)
-[![Built with v0](https://img.shields.io/badge/Built%20with-v0.app-black?style=for-the-badge)](https://v0.app/chat/cHtdgE8H6EW)
+A pure frontend TOTP two-factor authentication tool with multiple token import methods. All data is stored locally in your browser.
 
-## Overview
+## Features / 功能特性
 
-This repository will stay in sync with your deployed chats on [v0.app](https://v0.app).
-Any changes you make to your deployed app will be automatically pushed to this repository from [v0.app](https://v0.app).
+- **多种添加方式** - 手动输入密钥、扫描二维码、上传二维码图片
+- **高级设置** - 支持 SHA-1/256/512 算法、6/8位验证码、30/60秒刷新周期
+- **完整编辑** - 可编辑令牌的所有信息（名称、发行者、密钥、算法等）
+- **一键复制** - 点击验证码即可复制，带视觉反馈
+- **数据管理** - 支持导入/导出备份（JSON格式）
+- **去重检测** - 自动检测重复令牌
+- **主题切换** - 支持亮色/暗色/跟随系统三种主题
+- **多语言** - 支持中文/英文切换
+- **纯前端** - 无需后端，数据存储在浏览器 localStorage
+- **静态部署** - 支持导出为静态文件部署到任意平台
 
-## Deployment
+## Tech Stack / 技术栈
 
-Your project is live at:
+- Next.js 15
+- React 19
+- TypeScript
+- Tailwind CSS
+- shadcn/ui
+- jsQR (二维码识别)
 
-**[https://vercel.com/kdaugh14-4907s-projects/v0-frontend-2-fa-tool](https://vercel.com/kdaugh14-4907s-projects/v0-frontend-2-fa-tool)**
+## Environment Variables / 环境变量
 
-## Build your app
+所有环境变量均为可选配置：
 
-Continue building your app on:
+| 变量名 | 说明 | 示例值 |
+|--------|------|--------|
+| `NEXT_PUBLIC_SHOW_FOOTER` | 是否显示页脚（默认隐藏） | `true` |
+| `NEXT_PUBLIC_FOOTER_COPYRIGHT` | 版权所有者名称 | `Simon` |
+| `NEXT_PUBLIC_ICP_NUMBER` | ICP备案号（完整文本） | `滇ICP备2025074424号` |
+| `NEXT_PUBLIC_PSB_NUMBER` | 公安备案号（完整文本） | `滇公网安备53250402000233号` |
 
-**[https://v0.app/chat/cHtdgE8H6EW](https://v0.app/chat/cHtdgE8H6EW)**
+## Deployment / 部署
 
-## How It Works
+### Vercel
 
-1. Create and modify your project using [v0.app](https://v0.app)
-2. Deploy your chats from the v0 interface
-3. Changes are automatically pushed to this repository
-4. Vercel deploys the latest version from this repository
+直接导入 GitHub 仓库即可，无需额外配置。
+
+### 静态部署（阿里云 ESA / Cloudflare Pages 等）
+
+项目已配置为静态导出模式，构建后会生成 `out` 目录。
+
+**构建配置：**
+
+```
+安装命令：npm install
+构建命令：npm run build
+静态资源目录：out
+Node.js 版本：20.x 或 22.x
+```
+
+### 本地开发
+
+```bash
+# 安装依赖
+npm install
+
+# 启动开发服务器
+npm run dev
+
+# 构建
+npm run build
+```
+
+## Security / 安全说明
+
+- 所有令牌数据仅存储在浏览器本地 localStorage 中
+- 不会向任何服务器发送数据
+- 建议定期导出备份以防数据丢失
+- 导出的 JSON 文件包含敏感密钥信息，请妥善保管
+
+## License / 许可证
+
+MIT