面向业务与 FDE 的入门地图 · 对应厂商 V5(2026-08-30)

ZY Action Platform 全景导览

这是一套对标 Palantir 产品矩阵的国产自研平台:五款产品、一套共享底座、全部用 Go 写成单机可跑的二进制。 它要解决的不是「再做一个 BI」,而是把数据的口径、AI 的行为、部署的动作三件事, 收进同一套可审计、可回滚、可声明的规则里。

本页把 85 个后端模块、104 个功能页面压缩成一张地图:先看整体架构,再看五个产品各管什么、 它们如何串成一条闭环,最后是两条流程图(怎么建、怎么用)、角色分工,以及诚实的能力边界。 不需要任何技术背景就能读完。

产品
5 款 · 全部已交付
后端模块
85 个
前端页面
104 个
共享底座包
22 个
技术栈
Go 1.25 单机优先
01

它到底是什么

一句话:把企业里散落的数据变成有统一口径的业务对象,让人和 AI 都只能通过同一道受管控的门去读它、改它。

大多数数据平台停在「把数据查出来」。ZY Action Platform 多走了三步,而这三步恰恰是业务上最痛的地方:

「Action」这个名字就来自第二条——平台的核心资产不是报表,是动作(Action):一个被定义好参数、校验规则、权限和回写方式的写操作。 这也是它敢让 AI 碰生产数据的原因。

四条红线:所有设计决定的判据

厂商文档里反复出现的 R1–R4,是这套系统一切取舍的依据。理解了这四条,后面所有的机制都会显得理所当然。

R1
语义层是一等资产

口径、术语、表列语义捆在一起,本体和检索双向打通,绝不把裸表直接丢给大模型去猜。AI 查得准,靠的是这层语义,不是模型更强。

R2
治理内建在写路径上

一切写操作必须走 Action 定义。Agent 和人受完全相同的约束——不是给 AI 单独加一层护栏,而是根本没有第二条路可走。

R3
单机优先 = 机制浓缩版

不引消息队列、不引服务注册、不引外部图库。把分布式系统的机制(拉取式、声明式、离线包)做进单机内核,而不是先做个玩具版将来重写。

R4
共享同一套声明模型

本体、Agent 配置、评测集、网关路由、部署期望状态,用同一套 Schema 表达、同一个包分发。跨产品复用的是模型本身,不是接口调用。

读这份文档时请记住

本页所有能力描述都来自厂商 V5 文档(docs-ZY-V5/,2026-08-30)。凡是文档自己标注为「未实现 / 规划中 / 仿真」的,本页一律照实标注,不做善意补完。第 11 节专门讲边界。

02

V5 这一版补了什么

厂商在 2026-08-29/30 用 S0–S6 七个阶段做了一次整体升级。如果你看过上一版,这一节告诉你差别在哪。

上一版的形状是「四个产品跑通了主干」。V5 补的基本都是把主干变成日常可用的那些东西—— 长任务能看进度了、数据能进平台落成资产了、分析过程能沉淀成 Notebook 和报表了、 数据一变就能自动触发动作了,以及一整套让外部系统接得进来的标准接口。

S0平台底座

补上了三块地基:统一调度器(各产品不再各建一套 cron)、异步任务系统(导入元数据、跑管道这种慢操作不再让页面干等,五种状态 + 进度条)、资源 URI(14 类资源有了统一地址格式,跨产品互相引用的前提)。

schedulertaskresource长任务全部任务化
S1数据域

数据终于能「进平台」而不只是「连过去查」:数据集成为一等资产(可版本发布、可预览、可画像),全量/增量同步把外部数据按计划抽进来,质量画像用四个因子给数据打分,SQL 工作台让你直接用对象名写 SQL。

数据集 + 版本同步引擎质量画像对象化 SQLFoundry 数据源自管理
S2知识域

AI 侧从「查数」扩到「知识」:文档里能抽实体和关系并接进检索(RAG 从四路召回变五路),决策证据链让每个 AI 答案都能逐条追到出处,CDC 能感知源表变化,PDF/Word 解析成「文档—章节—片段」三层树。

实体抽取决策证据链CDC语义标注分层知识树
S3协作闭环

分析过程变成可交接的资产:Notebook(文字/SQL/图表三类单元格混排)、块式报表(定时生成快照 + 邮件分发)、Fusion 实体消解(把重复的客户记录合成一条)、流事件规则(数据一变就触发通知/同步/回写)。安全侧补了 TOTP 双因子和审计归档。

Notebook块式报表Fusion流规则NLQ 注入 RLS/CLSTOTP 双因子
S4图谱域

Gotham 补上从关系库到图谱的那一跳:行级图谱化导入(分页拉行 + 自动识别外键建边)、图分区压缩(多层 Louvain 把大图折叠成社区图)、时序图分析(按时间窗口看子图和趋势)。

图谱映射外键自动建议图分区时序子图 / 趋势 / 路径
S5语义互操作

让外部系统接得进来:13 类标准值类型把属性类型收敛并自动归一化,本体函数可在计算属性和条件里调用,MCP 把 Foundry 能力暴露成 LLM 工具(默认关闭),安全标记做第二道列级闸门,本体可导出成 OWL/SHACL 标准格式。

