CostHQ 核心评估
CostHQ 是一款专为 AI 代理工作流设计的会话成本追踪工具，通过 CLI 与 Web 仪表板组合，实现从任务启动到完成的全链路成本可视化。
核心用法
1. 会话生命周期管理：cs start 启动追踪，cs log-ai 记录每次 API 调用（支持 17+ 内置模型自动计价），cs end 结束并汇总
2. 多代理归因：通过 --agent 参数区分不同代理（如 "Code Review Bot"），支持多代理系统的成本拆分与 A/B 测试
3. 预算管控：内置警报系统，可设置日/总会话/单会话成本阈值，超支触发声光提醒
4. 可视化分析：cs dashboard 启动 Emerald Glassmorphism 风格仪表板，提供 KPI、成本趋势、文件热点、项目拆分等多维度视图
显著优点
- 零侵入集成：
--json模式使 CLI 即开即用，适合自动化流水线 - 智能恢复：
--close-stale与cs recover处理崩溃残留会话，避免状态冲突 - Git 原生感知：自动关联代码变更与提交记录，实现成本-产出映射
- 灵活的定价配置：支持覆盖或新增模型价格，适配私有部署与新兴模型
潜在局限
- 构建依赖：需 C/C++ 工具链编译嵌入式 SQLite，Windows/Alpine 环境配置较复杂
- Pro 功能锁定：v3.2.0 将高级功能移至子模块，开源版本功能边界需关注
- 本地存储限制：SQLite 单文件存储，大规模团队场景下扩展性受限
适合人群
- 需要精细化成本管控的 AI 开发团队
- 运行多代理系统的自动化平台
- 追求"每次任务成本透明"的独立开发者
常规风险
- 数据本地性：会话数据存储于
~/.CostHQ/，无内置备份机制 - 预算硬边界：当前实现以"警报"为主，非强制阻断，需配合工作流层面的二次校验
- 版本兼容性：JSON 响应含
schemaVersion字段，暗示未来可能 breaking change