Agent Analytics 是一款专为开发者设计的轻量级网站分析追踪工具，其核心理念是"极简追踪"——仅关注回答"项目是否活跃和成长"这一关键问题，而非收集海量冗余数据。
核心用法
该工具采用"嵌入代码 + CLI 管理"的双层架构。用户首先通过 npx @agent-analytics/cli 登录并创建项目，获取项目专属的 write token（公开可嵌入），随后将 tracker.js 脚本片段添加至网站 HTML 底部即可自动捕获页面浏览数据。对于关键转化事件（如 CTA 点击、注册、功能使用），开发者可通过简单的 onclick 处理器手动埋点，每个项目建议仅追踪 3-5 个核心事件。数据查询通过 CLI 命令（stats、events）或标准 REST API 完成，支持时段对比、转化率计算等基础分析。
显著优点
隐私保护是其最大亮点，系统明确不记录或保留 IP 地址等个人身份信息，符合现代隐私合规要求。架构设计体现开发者友好理念：write token 与 API key 分离，前者仅具写入权限且可嵌入前端，后者用于数据读取，实现最小权限原则。工具极轻量，无复杂仪表盘，AI Agent 可直接作为数据分析界面，通过简单的文本命令获取项目健康度概览。此外，支持自托管开源版本，给予用户完全的数据控制权。
潜在缺点与局限性
功能相对基础，缺乏 Mixpanel 等平台的复杂漏斗分析、留存计算或用户画像功能，不适合需要深度用户行为分析的企业场景。作为 T3 级个人开发者项目，长期维护稳定性和企业级 SLA 保障存在不确定性。数据需发送至外部服务端点（或自行部署），对于内网环境或有严格数据出境要求的场景可能受限。此外，依赖 npm 生态和第三方脚本加载，存在供应链安全风险。
适合的目标群体
特别适合独立开发者、创业团队及需要快速验证产品市场契合度的早期项目。对于拥有多个 side project 的开发者，能够通过统一的 CLI 界面监控各项目活跃度，快速识别值得投入资源的成长型项目。也适合对隐私敏感、不希望将用户数据交给 Google Analytics 等巨头的小众社区或隐私优先型产品。
使用风险
主要风险在于外部依赖：CLI 工具通过 npx 动态执行，若 npm 包被劫持可能导致恶意代码执行；tracker.js 从 CDN 加载，存在脚本篡改风险。建议生产环境锁定具体版本并验证子资源完整性。此外，免费版存在速率限制（10 req/min），高流量站点需升级或自建服务。数据存储于第三方云服务（除非自托管），敏感行业需评估数据主权风险。