lazyagent 编程代理监控台
在一个终端或桌面面板中监控多个编程代理的会话、状态与用量。
按维度查看评分与理由
证据表明产品默认在本地观察代理会话，无需账户或服务器；HTTP API 使用 Bearer 令牌，Webhook 声称采用签名载荷，维护命令提供交互确认、干运行预览及默认备份。发布工作流中的第三方 Actions 固定到提交，macOS 产物经过签名、公证并发布校验和。扣分原因是未提供实现代码来确认文件访问范围、令牌存储、Webhook 数据字段及运行时最小权限；Arch 仓库明确要求“Optional TrustAll”且包未签名；删除后的完整恢复流程也未展示。仓库、版权方和灵感来源有署名，但发布者身份与具体维护者责任未被独立确认。
README、许可证、Go 模块和发布工作流在产品名称、平台、构建方式及分发形式上高度一致，因此自洽性充分。依赖均指定版本，构建说明涵盖 Node、Go、GTK/WebKitGTK，发布流程还运行测试并验证 Linux 产物。扣分原因是 Wails 仍为 alpha 版本、依赖树较大，且所给材料未展示依赖故障降级策略。工作流包含明确的错误检查和失败退出，但没有提供普通运行时、解析损坏会话或网络/Webhook 故障时的用户错误信息。
材料清楚覆盖终端用户、桌面用户、脚本/API 客户端及 iOS 客户端场景，并明确产品是观察器而非代理替代品；支持的代理、接口和维护功能边界列举充分。macOS/Linux、x86_64/arm64、CLI/GUI/API 的安装与环境要求较详尽。扣分集中在触发精度：命令入口和显式的 YOLO 选项很清楚，但没有实现证据说明会话发现、状态转换、Webhook 触发及代理识别如何避免误判。
README 信息架构清晰，并指向按入门、概念、接口、用法、维护和参考分类的文档；安装、构建、启动和多种打包方式说明充分。MIT 文本完整且与元数据一致。扣分原因是命名和打包仍在演进（history 别名、cask/formula 变更），示例丰富但未见实际 FAQ 内容，已披露未签名 Arch 包和 Linux 依赖等限制但缺乏完整限制清单；News 和 Releases 提供更新路径，却没有所给材料中的正式变更日志。维护组织、社交账号、赞助入口和机器人身份可见，但职责分工、安全报告渠道及经验证的发布者身份不明确。
TUI、桌面卡片界面、HTTP API、JSON 输出、搜索片段、会话恢复和维护预览形成了可直接使用的输出与操作路径，故输出可用性充分。集中监控九类代理并保留原工作流具有明确的边际价值，但“不同于其他工具”和节省“80+ MiB”等主张没有比较数据或方法支撑。开源、本地运行、多种免费客户端及可选付费 iOS 客户端带来合理成本收益，但安装依赖、桌面构建复杂度、Webhook/API 配置成本和未签名分发风险未被量化。
多数安装、依赖、许可证和发布安全声明可追溯到 README、go.mod、LICENSE 与工作流中的具体配置，且这些来源相互印证版本化依赖、测试、校验和、公证和平台产物。扣分原因是核心监控、压缩、删除、索引、认证和签名行为缺少实现代码或测试文件佐证；“完全开源”、代理兼容性和空间节省等部分主张仅由 README 陈述。事实、操作说明与营销语大体可区分，但没有明确标注测量方法、假设或推断边界。
- Arch 软件源的软件包未签名，并要求启用“SigLevel = Optional TrustAll”；不愿信任托管该源的 GitHub 账户时，应优先使用带校验和的发布资产。
- 该工具读取并索引代理聊天记录，且可发送出站 Webhook；启用前应核查实际采集字段、索引位置、文件权限、API 绑定地址、令牌存储和 Webhook 目标。
- prune 会删除会话，compact 会原地重写文件；即使文档声称提供预览、验证和默认备份，也应先使用干运行并独立备份重要记录。
- sessions/latest 的 --yolo 模式会以降低确认约束的方式恢复代理会话；仅应在理解原代理权限和项目风险后显式使用。
- 本评估仅基于所给静态文件，未执行程序、测试安装包或核验发布者身份。
这个 Agent 能做什么，适合哪些场景？
lazyagent 是一款本地运行的编程代理监控工具，支持 Claude Code、Cursor、Codex、Grok CLI、Kilo、Kimi Code CLI、Amp、pi 和 OpenCode。它提供终端界面、macOS/Linux 桌面应用和受 Bearer Token 保护的 HTTP API，不要求服务器或账户，也不取代原有的代理工作流。工具读取本机会话及转录文件，汇总代理活动，并可列出、恢复、搜索、压缩或清理会话。它还可展示部分代理的速率限制或计费用量，并在会话转为空闲、等待输入或发生状态变化时发送签名 Webhook。桌面包同时包含 lazyagent 命令；只需要命令行的用户也可安装独立的 TUI/API 版本。
启动后，lazyagent 从受支持代理在本机留下的会话与转录数据中识别项目、活动状态和历史记录，并通过 TUI、桌面卡片面板或 HTTP API 输出统一视图。lazyagent sessions 列出当前目录下各代理的会话并允许恢复，lazyagent latest 直接恢复最近一次会话，两者均支持 YOLO 模式。lazyagent search 为 Claude、Codex、pi、Amp、Grok 和 Kimi 的转录文件建立增量本地索引并返回高亮片段。lazyagent compact 原地截断大型工具输出、思考块和嵌入图片，同时保留会话可恢复性；lazyagent prune 按天数或已不存在的项目目录筛选并删除聊天文件，提供交互选择、预览和 dry-run。lazyagent limits 汇总 Claude Code、Codex、Grok、Kimi Code 和 Cursor 的已记录用量窗口；状态转换还可触发带签名 JSON 载荷的出站 Webhook。
- 同时使用 Claude Code、Codex、Cursor 等多个工具的开发者，希望在一个 TUI 中查看所有活跃会话。
- 需要离开终端持续观察任务的 macOS 或 Linux 用户，可使用菜单栏、系统托盘或独立桌面仪表板。
- 积累大量代理转录文件的开发者，可搜索历史对话，并压缩大型工具输出、思考块和嵌入图片。
- 在多个项目间切换的工程师，可按当前目录列出会话，并恢复指定会话或最近一次会话。
- 需要控制配额的用户，可查看 Claude Code、Codex、Grok、Kimi Code 和 Cursor 已支持的速率限制或计费周期。
- 维护内部仪表板、Slack 通知或 CI 接口的团队，可通过 HTTP API 和签名 Webhook 接收状态数据。
这个 Agent 有哪些优点和局限？
- 一个本地工具统一支持九种编程代理，同时提供 TUI、桌面应用和 HTTP API。
- 采用观察式设计，不要求用户把会话迁入专有启动器，也不需要服务器或账户。
- 除状态监控外，还提供会话恢复、增量全文搜索、清理、压缩和用量查看等具体维护功能。
- macOS/Linux 桌面包内含 CLI，纯命令行用户也有独立构建，可按部署场景选择。
- HTTP API 使用 Bearer Token，状态 Webhook 提供签名 JSON 载荷，便于接入自有面板或自动化。
- 桌面发行说明只覆盖 macOS 和 Linux；所给资料没有提供 Windows 安装或兼容性证据。
- 各项功能的代理覆盖范围不完全一致，例如转录搜索和压缩只支持列出的部分代理。
- Arch 软件仓库的软件包未签名，使用它需要接受
Optional TrustAll所代表的供应链取舍，或改用校验过的发行资产。 - HTTP API 需要管理 Bearer 口令；Webhook 和远程客户端还会增加网络配置及密钥管理工作。
- 完整源码构建需要 Node.js 和平台库，而
go install只生成 TUI 版本，不包含桌面 GUI。
如何安装或部署这个 Agent？
macOS 桌面版可运行 brew install --cask illegalstudio/tap/lazyagent，它会安装 Lazyagent.app 并链接同名命令。macOS 或 Linux 的纯命令行版可运行 brew install illegalstudio/tap/lazyagent-cli。Arch Linux 可配置文档给出的 Illegal Studio pacman 仓库后运行 sudo pacman -Syu lazyagent；该仓库的软件包未签名，配置使用 SigLevel = Optional TrustAll。Linux 桌面版也可从 GitHub Releases 下载 amd64 或 arm64 的 DEB、RPM、Arch 包或 AppImage。仅构建 TUI 时，可在已安装 Go 的环境中运行 go install github.com/illegalstudio/lazyagent@latest。源码构建可执行 git clone https://github.com/illegalstudio/lazyagent、进入目录后运行 make tui；完整桌面构建需要 Node.js 和平台库，并使用 make install、make build。
如何使用这个 Agent？
首次可直接运行 lazyagent，打开监控所有受支持代理的终端界面；用 lazyagent --agent claude、lazyagent --agent grok 或 lazyagent --agent kimi 限定代理。运行 lazyagent --gui 打开桌面应用，运行 lazyagent --api 启动受 Bearer Token 保护的 HTTP API；可先用 lazyagent passphrase 设置或轮换 API 口令。lazyagent --tui --gui --api 可同时启动三种界面。常用维护命令包括 lazyagent sessions、lazyagent latest、lazyagent search "query"、lazyagent compact、lazyagent prune --days N 和 lazyagent limits；脚本可用 lazyagent sessions --json 或 lazyagent limits --json 获取 JSON。
常见问题
使用 lazyagent 是否需要云账户或独立服务器？
它会替代或启动我的编程代理吗？
删除或压缩会话是否有保护措施？
prune 提供交互式代理选择、dry-run 预览和确认时的逐项目选择；资料还说明重写默认经过验证并创建备份。执行删除前仍应检查预览结果。HTTP API 如何认证？
lazyagent passphrase 设置或轮换口令，再以 lazyagent --api 启动服务。