compressed-context 0.1.0 → 0.1.1

package/src/i18n/zh.ts

@@ -1,93 +1,93 @@
-import type { Messages } from "./types.ts"
-
-/** 中文文案。标签控制在 4 个字以内，侧栏窄也能放下。 */
-export const zh: Messages = {
-  title: "上下文构成",
-  labels: {
-    system: "系统",
-    tools: "工具定义",
-    tool: "工具结果",
-    text: "文本",
-    recent: "最近保留",
-    summaries: "摘要",
-    media: "媒体",
-  },
-  approximate: "≈",
-  terminal: "上下文无法继续压缩，请开新会话或使用原生压缩",
-  cacheTitle: "缓存记录",
-  cacheChart: "折线图",
-  cacheLog: "日志",
-  cacheInput: "输入",
-  cacheOutput: "输出",
-  cacheCached: "缓存",
-  cacheHit: "命中",
-  summariesTitle: "摘要块",
-  noData: "—",
-  command: {
-    title: "压缩上下文设置",
-    description: "打开插件设置",
-    group: "插件",
-  },
-  settings: {
-    title: "压缩上下文插件设置",
-    show: "显示面板",
-    limit: "上下文上限",
-    limitAuto: "模型原生",
-    limitCustom: "自定义上限…",
-    limitHint: "填的是上限；实际窗口取「设置值」和「模型原生窗口」中较小的那个。纯数字或带 k/m 后缀",
-    limitInvalid: "请输入有效的 token 数",
-    limitPlaceholder: "200k",
-    limitPreview: (value) => `= ${value} tokens`,
-    limitCapped: (requested, actual) => `${requested}（模型上限 ${actual}）`,
-    threshold: "压缩阈值",
-    thresholdHint: "输入 60 ~ 95 之间的整数（百分比）",
-    thresholdInvalid: "阈值必须在 60 ~ 95 之间",
-    thresholdPreview: (value) => `= ${value}%`,
-    nudgeGrowth: "压缩提醒间隔",
-    nudgeGrowthHint: "上下文每增长这么多 token 提醒模型可主动压缩；0 关闭",
-    nudgeGrowthInvalid: "请输入 0，或 1k ~ 200k",
-    summaryBlockPercent: "单条摘要上限",
-    summaryBlockPercentHint: "单条摘要最多占窗口的百分比；可输入 10% 或 20k",
-    summaryTotalPercent: "全部摘要上限",
-    summaryTotalPercentHint: "所有摘要加起来最多占窗口的百分比；可输入 50% 或 100k",
-    summaryPercentInvalid: "请输入 1% ~ 90%，或一个能换算成百分比的 token 数",
-    windowKnown: (value) => `当前窗口：${value}`,
-    windowUnknown: "当前窗口未知（先跑一次模型请求）",
-    summaryLanguage: "摘要语言",
-    summaryFormat: "摘要格式",
-    summaryFormatJson: "JSON（结构化）",
-    summaryFormatMarkdown: "Markdown（自然语言）",
-    summaryFormatBabel: "Babel（模型间高密度）",
-    autoCompress: "自动压缩",
-    enableCompressTool: "compress 工具",
-    enableDecompressTool: "decompress 工具",
-    showTimeline: "块头时间线",
-    showBlockTokens: "块头 token 估算",
-    showCacheChart: "显示缓存折线图",
-    showCacheLog: "显示缓存日志",
-    showSummaries: "显示摘要块",
-    categories: {
-      compress: "压缩",
-      summary: "摘要",
-      panel: "面板",
-      decompress: "解压",
-      interface: "界面",
-    },
-    decompressInlineMax: "解压内联上限",
-    decompressInlineMaxHint: "超过这个字符数就写成临时文件；输入纯数字或带 k/m 后缀",
-    decompressInlineMaxInvalid: "请输入 1k ~ 1m 之间的字符数",
-    decompressTempCap: "解压临时文件上限",
-    decompressTempCapHint: "最多保留多少个解压临时文件",
-    decompressTempCapInvalid: "请输入 1 ~ 1000 之间的整数",
-    decompressShowTokens: "解压返回 token 估算",
-    submit: "提交",
-    language: "语言",
-    auto: "自动",
-    on: "开",
-    off: "关",
-  },
-  languages: {
-    zh: "中文",
-    en: "English",
-  },
-}
+import type { Messages } from "./types.ts"
+
+/** 中文文案。标签控制在 4 个字以内，侧栏窄也能放下。 */
+export const zh: Messages = {
+  title: "上下文构成",
+  labels: {
+    system: "系统",
+    tools: "工具定义",
+    tool: "工具结果",
+    text: "文本",
+    recent: "最近保留",
+    summaries: "摘要",
+    media: "媒体",
+  },
+  approximate: "≈",
+  terminal: "上下文无法继续压缩，请开新会话或使用原生压缩",
+  cacheTitle: "缓存记录",
+  cacheChart: "折线图",
+  cacheLog: "日志",
+  cacheInput: "输入",
+  cacheOutput: "输出",
+  cacheCached: "缓存",
+  cacheHit: "命中",
+  summariesTitle: "摘要块",
+  noData: "—",
+  command: {
+    title: "压缩上下文设置",
+    description: "打开插件设置",
+    group: "插件",
+  },
+  settings: {
+    title: "压缩上下文插件设置",
+    show: "显示面板",
+    limit: "上下文上限",
+    limitAuto: "模型原生",
+    limitCustom: "自定义上限…",
+    limitHint: "填的是上限；实际窗口取「设置值」和「模型原生窗口」中较小的那个。纯数字或带 k/m 后缀",
+    limitInvalid: "请输入有效的 token 数",
+    limitPlaceholder: "200k",
+    limitPreview: (value) => `= ${value} tokens`,
+    limitCapped: (requested, actual) => `${requested}（模型上限 ${actual}）`,
+    threshold: "压缩阈值",
+    thresholdHint: "输入 60 ~ 95 之间的整数（百分比）",
+    thresholdInvalid: "阈值必须在 60 ~ 95 之间",
+    thresholdPreview: (value) => `= ${value}%`,
+    nudgeGrowth: "压缩提醒间隔",
+    nudgeGrowthHint: "上下文每增长这么多 token 提醒模型可主动压缩；0 关闭",
+    nudgeGrowthInvalid: "请输入 0，或 1k ~ 200k",
+    summaryBlockPercent: "单条摘要上限",
+    summaryBlockPercentHint: "单条摘要最多占窗口的百分比；可输入 10% 或 20k",
+    summaryTotalPercent: "全部摘要上限",
+    summaryTotalPercentHint: "所有摘要加起来最多占窗口的百分比；可输入 50% 或 100k",
+    summaryPercentInvalid: "请输入 1% ~ 90%，或一个能换算成百分比的 token 数",
+    windowKnown: (value) => `当前窗口：${value}`,
+    windowUnknown: "当前窗口未知（先跑一次模型请求）",
+    summaryLanguage: "摘要语言",
+    summaryFormat: "摘要格式",
+    summaryFormatJson: "JSON（结构化）",
+    summaryFormatMarkdown: "Markdown（自然语言）",
+    summaryFormatBabel: "Babel（模型间高密度）",
+    autoCompress: "自动压缩",
+    enableCompressTool: "compress 工具",
+    enableDecompressTool: "decompress 工具",
+    showTimeline: "块头时间线",
+    showBlockTokens: "块头 token 估算",
+    showCacheChart: "显示缓存折线图",
+    showCacheLog: "显示缓存日志",
+    showSummaries: "显示摘要块",
+    categories: {
+      compress: "压缩",
+      summary: "摘要",
+      panel: "面板",
+      decompress: "解压",
+      interface: "界面",
+    },
+    decompressInlineMax: "解压内联上限",
+    decompressInlineMaxHint: "超过这个字符数就写成临时文件；输入纯数字或带 k/m 后缀",
+    decompressInlineMaxInvalid: "请输入 1k ~ 1m 之间的字符数",
+    decompressTempCap: "解压临时文件上限",
+    decompressTempCapHint: "最多保留多少个解压临时文件",
+    decompressTempCapInvalid: "请输入 1 ~ 1000 之间的整数",
+    decompressShowTokens: "解压返回 token 估算",
+    submit: "提交",
+    language: "语言",
+    auto: "自动",
+    on: "开",
+    off: "关",
+  },
+  languages: {
+    zh: "中文",
+    en: "English",
+  },
+}

