mirror of
https://github.com/2234839/web-font.git
synced 2026-11-21 18:24:53 +08:00
- shared.ts 的 subsetCache 条目改为 {bytes, ttf},/api 裁剪与找字体共用同一份产物
- 容量计费含 ttf 对象开销(17 倍 bytes 估算),仍是 subsetCacheMaxSize 统一限额
- key 命名空间统一:版本指纹:进程启动时间:字体路径:outType:文本
155 lines
5.4 KiB
TypeScript
155 lines
5.4 KiB
TypeScript
import { fontDirs, subsetCacheMaxSize } from "./config";
|
||
import { LruCache } from "./lru_cache";
|
||
import type { SubsetTtfObject } from "./font_util/glyph_bitmap";
|
||
import { path_join, readFile, stat, readdir } from "./interface";
|
||
import { loadPersistedStats, scheduleStatsFlush, type PersistedStats } from "./stats_store";
|
||
|
||
/** 解析请求 URL(req.url 只有路径,需要补全协议和主机才能用 URL API) */
|
||
export function parseUrl(req: Request): URL {
|
||
return new URL(req.url, "http://localhost");
|
||
}
|
||
|
||
/** JSON 响应工具 */
|
||
export function jsonResponse(data: unknown, status = 200) {
|
||
return new Response(JSON.stringify(data), {
|
||
status,
|
||
headers: { "Content-Type": "application/json" },
|
||
});
|
||
}
|
||
|
||
/** 运行时统计(累计计数跨重启持久化,startTime 为本次进程启动时刻) */
|
||
export const stats = {
|
||
/** 服务启动时间戳(进程级,不持久化) */
|
||
startTime: Date.now(),
|
||
/** 总请求数(持久化累计) */
|
||
totalRequests: 0,
|
||
/** 字体裁剪请求次数(含缓存命中;持久化累计) */
|
||
subsetRequests: 0,
|
||
/** 字体裁剪缓存命中次数(持久化累计) */
|
||
subsetCacheHits: 0,
|
||
/** 累计裁剪文字字符数(持久化累计) */
|
||
totalChars: 0,
|
||
/** 临时文件上传次数(持久化累计) */
|
||
tempUploads: 0,
|
||
/** 离线裁剪完成次数(纯浏览器端裁剪的匿名上报;持久化累计) */
|
||
offlineSubsets: 0,
|
||
/** 离线裁剪字体下载次数(匿名上报;持久化累计) */
|
||
offlineDownloads: 0,
|
||
};
|
||
|
||
/**
|
||
* 从持久化文件恢复累计计数
|
||
*
|
||
* 在 main() 最早期 await 一次:让计数器从历史值起步,实现跨重启持久化。
|
||
* startTime 始终重置为当前时刻——uptime 度量的是本次进程。
|
||
*/
|
||
export async function initStats(): Promise<void> {
|
||
const persisted = await loadPersistedStats();
|
||
stats.startTime = persisted.startTime;
|
||
stats.totalRequests = persisted.totalRequests;
|
||
stats.subsetRequests = persisted.subsetRequests;
|
||
stats.subsetCacheHits = persisted.subsetCacheHits;
|
||
stats.totalChars = persisted.totalChars;
|
||
stats.tempUploads = persisted.tempUploads;
|
||
stats.offlineSubsets = persisted.offlineSubsets;
|
||
stats.offlineDownloads = persisted.offlineDownloads;
|
||
}
|
||
|
||
/** 取出需要持久化的累计计数字段 */
|
||
export function snapshotStats(): PersistedStats {
|
||
return {
|
||
totalRequests: stats.totalRequests,
|
||
subsetRequests: stats.subsetRequests,
|
||
subsetCacheHits: stats.subsetCacheHits,
|
||
totalChars: stats.totalChars,
|
||
tempUploads: stats.tempUploads,
|
||
offlineSubsets: stats.offlineSubsets,
|
||
offlineDownloads: stats.offlineDownloads,
|
||
};
|
||
}
|
||
|
||
/**
|
||
* 标记统计已变更,触发防抖落盘
|
||
*
|
||
* 请求热路径调用:仅做一次对象赋值 + 幂等的定时器检查,绝不阻塞。
|
||
* 真正的磁盘 IO 由 stats_store 内部按 FLUSH_INTERVAL 批量执行。
|
||
*/
|
||
export function markStatsDirty(): void {
|
||
scheduleStatsFlush(snapshotStats());
|
||
}
|
||
|
||
/** 字体文件 LRU 缓存,最多保留 3 个最近使用的字体 buffer(按条目数淘汰) */
|
||
export const fontBufferCache = new LruCache<ArrayBuffer>({ maxSize: 3 });
|
||
|
||
/**
|
||
* 字体裁剪产物缓存条目:bytes 供 HTTP 下载/前端预览;
|
||
* ttf 为内存子集对象(cmap 已重建,可直接光栅化评分),OTF 输入时为 null。
|
||
* 不为序列化已产出的对象单独留副本,两处消费方共享同一份产物。
|
||
*/
|
||
export interface SubsetCacheEntry {
|
||
/** 序列化裁剪字体(供 HTTP 下载/前端预览) */
|
||
bytes: Uint8Array;
|
||
/** 评分用内存子集对象(cmap 已重建,可直接光栅化),OTF 输入时为 null */
|
||
ttf: SubsetTtfObject | null;
|
||
}
|
||
|
||
/**
|
||
* 字体裁剪结果共享 LRU 缓存(按内存容量淘汰)。
|
||
* key 由消费方自定(版本指纹:字体路径:outType:文本);
|
||
* 容量计费 = 序列化 bytes + ttf 对象估算开销(16 倍),避免缓存对象本身把容器排薄。
|
||
*/
|
||
export const subsetCache = new LruCache<SubsetCacheEntry>({
|
||
maxBytes: subsetCacheMaxSize,
|
||
sizeFn: (v) => v.bytes.byteLength * (v.ttf ? 17 : 1),
|
||
});
|
||
|
||
/**
|
||
* 在所有字体目录中查找字体文件
|
||
* 匹配优先级:精确匹配 > 前缀匹配 > 包含匹配
|
||
*/
|
||
export async function findFontPath(filename: string): Promise<string | null> {
|
||
for (const dir of fontDirs) {
|
||
const filePath = path_join(dir, filename);
|
||
try {
|
||
const s = await stat(filePath);
|
||
if (s.isFile()) return filePath;
|
||
} catch {}
|
||
}
|
||
|
||
const allFonts: Array<{ basename: string; path: string }> = [];
|
||
for (const dir of fontDirs) {
|
||
try {
|
||
const entries = await readdir(dir);
|
||
for (const entry of entries) {
|
||
if (entry.isFile() && /\.(ttf|otf|woff|woff2)$/i.test(entry.name)) {
|
||
allFonts.push({
|
||
basename: entry.name.replace(/\.[^.]+$/, ""),
|
||
path: path_join(dir, entry.name),
|
||
});
|
||
}
|
||
}
|
||
} catch {}
|
||
}
|
||
|
||
const query = filename.replace(/\.[^.]+$/, "").toLowerCase();
|
||
|
||
for (const f of allFonts) {
|
||
if (f.basename.toLowerCase().startsWith(query)) return f.path;
|
||
}
|
||
|
||
for (const f of allFonts) {
|
||
if (f.basename.toLowerCase().includes(query)) return f.path;
|
||
}
|
||
|
||
return null;
|
||
}
|
||
|
||
/** 从缓存或磁盘读取字体 buffer */
|
||
export async function readFontBuffer(fontPath: string): Promise<ArrayBuffer> {
|
||
const cached = fontBufferCache.get(fontPath);
|
||
if (cached) return cached;
|
||
const buffer = new Uint8Array(await readFile(fontPath)).buffer;
|
||
fontBufferCache.set(fontPath, buffer);
|
||
return buffer;
|
||
}
|