update at 2026-02-08 18:28:39

USAGE.md

@@ -3,6 +3,7 @@
 本文覆盖两类使用方式：
 
 - Web 应用（推荐）：`frontend/` 图形界面
+- 微信小程序：`miniprogram/` 移动端图形界面
 - Python CLI：`font2svg.py` / `pic2svg.py`
 
 ## 1. Web 应用
@@ -57,7 +58,49 @@ pnpm run preview
 - 多个条目：自动打包 ZIP
 - 文件名：`字体名_文本前8字符.扩展名`
 
-## 2. Python CLI
+## 2. 微信小程序
+
+### 2.1 字体清单准备
+
+```bash
+pnpm run prepare-fonts
+```
+
+该命令会同时更新：
+
+- `frontend/public/fonts.json`
+- `miniprogram/assets/fonts.json`
+
+### 2.2 启动方式
+
+1. 打开微信开发者工具。
+2. 导入目录：`miniprogram/`。
+3. 在小程序后台配置合法域名（`request` 和 `downloadFile` 均需配置 `https://fonts.biboer.cn`）。
+4. 在服务器启动渲染 API：
+
+```bash
+python3 apiserver/server.py --host 0.0.0.0 --port 9300 --static-root /home/gavin/font2svg
+```
+
+5. Nginx 配置 `/api/` 反代到 `http://127.0.0.1:9300`。
+6. 编译并预览。
+
+### 2.3 页面操作
+
+1. 首页输入文本，选择字体，调整字号/颜色/字间距。
+2. 预览区实时显示 SVG 结果。
+3. 点击“导出 SVG 并分享”可生成文件并转发到聊天。
+4. 点击“导出 PNG 到相册”可保存图片到系统相册。
+
+### 2.4 小程序检查命令
+
+```bash
+pnpm run mp:syntax
+pnpm run mp:lint
+pnpm run mp:test
+```
+
+## 3. Python CLI
 
 ### 2.1 安装依赖
 
@@ -105,7 +148,7 @@ python pic2svg.py --indir images --outdir output
 - `--optimize-curves`：启用曲线优化
 - `--circle-fit`：圆拟合误差阈值
 
-## 3. 常见问题
+## 4. 常见问题
 
 ### Q1：前端看不到字体？