ValueType 13 类本体函数MCP(默认关闭)安全标记OWL / SHACL 导出
S6生态工程

工程化收口:组件市场(本环境建好的资产打包到另一个环境一键装上)、代码仓库(SQL 宏一处维护多处复用)、统一搜索(顶栏一个框搜遍五类资产)、Prometheus 指标单二进制/Dockeractionctl 命令行

组件市场代码仓库Nexus 统一搜索/metricsembed 单二进制actionctl CLI

对业务方最有感的三处变化

变化V5 之前V5 之后
长操作不再卡住页面 导入元数据、跑管道要在页面上干等几十秒甚至几分钟,超时了也不知道成没成 提交后立刻返回任务号,页面显示进度条;服务重启还能自动接着跑
AI 答案能追到出处 NLQ 返回一个数字和一段 SQL,「为什么是这个数」靠人自己核 决策证据链把答案拆成五步,每句话带 [n] 引用;/ai-audit 可回放全过程
数据变了会主动找人 只有人主动打开报表才知道数变了 CDC 监测到变化 → 流规则判断条件 → 自动发通知、跑同步、触发质检,或直接回写
状态更正

V4 时期文档里 P5 LightSwift 标的是「设计愿景 · 尚未实现」。V5 已改为「已交付(仿真 PoC)」——冒烟 16/16、前端 E2E 33/33 通过,端口 18084 可登录演示。

但厂商 docs-ZY-V5story/swift/index.html 这一页停留在 8 月 9 日仍写着「代码尚未开工」,是没跟上的旧页。同理 site/verification.htmlsite/apollo.htmlsite/contracts.html 三页也是 8 月 9 日版本,其中「Gotham 未入网关」的说法已被 8 月 30 日的技术栈页和四份手册推翻(网关现已代理全部五个产品)。看到这几页时以日期新的为准。

03

整体业务架构

四层。看懂这张图,就明白为什么五个产品既能各自独立启动,又能共用同一套权限、审计和数据源。

① 入口 与网关 ② 产品层 ③ 共享 底座 ④ 持久化 与可观测 浏览器 · Vue3 前端 web/ —— 五产品共 104 个功能页面 Go 网关 gateway :80 —— SPA 服务 + 五路反向代理 P1 LightAIP :18080 · /aip-api 自然语言查数 知识 · 决策证据链 P2 LightFoundry :18081 · /api 本体 · 指标 · 数据集 唯一写路径 P3 LightApollo :18082 · /apollo-api 声明式交付 拉取式部署 P4 LightGotham :18083 · /gotham-api 图谱情报分析 时空多视图 P5 LightSwift :18084 · /swift-api 星基跨境结算 仿真域 PoC 共享底座 platform/ —— 同一个 Go monorepo,五产品直接 import,不走网络调用 治理核心 auth · rbac · security(RLS/CLS) audit 泛化事件 · crypto 国密 AI 核心 llm 网关降级链 · vector 三后端 批量 / 过滤 / 删除 / 计数 数据核心 connector 白名单 + 写执行 datasource · metadata 调度核心V5 scheduler 统一调度 · task 五态 resource 资源 URI(14 类) 事件与通知V5 cdc 变更捕获 · notify 通知中心 monitoring · /metrics 运维核心 config · database · logger · settings license 授权自检 · mailer 邮件 基础类型 ierr 统一错误 · model 数据模型 · domain 领域对象 · repository 仓储层 主库 PostgreSQL 17 chatbi_action_dev 不可用则自动降级 SQLite 向量 milvus → turbovec → disk 三后端健康检查自动降级 图存储 自研磁盘 JSON 内存邻接表 + 快照落盘 可观测 /metrics + 滚动日志 Prometheus 文本格式
四层架构。关键在第 ② 层到第 ③ 层那五根箭头:五个产品不是通过网络互相调用,而是同一个代码仓库里共享同一套底座包。这解释了为什么它们能共用审计表、共用数据源注册表、共用同一套权限模型,却又能各自独立启动、独立部署、独立签发登录凭证。两个标了 V5 的底座包是这一版新加的地基。

为什么「共享底座」这件事对业务重要

如果五个产品是五套独立系统,那你会遇到的典型麻烦是:审计日志分散在五个地方,安全策略要配五遍, 同一个数据源要注册五次,而且升级时它们的版本会各走各的。 共享底座把这些收成一份——一条审计规则改一次,五个产品同时生效

代价也很直接:五个产品必须一起编译、一起发版,不能单独给某一个产品打补丁。 厂商选这条路的理由写在 R3 红线里——单机优先,先把机制做对,不为了「将来能拆」而提前付分布式的复杂度。

04

五个产品各管什么

对标 Palantir 的产品矩阵。刻意不做「一个超级系统包打天下」——每个环节用最擅长的那一款。

P2 · Foundry:18081

LightFoundry

平台的灵魂。把物理表建成业务对象(客户、订单、商品),定义指标口径,管数据集与同步,并且垄断所有写操作的入口。

谁在用:数据工程师、FDE、本体工程师

P1 · AIP:18080

LightAIP

一句话查数。自然语言 → SQL → 图表,五路召回 + 行列级安全注入 + 会话记忆;V5 起还能做带引用的决策证据链和文档实体抽取。

