@makuraryu/yonde 0.4.0 → 0.4.1

package/README.md

@@ -148,6 +148,8 @@ package_asset = "uisfx/sounds/cinematic/select.mp3"
 
 翻译缓存指纹包含输入内容、语言、模型、端点、提示词版本和分句规则，但不包含 API Key。音频缓存指纹包含文本、音色、语言、语速和音调。仅调整朗读顺序时，Yonde 会复用已有语音并重新合并。
 
+缓存文件采用原子写入；命中缓存时只检查文件元数据，避免 iCloud 为数千个小文件执行随机头部读取。最终拼接再按朗读顺序连续读取音频内容。
+
 翻译、语音生成和最终 MP3 合并都会显示单行进度条，包括完成比例、数量、耗时和 ETA。非交互终端按 5% 里程碑输出，避免日志刷屏。
 
 所有语音和分隔音效会统一为 24 kHz、单声道、96 kbps，最终 MP3 采用无损快速拼接，不再把数小时音频完整重编码。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@makuraryu/yonde",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Config-driven Bun CLI for creating bilingual Japanese listening scripts and MP3 audio",
   "type": "module",
   "bin": {

package/src/audio.ts

@@ -47,11 +47,18 @@ function specHash(spec: AudioSpec): string {
     .slice(0, 24);
 }
 
-async function synthesize(spec: AudioSpec, cacheDir: string, ffmpegPath: string): Promise<SynthesisResult> {
+async function synthesize(
+  spec: AudioSpec,
+  cacheDir: string,
+  ffmpegPath: string,
+  existingCacheNames: ReadonlySet<string>,
+): Promise<SynthesisResult> {
   const hash = specHash(spec);
   const safeId = spec.kind.replace(/[^a-zA-Z0-9_-]/g, "_");
   const output = join(cacheDir, `${safeId}-${hash}.mp3`);
-  if (await fileIsUsable(output)) return { path: output, cached: true };
+  // Cache files are atomically renamed after a successful synthesis. A single
+  // directory listing avoids thousands of slow per-file metadata reads on iCloud.
+  if (existingCacheNames.has(basename(output))) return { path: output, cached: true };
 
   const temporary = `${output}.${process.pid}.${randomUUID()}.part.mp3`;
   if (!/[\p{L}\p{N}]/u.test(spec.text)) {
@@ -273,7 +280,9 @@ export async function buildAudio(
   if (!ffmpegPath) throw new Error("找不到 ffmpeg；请先安装 ffmpeg，或仅运行 --stage translate");
   const cacheDir = join(stateDir, "audio-cache");
   await mkdir(cacheDir, { recursive: true });
-  for (const entry of await readdir(cacheDir)) if (entry.endsWith(".part.mp3")) await rm(join(cacheDir, entry), { force: true });
+  const cacheEntries = await readdir(cacheDir);
+  for (const entry of cacheEntries) if (entry.endsWith(".part.mp3")) await rm(join(cacheDir, entry), { force: true });
+  const existingCacheNames = new Set(cacheEntries.filter((entry) => entry.endsWith(".mp3")));
   const outputDir = dirname(outputPath);
   await mkdir(outputDir, { recursive: true });
 
@@ -316,7 +325,7 @@ export async function buildAudio(
   let results: SynthesisResult[];
   try {
     results = await runPool(
-      entries.map(([, spec]) => () => synthesize(spec, cacheDir, ffmpegPath)),
+      entries.map(([, spec]) => () => synthesize(spec, cacheDir, ffmpegPath, existingCacheNames)),
       config.audio.concurrency,
       (result) => {
         completed += 1;

package/src/main.ts

@@ -11,7 +11,7 @@ type Stage = "translate" | "audio" | "all";
 type RunArgs = { command: "run"; input: string; stage: Stage; outputDir?: string; configPath?: string };
 type CliArgs = RunArgs | { command: "init"; path: string } | { command: "config-check"; configPath?: string } | { command: "help" } | { command: "version" };
 
-const VERSION = "0.4.0";
+const VERSION = "0.4.1";
 
 export const HELP_TEXT = `Yonde ${VERSION} — 配置驱动的双语听力材料生成器