Sikuwa/CHANGELOG.md

更新日志

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

格式基于 Keep a Changelog， 版本号遵循 语义化版本。

---

未发布

计划中

• 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 编译模式：

# 新增配置
[sikuwa.native]
cc = "gcc"
cxx = "g++"
output_dll = true
output_exe = true

CLI 变更

build 命令新增参数：

# 新增 -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
• Gitee Releases
• PyPI