Trae++

Trae++ 是运行在 Local UI Extension Host 的 Trae 工作区洞察扩展。它在编辑器内展示企业版 Token 用量、Trae 官方个人周期 AI 贡献，当前 Git 仓库的本机今日 AI Commit 新增行统计，以及个人产研数字分身调用情况。

核心能力

• Token 用量：通过账号密码自动登录或手动 Session，直连 Trae 官方个人用量接口。
• 个人 AI 贡献：展示近 30 天代码提交 AI 贡献率、AI/总 Commit 新增行、Agent/CUE 使用与采纳，以及最近 7 个上游代码提交趋势数据点。
• 本机今日 AI Commit：读取本机 Trae CN daemon 日志与 git-ai status --json，分别展示当前仓库今日已提交和当前未提交新增行。
• 产研数字分身：使用独立 AiDO 账号查看调用总量、使用分身数和分布。
• 可配置展示：今日统计可放入 AI 贡献 Hover/概览、显示为独立状态栏，或同时显示；五个模块均可独立启停，状态栏显示可以单独控制。
• Agent 动态表单：让 TRAE Agent 通过 MCP 请求多个结构化输入，并在 IDE Webview 内完成填写。

docs/trae-ai-lines/ 是今日统计能力的原始参考实现，保留用于协议证据和回归对照，不进入正式运行路径或 VSIX。

产研数字分身

先运行 Trae++: 配置产研数字分身服务器，填写管理员提供的 HTTPS API 基础地址（包含服务路径，例如 https://aido.example.com/dt-mgmt）。也可在用户设置中配置 traePlusPlus.rdAgentUsage.serverUrl，默认留空；未配置时不连接产研服务器。

然后运行 Trae++: 登录产研数字分身，核对界面显示的服务器地址，再输入自己的 AiDO NT 账号与密码。凭据保存在 VS Code SecretStorage，令牌失效时自动重登；与 Trae 企业认证独立。首次直接登录也会先引导配置地址。更换服务器会清除旧登录状态和缓存，升级前保存的无地址绑定凭据需重新登录。地址只接受 HTTPS，不接受内嵌账号密码、查询参数或片段，也不接受工作区覆盖。

• 独立状态栏显示 分身·7天 N 次；悬浮查看账号、日期范围、调用总量、使用分身数和前 5 个分身。
• 点击状态栏或运行 Trae++: 打开产研数字分身详情，查看完整调用分布和占比。
• 默认近 7 天，可切换近 30 天、当月或自定义历史日期，跨度最多 3 个自然月（含首尾）；均按北京时间，选择在用户设置中保存。
• 默认每 10 分钟刷新；可手动刷新。退出命令会清除 AiDO 凭据和内存统计。
• 仅查询登录返回的个人邮箱。空记录显示 0；失败不会显示为 0，同一查询的旧结果会标注刷新失败和时间。

接口仅返回周期内有记录的启用分身，不提供全部分身清单、每日趋势或数据更新时间。使用分身数不是全部可用分身数量，刷新时间仅代表插件查询时间。

数据口径

个人周期数据与本机今日数据是两套独立口径：

• 个人周期 AI 贡献来自 Trae 官方 get_analysis_overview_v2，默认按配置时区查询最近 30 个自然日。
• 今日已提交数据来自本机 Trae CN daemon 的 git_ai_commit_file / git_ai_commit_attribution 事件，并通过 Git 对象查询限定到当前仓库。
• 当前未提交总新增行来自 git-ai 的 stats.git_diff_added_lines；AI 新增行只累计明确模型归因的 checkpoint。
• checkpoint 缺失时仍展示总新增行，但 AI 归因显示“不可用”，不会回退使用混有人工编辑的 stats.ai_additions。
• V1 只统计新增行，不统计删除行、修改行或净增行。

快速开始

1. 安装并启用 Trae++，运行 Trae++: 功能与设置。
2. 选择需要的模块，在同一菜单中启停、打开详情、管理账号或调整展示。
3. Token 和个人贡献共用企业认证；个人贡献需单独配置查询邮箱与时区。0.0.3 起已移除本机登录态导入。
4. 今日归因只需打开本地 Git 仓库；产研数字分身需配置服务器地址并使用独立 AiDO 账号；Agent 表单无需企业认证。
5. 默认保留独立指标；可切换为一个简洁入口。点击指标打开详情，刷新位于 Hover 和页内工具栏。

命令

共 23 个公开命令，均可从命令面板搜索；推荐从“Trae++: 功能与设置”按模块操作。

配置

共 20 个配置项，分为 6 组。

隐藏状态栏不会关闭采集；关闭模块会停止后续后台活动。今日设置为整合展示且 AI 状态栏不可见时，独立指标模式会自动提供今日入口；简洁模式从总入口打开详情。用户保存的原有展示配置不会被自动改写。

刷新间隔为 0 表示关闭定时刷新；启动、配置/账号/仓库等相关事件和手动操作仍可能刷新。AI 贡献还会在打开过期页面或窗口重新获得焦点时检查过期状态。维护者可参考仓库中的 docs/requirements/current-features.md。

命令与配置表由 node scripts/sync-feature-reference.mjs 从 package.json 生成；使用 --check 检查是否一致。

隐私与安全

• 不采集遥测，不上传源码、文件路径、仓库、Commit Hash、daemon payload、checkpoint 或本机统计。
• 企业账号、密码和 Session 只保存在 VS Code SecretStorage，不写入普通设置、日志、 仓库或打包产物；手动 Session 方式始终保留。
• 密码模式只访问 console.enterprise.trae.cn 的固定登录与个人用量接口；Session 失效时 最多自动登录并重放一次，不绕过 SSO、MFA、验证码或风控。
• 个人 AI 贡献只请求 Trae 官方企业控制台；扩展不包含外部聚合服务地址、appId 或 appSecret。
• 本机日志扫描限定在已知 Trae CN 目录，跳过符号链接，并设置深度、文件数和单行大小上限。
• Git 与 git-ai 使用固定参数、无 shell 子进程，并设置超时和输出上限。
• 不可信工作区、远程工作区和不支持平台不会执行本机仓库子进程。
• Agent 表单 Broker 只监听 127.0.0.1，使用随机令牌鉴权，且不记录表单填写内容。

兼容性

• VS Code 1.88+ 兼容编辑器。
• 扩展固定运行于 Local UI Extension Host。
• 本机今日统计 V1 面向本地 Trae CN：macOS 已完成当前开发机自动化与只读实机诊断；Windows 已实现路径和运行时兼容代码，但发布前仍需真机对账。
• Linux、Trae 国际版、Remote SSH、Dev Container 和虚拟工作区不提供本机今日统计。

项目结构与设计

• 详细设计：docs/requirements/daily-ai-commit-integration-design.md
• 接口与本机数据源：docs/api-reference.md
• 项目结构：docs/project-structure.md
• 个人用量与认证 ADR：docs/decisions/0001-personal-usage-source-and-authentication.md
• 账号密码自动获取 Session ADR：docs/decisions/0002-password-session-acquisition.md

许可证

MIT