compressed-context 0.1.0 → 0.2.0

package/src/compression/settings-rpc.ts

@@ -1,111 +1,123 @@
-import type { Plugin } from "@opencode/plugin"
-
-import type { SummaryBlock } from "../shared/blocks.ts"
-import { ContextRpc } from "../shared/rpc.ts"
-import { loadCacheHistory, recordCacheHistory } from "./cache-history.ts"
-import { activeBlocks, renderSummary } from "./render.ts"
-import { isBabelSummary, isMarkdownSummary } from "./schema.ts"
-import { loadState } from "./state.ts"
-import {
-  RESOLVED_WINDOW_KEY,
-  loadServerSettings,
-  parseServerSettings,
-  saveServerSettings,
-  windowKey,
-} from "./settings.ts"
-
-/** 注册句柄的最小结构。 */
-export interface Disposable {
-  dispose(): Promise<void>
-}
-
-/**
- * 输入：服务端插件上下文。
- * 输出：注册 settingsGet / settingsSet / blocksGet / cacheHistoryGet，并返回注销句柄。
- * 预期：TUI 推来的设置存进 ctx.storage；非法值返回 ok:false；读取时带上最近解析到的原生窗口；
- *       blocksGet 只返回 active 链，cacheHistoryGet 读取前先补写当前上下文。
- */
-export async function registerSettingsRpc(ctx: Plugin.Context): Promise<Disposable> {
-  return ctx.rpc.register(ContextRpc, {
-    settingsGet: async (input) => {
-      const settings = await loadServerSettings(ctx.storage)
-      const requested = (input as { readonly sessionID?: unknown }).sessionID
-      const sessionID = typeof requested === "string" && requested.length > 0 ? requested : undefined
-      // 优先返回当前会话模型自己的窗口；拿不到再退回最近一次解析值。
-      let resolvedWindow: number | undefined
-      if (sessionID !== undefined) {
-        try {
-          const session = await ctx.session.get({ sessionID })
-          const model = session.model
-          if (model !== undefined) {
-            const stored = await ctx.storage.get(windowKey(model.providerID, model.id))
-            if (typeof stored === "number" && stored > 0) resolvedWindow = stored
-          }
-        } catch {
-          // 会话不存在或模型未知：回退到最近一次解析值
-        }
-      }
-      if (resolvedWindow === undefined) {
-        const stored = await ctx.storage.get(RESOLVED_WINDOW_KEY)
-        if (typeof stored === "number" && stored > 0) resolvedWindow = stored
-      }
-      return {
-        contextLimit: settings.contextLimit,
-        triggerPercent: settings.triggerPercent,
-        nudgeGrowthTokens: settings.nudgeGrowthTokens,
-        summaryBlockPercent: settings.summaryBlockPercent,
-        summaryTotalPercent: settings.summaryTotalPercent,
-        summaryLanguage: settings.summaryLanguage,
-        summaryFormat: settings.summaryFormat,
-        autoCompress: settings.autoCompress,
-        enableCompressTool: settings.enableCompressTool,
-        enableDecompressTool: settings.enableDecompressTool,
-        showTimeline: settings.showTimeline,
-        showBlockTokens: settings.showBlockTokens,
-        decompressInlineMax: settings.decompressInlineMax,
-        decompressTempCap: settings.decompressTempCap,
-        decompressShowTokens: settings.decompressShowTokens,
-        ...(resolvedWindow === undefined ? {} : { resolvedWindow }),
-      }
-    },
-    settingsSet: async (input) => {
-      const current = await loadServerSettings(ctx.storage)
-      const parsed = parseServerSettings({ ...current, ...(input as Record<string, unknown>) })
-      if (!parsed) return { ok: false }
-      await saveServerSettings(ctx.storage, parsed)
-      return { ok: true }
-    },
-    blocksGet: async (input) => {
-      const sessionID = (input as { readonly sessionID: string }).sessionID
-      const state = await loadState(ctx.storage, sessionID)
-      // 只返回模型实际看到的 active 链；被合并掉的源块不展示。
-      const blocks: SummaryBlock[] = activeBlocks(state.blocks, state.pending).map((block) => ({
-        id: block.id,
-        tier: block.tier,
-        format: isBabelSummary(block.summary)
-          ? "babel"
-          : isMarkdownSummary(block.summary)
-            ? "markdown"
-            : "json",
-        title: block.summary.title,
-        at: block.at,
-        tokensBefore: block.tokensBefore,
-        tokensAfter: block.tokensAfter,
-        ...(block.sourceBlockIds === undefined ? {} : { sourceBlockIds: [...block.sourceBlockIds] }),
-        body: renderSummary(block.summary),
-      }))
-      return { blocks }
-    },
-    cacheHistoryGet: async (input) => {
-      const sessionID = (input as { readonly sessionID: string }).sessionID
-      const history = await loadCacheHistory(ctx.storage, sessionID)
-      // 只在历史为空时补写一次；已有历史时只读，避免每次 TUI 刷新都拉全文。
-      if (history.samples.length === 0) {
-        await recordCacheHistory(ctx, sessionID)
-        const bootstrapped = await loadCacheHistory(ctx.storage, sessionID)
-        return { samples: bootstrapped.samples }
-      }
-      return { samples: history.samples }
-    },
-  })
-}
+import type { Plugin } from "@opencode/plugin"
+
+import type { SummaryBlock } from "../shared/blocks.ts"
+import { ContextRpc } from "../shared/rpc.ts"
+import { loadCacheHistory, recordCacheHistory } from "./cache-history.ts"
+import { activeBlocks, renderSummary } from "./render.ts"
+import { isBabelSummary, isMarkdownSummary } from "./schema.ts"
+import { loadState } from "./state.ts"
+import {
+  RESOLVED_WINDOW_KEY,
+  loadServerSettings,
+  parseServerSettings,
+  saveServerSettings,
+  type ServerSettings,
+  windowKey,
+} from "./settings.ts"
+
+/** 注册句柄的最小结构。 */
+export interface Disposable {
+  dispose(): Promise<void>
+}
+
+/** 设置 RPC 的可选回调。 */
+export interface SettingsRpcOptions {
+  /** 输入：刚保存的设置；输出：无；预期：让 compress 工具的描述与参数跟着摘要格式切换。 */
+  readonly onSaved?: (settings: ServerSettings) => Promise<void>
+}
+
+/**
+ * 输入：服务端插件上下文 + 可选保存回调。
+ * 输出：注册 settingsGet / settingsSet / blocksGet / cacheHistoryGet，并返回注销句柄。
+ * 预期：TUI 推来的设置存进 ctx.storage；非法值返回 ok:false；读取时带上最近解析到的原生窗口；
+ *       blocksGet 只返回 active 链，cacheHistoryGet 读取前先补写当前上下文；
+ *       保存成功后调用 onSaved，让依赖设置的运行时（工具描述）立刻更新。
+ */
+export async function registerSettingsRpc(
+  ctx: Plugin.Context,
+  options?: SettingsRpcOptions,
+): Promise<Disposable> {
+  return ctx.rpc.register(ContextRpc, {
+    settingsGet: async (input) => {
+      const settings = await loadServerSettings(ctx.storage)
+      const requested = (input as { readonly sessionID?: unknown }).sessionID
+      const sessionID = typeof requested === "string" && requested.length > 0 ? requested : undefined
+      // 优先返回当前会话模型自己的窗口；拿不到再退回最近一次解析值。
+      let resolvedWindow: number | undefined
+      if (sessionID !== undefined) {
+        try {
+          const session = await ctx.session.get({ sessionID })
+          const model = session.model
+          if (model !== undefined) {
+            const stored = await ctx.storage.get(windowKey(model.providerID, model.id))
+            if (typeof stored === "number" && stored > 0) resolvedWindow = stored
+          }
+        } catch {
+          // 会话不存在或模型未知：回退到最近一次解析值
+        }
+      }
+      if (resolvedWindow === undefined) {
+        const stored = await ctx.storage.get(RESOLVED_WINDOW_KEY)
+        if (typeof stored === "number" && stored > 0) resolvedWindow = stored
+      }
+      return {
+        contextLimit: settings.contextLimit,
+        triggerPercent: settings.triggerPercent,
+        nudgeGrowthTokens: settings.nudgeGrowthTokens,
+        summaryBlockPercent: settings.summaryBlockPercent,
+        summaryTotalPercent: settings.summaryTotalPercent,
+        summaryLanguage: settings.summaryLanguage,
+        summaryFormat: settings.summaryFormat,
+        autoCompress: settings.autoCompress,
+        enableCompressTool: settings.enableCompressTool,
+        enableDecompressTool: settings.enableDecompressTool,
+        showTimeline: settings.showTimeline,
+        showBlockTokens: settings.showBlockTokens,
+        decompressInlineMax: settings.decompressInlineMax,
+        decompressTempCap: settings.decompressTempCap,
+        decompressShowTokens: settings.decompressShowTokens,
+        ...(resolvedWindow === undefined ? {} : { resolvedWindow }),
+      }
+    },
+    settingsSet: async (input) => {
+      const current = await loadServerSettings(ctx.storage)
+      const parsed = parseServerSettings({ ...current, ...(input as Record<string, unknown>) })
+      if (!parsed) return { ok: false }
+      await saveServerSettings(ctx.storage, parsed)
+      if (options?.onSaved !== undefined) await options.onSaved(parsed)
+      return { ok: true }
+    },
+    blocksGet: async (input) => {
+      const sessionID = (input as { readonly sessionID: string }).sessionID
+      const state = await loadState(ctx.storage, sessionID)
+      // 只返回模型实际看到的 active 链；被合并掉的源块不展示。
+      const blocks: SummaryBlock[] = activeBlocks(state.blocks, state.pending).map((block) => ({
+        id: block.id,
+        tier: block.tier,
+        format: isBabelSummary(block.summary)
+          ? "babel"
+          : isMarkdownSummary(block.summary)
+            ? "markdown"
+            : "json",
+        title: block.summary.title,
+        at: block.at,
+        tokensBefore: block.tokensBefore,
+        tokensAfter: block.tokensAfter,
+        ...(block.sourceBlockIds === undefined ? {} : { sourceBlockIds: [...block.sourceBlockIds] }),
+        body: renderSummary(block.summary),
+      }))
+      return { blocks }
+    },
+    cacheHistoryGet: async (input) => {
+      const sessionID = (input as { readonly sessionID: string }).sessionID
+      const history = await loadCacheHistory(ctx.storage, sessionID)
+      // 只在历史为空时补写一次；已有历史时只读，避免每次 TUI 刷新都拉全文。
+      if (history.samples.length === 0) {
+        await recordCacheHistory(ctx, sessionID)
+        const bootstrapped = await loadCacheHistory(ctx.storage, sessionID)
+        return { samples: bootstrapped.samples }
+      }
+      return { samples: history.samples }
+    },
+  })
+}

