SuperAPI AI 工具集

ctx-purge

通用与其它

查看项目

更新于 10-16 06:48

技能介绍

用途:ctx-purge 用于永久删除 context-mode 的知识库与会话数据,是删除会话数据的唯一机制,操作不可撤销。

主要能力:支持两种范围。项目范围(scope: "project")会清空全部内容,包括 FTS5 知识库(来自 ctx_index、ctx_fetch_and_index、ctx_batch_execute 的所有索引内容)、项目中所有会话的事件数据库行(分析、元数据、恢复快照)、会话事件 markdown 文件,以及内存与持久化的统计数据。会话范围(sessionId: "<id>" 或 scope: "session")只清除匹配会话的行与 FTS5 分块,保留同级会话、项目统计和 FTS5 存储文件。

使用方式:先与用户确定范围。只清一个会话需提供 sessionId;清整个项目需确认 scope:'project'。调用 mcp__context-mode__ctx_purge MCP 工具:会话级传 { confirm: true, sessionId: "<id>" };项目级传 { confirm: true, scope: "project" }。仅传 { confirm: true } 仍可用但会发出弃用警告,建议使用显式形式。执行后向用户报告结果,响应会列出被删除的内容,会话级清理还会确认其他会话与项目统计已保留。

规则:confirm: true 始终必填;sessionId 与 scope: "project" 同时出现会被拒绝(含义矛盾);scope: "session" 缺少 sessionId 会报错。

适用场景:会话级用于临时验收场景、演练回放、隔离被污染的会话而不丢失主会话统计;项目级用于知识库含过时或错误内容污染搜索结果、在同一会话中切换无关项目、或需要完全重新开始。

限制:ctx_purge 是删除会话数据的唯一方式;ctx_stats 只读,仅显示统计;/clear 与 /compact 不影响任何 context-mode 数据;没有撤销功能,如需内容须重新索引。