ctx-purge

Context Mode 清除

永久删除此项目的会话数据。支持两种范围（issue #520）：

• 项目范围（scope: "project"）：清除所有内容——知识库、每个会话的所有会话数据库行、事件 Markdown 文件和统计数据。
• 会话范围（sessionId: "<id>" 或 scope: "session"）：仅清除匹配会话的行和 FTS5 分块。其他会话、项目统计数据和 FTS5 存储文件都会保留。

操作说明

1. 先与用户确定范围：
   • “只清除一个会话？”→ 询问 sessionId。
   • “清除整个项目？”→ 确认 scope:'project'（这是具有破坏性且不可逆的默认选项）。
2. 警告用户，使用 scope:'project' 会删除所有内容：
   • FTS5 知识库（ctx_index、ctx_fetch_and_index、ctx_batch_execute 中的所有已索引内容）
   • 项目中所有会话的会话事件数据库（分析数据、元数据、恢复快照）
   • 会话事件 Markdown 文件
   • 内存中的会话统计数据及持久化统计文件
3. 使用选定的参数调用 mcp__context-mode__ctx_purge MCP 工具：
   • 指定范围：{ confirm: true, sessionId: "<id>" }——表示会话范围。
   • 项目范围：{ confirm: true, scope: "project" }——明确的破坏性操作形式。
   • 仅使用 { confirm: true } 仍然有效，但会发出弃用警告。优先使用明确指定范围的形式。
4. 向用户报告结果——响应会明确列出删除的内容，并（对于指定范围的清除）确认其他会话和项目统计数据均已保留。

Schema 规则

• 始终需要 confirm: true。
• 同时指定 sessionId 和 scope: "project" 会被拒绝，因为这存在歧义（sessionId 表示会话范围，与项目范围组合会产生矛盾）。
• 未指定 sessionId 时使用 scope: "session" 会报错——必须提供 sessionId。

适用场景

• 指定范围（按会话）：临时验收场景、演练回放、隔离受污染的会话，同时保留主工作会话的统计数据。
• 项目范围：知识库中包含陈旧或错误内容，污染了搜索结果；在同一会话中切换互不相关的项目；需要完全重新开始。

重要事项

• ctx_purge 是删除会话数据的唯一方式。不存在其他机制。
• ctx_stats 为只读——仅显示统计数据。
• /clear 和 /compact 不会影响任何 context-mode 数据。
• 此操作无法撤销。如需再次使用相关内容，请重新索引。