docs: enhance README with detailed usage instructions and examples

Author: luckfunc

README.md

@@ -2,29 +2,81 @@ English | [中文](./README_zh.md)
 
 # Resource Saving Script
 
-A simple but powerful Node.js script that runs a local web server and automatically downloads missing resources.
+A Node.js tool for local development that starts a local server while automatically fetching missing remote resource files.
 
-### Global Installation
+## Table of Contents
+
+- [Installation](#installation)
+- [Usage](#usage)
+- [How It Works](#how-it-works)
+- [Usage Example](#usage-example)
+- [Use Cases](#use-cases)
+
+## Installation
 
 ```bash
 npm install -g resource-save-script
 ```
 
-### Usage
+## Usage
 
-Once installed, you can use the `h` command in your terminal.
+Once installed, use the `h` command in your terminal:
 
 ```bash
-# Run on a custom port (e.g., 8080)
+# Run on a custom port
 h 8080
 
-# Run on the default port (4000)
+# Run on the default port 4000
 h
 ```
 
-After running the command, the script will prompt you to enter the base URL of the remote server where the resources are located.
+You'll be prompted to enter the remote server URL:
 
 ```text
 → Please enter the base URL for resources: https://your-remote-server.com
 ```
-The local server will then start, and any missing files will be downloaded automatically.
+
+## How It Works
+
+The script monitors 404 requests on the local server. When a missing file is detected, it automatically downloads the file from the specified remote server to your local directory.
+
+## Usage Example
+
+Let's say you want to debug a page from `luckfunc.com` locally:
+
+**1. Create and enter project directory**
+```bash
+mkdir my-project
+cd my-project
+```
+
+**2. Download the main page**
+```bash
+curl -o index.html https://luckfunc.com/
+```
+
+**3. Start the script in your project directory**
+```bash
+h
+# Enter: https://luckfunc.com/
+```
+
+**4. Access the page**
+
+Open your browser and visit `http://127.0.0.1:4000/index.html`
+
+When the page loads, if it references local files like `i18n.js` that don't exist, the script will automatically download them from `luckfunc.com` to your local directory.
+
+Terminal output will show download progress:
+```text
+Missing file detected: /i18n.js
+Download complete: /path/to/your/project/i18n.js (1234 bytes)
+```
+
+Refresh the page and all resources will load properly.
+
+## Use Cases
+
+- Local debugging of live websites
+- Setting up offline development environments
+- Bulk downloading of static resources

README_zh.md

@@ -2,29 +2,81 @@
 
 # 资源保存脚本
 
-一个简单但功能强大的 Node.js 脚本，可以运行一个本地 Web 服务器并自动下载缺失的资源。
+一个用于本地开发的 Node.js 工具，启动本地服务器的同时自动抓取缺失的远程资源文件。
 
-### 全局安装
+## 目录
+
+- [安装](#安装)
+- [使用](#使用)
+- [工作原理](#工作原理)
+- [使用场景示例](#使用场景示例)
+- [适用场景](#适用场景)
+
+## 安装
 
 ```bash
 npm install -g resource-save-script
 ```
 
-### 使用方法
+## 使用
 
-安装后，您可以在终端中使用 `h` 命令。
+安装完成后，在终端中使用 `h` 命令启动：
 
 ```bash
-# 使用自定义端口 (例如 8080)
+# 指定端口号
 h 8080
 
-# 使用默认端口 (4000)
+# 使用默认端口 4000
 h
 ```
 
-运行命令后，脚本将提示您输入存放资源的远程服务器的基础 URL。
+启动时会提示输入远程服务器地址：
 
 ```text
 → 请输入资源所在的根 URL: https://your-remote-server.com
 ```
-之后本地服务器将启动，并自动下载任何缺失的文件。
+
+## 工作原理
+
+脚本会监听本地服务器的 404 请求，当检测到缺失文件时自动从指定的远程服务器下载到本地。
+
+## 使用场景示例
+
+假设你想在本地调试 `luckfunc.com` 的页面：
+
+**1. 创建并进入项目目录**
+```bash
+mkdir my-project
+cd my-project
+```
+
+**2. 下载主页面**
+```bash
+curl -o index.html https://luckfunc.com/
+```
+
+**3. 在项目目录下启动脚本**
+```bash
+h
+# 输入: https://luckfunc.com/
+```
+
+**3. 访问页面**
+
+打开浏览器访问 `http://127.0.0.1:4000/index.html`
+
+当页面加载时，如果引用了本地不存在的 `i18n.js` 等文件，脚本会自动从 `luckfunc.com` 下载这些文件到本地目录。
+
+终端会显示下载进度：
+```text
+检测到缺失文件: /i18n.js
+下载完成: /path/to/your/project/i18n.js (1234 bytes)
+```
+
+再次刷新页面，所有资源都能正常加载了。
+
+## 适用场景
+
+- 本地调试线上页面
+- 离线开发环境搭建
+- 静态资源批量下载