用途:inspector-on 用于开启 CocoPlus 的自动环境扫描模式。启用后,每次在指定目录启动 Coco 会话时,都会在后台触发一次环境扫描,结果保存到 .cocoplus/snapshots/ 目录。
主要能力:一是创建模式标志文件 .cocoplus/modes/inspector.on(内容为空);二是更新 AGENTS.md,把 Inspector 行改为“- Inspector: ON (auto-scan at session start)”,并保持文件不超过 200 行;三是完成启用后输出确认信息。
使用方式:执行前先确认 .cocoplus/ 目录存在,若不存在则输出提示“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止。确认无误后,用 Write 工具创建空标志文件(说明中要求跨平台,不使用 touch);随后更新 AGENTS.md 中的 Inspector 行。输出内容为“✓ Environment Inspector enabled. A background environment scan will run at the start of every Coco session in this directory. Results are saved to .cocoplus/snapshots/。”
完成条件:.cocoplus/modes/inspector.on 标志文件存在,并且 .cocoplus/AGENTS.md 中的 Inspector 行显示为“- Inspector: ON (auto-scan at session start)”。资料还特别提醒,不能因为标志文件已存在就跳过更新 AGENTS.md;AGENTS.md 是热上下文,如果其中显示“Inspector: off”,即使标志文件已设置,AI 也不会触发自动扫描。
适用场景:需要在每次 Coco 会话开始时自动了解目录环境的场景。
限制:依赖已有的 .cocoplus/ 初始化;具体扫描项、耗时和快照格式暂未提供。