diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4ace7b0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,68 @@
+# 白荼个人主页 (BaiTu Homepage)
+
+这是一个简约风格的个人主页项目，采用纯 HTML/CSS/JavaScript 构建，旨在展示个人信息、开发作品、常用工具以及生活随笔。
+
+## 项目特点
+
+- **信纸风格**：独特的信纸视觉设计，营造“见字如面”的沉浸式阅读体验。
+- **极简主义**：采用纯 HTML/CSS/JavaScript 构建，无繁重框架，加载迅速。
+- **多语言支持**：内置中英文切换功能，满足不同访问者的需求。
+- **动态内容**：
+  - **闲言碎语**：通过 Memos API 实时同步生活点滴。
+  - **历史足迹**：基于 ECharts 的交互式地图，记录走过的城市。
+  - **我的网站/工具/游戏**：动态加载并展示个人作品集和常用资源。
+- **交互体验**：
+  - 全局搜索功能（支持 Google, Baidu, DuckDuckGo, Yandex）。
+  - 留言板与博客文章预览弹窗。
+  - “旅途剪影”相册模块，支持瀑布流展示与图片轮播。
+- **性能优化**：使用 Nginx 缓存静态资源，集成 Umami 进行轻量级数据统计。
+
+## 快速开始
+
+1. **克隆仓库**
+   ```bash
+   git clone https://github.com/dellevin/iletter-homepage.git
+   cd iletter-homepage
+   ```
+
+2. **本地运行**
+   由于项目包含一些动态数据加载（如 Memos 接口），建议在本地服务器环境下运行。你可以使用 Python 快速启动一个简易服务器：
+   ```bash
+   python -m http.server 8080
+   ```
+   然后在浏览器中访问 `http://localhost:8080`。
+
+## 目录结构
+
+```text
+.
+├── static/
+│   ├── css/          # 样式文件
+│   ├── js/           # JavaScript 逻辑（含多语言配置）
+│   ├── img/          # 图片资源（含相册、图标等）
+│   └── font/         # 字体文件
+├── scripts/          # 自动化脚本（如照片索引生成）
+├── index.html        # 主页面入口
+└── README.md         # 项目说明
+```
+
+## 技术栈
+
+- **前端核心**：HTML5, CSS3, Vanilla JavaScript
+- **图表库**：ECharts (用于地图足迹可视化)
+- **网络请求**：Axios
+- **后端接口**：Memos API (闲言碎语), 自建评论系统
+- **统计与防护**：Umami, 堡塔云 WAF
+
+## 人生相册自动化
+
+项目包含 `scripts/generate-photos-json.py` 脚本，用于自动扫描 `static/img/photos/` 目录并生成 `photos.json` 索引文件，方便前端快速加载最新照片。
+
+## 贡献与反馈
+
+如果你对项目有任何建议或发现了 Bug，欢迎在 [GitHub Issues](https://github.com/dellevin/iletter-homepage/issues) 中提出。
+
+## 许可证
+
+本项目仅供学习交流使用。
+
diff --git a/static/js/language/en.js b/static/js/language/en.js
index 5f2ebb8..44930c0 100644
--- a/static/js/language/en.js
+++ b/static/js/language/en.js
@@ -17,7 +17,7 @@ const translationsEN = {
   about_me_p2:
     'My hobbies usually involve playing games, reading books, watching anime, and I prefer staying indoors. I hate repetitive and simple work, so I often write small tools to make life easier because laziness drives my productivity. I frequently lurk on various forums and blogs, shouting "666" or "Amazing" under tech bloggers. My own blog updates sporadically, mainly recording daily life notes and technical challenges encountered.',
   about_me_p3:
-    'This site follows a minimalist style, using pure HTML. Umami tracks UV/PV at the bottom. The Memos section uses the Memos API. It also employs Baota Cloud WAF protection and nginx caching for static resources. If you are interested, you can directly download the source code from <a href="https://gitea.iletter.top/dellevin/BaiTu-homepage" target="_blank">https://gitea.iletter.top/dellevin/BaiTu-homepage </a> and use it, or through F12 view website source code download.',
+    'This site follows a minimalist style, using pure HTML. Umami tracks UV/PV at the bottom. The Memos section uses the Memos API. It also employs Baota Cloud WAF protection and nginx caching for static resources. If you are interested, you can directly download the source code from <a href="https://github.com/dellevin/iletter-homepage" target="_blank">https://github.com/dellevin/iletter-homepage </a> and use it, or through F12 view website source code download.',
   about_me_p4:
     "As a 99er programmer, I am glad to still have great passion for technology after starting work! If you share the same interest in technology, I would love to meet you! Let's progress and grow together!",
   // 联系方式
diff --git a/static/js/language/zh.js b/static/js/language/zh.js
index 8067aeb..0364593 100644
--- a/static/js/language/zh.js
+++ b/static/js/language/zh.js
@@ -17,7 +17,7 @@ const translationsZH = {
   about_me_p2:
     '平时的爱好也就是玩玩游戏，看看书，刷刷动漫，不爱出门，肥宅一个。讨厌重复简单的工作，会想办法偷懒写写自己的顺手的小工具什么的，毕竟懒惰是我的生产力。我也经常混迹于各大网络论坛博客并在各个技术博主下面直呼"大佬666"、"大佬牛牛牛"。自己的博客也在断断续续中更新。主要是记录生活随笔和碰到的技术难题。',
   about_me_p3:
-    '本站秉承简约风格，采用纯HTML，Umami做网站底部的uv/pv ，闲言碎语模块使用memos接口。同时使用堡塔云WAF防护，nginx缓存加速网站静态资源。如果您有兴趣，可以直接下载本站的 <a href="https://gitea.iletter.top/dellevin/BaiTu-homepage" target="_blank">https://gitea.iletter.top/dellevin/BaiTu-homepage </a> 并使用，或者通过F12查看网站源代码下载。',
+    '本站秉承简约风格，采用纯HTML，Umami做网站底部的uv/pv ，闲言碎语模块使用memos接口。同时使用堡塔云WAF防护，nginx缓存加速网站静态资源。如果您有兴趣，可以直接下载本站的 <a href="https://github.com/dellevin/iletter-homepage" target="_blank">https://github.com/dellevin/iletter-homepage </a> 并使用，或者通过F12查看网站源代码下载。',
   about_me_p4:
     "作为一个99年的码农，很庆幸我在工作之后还对技术有着极大的热情！如果你也对技术有着同样的兴趣，也很希望认识你！一同进步共同成长！",