dsh-context-compression-improved 0.1.1 → 0.2.0

package/packages/selector/src/client/EstimatorControls.tsx

@@ -0,0 +1,281 @@
+/**
+ * TokenPilot-inspired estimator channel card components.
+ *
+ * Extracted from CompressionProfileSelector.tsx to reduce god-module size.
+ *
+ * @module dsh-context-compression-improved/client/EstimatorControls
+ */
+
+import { useEffect, useState } from 'react'
+import type { ContextCompressionLocaleKey } from './locales.ts'
+import type { PresetOptionsPatch } from './preset-options.ts'
+import type { PresetOptionsSettings } from '../profiles.ts'
+import css from './CompressionProfileSelector.module.css'
+
+interface EstimatorInactiveNoticeProps {
+  /** Already-localized label of the profile that currently owns the selector. */
+  profile: string
+  t: (key: ContextCompressionLocaleKey) => string
+}
+
+/**
+ * The estimator card is gated on the tokenpilot-inspired profile, because
+ * `presetOptions` is merged into that profile alone. A card that merely
+ * disappears reads as a missing feature — the first real-machine report was
+ * exactly that — so keep the heading and its anchor id in place and spend them
+ * on the reason plus the profile that unlocks the card. The gate itself is
+ * unchanged: no estimator control exists outside tokenpilot-inspired.
+ */
+export function EstimatorInactiveNotice({ profile, t }: EstimatorInactiveNoticeProps) {
+  return (
+    <section className={css.autoCompact} aria-labelledby="context-compression-estimator-title">
+      <h3 id="context-compression-estimator-title" className={css.autoCompactTitle}>{t('estimator.title')}</h3>
+      <p className={css.customNote}>{t('estimator.inactive').replace('{profile}', profile)}</p>
+    </section>
+  )
+}
+
+interface EstimatorControlsProps {
+  options: PresetOptionsSettings
+  disabled: boolean
+  save: (options: PresetOptionsPatch) => Promise<void>
+  settle: (operation: () => Promise<void>) => void
+  t: (key: ContextCompressionLocaleKey) => string
+}
+
+interface CatalogModelEntry { readonly id: string, readonly name: string }
+interface CatalogProviderEntry { readonly id: string, readonly name: string, readonly models: readonly CatalogModelEntry[], readonly error?: string }
+interface EstimatorCatalogBody {
+  readonly ok?: boolean
+  readonly providers?: readonly CatalogProviderEntry[]
+  readonly selection?: { readonly provider: string, readonly model: string }
+}
+
+// The host channel is `/api`, and only `/api`: the pre-0.1.2 `/endpoint` prefix
+// does not exist on this tier's hosts, so probing it first only bought a
+// guaranteed 404 round-trip ahead of every successful load.
+export const ESTIMATOR_CATALOG_ROUTES = [
+  '/api/dsh-context-compression-improved/estimator-catalog',
+]
+
+/**
+ * TokenPilot-inspired estimator channel card. Shown only while the
+ * tokenpilot-inspired profile is selected, and split by channel:
+ *
+ * - `host` reuses the providers and credentials already configured in DSH
+ *   through the Harness `llm` service, so this card names a provider and a
+ *   model and accepts NO API key — the key field belongs to the direct channel
+ *   alone.
+ * - `direct` talks to a native OpenAI-compatible endpoint, the only channel
+ *   carrying its own base URL and write-only key.
+ *
+ * The whole card is advisory: an unconfigured or failing endpoint keeps every
+ * consumer on its rule-only fallback.
+ */
+export function EstimatorControls({ options, disabled, save, settle, t }: EstimatorControlsProps) {
+  const [keyDraft, setKeyDraft] = useState('')
+  const [baseUrl, setBaseUrl] = useState(options.estimatorBaseUrl ?? '')
+  const [model, setModel] = useState(options.estimatorModel ?? '')
+  const [provider, setProvider] = useState(options.estimatorProvider ?? '')
+  const mode = options.estimatorMode ?? ''
+  // Host-mode dropdown source: the live provider/model-group catalog served by
+  // the runtime's estimator-catalog route (dsh-perm-gate receiver pattern).
+  // Empty catalog (route missing / llm service absent) falls back to the
+  // manual text inputs so nothing breaks on hosts without the webServer.
+  const [catalog, setCatalog] = useState<EstimatorCatalogBody | undefined>()
+  useEffect(() => {
+    if (mode !== 'host') return
+    let alive = true
+    // The catalog route answers once the host webServer/llm services are up;
+    // poll briefly so the dropdowns fill without reopening the panel.
+    let attempts = 0
+    const load = async (routes: readonly string[]): Promise<EstimatorCatalogBody | undefined> => {
+      for (const route of routes) {
+        try {
+          const response = await fetch(route, { headers: { 'cache-control': 'no-cache' } })
+          if (response.ok) return (await response.json()) as EstimatorCatalogBody
+        } catch {
+          // try the next prefix
+        }
+      }
+      return undefined
+    }
+    const tick = (): void => {
+      attempts += 1
+      void load(ESTIMATOR_CATALOG_ROUTES).then((body) => {
+        if (!alive) return
+        if (body !== undefined && (body.providers?.length ?? 0) > 0) {
+          setCatalog(body)
+          return
+        }
+        if (attempts < 10) setTimeout(tick, 3_000)
+      })
+    }
+    tick()
+    return () => { alive = false }
+  }, [mode])
+  const hostProviders = catalog?.providers ?? []
+  // Model suggestions follow the provider draft exactly like dsh-perm-gate's
+  // receiver card: an empty provider lists every group's models, a chosen
+  // provider narrows to its own. The provider error (if any) rides along in
+  // the option label so a broken group is visible without blocking typing.
+  const providerDraft = provider
+  const hostModels = hostProviders
+    .filter(entry => providerDraft === '' || entry.id === providerDraft)
+    .flatMap(entry => entry.models.map(model => ({ ...model, provider: entry.id })))
+  const hostProvider = hostProviders.find(entry => entry.id === providerDraft)
+    ?? hostProviders.find(entry => entry.id === (options.estimatorProvider ?? ''))
+  const hasKey = (options.estimatorApiKey ?? '') !== ''
+  const commit = (patch: PresetOptionsPatch) => {
+    settle(() => save(patch))
+  }
+  // What the host channel would actually call right now: an explicit override
+  // wins, otherwise the session default the catalog reports. Naming the
+  // resolved route is the whole point of this channel — the user re-enters
+  // nothing the Harness already knows.
+  const overrideProvider = options.estimatorProvider ?? ''
+  const overrideModel = options.estimatorModel ?? ''
+  const effectiveProvider = overrideProvider !== '' ? overrideProvider : catalog?.selection?.provider ?? ''
+  const effectiveModel = overrideModel !== '' ? overrideModel : catalog?.selection?.model ?? ''
+  const effectiveRoute = effectiveProvider !== '' && effectiveModel !== ''
+    ? `${effectiveProvider} / ${effectiveModel}`
+    : t('estimator.hostUnresolved')
+  return (
+    <section className={css.autoCompact} aria-labelledby="context-compression-estimator-title">
+      <h3 id="context-compression-estimator-title" className={css.autoCompactTitle}>{t('estimator.title')}</h3>
+      <p className={css.customNote}>{t('estimator.description')}</p>
+      <label className={css.field}>
+        <span>{t('estimator.mode')}</span>
+        <select
+          value={mode}
+          disabled={disabled}
+          onChange={(event) => { settle(() => save({ estimatorMode: event.currentTarget.value as '' | 'host' | 'direct' })) }}
+        >
+          <option value="">{t('estimator.mode.off')}</option>
+          <option value="host">{t('estimator.mode.host')}</option>
+          <option value="direct">{t('estimator.mode.direct')}</option>
+        </select>
+      </label>
+      {mode === '' ? null : mode === 'host' ? (
+        <>
+          <label className={css.field}>
+            <span>{t('estimator.provider')}</span>
+            <input
+              type="text"
+              list="estimator-provider-options"
+              value={provider}
+              disabled={disabled}
+              placeholder={t('estimator.provider.placeholder')}
+              onChange={(event) => {
+                const next = event.currentTarget.value
+                setProvider(next)
+                // Picking from the datalist fires change without blur: commit
+                // an exact catalog hit immediately; free typing waits for blur
+                // so mid-edit keystrokes never disable the panel.
+                if (next !== '' && hostProviders.some(entry => entry.id === next)) {
+                  commit({ estimatorProvider: next })
+                }
+              }}
+              onBlur={() => { if (provider !== (options.estimatorProvider ?? '')) commit({ estimatorProvider: provider }) }}
+            />
+          </label>
+          {/* Datalists ride outside the labels on purpose: option text inside a
+              label would leak into its accessible name. */}
+          <datalist id="estimator-provider-options">
+            {hostProviders.map(entry => (
+              <option key={entry.id} value={entry.id}>
+                {entry.name === '' ? entry.id : entry.name}{entry.error === undefined ? '' : ` (${entry.error})`}
+              </option>
+            ))}
+          </datalist>
+          <label className={css.field}>
+            <span>{t('estimator.model')}</span>
+            <input
+              type="text"
+              list="estimator-model-options"
+              value={model}
+              disabled={disabled}
+              placeholder={t('estimator.model.placeholder')}
+              onChange={(event) => {
+                const next = event.currentTarget.value
+                setModel(next)
+                if (next !== '' && hostModels.some(entry => entry.id === next)) {
+                  commit({ estimatorModel: next })
+                }
+              }}
+              onBlur={() => { if (model !== (options.estimatorModel ?? '')) commit({ estimatorModel: model }) }}
+            />
+          </label>
+          <datalist id="estimator-model-options">
+            {hostModels.map(entry => (
+              <option key={`${entry.provider}\0${entry.id}`} value={entry.id}>{entry.name}</option>
+            ))}
+          </datalist>
+          {hostProvider?.error === undefined ? null : (
+            <p className={css.customNote}>{String(hostProvider.error)}</p>
+          )}
+          <p className={css.customNote}>{t('estimator.hostReuse')}</p>
+          <p className={css.customNote}>{t('estimator.hostRoute').replace('{route}', effectiveRoute)}</p>
+        </>
+      ) : (
+        <>
+          <label className={css.field}>
+            <span>{t('estimator.baseUrl')}</span>
+            <input
+              type="text"
+              value={baseUrl}
+              disabled={disabled}
+              placeholder="https://127.0.0.1:8000/v1"
+              onChange={(event) => { setBaseUrl(event.currentTarget.value) }}
+              onBlur={() => { if (baseUrl !== (options.estimatorBaseUrl ?? '')) commit({ estimatorBaseUrl: baseUrl }) }}
+            />
+          </label>
+          <label className={css.field}>
+            <span>{t('estimator.model')}</span>
+            <input
+              type="text"
+              value={model}
+              disabled={disabled}
+              placeholder={t('estimator.model.placeholder')}
+              onChange={(event) => { setModel(event.currentTarget.value) }}
+              onBlur={() => { if (model !== (options.estimatorModel ?? '')) commit({ estimatorModel: model }) }}
+            />
+          </label>
+          <label className={css.field}>
+            <span>{t('estimator.apiKey')}</span>
+            <div style={{ display: 'flex', gap: '6px' }}>
+              <input
+                type="password"
+                autoComplete="off"
+                spellCheck={false}
+                value={keyDraft}
+                disabled={disabled}
+                placeholder={hasKey ? t('estimator.apiKey.set') : t('estimator.apiKey.placeholder')}
+                onChange={(event) => { setKeyDraft(event.currentTarget.value) }}
+                onBlur={() => {
+                  const next = keyDraft.trim()
+                  if (next === '') return
+                  settle(() => save({ estimatorApiKey: next }))
+                  setKeyDraft('')
+                }}
+                onKeyDown={(event) => {
+                  if (event.key === 'Enter') event.currentTarget.blur()
+                }}
+              />
+              {hasKey ? (
+                <button
+                  type="button"
+                  disabled={disabled}
+                  onClick={() => { settle(() => save({ estimatorApiKey: undefined })) }}
+                >
+                  {t('estimator.apiKey.clear')}
+                </button>
+              ) : null}
+            </div>
+            {hasKey ? <span className={css.customNote}>{t('estimator.apiKey.overwrite')}</span> : null}
+          </label>
+        </>
+      )}
+    </section>
+  )
+}

