CX CLEAR
GitHub
文档核心功能
核心功能

自动清理策略

用条件规则自动命中待清理的会话。

自动清理策略用「条件组合」描述哪些会话该删:不用一条条挑,写好规则后让规则去命中。

策略是什么

每条规则由若干条件组成,条件之间可以选「且」(全部满足才命中)或「或」(满足任一即命中)。多条规则之间恒为「或」——任一启用规则命中的会话都算待删。

策略保存在 %USERPROFILE%\.cxclear\chat-retention.txt,对话管理页的自动模式会按它预览命中范围。

创建规则

在策略页新建规则、填条件、起个名字。新建的规则默认是关闭的,需要手动打开开关才生效——避免误配规则一把删光。

条件类型

条件取值含义
未更新超过天数会话最后更新时间早于 N 天前
未更新少于天数会话最后更新时间晚于 N 天前
大小超过MB会话占用大于 N MB
大小少于MB会话占用小于 N MB
所属工具是工具限定某个工具的会话
项目名包含文本项目名包含关键字(不区分大小写)
标题包含文本会话标题包含关键字(不区分大小写)

让 AI 生成规则

策略文件是纯文本,可以直接让 AI 按规则格式修改 chat-retention.txt。CLI 提供两个验证手段:

bash
# 校验规则文件写法是否正确
cxclear rules validate --file rules.json

# 试跑某条规则会命中哪些会话(即使还没启用)
cxclear find chats --rules-file rules.json --rule new-rule

AI 写入的规则同样默认关闭,在 GUI 里核对命中范围后再启用。完整命令见 CLI 使用方式。