AI 会话成本追踪工具，支持多 Agent 预算管控与实时仪表板，自动统计 Token、文件变更与 Git 提交。
说明：
## 核心功能
`codesession`（codesession-cli）是一款专为 AI 编程工作流设计的会话成本追踪与管控工具，支持 Claude Code、OpenClaw、Codex、Cursor、Windsurf、Cline 等主流 AI Agent。其核心能力包括：
– **全流程成本追踪**：从任务启动到结束，自动记录 AI API 调用（Token 消耗、模型成本）、文件变更、Git 提交及会话时长
– **预算强制管控**：支持每日/总会话/单会话三级成本阈值设定，超限触发浏览器通知与声音告警
– **一键式代理模式**：`cs run ` 封装会话启动、代理拦截、命令执行与成本汇总（v2.5.1），零配置开箱即用
– **可视化仪表板**：本地 Web 服务（默认 3737 端口）提供 KPI 概览、会话详情、模型成本分析、文件热点洞察与活动热力图
## 显著优点
1. **多 Agent 生态兼容**：内置 21+ 模型定价（含 Codex），支持 Anthropic、OpenAI、Google、Mistral、DeepSeek 等主流厂商
2. **结构化输出优先**：所有命令支持 `–json`，专为 AI Agent 自动化解析设计，包含 `schemaVersion` 与版本字段便于兼容性管理
3. **数据隐私可控**：Token 计数本地存储（SQLite，`~/.codesession/sessions.db`），代理模式仅拦截请求计量，不存储 Prompt 原文或 API Key
4. **灵活成本归因**：`–agent` 参数支持多 Agent 系统成本拆分，便于 A/B 测试与团队成本核算
5. **会话恢复机制**：`–resume` 与 `cs recover` 应对崩溃场景，避免会话孤儿状态
## 潜在局限
– **本地运行依赖**：需 Node.js 18+ 及 C/C++ 编译工具链（Windows 需 Visual Studio Build Tools），安装门槛高于纯 Python 工具
– **代理模式网络约束**：拦截服务绑定 `127.0.0.1`，仅限本机 Agent 使用，分布式多机场景需额外配置
– **手动集成成本**：非全自动插桩，开发者需在 Agent 代码中显式调用 `cs log-ai` 记录每次 API 调用（除非使用代理模式）
– **定价表维护**：新增模型需手动 `cs pricing set` 更新，官方定价表可能存在滞后
## 适用人群
– **AI 应用开发者**：需精确核算多步骤复杂任务的 Token 成本与 ROI
– **多 Agent 系统架构师**：需要按 Agent 维度拆分成本、监控预算消耗
– **AI 编程工具链集成者**：为 Claude Code、Codex CLI 等工具增加成本可视化能力
– **中小团队技术负责人**：建立团队级 AI 支出预算管控与审计机制
## 常规风险
– **预算误配风险**：成本告警为软限制，依赖用户或 Agent 主动检查 `cs status`，无硬性阻断 API 调用机制
– **数据丢失风险**：SQLite 为本地单文件存储，无内置备份机制，误删 `~/.codesession/` 将导致历史数据丢失
– **版本兼容风险**：JSON Schema 可能随版本演进，自动化系统需校验 `schemaVersion` 字段
– **代理模式安全风险**：虽仅监听本地回环，但若主机存在恶意进程，理论上可访问计量端点（不过无敏感数据暴露）
会员专属