package/packages/selector/src/client/decode.ts

@@ -0,0 +1,49 @@
+/** Browser-safe settings decoding shared by the client entry and node tests. */
+
+import {
+  canonicalizeCustomPolicy,
+  COMPRESSION_PROFILES,
+  decodeAutoCompactSettings,
+  decodeCodeSkeletonSettings,
+  decodePresetOptionsSettings,
+  isCustomCompressionPolicy,
+  isPlainRecord,
+  type CompressionProfile,
+  type ContextCompressionSettings,
+} from '../profiles.ts'
+
+/**
+ * Decode one stored context-compression settings document with exactly the
+ * runtime schema's strictness: a plain object with only `profile`, `custom`,
+ * `autoCompact`, and `codeSkeleton` keys, a supported profile, a valid Custom
+ * document canonicalized to v3 exactly as the runtime resolver would, a
+ * strictly-shaped autoCompact section (absent inherits the 80% default), and
+ * a strictly-shaped codeSkeleton gate (absent inherits off). Anything else
+ * decodes to `undefined` so the UI reports the document as unreadable instead
+ * of silently disagreeing with the runtime.
+ */
+export function decodeSettings(value: unknown): ContextCompressionSettings | undefined {
+  if (!isPlainRecord(value)) return undefined
+  const keys = Object.keys(value)
+  if (keys.some(key => key !== 'profile' && key !== 'custom' && key !== 'autoCompact' && key !== 'codeSkeleton' && key !== 'presetOptions')) {
+    return undefined
+  }
+  const profile = (value as { profile?: unknown }).profile
+  const custom = (value as { custom?: unknown }).custom
+  const autoCompact = decodeAutoCompactSettings((value as { autoCompact?: unknown }).autoCompact)
+  const codeSkeleton = decodeCodeSkeletonSettings((value as { codeSkeleton?: unknown }).codeSkeleton)
+  const presetOptions = decodePresetOptionsSettings((value as { presetOptions?: unknown }).presetOptions)
+  return typeof profile === 'string'
+    && (COMPRESSION_PROFILES as readonly string[]).includes(profile)
+    && isCustomCompressionPolicy(custom)
+    && autoCompact !== undefined
+    && codeSkeleton !== undefined
+    ? {
+        profile: profile as CompressionProfile,
+        custom: canonicalizeCustomPolicy(custom),
+        autoCompact,
+        codeSkeleton,
+        ...presetOptions === undefined ? {} : { presetOptions },
+      }
+    : undefined
+}

