Business Pain Points

业务痛点

1. 上下文满了，但 compact 没有及时发生

Claude Code、本地估算器和模型提供商可能采用不同的 Token 统计方式。客户端认为仍有空间时，上游已经按 input + requested output 拒绝请求。结果是 /compact 本身也无法被模型执行。

**CCProxy Agent 的处理：**使用更保守的本地阈值，提前评估输出预算，并解析上游 400 中报告的 context limit、input tokens 和 requested output。

2. 工具输出不断堆积并触发重复调用

Read、Bash、Grep 等工具可能返回几十万字符。简单截断最新结果后，模型看不到刚获得的数据，最自然的行为是再次执行同一个工具，形成循环。

**CCProxy Agent 的处理：**先清除较旧的 tool_result.content；仍超限时只裁剪最新结果中段，保留头部、尾部、tool_use_id 和消息位置，并明确提示模型不要仅因中段被裁剪而重复工具调用。

3. 通用压缩破坏 Agent 协议

把多轮消息合并成普通文本会破坏工具调用顺序、角色以及 tool_use / tool_result 配对。HTTP 请求可能成功，但模型状态已经错误。

**CCProxy Agent 的处理：**一旦检测到 Agent 工具协议，禁止通用文本 chunk/compact，只允许结构化工具结果清理和 Claude 原生 compact。

4. 图片既占上下文，又不一定被主模型支持

Base64 图片体积大；CC Switch 当前选择的主模型也可能没有视觉能力。

**CCProxy Agent 的处理：**识别图片输入，限制图片数量和大小，调用一个或多个 Vision 模型生成文字摘要，再按配置移除原始图片。

5. CC Switch 端口和 Desktop 配置会变化

自动端口、配置切换和 Desktop 3P Gateway 重写会让固定 Base URL 失效。

**CCProxy Agent 的处理：**启动时扫描可用上游；运行中监控 Desktop Gateway 漂移；CC Switch 切换 active config 时恢复旧目标并接管新目标。

6. 代理启动后难以安全关闭

命令行窗口、Web 页面和后台进程可能分别管理生命周期；异常退出还可能让 Claude 永久指向已经不存在的代理。

**CCProxy Agent 的处理：**portable EXE 作为统一入口，关闭时停止 watcher、恢复 CLI/Desktop 配置并关闭 HTTP 连接；异常退出通过 patch state 在下次启动恢复。

不解决的问题

• 不保证压缩完全无损。
• 不阻止 Claude 合理地再次调用工具。
• 不替代模型服务的鉴权、计费和 SLA。
• 当前不支持公网、多用户或多租户部署。
• 当前不提供完整会话内容的审计存档。