Codesession

核心用法

codesession-cli 是一款专为 AI 辅助开发设计的会话成本追踪工具，通过 cs 命令行接口实现端到端的费用监控。

工作流：
1. 启动会话：cs start "任务描述" --json --close-stale 创建结构化追踪会话
2. 记录 AI 调用：cs log-ai -p anthropic -m claude-sonnet-4 --prompt-tokens 8000 --completion-tokens 2000 --agent "Agent名称" --json 自动计算或手动输入费用
3. 状态监控：cs status --json 实时查看累计成本、令牌数、耗时
4. 结束归档：cs end -n "完成备注" --json 自动扫描 Git 变更与提交记录
5. 数据可视化：cs dashboard 启动本地 Web 仪表盘（默认 3737 端口），提供 KPI、趋势预测、模型对比、文件热点等多维度分析

显著优点：

• 精细化成本归因：支持多 Agent 名称追踪（v1.9.1+），适配复杂多智能体工作流
• 开箱即用的定价体系：内置 17+ 主流模型（Anthropic/OpenAI/Google/DeepSeek 等）价格表，自动换算费用
• 零侵入式追踪：--json 模式下进程立即退出，无常驻后台，靠数据库状态保持会话活性
• Git 原生集成：自动关联代码变更与提交，实现成本-代码映射
• 预算硬约束：可配置预算上限，超支预警
• 多格式导出：JSON/CSV 格式支持历史数据审计

潜在局限：

• Node.js 依赖较重：需 18+ 版本，且依赖原生 C/C++ 编译工具链安装 SQLite 模块，Windows/macOS/Linux 均需额外配置
• 本地存储限制：SQLite 单文件存储于 ~/.codesession/，无云同步与团队协作功能
• 模型定价滞后：内置价格表需手动更新，新模型或调价时需用户自行 cs pricing set 维护
• 仪表盘单机访问：Web UI 仅本地运行，无远程查看或分享能力
• 会话恢复机制复杂：崩溃后需 --resume 或 cs recover，存在误操作导致会话分叉风险

适合人群：

• 独立开发者与小型团队，需量化 AI 辅助开发的实际成本
• 构建多 Agent 系统的工程师，需分角色追踪费用归因
• 按项目/客户结算费用的自由职业者，需生成可审计的成本报告
• 关注 AI 支出优化的技术管理者

常规风险：

• 数据丢失：本地 SQLite 文件无自动备份，磁盘故障即丢失历史
• 隐私泄露：会话数据包含完整文件路径与 Git 提交信息，多用户共享机器时存在信息暴露风险
• 预算误判：若模型不在定价表且未手动指定 -c 成本，费用统计可能遗漏或失真
• 版本兼容性：JSON 输出格式可能随 schemaVersion 演进，自动化脚本需做版本适配

核心功能

codesession 是一款专为 AI Agent 设计的会话成本追踪 CLI 工具，通过 cs 命令实现全链路开发可观测性。核心能力包括：

• 成本精算：自动计算 17+ 主流模型（Anthropic/OpenAI/Google 等）的 Token 成本，支持自定义定价表
• 会话追踪：记录文件变更、Git 提交、AI API 调用，生成带时间线的完整会话档案
• 预算管控：实时查询会话开销，支持预算阈值预警，防止意外高额账单
• 多智能体支持：v1.9.4 新增 --agent 标记，可区分追踪不同 Agent 的贡献与成本
• 可视化仪表盘：本地启动 Web 服务（默认 :3737），提供 KPI 概览、成本趋势、文件热点等分析

显著优点

• 零侵入集成：纯文档型 Skill，通过外部 CLI 调用，不修改现有工作流
• 结构化输出：所有命令支持 --json，便于 Agent 自动化解析
• 数据本地化：会话数据存于 ~/.codesession/sessions.db，无云端隐私风险
• Git 原生感知：自动扫描仓库变更，无需手动记录文件改动

潜在局限

• 外部依赖风险：运行时依赖 npm 全局安装的 codesession-cli，版本兼容性需用户自行维护
• 构建工具门槛：Node 18+ 及 C/C++ 构建工具（用于 SQLite 编译）增加初始化复杂度
• T3 来源可信度：维护者为个人开发者，虽代码开源透明，但长期维护承诺弱于企业级项目
• 无实时同步：本地存储模式无法跨设备共享会话数据

适合人群

• 频繁调用大模型 API 的开发者与 Agent 团队
• 需量化 AI 辅助开发 ROI 的技术管理者
• 运行多 Agent 协作系统（如 Code Review Bot + Test Writer）的复杂工作流

常规风险

• 供应链安全：npm 包更新需人工关注，建议定期执行 npm audit
• 权限管理：codesession-cli 需 Git 执行权限与文件系统访问，敏感仓库建议隔离环境
• 数据备份：本地数据库损坏会导致历史会话丢失，需定期备份 ~/.codesession/