package/packages/selector/src/client/index.ts

@@ -0,0 +1,111 @@
+import type {} from '@deepseek-ai/dsh-client-locale/client'
+import type { ClientContext } from '@deepseek-ai/dsh-client-runtime/client'
+import type {} from '@deepseek-ai/dsh-client-ui-settings/client'
+import type {} from '@deepseek-ai/dsh-client-ui-workspace/client'
+import {
+  isCustomCompressionPolicy,
+  ContextCompressionSettingsSection,
+  type CompressionSelectorInjected, type ContextCompressionSettings,
+} from './CompressionProfileSelector.tsx'
+import { DEFAULT_CUSTOM_COMPRESSION_POLICY } from '../profiles.ts'
+import { decodeSettings } from './decode.ts'
+import { en, zh } from './locales.ts'
+import { mergePresetOptionsPatch, presetOptionsEqual } from './preset-options.ts'
+
+export const inject = ['slots', 'locale', 'settingsScope']
+const NS = 'context-compression'
+
+
+function sameCustomPolicy(
+  left: ContextCompressionSettings['custom'],
+  right: ContextCompressionSettings['custom'],
+): boolean {
+  if (left.version !== 3 || right.version !== 3) return false
+  return left.version === right.version
+    && left.unit === right.unit
+    && left.prefixPolicy === right.prefixPolicy
+    && left.fresh.enabled === right.fresh.enabled
+    && left.fresh.trigger === right.fresh.trigger
+    && left.fresh.target === right.fresh.target
+    && left.aggregate.enabled === right.aggregate.enabled
+    && left.aggregate.trigger === right.aggregate.trigger
+    && left.aggregate.target === right.aggregate.target
+    && left.history.enabled === right.history.enabled
+    && left.history.trigger === right.history.trigger
+    && left.history.keepRecentToolCalls === right.history.keepRecentToolCalls
+    && left.history.keepRecentTokens === right.history.keepRecentTokens
+    && left.history.minReclaim === right.history.minReclaim
+    && left.tailTrim.enabled === right.tailTrim.enabled
+    && left.tailTrim.trigger === right.tailTrim.trigger
+}
+
+export function apply(ctx: ClientContext): void {
+  ctx.effect(() => ctx.locale.register(NS, { zh, en }), 'ui-context-compression: dictionaries')
+  const scope = ctx.settingsScope.bind<ContextCompressionSettings>({ namespace: NS, decode: decodeSettings })
+  const writeAndConfirm = async (
+    write: () => Promise<void>,
+    accepts: (settings: ContextCompressionSettings) => boolean,
+  ): Promise<void> => {
+    const beforeRevision = scope.getSnapshot().revision
+    await write()
+    const after = scope.getSnapshot()
+    if (
+      after.status !== 'ready'
+      || after.value === undefined
+      || after.revision === beforeRevision
+      || !accepts(after.value)
+    ) {
+      throw new Error('Context compression settings were not saved.')
+    }
+  }
+  const injected = (): CompressionSelectorInjected => ({
+    hooks: { compression: scope },
+    select: profile => writeAndConfirm(
+      () => scope.set('profile', profile),
+      settings => settings.profile === profile,
+    ),
+    saveCustom: custom => writeAndConfirm(
+      () => scope.set('custom', custom),
+      settings => isCustomCompressionPolicy(settings.custom)
+        && sameCustomPolicy(settings.custom, custom),
+    ),
+    resetCustom: () => writeAndConfirm(
+      () => scope.set('custom', structuredClone(DEFAULT_CUSTOM_COMPRESSION_POLICY)),
+      settings => isCustomCompressionPolicy(settings.custom)
+        && sameCustomPolicy(settings.custom, DEFAULT_CUSTOM_COMPRESSION_POLICY),
+    ),
+    saveAutoCompact: thresholdPercent => writeAndConfirm(
+      () => scope.set('autoCompact', { thresholdPercent }),
+      settings => settings.autoCompact.thresholdPercent === thresholdPercent,
+    ),
+    saveCodeSkeleton: enabled => writeAndConfirm(
+      () => scope.set('codeSkeleton', { enabled }),
+      settings => settings.codeSkeleton.enabled === enabled,
+    ),
+    savePresetOptions: options => {
+      // The section root is replaced by whatever is written there, so merge the
+      // patch over the stored document: writing the bare patch deleted
+      // estimatorMode (and every other override) on the next field edit.
+      const current = scope.getSnapshot().value?.presetOptions
+      const next = mergePresetOptionsPatch(current, options)
+      if (presetOptionsEqual(current, next)) return Promise.resolve()
+      return writeAndConfirm(
+        () => scope.set('presetOptions', next),
+        settings => presetOptionsEqual(settings.presetOptions, next),
+      )
+    },
+  })
+  ctx.slots.inject('settings.section', () => ctx.slots.register({
+    name: 'settings.section',
+    id: 'context-compression',
+    order: 17,
+    label: () => ctx.locale.bind(NS)('nav'),
+    locale: NS,
+    inject: injected,
+  }, ContextCompressionSettingsSection))
+}
+
+export type {
+  CompressionProfile, CompressionProfileSelectorProps, CompressionSelectorInjected,
+  ContextCompressionSettings,
+} from './CompressionProfileSelector.tsx'

