内容
# <img src="branding/icon.svg" width="32" height="32" alt="trRUSTt logo"> trRUSTt [V1 — 开发中]
> **"相信你的数据。一个二进制文件。无限的数据面板。"**
**AI驱动的Power BI外部工具。** 美丽的图形界面。单个30MB二进制文件。零依赖。直接放入外部工具文件夹中。速度提升10倍。
---
## 🎯 问题所在
大多数商业智能工作是**机械配置，而不是洞察**。拖拽可视化组件，格式化坐标轴，编写样板DAX代码，重新创建相同的KPI卡片——这会浪费2-4小时的dashboard创建时间，分析工作甚至还没开始。DAX很难写。一致性更难。分析师花费更多时间在配置上，而不是思考。
**trRUSTt处理重复性工作，让分析师专注于判断，而不是配置。**
---
## 💡 解决方案
| 之前使用trRUSTt | 使用trRUSTt |
|---|---|
| 每个dashboard 2-4小时 | 3-5分钟 |
| 手动编写和调试DAX | AI生成、验证、自我纠正 |
| 不一致的格式化 | 配置驱动的主题，自动应用 |
| 需要商业智能专业知识 | 用纯英文描述需求 |
| 没有审计跟踪，没有RBAC | 完整的企业级功能：用户、组织、工作区、SSO |
| 单个工具，锁定 | MCP原生 - 连接到任何AI工具 |
**速度提升10倍。 AI驱动。 100%可配置。 企业级就绪。**
---
## 🌍 适用人群
**trRUSTt适用于所有使用Microsoft Power BI的人。** 任何行业。任何国家。任何角色。
| 对象 | 为什么使用trRUSTt |
|---|---|
| **商业智能分析师** | 秒级生成第一稿dashboard。花时间改进故事，而不是配置可视化组件。 |
| **商业智能顾问** | 为多个客户提供一致、专业的dashboard。速度提升10倍 = 更多项目。 |
| **数据团队负责人** | 标准化质量。配置驱动的DAX治理。AI提升初级分析师技能。 |
| **企业IT / 管理员** | 完整的RBAC、SSO、审计日志、权限控制。策略驱动的控制。 通过SCCM/Intune部署。 |
| **业务团队** | 描述您需要的dashboard。不需要DAX语法。不需要可视化配置。只需提出业务问题。 |
| **OEM / SaaS公司** | 白标trRUSTt。在您的产品中嵌入AI驱动的分析。重新品牌化并转售。 |
---
## 🚀 快速入门
```bash
# 1. 从GitHub Releases下载TRRUSTT.exe（约30 MB）
# 2. 复制到外部工具文件夹
copy TRRUSTT.exe "%APPDATA%\Microsoft\Power BI Desktop\External Tools\"
# 3. 注册（创建1个JSON文件）
# %APPDATA%\Microsoft\Power BI Desktop\External Tools\TRRUSTT.json
{
"name": "🔷 trRUSTt",
"path": "TRRUSTT.exe",
"arguments": "--port %port% --pbix \"%pbix%\""
}
# 4. 打开Power BI Desktop → 外部工具 → 🔷 trRUSTt
# 美丽的图形界面打开，预连接到您的PBI模型
```
---
## 🗺️ 路线图
### ✅ V1（开发中 - 2026）
| 类别 | 功能 |
|---|---|
| **PBI集成** | 外部工具，实时XMLA到PBI Desktop SSAS，完整的元数据编辑（度量值，列，表，关系，层次结构，计算组） |
| **图形界面** | Tauri + Svelte 5 + shadcn/ui，Dashboard向导，交互式可视化画布（拖拽），主题设计器，设置面板，架构资源管理器，DAX游乐场 |
| **DAX引擎** | 4个复杂度级别（初学者 → 专家），PEG解析器，7步验证，自我纠正，自然语言解释 |
| **AI** | 6个提供商（OpenAI，Azure，Anthropic，Gemini，DeepSeek，Ollama），RAG（LanceDB），视觉（图像到dashboard），提示链 |
| **数据** | 数据摄入（CSV，SQL，Parquet，JSON → Polars配置文件 → TMSL模型），架构配置文件 |
| **MCP** | Microsoft Power BI建模MCP服务器（本地）+ Power BI MCP服务器（远程）预配置，trRUSTt暴露为MCP服务器 |
| **企业** | RBAC（5个角色），组织 + 工作区，SQLite内部数据库（15张表），审计日志，AI成本跟踪，AI缓存 |
| **配置** | 100%可配置，7层解析（TRRUSTT环境变量 → CLI → 用户 → 项目 → 工作区 → 管理员 → 默认值），8个策略类别 |
| **许可证** | 纯Rust JWT（Ed25519），AES-256-GCM加密缓存，30天离线宽限期，定期电话回家 |
| **品牌** | trRUSTt（仅RUST显示为大写），TRRUSTT（全部大写用于代码/配置），白标就绪 |
| **平台** | Windows（Power BI Desktop仅支持Windows） |
### 🔷 第二阶段（2027）
| 类别 | 计划功能 |
|---|---|
| **跨平台** | macOS + Linux（CLI + MCP服务器 + Docker） |
| **离线模式** | .pbix文件操作通过Tabular Editor 2 CLI（无需运行PBI Desktop） |
| **PBI服务** | 直接发布到Power BI服务，Fabric集成，自动部署管道 |
| **协作** | 多用户工作区，共享提示/主题，通过git同步团队配置 |
| **市场** | 内置主题市场，DAX配方包，行业模板（金融，医疗保健，零售） |
| **高级AI** | 本地LLM推理（candle + CUDA），微调DAX模型，自动洞察生成 |
| **移动伴侣** | iOS/Android应用（查看dashboard，接收警报，批准更改） |
| **企业控制台** | 用于组织fleet管理的基于Web的管理仪表盘 |
---
## 🎯 核心功能（V1）
| # | 功能 |
|---|---|
| 🎨 | **美丽的图形界面** - Dashboard向导，拖拽可视化画布，主题设计器，DAX游乐场，设置面板，架构资源管理器，提示编辑器 |
| 🤖 | **AI驱动的DAX** - 4个复杂度级别（初学者/中级/高级/专家），7步验证，自我纠正，自然语言解释 |
| 📊 | **自动生成dashboard** - AI计划布局，选择可视化组件，绑定度量值，应用主题 - 所有内容实时推送到PBI Desktop |
| 🖼️ | **图像到dashboard** - 上传草图/信息图表 → AI提取布局 + 颜色 → 生成匹配的dashboard |
| 🔌 | **MCP服务器/客户端** - Microsoft MCP服务器预配置为默认值。 将trRUSTt工具暴露给任何AI助手。 连接外部MCP服务器。 |
| 🔧 | **100%可配置** - 没有硬编码。 7层配置解析。 8个策略类别（备份，保留，安全，AI使用，DAX，访问，通知，合规）。 管理员可强制执行。 |
| 📐 | **完整的元数据编辑** - 推送度量值，列，表，关系，层次结构，计算组，显示文件夹，格式字符串 |
| 📥 | **数据摄入** - CSV，SQL，Parquet，JSON → 通过Polars自动配置文件 → 推断关系 → 构建表格模型 → 生成dashboard |
| 🏷️ | **白标就绪** - 重新品牌化所有内容：名称，徽标，颜色，URL。 OEM合作伙伴可以作为自己的产品转售。 |
| 💰 | **6种商业化途径** - 免费层，Pro（$149/年），Team（$49/用户/月），企业级，OEM白标，API/PAYG |
---
## 🛠️ CLI用法
```bash
# 图形界面模式（双击TRRUSTT.exe - 主要模式）
TRRUSTT.exe
# 架构发现（CLI）
TRRUSTT.exe schema discover --port 54321
# 生成DAX（CLI）
TRRUSTT.exe dax generate --description "同比增长率" --complexity advanced --port 54321
# 创建dashboard（CLI）
TRRUSTT.exe dashboard create --intent "执行官KPI dashboard" --port 54321
# MCP服务器模式（适用于Claude Desktop，Cursor，Continue）
TRRUSTT.exe mcp serve
# TUI管理员（快速终端配置）
TRRUSTT.exe admin
```
---
## 🏗️ 架构
```
TRRUSTT（单个二进制文件 ~30 MB，无运行时依赖）
│
┌─────────────────────┼─────────────────────┐
│ │ │
🎨 Tauri Shell 🦀 Rust核心 🌐 AI引擎
（Svelte 5 + （XMLA，DAX， （async-openai，
shadcn/ui） 配置，许可证） RAG，视觉）
│
Power BI Desktop
SSAS实例（localhost:XXXXX）
```
11个Rust crates。 Tauri + Svelte + shadcn/ui图形界面。 SQLite（sqlx）+ LanceDB内部数据库。 6个AI提供商。 15个数据库表。 8个策略类别。 所有内容都在一个二进制文件中。
---
## 🏗️ 开发
### 先决条件
- **Rust 1.80+** - 通过 [rustup.rs](https://rustup.rs) 安装
- **Node.js 22+** + **pnpm** - 用于Tauri前端
- **Windows** - Power BI Desktop仅支持Windows（第二阶段支持跨平台CLI）
> 💡 该项目使用`rust-lld`（Rust内置链接器）- 无需MSVC构建工具。 请参见 `.cargo/config.toml`。
### 构建命令
```bash
git clone https://github.com/oshjain/trrustt.git && cd trrustt
# 前端依赖
cd crates/trrustt/frontend && pnpm install && cd ../../..
# 构建
cargo build
cargo build --release # 生产构建（~30 MB）
# 开发模式（前端热重载）
cargo tauri dev
# 测试和校验
cargo test --workspace
cargo clippy --workspace -- -D warnings
cargo fmt --all -- --check
cargo audit
```
---
## 📦 Crate结构
```
crates/
├── trrustt/ # 🔷 二进制文件 + Tauri shell + Svelte前端
├── xmla-client/ # 📡 XMLA/TMSL客户端（reqwest）
├── dax-engine/ # 📐 DAX解析器（pom），验证器，生成器
├── ai-engine/ # 🤖 LLM路由器，RAG（LanceDB），视觉
├── config-engine/ # ⚙️ 7层配置（figment），加密（ring）
├── dashboard-generator/ # 📊 布局AI，可视化TMSL，主题
├── mcp-hub/ # 🔌 MCP服务器（stdio）+ 客户端（Microsoft默认值）
├── data-store/ # 🗄️ SQLite（sqlx）+ LanceDB - 15张表，RBAC，审计
├── data-ingestion/ # 📥 CSV，SQL，Parquet，JSON → Polars → TMSL模型
├── license-manager/ # 🔑 纯Rust JWT（Ed25519），AES-256-GCM
└── shared/ # 📦 类型，错误（thiserror），遥测
```
---
## 📋 文档
| 文档 | 描述 |
|---|---|
| [📘 主产品计划](docs/00-MASTER-PLAN.md) | 完整的PRD - 25个章节，竞争分析 |
| [🏗️ 组件架构](docs/architecture/01-component-architecture.md) | 11个crate，依赖图，公共API |
| [📊 数据流架构](docs/architecture/02-data-flow.md) | XMLA流程，存储布局，SQLite架构 |
| [⚙️ 配置引擎](docs/technical/01-configuration-engine.md) | 7层配置，figment，加密，注册表 |
| [📐 DAX引擎](docs/technical/02-dax-engine.md) | PEG解析器，7步验证，自我纠正 |
| [🧪 测试和部署](docs/technical/03-testing-packaging-deployment.md) | CI/CD，跨编译，单二进制部署 |
| [🗄️ 内部数据库](docs/technical/04-internal-database.md) | 15张表，RBAC，组织，工作区，SSO桥 |
| [📋 策略和备份](docs/technical/05-policy-backup-seeding.md) | 8个策略类别，备份策略，种子 |
| [💰 商业化模式](docs/business/01-monetization-model.md) | 6种途径，定价层级，预测 |
| [🚀 上市计划](docs/business/02-go-to-market.md) | 定位，上市计划，合作伙伴 |
---
## 🔒 安全
- `#![forbid(unsafe_code)]` - 零不安全Rust
- `cargo-audit` + `cargo-deny` 在CI中
- AES-256-GCM用于敏感配置
- EV代码签名用于Windows二进制文件
## 📄 许可证
开源核心（MIT/Apache 2.0）。 Pro/Enterprise功能需付费。
---
> **V1 开发中 | trRUSTt（品牌）/ TRRUSTT（代码/配置）| 第二阶段：2027**
*"相信你的数据。一个二进制文件。无限的数据面板。"*
