diff --git a/.gitignore b/.gitignore
new file mode 100644
index 0000000..d600b6c
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,25 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+pnpm-debug.log*
+lerna-debug.log*
+
+node_modules
+dist
+dist-ssr
+*.local
+
+# Editor directories and files
+.vscode/*
+!.vscode/extensions.json
+.idea
+.DS_Store
+*.suo
+*.ntvs*
+*.njsproj
+*.sln
+*.sw?
+
diff --git a/BUILD_TROUBLESHOOTING.md b/BUILD_TROUBLESHOOTING.md
new file mode 100644
index 0000000..6f0009e
--- /dev/null
+++ b/BUILD_TROUBLESHOOTING.md
@@ -0,0 +1,118 @@
+# ZAPlayer 构建故障排除指南
+
+## 常见问题解决
+
+### 1. Terser 依赖错误
+
+**错误信息：**
+```
+error during build: [vite:terser] terser not found. Since Vite v3, terser has become an optional dependency. You need to install it.
+```
+
+**解决方案：**
+
+#### 方案A：使用简化构建（推荐）
+```bash
+# 使用不需要terser的简化配置
+npm run build:simple
+```
+
+#### 方案B：安装terser依赖
+```bash
+# 安装terser依赖
+npm run install:terser
+
+# 然后正常构建
+npm run build:min
+```
+
+#### 方案C：手动安装terser
+```bash
+npm install --save-dev terser
+npm run build:min
+```
+
+### 2. 构建配置选择
+
+我们提供了多个构建配置：
+
+| 配置文件 | 用途 | 特点 |
+|----------|------|------|
+| `vite.lib.simple.config.js` | 简化构建 | 使用Vite内置压缩，无需额外依赖 |
+| `vite.lib.config.js` | 高级构建 | 使用terser，压缩效果更好 |
+
+### 3. 构建输出文件
+
+成功构建后，会在 `dist/` 目录下生成：
+- `za-player.min.js` - UMD格式，浏览器使用
+- `za-player.es.js` - ES模块格式，现代项目使用
+
+### 4. 验证构建结果
+
+构建完成后，可以通过以下方式验证：
+
+#### 检查文件是否存在
+```bash
+ls -la dist/
+# Windows: dir dist\
+```
+
+#### 检查文件大小
+```bash
+# 查看文件大小（应该有一定压缩）
+wc -c dist/za-player.min.js
+wc -c dist/za-player.es.js
+```
+
+#### 测试功能
+打开 `test-build.html` 文件，在浏览器中测试两个构建文件是否正常工作。
+
+### 5. 快速开始（推荐流程）
+
+```bash
+# 1. 安装依赖
+npm install
+
+# 2. 使用简化构建（避免terser问题）
+npm run build:simple
+
+# 3. 验证构建结果
+ls dist/
+# 应该看到 za-player.min.js 和 za-player.es.js
+
+# 4. 测试功能
+# 在浏览器中打开 test-build.html
+```
+
+### 6. 如果仍然有问题
+
+1. **清除node_modules并重新安装：**
+ ```bash
+ rm -rf node_modules package-lock.json
+ npm install
+ ```
+
+2. **检查Node.js版本：**
+ ```bash
+ node --version
+ # 建议使用 Node.js 16+
+ ```
+
+3. **检查Vite版本：**
+ ```bash
+ npm list vite
+ ```
+
+4. **查看详细错误信息：**
+ ```bash
+ npm run build:simple -- --debug
+ ```
+
+### 7. 获取帮助
+
+如果以上方法都不能解决问题，请提供以下信息：
+1. 完整的错误信息
+2. Node.js版本 (`node --version`)
+3. npm版本 (`npm --version`)
+4. 操作系统信息
+5. 使用的构建命令
\ No newline at end of file
diff --git a/README.md b/README.md
index cae1c3a..b04056d 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,176 @@
-# ZAPlayer
+# ZAPlayer 使用说明
-ZAPlayer是一个支持HLS(M3U8)和FLV格式的视频播放器类库。
\ No newline at end of file
+ZAPlayer是一个支持HLS(M3U8)和FLV格式的视频播放器类库。
+
+## 快速开始
+
+### 方法1：直接引用构建好的类库文件
+
+1. 首先构建类库文件：
+```bash
+npm run build:min
+```
+
+2. 构建完成后，会在 `dist/` 目录下生成两个文件：
+ - `za-player.min.js` - 压缩后的UMD格式，适合浏览器直接使用
+ - `za-player.es.js` - ES模块格式，适合现代JavaScript项目
+
+3. 在HTML文件中引用（浏览器使用）：
+```html
+
+
+
+ ZAPlayer 示例
+
+
+
+
+
+
+
+
+
+
+
+```
+
+### 方法2：使用ES模块
+
+```html
+
+
+
+ ZAPlayer ES模块示例
+
+
+
+
+
+
+
+```
+
+### 方法3：在Node.js或现代前端项目中使用ES模块
+
+```javascript
+// 使用ES模块导入
+import ZAPlayer from './dist/za-player.es.js';
+
+// 创建播放器
+const player = new ZAPlayer('#container', {
+ type: 'flv',
+ src: 'video.flv'
+});
+
+player.player.play();
+```
+
+### 方法4：动态加载（浏览器版本）
+
+```javascript
+// 动态加载ZAPlayer类库
+function loadZAPlayer(callback) {
+ const script = document.createElement('script');
+ script.src = 'dist/za-player.min.js'; // 使用压缩版本
+ script.onload = callback;
+ document.head.appendChild(script);
+}
+
+// 使用动态加载的类库
+loadZAPlayer(function() {
+ const player = new ZAPlayer('#videoContainer', {
+ type: 'flv',
+ src: 'your-video-url.flv'
+ });
+
+ player.player.play();
+});
+```
+
+## API 说明
+
+### 构造函数
+```javascript
+new ZAPlayer(container, options)
+```
+
+**参数：**
+- `container` (string|Element): 视频容器的选择器字符串或DOM元素
+- `options` (object): 配置选项
+ - `type` (string): 视频类型，'hls' 或 'flv'，默认为 'hls'
+ - `src` (string, 可选): 视频地址，可以在创建后通过load方法加载
+
+**返回值：**
+- 返回一个对象，包含player属性，player对象有以下方法：
+ - `play()`: 播放视频
+ - `pause()`: 暂停视频
+ - `stop()`: 停止视频
+ - `load(url)`: 加载新的视频地址
+
+## 示例视频地址
+
+### FLV格式
+```javascript
+// 示例FLV地址
+player.player.load('http://192.168.1.200:10037/live/PUGE0hFBYluVe_01.flv');
+```
+
+### HLS(M3U8)格式
+```javascript
+// 示例HLS地址
+player.player.load('http://192.168.1.201:9080/DS-2CD5026FWD20180811AACH220809006/0000000B/hls.m3u8');
+```
+
+## 浏览器兼容性
+
+- 支持现代浏览器的Media Source Extensions (MSE)
+- 支持WebCodecs API（用于高级解码）
+- 支持Fetch API
+
+## 注意事项
+
+1. 确保视频地址支持跨域访问（CORS）
+2. 对于直播流，确保服务器支持持续的数据传输
+3. 某些浏览器可能需要HTTPS协议才能正常工作
+
+## 构建说明
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式
+npm run dev
+
+# 构建演示页面
+npm run build
+
+# 构建类库文件（同时生成两个文件）
+npm run build:min
+```
+
+构建完成后，类库文件会在`dist/`目录下生成：
+- `za-player.min.js` - 压缩后的UMD格式类库文件，适合浏览器直接使用
+- `za-player.es.js` - ES模块格式，适合现代JavaScript项目和打包工具
\ No newline at end of file
diff --git a/USAGE.md b/USAGE.md
new file mode 100644
index 0000000..b04056d
--- /dev/null
+++ b/USAGE.md
@@ -0,0 +1,176 @@
+# ZAPlayer 使用说明
+
+ZAPlayer是一个支持HLS(M3U8)和FLV格式的视频播放器类库。
+
+## 快速开始
+
+### 方法1：直接引用构建好的类库文件
+
+1. 首先构建类库文件：
+```bash
+npm run build:min
+```
+
+2. 构建完成后，会在 `dist/` 目录下生成两个文件：
+ - `za-player.min.js` - 压缩后的UMD格式，适合浏览器直接使用
+ - `za-player.es.js` - ES模块格式，适合现代JavaScript项目
+
+3. 在HTML文件中引用（浏览器使用）：
+```html
+
+
+
+ ZAPlayer 示例
+
+
+
+
+
+
+
+
+
+
+
+```
+
+### 方法2：使用ES模块
+
+```html
+
+
+
+ ZAPlayer ES模块示例
+
+
+
+
+
+
+
+```
+
+### 方法3：在Node.js或现代前端项目中使用ES模块
+
+```javascript
+// 使用ES模块导入
+import ZAPlayer from './dist/za-player.es.js';
+
+// 创建播放器
+const player = new ZAPlayer('#container', {
+ type: 'flv',
+ src: 'video.flv'
+});
+
+player.player.play();
+```
+
+### 方法4：动态加载（浏览器版本）
+
+```javascript
+// 动态加载ZAPlayer类库
+function loadZAPlayer(callback) {
+ const script = document.createElement('script');
+ script.src = 'dist/za-player.min.js'; // 使用压缩版本
+ script.onload = callback;
+ document.head.appendChild(script);
+}
+
+// 使用动态加载的类库
+loadZAPlayer(function() {
+ const player = new ZAPlayer('#videoContainer', {
+ type: 'flv',
+ src: 'your-video-url.flv'
+ });
+
+ player.player.play();
+});
+```
+
+## API 说明
+
+### 构造函数
+```javascript
+new ZAPlayer(container, options)
+```
+
+**参数：**
+- `container` (string|Element): 视频容器的选择器字符串或DOM元素
+- `options` (object): 配置选项
+ - `type` (string): 视频类型，'hls' 或 'flv'，默认为 'hls'
+ - `src` (string, 可选): 视频地址，可以在创建后通过load方法加载
+
+**返回值：**
+- 返回一个对象，包含player属性，player对象有以下方法：
+ - `play()`: 播放视频
+ - `pause()`: 暂停视频
+ - `stop()`: 停止视频
+ - `load(url)`: 加载新的视频地址
+
+## 示例视频地址
+
+### FLV格式
+```javascript
+// 示例FLV地址
+player.player.load('http://192.168.1.200:10037/live/PUGE0hFBYluVe_01.flv');
+```
+
+### HLS(M3U8)格式
+```javascript
+// 示例HLS地址
+player.player.load('http://192.168.1.201:9080/DS-2CD5026FWD20180811AACH220809006/0000000B/hls.m3u8');
+```
+
+## 浏览器兼容性
+
+- 支持现代浏览器的Media Source Extensions (MSE)
+- 支持WebCodecs API（用于高级解码）
+- 支持Fetch API
+
+## 注意事项
+
+1. 确保视频地址支持跨域访问（CORS）
+2. 对于直播流，确保服务器支持持续的数据传输
+3. 某些浏览器可能需要HTTPS协议才能正常工作
+
+## 构建说明
+
+```bash
+# 安装依赖
+npm install
+
+# 开发模式
+npm run dev
+
+# 构建演示页面
+npm run build
+
+# 构建类库文件（同时生成两个文件）
+npm run build:min
+```
+
+构建完成后，类库文件会在`dist/`目录下生成：
+- `za-player.min.js` - 压缩后的UMD格式类库文件，适合浏览器直接使用
+- `za-player.es.js` - ES模块格式，适合现代JavaScript项目和打包工具
\ No newline at end of file
diff --git a/index.html b/index.html
new file mode 100644
index 0000000..50d1660
--- /dev/null
+++ b/index.html
@@ -0,0 +1,66 @@
+
+
+
+
+
+
+ qhlsplayer
+
+
+
+
+
+
ZAPlayer
+
+
+
+
+
+
+
+
+
+
+
ZAPlayer 构建文件测试
+
+
+
测试1：UMD格式 (za-player.min.js)
+
+
+
+
测试2：ES模块格式 (za-player.es.js)
+
+
+