package/packages/selector/src/client/locales.ts

@@ -0,0 +1,198 @@
+/** Simplified Chinese copy for the context-compression selector. */
+export const zh = {
+  'nav': '上下文压缩选择器',
+  'settings.title': '上下文压缩选择器',
+  'settings.description': '为当前会话选择压缩 Profile，并配置该 Profile 提供的参数。',
+  'label': '上下文压缩',
+  'status.loading': '加载中',
+  'status.unavailable': '不可用',
+  'status.presetUnavailable': '此会话的 preset 未提供上下文压缩，或能力尚未确认。',
+  'status.minimalUnavailable': '极简模式不会为此会话加载上下文压缩能力，因此选择器在本会话中等效为关闭，仅保留 Harness 原生行为。切换到标准、PTC／Coding、创造模式，或支持该能力的自定义 preset 后即可配置。',
+  'status.saveFailed': '保存失败，请重试',
+  'pricing.disclosure': 'DeepSeek 官方价格目录复核于 2026-08-25。Asia/Shanghai 周一至周五 09:00–12:00、14:00–18:00 为峰时，其余为谷时；跨边界请求按成本区间处理。',
+  'profile.balanced': '平衡模式',
+  'profile.cache-strict': 'Cache Strict（前缀保护）',
+  'profile.savings': '节省模式',
+  'profile.adaptive': 'Adaptive（保守成本）',
+  'profile.tokenpilot-inspired': 'TokenPilot 启发模式',
+  'estimator.title': '估计器（可选）',
+  'estimator.description': '辅助小模型零样本判断旧文件读取是否仍有引用价值，仅建议性加速历史清理；未配置或失败时自动退回纯规则通道，不影响主流程。',
+  'estimator.mode': '通道',
+  'estimator.mode.off': '关闭（纯规则）',
+  'estimator.followHost': '跟随宿主默认模型',
+  'estimator.mode.host': '宿主模型（复用已配置供应商）',
+  'estimator.mode.direct': '直连 OpenAI 兼容端点',
+  'estimator.inactive': '估计器只随「TokenPilot 启发模式」提供：该模式的预设选项（去重指针、摘要定位块、读取状态语义与估计器通道）不会合并进其他 Profile，因此当前 Profile「{profile}」下没有可配置的估计器通道。选择「TokenPilot 启发模式」后，本区块会出现「通道」选择，可复用已配置供应商（宿主模型）或直连 OpenAI 兼容端点。',
+  'estimator.provider': '供应商',
+  'estimator.provider.placeholder': '留空则跟随会话默认模型，可从下拉选择或自定义输入',
+  'estimator.model.placeholder': '留空则跟随会话默认模型，可从下拉选择或自定义输入',
+  'estimator.hostReuse': '宿主通道直接复用你在 DSH 中已配置的供应商与凭据，无需填写 API Key；此通道也不接收 API Key。',
+  'estimator.hostRoute': '当前生效路由：{route}。',
+  'estimator.hostUnresolved': '尚未确定（请在 DSH 设置中选择默认模型，或在此指定供应商与模型）',
+  'estimator.baseUrl': '端点地址（/v1）',
+  'estimator.model': '模型',
+  'estimator.apiKey': 'API Key（仅写入，不回显）',
+  'estimator.apiKey.placeholder': '输入端点密钥并失焦保存',
+  'estimator.apiKey.set': '已设置 · 输入新值覆盖',
+  'estimator.apiKey.clear': '清除',
+  'estimator.apiKey.overwrite': '已设置保密值，输入新值并失焦即可覆盖。',
+  'detail.tokenpilot-inspired': '在平衡模式之上叠加去重指针、恢复豁免、摘要定位块、前缀稳定与读取状态语义；估计器需另行配置端点',
+  'profile.custom': 'Custom／实验模式',
+  'profile.native': '原生对照',
+  'profile.off': '插件关闭',
+  'profile.current': '当前选择',
+  'detail.balanced': '确定性压缩新工具结果；高水位时老化旧结果',
+  'detail.cache-strict': '仅在确认容量压力时老化已发送历史；服务端缓存命中仍是 best-effort',
+  'detail.savings': '使用更小目标并更早清理旧工具结果；不保证每个请求更便宜',
+  'detail.adaptive': 'Fresh／Aggregate 与平衡模式一致；仅当紧邻官方 usage 与当前官方价格证明历史压缩明确更省钱时老化历史，否则保留',
+  'detail.custom': '为新会话选择已实现的压缩阶段和计量阈值',
+  'detail.native': '只使用 DeepSeek Harness 原生头尾裁剪',
+  'detail.off': '关闭确定性选择器；原生 auto-compact 仍由 Harness 配置决定',
+  'autoCompact.title': 'Auto Compact 触发水位',
+  'autoCompact.description': '模型驱动 Auto Compact 在请求占用达到该水位时触发。调整后，标准 Profile 的 History 触发值、最小回收量与近期尾窗随水位联动；修改只影响新会话。',
+  'autoCompact.inputLabel': 'Auto Compact 阈值（%）',
+  'autoCompact.sliderLabel': 'Auto Compact 阈值滑杆',
+  'autoCompact.quick': '快捷值',
+  'autoCompact.riskLow': '低于推荐范围：更早触发会增加摘要调用与前缀重建。',
+  'autoCompact.riskHigh': '高于推荐范围：上下文容量为请求与输出共享，过晚触发会减少单次大输出、推理与工具 schema 的余量。',
+  'autoCompact.invalid': 'Auto Compact 阈值必须是 50–90 之间的整数。',
+  'autoCompact.save': '保存 Auto Compact 阈值',
+  'autoCompact.summaryHint': 'Auto Compact 阈值：{percent}%。可在设置中修改。',
+  'codeSkeleton.title': '代码骨架压缩（备选）',
+  'codeSkeleton.description': '正交开关：独立于上方 Profile。开启后，首次曝光的超大源码类工具结果会先尝试保留导入与声明的骨架（省略函数体并保留错误行），失败时自动回退到原头部裁剪；需要精确 tokenizer，修改只影响新会话。',
+  'codeSkeleton.enabled': '代码骨架压缩',
+  'codeSkeleton.enabled.on': '开',
+  'codeSkeleton.enabled.off': '关（默认）',
+  'custom.title': 'Custom 策略',
+  'custom.settingsHint': '具体参数请前往“设置 > 上下文压缩选择器”中编辑。',
+  'custom.sessionScope': '保存后的修改会在当前压缩运行时随后首次观察某个 Session 时生效；已被该运行时观察的 Session 继续使用其冻结策略。',
+  'custom.measurement': '首选 DeepSeek 精确 tokenizer；不可用时回退到带校准的 tokenizer estimate，绝不使用 chars/4。缓存归因仍未知。',
+  'custom.unit': '规范单位',
+  'custom.unit.tokens': 'Tokens',
+  'custom.unit.contextPercent': '上下文百分比',
+  'custom.enabled': '是否启用',
+  'custom.enabled.on': '开',
+  'custom.enabled.off': '关',
+  'custom.fresh.enabled': '启用 Fresh',
+  'custom.fresh.trigger': 'Fresh 触发值',
+  'custom.fresh.target': 'Fresh 目标值',
+  'custom.aggregate.enabled': '启用 Aggregate',
+  'custom.aggregate.trigger': 'Aggregate 触发值',
+  'custom.aggregate.target': 'Aggregate 目标值',
+  'custom.history.enabled': '启用 History',
+  'custom.history.trigger': 'History 触发值',
+  'custom.history.keepRecentToolCalls': '保护近期工具调用数',
+  'custom.history.keepRecentTokens': '保护近期工具结果尾窗',
+  'custom.history.minReclaim': '最小回收量',
+  'custom.prefixPolicy': '已发送前缀策略',
+  'custom.prefixPolicy.preserve': '仅在容量压力时改写',
+  'custom.prefixPolicy.pressureBreak': '允许常规历史老化',
+  'custom.experimental': 'Experimental：以下功能仅用于 Custom，不会加入标准 Profile。',
+  'custom.tailTrim.enabled': '启用 TailTrim（实验）',
+  'custom.tailTrim.trigger': 'TailTrim 触发值',
+  'custom.tailTrim.warning': 'TailTrim 只在精确 tokenizer 可用时，把一个完整、已结束且非错误的纯工具组替换为可恢复引用；它与 History 共用近期工具调用数、工具结果尾窗和最小回收参数。它会改写已发送前缀，可能降低缓存命中。',
+  'custom.save': '保存 Custom 策略',
+  'custom.reset': '重置 Custom 策略',
+  'custom.invalid': 'Custom 策略参数无效。',
+} satisfies Record<string, string>
+
+/** Locale keys that every context-compression selector dictionary must provide. */
+export type ContextCompressionLocaleKey = keyof typeof zh
+
+/** English copy matching every simplified Chinese selector key. */
+export const en = {
+  'nav': 'Context compression selector',
+  'settings.title': 'Context compression selector',
+  'settings.description': 'Choose a compression profile for the current session and configure the parameters it provides.',
+  'label': 'Context compression',
+  'status.loading': 'Loading',
+  'status.unavailable': 'Unavailable',
+  'status.presetUnavailable': 'This session’s preset does not provide context compression, or availability is not yet confirmed.',
+  'status.minimalUnavailable': 'Minimal mode does not load context compression for this session. The selector is effectively off and Harness native behavior remains. Switch to Standard, PTC / Coding, Creative, or a capable custom preset to configure it.',
+  'status.saveFailed': 'Save failed. Try again.',
+  'pricing.disclosure': 'DeepSeek official prices checked 2026-08-25. Peak Mon–Fri 09:00–12:00 and 14:00–18:00 Asia/Shanghai; otherwise off-peak. Cross-boundary requests use a cost range.',
+  'profile.balanced': 'Balanced',
+  'profile.cache-strict': 'Cache Strict (prefix protection)',
+  'profile.savings': 'Savings',
+  'profile.adaptive': 'Adaptive (conservative cost)',
+  'profile.tokenpilot-inspired': 'TokenPilot-inspired',
+  'estimator.title': 'Estimator (optional)',
+  'estimator.description': 'A small auxiliary model zero-shots whether old file reads are still likely referenced, advisory-only for history aging; unconfigured or failing endpoints fall back to rule-only behavior.',
+  'estimator.mode': 'Channel',
+  'estimator.mode.off': 'Off (rule-only)',
+  'estimator.followHost': 'Follow the host default model',
+  'estimator.mode.host': 'Host model (reuse configured providers)',
+  'estimator.mode.direct': 'Direct OpenAI-compatible endpoint',
+  'estimator.inactive': 'The estimator ships only with the TokenPilot-inspired profile: that profile’s preset options (dedupe pointers, summary locators, read-state semantics, and the estimator channel) are never merged into another profile, so the current profile “{profile}” has no estimator channel to configure. Select TokenPilot-inspired and this section gains a Channel choice — reuse configured providers (host model) or a direct OpenAI-compatible endpoint.',
+  'estimator.provider': 'Provider',
+  'estimator.provider.placeholder': 'Empty follows the session default model; pick from the dropdown or type a custom id',
+  'estimator.model.placeholder': 'Empty follows the session default model; pick from the dropdown or type a custom id',
+  'estimator.hostReuse': 'The host channel reuses the providers and credentials you already configured in DSH, so no API key is needed — and none is accepted here.',
+  'estimator.hostRoute': 'Effective route: {route}.',
+  'estimator.hostUnresolved': 'not determined yet (choose a default model in DSH settings, or name a provider and model here)',
+  'estimator.baseUrl': 'Endpoint base URL (/v1)',
+  'estimator.model': 'Model',
+  'estimator.apiKey': 'API key (write-only, never echoed)',
+  'estimator.apiKey.placeholder': 'Type the endpoint key; blur to save',
+  'estimator.apiKey.set': 'Set · type a new value to overwrite',
+  'estimator.apiKey.clear': 'Clear',
+  'estimator.apiKey.overwrite': 'A secret is stored; type a new value and blur to overwrite it.',
+  'detail.tokenpilot-inspired': 'Layered on Balanced: dedupe pointers, recovery exemption, summary locators, prefix stabilization, and read-state semantics; the estimator needs an endpoint configured separately',
+  'profile.custom': 'Custom / Experimental',
+  'profile.native': 'Native baseline',
+  'profile.off': 'Plugin off',
+  'profile.current': 'Current profile',
+  'detail.balanced': 'Reduce fresh tool results deterministically; age old results at high watermarks',
+  'detail.cache-strict': 'Age sent history only under confirmed capacity pressure; provider cache hits remain best-effort',
+  'detail.savings': 'Use smaller targets and age old tool results earlier; does not guarantee a cheaper request',
+  'detail.adaptive': 'Use Balanced Fresh/Aggregate; age history only when adjacent official usage and current official prices prove a clear saving',
+  'detail.custom': 'Choose implemented stages and measured thresholds for new sessions',
+  'detail.native': 'Use only the Harness native head/tail pruner',
+  'detail.off': 'Disable the deterministic selector; native auto-compact remains separately configured',
+  'autoCompact.title': 'Auto Compact trigger level',
+  'autoCompact.description': 'Model-driven Auto Compact triggers once request usage crosses this level. Standard-profile History triggers, minimum reclaim, and the recent tail follow the level; changes affect new sessions only.',
+  'autoCompact.inputLabel': 'Auto Compact threshold (%)',
+  'autoCompact.sliderLabel': 'Auto Compact threshold slider',
+  'autoCompact.quick': 'Quick values',
+  'autoCompact.riskLow': 'Below the recommended band: triggering earlier increases summarization calls and prefix rebuilds.',
+  'autoCompact.riskHigh': 'Above the recommended band: context capacity is shared by requests and output, so triggering later reduces headroom for single large outputs, reasoning, and tool schemas.',
+  'autoCompact.invalid': 'The Auto Compact threshold must be an integer between 50 and 90.',
+  'autoCompact.save': 'Save Auto Compact threshold',
+  'autoCompact.summaryHint': 'Auto Compact threshold: {percent}%. Change it in Settings.',
+  'codeSkeleton.title': 'Code skeleton compression (opt-in)',
+  'codeSkeleton.description': 'Orthogonal switch, independent of the profiles above. When enabled, an oversized fresh source-code tool result first tries a skeleton that keeps imports and declarations (bodies elided, error lines kept) and falls back to the original head pruning on failure. Requires the exact tokenizer; changes affect new sessions only.',
+  'codeSkeleton.enabled': 'Code skeleton compression',
+  'codeSkeleton.enabled.on': 'On',
+  'codeSkeleton.enabled.off': 'Off (default)',
+  'custom.title': 'Custom policy',
+  'custom.settingsHint': 'Edit detailed parameters in Settings > Context compression selector.',
+  'custom.sessionScope': 'Saved changes apply when the current compression runtime next observes a Session for the first time. A Session already observed by that runtime keeps its frozen policy.',
+  'custom.measurement': 'Exact DeepSeek tokenizer first; tokenizer estimate with calibration fallback. Never chars/4. Cache attribution remains unknown.',
+  'custom.unit': 'Canonical unit',
+  'custom.unit.tokens': 'Tokens',
+  'custom.unit.contextPercent': 'Context percent',
+  'custom.enabled': 'Enabled',
+  'custom.enabled.on': 'On',
+  'custom.enabled.off': 'Off',
+  'custom.fresh.enabled': 'Enable Fresh',
+  'custom.fresh.trigger': 'Fresh trigger',
+  'custom.fresh.target': 'Fresh target',
+  'custom.aggregate.enabled': 'Enable Aggregate',
+  'custom.aggregate.trigger': 'Aggregate trigger',
+  'custom.aggregate.target': 'Aggregate target',
+  'custom.history.enabled': 'Enable History',
+  'custom.history.trigger': 'History trigger',
+  'custom.history.keepRecentToolCalls': 'Protected recent tool calls',
+  'custom.history.keepRecentTokens': 'Protected recent tool-result tail',
+  'custom.history.minReclaim': 'Minimum reclaim',
+  'custom.prefixPolicy': 'Sent-prefix policy',
+  'custom.prefixPolicy.preserve': 'Preserve until capacity pressure',
+  'custom.prefixPolicy.pressureBreak': 'Allow routine history aging',
+  'custom.experimental': 'Experimental: these controls are Custom-only and never added to standard profiles.',
+  'custom.tailTrim.enabled': 'Enable TailTrim (experimental)',
+  'custom.tailTrim.trigger': 'TailTrim trigger',
+  'custom.tailTrim.warning': 'TailTrim requires the exact tokenizer and replaces at most one complete, finished, non-error tool-only group with a recoverable reference. It shares Protected recent tool calls, Protected recent tool-result tail, and Minimum reclaim with History. It rewrites a sent prefix and may reduce cache hits.',
+  'custom.save': 'Save Custom policy',
+  'custom.reset': 'Reset Custom policy',
+  'custom.invalid': 'Custom policy values are invalid.',
+} satisfies Record<ContextCompressionLocaleKey, string>