Context Anchor

核心用法

Context Anchor 是一个纯 Bash 脚本工具，用于在上下文压缩后帮助 Agent 快速恢复工作状态。它通过扫描预定义的记忆文件路径（memory/current-task.md、日期日志、context/active/*.md），提取当前任务状态、活跃文件、近期决策和待办事项，生成结构化的 "Where You Left Off" 简报。

显著优点

1. 零依赖设计：仅使用标准 Unix 工具（find、grep、date 等），跨平台兼容 macOS 和 Linux
2. 模块化输出：支持 --task、--decisions、--loops 等参数按需获取信息，避免信息过载
3. 智能扫描规则：自动识别 "Decision:"、"Decided:"、"✅" 标记决策，"?"、"TODO:"、"Blocker:" 标记待办
4. 与 Agent 工作流深度整合：可直接嵌入 AGENTS.md 的 "Every Session" 例行程序

潜在局限

• 依赖用户遵循特定的文件命名和目录结构约定
• 纯文本匹配，无法理解语义相似性
• 无法处理已被物理删除的文件
• 对于长期项目，默认 2 天回溯可能不足以捕捉完整上下文

适合人群

• 使用文件系统记忆架构的 AI Agent 用户
• 需要频繁处理上下文压缩场景的长期对话用户
• 多 Agent 协作场景下的任务交接

常规风险

低风险。工具只读取文件不写入，但需注意：

• 扫描路径若包含敏感信息（如 API 密钥）会在输出中暴露
• 建议配合 .anchorignore 或路径白名单控制扫描范围

核心用法

context-anchor 是一个专为 AI 会话设计的上下文恢复工具。通过运行 ./scripts/anchor.sh，它会自动扫描本地 memory 文件系统，生成结构化的"当前状态简报"。支持多种查看模式：完整简报（默认）、仅当前任务、仅活跃文件、仅最近决策、仅待办循环，以及自定义扫描天数（--days N）。

显著优点

• 零依赖安全：纯 bash 编写，仅使用 grep、stat、date 等标准 Unix 工具，无任何外部依赖或网络请求
• 跨平台兼容：内置 macOS/Linux 双平台适配，自动识别 stat/date 命令差异
• 智能提取：自动识别决策标记（"Decision:"、"✅"）和待办标记（"TODO:"、"?"、"Blocker:"）
• 场景覆盖：适用于会话启动、上下文压缩后恢复、任务交接、每日回顾等多种场景
• 可定制性：通过 WORKSPACE 环境变量支持自定义工作区路径

潜在局限

• 本地文件依赖：完全依赖用户维护规范的 memory 文件结构，若文件命名或格式不统一，提取效果下降
• 无持久化缓存：每次运行都重新扫描，对于超大工作区可能存在性能瓶颈（但未发现此问题）
• 标记识别刚性：仅支持预设的关键字匹配，不支持自然语言语义理解
• 隐私提示不足：虽然安全报告建议添加，但当前文档未明确声明"无数据外传"

适合人群

• 使用 AI 进行长期项目协作、需要频繁上下文恢复的用户
• 团队协作场景下需要任务交接的 AI 工作流
• 注重数据隐私、偏好纯本地工具的技术用户
• 习惯维护结构化 memory/日志文件的用户

常规风险

• 低：本地文件读取范围由 WORKSPACE 变量控制，需确保指向正确目录
• 低：输出内容可能包含敏感工作信息，共享屏幕时需注意
• 建议：当前未指定开源许可证，建议补充 LICENSE 文件