谁在用:业务分析师、不会写 SQL 的所有人

P4 · Gotham:18083

LightGotham

追人与关系。多源数据融合成图谱,实体解析把「同一个人的多条记录」归并,再用图算法、时空视图、模式识别找出隐藏关联。

谁在用:情报 / 风控 / 合规分析师

P3 · Apollo:18082

LightApollo

安全地送到现场。声明「这个环境应该长什么样」,目标机上的 Agent 主动来拉、自己验签、自己应用。控制台永不反向连入客户网络。

谁在用:运维工程师、FDE、安全合规

P5 · Swift:18084

LightSwift

星基跨境结算(仿真域 PoC)。ISO 20022 报文引擎 + 国密全链路 + 复式记账 + 对账,在单机进程里跑通十步端到端。星座、链路、账户余额、清算通道均为模拟。

谁在用:方案评审、演示场景

选型时最容易问错的问题

「哪一款是主产品?」——没有。这套矩阵的设计前提就是各取所长:建模找 Foundry、查数找 AIP、追关系找 Gotham、交付找 Apollo。如果你只想解决其中一件事,装一个也能跑。

五个产品的登录与端口

产品端口网关前缀认证前端页面
LightAIP18080/aip-apiaip_token35
LightFoundry18081/apiaip_token30
LightApollo18082/apollo-apiapollo_token(独立用户库)19
LightGotham18083/gotham-apiaip_token + WebSocket 刷新令牌16
LightSwift18084/swift-apiswift_token(内嵌登录)4
Web 网关80不鉴权,只转发

注意最后一列之外的那件事:Apollo 和 Swift 有各自独立的用户库,AIP / Foundry / Gotham 共用一套。 也就是说,今天还做不到「一次登录走遍全平台」——这是第 11 节里列的明确边界之一。

05

它们怎么串成一条闭环

数据 → 智能 → 决策 → 交付 → 创新。五个产品之间靠六份冻结的接口契约衔接,不是靠约定俗成。

本体 api_name 直接作为图节点 / 边的类型 数据 P2 LightFoundry 把表变成对象与口径 整个平台的语义地基 智能 P1 LightAIP 一句话查数 · 决策证据链 五路召回 + 行列级安全注入 决策 P4 LightGotham 图谱追关系 · 时空研判 把数字变成可引用的证据 ① 语义供给 ② Action 写回 ③ 研判升级 ④ 制品化:本体 YAML / 网关路由 / 评测集 → bundle 交付 P3 LightApollo 声明期望状态 · Spoke 主动拉取 控制面永不反向连入客户环境 创新 P5 LightSwift 星基跨境结算(仿真域 PoC) 复用拉取机制 + 对象 / 动作模型 ⑤ 拉取机制复用
价值闭环。整张图的重点是那条朱砂色的回头箭头 ②:AIP 不自己写数据库,它把写请求交回 Foundry 的 Action。这一条设计决定了「AI 能不能被信任去改生产数据」——答案是能,因为它走的是和人完全相同的七道关卡(见下一节)。

六份跨产品契约

这六份接口在第一个产品做完时就冻结了签名,后面的产品只能对齐、不能改。 业务上的意义是:换掉任何一个产品,其余四个不用改——因为它们之间约定的是数据形状,不是彼此的实现。

契约谁提供 → 谁消费解决什么
① 语义检索Foundry → AIP / Swift按文本找到指标、对象、属性,返回结构化结果而不是文本块。AI 检索的是「订单收入 = SUM(paid_amount)」这条定义,不是一段描述它的话。
② Action 执行Foundry → AIP / Swift唯一的写入口。四种模式:只校验、直接执行、异步执行、先校验再执行。HTTP 200 不等于成功——要看响应体里的校验结论。
③ LLM 网关AIP → Swift / Apollo所有大模型调用的统一入口,带降级链和熔断。熔断时返回降级结果并明确标注 degraded=true,不假装正常。
④ bundle 制品Apollo → 全部分发包的格式:文件清单 + 国密哈希 + 整体签名 + 签名者身份。目标机验签的顺序是逐文件校验 → 整体验签 → 签名者是否在白名单 → 版本是否单调递增。
⑤ 评测集AIP → SwiftNLQ 的回归测试用例随发布包一起分发,换个环境也能验证「AI 还答得对不对」。
⑥ 对象 / 动作模型共享代码包对象、属性、链接、动作的结构体定义本身就是契约。Gotham 的图节点类型、Swift 的结算对象都直接复用它。
最容易被误读的一句话

厂商文档里写着「跨产品语义层未打通」,很多人读成「架构上连不起来」。实际含义是:五套演示数据是各自独立的库(AIP 里的张三和 Foundry 里的张三不是同一条记录)。要让它们连通,把同一个数据源注册进两边即可——契约①和②本来就是为此设计的。这是演示数据的边界,不是架构的边界

06

本体与写路径:整套系统的地基

如果只读这份文档的一节,读这一节。前面所有产品的价值都建立在这两件事上。

本体:把表变成业务对象

