@ry-krystal/kicad-converter/CHANGELOG.md

专业的KiCad符号文件与JSON互转工具

# 更新日志

本文档记录了 @ry-krystal/kicad-converter 的所有重要更改。

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

## [1.0.6] - 2025-07-24

### 修复
- 🎯 **重要修复**: JSON转.kicad_sym文件格式问题
- 📐 恢复原始KiCad文件的多行缩进格式
- 🔧 使用制表符缩进而非空格，完全匹配原始格式
- ✨ 属性、效果、字体信息现在正确分行显示
- 🔄 增强版生成器支持复杂符号库文件（测试106个符号）

### 改进  
- 📏 优化文本效果的多行格式生成
- 🎨 保持与原始KiCad文件完全一致的视觉布局
- 🧪 通过大型符号库文件测试验证（479KB→114KB双向转换）

## [1.0.0] - 2025-07-23

### 新增
- 🎉 首次发布到npm
- ⚡ 双引擎架构：核心版转换器 + 增强版转换器
- 🔄 完整的双向转换：KiCad符号文件 ↔ JSON格式
- 🛠️ 专业命令行工具，支持批量处理
- ✅ 内置数据验证和完整性检查
- 📊 详细的转换统计和性能监控
- 🔧 程序化API，支持TypeScript
- 📦 模块化架构，易于扩展

### 功能特性
- **核心转换器**: 稳定可靠的基础转换功能
- **增强版转换器**: 高性能处理，支持错误恢复
- **CLI工具**: 完整的命令行界面
  - 自动检测文件类型
  - 批量转换目录
  - 递归处理子目录
  - 数据验证和统计
- **API接口**: TypeScript/JavaScript程序化调用
- **工具函数**: 文件操作、路径处理、配置管理

### 技术栈
- TypeScript 5.8+ 严格模式
- Node.js 18+ 支持
- ESLint + Prettier 代码规范
- Rollup 构建系统
- Vitest 测试框架

### 安装方式
```bash
# 全局安装CLI工具
npm install -g @kicad-tools/converter

# 项目依赖安装
npm install @kicad-tools/converter
```

### 使用示例
```bash
# 命令行使用
kicad-converter input.kicad_sym
kc --batch ./symbols/ --recursive

# 程序化使用
import { convertKiCadToJson } from '@kicad-tools/converter';
const result = await convertKiCadToJson(content);
```

---

## 开发历程

### v2.0.0-beta (内部版本)
- 完整重构原有转换器
- 实现模块化架构
- 添加增强版转换引擎

### v1.0.0-alpha (内部版本)  
- 基础KiCad解析器
- 简单的JSON转换
- 原型CLI工具

---

## 贡献

欢迎提交Issue和Pull Request！

- 🐛 [报告问题](https://github.com/kicad-tools/converter/issues)
- 💬 [参与讨论](https://github.com/kicad-tools/converter/discussions)
- 📖 [查看文档](https://github.com/kicad-tools/converter#readme)