chatccc 0.2.254 → 0.2.256

package/README.md

@@ -373,6 +373,7 @@ Codex 的默认模型和推理强度可继续由 `~/.codex/config.toml` 管理
 | `ccc.DEEPSEEK_API_KEY` / `ccc.DEEPSEEK_BASE_URL` | CCC Agent 的 API Key 和服务地址；**不限于 DeepSeek**——可填任意 OpenAI 兼容端点（OpenAI、Kimi、通义、智谱、Ollama 本地等） |
 | `ccc.model` | CCC Agent 默认模型 |
 | `ccc.compactionTimeoutMs` | CCC Agent 上下文压缩单轮超时（毫秒），默认 300000（5 分钟）；压缩超时会让整轮对话失败，建议保持默认或调大 |
+| `ccc.contextWindow` | CCC Agent 模型上下文窗口（token），默认 1048576（1M，DeepSeek V4 Pro/Flash 原生规格）；压缩阈值自动 = 窗口 × 80%；超过模型/服务端实际上限会被 API 拒绝，可在 Web UI 下拉选择或自定义（单位 k） |
 
 > **权限控制**：普通消息以 `bypassPermissions` 模式运行，跳过 Agent 操作确认。使用 `/plan` 或 `/ask` 前缀时，ChatCCC 自动切换为只读模式：Claude SDK 仅放行 Read + stop-stuck-loop 网络请求，Codex 使用 `--sandbox read-only`，Cursor 使用 `--mode plan/ask`。请只在可信环境中使用。
 

package/config.sample.json

@@ -53,7 +53,8 @@
     "alternativeModel": "",
     "effort": "",
     "provider": "",
