Initial commit: Modular personal toolbox with high-fidelity Chinese stroke order tool and CI/CD

README.md

@@ -0,0 +1,53 @@
+# Own-Tools | 个人工具箱
+
+这是一个基于 Go 语言构建的模块化、全内嵌、响应式个人工具箱。
+
+## 🌟 核心特性
+
+- **模块化架构**：采用插件化设计（`pkg/base` 接口），后端路由自动注册，前端动态加载工具。
+- **响应式设计**：全站适配桌面端与移动端，具备 Apple 风格的高级质感。
+- **模板驱动**：基于 Go `html/template` 实现布局继承，全站视觉高度统一。
+- **全内嵌部署**：所有前端静态资源、千万级字库数据及字体文件均打包进单个二进制文件。
+- **生产就绪**：支持 Google Analytics 动态注入、Liveness/Readiness 探测、TLS Ingress 自动化部署。
+
+## 🛠 已集成工具
+
+### [汉字字帖生成器](./pkg/zitie/README.md)
+- **2x3 教学方格**：带圆圈序号、方向箭头、骨架红线。
+- **步进式分解**：9列紧凑米字格，逐笔展示书写过程。
+- **古风竖排信纸**：红色乌丝栏，支持 4 款顶级华光书法字体，智能缺字处理。
+
+## 🚀 快速开始
+
+### 本地运行
+```bash
+./toolbox -port 8888 -ga G-XXXXXXXXXX
+```
+访问 `http://localhost:8888` 即可使用。
+
+### 从源码编译
+```bash
+go build -o toolbox cmd/toolbox/main.go
+```
+
+## 🐳 容器化与部署
+
+### 环境变量
+- `PORT`: 监听端口（默认 8080）。
+- `GIN_MODE`: 设置为 `release` 以优化性能。
+- `GA_ID`: 动态注入 Google Analytics ID。
+
+### K3s 部署
+```bash
+kubectl apply -f deploy/k8s.yaml
+```
+
+## 📂 项目结构
+- `cmd/toolbox/`: 程序入口及 web 模板 (`layout.html`, `index.html`)。
+- `pkg/base/`: 核心插件接口定义。
+- `pkg/zitie/`: 汉字字帖功能实现。
+- `deploy/`: Kubernetes 部署清单。
+- `.gitea/`: CI/CD 流水线配置。
+
+## 📝 许可证
+MIT License.