用途:作为 Agentic OS 的系统管理员子代理,安全移除 context/.locks/ 目录下所有代理 .lock 锁,用于解决代理崩溃后遗留陈旧锁所引发的死锁。
依赖:需要 Python 3.8+,仅使用标准库,无需外部包。安装依赖命令:pip-compile ./requirements.in 和 pip install -r ./requirements.txt;相关依赖锁定文件当前为空,即仅标准库。
使用方式:按阶段执行。阶段0,如内核可用,先向事件总线发送意图:python context/kernel.py emit_event --agent os-clean-locks --type intent --action clear_locks;若 kernel.py 不存在则跳过。阶段1,确认 context/.locks/ 存在,不存在则告知用户无锁可清并退出。阶段2,用 Bash 列出该目录下所有锁目录(如 ls -la context/.locks/)。阶段3,对找到的每个 .lock 目录安全删除(注意它们是目录而非文件),如 rm -r context/.locks/skill.lock/;如 kernel.py 可用,运行 python context/kernel.py state_update active_agent os-clean-locks 和 python context/kernel.py state_update locks_cleared true,否则跳过。阶段4,如内核可用,发送结果事件:python context/kernel.py emit_event --agent os-clean-locks --type result --action clear_locks --status success,并总结具体移除了哪些锁,确认系统可进行后续代理操作。
适用场景:代理因崩溃留下陈旧锁、系统出现死锁时使用。限制:仅处理 context/.locks/ 目录中的锁;若该目录不存在则无事可做;事件总线与状态更新功能依赖 kernel.py,缺失时相应步骤跳过;删除操作为不可逆的目录递归删除,需确认目标路径正确。