Sikuwa first commit

CHANGELOG.md

@@ -0,0 +1,184 @@
+# 更新日志
+
+本文档记录 Sikuwa 项目的所有重要变更。
+
+格式基于 [Keep a Changelog](https://keepachangelog.com/zh-CN/1.0.0/)，
+版本号遵循 [语义化版本](https://semver.org/lang/zh-CN/)。
+
+---
+
+## [未发布]
+
+### 计划中
+
+- WebAssembly 编译目标支持
+- 远程分布式编译
+- 编译配置可视化工具
+
+---
+
+## [1.3.0] - 2026-01-31
+
+### 新增
+
+- **Native 编译模式**: 支持 Python 到 C/C++ 的转换，通过 GCC/G++ 编译为原生二进制
+  - 生成通用动态链接库 (.dll/.so)
+  - 不依赖 Python 专用格式 (.pyd)
+  - 支持静态链接选项
+  - 可保留生成的 C/C++ 源码用于审计
+
+- **增量编译系统**: 实现"指哪编哪"的精确编译
+  - 函数级粒度的变更检测
+  - 依赖关系图追踪
+  - 编译缓存持久化
+  - 并行编译支持
+
+- **C++ 智能缓存扩展**: 高性能缓存实现
+  - 基于 pybind11 的 Python 绑定
+  - LRU 缓存策略
+  - 内存映射文件支持
+
+- **国际化支持 (i18n)**
+  - 内置中英文支持
+  - 基于 Babel 的翻译框架
+  - 可扩展的语言包机制
+
+- **新增 CLI 命令**
+  - `sikuwa doctor`: 环境诊断
+  - `sikuwa validate`: 配置验证
+
+### 变更
+
+- 重构日志系统，支持多级别日志输出
+- 优化构建流程，减少不必要的文件操作
+- 改进配置文件解析，支持更复杂的嵌套结构
+
+### 修复
+
+- 修复 Windows 平台路径处理问题
+- 修复大型项目编译时的内存溢出问题
+- 修复并行编译时的竞态条件
+- 修复 TOML 配置中特殊字符解析错误
+
+### 性能
+
+- 增量编译场景下构建速度提升 60%
+- 缓存命中时跳过重复计算
+- 优化依赖分析算法复杂度
+
+---
+
+## [1.2.0] - 2025-10-15
+
+### 新增
+
+- 初始公开发布
+- 基于 Nuitka 的构建系统
+- TOML 配置文件支持
+- 跨平台构建 (Windows/Linux/macOS)
+- Standalone 和 OneFile 模式
+- 资源文件打包
+
+### CLI 命令
+
+- `sikuwa build`: 构建项目
+- `sikuwa clean`: 清理构建文件
+- `sikuwa init`: 初始化配置
+- `sikuwa info`: 显示项目信息
+- `sikuwa version`: 显示版本
+
+### 配置选项
+
+- 项目基本信息配置
+- Nuitka 编译选项
+- 平台特定配置
+- 数据文件包含
+
+---
+
+## [1.1.0] - 2025-08-20
+
+### 新增
+
+- 插件系统支持
+- 自定义构建钩子
+
+### 变更
+
+- 重构配置管理模块
+
+### 修复
+
+- 修复依赖检测遗漏问题
+
+---
+
+## [1.0.0] - 2025-06-01
+
+### 新增
+
+- 项目初始版本
+- 基础构建功能
+- 命令行界面原型
+
+---
+
+## 版本对比
+
+| 版本 | 发布日期 | 主要特性 |
+|:---|:---|:---|
+| 1.3.0 | 2026-01-31 | Native 模式、增量编译、i18n |
+| 1.2.0 | 2025-10-15 | 公开发布、完整 CLI |
+| 1.1.0 | 2025-08-20 | 插件系统 |
+| 1.0.0 | 2025-06-01 | 初始版本 |
+
+---
+
+## 迁移指南
+
+### 从 1.2.x 升级到 1.3.x
+
+**配置文件变更**
+
+新增 `[sikuwa.native]` 配置节，用于 Native 编译模式：
+
+```toml
+# 新增配置
+[sikuwa.native]
+cc = "gcc"
+cxx = "g++"
+output_dll = true
+output_exe = true
+```
+
+**CLI 变更**
+
+`build` 命令新增参数：
+
+```bash
+# 新增 -m/--mode 参数
+sikuwa build -m native
+
+# 新增 --keep-c-source 参数
+sikuwa build -m native --keep-c-source
+```
+
+**API 变更**
+
+- `BuildConfig` 类新增 `compiler_mode` 属性
+- `BuildConfig` 类新增 `native_options` 属性
+- 新增 `NativeCompilerOptions` 数据类
+
+---
+
+## 链接
+
+- [GitHub Releases](https://github.com/FORGE24/Sikuwa/releases)
+- [Gitee Releases](https://gitee.com/FORGE24/Sikuwa/releases)
+- [PyPI](https://pypi.org/project/sikuwa/)
+
+[未发布]: https://github.com/FORGE24/Sikuwa/compare/v1.3.0...HEAD
+[1.3.0]: https://github.com/FORGE24/Sikuwa/compare/v1.2.0...v1.3.0
+[1.2.0]: https://github.com/FORGE24/Sikuwa/compare/v1.1.0...v1.2.0
+[1.1.0]: https://github.com/FORGE24/Sikuwa/compare/v1.0.0...v1.1.0
+[1.0.0]: https://github.com/FORGE24/Sikuwa/releases/tag/v1.0.0