package/src/index.ts

@@ -1,108 +1,108 @@
-import { Plugin } from "@opencode/plugin"
-
-import { maybeAutoCompress, maybeAutoCompressStep, maybeNudge } from "./compression/auto.ts"
-import { recordCacheHistoryStep } from "./compression/cache-history.ts"
-import { adoptNativeCheckpoint } from "./compression/adopt.ts"
-import { handleCompaction } from "./compression/compaction.ts"
-import { reconcileAll, startSessionEvents } from "./compression/events.ts"
-import { registerSettingsRpc, type Disposable } from "./compression/settings-rpc.ts"
-import { loadState } from "./compression/state.ts"
-import { registerCompressTool } from "./compression/tool.ts"
-import { registerDecompressTool } from "./compression/decompress-tool.ts"
-import { createStats, mergeMetadata, shouldPublish, type ContextStats } from "./shared/stats.ts"
-import { estimateCategories } from "./shared/tokens.ts"
-
-export default Plugin.define({
-  id: "compressed-context",
-
-  /**
-   * 输入：OpenCode 注入的插件上下文 ctx。
-   * 输出：注册 compress 工具、设置 RPC、context / compaction 钩子与事件订阅。
-   * 预期：块链通过 compaction 落盘；失败不破坏历史。
-   */
-  async setup(ctx) {
-    const published = new Map<string, ContextStats>()
-    const disposables: Disposable[] = []
-
-    /** 输入：sessionID；输出：无；预期：会话空闲/删除时清掉进程内统计缓存。 */
-    const forgetMemory = (sessionID: string): void => {
-      published.delete(sessionID)
-    }
-
-    const publishStats = async (sessionID: string, stats: ContextStats): Promise<void> => {
-      const session = await ctx.session.get({ sessionID })
-      await ctx.session.update({
-        sessionID,
-        metadata: mergeMetadata(session.metadata, stats),
-      })
-    }
-
-    disposables.push(await registerCompressTool(ctx))
-    disposables.push(await registerDecompressTool(ctx))
-    disposables.push(await registerSettingsRpc(ctx))
-    const stopEvents = startSessionEvents(ctx, {
-      onSessionIdle: forgetMemory,
-      onSessionDeleted: forgetMemory,
-      onStepEnded: ({ sessionID, messageID, tokens }) =>
-        void (async () => {
-          await recordCacheHistoryStep(ctx, sessionID, { messageID, tokens })
-          await maybeAutoCompressStep({ ctx, sessionID, tokens })
-        })(),
-    })
-    void reconcileAll(ctx)
-
-    disposables.push(
-      await ctx.session.hook("context", async (event) => {
-        await adoptNativeCheckpoint(ctx, event.sessionID, event.messages)
-
-        await maybeNudge({
-          ctx,
-          sessionID: event.sessionID,
-          messages: event.messages,
-          system: event.system,
-          tools: event.tools,
-          model: event.model,
-        })
-
-        const stats = createStats(
-          estimateCategories({
-            system: event.system,
-            tools: event.tools,
-            messages: event.messages,
-          }),
-          Date.now(),
-        )
-        if (shouldPublish(published.get(event.sessionID), stats)) {
-          published.set(event.sessionID, stats)
-          void publishStats(event.sessionID, stats).catch(() => undefined)
-        }
-
-        await maybeAutoCompress({
-          ctx,
-          sessionID: event.sessionID,
-          messages: event.messages,
-          system: event.system,
-          tools: event.tools,
-          model: event.model,
-        })
-      }),
-    )
-
-    disposables.push(
-      await ctx.session.hook("compaction", (event) => handleCompaction(ctx, event)),
-    )
-
-    // 终止后拒绝一切新输入：把真实原因直接抛给宿主，TUI 会显示这条错误。
-    disposables.push(
-      await ctx.session.hook("prompt", async (event) => {
-        const state = await loadState(ctx.storage, event.sessionID)
-        if (state.terminal !== undefined) throw new Error(state.terminal)
-      }),
-    )
-
-    return () => {
-      stopEvents()
-      for (const disposable of disposables) void disposable.dispose()
-    }
-  },
-})
+import { Plugin } from "@opencode/plugin"
+
+import { maybeAutoCompress, maybeAutoCompressStep, maybeNudge } from "./compression/auto.ts"
+import { recordCacheHistoryStep } from "./compression/cache-history.ts"
+import { adoptNativeCheckpoint } from "./compression/adopt.ts"
+import { handleCompaction } from "./compression/compaction.ts"
+import { reconcileAll, startSessionEvents } from "./compression/events.ts"
+import { registerSettingsRpc, type Disposable } from "./compression/settings-rpc.ts"
+import { loadState } from "./compression/state.ts"
+import { registerCompressTool } from "./compression/tool.ts"
+import { registerDecompressTool } from "./compression/decompress-tool.ts"
+import { createStats, mergeMetadata, shouldPublish, type ContextStats } from "./shared/stats.ts"
+import { estimateCategories } from "./shared/tokens.ts"
+
+export default Plugin.define({
+  id: "compressed-context",
+
+  /**
+   * 输入：OpenCode 注入的插件上下文 ctx。
+   * 输出：注册 compress 工具、设置 RPC、context / compaction 钩子与事件订阅。
+   * 预期：块链通过 compaction 落盘；失败不破坏历史。
+   */
+  async setup(ctx) {
+    const published = new Map<string, ContextStats>()
+    const disposables: Disposable[] = []
+
+    /** 输入：sessionID；输出：无；预期：会话空闲/删除时清掉进程内统计缓存。 */
+    const forgetMemory = (sessionID: string): void => {
+      published.delete(sessionID)
+    }
+
+    const publishStats = async (sessionID: string, stats: ContextStats): Promise<void> => {
+      const session = await ctx.session.get({ sessionID })
+      await ctx.session.update({
+        sessionID,
+        metadata: mergeMetadata(session.metadata, stats),
+      })
+    }
+
+    disposables.push(await registerCompressTool(ctx))
+    disposables.push(await registerDecompressTool(ctx))
+    disposables.push(await registerSettingsRpc(ctx))
+    const stopEvents = startSessionEvents(ctx, {
+      onSessionIdle: forgetMemory,
+      onSessionDeleted: forgetMemory,
+      onStepEnded: ({ sessionID, messageID, tokens }) =>
+        void (async () => {
+          await recordCacheHistoryStep(ctx, sessionID, { messageID, tokens })
+          await maybeAutoCompressStep({ ctx, sessionID, tokens })
+        })(),
+    })
+    void reconcileAll(ctx)
+
+    disposables.push(
+      await ctx.session.hook("context", async (event) => {
+        await adoptNativeCheckpoint(ctx, event.sessionID, event.messages)
+
+        await maybeNudge({
+          ctx,
+          sessionID: event.sessionID,
+          messages: event.messages,
+          system: event.system,
+          tools: event.tools,
+          model: event.model,
+        })
+
+        const stats = createStats(
+          estimateCategories({
+            system: event.system,
+            tools: event.tools,
+            messages: event.messages,
+          }),
+          Date.now(),
+        )
+        if (shouldPublish(published.get(event.sessionID), stats)) {
+          published.set(event.sessionID, stats)
+          void publishStats(event.sessionID, stats).catch(() => undefined)
+        }
+
+        await maybeAutoCompress({
+          ctx,
+          sessionID: event.sessionID,
+          messages: event.messages,
+          system: event.system,
+          tools: event.tools,
+          model: event.model,
+        })
+      }),
+    )
+
+    disposables.push(
+      await ctx.session.hook("compaction", (event) => handleCompaction(ctx, event)),
+    )
+
+    // 终止后拒绝一切新输入：把真实原因直接抛给宿主，TUI 会显示这条错误。
+    disposables.push(
+      await ctx.session.hook("prompt", async (event) => {
+        const state = await loadState(ctx.storage, event.sessionID)
+        if (state.terminal !== undefined) throw new Error(state.terminal)
+      }),
+    )
+
+    return () => {
+      stopEvents()
+      for (const disposable of disposables) void disposable.dispose()
+    }
+  },
+})

package/src/shared/blocks.ts

@@ -1,17 +1,17 @@
-/**
- * 摘要块的跨进程 DTO。
- *
- * 服务端把 active 链渲染成 body，TUI 只负责展示。
- */
-export interface SummaryBlock {
-  readonly id: string
-  readonly tier: 1 | 2 | 3
-  /** 摘要格式；Babel 正文不能按 Markdown 渲染。 */
-  readonly format: "json" | "markdown" | "babel"
-  readonly title: string
-  readonly at: number
-  readonly tokensBefore: number
-  readonly tokensAfter: number
-  readonly sourceBlockIds?: readonly string[]
-  readonly body: string
-}
+/**
+ * 摘要块的跨进程 DTO。
+ *
+ * 服务端把 active 链渲染成 body，TUI 只负责展示。
+ */
+export interface SummaryBlock {
+  readonly id: string
+  readonly tier: 1 | 2 | 3
+  /** 摘要格式；Babel 正文不能按 Markdown 渲染。 */
+  readonly format: "json" | "markdown" | "babel"
+  readonly title: string
+  readonly at: number
+  readonly tokensBefore: number
+  readonly tokensAfter: number
+  readonly sourceBlockIds?: readonly string[]
+  readonly body: string
+}