AI代理物理状态显示器，通过终端实时展示单字母标识、工作状态与活动详情，实现零延迟的状态感知，适合常驻型智能体监控。
说明：
## 核心用法
Clawd Presence 是一款面向 AI 代理的终端级物理状态显示系统，核心解决”聊天交互存在延迟”的痛点。通过独立的终端窗口持续广播代理状态，用户可像看时钟一样快速感知 AI 当前活动。
**部署流程**：
1. 配置阶段：通过 `configure.py` 自动识别或手动设定单字母标识（A-Z）与代理名称
2. 运行阶段：在独立终端启动 `display.py` 作为常驻显示端
3. 集成阶段：在代理代码中嵌入 `status.py` 调用，任务切换时主动上报状态
**状态机制**：
系统内置五种可视化状态——work（执行中/绿色）、think（处理中/黄色）、idle（待命/青色）、alert（需人工/红色）、sleep（低功耗/蓝色）。支持自定义超时回退（默认5分钟无更新自动转 idle），防止状态过期误导。
## 显著优点
– **零延迟感知**：颠覆”主动查询”模式，状态推送实现被动接收
– **极简集成**：单命令状态上报，无需改造代理核心逻辑
– **视觉编码**：颜色+单字母标识+进度描述，信息密度高
– **常驻友好**：专为 always-on 场景设计，适合长期运行的自动化代理
– **资源轻量**：纯终端渲染，无 GUI 依赖，服务器/边缘设备均可部署
## 潜在局限
– **物理空间依赖**：需独立屏幕或终端窗口，单屏工作环境价值受限
– **信息维度单一**：仅展示”正在做什么”，不展示”做得怎么样”（无进度百分比、无历史记录）
– **状态上报可靠**：依赖代理主动调用，若代理崩溃则显示最后一次上报状态（虽有超时回退，但仍存在窗口期误导）
– **网络/进程隔离**：display 与 status 通过文件或本地机制通信，分布式部署需额外适配
## 适合人群
– 运行长期自动化代理的开发者/运维者（如代码生成 agent、数据 pipeline agent）
– 需要物理可见性而不想持续盯聊天窗口的场景
– 多代理并行监控环境（配合 A-Z 单字母标识快速区分）
– 极简主义偏好者，拒绝 Web Dashboard 的复杂度
## 常规风险
– **状态不同步**：代理异常退出未上报，显示端可能滞留错误状态（直至超时触发）
– **配置泄露**：monogram 与代理名称可能暴露内部命名规范
– **终端持久化**：长期运行终端可能因系统更新、SSH 断开等失效，需配合 tmux/screen 等工具
– **权限边界**：status/configure 脚本需文件系统写权限，多用户环境需关注路径隔离
会员专属
