智能对话上下文恢复工具,支持多级别摘要、时间线回顾与自动触发,让用户秒级回到工作状态
说明:
## 核心用法
`context-restore` 是一款对话上下文恢复技能,核心功能是读取压缩后的上下文文件(`compressed_context/latest_compressed.json`),提取关键信息并生成结构化报告,帮助用户在开启新会话后快速恢复工作状态。
**三种调用方式:**
1. **命令触发**:`/context-restore` 或 `/context-restore –level detailed`
2. **自然语言**:说”继续之前的工作””恢复上下文”等关键词自动触发
3. **Python API**:`restore_context(filepath, level=”normal”)`
**三级恢复粒度:**
– **Minimal(极简)**:核心状态一句话 + 1个活跃任务,适合快速确认
– **Normal(标准)**:项目状态、待办任务、最近操作、MEMORY.md 高亮,日常默认
– **Detailed(完整)**:完整会话概览、7天时间线、所有项目详情,适合深度回顾
**Phase 2 增强功能**:时间线视图(`–timeline –period weekly`)、内容过滤(`–filter`)、上下文对比(`–diff`)
**Phase 3 自动集成**:变化检测(`–check-only`)、自动恢复(`–auto`)、Cron 任务安装(`–install-cron`)
## 显著优点
– **零摩擦恢复**:自然语言触发,无需记忆复杂命令
– **智能分级**:三档粒度精准匹配不同场景需求
– **结构化输出**:JSON API 供其他技能调用,生态集成友好
– **跨平台适配**:Telegram 自动分块、Discord embed、CLI 树形结构
– **自动化能力**:Cron 集成实现周期性自动监控与恢复
– **健壮性设计**:文件损坏降级读取、权限错误静默处理
## 潜在局限
– **依赖前置技能**:必须配合 `context-save` 使用,否则无数据可恢复
– **文件路径固定**:默认依赖特定路径 `compressed_context/latest_compressed.json`,跨设备同步需额外配置
– **自动模式风险**:`–auto` 可能恢复过时或冲突的上下文,建议配合 `–confirm` 使用
– **中文分词限制**:`–filter` 关键词过滤为简单字符串匹配,无语义理解
– **Telegram 分块阈值**:固定 4000 字符分割,中文环境下可能因 UTF-8 多字节出现截断问题
## 适合人群
| 用户类型 | 典型场景 |
|———|———|
| 多项目并行开发者 | 跨天/跨任务切换时快速定位进度 |
| 长周期对话用户 | 周期性回顾本周工作成果 |
| 自动化工作流搭建者 | 配合 Cron 实现无人值守状态同步 |
| 团队协作场景 | 通过 `–diff` 追踪项目变更历史 |
## 常规风险
– **隐私泄露**:上下文文件可能包含敏感对话内容,需确保 `compressed_context/` 目录权限控制
– **状态冲突**:自动恢复可能覆盖用户当前手动输入的意图,建议关键操作前执行 `–check-only` 验证
– **存储膨胀**:长期运行的详细模式日志可能累积,需定期清理历史版本
– **Cron 任务失控**:`–install-cron` 生成的任务若未正确配置日志路径,可能导致磁盘写满








