docs: 更新readme.md

This commit is contained in:
2026-01-07 00:29:05 +08:00
parent cf751c4c28
commit 04c0c3cae5

View File

@@ -5,7 +5,8 @@
## 功能特性
- ✅ 管理员登录密码admin123
- ✅ App上传支持.apk、.ipa、.zip文件最大100MB
- ✅ App上传支持.apk、.ipa、.zip文件最大1GB
- ✅ App删除功能
- ✅ 无需登录即可下载
- ✅ 响应式设计
- ✅ 纯前端实现,无框架依赖
@@ -13,7 +14,16 @@
## 快速开始
### 1. 启动端服务
### 1. 启动端服务
```bash
cd background
go run main.go
```
后端服务将在 http://localhost:6903 上运行
### 2. 启动前端服务
```bash
# 使用Python启动简单HTTP服务器
@@ -27,7 +37,7 @@ npx http-server -p 8000
#### 后端要求
- 端口3000
- 端口:6903 (修改自默认的3000端口)
- 无需鉴权
- 支持CORS跨域请求
@@ -35,19 +45,28 @@ npx http-server -p 8000
| 方法 | 路径 | 描述 | 请求体 | 响应 |
|------|------|------|--------|------|
| GET | /api/apps | 获取App列表 | - | `[{id: string, name: string, fileName: string, date: string}]` |
| GET | /api/apps | 获取App列表 | - | `[{id: string, name: string, fileName: string, date: string, filePath: string}]` |
| POST | /api/apps | 上传App | multipart/form-data<br>`name`: App名称<br>`file`: 文件 | `{success: boolean, message?: string}` |
| DELETE | /api/apps/:id | 删除指定App | - | `{success: boolean, message?: string}` |
| GET | /api/apps/:id | 下载指定App | - | 文件流 |
| GET | /api/docs | 获取文档内容 | - | `[{docBody: string}]` |
## 技术栈
- HTML5
- CSS3
- JavaScript (ES6+)
- Go (后端)
- Gin (Web框架)
## 文件结构
```
├── background/ # 后端目录
│ ├── main.go # 后端主程序
│ ├── apps.json # 应用数据持久化文件
│ ├── files/ # 存储上传的文件
│ └── docs/ # 存储文档文件
├── index.html # 主页面
├── style.css # 样式文件
├── script.js # 核心逻辑
@@ -74,6 +93,12 @@ npx http-server -p 8000
1. 在下载区域找到要下载的App
2. 点击"下载"按钮即可开始下载
### 删除App
1. 点击App列表中的"删除"按钮
2. 在确认对话框中点击"确定"
3. App将从列表和服务器中被删除
## 自定义配置
### 修改管理员密码
@@ -92,10 +117,24 @@ const ADMIN_PASSWORD = 'your_new_password';
const API_BASE_URL = 'http://your-backend-url:port/api';
```
### 修改后端端口
`background/main.go` 中修改:
```go
port = ":6903" // 修改为你想要的端口
```
## 数据持久化
- 应用列表数据保存在 `background/apps.json` 文件中
- 上传的文件保存在 `background/files/` 目录中
- 文档内容保存在 `background/docs/` 目录中
## 注意事项
1. 默认使用localStorage存储数据只保存在浏览器中
2. 建议部署后端API以实现持久化存储
1. 默认使用localStorage存储登录状态,数据只保存在浏览器中
2. 应用数据持久化在后端的apps.json文件中
3. 生产环境中请修改默认密码
4. 建议添加HTTPS支持尤其是在公网环境中