-    "compactionTimeoutMs": 300000
+    "compactionTimeoutMs": 300000,
+    "contextWindow": 1048576
   },
   "claude": {
     "enabled": false,

package/deepccc-agent/README.md

@@ -77,6 +77,7 @@ $env:DEEPCCC_STREAMING="true"
   "model": "deepseek-v4-pro",
   "effort": "",
   "streaming": true,
+  "contextWindow": 1048576,
   "rawStreamLogs": {
     "enabled": true,
     "maxBytesPerTurn": 1048576,
@@ -90,15 +91,23 @@ $env:DEEPCCC_STREAMING="true"
 `DEEPCCC_PROVIDER` 或命令行 `--provider` 覆盖：
 
 - `openai` 使用 OpenAI-compatible Chat Completions 协议，兼容 DeepSeek、OpenAI、LiteLLM、vLLM 等服务。
-- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` 可以继续填写同一个服务基址；DeepCCC 会为不带 `/v1` 的地址自动补上 `/v1`。`effort` 是 OpenAI/DeepSeek 扩展参数，在 Anthropic 模式下不会发送。
+- `anthropic` 使用 Anthropic Messages 协议。配置中的 `baseURL` **完全按填写值使用，不自动补 `/v1`**，请填写到完整版本化地址，例如 DeepSeek 官方 Anthropic 端点为 `https://api.deepseek.com/anthropic/v1`（官方 Anthropic SDK 使用的 `https://api.deepseek.com/anthropic` 基址会拼接为 `.../anthropic/v1/messages`）。`effort` 是 OpenAI/DeepSeek 扩展参数，在 Anthropic 模式下不会发送。
 
 `streaming` 控制主对话是否使用流式请求，默认 `true`；也可以通过
 `DEEPCCC_STREAMING=true|false` 覆盖。关闭后，终端会在整条模型响应完成后一次性显示结果。
 
+`contextWindow` 是模型上下文窗口（token），默认 `1048576`（1M，DeepSeek V4 Pro/Flash
+原生规格）；上下文压缩阈值自动 = `contextWindow × 0.8`（超出即把较早消息压缩为摘要）。
+可通过 `DEEPCCC_CONTEXT_WINDOW` 环境变量覆盖。⚠️ 超过模型/服务端实际上限时请求会被
+API 拒绝（context length exceeded），实际窗口以模型与所用服务端为准（如 litellm 的
+`max_input_tokens`）。
+
 `rawStreamLogs.enabled` 默认 `true`，通过 `DEEPCCC_RAW_STREAM_LOGS` 环境变量或配置 JSON 关闭。
 开启时，每次对话的原始流按 gzip JSONL 落到 `~/.deepccc/raw-stream-logs/`，供
 `session_search` 工具在会话被压缩后找回被压缩消息的精确原文（检索时设置
-`include_raw_logs=true`）。关闭后，压缩后的旧消息原文将无法找回。
+`include_raw_logs=true`）。压缩后注入的恢复提示会携带当前会话 ID：优先用
+`session_id` 限定只搜当前会话，未命中时可省略 `session_id` 做全库检索。
+关闭后，压缩后的旧消息原文将无法找回。
 
 ## 命令行交互
 

package/deepccc-agent/package.json

@@ -1,6 +1,6 @@
 {
   "name": "deepccc",
-  "version": "0.1.23",
+  "version": "0.1.25",
   "description": "A lightweight coding agent with OpenAI-compatible and Anthropic Messages API support.",
   "license": "Apache-2.0",
   "keywords": [

package/dist/deepccc-agent/src/config.js

@@ -14,6 +14,7 @@ export const DEFAULT_CONFIG = {
     model: "deepseek-v4-pro",
     effort: "",
     streaming: true,
+    contextWindow: 1_048_576,
     rawStreamLogs: {
         // 默认开启：压缩后可通过 session_search（include_raw_logs=true）找回原文。
         // 如需关闭，在 ~/.deepccc/config.json 中设置 rawStreamLogs.enabled=false。
@@ -67,6 +68,7 @@ function loadConfig() {
         model: env("DEEPCCC_MODEL") ?? env("DEEPSEEK_MODEL") ?? file.model ?? DEFAULT_CONFIG.model,
         effort: env("DEEPCCC_EFFORT") ?? env("DEEPSEEK_EFFORT") ?? file.effort ?? DEFAULT_CONFIG.effort,
         streaming: boolEnv("DEEPCCC_STREAMING") ?? file.streaming ?? DEFAULT_CONFIG.streaming,
+        contextWindow: numberEnv("DEEPCCC_CONTEXT_WINDOW") ?? file.contextWindow ?? DEFAULT_CONFIG.contextWindow,
         rawStreamLogs: {
             enabled: boolEnv("DEEPCCC_RAW_STREAM_LOGS") ?? rawLogs.enabled ?? DEFAULT_CONFIG.rawStreamLogs.enabled,
             maxBytesPerTurn: numberEnv("DEEPCCC_RAW_STREAM_MAX_BYTES") ?? rawLogs.maxBytesPerTurn ?? DEFAULT_CONFIG.rawStreamLogs.maxBytesPerTurn,

package/dist/deepccc-agent/src/context.js

@@ -3,7 +3,12 @@ import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, writeFile
 import { homedir } from "node:os";
 import { join } from "node:path";
 export const DEFAULT_BUILTIN_CONTEXT_DIR = join(homedir(), ".deepccc", "sessions");
-export const DEFAULT_COMPACT_AT_TOKENS = 128_000;
+/** 默认模型上下文窗口：1M（DeepSeek V4 Pro/Flash 原生规格）。 */
+export const DEFAULT_CONTEXT_WINDOW_TOKENS = 1_048_576;
+/** 压缩阈值 = 窗口 × 0.8（业界惯例：在窗口接近上限前主动压缩，留出安全余量）。 */
+export const COMPACTION_THRESHOLD_RATIO = 0.8;
+/** 默认压缩阈值 = 1M × 0.8。 */
+export const DEFAULT_COMPACT_AT_TOKENS = Math.floor(DEFAULT_CONTEXT_WINDOW_TOKENS * COMPACTION_THRESHOLD_RATIO);
 export const DEFAULT_KEEP_RECENT_MESSAGES = 16;
 const RECENT_CONTEXT_BUDGET_RATIO = 0.6;
 const MAX_COMPACTION_SUMMARY_CHARS = 8_000;
@@ -247,7 +252,8 @@ export class BuiltinContextManager {
         this.contextDir = options.contextDir ?? DEFAULT_BUILTIN_CONTEXT_DIR;
         this.sessionId = normalizeBuiltinSessionId(options.sessionId ?? defaultBuiltinSessionId());
         this.cwd = options.cwd;
-        this.compactAtTokens = options.compactAtTokens ?? DEFAULT_COMPACT_AT_TOKENS;
+        this.compactAtTokens = options.compactAtTokens
+            ?? Math.floor((options.contextWindow ?? DEFAULT_CONTEXT_WINDOW_TOKENS) * COMPACTION_THRESHOLD_RATIO);
         this.keepRecentMessages = Math.max(1, options.keepRecentMessages ?? DEFAULT_KEEP_RECENT_MESSAGES);
         this.state = this.load();
     }

package/dist/deepccc-agent/src/index.js

@@ -61,13 +61,16 @@ const SUMMARY_SYSTEM_PROMPT = [
 /**
  * 压缩后注入的恢复提示（lead-in，对齐业界 Codex 的 post-compaction lead-in 思路）：
  * 只要会话发生过压缩（存在摘要），就在摘要后告知模型可用 session_search 找回原文。
- * 这样模型在后续每一轮都知道"较早消息已压缩、原文可检索"，而不是把恢复完全
- * 外包给模型的自发判断。
+ * 提示动态携带当前会话 ID：模型可优先用 session_id 限定只搜当前会话，
+ * 未命中时也可省略 session_id 退化全库检索。这样模型在后续每一轮都知道
+ * "较早消息已压缩、原文可检索"，而不是把恢复完全外包给模型的自发判断。
  */
-const COMPACTION_RECOVERY_HINT_ENABLED = [
-    "[系统提示] 本会话较早的消息已压缩为摘要。",
-    "如需找回被压缩消息的精确原文，可调用 session_search 工具检索本会话，并设置 include_raw_logs=true 以扫描本地 gzip 原始流日志。",
-].join("\n");
+function buildCompactionRecoveryHint(sessionId) {
+    return [
+        "[系统提示] 本会话较早的消息已压缩为摘要。当前会话 ID：" + sessionId + "。",
+        `如需找回被压缩消息的精确原文，优先调用 session_search 工具并设置 session_id="${sessionId}"（仅检索当前会话）；若未命中，可省略 session_id 做全库检索（较慢）。检索时请设置 include_raw_logs=true 以扫描本地 gzip 原始流日志。`,
+    ].join("\n");
+}
 const COMPACTION_RECOVERY_HINT_DISABLED = [
     "[系统提示] 本会话较早的消息已压缩为摘要，原始消息未保留（raw stream logs 已关闭）。",
 ].join("\n");
@@ -139,16 +142,18 @@ function addAnthropicToolJsonCompatibilityNote(messages) {
 }
 /**
  * 压缩后恢复提示注入：只要会话存在摘要（即发生过压缩），就在摘要消息后追加
- * 一条提示，告知模型可用 session_search（include_raw_logs=true）找回被压缩的原文。
- * 提示内容随 raw stream logs 开关动态切换，避免关闭日志时给出误导性承诺。
+ * 一条提示，告知模型可用 session_search 找回被压缩的原文。
+ * - raw stream logs 开启：提示携带当前会话 ID，优先 session_id 限定当前会话，
+ *   未命中时可省略 session_id 做全库检索；
+ * - raw stream logs 关闭：仅告知原文未保留，不给出误导性承诺。
  */
-function maybeAppendCompactionRecoveryHint(messages, summary, rawLogsEnabled) {
+function maybeAppendCompactionRecoveryHint(messages, summary, rawLogsEnabled, sessionId) {
     if (!summary.trim())
         return messages;
     const summaryIndex = messages.findIndex((message) => message.role === "user" && message.content.startsWith("以下是更早的对话摘要"));
     if (summaryIndex < 0)
         return messages;
-    const hint = rawLogsEnabled ? COMPACTION_RECOVERY_HINT_ENABLED : COMPACTION_RECOVERY_HINT_DISABLED;
+    const hint = rawLogsEnabled ? buildCompactionRecoveryHint(sessionId) : COMPACTION_RECOVERY_HINT_DISABLED;
     return messages.map((message, index) => (index === summaryIndex
         ? { ...message, content: `${message.content}\n\n${hint}` }
         : message));
@@ -205,8 +210,10 @@ function normalizeMaxSteps(value) {
     return value;
 }
 function normalizeAnthropicBaseURL(baseURL) {
-    const normalized = baseURL.trim().replace(/\/+$/, "");
-    return normalized.endsWith("/v1") ? normalized : `${normalized}/v1`;
+    // 完全按用户填写的地址使用，不自动补 /v1（AI SDK 仅对官方 api.anthropic.com
+    // 特判补一次 /v1，其他地址原样拼接 /messages）。
+    // DeepSeek Anthropic 端点示例：https://api.deepseek.com/anthropic/v1。
+    return baseURL.trim().replace(/\/+$/, "");
 }
 export class ChatSession {
     model;
@@ -260,6 +267,7 @@ export class ChatSession {
             contextDir: options.contextDir,
             sessionId: options.sessionId ?? defaultBuiltinSessionId(this.cwd),
             cwd: this.cwd,
+            contextWindow: options.contextWindow ?? appConfig.contextWindow,
             compactAtTokens: options.compactAtTokens,
             keepRecentMessages: options.keepRecentMessages,
         });
@@ -333,7 +341,7 @@ export class ChatSession {
             const system = this.buildSystemPrompt(skills);
             this.systemPrompt = system;
             const contextMessages = this.context.buildModelMessages();
-            const hintedMessages = maybeAppendCompactionRecoveryHint(contextMessages, this.context.summary, appConfig.rawStreamLogs.enabled);
+            const hintedMessages = maybeAppendCompactionRecoveryHint(contextMessages, this.context.summary, appConfig.rawStreamLogs.enabled, this.context.sessionId);
             const modelMessages = this.provider === "anthropic"
                 ? addAnthropicToolJsonCompatibilityNote(hintedMessages)
                 : hintedMessages;

package/dist/src/adapters/ccc-adapter.js

@@ -8,6 +8,7 @@ function toChatSessionOptions(sessionId, cwd, options) {
         persist: true,
         sessionId,
         contextDir: options.contextDir,
+        contextWindow: options.contextWindow,
         compactAtTokens: options.compactAtTokens,
         keepRecentMessages: options.keepRecentMessages,
         compactionTimeoutMs: options.compactionTimeoutMs,

package/dist/src/config.js

@@ -86,6 +86,7 @@ const CONFIG_SAMPLE_FILE = join(PROJECT_ROOT, "config.sample.json");
 export const DEFAULT_CCC_DEEPSEEK_BASE_URL = "https://api.deepseek.com/v1";
 export const DEFAULT_CCC_MODEL = "deepseek-v4-pro";
 export const DEFAULT_CCC_COMPACTION_TIMEOUT_MS = 5 * 60 * 1000;
+export const DEFAULT_CCC_CONTEXT_WINDOW_TOKENS = 1_048_576;
 /**
  * 将旧位置（PROJECT_ROOT）的持久化数据一次性迁移到 USER_DATA_DIR。
  * 仅当 USER_DATA_DIR 下没有 config.json 且 PROJECT_ROOT 下有旧数据时才执行。
@@ -312,6 +313,7 @@ function loadConfig() {
             effort: "",
             provider: "",
             compactionTimeoutMs: DEFAULT_CCC_COMPACTION_TIMEOUT_MS,
+            contextWindow: DEFAULT_CCC_CONTEXT_WINDOW_TOKENS,
         },
     };
     if (!IS_TEST_ENV) {
@@ -503,6 +505,7 @@ function loadConfig() {
             effort: normalizeOptionalConfigField(cccRaw.effort, { label: "ccc.effort" }),
             provider: normalizeCccProviderOverride(cccRaw.provider),
             compactionTimeoutMs: normalizePositiveInteger(cccRaw.compactionTimeoutMs, DEFAULT_CCC_COMPACTION_TIMEOUT_MS),
+            contextWindow: normalizePositiveInteger(cccRaw.contextWindow, DEFAULT_CCC_CONTEXT_WINDOW_TOKENS),
         },
     };
 }

package/dist/src/session.js

@@ -530,6 +530,7 @@ export function getAdapterForTool(tool, sessionId) {
             model: effectiveModel || undefined,
             effort: effectiveEffort || undefined,
             compactionTimeoutMs: config.ccc.compactionTimeoutMs,
+            contextWindow: config.ccc.contextWindow,
             // 留空（""）不传 → ChatSession 跟随 DeepCCC 内核配置（~/.deepccc/config.json 或 DEEPCCC_PROVIDER）
             ...(config.ccc.provider ? { provider: config.ccc.provider } : {}),
         });

package/dist/src/web-ui.js

@@ -495,6 +495,10 @@ export function unflattenConfig(flat) {
             result.ccc = result.ccc || {};
             result.ccc.provider = val;
         }
+        else if (key === "CHATCCC_CCC_CONTEXT_WINDOW") {
+            result.ccc = result.ccc || {};
+            result.ccc.contextWindow = parseInt(String(val), 10) || 1048576;
+        }
         else if (key === "CHATCCC_CCC_ENABLED") {
             result.ccc = result.ccc || {};
             result.ccc.enabled = val === true || val === "true";
@@ -631,7 +635,7 @@ async function handleClaudeSdkInstall(_req, res) {
 // ---------------------------------------------------------------------------
 // HTML page (embedded template)
 // ---------------------------------------------------------------------------
-export const PAGE_HTML = `<!DOCTYPE html>
+export const PAGE_HTML = `<!DOCTYPE html>
 <html lang="zh-CN">
 <head>
 <meta charset="UTF-8">
@@ -886,6 +890,20 @@ header .badge{font-size:13px;padding:4px 12px;border-radius:12px;font-weight:500
                 <option value="max">max - 最强推理</option>
               </select>
             </div>
+            <div class="form-group">
+              <label>上下文窗口（模型最大上下文）</label>
+              <select id="field-CHATCCC_CCC_CONTEXT_WINDOW" onchange="onContextWindowPresetChange('field-', this.value)">
+                <option value="1m">1M（1,048,576 tokens，推荐）</option>
+                <option value="512k">512K（524,288 tokens）</option>
+                <option value="256k">256K（262,144 tokens）</option>
+                <option value="128k">128K（131,072 tokens）</option>
+                <option value="custom">自定义（单位 k）</option>
+              </select>
+              <div id="field-CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM_ROW" style="margin-top:6px;display:none">
+                <input type="number" id="field-CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM" min="1" placeholder="例如 768 表示 768K（786,432 tokens）" style="width:100%;padding:8px 12px;border:1px solid #cbd5e1;border-radius:8px;font-size:14px;outline:none">
+              </div>
+              <div class="hint">压缩阈值自动 = 窗口 × 80%（超出即把较早消息压缩为摘要）。⚠️ 超过模型/服务端实际上限时请求会被 API 直接拒绝（context length exceeded）；实际窗口以模型与所用服务端为准（如 litellm 代理的 max_input_tokens）。</div>
+            </div>
           </fieldset>
         </div>
 
@@ -1211,7 +1229,7 @@ const AGENT_FIELDS = {
   claude: ['CHATCCC_ANTHROPIC_MODEL','CHATCCC_ANTHROPIC_SUBAGENT_MODEL','CHATCCC_ANTHROPIC_EFFORT','CHATCCC_ANTHROPIC_API_KEY','CHATCCC_ANTHROPIC_BASE_URL','CHATCCC_ANTHROPIC_MAX_TURN'],
   cursor: ['CHATCCC_CURSOR_PATH','CHATCCC_CURSOR_MODEL','CHATCCC_CURSOR_ALTERNATIVE_MODEL','CHATCCC_CURSOR_AVATAR_BATTERY_MODE','CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'],
   codex: ['CHATCCC_CODEX_PATH','CHATCCC_CODEX_MODEL','CHATCCC_CODEX_ALTERNATIVE_MODEL','CHATCCC_CODEX_EFFORT','CHATCCC_CODEX_FAST_MODE'],
-  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT','CHATCCC_CCC_PROVIDER']
+  ccc: ['CHATCCC_CCC_API_KEY','CHATCCC_CCC_BASE_URL','CHATCCC_CCC_MODEL','CHATCCC_CCC_ALTERNATIVE_MODEL','CHATCCC_CCC_EFFORT','CHATCCC_CCC_PROVIDER','CHATCCC_CCC_CONTEXT_WINDOW']
 };
 const FEISHU_FIELDS = ['CHATCCC_APP_ID','CHATCCC_APP_SECRET'];
 const WEB_UI_FIELDS = ['CHATCCC_WEB_UI_OPEN_ON_START'];
@@ -1221,6 +1239,58 @@ function cursorBatteryModeLabel(value) {
   return value === 'onDemandUse' ? 'On demand use 金额' : 'API 使用比例';
 }
 
+// 上下文窗口：预设档位 ↔ tokens。下拉值用小写 k / m 标签，自定义输入以 k 为单位。
+function contextWindowPresetFor(tokens) {
+  if (tokens === 1048576) return '1m';
+  if (tokens === 524288) return '512k';
+  if (tokens === 262144) return '256k';
+  if (tokens === 131072) return '128k';
+  return 'custom';
+}
+
+function contextWindowTokensLabel(tokens) {
+  var t = Number(tokens) || 1048576;
+  if (t >= 1048576) return (t / 1048576) + 'M (' + t.toLocaleString('en-US') + ' tokens)';
+  return (t / 1024) + 'K (' + t.toLocaleString('en-US') + ' tokens)';
+}
+
+// 根据 tokens 回填预设下拉 + 自定义输入；prefix 为 'field-'（向导）或 'edit-'（编辑弹窗）。
+function prefillContextWindow(prefix, tokens) {
+  var t = Number(tokens) || 1048576;
+  var selectEl = document.getElementById(prefix + 'CHATCCC_CCC_CONTEXT_WINDOW');
+  if (!selectEl) return;
+  var preset = contextWindowPresetFor(t);
+  selectEl.value = preset;
+  onContextWindowPresetChange(prefix, preset);
+  if (preset === 'custom') {
+    var customEl = document.getElementById(prefix + 'CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM');
+    if (customEl) customEl.value = String(Math.round(t / 1024));
+  }
+}
+
+// 预设切换：custom 时显示自定义输入框（单位 k）。
+function onContextWindowPresetChange(prefix, value) {
+  var rowId = prefix === 'edit-' ? 'edit-CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM_ROW' : 'field-CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM_ROW';
+  var row = document.getElementById(rowId);
+  if (row) row.style.display = (value === 'custom') ? '' : 'none';
+}
+
+// 把预设下拉 + 自定义输入转换为 tokens 数字字符串（用于提交给服务端）。
+function contextWindowToTokensValue(prefix) {
+  var selectEl = document.getElementById(prefix + 'CHATCCC_CCC_CONTEXT_WINDOW');
+  if (!selectEl || !selectEl.value) return null;
+  var v = selectEl.value;
+  if (v === '1m') return String(1048576);
+  if (v === 'custom') {
+    var customEl = document.getElementById(prefix + 'CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM');
+    var k = parseInt((customEl && customEl.value.trim()) || '', 10);
+    if (!Number.isFinite(k) || k <= 0) k = 1024; // 非法输入回退 1M
+    return String(k * 1024);
+  }
+  var presetK = parseInt(v, 10); // '128k' → 128
+  return String((presetK || 1024) * 1024);
+}
+
 function configEffectHint(section) {
   if (section === 'feishu') return '生效范围：App ID、App Secret、平台类型或飞书开关变更需要重启 ChatCCC；其它未变更项仅保存。';
   if (section === 'webUi') return '生效范围：下次直接启动生效；内部重启始终不打开。';
@@ -1548,6 +1618,7 @@ function renderStep2() {
     prefillNested('field-CHATCCC_CCC_MODEL', c.ccc.model);
     prefillNested('field-CHATCCC_CCC_ALTERNATIVE_MODEL', c.ccc.alternativeModel);
     prefillNested('field-CHATCCC_CCC_EFFORT', c.ccc.effort);
+    prefillContextWindow('field-', c.ccc.contextWindow);
   }
 
   // 按已有 config 决定每个 Agent 默认是否开启：优先 enabled 字段，缺省时按"任一字段非空"
@@ -1647,6 +1718,11 @@ function collectAllFields() {
   }
   if (state.agentsEnabled.ccc) {
     AGENT_FIELDS.ccc.forEach(function(key){
+      if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') {
+        var cw = contextWindowToTokensValue('field-');
+        if (cw !== null) vars[key] = cw;
+        return;
+      }
       var el = document.getElementById('field-' + key);
       if (el && el.value.trim()) vars[key] = el.value.trim();
     });
@@ -1728,6 +1804,7 @@ function renderStep3() {
       lines.push('<div class="config-row"><span class="key">模型</span><span class="val">' + (vars.CHATCCC_CCC_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">备选模型</span><span class="val">' + (vars.CHATCCC_CCC_ALTERNATIVE_MODEL || '(留空)') + '</span></div>');
       lines.push('<div class="config-row"><span class="key">Effort</span><span class="val">' + (vars.CHATCCC_CCC_EFFORT || '(留空)') + '</span></div>');
+      lines.push('<div class="config-row"><span class="key">上下文窗口</span><span class="val">' + contextWindowTokensLabel(vars.CHATCCC_CCC_CONTEXT_WINDOW || 1048576) + '</span></div>');
     }
   });
   document.getElementById('review-content').innerHTML = lines.join('');
@@ -2023,14 +2100,15 @@ function editSection(section) {
     'CHATCCC_CODEX_FAST_MODE': 'Fast 模式',
     'CHATCCC_CCC_API_KEY': 'API Key', 'CHATCCC_CCC_BASE_URL': 'Base URL',
     'CHATCCC_CCC_PROVIDER': 'API 协议（选填）',
-    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort'
+    'CHATCCC_CCC_MODEL': '模型', 'CHATCCC_CCC_ALTERNATIVE_MODEL': '备选模型', 'CHATCCC_CCC_EFFORT': 'Effort', 'CHATCCC_CCC_CONTEXT_WINDOW': '上下文窗口'
   };
   var hintMap = {
     'CHATCCC_WEB_UI_OPEN_ON_START': '关闭后可继续手动访问 http://localhost:<端口>/；/restart、/update 和 Web UI 重启无论此项为何值都不会自动打开。',
     'CHATCCC_CHROME_DEVTOOLS_ENABLED': '依赖：本机 Google Chrome；ChatGPT 订阅到期查询需要在该 CDP Chrome 中登录 ChatGPT。',
     'CHATCCC_CHROME_DEVTOOLS_PORT': '默认 15166，健康检查端点为 http://127.0.0.1:15166/json/version。',
     'CHATCCC_CHROME_DEVTOOLS_PATH': '选填。留空时自动探测 Google Chrome。',
-    'CHATCCC_CCC_PROVIDER': '与 Base URL 强相关：OpenAI 兼容端点选 openai；Anthropic Messages 端点选 anthropic。留空 = 跟随 DeepCCC 内核配置（~/.deepccc/config.json 或 DEEPCCC_PROVIDER），改动需重启 ChatCCC 生效。'
+    'CHATCCC_CCC_PROVIDER': '与 Base URL 强相关：OpenAI 兼容端点选 openai；Anthropic Messages 端点选 anthropic。留空 = 跟随 DeepCCC 内核配置（~/.deepccc/config.json 或 DEEPCCC_PROVIDER），改动需重启 ChatCCC 生效。',
+    'CHATCCC_CCC_CONTEXT_WINDOW': '压缩阈值自动 = 窗口 × 80%（超出即把较早消息压缩为摘要）。⚠️ 超过模型/服务端实际上限时请求会被 API 直接拒绝（context length exceeded），实际窗口以模型与所用服务端为准（如 litellm 代理的 max_input_tokens）；单位 k = 1024 tokens，1M = 1,048,576 tokens。'
   };
 
   if (section === 'chromeDevtools') {
@@ -2076,6 +2154,7 @@ function editSection(section) {
         else if (key === 'CHATCCC_CCC_MODEL') val = state.config.ccc.model || '';
         else if (key === 'CHATCCC_CCC_ALTERNATIVE_MODEL') val = state.config.ccc.alternativeModel || '';
         else if (key === 'CHATCCC_CCC_EFFORT') val = state.config.ccc.effort || '';
+        else if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') val = state.config.ccc.contextWindow || '1048576';
       }
     }
     var isSecret = key.includes('SECRET') || key.includes('API_KEY');
@@ -2102,6 +2181,22 @@ function editSection(section) {
       html += '</select>';
       if (hintMap[key]) html += '<div class="hint" style="margin-top:6px;line-height:1.5">' + hintMap[key] + '</div>';
       html += '</div>';
+    } else if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') {
+      var cwVal = val || '1048576';
+      var cwPreset = contextWindowPresetFor(cwVal);
+      html += '<div class="form-group"><label>' + (labelMap[key] || key) + '</label>';
+      html += '<select id="edit-' + key + '" onchange="onContextWindowPresetChange(\\'edit-\\', this.value)" style="width:100%;padding:8px 12px;border:1px solid #cbd5e1;border-radius:8px;font-size:14px;outline:none">';
+      html += '<option value="1m"' + (cwPreset === '1m' ? ' selected' : '') + '>1M（1,048,576 tokens，推荐）</option>';
+      html += '<option value="512k"' + (cwPreset === '512k' ? ' selected' : '') + '>512K（524,288 tokens）</option>';
+      html += '<option value="256k"' + (cwPreset === '256k' ? ' selected' : '') + '>256K（262,144 tokens）</option>';
+      html += '<option value="128k"' + (cwPreset === '128k' ? ' selected' : '') + '>128K（131,072 tokens）</option>';
+      html += '<option value="custom"' + (cwPreset === 'custom' ? ' selected' : '') + '>自定义（单位 k）</option>';
+      html += '</select>';
+      html += '<div id="edit-CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM_ROW" style="margin-top:6px;display:' + (cwPreset === 'custom' ? '' : 'none') + '">';
+      html += '<input type="number" id="edit-CHATCCC_CCC_CONTEXT_WINDOW_CUSTOM" min="1" placeholder="例如 768 表示 768K（786,432 tokens）" style="width:100%;padding:8px 12px;border:1px solid #cbd5e1;border-radius:8px;font-size:14px;outline:none" value="' + (cwPreset === 'custom' ? Math.round(Number(cwVal) / 1024) : '') + '">';
+      html += '</div>';
+      if (hintMap[key]) html += '<div class="hint" style="margin-top:6px;line-height:1.5">' + hintMap[key] + '</div>';
+      html += '</div>';
     } else {
       var rowId = key === 'CHATCCC_CURSOR_ON_DEMAND_MONTHLY_BUDGET'
         ? ' id="edit-cursor-on-demand-budget-row"'
@@ -2129,6 +2224,9 @@ function editSection(section) {
     html += '</select></div>';
   }
   document.getElementById('edit-modal-fields').innerHTML = html;
+  if (section === 'ccc') {
+    prefillContextWindow('edit-', (state.config.ccc && state.config.ccc.contextWindow) || 1048576);
+  }
   if (section === 'cursor') {
     var editModeEl = document.getElementById('edit-CHATCCC_CURSOR_AVATAR_BATTERY_MODE');
     onCursorBatteryModeChange('edit-', editModeEl ? editModeEl.value : 'apiPercent');
@@ -2158,6 +2256,10 @@ async function saveEdit() {
     var el = document.getElementById('edit-' + key);
     if (!el) return;
     if (key === 'CHATCCC_WEB_UI_OPEN_ON_START' || key === 'CHATCCC_CHROME_DEVTOOLS_ENABLED' || key === 'CHATCCC_CODEX_FAST_MODE') vars[key] = !!el.checked;
+    else if (key === 'CHATCCC_CCC_CONTEXT_WINDOW') {
+      var cw = contextWindowToTokensValue('edit-');
+      if (cw !== null) vars[key] = cw;
+    }
     else vars[key] = el.value.trim();
   });
   if (editSectionType === 'chromeDevtools' && !vars.CHATCCC_CHROME_DEVTOOLS_PORT) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "chatccc",
-  "version": "0.2.254",
+  "version": "0.2.256",
   "description": "Feishu bot bridge for Claude Code",
   "license": "Apache-2.0",
   "type": "module",