# 更新日志

本文档记录项目的所有重要更改。

格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。

## [未发布]

### 计划中
- 属性基础测试（Property-Based Testing）
- 完整的功能测试套件
- 性能优化（缓存、索引优化）
- UI 增强（Alpine.js 动画和交互）
- 文档版本控制
- 文档标签系统
- 文档评论功能

## [1.0.0] - 2025-12-05

### 新增
- 🎉 初始版本发布
- ✨ 用户认证和授权系统
- ✨ 用户分组管理功能
- ✨ Word 文档上传和存储
- ✨ 文档分类（全局知识库和专用知识库）
- ✨ 基于分组的细粒度权限控制
- ✨ 文档下载功能和下载日志记录
- ✨ Word 文档自动转换为 Markdown
- ✨ 异步队列处理文档转换任务
- ✨ Meilisearch 全文搜索集成
- ✨ 文档 Markdown 在线预览
- ✨ 搜索结果权限过滤
- ✨ 安全日志记录和审计
- ✨ Filament 3.X 管理面板
- ✨ 完整的简体中文界面
- ✨ 响应式设计，支持移动设备

### 技术实现
- 🔧 Laravel 11.x 框架
- 🔧 Filament 3.X 管理面板
- 🔧 Meilisearch 搜索引擎
- 🔧 Pandoc 文档转换工具
- 🔧 Redis 队列系统
- 🔧 Laravel Scout 搜索集成
- 🔧 CommonMark Markdown 渲染

### 文档
- 📚 项目概览文档
- 📚 部署指南
- 📚 API 参考文档
- 📚 Meilisearch 配置指南
- 📚 文档转换指南
- 📚 安全日志说明

### 测试
- ✅ 单元测试框架（Pest PHP）
- ✅ 测试工厂（Factories）
- ✅ 测试数据填充（Seeders）

### 安全
- 🔒 基于策略的权限控制
- 🔒 文件访问权限验证
- 🔒 未授权访问日志记录
- 🔒 XSS 防护（HTML 清理）
- 🔒 文件类型验证

### 性能
- ⚡ 异步文档转换
- ⚡ 队列任务处理
- ⚡ Meilisearch 快速搜索
- ⚡ 文件流式下载

## 版本说明

### 版本号规则

- **主版本号（Major）**：不兼容的 API 修改
- **次版本号（Minor）**：向下兼容的功能性新增
- **修订号（Patch）**：向下兼容的问题修正

### 更新类型

- `新增`：新功能
- `变更`：对现有功能的变更
- `弃用`：即将移除的功能
- `移除`：已移除的功能
- `修复`：Bug 修复
- `安全`：安全相关的修复

## 升级指南

### 从开发版升级到 1.0.0

这是首个正式版本，无需升级操作。

## 贡献者

感谢所有为本项目做出贡献的开发者！

---

**注意**：本更新日志遵循 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/) 格式。