本体(Ontology)是 Foundry 的核心资产,由四个要素组成。它不是「给表起个中文别名」, 而是把散在数据库里的技术结构,翻译成业务方直接说得出口的语言,并且把口径、约束、权限、动作都钉在上面。

要素是什么业务上意味着
对象 Object一张主表(最多再挂 3 张补充表)+ 一个稳定的英文名 api_name「订单」从此是一个大家都认的东西,而不是 db2.dbo.ord_hdr_v2
属性 Property映射某一列或计算得出;带约束、同义词、PII 标记、列级安全给「区域」加上同义词「大区/片区」,业务怎么说都能查到;给「姓名」打 PII,脱敏自动生效
链接 Link对象之间的关系,带方向和基数(一对一 / 一对多 / 多对多)查订单时自动带出客户,不用每次手写 JOIN,也不会有人写错关联键
动作 Action一个被定义好参数、校验规则、权限和回写方式的写操作「把订单标记为已发货」成为一个受控动作,而不是谁都能跑的一条 UPDATE

改本体也要走评审

本体一旦被报表、指标、AI 检索依赖,随便改就会连累一片。所以它有一套完整的版本状态机: 草稿 → 评审 → 合入,可批准、可驳回、可回滚到任意历史版本。

写路径:为什么敢让 AI 改生产数据

这是 R2 红线的落地。所有数据回写——人在页面上点的、AI Agent 自动执行的、外部系统通过 MCP 调的、 流规则自动触发的——全部穿过同一条流水线,没有旁路

提交成功 源系统回写(pre / post)+ 编辑态落盘 + 审计 写请求 人 或 AI Agent 同一条路径 同样的关卡 参数校验 Schema 定义 类型与必填 逐动作授权 RBAC 判定 能不能执行 写权限三分 记录级 · 属性级 非 SQL 改写 校验规则 ValidationRules V5 新增 强制审计 含修改前状态 prior_state 幂等 + 事务 重复提交时 返回首次结果 乐观并发 updated_at 毫秒精度比对 任一关卡不通过 → 立刻拒绝,一个字节都不写库 ACTION_VALIDATION_FAILED · ACTION_NOT_AUTHORIZED · ACTION_IDEMPOTENT_REPLAY · 409 ACTION_CONFLICT(附最新状态供重试)
写路径七道关卡。左边的入口刻意画成一个——人和 AI Agent 走的不是相似的两条路,是同一条路。厂商文档在两处枚举略有出入(技术站写六步、FDE 手册写六步但含 V5 新增的校验规则),此处取并集画成七步。第 ④ 关是 V5 才加的:允许你在动作定义里写业务前置条件(比如「已发货的订单不能改金额」),不满足就聚合返回全部原因并阻断。

两个容易忽略但很要命的细节

HTTP 200 不等于成功

调用 Action 返回 200,只代表请求被受理了。真正的成败要看响应体里 validation.result 是不是 VALID。做集成时如果只判状态码,会把失败当成功。

编辑态叠加:V4 的老账,V5 补上了

通过 Action 改过的值不直接覆盖源表,而是独立落在编辑态表里,查询时叠加上去。V4 时期只有明细查询叠加,聚合查询不叠加——同一个数字在明细页和汇总页对不上,厂商自己称之为「最大语义债」。

V5 已修复:明细与聚合都会叠加(聚合回退成明细+内存聚合,上限一万行,超限会标注为近似值)。残留:比率型 / 派生型 / 累计型指标仍未叠加,文档标为下一阶段处理。

07

模块全景

85 个后端模块,按能力域归类。这一节是查阅用的——先扫标题,需要时再看细节。

产品后端模块前端页面能力重心
P2 LightFoundry2930本体语义层 · 数据域 · 协作分析 · 治理 · 互操作生态
P1 LightAIP2135查数主链路 · 知识域 · 智能体 · LLM 基础设施
P4 LightGotham1716图谱核心 · 时空视图 · 研判产出 · 协作安全
P3 LightApollo1319交付核心 · 制品配置 · 环境运行 · 监控自愈
P5 LightSwift14仅收录部署运维;结算能力见故事站
共享底座 platform/422 个包中 4 个有独立开发文档(V5 新增的调度 / CDC / 通知 / 向量)
合计 85 个后端模块 · 104 个前端页面

P2 LightFoundry · 29 个模块

能力域包含模块一句话
本体与语义层ontology_modeling ontology_sql analytics_engine data_integration四要素建模、版本状态机、对象名直接写 SQL、语义翻译成物理 SQL
数据域V5dataset sync quality pipeline_builder data_lineage数据集版本化、全量/增量同步、四因子质量画像、SQL 步骤管道、四级血缘
协作分析V5notebook report fusion stream visualization_dashboard工作簿、定时报表、实体消解、变更驱动流规则、仪表盘
治理与安全access_control core_auth_apikey audit_compliance data_governance两层权限、JWT + API Key 双通道、审计五问、术语表与密级
互操作与生态V5mcp actionctl nexus marketplace coderepo把能力暴露给 LLM、命令行、统一搜索、组件市场、SQL 宏仓库
应用与运维application_builder collaboration mlops_platform monitoring deployment_ops api_sdk低代码应用、工作流、模型注册与推理、指标暴露、部署、OpenAPI 门户

