# tools

**Repository Path**: payneffff/tools

## Basic Information

- **Project Name**: tools
- **Description**: 自用小工具
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-07
- **Last Updated**: 2026-05-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 工具脚本仓库

收集日常开发中使用的各类工具脚本。

## 目录结构

```
tools/
├── asset-compress/    # 资源压缩工具
│   └── compress-assets.js   压缩图片和 GLB 模型资源
├── kml-tools/         # KML 处理工具
│   ├── merge_kml.py         合并多个 KML 文件
│   ├── optimize_kml.py      KML 样式统一
│   └── process_kml.py       KML 线路整理
├── text-to-docx/      # 文本转 Word 工具
│   ├── main.py              pywebview 桌面应用入口
│   ├── backend/             Python 后端（解析/生成/配置）
│   └── frontend/            Vue 3 前端界面
└── README.md
```

## 工具说明

### asset-compress — 资源压缩

压缩 earthsdk3-assets 目录下的图片（PNG/JPEG/WebP）和 GLB 模型资源，输出到独立目录，可直接重命名替换原目录。

- PNG 调色板模式，近无损减少 30-70%
- JPEG mozjpeg quality=82
- GLB Draco 几何压缩 + 内嵌贴图压缩
- 压缩后取更小的，不会越压越大
- 总体压缩率约 67%

### kml-tools — KML 处理

三步式 KML 处理流水线（工作目录：source/ 输入，result/ 输出）：

1. **merge_kml.py** — 文件合并：将多个 KML 文件合并为一个（如线数据 + 点数据）
2. **optimize_kml.py** — 样式统一：统一线条颜色/宽度、文字颜色、贴地设置，清理冗余字体参数
3. **process_kml.py** — 线路整理：合并线段为走势线，保留里程标注（K+xxx 格式），移除无用标注

### text-to-docx — 文本转 Word

将纯文本自动排版为规范的 .docx 文件，支持智能段落识别、格式配置、实时预览。

- 支持文件导入、剪贴板粘贴、拖拽三种输入方式
- 智能识别标题、多级标题（H1-H3）、正文、有序/无序列表
- 完整格式配置：字体、字号、行距、缩进、页面设置
- 配置模板保存/加载
- 实时富文本预览
- 打包为单 exe（Python + pywebview + Vue 3 + Vite 8）