性能与上下文优化 · ZeroWorks 用户指南

为什么要关心上下文占用

每次模型调用都会重新读取整段对话，因此会话越长，单次调用的成本越高，可用的推理空间也越少。冗长的命令输出是最容易吃掉上下文的地方。

常见的输出大户包括：代码差异、目录列表、搜索结果、测试日志、包管理器安装过程和构建日志。它们本身信息量有限，重复的部分却会被反复读进上下文。

会话接近模型的上下文上限时，工作台会自动把前面的对话整理成一段摘要，再带着摘要继续。你也可以把触发阈值调低，让压缩更早发生。

阈值设置在“设置 → AI → 压缩上下文时机”里，同时会记录在配置目录下的配置文件中。新会话和重启后的会话会读取这个设置。

试一试

{ "autoCompactWindow": 400000 }

Claude 内置子代理可能重复读取自己的上下文。“设置 → AI → 子代理模型”可指定更便宜的模型，适合查找与简单检索。

静态设置只作用于原本继承会话模型的内置子代理；不会把它提升到比会话模型更高的档位，显式指定模型或自定义 Agent 不受影响。这个设置不代表 Pi 连接也提供同样的 Claude 子代理功能。

按任务自动选模还需要 decisionLayer.enabled 与 features.subagentModels 同时开启。只打开决策总开关不够；未启用或无法判断时，继续使用原有静态设置。

与其等会话自然变长，不如主动控制体积。下面的做法都在会话早期就可以用。

试一试

请把这段测试输出保存为文件，只在对话里给出结论和文件路径，不要粘贴完整日志。

RTK 是独立的命令输出压缩工具。ZeroWorks 按需把支持的 Bash 命令交给 rtk rewrite，例如把 git status 改写为 rtk git status，减少返回给模型的重复文本。

rtkEnabled 默认 false。RTK 需安装在实际运行 Agent 的主机，并能被该进程的 PATH 找到；本机安装不会自动提供给另一台远程服务器。当前运行时只使用 0.44.0 及以上版本，更旧版本不会用于改写。

安装方式见 RTK 官方仓库。以下是该项目的安装命令；本页不代替平台安装或真实命令结果验收。

在 Agent 主机按对应平台安装 RTK，运行 rtk --version，确认版本 >= 0.44.0；运行 rtk gain 确认装的是带输出优化统计的 RTK。
在“设置 → AI”找到 RTK / Token 优化。未检测到时点 Recheck；旧版本按 Update 提示升级，再重新检查。
检测通过后打开优化开关。若终端能找到而应用仍找不到，核对应用启动环境的 PATH；安装或修改 PATH 后重启 ZeroWorks。
在会话里运行一条简单的受支持命令，核对结果，再查看设置里的节省统计。并非每条命令都会被改写，也不保证固定节省比例。

环境	安装命令	PATH 检查
macOS / Linux，已安装 Homebrew	brew install rtk	which rtk
Windows	winget install rtk-ai.rtk	where.exe rtk

试一试

rtk --version rtk gain

需要逐行核对日志、匹配行或数值时，可以绕过 RTK。提示模型“不要摘要”不会自动关闭运行时改写；使用配置排除或明确的命令前缀。

主配置的 rtkEnabled 控制总开关；rtkExcludeCommands 是命令首词的精确匹配列表，例如 ["grep", "cat"]，不是正则或完整命令片段。
排除只检查命令开头的首词；复杂管道或前置环境变量不要当作整条命令都已排除。
单次绕过可运行 command grep -n TODO README.md；首词 command 或 builtin 会跳过 RTK，绝对路径也可用于指定真实程序。
需要保留完整输出时写入文件，再按需查看。绕过 RTK 不代表其他工具预览、输出上限或模型上下文限制也被取消。

试一试

{ "rtkEnabled": true, "rtkExcludeCommands": [ "grep", "cat" ] }