P1 LightAIP · 21 个模块

能力域包含模块一句话
查数主链路nlq_engine rag_engine oag visualization_dsl ontology_integration意图 → 五路召回 → 安全注入 → 记忆 → 生成 SQL → 执行 → 推荐图表
知识域V5entity_extraction decision schema_annotation knowledge_base文档抽实体、五步决策证据链、字段关系自动推断、知识库分层树
智能体与自动化agent_framework tool_system workflow_automation automation_copilot多智能体编排、工具注册与鉴权、定时工作流、对话式配置自动化
LLM 基础设施llm_gateway prompt_engineering evaluation_monitoring多供应商路由降级熔断、Prompt 版本化、评测集与效果监控
接入与治理datasource_connector core_auth_rbac security_governance deployment_ops api_sdk数据源与元数据、认证 RBAC + 双因子、敏感列与护栏、部署、OpenAPI

P4 LightGotham · 17 个模块

能力域包含模块一句话
图谱核心knowledge_graph graph_analysis entity_resolution自研磁盘图存储、展开/最短路径/中心性/社群、四层实体解析流水线
数据接入multi_source_fusion search四类来源清洗映射入图(V5 支持按行图谱化 + 外键自动建边)、跨域全局搜索
时空与视图geospatial_analysis timeline_analysis multi_view_linkage地图要素与框选聚合、时间轴与时间轮盘、图/地图/时间轴三视图联动
研判与产出pattern_recognition intelligence_reporting五类规则检测 + 告警去重打分、结构化情报报告与三格式导出
协作与安全collaboration_workflow eventbus_ws access_control_security项目任务看板、进程内事件总线 + WebSocket 实时协同、ABAC 属性授权
基座运维core_auth_health ops deployment_ops edge_offline认证与健康探针、运维监控、部署、边缘离线运行

P3 LightApollo · 13 个模块