package/src/compression/settings.ts

@@ -1,175 +1,175 @@
-import type { Schema } from "effect"
-
-import {
-  DEFAULT_AUTO_COMPRESS,
-  DEFAULT_DECOMPRESS_INLINE_MAX,
-  DEFAULT_DECOMPRESS_SHOW_TOKENS,
-  DEFAULT_DECOMPRESS_TEMP_CAP,
-  DEFAULT_ENABLE_COMPRESS_TOOL,
-  DEFAULT_ENABLE_DECOMPRESS_TOOL,
-  DEFAULT_NUDGE_GROWTH_TOKENS,
-  DEFAULT_SHOW_BLOCK_TOKENS,
-  DEFAULT_SHOW_TIMELINE,
-  DEFAULT_SUMMARY_BLOCK_PERCENT,
-  DEFAULT_SUMMARY_FORMAT,
-  DEFAULT_SUMMARY_TOTAL_PERCENT,
-  MAX_DECOMPRESS_INLINE_MAX,
-  MAX_DECOMPRESS_TEMP_CAP,
-  MAX_CONTEXT_LIMIT,
-  MAX_SUMMARY_PERCENT,
-  MAX_TRIGGER_PERCENT,
-  MIN_CONTEXT_LIMIT,
-  MIN_DECOMPRESS_INLINE_MAX,
-  MIN_DECOMPRESS_TEMP_CAP,
-  MIN_SUMMARY_PERCENT,
-  MIN_TRIGGER_PERCENT,
-  isSummaryLanguage,
-  isSummaryFormat,
-  type CompressionSettings,
-} from "../shared/settings.ts"
-import { readOptionalInt, readStrictBoolean } from "../shared/parse.ts"
-import type { StorageLike } from "./state.ts"
-
-/** 服务端从 TUI 收到的设置；字段与 shared 的 CompressionSettings 一致。 */
-export type ServerSettings = CompressionSettings
-
-export const SETTINGS_KEY = "settings"
-/** 插件最近一次从模型解析到的原生窗口；TUI 用它把绝对值换算成百分比。 */
-export const RESOLVED_WINDOW_KEY = "window:last"
-
-/** 最近一次解析到的「生效窗口」＝ min(settings.contextLimit, 原生窗口)；自动压缩用它折算阈值。 */
-export const EFFECTIVE_WINDOW_KEY = "window:effective"
-
-/** 输入：模型标识；输出：该模型原生窗口在 storage 里的 key。 */
-export function windowKey(providerID: string, modelID: string): string {
-  return `window:${providerID}/${modelID}`
-}
-
-export const DEFAULT_SERVER_SETTINGS: ServerSettings = {
-  contextLimit: "auto",
-  triggerPercent: 80,
-  nudgeGrowthTokens: DEFAULT_NUDGE_GROWTH_TOKENS,
-  summaryBlockPercent: DEFAULT_SUMMARY_BLOCK_PERCENT,
-  summaryTotalPercent: DEFAULT_SUMMARY_TOTAL_PERCENT,
-  summaryLanguage: "auto",
-  summaryFormat: DEFAULT_SUMMARY_FORMAT,
-  autoCompress: DEFAULT_AUTO_COMPRESS,
-  enableCompressTool: DEFAULT_ENABLE_COMPRESS_TOOL,
-  enableDecompressTool: DEFAULT_ENABLE_DECOMPRESS_TOOL,
-  showTimeline: DEFAULT_SHOW_TIMELINE,
-  showBlockTokens: DEFAULT_SHOW_BLOCK_TOKENS,
-  decompressInlineMax: DEFAULT_DECOMPRESS_INLINE_MAX,
-  decompressTempCap: DEFAULT_DECOMPRESS_TEMP_CAP,
-  decompressShowTokens: DEFAULT_DECOMPRESS_SHOW_TOKENS,
-}
-
-/**
- * 输入：storage 里的原始值。
- * 输出：合法设置；非法返回 undefined。
- * 预期：范围外的值一律拒绝，不静默修正。
- */
-export function parseServerSettings(value: unknown): ServerSettings | undefined {
-  if (typeof value !== "object" || value === null) return undefined
-  const record = value as Record<string, unknown>
-  const limit = record["contextLimit"]
-  const percent = record["triggerPercent"]
-  const nudge = record["nudgeGrowthTokens"] ?? DEFAULT_NUDGE_GROWTH_TOKENS
-  const blockPercent = record["summaryBlockPercent"] ?? DEFAULT_SUMMARY_BLOCK_PERCENT
-  const totalPercent = record["summaryTotalPercent"] ?? DEFAULT_SUMMARY_TOTAL_PERCENT
-  const language = record["summaryLanguage"] ?? "auto"
-  const summaryFormat = record["summaryFormat"] ?? DEFAULT_SUMMARY_FORMAT
-  if (
-    limit !== "auto" &&
-    (typeof limit !== "number" ||
-      !Number.isFinite(limit) ||
-      limit < MIN_CONTEXT_LIMIT ||
-      limit > MAX_CONTEXT_LIMIT)
-  ) {
-    return undefined
-  }
-  if (
-    typeof percent !== "number" ||
-    !Number.isFinite(percent) ||
-    percent < MIN_TRIGGER_PERCENT ||
-    percent > MAX_TRIGGER_PERCENT
-  ) {
-    return undefined
-  }
-  if (
-    typeof nudge !== "number" ||
-    !Number.isFinite(nudge) ||
-    (nudge !== 0 && (nudge < 1_000 || nudge > 200_000))
-  ) {
-    return undefined
-  }
-  if (
-    typeof blockPercent !== "number" ||
-    !Number.isFinite(blockPercent) ||
-    blockPercent < MIN_SUMMARY_PERCENT ||
-    blockPercent > MAX_SUMMARY_PERCENT
-  ) {
-    return undefined
-  }
-  if (
-    typeof totalPercent !== "number" ||
-    !Number.isFinite(totalPercent) ||
-    totalPercent < MIN_SUMMARY_PERCENT ||
-    totalPercent > MAX_SUMMARY_PERCENT
-  ) {
-    return undefined
-  }
-  if (!isSummaryLanguage(language)) return undefined
-  if (!isSummaryFormat(summaryFormat)) return undefined
-  const autoCompress = readStrictBoolean(record["autoCompress"], DEFAULT_AUTO_COMPRESS)
-  const enableCompressTool = readStrictBoolean(record["enableCompressTool"], DEFAULT_ENABLE_COMPRESS_TOOL)
-  const enableDecompressTool = readStrictBoolean(record["enableDecompressTool"], DEFAULT_ENABLE_DECOMPRESS_TOOL)
-  const showTimeline = readStrictBoolean(record["showTimeline"], DEFAULT_SHOW_TIMELINE)
-  const showBlockTokens = readStrictBoolean(record["showBlockTokens"], DEFAULT_SHOW_BLOCK_TOKENS)
-  const decompressShowTokens = readStrictBoolean(record["decompressShowTokens"], DEFAULT_DECOMPRESS_SHOW_TOKENS)
-  if (
-    autoCompress === undefined ||
-    enableCompressTool === undefined ||
-    enableDecompressTool === undefined ||
-    showTimeline === undefined ||
-    showBlockTokens === undefined ||
-    decompressShowTokens === undefined
-  ) {
-    return undefined
-  }
-  const decompressInlineMax =
-    record["decompressInlineMax"] === undefined
-      ? DEFAULT_DECOMPRESS_INLINE_MAX
-      : readOptionalInt(record["decompressInlineMax"], MIN_DECOMPRESS_INLINE_MAX, MAX_DECOMPRESS_INLINE_MAX)
-  const decompressTempCap =
-    record["decompressTempCap"] === undefined
-      ? DEFAULT_DECOMPRESS_TEMP_CAP
-      : readOptionalInt(record["decompressTempCap"], MIN_DECOMPRESS_TEMP_CAP, MAX_DECOMPRESS_TEMP_CAP)
-  if (decompressInlineMax === undefined || decompressTempCap === undefined) return undefined
-  return {
-    contextLimit: limit,
-    triggerPercent: Math.round(percent),
-    nudgeGrowthTokens: Math.round(nudge),
-    summaryBlockPercent: Math.round(blockPercent * 10) / 10,
-    summaryTotalPercent: Math.round(totalPercent * 10) / 10,
-    summaryLanguage: language,
-    summaryFormat,
-    autoCompress,
-    enableCompressTool,
-    enableDecompressTool,
-    showTimeline,
-    showBlockTokens,
-    decompressInlineMax,
-    decompressTempCap,
-    decompressShowTokens,
-  }
-}
-
-/** 输入：storage；输出：设置（缺失或损坏时用默认值）。 */
-export async function loadServerSettings(storage: StorageLike): Promise<ServerSettings> {
-  return parseServerSettings(await storage.get(SETTINGS_KEY)) ?? DEFAULT_SERVER_SETTINGS
-}
-
-/** 输入：storage + 设置；输出：无。 */
-export async function saveServerSettings(storage: StorageLike, settings: ServerSettings): Promise<void> {
-  await storage.set(SETTINGS_KEY, settings as unknown as Schema.Json)
-}
+import type { Schema } from "effect"
+
+import {
+  DEFAULT_AUTO_COMPRESS,
+  DEFAULT_DECOMPRESS_INLINE_MAX,
+  DEFAULT_DECOMPRESS_SHOW_TOKENS,
+  DEFAULT_DECOMPRESS_TEMP_CAP,
+  DEFAULT_ENABLE_COMPRESS_TOOL,
+  DEFAULT_ENABLE_DECOMPRESS_TOOL,
+  DEFAULT_NUDGE_GROWTH_TOKENS,
+  DEFAULT_SHOW_BLOCK_TOKENS,
+  DEFAULT_SHOW_TIMELINE,
+  DEFAULT_SUMMARY_BLOCK_PERCENT,
+  DEFAULT_SUMMARY_FORMAT,
+  DEFAULT_SUMMARY_TOTAL_PERCENT,
+  MAX_DECOMPRESS_INLINE_MAX,
+  MAX_DECOMPRESS_TEMP_CAP,
+  MAX_CONTEXT_LIMIT,
+  MAX_SUMMARY_PERCENT,
+  MAX_TRIGGER_PERCENT,
+  MIN_CONTEXT_LIMIT,
+  MIN_DECOMPRESS_INLINE_MAX,
+  MIN_DECOMPRESS_TEMP_CAP,
+  MIN_SUMMARY_PERCENT,
+  MIN_TRIGGER_PERCENT,
+  isSummaryLanguage,
+  isSummaryFormat,
+  type CompressionSettings,
+} from "../shared/settings.ts"
+import { readOptionalInt, readStrictBoolean } from "../shared/parse.ts"
+import type { StorageLike } from "./state.ts"
+
+/** 服务端从 TUI 收到的设置；字段与 shared 的 CompressionSettings 一致。 */
+export type ServerSettings = CompressionSettings
+
+export const SETTINGS_KEY = "settings"
+/** 插件最近一次从模型解析到的原生窗口；TUI 用它把绝对值换算成百分比。 */
+export const RESOLVED_WINDOW_KEY = "window:last"
+
+/** 最近一次解析到的「生效窗口」＝ min(settings.contextLimit, 原生窗口)；自动压缩用它折算阈值。 */
+export const EFFECTIVE_WINDOW_KEY = "window:effective"
+
+/** 输入：模型标识；输出：该模型原生窗口在 storage 里的 key。 */
+export function windowKey(providerID: string, modelID: string): string {
+  return `window:${providerID}/${modelID}`
+}
+
+export const DEFAULT_SERVER_SETTINGS: ServerSettings = {
+  contextLimit: "auto",
+  triggerPercent: 80,
+  nudgeGrowthTokens: DEFAULT_NUDGE_GROWTH_TOKENS,
+  summaryBlockPercent: DEFAULT_SUMMARY_BLOCK_PERCENT,
+  summaryTotalPercent: DEFAULT_SUMMARY_TOTAL_PERCENT,
+  summaryLanguage: "auto",
+  summaryFormat: DEFAULT_SUMMARY_FORMAT,
+  autoCompress: DEFAULT_AUTO_COMPRESS,
+  enableCompressTool: DEFAULT_ENABLE_COMPRESS_TOOL,
+  enableDecompressTool: DEFAULT_ENABLE_DECOMPRESS_TOOL,
+  showTimeline: DEFAULT_SHOW_TIMELINE,
+  showBlockTokens: DEFAULT_SHOW_BLOCK_TOKENS,
+  decompressInlineMax: DEFAULT_DECOMPRESS_INLINE_MAX,
+  decompressTempCap: DEFAULT_DECOMPRESS_TEMP_CAP,
+  decompressShowTokens: DEFAULT_DECOMPRESS_SHOW_TOKENS,
+}
+
+/**
+ * 输入：storage 里的原始值。
+ * 输出：合法设置；非法返回 undefined。
+ * 预期：范围外的值一律拒绝，不静默修正。
+ */
+export function parseServerSettings(value: unknown): ServerSettings | undefined {
+  if (typeof value !== "object" || value === null) return undefined
+  const record = value as Record<string, unknown>
+  const limit = record["contextLimit"]
+  const percent = record["triggerPercent"]
+  const nudge = record["nudgeGrowthTokens"] ?? DEFAULT_NUDGE_GROWTH_TOKENS
+  const blockPercent = record["summaryBlockPercent"] ?? DEFAULT_SUMMARY_BLOCK_PERCENT
+  const totalPercent = record["summaryTotalPercent"] ?? DEFAULT_SUMMARY_TOTAL_PERCENT
+  const language = record["summaryLanguage"] ?? "auto"
+  const summaryFormat = record["summaryFormat"] ?? DEFAULT_SUMMARY_FORMAT
+  if (
+    limit !== "auto" &&
+    (typeof limit !== "number" ||
+      !Number.isFinite(limit) ||
+      limit < MIN_CONTEXT_LIMIT ||
+      limit > MAX_CONTEXT_LIMIT)
+  ) {
+    return undefined
+  }
+  if (
+    typeof percent !== "number" ||
+    !Number.isFinite(percent) ||
+    percent < MIN_TRIGGER_PERCENT ||
+    percent > MAX_TRIGGER_PERCENT
+  ) {
+    return undefined
+  }
+  if (
+    typeof nudge !== "number" ||
+    !Number.isFinite(nudge) ||
+    (nudge !== 0 && (nudge < 1_000 || nudge > 200_000))
+  ) {
+    return undefined
+  }
+  if (
+    typeof blockPercent !== "number" ||
+    !Number.isFinite(blockPercent) ||
+    blockPercent < MIN_SUMMARY_PERCENT ||
+    blockPercent > MAX_SUMMARY_PERCENT
+  ) {
+    return undefined
+  }
+  if (
+    typeof totalPercent !== "number" ||
+    !Number.isFinite(totalPercent) ||
+    totalPercent < MIN_SUMMARY_PERCENT ||
+    totalPercent > MAX_SUMMARY_PERCENT
+  ) {
+    return undefined
+  }
+  if (!isSummaryLanguage(language)) return undefined
+  if (!isSummaryFormat(summaryFormat)) return undefined
+  const autoCompress = readStrictBoolean(record["autoCompress"], DEFAULT_AUTO_COMPRESS)
+  const enableCompressTool = readStrictBoolean(record["enableCompressTool"], DEFAULT_ENABLE_COMPRESS_TOOL)
+  const enableDecompressTool = readStrictBoolean(record["enableDecompressTool"], DEFAULT_ENABLE_DECOMPRESS_TOOL)
+  const showTimeline = readStrictBoolean(record["showTimeline"], DEFAULT_SHOW_TIMELINE)
+  const showBlockTokens = readStrictBoolean(record["showBlockTokens"], DEFAULT_SHOW_BLOCK_TOKENS)
+  const decompressShowTokens = readStrictBoolean(record["decompressShowTokens"], DEFAULT_DECOMPRESS_SHOW_TOKENS)
+  if (
+    autoCompress === undefined ||
+    enableCompressTool === undefined ||
+    enableDecompressTool === undefined ||
+    showTimeline === undefined ||
+    showBlockTokens === undefined ||
+    decompressShowTokens === undefined
+  ) {
+    return undefined
+  }
+  const decompressInlineMax =
+    record["decompressInlineMax"] === undefined
+      ? DEFAULT_DECOMPRESS_INLINE_MAX
+      : readOptionalInt(record["decompressInlineMax"], MIN_DECOMPRESS_INLINE_MAX, MAX_DECOMPRESS_INLINE_MAX)
+  const decompressTempCap =
+    record["decompressTempCap"] === undefined
+      ? DEFAULT_DECOMPRESS_TEMP_CAP
+      : readOptionalInt(record["decompressTempCap"], MIN_DECOMPRESS_TEMP_CAP, MAX_DECOMPRESS_TEMP_CAP)
+  if (decompressInlineMax === undefined || decompressTempCap === undefined) return undefined
+  return {
+    contextLimit: limit,
+    triggerPercent: Math.round(percent),
+    nudgeGrowthTokens: Math.round(nudge),
+    summaryBlockPercent: Math.round(blockPercent * 10) / 10,
+    summaryTotalPercent: Math.round(totalPercent * 10) / 10,
+    summaryLanguage: language,
+    summaryFormat,
+    autoCompress,
+    enableCompressTool,
+    enableDecompressTool,
+    showTimeline,
+    showBlockTokens,
+    decompressInlineMax,
+    decompressTempCap,
+    decompressShowTokens,
+  }
+}
+
+/** 输入：storage；输出：设置（缺失或损坏时用默认值）。 */
+export async function loadServerSettings(storage: StorageLike): Promise<ServerSettings> {
+  return parseServerSettings(await storage.get(SETTINGS_KEY)) ?? DEFAULT_SERVER_SETTINGS
+}
+
+/** 输入：storage + 设置；输出：无。 */
+export async function saveServerSettings(storage: StorageLike, settings: ServerSettings): Promise<void> {
+  await storage.set(SETTINGS_KEY, settings as unknown as Schema.Json)
+}