Seshat-BI 是一个面向 Power BI 的只读式 BI 管道治理与就绪度系统。其核心目标是回答一个问题：零售数据源是否已准备好成为可信的 Power BI 资产？系统允许 AI 智能体构建 BI 管道，但绝不允许其自行批准任何阶段。每个阶段都必须有已提交的证据和具名人工批准，确保数据从源头到发布的每一步都可追溯、可验证。
用途
Seshat-BI 用于治理从原始数据到 Power BI 发布的整个 BI 管道。它通过七个阶段（Source -> Mapping -> Silver -> Gold -> Semantic Model -> Dashboard -> Publish）的严格门控，确保每个阶段在前一阶段通过后才能开始。系统不生成一键式仪表板，也不自动批准任何决策，而是强制要求人工审批和证据支持。
主要能力
- 证据门控的源剖析：对数据源进行剖析，记录行数、唯一性等证据，并生成源映射。
- Medallion 映射治理：管理 bronze、silver、gold 层的数据映射，确保映射决策经过人工批准。
- 指标契约：为每个 Power BI 度量值绑定契约，防止未定义或未经验证的指标进入仪表板。
- 静态与实时检查：
seshat check对 silver 和 gold 运行静态门控（SQL、TMDL/PBIR、DAX、配置、文档、键、日期覆盖、孤立关系、对账等）；seshat validate针对实时数据库验证 gold 层。 - DAX 治理与生成：通过静态规则、契约漂移检查、实时值代理和已验证的度量值生成来治理 DAX。
- 可移植证明界面：提供离线 HTML、审查 JSON、SARIF、GitHub Action、就绪护照和离线组合浏览器。
- 只读 MCP 治理器：通过
seshat mcp将治理状态暴露给本地 MCP 客户端，但拒绝执行和批准。 - Seshat Studio：本地分析师控制台，以浏览器视图展示工作区就绪度、每表旅程和智能体对话。
- 扩展包与适配器：提供治理扩展包，以及可选的 dbt 和 Dagster 适配器（仅建议，不产生就绪真相）。
- Power BI 工作流：支持源代码控制的 Power BI 工作流，提供确定性 PBIR 编写助手和只读评估路径。
使用方式
- 快速体验：运行
uvx --from seshat-bi seshat demo init可在 60 秒内启动离线演示，无需数据库、Power BI Desktop 或账户。演示会生成就绪证明到.seshat-output/demo/index.html。 - 持久安装：使用
pipx install seshat-bi，然后运行seshat demo init、seshat demo run、seshat demo report --format html。 - 智能体交互：通过 Claude Code、Codex 或本地 Studio 控制台工作。
seshat status显示每张表的状态，seshat next给出唯一允许的下一步操作，seshat check和seshat validate是必须通过的门控。 - 实时验证：需要将 DSN 存储在 gitignored 的
.env文件中，复制.env.example并填写值。 - 可选扩展：基础安装仅依赖 PyYAML，其他功能如数据库驱动、MCP、dbt、studio 等为可选扩展，可通过
pipx inject或pip install添加。
适用场景
- BI 开发者：希望 Power BI 模型可追溯到受治理的 gold 表。
- 分析工程师和数据工程师：运行 bronze -> silver -> gold 仓库，需要失败关闭的门控。
- 分析领导者：需要知道哪些数字可以安全地呈现给高管，以及谁批准了它们。
- 构建 AI 智能体的团队：需要智能体在真实业务数据面前保持真实。
限制
- 系统是只读的，不提供一键式仪表板生成、Fabric 部署平台、通用 ERP 连接器或自动批准引擎。
- Power BI 写入受门控，本地写入腿已发布，但远程腿仍被推迟且需所有者门控。在 Power BI Desktop 中构建最终批准页面仍需人工操作。
- 统计提供程序为只读，且最初仅支持 PostgreSQL。离线本地 CSV 证据无需数据库。
- 实时验证需要数据库驱动和 DSN 配置。
- 系统处于活跃测试阶段（beta），版本 3.0 为重大更新，升级可能导致之前绿色的仓库变红，这是有意为之。
- 基础安装仅依赖 PyYAML，其他功能需额外安装。
- 项目采用 Apache License 2.0 许可。
