个人工具箱 (Own-Tools)

这是一个基于 Go 语言构建的模块化个人工具箱。目前已实现核心功能：汉字字帖生成器。

🌟 核心特性

• 全内嵌部署：所有前端静态资源、汉字笔顺数据（9574个字）以及字体文件均通过 go:embed 打包进单个二进制文件。
• 高性能渲染：原生 Go 实现的矢量 PDF 绘图，支持贝塞尔曲线平滑采样，生成高质量、不失真的字帖。
• 模块化架构：采用插件化设计（pkg/base 接口），可轻松扩展新工具。
• 云原生就绪：提供多阶段构建的 Dockerfile，并集成了 Gitea Actions CI/CD。

🛠 已集成工具

汉字字帖生成器 (jitie)

• 教学字帖 (2x3)：带红色圆圈序号、方向箭头和骨架红线的专业临摹贴。
• 步进分解 (9列)：米字格背景，逐笔展示汉字书写过程，支持多字连续排版。
• 智能适配：自动适配 A4 和 Letter 纸张尺寸。

🚀 快速开始

本地运行 (已有编译好的二进制文件)

./toolbox -port 8888

访问 http://localhost:8888 即可开始使用。

从源码编译

确保已安装 Go 1.23+。

go build -o toolbox cmd/toolbox/main.go

命令行参数

• -port: 指定 Web 服务端口（默认 8080，优先级高于环境变量）。

🐳 容器化部署

环境变量

• PORT: 容器内监听端口（默认 8080）。

构建镜像

docker build -t toolbox:latest .

运行镜像

docker run -p 8080:8080 toolbox:latest

📂 项目结构

• cmd/toolbox/: 程序入口及内嵌前端网页。
• pkg/base/: 工具标准接口定义及自动注册中心。
• pkg/jitie/: 汉字字帖工具实现。
  • data/: 内嵌的 30MB 完整字库及字体。
  • logic/: PDF 渲染、SVG 解析、避让算法逻辑。
• .gitea/workflows/: CI/CD 自动化流水线配置。
• design/: 项目设计文档。

📝 许可证

自用工具，遵循 MIT 协议。