feat: add manual known-word cache refresh path

- Add CLI command flag  with non-GUI dispatch flow and OSD error handling.

- Add runtime integration call and IPC hook so manual refresh works from command runner without app startup.

- Add public AnkiIntegration manual refresh API with force refresh semantics and guard reuse.

- Preserve default n+1 behavior by fixing config validation for malformed  values and adding tests.

src/main/cli-runtime.ts

@@ -22,6 +22,7 @@ export interface CliCommandRuntimeServiceContext {
   mineSentenceCard: () => Promise<void>;
   startPendingMineSentenceMultiple: (timeoutMs: number) => void;
   updateLastCardFromClipboard: () => Promise<void>;
+  refreshKnownWordCache: () => Promise<void>;
   triggerFieldGrouping: () => Promise<void>;
   triggerSubsyncFromConfig: () => Promise<void>;
   markLastCardAsAudioCard: () => Promise<void>;
@@ -70,12 +71,13 @@ function createCliCommandDepsFromContext(
     mining: {
       copyCurrentSubtitle: context.copyCurrentSubtitle,
       startPendingMultiCopy: context.startPendingMultiCopy,
-      mineSentenceCard: context.mineSentenceCard,
-      startPendingMineSentenceMultiple: context.startPendingMineSentenceMultiple,
-      updateLastCardFromClipboard: context.updateLastCardFromClipboard,
-      triggerFieldGrouping: context.triggerFieldGrouping,
-      triggerSubsyncFromConfig: context.triggerSubsyncFromConfig,
-      markLastCardAsAudioCard: context.markLastCardAsAudioCard,
+    mineSentenceCard: context.mineSentenceCard,
+    startPendingMineSentenceMultiple: context.startPendingMineSentenceMultiple,
+    updateLastCardFromClipboard: context.updateLastCardFromClipboard,
+    refreshKnownWords: context.refreshKnownWordCache,
+    triggerFieldGrouping: context.triggerFieldGrouping,
+    triggerSubsyncFromConfig: context.triggerSubsyncFromConfig,
+    markLastCardAsAudioCard: context.markLastCardAsAudioCard,
     },
     ui: {
       openYomitanSettings: context.openYomitanSettings,

src/main/dependencies.ts

@@ -145,6 +145,7 @@ export interface CliCommandRuntimeServiceDepsParams {
       CliCommandDepsRuntimeOptions["mining"]["startPendingMineSentenceMultiple"];
     updateLastCardFromClipboard:
       CliCommandDepsRuntimeOptions["mining"]["updateLastCardFromClipboard"];
+    refreshKnownWords: CliCommandDepsRuntimeOptions["mining"]["refreshKnownWords"];
     triggerFieldGrouping: CliCommandDepsRuntimeOptions["mining"]["triggerFieldGrouping"];
     triggerSubsyncFromConfig:
       CliCommandDepsRuntimeOptions["mining"]["triggerSubsyncFromConfig"];
@@ -273,6 +274,7 @@ export function createCliCommandRuntimeServiceDeps(
       mineSentenceCard: params.mining.mineSentenceCard,
       startPendingMineSentenceMultiple: params.mining.startPendingMineSentenceMultiple,
       updateLastCardFromClipboard: params.mining.updateLastCardFromClipboard,
+      refreshKnownWords: params.mining.refreshKnownWords,
       triggerFieldGrouping: params.mining.triggerFieldGrouping,
       triggerSubsyncFromConfig: params.mining.triggerSubsyncFromConfig,
       markLastCardAsAudioCard: params.mining.markLastCardAsAudioCard,

src/main/ipc-runtime.ts

@@ -3,6 +3,7 @@ import {
   registerAnkiJimakuIpcRuntimeService,
   registerIpcHandlersService,
 } from "../core/services";
+import { registerAnkiJimakuIpcHandlers } from "../core/services/anki-jimaku-ipc-service";
 import {
   createAnkiJimakuIpcRuntimeServiceDeps,
   AnkiJimakuIpcRuntimeServiceDepsParams,
@@ -34,6 +35,7 @@ export function registerAnkiJimakuIpcRuntimeServices(
 ): void {
   registerAnkiJimakuIpcRuntimeService(
     createAnkiJimakuIpcRuntimeServiceDeps(params),
+    registerAnkiJimakuIpcHandlers,
   );
 }