能力域包含模块一句话
交付核心hub_deployment gitops_engine cicd_pipeline期望状态 + DAG 门控 + 漂移检测 + 回滚、声明式编排、构建流水线
制品与配置artifact_management configuration_management统一制品库 + 国密签名验签、多环境配置与密文管理
环境与运行multi_env_management edge_airgap_support hybrid_cloud_deploy环境登记与 Agent 状态机、断网/信创场景、混合云(归并视图,无独立代码包
监控与自愈monitoring_observability alerting_self_healing四类内置探针自研轻量监控、告警归并成事件单 + 安全边界内自愈
安全与接口security_compliance rbac_audit api_cli_sdkSBOM 与漏洞扫描、逐路由权限 + 全量 HTTP 审计、REST/CLI 接口面

共享底座 platform/ · 22 个包

前面架构图里已经画过分组。这里补一句 V5 的四个新包为什么重要——它们不是「又多了几个功能」, 而是把之前各产品各自造轮子的三件事收成了一份:

关于 Swift 的模块数

开发文档只收录了 Swift 的 1 个部署运维模块,看上去像是「几乎没做」。实际情况是它的报文引擎、结算状态机、GAC 终端、HCC 管控台、星地链路仿真、国密全链路都已实现并有冒烟与端到端测试通过,只是开发文档尚未补齐。同理,前端页面文档里 Apollo 的 19 页和 Swift 的 4 页也只有索引、没有正文。

08

流程图一:从零把它建起来

FDE 进场到交付撤场的四个阶段,以及每个阶段谁做什么。厂商把这套定位成「轻交付」——一周部署、两周培训,然后靠制品而不是靠人留在现场。

角色 \ 阶段
① 接数据
② 建语义
③ 上治理
④ 交付上线
FDE
前沿部署工程师
A1进场部署规划端口与网段,五产品一键启动;注册客户数据源并连接测试
A2导入元数据任务化执行、页面看进度;导入前自动清理旧表名,防止残留误导 AI 检索
A3打标与授权敏感字段打 PII 与安全标记,配置用户授权矩阵
A4交接撤场期望状态 YAML 进本地 Git;交接文档写清「哪些不能承诺」
数据工程师
B1建数据集从数据源拉数或上传 CSV / JSON 建集;配全量或增量同步目标
B2建本体与指标对象 / 属性 / 链接 / 动作四要素;指标四层定义,口径在指标里现算
B3质量与血缘跑质量画像四因子评分;合入前用影响分析看波及范围
B4版本合入草稿 → 评审 → 合入;导出本体 YAML 作为 Apollo 分发件
业务方
分析师 / 骨干
C1确认口径「销售额」到底含不含退款、含不含税——这一步定了,全平台就统一了
C2试跑核对在 SQL 工作台或 Notebook 里跑一遍,和现有报表对数字
C3验收用自然语言问几个真实业务问题,看能不能问出正确结果
运维工程师
D1起服务五个后端 + 网关;确认健康探针全绿、数据库没有静默降级
D2接监控Prometheus 抓 /metrics;确认调度任务已注册、任务队列不堆积
D3部署与兜底DAG 分批推进;配漂移忽略路径;自动回滚作为最后一道保险

阴影格是这条路上最容易翻车的两步。B2 和 C1 必须同时发生——如果数据工程师建完模型才去问业务口径, 基本上要返工。厂商手册里反复强调的也是这一点:指标定义是业务决定,不是技术决定

详细路径(十步)

部署五个产品并起网关

Windows 上双击一键启动脚本,拉起五个后端 + 网关六个进程。信创离线环境同样可行——单一 Go 二进制,无外部服务依赖。

FDE / 运维产品:全部验证:五个 /health 全返回 ok
注册数据源并导入元数据

V5 起 Foundry 有独立的数据源页,不再依赖 AIP。导入元数据是任务化的:提交后返回任务号,页面轮询进度。连接器默认只放行 MySQL / SQL Server / PostgreSQL 三类。

FDE产品:Foundry注意:导入前会清理旧表名,避免残留误导检索
把数据落成平台内的数据集

从数据源查询拉数、或直接上传 CSV / JSON 建集(XLSX 会明确报错,不静默失败)。数据集可版本发布、可预览、可跑基础画像(空值率 / 唯一值 / Top5)。

数据工程师产品:FoundryV5
配置同步目标,让数据持续进来

全量模式是事务内重写;增量模式按水位线断点续传、冲突跳过。同步成功会自动联动血缘和质量画像刷新。

数据工程师产品:FoundryV5
建本体:对象、属性、链接、动作

整条链路里唯一不能省的一步。属性记得加同义词(提升语义检索命中)、给敏感字段打 PII 标记(列级安全自动生效)。V5 起属性类型收敛为 13 类标准值类型,可一键归一化存量属性。

数据工程师 + 业务方产品:Foundry输出:可 YAML 导出,随发布包分发
定义指标:口径落地为一条定义

四层结构:实体(决定粒度)→ 维度 / 度量 → 指标。类型分简单、比率、派生、累计四级。口径在指标里现算,不做预聚合——这样改口径不用重跑历史。

业务方拍板 · 数据工程师落地产品:Foundry
建管道与质量规则

单数据源内的有序 SQL 步骤,输出映射到对象。质量规则四类:非空、格式、唯一、引用完整性。error 级问题会直接阻断目标对象同步——脏数据不进本体。

数据工程师产品:Foundry边界:跨数据源管道未实现
定义 Action:把「改数据」变成受控动作

参数 Schema、校验规则、编辑类型、回写模式、幂等键。回写模式分两种:pre 先写源系统成功再提交本体(适合结算对账),post 先提交本体再异步做副作用(适合发通知)。

数据工程师 / FDE产品:Foundry关键:这一步决定了 AI 能做什么
版本评审合入,看影响面

草稿 → 评审 → 合入。合入前系统列出受影响的指标、报表、AI 检索并给重建建议;被引用的对象禁止删除;有真冲突会阻塞等人处理。

数据工程师 + 评审人产品:Foundry
打包成制品,用 Apollo 分发

本体 YAML、网关路由、评测集打成签名发布包。目标机上的 Agent 主动拉取,逐文件校验 → 整体验签 → 检查签名者白名单 → 检查版本是否单调递增 → 按依赖顺序应用。控制台不需要能连进客户网络。

运维 / FDE产品:Apollo兜底:就绪超时自动回滚上一稳定版
09

流程图二:建好之后怎么用

日常闭环。和传统 BI 的差别不在第一步,在第三步之后——发现异常之后还能追下去、改回来、并且让下一轮自动发生。

业务方 发现数字不对 Foundry 报表 / 仪表盘 定时快照推到邮箱 或顶栏搜索直接找到 分析师 问一句为什么 AIP 智能查询 五路召回 + 安全注入 答案带引用可追出处 分析师 / 情报 顺着线索追因 Foundry 血缘 · Gotham 图 这个数从哪来的 这些客户什么关系 业务方 / Agent 走 Action 改数据 Foundry 唯一写路径 七道关卡 + 全程留痕 改前状态一并记录 系统自动 驱动下一轮 CDC → 流规则 通知 / 同步 / 质检 报表定时重算分发 闭环:每一轮改动都留下审计 + 血缘 + 版本,下次问「这个数怎么算的」有答案
一次完整闭环。这是唯一一条同时用到本体、血缘、版本、图分析、写路径和审计的路径。任何一个环节缺失,闭环就退化成传统 BI:发现异常之后,靠人在群里问「这个数到底怎么算的」。最右边那格是 V5 才有的——以前闭环到第四步就断了,改完数据没有任何东西会自动接上。

业务方最常用的四个入口

想做什么去哪怎么用
快速取个数AIP 智能查询用直白关键词提问(「销售额」「订单数量」比口语化更容易命中)。重要数字务必核对返回的 SQL。
问一个需要理由的问题AIP 决策证据链V5系统会拆解问题、三路检索、逐条核验证据、只基于证据作答,答案里的 [n] 可点回原文。
反复要看的分析Foundry Notebook / 报表V5Notebook 把「取数 + 说明 + 图表」沉淀成可重跑的工作簿;报表可定时生成快照并邮件分发。
不知道东西在哪Foundry 顶栏搜索V5一个框搜遍对象、指标、数据集、仪表盘、Notebook,按相关度融合排序,点结果直接跳到对应页面。看不见的资产不会出现在结果里。
10

谁用哪一块

五类角色,五条互不重叠的工作线。角色之间靠「制品」交接——对象、指标、报告、期望状态——而不是靠开会对口径。

角色主战场日常做什么交出什么制品
数据工程师
语义的生产者
Foundry 建对象与指标、修管道、跑质量画像、管版本合入。一次建模,下游所有人复用。 对象定义、指标口径、数据集、本体 YAML
业务分析师
结论的消费者
AIP + Foundry 自然语言查数、核对口径、做 Notebook 与报表。不写 SQL 也能干活,但重要数字要核对生成的 SQL。 Notebook、报表、结论
情报 / 风控分析师
深度研判
Gotham 图谱展开与最短路径、实体解析审核、模式规则告警处置、写情报报告。 情报报告、告警处置结论
运维工程师
交付的保障者
Apollo + 全平台 期望状态与部署推进、漂移检测与收敛、监控指标与告警、回滚兜底、数据库与授权巡检。 期望状态 YAML、发布包、运维记录
FDE 前沿部署工程师
最后一公里
全部五个 进场部署、接客户数据、定制本体、培训业务骨干、交接后撤场。对标 Palantir 的 FDE 角色,但走「轻交付」路线。 整套可运行环境 + 交接文档 + 制品清单
决策者
只读
报表 / 报告 不碰 SQL 和 YAML。要数字先问「口径来自哪条指标定义」,要结论先问「谁查的、SQL 是什么」。 选型与承诺的判断
角色之间的接缝在哪

最容易出问题的接缝是数据工程师 ↔ 业务方:模型建完了才去确认口径,基本要返工。其次是数据工程师 ↔ 运维:本体改了但没走发布包分发,目标环境还是旧定义。这两处厂商都给了机制兜底(影响分析、版本单调递增),但机制拦得住错误,拦不住「没沟通」。

权限上的实际分工

11

能力边界(照实说)

这一节按厂商文档自己的标注整理。演示前先看一遍,比事后解释省事。

成熟度对照

能力状态具体说明
本体建模 · 指标语义层 · Action 写路径✅ 完整四要素、版本状态机、影响分析、七道关卡、幂等与乐观锁,全链路冒烟通过
数据集 · 同步 · 质量画像 · SQL 工作台✅ 完整V5 新增,任务化执行,成功链自动联动血缘与质量
NLQ 查数 · 决策证据链 · 知识域✅ 完整五路召回、行列级安全注入、会话记忆、实体抽取、五步证据链
图谱分析 · 实体解析 · 时空多视图✅ 完整自研磁盘图存储 + Go 原生算法;V5 补齐行级图谱化导入、图分区、时序分析
声明式部署 · 签名验签 · 漂移检测✅ 完整纯拉取模型、国密 SM3/SM2、签名者白名单、DAG 门控、自动回滚
知识库问答◐ 部分知识库只作为检索通道喂给查数链路,没有独立的「问文档」入口——该意图会短路返回提示
MCP 对外暴露◐ 默认关闭需显式开启配置项才注册路由;开启后每次工具调用都落审计,写动作仍走完整写路径
混合云部署◐ 归并视图厂商明确标注:没有独立代码包,是既有能力的组合说法,无 gRPC 端点、无 K8s 清单渲染
Apollo 演示 Agent◐ 仅巡检演示轮询器只拉取和上报,不真实拉起进程;要真部署得挂上进程管理器
Git 真相源◐ 本地目录用本地目录模拟仓库,真实 GitHub / GitLab / Gitea 对接规划中;同步靠手动或定时触发
P5 Swift 星基结算◐ 仿真 PoC报文、国密、复式记账、对账全链路可跑(冒烟 16/16、E2E 33/33),但星座拓扑、链路延迟、账户余额、外部清算通道全是模拟,不是在轨系统
跨产品单点登录✗ 未实现Apollo 和 Swift 各有独立用户库,切产品要重新登录
跨数据源管道✗ 未实现管道只支持单数据源内的 SQL 步骤,跨源 join 不做(与单机优先一致)
字段级全量血缘✗ 浓缩版四级血缘(源 → 管道 → 对象 → 指标)+ Action 写边 + 报表打点,不是逐字段全量

规模与依赖的硬边界

规模
TB 级是共同上限

图存储是内存邻接表 + JSON 落盘;查数一次只查一个数据源、最多返回 100 行;对象查询最多 3 层深、禁止点号引用。厂商自己说明:TB 级是设计判断,未经真实压测,大规模选型前要做基准验证。

AI
断网时链路中断

生成 SQL 依赖外部大模型(主力 deepseek-v4-flash,备用 qwen,兜底本地规则)。降级方案:Foundry 的对象查询、SQL 工作台、Gotham 的图算法都是本地计算,断网照样能取数、能研判。

数据
演示库互不联通

五套演示数据各自独立,人名相近(张三 / 李四 / 王五)但不是同一条记录。跨产品追查演示数据需要手工导。注意这是演示数据的限制,不是架构限制——注册同一个真实数据源即可打通。

运行
演示数据每次重启重建

各产品的 demo 数据源启动时幂等重建,临时改动重启就还原(平台元数据与审计会保留)。做演示前不要在 demo 库里存重要东西。

部署前一定要确认的一件事

数据库连不上 PostgreSQL 时,系统会静默降级到 SQLite 并继续启动。好处是单机永远跑得起来,坏处是——你可能以为在用生产库,其实在用本地文件。降级后运维冒烟脚本里的数据库断言也会失效。

上线前务必检查启动自检日志里的数据库项,或直接确认表建在了 chatbi_action_dev 里。

验证证据(厂商自述)

层次结果覆盖
Go 单元测试285 个测试函数 / 40 个文件,全绿底座 + 四产品核心包
真实冒烟Foundry 23/23 · Apollo 26/26 · Gotham 44/44 · Swift 16/16跑在真实 PostgreSQL 上,全链路端到端
浏览器 E2EFoundry 5/5 · Apollo 5/5 · Swift 33/33Playwright 真实点击,AIP / Gotham 走前端骨架 + API 联调
契约一致性OpenAPI 规格与实际路由双向对拍V5 新增,防止「文档写了但没实现」和反过来

口径提示:单测与前三个冒烟数字来自 site/verification.html(8 月 9 日版,未随 V5 更新),Swift 的数字来自 8 月 10 日的路线图页。 V5 新增的大量模块是否已纳入这些统计,文档没有说明——把它当作「V4 主干的验证证据」来读更稳妥。

12

术语速查

读厂商文档时最常撞上的词。带 V5 标记的是这一版新出现的。

本体 Ontology
建立在物理表之上的业务语义层,由对象 / 属性 / 链接 / 动作四要素组成。整个平台的地基。
Action 动作
被定义好参数、校验、权限和回写方式的写操作。平台唯一的写入口,人和 AI 都必须走它。
api_name / rid
对象的稳定标识。所有跨系统引用都用它,不用会变的数据库自增 ID。
OOL 对象查询语言
轻量版对象遍历查询:一次只针对一个对象类型,跨对象要显式 traverse,最多 3 层深,禁止点号引用。
RLS / CLS
行级 / 列级安全。查询时自动注入过滤条件与列遮蔽。V5 起自然语言查数主链路也注入,注入失败直接拒绝执行。
编辑态 ontology_edits
通过 Action 改过的值不覆盖源表,独立落盘,查询时叠加。V5 起明细与聚合都会叠加。
乐观并发控制
回写时带上「我看到的时间戳」,不匹配就返回 409 冲突和最新状态,让客户端重试。防止两个人同时改覆盖彼此。
幂等键 idempotency key
同一个键重复提交只执行一次,后续返回首次结果。网络重试不会变成重复扣款。
RAG 五路召回V5
查数前并行检索五个通道并加权融合:元数据 0.35 / 知识库 0.25 / 历史 0.15 / 少样本 0.15 / 实体 0.10(第五路是 V5 新增)。
决策证据链V5
五步:拆解问题 → 三路检索 → 逐条核验证据 → 仅基于证据综合 → 确定性映射引用。每步都写审计,可全流程回放。
CDC 变更捕获V5
轮询比对源表检出增删改,不依赖数据库日志、不需要装消息队列。Foundry 的流规则消费它的事件。
Fusion 实体消解V5
把「同一个客户的多条脏记录」自动合成一条:规则分桶 → 相似度加权 → 灰区交给大模型复核 → 聚类选主 → 人工确认。
标准值类型 ValueTypeV5
冻结的 13 类属性类型(文本 / 数值 / 金额 / 百分比 / 日期 / 枚举 / 数组…),可对存量属性一键归一化,先预览再写库。
MCP 模型上下文协议V5
把平台能力暴露成大模型可调用的工具。默认关闭;开启后 5 个工具全程审计,写动作照走完整写路径。
Nexus 统一搜索V5
顶栏一个框搜遍对象 / 指标 / 数据集 / 仪表盘 / Notebook,多路并行后用倒数排名融合排序,看不见的资产不出现。
期望状态 Desired State
用 YAML 声明「这个环境应该长什么样」。目标机上的 Agent 主动来拉、自己验签、自己应用。
Spoke Agent
装在目标机上的拉取端。只出不进——拉取和上报都是它主动发起,控制台永远不需要能连进客户网络。
漂移 Drift
实际状态和声明状态不一致(有人手改了配置)。系统产出字段级差异,可配忽略路径,可自动收敛回去。
ABAC
Gotham 的属性授权:先过基础角色门,再按主体 / 资源 / 操作 / 环境四类属性收窄。拒绝一票否决,默认拒绝。
实体解析四层
分块 → 确定性匹配 → 规则匹配 → 模糊匹配(可选大模型复核灰区),再聚类。分数 ≥0.90 自动合并、0.70~0.90 待人工审核、<0.70 拒绝。
降级链
主力挂了自动换下一个:大模型 deepseek → qwen → 本地规则;向量库 milvus → turbovec → 磁盘;数据库 PostgreSQL → SQLite。
国密 SM2 / SM3
国产密码算法。SM3 做内容哈希,SM2 做签名验签。纯 Go 实现,兼容信创环境的无 CGO 编译。
actionctlV5
命令行客户端。7 个子命令:登录、本体导入导出、数据集、异步任务、指标查询、MCP 探活。本体从此可以进 Git 做代码评审。