ContextKeeper 是一款面向AI代理（AI agents）设计的轻量级项目状态追踪工具，核心定位是解决跨会话上下文丢失问题。与传统自动化工具不同，它采用纯手动检查点机制，用户通过 ./ckpt.sh "描述信息" 主动标记项目里程碑，配合 ./dashboard.sh 可视化查看当前状态，实现极简的工作流衔接。
核心用法
工具由两个前台Bash脚本组成，零守护进程设计：
- ckpt.sh：接收用户输入的描述字符串，经严格转义与验证后写入检查点日志
- dashboard.sh：聚合Git状态、最近检查点、时间戳等信息生成可读摘要
显著优点
1. 安全优先架构：明确禁用命令替换、PID文件操作、后台守护进程，从源头消除RCE、权限提升、资源耗尽类攻击面
2. 零依赖部署：仅需bash与git，无需包管理器或编译步骤
3. 确定性行为：完全同步执行，无竞态条件或状态漂移风险
4. AI友好：输出格式稳定，便于代理程序解析
潜在局限
- 无自动保存/崩溃恢复，依赖用户主动创建检查点
- 缺乏多项目隔离机制，单一仓库内全局生效
- 检查点存储为本地文本，无加密或远程同步
- 功能极简，不适合需要实时协作或复杂版本管理的场景
适合人群
- 使用AI编码助手（如GitHub Copilot、Claude Code）的开发者
- 重视终端环境安全、拒绝后台进程的用户
- 短周期任务或单文件实验性项目的快速上下文管理
常规风险
| 风险类型 | 评估 |
|---------|------|
| 命令注入 | 低 — 用户输入经显式转义，无eval/exec |
| 信息泄露 | 中 — 检查点明文存储，可能含敏感提交信息 |
| 可用性 | 低 — 无服务组件，脚本故障不影响系统 |
| 供应链 | 低 — 零外部依赖，代码透明可审计 |