# Changelog

本项目遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.1.0/) 格式,版本号遵循语义化版本。
发布流程:合入 main → 更新本文件 Unreleased 段 → `git tag -a vX.Y.Z -m "..." && git push origin vX.Y.Z` → `make build`(版本号自动注入二进制与 /api/v1/health)。

## [Unreleased]

### 移除
- 备份恢复功能(含 API / CLI / 手册):日志数据本体的保留与安全由对象存储与 Loki retention 承担,平台侧备份价值有限
- 平台监控页与 `/api/v1/system/metrics-summary`:原始指标仍经标准 `/api/v1/metrics`(Prometheus 文本格式)暴露,可自行抓取
- 资源用量弹窗的可选 Prometheus 接入(峰值/限流查询):统一以「未接入 Prometheus:暂无峰值/限流数据」提示,扩容建议基于 metrics-server 实时值

### 新增
- 一键安装脚本(quick_start.sh):bash -c "$(curl …)" 对标 1Panel/雷池体验——架构自检、发布包下载、
  随机密钥生成、systemd 开机自启、升级幂等(数据自动备份),完成后打印访问地址与初始密码
  (10.10.10.161 CentOS 7 真机验证安装/登录/升级/文档落地页全通);配套 upload-release.sh 发布双架构包到 Gitea Release
- 落地页(homepage/,`/homepage` 访问):产品介绍、特性、快速开始
- 用户手册文档站(docsify,`/docs` 访问):安装、部署向导、采集、查询、分析、告警、授权、备份、FAQ 十篇

## [2.0.0] - 2026-10-29

品牌从 opsxloki 正式更名为 LokiStack,平台能力全面成型。

### 安全
- 修复 Loki 版本号 SSH 命令注入(严格 `^\d+.\d+.\d+$` 校验并覆盖更新路径)
- 采集敏感路径防护覆盖默认 LogPath 与创建入口(/etc/shadow 等不可绕过)
- 数据文件损坏时备份留档后再空库启动,不再静默覆盖可恢复数据

### 可靠性
- 停止/重启部署不再删除 loki-data PVC(filesystem 存储日志数据保留)
- 采集器安装/卸载并发去重(重复点击不再互踩 docker rm/run)
- 备份恢复替换文件后立即重载内存态,消除旧内存覆盖恢复文件的竞态
- 审计页过滤防抖 + 取消;向导自动部署精确瞄准新实例;路由级错误边界
- Live Tail 重构:输入防抖、轮询可取消、乱序响应丢弃

### 功能
- 新增「日志分析」页(admin):统计卡/趋势折线/命名空间饼图/应用流图/每日日志量/Top10 排行/Ingress 访问分析(自动加载,无 ingress 自动折叠)
- 新增 `POST /logs/metrics` LogQL 指标代理(多序列,`[$step]` 自适应)
- 快捷查询:选中 App/Pod 即插入并执行;Ingress 按钮按选择条件显示
- /logs 结果区收敛为原始日志视图;数据源管理与查询授权页专业化改版
- 内置告警规则默认启用并绑定默认通道,配好 Webhook 即收告警
- 告警规则清理历史误种的 Kubernetes 基础设施类(节点 NotReady/OOMKilled)

### 工程化
- Gitea Actions CI 门禁(后端 gofmt/golangci-lint/vet/test + 前端 lint/test/build)
- 前端测试设施落地(vitest,14 个命脉用例);golangci-lint v2 归零
- 版本注入链路修复(build/Dockerfile → main.version → /health,前端对齐)
- 全站中英文文案审校精简;shadcn 样板汉化;历史数据文件自动迁移为 lokistack.json

## [1.x 及更早]
见 git 历史(opsxloki 时期)。