Skip to content

World's first open-source enterprise world model.

An ontology now starts with nothing the code put there (#128)

WaylandYang5be94c1bef63
diff --git a/crates/utopia-server/src/api/kbs.rs b/crates/utopia-server/src/api/kbs.rs
index d5ac9523..9cd9bd1a 100644
--- a/crates/utopia-server/src/api/kbs.rs
+++ b/crates/utopia-server/src/api/kbs.rs
@@ -89,14 +89,7 @@ pub async fn create(
}
utopia_store::access::set_kb_member(&state.pool, kb.id, user.id, "admin", Some(user.id))
.await?;
- install_packs(
- &state,
- kb.id,
- user.id,
- &kb.ontology_lang,
- &req.ontology_packs,
- )
- .await?;
+ install_packs(&state, kb.id, user.id, &req.ontology_packs).await?;
let kb = utopia_store::kbs::get(&state.pool, kb.id).await?;
Ok(Json(kb))
}
@@ -276,12 +269,12 @@ pub async fn audit_log(
let events = utopia_store::audit::list_for_kb(&state.pool, id, 100).await?;
Ok(Json(json!({ "events": events })))
}
-
/// 建库时装选中的本体包。
///
-/// **种子本体先落地**:包里的类要认领同名的种子类(`schema:Organization` 接管
-/// `organization`),而认领的前提是那一行已经存在。`ensure_default_ontology`
-/// 平时是懒调的(首次读本体或首次抽取时),这里必须显式先跑一次。
+/// 从前这里要先跑一次 `ensure_default_ontology`:包里的类要认领同名的种子类
+/// (`schema:Organization` 接管 `organization`),而认领的前提是那一行已经存在。
+/// **现在没有种子可认领了**——0009 删掉内置实体类、0010 与 `#125` 删掉种子关系、
+/// 0011 把 `mapped_to` 搬去语义层之后,播种函数本身也退场了。包直接落进空库。
///
/// **一个包失败不回滚已装的**:本体是加法,装了一半的库仍然可用,
/// 而回滚要撤已经建好的类——那正是 0008 决定不做导入撤销的理由。
@@ -290,13 +283,11 @@ async fn install_packs(
state: &AppState,
kb_id: Uuid,
actor: Uuid,
- lang: &str,
pack_ids: &[String],
) -> ApiResult<()> {
if pack_ids.is_empty() {
return Ok(());
}
- utopia_store::graph::ensure_default_ontology(&state.pool, kb_id, lang).await?;
for id in pack_ids {
let pack = crate::ontology_packs::get(id)
.ok_or_else(|| AppError::invalid("unknown_pack", format!("未知的本体包:{id}")))?;
diff --git a/crates/utopia-server/src/api/ontology_routes.rs b/crates/utopia-server/src/api/ontology_routes.rs
index a7cadf76..463ab1c3 100644
--- a/crates/utopia-server/src/api/ontology_routes.rs
+++ b/crates/utopia-server/src/api/ontology_routes.rs
@@ -30,8 +30,6 @@ pub async fn get(
Path(kb_id): Path<Uuid>,
) -> ApiResult<Json<serde_json::Value>> {
require_kb(&state, &user, kb_id, Role::Viewer).await?;
- let kb = utopia_store::kbs::get(&state.pool, kb_id).await?;
- utopia_store::graph::ensure_default_ontology(&state.pool, kb_id, &kb.ontology_lang).await?;
let entity_types = utopia_store::ontology::entity_type_views(&state.pool, kb_id).await?;
let relation_types = utopia_store::ontology::relation_type_views(&state.pool, kb_id).await?;
let misses = utopia_store::ontology::list_misses(&state.pool, kb_id).await?;
diff --git a/crates/utopia-server/src/extraction.rs b/crates/utopia-server/src/extraction.rs
index 501341fc..20361da6 100644
--- a/crates/utopia-server/src/extraction.rs
+++ b/crates/utopia-server/src/extraction.rs
@@ -168,11 +168,6 @@ async fn run(state: &AppState, document_id: Uuid) -> anyhow::Result<()> {
let my_epoch = utopia_store::documents::extract_epoch(&state.pool, document_id).await?;
utopia_store::documents::set_graph_status(&state.pool, document_id, "extracting").await?;
state.emit_document(doc.kb_id, document_id);
- let kb_lang = utopia_store::kbs::get(&state.pool, doc.kb_id)
- .await?
- .ontology_lang;
- utopia_store::graph::ensure_default_ontology(&state.pool, doc.kb_id, &kb_lang).await?;
-
let etypes = utopia_store::graph::entity_types(&state.pool, doc.kb_id).await?;
let rtypes = utopia_store::graph::relation_types(&state.pool, doc.kb_id).await?;
// 关系与属性分道:属性走字面值通道,不进关系清单。
@@ -188,7 +183,8 @@ async fn run(state: &AppState, document_id: Uuid) -> anyhow::Result<()> {
// `DEFAULT_RELATION_TYPES` 里的种子——而这里的排除过滤已经跟着删了。于是
// `ensure_default_ontology` 七分钟后把行种回来,`related_to` 第一次被**列进
// 提示词给模型看**。0001 量过:359 次使用里 321 次是模型从清单上挑的。
- // 谁要往种子表里加回一个兜底关系,先看 0010。
+ // 谁要往种子表里加回一个兜底关系,先看 0010——不过那张表现在已经没有了
+ // (`#128`),连播种函数一起退场。
let type_key_by_id: HashMap<Uuid, &str> =
etypes.iter().map(|t| (t.id, t.key.as_str())).collect();
let attr_meta: HashMap<&str, &utopia_core::models::RelationType> = rtypes
diff --git a/crates/utopia-server/src/ontology_packs.rs b/crates/utopia-server/src/ontology_packs.rs
index 14e829be..e474a500 100644
--- a/crates/utopia-server/src/ontology_packs.rs
+++ b/crates/utopia-server/src/ontology_packs.rs
@@ -1,8 +1,12 @@
-//! 预置本体包:建库时可选的起点。
+//! 预置本体包:建库时的起点。
//!
-//! 十个种子关系一个类型签名都没有(`graph.rs` 的 `DEFAULT_RELATION_TYPES`),
-//! 而抽取提示词是支持签名的——`- buys_from (employee|team → *)`。没有签名,方向
-//! 就只能靠散文描述,而散文约束不了方向。schema.org 的 1521 个属性里 1488 个带
+//! 建库时**什么都不铺**:0009 删掉内置实体类、0010 与 `#125` 删掉种子关系、
+//! 0011 把 `mapped_to` 搬去语义层之后,播种机制整个退场。所以这些包不是
+//! 「补充」而是本体的**全部来源**。
+//!
+//! 当初那十条种子关系一个类型签名都没有,而抽取提示词是支持签名的——
+//! `- buys_from (employee|team → *)`。没有签名,方向就只能靠散文描述,
+//! 而散文约束不了方向。schema.org 的 1521 个属性里 1488 个带
//! domain + range,方向是**声明的**不是描述的。见 `docs/decisions/0008`。
//!
//! **文件内嵌进二进制**,不在运行时下载:README 承诺整套系统可以跑在完全离线的
diff --git a/crates/utopia-store/src/graph.rs b/crates/utopia-store/src/graph.rs
index de527185..4c432b5b 100644
--- a/crates/utopia-store/src/graph.rs
+++ b/crates/utopia-store/src/graph.rs
@@ -22,121 +22,20 @@ const ADOPT_SUPERSEDED: &str = "superseded";
/// 读成"并入"而不是"撤回",否则界面会宣称一件没发生的事。
const ADOPT_MERGED: &str = "merged";
-/// 建库时铺的关系。**只剩 `mapped_to` 一条,而它也是暂留。**
-///
-/// 从前这里有九个(works_at、part_of、produces…)。删掉它们的理由跟 0009 删掉
-/// 内置实体类是同一条,只是晚了一步:
-///
-/// - **零个带签名。** 那九条一个 domain / range 都没设,方向只能靠散文写——
-/// 与 0009 记的「零个带类型签名」一字不差。
-/// - **装了本体包也不会被顶替。** 实体类那边至少还能按 key 撞名被认领
-/// (`schema:Person` 接管 `person`),关系这边连这个都没有:schema.org 叫
-/// `worksFor`、`isPartOf`,key 与 `works_at`、`part_of` 对不上,于是**并存**——
-/// 同一件事在图上成了两条边。`location` 割断地理子树那次就是这么来的。
-/// - **它们挡在公理前面。** 一致性检查(0002 R0)要 `is_transitive` /
-/// `is_asymmetric` / `is_symmetric` 这些位,而种子是代码里写死的六元组,
-/// 没有这些列,于是**公理位恒为 false**。真词表带着公理(IOF 的 13 条传递属性、
-/// FOAF 的互斥声明),种子只会往里掺一批永远查不出矛盾的关系。
-///
-/// **`mapped_to` 暂留,但它也不该在这里。** 它是「怎么从数据库算出这个数」,
-/// 不是「世界上有什么」——按上面同一条理由,它属于语义层而不是本体。
-/// 现在不动它,因为搬走要一并重做三样今天白拿的东西:低置信事实的 Review
-/// 流(`review_routes` 按置信度捞,Confirm/Reject 零新 UI)、口径演变的双时态
-/// 历史、以及证据链。那是独立的一刀,配一篇自己的决策记录。
-const DEFAULT_RELATION_TYPES: &[(&str, &str, &str, bool, bool, &str)] = &[
- // 问数语义层:概念 → 数据资产定义(object_value 宾语:{source, table?, expr?, sql?,
- // derived?, unit?, summary})。多源=多条并存;同源口径演变由确认流程显式闭合,
- // 不靠引擎盲判(唯一性粒度是 (概念,源),在 object_value 内部,引擎不感知)
- (
- "mapped_to",
- "mapped to",
- "state",
- false,
- false,
- "A business concept maps to a concrete data asset — the semantic layer's definition \
- of how to compute it.",
- ),
-];
-
-/// 关系的中文措辞:`key → (label, description)`。label 是**动词短语**,
-/// 读起来要能接上主宾:「张三 —任职于→ 星云科技」。
-///
-/// **只覆盖 label 与 description**。时态与函数性跟语言无关,在上面那张表里
-/// 只有一份——复制一遍迟早会漂移。
-///
-/// 两条写法上的规矩,都不是文风问题:
-///
-/// 1. **描述里提到类型时用 key,不用 label。** 中文库的 label 是「人物」,
-/// 但模型必须输出 `person`。描述逐字进提示词,写「那些属于人物」等于教模型
-/// 输出一个不存在的类型。
-/// 2. **负面例子是干活的那半。** 模型的错误集中在相邻类的边界上,不在类的中心;
-/// "什么不算" 比 "什么算" 更能改变结果。所以这不是翻译,是用中文重写一遍。
-const RELATION_TEXT_ZH: &[(&str, &str, &str)] = &[(
- "mapped_to",
- "映射到",
- "一个业务概念映射到一份具体的数据资产——语义层里「这个东西怎么算」的定义。",
-)];
-
-/// 取某个 key 在给定语言下的 (label, description);没有该语言的措辞就回落到英文。
-///
-/// 回落是必须的:中文表漏了一条不该让建库失败,只该让那一条是英文。
-fn localized(
- table: &'static [(&'static str, &'static str, &'static str)],
- key: &str,
- lang: &str,
- fallback: (&'static str, &'static str),
-) -> (&'static str, &'static str) {
- if lang == "zh" {
- if let Some((_, label, description)) = table.iter().find(|(k, _, _)| *k == key) {
- return (label, description);
- }
- }
- fallback
-}
-
-/// 建库时铺内置本体——**只有关系,没有实体类**(见 `docs/decisions/0009`)。
-/// 已存在的行只补空描述,
-/// 不覆盖人写过的:种子里的描述是缺省值不是权威,用户按自己的语料调过之后
-/// 不该被下一次调用抹掉。
-///
-///
-/// 从前这里有九个(person、organization、location…)。通病是**零个带类型签名**,
-/// 方向只能靠散文写;而装了 schema.org 之后它们又会被同名的真类顶替,
-/// 等于从头到尾只是个占位。`location` 是反例中的反例——schema.org 里它叫 `Place`,
-/// key 对不上于是不被认领,`City` 挂到另建的 `place` 底下,
-/// 一个我们自己起的名字把整条地理子树割断了。
-///
-/// 兜底类 `concept` 一并退场:「还没判出来」现在由 `entities.type_id IS NULL` 表达。
-/// 哨兵有名字,有名字就会撞——`skos:Concept` 派生出的 key 正是 `concept`,
-/// 而哨兵没有 IRI,导入的「占位者没有 IRI 就认领它」会让它直接接管。
-pub async fn ensure_default_ontology(pool: &PgPool, kb_id: Uuid, lang: &str) -> AppResult<()> {
- for (key, en_label, temporal, functional, inverse_functional, en_description) in
- DEFAULT_RELATION_TYPES
- {
- let (label, description) =
- localized(RELATION_TEXT_ZH, key, lang, (en_label, en_description));
- sqlx::query(
- "INSERT INTO relation_types
- (id, kb_id, key, label, temporal, functional, inverse_functional, builtin,
- description)
- VALUES ($1, $2, $3, $4, $5, $6, $7, TRUE, $8)
- ON CONFLICT (kb_id, key) DO UPDATE
- SET description = EXCLUDED.description
- WHERE relation_types.description = ''",
- )
- .bind(Uuid::now_v7())
- .bind(kb_id)
- .bind(key)
- .bind(label)
- .bind(temporal)
- .bind(functional)
- .bind(inverse_functional)
- .bind(description)
- .execute(pool)
- .await?;
- }
- Ok(())
-}
+// 建库不再播种任何关系,也不再有 `ensure_default_ontology`。
+//
+// 这里曾经有十条种子关系、一张中文措辞表、一个按语言取措辞的 `localized`,
+// 以及一个在建库 / 首次读本体 / 每次抽取前都会跑一遍的播种函数。它们分三次退场:
+//
+// - `related_to`(0010):代码层面的兜底,摆进提示词就成了逃生舱
+// - 另外八条(`#125`):零个带签名、装了本体包也不会被同名顶替
+// (`worksFor` 与 `works_at` 的 key 对不上,于是并存成两条边)、
+// 而且公理位恒为 false,一致性检查在它们上面永远查不出矛盾
+// - `mapped_to`(0011):它是「这个数怎么算」不是「世界上有什么」,
+// 已搬去 `concept_mappings`
+//
+// 剩下的那个函数于是只是在遍历一张空表。**本体从建库第一天起就只有
+// 用户自己导入的词表**——与 0009 删掉内置实体类是同一件事的下半段。
pub async fn entity_types(pool: &PgPool, kb_id: Uuid) -> AppResult<Vec<EntityType>> {
Ok(
diff --git a/crates/utopia-store/tests/no_predicate_still_shows.rs b/crates/utopia-store/tests/no_predicate_still_shows.rs
index a21f512a..29d7d2e8 100644
--- a/crates/utopia-store/tests/no_predicate_still_shows.rs
+++ b/crates/utopia-store/tests/no_predicate_still_shows.rs
@@ -236,22 +236,25 @@ async fn a_fact_without_a_predicate_is_still_visible_everywhere() -> anyhow::Res
assert!(c.is_some(), "变更流漏掉了没有谓词的事实");
assert_eq!(c.unwrap().predicate_label.as_deref(), Some("acquired"));
- // 7. **种子不能把它长回来。**
+ // 7. **不再有任何机制能把它长回来。**
//
- // 这一条第一版是空的:只 `SELECT count(*) … WHERE key='related_to' AND builtin`,
- // 而上面的夹具是裸 SQL 建的库,从没调用过 `ensure_default_ontology`——
- // 种子一次都没种下,断言在一片空地上成立。真实情况是 0052 删完七分钟,
- // 代码就把行种回来了(见 0053)。**对照组必须先把种子种下去。**
- utopia_store::graph::ensure_default_ontology(&pool, f.kb, "en").await?;
+ // 这一条的历史值得留着:第一版是空断言(只 `SELECT … WHERE builtin`,
+ // 而夹具是裸 SQL 建的库、从没播种过,于是断言在一片空地上成立);
+ // 第二版补了对照组——先调 `ensure_default_ontology` 把种子种下去,
+ // 再确认 `related_to` 不在其中。因为 0052 删完七分钟,代码就把行种回来了(0053)。
+ //
+ // 现在**连播种函数都没有了**:0009 删内置实体类、0010 与 `#125` 删种子关系、
+ // 0011 把 `mapped_to` 搬去 `concept_mappings`,`ensure_default_ontology`
+ // 随之退场。所以这里改守更强的那条性质:**建库路径上不存在任何
+ // 代码硬塞的关系**,`builtin` 那一列在新库里恒为空。
let seeded: Vec<String> =
sqlx::query_scalar("SELECT key FROM relation_types WHERE kb_id = $1 AND builtin")
.bind(f.kb)
.fetch_all(&pool)
.await?;
- assert!(!seeded.is_empty(), "种子一个都没种下,这一条又成了空断言");
assert!(
- !seeded.iter().any(|k| k == "related_to"),
- "种子表把 related_to 长回来了:{seeded:?}"
+ seeded.is_empty(),
+ "本体里不该有代码硬塞进去的关系,实得 {seeded:?}"
);
// 只按 kb 查,不查全库:全库计数会被并行跑的其它测试和上一轮的残留污染,