TiaCC.Cli 1.0.1

TiaCC - 测试影响分析系统

<div align="center">

只运行受影响的测试，让 CI 快如闪电

将 30 分钟的全量测试缩短到 5 分钟

快速开始 | 工作原理 | Dashboard | 文档

English Version

</div>

你是否遇到过这些问题？

TiaCC 如何解决？

<div align="center">

┌─────────────────────────────────────────────────────────────────────────┐
│                                                                         │
│     传统方式                           TiaCC 方式                        │
│     ─────────                          ──────────                        │
│                                                                         │
│     改了 calculator.cpp                改了 calculator.cpp              │
│            ↓                                  ↓                         │
│     运行 1000+ 个测试                   智能分析：该文件被哪些测试覆盖？    │
│            ↓                                  ↓                         │
│     等待 30 分钟                        只推荐 2 个相关测试               │
│            ↓                                  ↓                         │
│     ...                                 3 分钟搞定！                     │
│                                                                         │
└─────────────────────────────────────────────────────────────────────────┘

</div>

核心原理

TiaCC 通过代码覆盖率分析建立源文件与测试的映射关系：

1. Nightly 构建时：运行全量测试，记录每个测试覆盖了哪些源文件
                   ↓
2. 生成映射数据库：calculator.cpp ← test_calc_basic, test_calc_advanced
                   statistics.cpp  ← test_statistics
                   ↓
3. PR 提交时：检测你改了哪些文件
                   ↓
4. 智能推荐：只运行受影响的测试！

交互式 Dashboard

TiaCC 提供美观的 Web Dashboard，让你可视化理解代码与测试的关系：

• 依赖关系图：展示源文件与测试的关联
• 文件树/覆盖率聚合：按目录聚合覆盖率，快速定位热点
• 搜索与函数级定位：定位关键依赖与覆盖率薄弱区域
• 详细说明见 docs/dashboard.md

快速开始

30 秒体验 Dashboard

# 1. 克隆仓库
git clone https://github.com/lusipad/TiaCC.git
cd TiaCC

# 2. 启动 Dashboard（Blazor）
dotnet run --project src/dashboard/dotnet/TiaCC.Dashboard/TiaCC.Dashboard.csproj -c Release

在你的项目中使用

第一步：安装 TiaCC CLI

# 确保已安装 .NET 10 SDK（版本见 global.json）
dotnet --version

# 构建 TiaCC CLI
dotnet build src/TiaCC.DotNet.sln -c Release

第二步：Nightly 构建映射数据库

# 1. 运行测试并收集覆盖率
dotnet test --collect:"XPlat Code Coverage" --results-directory ./coverage

# 2. 初始化数据库
dotnet run --project src/cli/dotnet/TiaCC.Cli/TiaCC.Cli.csproj -- init --db impact_map.db

# 3. 映射覆盖率数据
dotnet run --project src/cli/dotnet/TiaCC.Cli/TiaCC.Cli.csproj -- map \
  --db impact_map.db \
  --coverage ./coverage/*/coverage.cobertura.xml \
  --test MyTestClass

第三步：PR 时获取推荐测试

# 查询受影响的测试
dotnet run --project src/cli/dotnet/TiaCC.Cli/TiaCC.Cli.csproj -- query \
  --db impact_map.db \
  --files src/MyService.cs

# 输出示例：
# Affected tests:
#   - MyServiceTests
#   - IntegrationTests

效果对比

典型使用场景

场景 1：日常开发

# 修改了 MathService.cs
git diff --name-only
# → src/MathService.cs

# 查询受影响的测试
dotnet run --project src/cli/dotnet/TiaCC.Cli/TiaCC.Cli.csproj -- query \
  --db impact_map.db \
  --files src/MathService.cs
# → MathServiceTests

# 只运行这个测试
dotnet test --filter "FullyQualifiedName~MathServiceTests"

场景 2：CI/CD 集成

# .github/workflows/pr.yml
- name: 获取受影响的测试
  run: |
    dotnet run --project src/cli/dotnet/TiaCC.Cli/TiaCC.Cli.csproj -- query \
      --db impact_map.db \
      --files $(git diff --name-only origin/main) \
      > affected_tests.txt

- name: 运行受影响的测试
  run: |
    FILTER=$(cat affected_tests.txt | tr '\n' '|' | sed 's/|$//')
    dotnet test --filter "FullyQualifiedName~$FILTER"

场景 3：Dashboard 分析

1. 可视化探索 - 理解代码与测试的依赖关系
2. 函数级定位 - 找出覆盖率低的函数
3. 影响分析 - 修改某文件会影响哪些测试

支持的技术栈

项目结构

TiaCC/
├── global.json          # .NET SDK 版本
├── scripts/             # 仓库脚本（含 dotnet 自测脚本）
├── src/
│   ├── cli/dotnet/      # .NET CLI (tia-mapper)
│   ├── core/cpp/        # C++ 核心/覆盖率采集
│   ├── core/dotnet/     # .NET 核心库
│   ├── dashboard/dotnet/# Blazor Dashboard
│   ├── collectors/      # 覆盖率采集器（如 coverlet）
│   └── clients/         # 多语言测试框架客户端
├── tests/e2e/           # 端到端验证测试
└── docs/                # 详细文档

更多文档

贡献

欢迎贡献！请阅读 CONTRIBUTING.md 了解如何参与。

许可证

MIT License - 详见 LICENSE

<div align="center">

如果 TiaCC 帮助了你，请给个 Star！

Made with by the TiaCC Team

</div>