Gajae-Code隐私与可观测性：遥测白名单模型与本地Stats仪表盘完全指南

Gajae-Code隐私与可观测性遥测白名单模型与本地Stats仪表盘完全指南【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-codeGajae-Code 的隐私与可观测性设计非常克制内置遥测采用白名单模型且默认关闭AI 用量数据则由本地stats 仪表盘统计展示。本文面向新手带你快速搞懂 Gajae-Code 到底收集什么、如何一键关闭遥测以及如何用本地 stats 仪表盘查看 Token、成本与工具调用趋势。一、遥测白名单模型默认关闭只发固定事件Gajae-Code 内置了一条最小化的更新与采用情况遥测通道核心原则是默认关闭不显式开启任何数据都不会发送固定事件白名单目前仅允许 5 种事件名update_check_started、update_check_completed、update_install_started、update_install_completed、update_install_failed未知字段直接丢弃白名单外的取值在传输前即被拒绝。每个事件只能包含schema 版本号、固定的事件名、本地随机生成的 UUIDv4 安装 ID、ISO 时间戳、更新通道stable/nightly、固定结果值available / up_to_date / installed / failed / skipped以及固定更新方式bun / npm / binary / migrate。永远不会被收集的内容官方在 docs/telemetry.md 中明确列出了永不采集清单提示词、命令行参数、路径、环境变量、密钥、账号身份、模型或服务商身份、仓库身份、错误文本、主机名、用户名、机器 ID、IP 派生身份。安装 ID 是纯随机生成与设备、网络、账号、仓库数据无关并以私有文件权限保存在本地用户目录的telemetry-install-id文件中。白名单校验的实现可以直接在源码中阅读序列化函数会在任何含禁用键如 prompt、path、secret、hostname 等的数据出现时直接失败events.ts。二、一键开关如何控制遥测含紧急杀开关遥测通过常规配置项控制默认为falsegjc config set telemetry.enabled true # 开启可选 gjc config set telemetry.enabled false # 关闭默认 gjc config get telemetry.enabled # 查看当前状态此外还有一个进程级紧急杀开关优先级高于一切配置在事件被调度之前即被评估GJC_DISABLE_TELEMETRY1 gjc update该开关接受1、true、yes、on四种取值。传输行为不阻塞、不留存事件通过 HTTPS POST 发送采用尽力而为策略调用不阻塞更新命令、最多 2 个请求在途、单请求 1500ms 超时。离线、超时、队列饱和等失败不影响 GJC 的正常行为也不保留任何本地事件队列或日志。三、本地 Stats 仪表盘AI 用量可观测性与上报到云端的遥测相反Gajae-Code 的可观测性能力全部留在本地——由gajae-code/stats包提供解析~/.gjc/agent/sessions/下的 JSONL 会话日志用 SQLite~/.gjc/stats.db增量聚合再渲染成 Web 仪表盘。核心指标一览指标计算方式Tokens/soutput_tokens / (duration / 1000)缓存命中率cache_read / (input cache_read) * 100错误率count(stopReasonerror) / total_calls * 100总成本usage.cost.total求和平均延迟 / TTFTduration/ttft均值快速启动本地统计仪表盘gjc stats # 启动仪表盘默认 http://localhost:3847 gjc stats --port 8080 # 自定义端口 gjc stats --summary # 控制台打印摘要按角色拆分用量 gjc stats --json # 输出 JSON方便脚本处理仪表盘提供总体指标卡片请求数、成本、缓存命中率、错误率、Tokens/s 等、时间序列图、按模型/按文件夹/按智能体executor、planner、architect、critic 等的拆分表格并每 30 秒自动刷新。服务端 API 也全部本地可用/api/stats、/api/stats/costs等支持?range1h|24h|7d|30d|90d|all详见 packages/stats/README.md 与 server.ts。 隐私要点仪表盘只绑定 127.0.0.1不支持跨域请求也不信任转发的主机头——它天生就是一个纯本地工具。四、深入分析会话语料的 SQLite 分析流如果你想在仪表盘之上做更细的挖掘仓库内置了session-stats分析工具链先把会话语料增量同步进同一个~/.gjc/stats.db带ss_前缀的表再用短小的 Python 脚本做按工具/按天/按会话的查询重跑只需亚秒级。常用命令如bun run stats:tools按工具统计 Token 总量、stats:edits编辑工具可靠性审计等完整说明见 scripts/session-stats/README.md。下图展示的是分析流产出的Top 10 工具 Token 用量趋势六宫格图日 Token 量、日调用数、每次调用均值、累计 Token、周中位数与单次调用直方图可以直观看出read、search、task等工具在整体用量中的占比与演化。五、新手常见问题 FAQQ1默认情况下 Gajae-Code 会上传我的代码或提示词吗不会。遥测默认关闭即使开启白名单机制也保证只发送 5 种更新事件及固定字段提示词、路径、密钥等永远不序列化。Q2本地统计数据库会被上传吗不会。~/.gjc/stats.db与仪表盘服务器都只在本机运行和访问仅绑定回环地址。Q3仪表盘没数据怎么办检查~/.gjc/agent/sessions/下是否存在会话日志端口冲突时可用--port换端口启动。更多排障内容见 packages/stats/README.md。总结隐私优先 本地可观测的完整方案Gajae-Code 用两套机制回答了AI 编程助手如何既透明又安全这个问题遥测白名单模型——默认关闭、固定事件、禁用键失败即拒配合GJC_DISABLE_TELEMETRY紧急杀开关把控制权完全交给用户本地 stats 仪表盘——会话日志、SQLite 聚合、仅回环访问的 Web 面板让 Token、成本、缓存命中率与工具调用趋势全部在你本机可见。想进一步阅读原始设计文档可以从 docs/telemetry.md 与 packages/stats/README.md 入手白名单序列化逻辑见 events.ts仪表盘 API 见 server.ts。【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考