im0o fa4a7e92f4 feat(io): 导出 WebP/PNG 下载,模板存 localStorage 可加载复用
- export.ts:toBlob 参数纯函数 resolveExportRequest——multiplier 恒为 1,
  画布 backstore 本就是逻辑尺寸,不再乘预览缩放;WebP 带质量、PNG 无损不带
- templates.ts:模板 = canvas.toJSON() + 尺寸,存 localStorage(key 单键数组);
  save/list/delete 可注入 store 便于 Node 侧自检;collectUsedFonts 扫文本对象
  fontFamily(instanceof FabricText + type 名兜底),missingFonts 查缺字
- ExportPanel.vue:格式/质量/文件名/下载;模板保存命名、列表、加载
  (loadFromJSON + setSize 恢复尺寸)、删除(二次确认);加载时若字体列表
  已就绪且模板用了本机没有的字体则提示;字体列表为空(T2 未实现)跳过检查
- selfcheck.ts:bun 直接跑的 Node 断言,覆盖 multiplier、storage 往返、
  usedFonts 收集、缺字体与文件名清洗

浏览器下载、质量滑杆体积、刷新后加载恢复需主控用 Chrome 验
2026-09-04 16:02:28 +08:00

cover-studio

im0o 博客的封面 / 头图生成器。自用工具。

替代「为了做一张封面专门开一次 Photoshop」这个动作。产出两类图:

  • 封面(cover) — 带字的索引卡。列表里只有 224px 宽,必须一眼认出是哪篇,所以要有字。 形态是一张相关截图或照片,高斯模糊 + 压暗,居中压 1–2 行标题。
  • 头图(top_img) — 无字的原图。文章页里 780px 宽,读者已经知道在读什么,字是冗余。 这个模式下不模糊不压暗,只裁到目标比例。

跑起来

bun install
bun dev          # http://localhost:5180

这个工具只在 dev 下完整可用。 系统字体的枚举与读取是挂在 Vite 开发服务器上的中间件, vite build 出的静态产物里没有那两个接口。这是刻意的:为「列一下本机字体」单起一个后端进程不值得。

架构

src/
├─ types.ts                  全仓共享的类型契约。并行开发期间不要动它
├─ style.css                 设计 token。面板用这里的变量,不要自带一套颜色
├─ App.vue                   外壳:左工作区 + 右侧栏
├─ editor/
│  ├─ useEditor.ts           Fabric 画布单例、选中态、尺寸、装图装字
│  ├─ canvasSize.ts          尺寸预设与比例锁
│  └─ filters/               滤镜注册表与自定义滤镜
├─ fonts/
│  ├─ vite-plugin-fonts.ts   Vite 中间件:枚举并读取本机字体
│  └─ useFonts.ts            前端:取列表、@font-face 挂载
├─ sources/                  背景来源:上传 / 预设几何 / Unsplash
├─ io/                       导出(WebP/PNG 下载)与模板(localStorage)
└─ components/
   ├─ Workspace.vue          左:画布预览
   ├─ Sidebar.vue            右:面板容器,按选中对象切换
   └─ panels/                五个面板,各归各的开发线

画布是逻辑尺寸(导出像素,如 1200×630),显示时按容器缩放。 Fabric 的 backstore 尺寸和 CSS 尺寸分开设置,所以预览缩放不影响导出分辨率。

右栏面板的显示与否由画布当前选中对象决定。 这是 Fabric 对象模型白送的, 不需要自己做状态机:选中图片出滤镜面板,选中文字出文字面板。

技术选型的理由

  • Fabric.js v7 — 选它不是为了滤镜,是为了对象模型:拖拽 / 缩放 / 裁剪 / 文字框 / 层级全都白送。 而且 canvas.toJSON() / loadFromJSON() 直接就是模板的序列化格式,不用自己设计。
  • 导出用 WebP — 实测同一张图,540×287 PNG = 134 KB,1200×630 WebP = 23 KB。 尺寸翻倍还小 5 倍。旧封面存 PNG 是历史失误:模糊背景 + 少量文字正好是 PNG 最烂的场景。
  • 无独立后端 — 字体接口写成 Vite 插件的 configureServer 中间件,bun dev 一个命令, 没有第二个进程、没有端口要配。

明确不做

选文章 / 回填 frontmatter、自动上传图床、多尺寸派生(只出一份)、内置预设包(模板全靠用户自己存)。

仓库位置

独立 git 仓,远端在 Gitea。不是 blog-workspace 的 submodule——它和博客之间没有代码依赖, 产物是手动拿走的图片文件。它在 blog-workspace 目录下但被 gitignore, 和 blog-v3-draft/ 是同一个处理方式。

S
Description
No description provided
Readme
284 KiB
Languages
TypeScript 57.9%
Vue 40.6%
CSS 1.2%
JavaScript 0.2%