inspector-off 是 snowflake-labs/cocoplus 提供的技能,用来关闭 CocoPlus 在会话开始时自动执行的环境扫描。
用途: 当用户不希望每次会话开始时自动扫描环境时,可以使用该技能关闭自动扫描,同时保留已有的环境快照记录。
主要能力与执行流程:
- 前置检查:确认当前目录存在 .cocoplus/ 目录。如果不存在,就输出“CocoPlus not initialized in this directory. Run $pod init to begin.”并停止,不进行后续操作。
- 移除模式标记:删除 .cocoplus/modes/inspector.on 文件(如果存在)。资料给出的跨平台实现方式为 Bash 工具执行 node -e "try{require('fs').unlinkSync('.cocoplus/modes/inspector.on')}catch(_){}"。
- 更新 AGENTS.md:保持文件不超过 200 行,把 Inspector 行替换为“- Inspector: off”。
- 输出结果提示:“✓ Environment Inspector disabled. Existing snapshots in .cocoplus/snapshots/ are preserved. Run $inspector on to re-enable.”
完成标准:
- .cocoplus/modes/inspector.on 标记文件不存在;
- .cocoplus/AGENTS.md 中 Inspector 行显示为“- Inspector: off”;
- .cocoplus/snapshots/ 中已有的快照文件仍然存在,未被删除。
适用场景: 适用于已使用 CocoPlus 初始化、但希望跳过会话开始时自动环境扫描的目录或项目。
限制与注意事项:
- 未初始化 CocoPlus 的目录无法执行,需要先运行 $pod init。
- 关闭自动扫描不应删除已有快照;快照是环境历史记录,关闭扫描并不意味着历史数据失效。
- 重新启用需运行 $inspector on。
- 资料未提供其他配置项、版本要求或平台差异说明。