核心用法
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生成的任务若未正确配置日志路径，可能导致磁盘写满