docs: add v1.0.0 release notes and package naming

2026-08-05 15:28:29 +08:00
parent 6f07849a53
commit 18db389beb
3 changed files with 74 additions and 10 deletions
@@ -0,0 +1,46 @@
+# Home-Vue-Go v1.0.0
+
+Home-Vue-Go 的首个正式版本，将 Vue 3 前端与 Go 后端整合为可直接部署的单文件应用。
+
+## 主要功能
+
+- Vue 3 + Vite 前端，提供主页、登录页和可视化管理后台。
+- Go + Gin API，使用 Ent ORM 与 SQLite 存储站点配置和业务数据。
+- 支持站点、联系方式、轮换文本和站点外观配置管理。
+- 支持图片上传、JWT 登录认证、密码修改和登录历史记录。
+- 支持本地访问统计以及 Umami 自托管、Umami Cloud 数据源。
+- 前端资源嵌入可执行文件，无需单独部署 Web 静态目录。
+
+## 单端口部署
+
+前端页面、API 和上传文件统一通过一个 HTTP 端口提供服务：
+
+- 默认访问地址：`http://localhost:1552`
+- API 地址：`http://localhost:1552/api`
+- 管理后台：`http://localhost:1552/admin`
+- 可通过 `PORT` 环境变量修改监听端口。
+
+## 下载与运行
+
+请根据系统下载对应安装包：
+
+- `Home-Vue-Go_Windows.zip`
+- `Home-Vue-Go_Linux.tar.gz`
+- `Home-Vue-Go_macOS.tar.gz`
+
+解压后直接运行 `Home-Vue-Go`；Windows 运行 `Home-Vue-Go.exe`。Linux 或 macOS 首次运行前可能需要增加执行权限：
+
+```bash
+chmod +x Home-Vue-Go
+./Home-Vue-Go
+```
+
+首次启动会在程序同级目录创建 `data` 数据目录。默认管理员账号为 `admin`，默认密码为 `admin123`，登录后请立即修改密码。
+
+## 升级与数据
+
+升级前请备份程序同级目录中的 `data` 文件夹。替换可执行文件即可升级，请勿删除原有的数据库和上传文件。
+
+## 构建产物
+
+本版本通过 GitHub Actions 自动测试并构建 Windows、Linux 和 macOS amd64 安装包。所有安装包均包含 README 和与原仓库一致的 MIT 许可证。