refactor(notes): move derivations to colorPalette

NotesPage 300/300 (C9 余量 0) 拆件：两个 useMemo 的派生逻辑逐字搬入 utils/colorPalette（已是 resolveNoteColor 四档解析的真源），页面侧改为调用 => 300 -> 285；补 3 条纯函数判据（groupFilter / filterSealed / 四档色板优先级），既有用例零改动。

Author: Aparencia

app/src/pages/NotesPage.tsx

@@ -16,7 +16,7 @@
 import { useCallback, useEffect, useMemo, useRef, useState } from "react";
 import { invoke } from "@tauri-apps/api/core";
 import type { Note } from "../types";
-import { resolveNoteColor } from "../utils/colorPalette";
+import { buildNoteColorMap, visibleNotesOf } from "../utils/colorPalette";
 // 批 8（REQ-317）：模型卡对话框槽（拆件）与选区行动类编排（hook 收敛）
 import { useNoteSelectionActions } from "../hooks/useNoteSelectionActions";
 import NotesGroupsColumn from "../components/notes/NotesGroupsColumn";
@@ -173,24 +173,9 @@ export default function NotesPage({ focusNoteId, focusNoteSearch, focusGroupId,
     setEditing(false);
   };
 
-  // v0.11.0：组过滤在客户端生效（列表已全量加载；组切换零请求）
-  // v0.20.3（REQ-301）+2026-09-06 审查（TD-E）：SE 封存默认不可见——#树洞
-  // tag 精确匹配（防“树洞XX”子串误滤）；除显式显隐开关外任何视图态均排除
-  const visibleNotes = useMemo(() => {
-    const filtered = groupFilter === null ? list.notes : list.notes.filter((n) => n.group_id === groupFilter);
-    return filterSealed(filtered);
-  }, [list.notes, groupFilter, filterSealed]);
-
-  // v0.14 B：组映射（noteId → 组，resolveNoteColor 组继承档用）
-  const groupMap = useMemo(() => new Map(list.groups.map((g) => [g.id, g])), [list.groups]);
-  // v0.14 B：笔记色板 id 映射（四档优先级解析——笔记显式 > 组继承 > 标签 > 默认灰）
-  const noteColors = useMemo(() => {
-    const m: Record<number, string | null> = {};
-    for (const n of visibleNotes) {
-      m[n.id] = resolveNoteColor(n, n.group_id != null ? groupMap.get(n.group_id) : null, list.tagColors);
-    }
-    return m;
-  }, [visibleNotes, groupMap, list.tagColors]);
+  // 批 5 T4：可见笔记（组过滤 + SE 封存）与色板映射的派生搬进 utils/colorPalette
+  const visibleNotes = useMemo(() => visibleNotesOf(list.notes, groupFilter, filterSealed), [list.notes, groupFilter, filterSealed]);
+  const noteColors = useMemo(() => buildNoteColorMap(visibleNotes, list.groups, list.tagColors), [visibleNotes, list.groups, list.tagColors]);
 
   return (
     <div style={{ display: "flex", height: "calc(100vh - var(--ed-nav-h))", minHeight: 0 }}>

app/src/utils/colorPalette.test.ts

@@ -8,14 +8,17 @@ import { describe, expect, it } from "vitest";
 import {
   COLOR_IDS,
   COLOR_PALETTE,
+  buildNoteColorMap,
   contrastRatio,
   isColorId,
   isThemeSafe,
   onColorText,
   paletteHex,
   parseNoteProperties,
   resolveNoteColor,
+  visibleNotesOf,
 } from "./colorPalette";
+import type { Note, NoteGroup } from "../types";
 
 describe("colorPalette 对比度基础", () => {
   it("黑白对比度为 21:1", () => {
@@ -118,3 +121,43 @@ describe("resolveNoteColor 四档优先级", () => {
     expect(resolveNoteColor(note, null, {})).toBe("neon");
   });
 });
+
+// ── 批 5 T4：自 NotesPage 搬入的两个派生（判据随搬入新增；既有用例未改）──
+const mkNote = (id: number, group_id: number | null, tags = "[]", properties: string | null = null): Note =>
+  ({ id, title: `n${id}`, content: "", source: "manual", tags, properties, pin: 0, group_id, created_at: 1, updated_at: 2 });
+
+const mkGroup = (id: number, color: string | null): NoteGroup =>
+  ({ id, name: `g${id}`, terrain: "container", kind: "topic", domainTag: null, source: "manual",
+    seriesKey: null, routeReason: null, routeOverridden: 0, color, noteCount: 1, createdAt: 1, updatedAt: 2 });
+
+describe("visibleNotesOf 组过滤 + 封存过滤（批 5 T4 搬入）", () => {
+  it("① groupFilter 生效：只留该组；null = 全量（含未归组）", () => {
+    const notes = [mkNote(1, 7), mkNote(2, 8), mkNote(3, null)];
+    const keep = (n: Note[]) => n;
+    expect(visibleNotesOf(notes, 7, keep).map((n) => n.id)).toEqual([1]);
+    expect(visibleNotesOf(notes, null, keep).map((n) => n.id)).toEqual([1, 2, 3]);
+  });
+
+  it("② filterSealed 生效：恒真桩原样透传（同一引用，不复制）/ 恒假桩滤空", () => {
+    const notes = [mkNote(1, 7)];
+    const keep = (n: Note[]) => n;
+    const drop = (): Note[] => [];
+    expect(visibleNotesOf(notes, null, keep)).toBe(notes);
+    expect(visibleNotesOf(notes, null, drop)).toEqual([]);
+  });
+});
+
+describe("buildNoteColorMap 色板优先级（批 5 T4 搬入）", () => {
+  it("③ 笔记显式 > 组继承 > 标签 > 默认灰；未归组/组不存在都不查组表", () => {
+    const groups = [mkGroup(7, "green")];
+    const tagColors = { 编程: "blue" };
+    const notes = [
+      mkNote(1, 7, '["编程"]', '{"color":"purple"}'), // 显式优先
+      mkNote(2, 7, '["编程"]'),                        // 组继承次之
+      mkNote(3, null, '["编程"]'),                     // 未归组 → 标签档
+      mkNote(4, 9, "[]"),                              // 组不存在 → 默认灰
+      mkNote(5, null, "[]"),                           // 全无量 → 默认灰
+    ];
+    expect(buildNoteColorMap(notes, groups, tagColors)).toEqual({ 1: "purple", 2: "green", 3: "blue", 4: null, 5: null });
+  });
+});

app/src/utils/colorPalette.ts

@@ -6,7 +6,12 @@
  *              isThemeSafe/onColorText 决定色块上的文字颜色（黑/白取高对比），
  *              resolveNoteColor 统一卡片/列表/侧栏的颜色来源（spec §4.3）。
  *              未知色板 id 一律回退默认灰（数据损坏防御，不崩溃）。
+ * @ai-context: 批 5 T4——`NotesPage`（300/300 贴边）的「可见笔记派生」与「色板
+ *              id 映射」两个 useMemo 搬到这里（visibleNotesOf / buildNoteColorMap）；
+ *              归属理由：noteColors 被列表列与阅读列**共用**，且本文件已是
+ *              resolveNoteColor（四级解析）的真源 ⇒ 不制造第二份派生。
  */
+import type { Note, NoteGroup } from "../types";
 
 /** 色板 id（12 色；null=未设置/默认灰） */
 export type ColorId =
@@ -122,3 +127,49 @@ export function resolveNoteColor(
   }
   return null;
 }
+
+/**
+ * 可见笔记派生：组过滤 → SE 封存过滤（v0.11.0 + v0.20.3 REQ-301；批 5 T4 自
+ * `NotesPage` 逐字搬入）。
+ *
+ * @ai-context: 组过滤在客户端生效（列表已全量加载 ⇒ 组切换零请求）；SE 封存默认
+ *              不可见由注入的 filterSealed 承载（#树洞 tag 精确匹配，防「树洞XX」
+ *              子串误滤，见 `hooks/useNotesSealedFilter`）——本函数只把「先组过滤、
+ *              后封存过滤」的既有串接顺序固化在一处，供页面 memo 调用。
+ * @ai-context: 纯函数——不读 localStorage、不调 invoke、不改入参；groupFilter===null
+ *              时把 notes **原样**交给 filterSealed（不复制 ⇒ 保持下游 memo 的引用
+ *              语义，与拆前 `NotesPage.tsx:179-182` 逐字等价）。
+ * @ai-context: 形参 filterSealed 用 `(n: Note[]) => Note[]`（非 readonly）——消费者
+ *              `useNotesSealedFilter` 的实参是可变数组；readonly 形参在
+ *              `strictFunctionTypes` 下不可赋值（批 5 T4 实测 tsc TS2345）。
+ */
+export function visibleNotesOf(
+  notes: Note[],
+  groupFilter: number | null,
+  filterSealed: (n: Note[]) => Note[],
+): Note[] {
+  const filtered = groupFilter === null ? notes : notes.filter((n) => n.group_id === groupFilter);
+  return filterSealed(filtered);
+}
+
+/**
+ * 笔记色板 id 映射（v0.14 B；批 5 T4 自 `NotesPage` 逐字搬入）。
+ *
+ * @ai-context: 四档优先级解析的真源是 resolveNoteColor（笔记显式 > 组继承 > 标签 >
+ *              默认灰）；本函数只做「组表 → noteId → 组色」的查表与逐笔记求值。
+ * @ai-context: 纯函数——不读 localStorage、不调 invoke、不改入参（返回新对象）；
+ *              未归组笔记（group_id == null）传 null 组、不查表（防组 id 缺省时
+ *              误继承其它组色）。
+ */
+export function buildNoteColorMap(
+  visibleNotes: readonly Note[],
+  groups: readonly NoteGroup[],
+  tagColors: Readonly<Record<string, string>>,
+): Record<number, string | null> {
+  const groupMap = new Map(groups.map((g): [number, NoteGroup] => [g.id, g]));
+  const m: Record<number, string | null> = {};
+  for (const n of visibleNotes) {
+    m[n.id] = resolveNoteColor(n, n.group_id != null ? groupMap.get(n.group_id) : null, tagColors);
+  }
+  return m;
+}