refactor(client): 开启 noUnusedLocals 并清理 10 处死代码，生产代码 any 清零

Author: Aparencia

client/.oxlintrc.json

@@ -1,8 +1,19 @@
-{
-  "$schema": "./node_modules/oxlint/configuration_schema.json",
-  "plugins": ["react", "typescript", "oxc"],
-  "rules": {
-    "react/rules-of-hooks": "error",
-    "react/only-export-components": ["warn", { "allowConstantExport": true }]
-  }
-}
+{
+  "$schema": "./node_modules/oxlint/configuration_schema.json",
+  "plugins": ["react", "typescript", "oxc"],
+  "rules": {
+    "react/rules-of-hooks": "error",
+    "react/only-export-components": ["warn", { "allowConstantExport": true }],
+    "typescript/no-explicit-any": "warn",
+    "no-unused-vars": "warn",
+    "react-hooks/exhaustive-deps": "warn"
+  },
+  "overrides": [
+    {
+      "files": ["**/*.test.{ts,tsx}", "**/test/**/*.{ts,tsx}"],
+      "rules": {
+        "typescript/no-explicit-any": "off"
+      }
+    }
+  ]
+}

client/electron/ipcUtils.ts

@@ -51,8 +51,7 @@ export function getMainWindowId(): number | null {
  * 支持类型安全的 handler 签名：
  * 允许 handler 声明具体参数类型，内部通过断言适配 ipcMain.handle 的 unknown[] 签名。
  */
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
-type TypedHandler<T extends any[]> = (
+type TypedHandler<T extends unknown[]> = (
   event: Electron.IpcMainInvokeEvent,
   ...args: T
 ) => Promise<unknown>;
@@ -73,7 +72,7 @@ type TypedHandler<T extends any[]> = (
  * @param handler - 处理函数
  * @ai-context main.ts 中所有 safeHandle 调用均经过此函数
  */
-export function safeHandle<T extends any[]>(
+export function safeHandle<T extends unknown[]>(
   channel: string,
   handler: TypedHandler<T>,
 ): void {
@@ -147,7 +146,7 @@ export function requireArray<T = unknown>(value: unknown, field: string): T[] {
  * @param handler - 实际处理函数（仅处理最后一次请求的参数）
  * @ai-context 用于高频 IPC 场景（如滚动位置同步、窗口状态更新）
  */
-export function safeHandleBatched<T extends any[]>(
+export function safeHandleBatched<T extends unknown[]>(
   channel: string,
   handler: TypedHandler<T>,
 ): void {

client/src/features/constellation/lib/evolutionData.ts

@@ -79,7 +79,9 @@ interface ReviewIndex {
 export function deriveEvolutionData(
   graph: KnowledgeGraph,
   reviews: Array<{ cardId: string; reviewedAt: Date | string }> = [],
-  sourceRefs: Map<string, string> = new Map(),
+  // 兼容历史调用签名：本函数不使用 sourceRefs（映射在 buildEvolutionData 中消费），
+  // 下划线前缀避免 noUnusedParameters 报错，保持公共 API 不变
+  _sourceRefs: Map<string, string> = new Map(),
   now: number = Date.now(),
 ): EvolutionData {
   if (graph.coldStart || graph.nodes.length === 0) {

client/src/features/inspiration/lib/constellationLayout.ts

@@ -188,8 +188,9 @@ function isInCenterExclusion(
  * @ai-context 为中心创作区留出视觉空间，光点被推到左右两侧
  */
 function redistributeFromCenter(
-  x: number,
-  y: number,
+  // 历史签名保留 x/y（调用处按位置传参），实现只用 seed 与 exclusion 重算横向位置
+  _x: number,
+  _y: number,
   seed: number,
   exclusion: NonNullable<LayoutOptions['centerExclusion']>,
 ): number {

client/src/features/pomodoro/store/tickSlice.ts

@@ -243,7 +243,8 @@ function runPhaseCompletion(
  * 避免墙钟校准跳变时漏报。
  */
 function emitPhaseSignals(
-  get: () => PomodoroState,
+  // 历史签名保留 get（调用处按位置传参），实现只读 set 与阶段参数
+  _get: () => PomodoroState,
   set: (fn: (s: PomodoroState) => Partial<PomodoroState>) => void,
   phase: Phase,
   nextRemaining: number,

client/src/hooks/useLearningProgress.ts

@@ -73,7 +73,7 @@ export function useLearningProgress(): LearningProgressItem[] {
       try {
         const allCards = await db.flashcards.toArray();
         if (allCards.length > 0) {
-          const reviewedCards = allCards.filter((c: any) => c.repetitions > 0);
+          const reviewedCards = allCards.filter((c) => c.repetitions > 0);
           const flashcardProgress = Math.min(100, Math.round((reviewedCards.length / allCards.length) * 100));
           result.push({ subject: '闪卡复习', progress: flashcardProgress });
         } else {

client/src/lib/3d/core/ContextRecovery.tsx

@@ -49,7 +49,7 @@ export function ContextRecovery({ onContextLost }: { onContextLost?: () => void
         console.log('[WebGL] Context restored');
         // 强制重新编译所有着色器
         try {
-          const info = (gl as any).info;
+          const info = (gl as unknown as { info?: { programs?: Array<{ destroy?: () => void }> } }).info;
           if (info?.programs) {
             // WebGLRenderer 旧 info 结构：info.programs 为数组
             (info.programs as Array<{ destroy?: () => void }>)?.forEach((program) => {

client/src/lib/3d/core/MemoryManager.tsx

@@ -43,12 +43,17 @@ export function MemoryManager() {
   // 定期报告内存使用
   useEffect(() => {
     const interval = setInterval(() => {
-      const info = gl.info as any;
+      const info = gl.info as unknown as {
+        memory?: { geometries?: number; textures?: number; programs?: number };
+        programs?: { length?: number };
+      };
       const programs = info.memory?.programs ?? info.programs?.length ?? 0;
-      if (info.memory.geometries > 500 || info.memory.textures > 100) {
+      const geometries = info.memory?.geometries ?? 0;
+      const textures = info.memory?.textures ?? 0;
+      if (geometries > 500 || textures > 100) {
         console.warn('[3D Memory]', {
-          geometries: info.memory.geometries,
-          textures: info.memory.textures,
+          geometries,
+          textures,
           programs,
         });
       }

client/src/lib/3d/shaders/gpuParticleShaders.ts

@@ -77,7 +77,8 @@ export function patchParticleShader(
   };
 
   // 保存引用以便在 useFrame 中更新 uniform
-  (material as any).__gpuParticleUniforms = uniforms;
+  // （自定义属性挂载：three 未公开该扩展点，用受约束的接口声明替代 any）
+  (material as unknown as { __gpuParticleUniforms: Record<string, THREE.IUniform> }).__gpuParticleUniforms = uniforms;
 }
 
 /**
@@ -87,7 +88,7 @@ export function updateGPUParticleUniforms(
   material: THREE.PointsMaterial,
   time: number,
 ): void {
-  const uniforms = (material as any).__gpuParticleUniforms as Record<string, THREE.IUniform> | undefined;
+  const uniforms = (material as unknown as { __gpuParticleUniforms?: Record<string, THREE.IUniform> }).__gpuParticleUniforms;
   if (uniforms) {
     uniforms.uTime.value = time;
   }

client/src/lib/ai/RemoteAIPlugin.ts

@@ -37,12 +37,10 @@ import {
  * AIPlugin 门面与流式 postStream 调用，公共 API 与拆分前一致。
  */
 export class RemoteAIPlugin implements AIPlugin {
-  /** 保留字段：历史构造签名兼容（超时实际由 aiClient 统一控制） */
-  private timeout: number;
-
-  constructor(timeout: number = 60000) {
-    this.timeout = timeout;
-  }
+  constructor(
+    // 历史构造签名兼容：超时实际由 aiClient 统一控制，不再消费该参数
+    _timeout: number = 60000,
+  ) {}
 
   // ── 非流式功能（委托域模块） ─────────────────────────