From 9daaf7f403db6fa05a2d9639285fd8bcdb23e520 Mon Sep 17 00:00:00 2001
From: opsx <opsx@local>
Date: Thu, 29 Oct 2026 13:28:23 +0800
Subject: [PATCH] =?UTF-8?q?docs:=20CHANGELOG=20=E8=90=BD=E5=9C=B0=E4=B8=8E?=
 =?UTF-8?q?=E5=8F=91=E5=B8=83=E6=B5=81=E7=A8=8B=E8=AF=B4=E6=98=8E?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 CHANGELOG.md | 39 +++++++++++++++++++++++++++++++++++++++
 1 file changed, 39 insertions(+)
 create mode 100644 CHANGELOG.md

diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
index 0000000..a04b52a
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,39 @@
+# 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]
+
+## [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 时期)。