企业官网建设流程全解析

Utopia复核队列指南：实体合并与事实确认的人机协同决策清单

【免费下载链接】utopia首个开源企业世界模型项目地址: https://gitcode.com/deeplethe/utopia

Utopia 是一款首个开源的企业世界模型（知识工程底座），它的**复核队列（Review Queue）**让机器先裁、人来定夺：实体合并、事实确认、冲突处理全部排队等你决策，每个决定都写进只增不改的账本，随时可查、可撤销。这篇指南带你 5 分钟上手复核队列，看清 8 种待办卡片的处理姿势。

为什么需要复核队列？

文档进系统后，抽取引擎会把内容变成实体和事实。但机器总有拿不准的时候：

• 两个实体到底是不是同一个？比如Acme和Acme Corp，合错了就混淆了两个人的事实；
• 这句话抽出的三元组对不对？比如Acme --?--> 深圳，人一看原句就知道该拒；
• 新事实和旧事实打架了，该关旧、留双、还是拒新？

Utopia 的答案很克制：机器能裁的自动裁，裁不动的进队列等人点头。低置信度抽取、疑似重复、基数冲突，统统排队，不静默入库。

💡 设计原则：宁可分开，不可错合——错合并会混掉两个实体的事实，而"保留"随时可以反悔。

三步快速进入复核队列

1. 启动项目（需要 Docker）：

   git clone https://gitcode.com/deeplethe/utopia cd utopia docker compose --profile app up -d

2. 打开http://localhost:1516注册，第一个账号自动成为管理员，并创建一个公开知识库；

3. 在左侧导航进入Review（复核）页面，先看总览：有多少在等、等了几天、队列在消还是在涨。

总览页由 ReviewOverview.tsx 渲染，数据全部来自服务端同一口径的统计接口；队列的完整设计思路见 governance.md。

八种待办队列一览

进入 Review 页，左栏按来源分组，每档卡片长得不一样，问的问题也不同：

另有Agent 队列：机器裁不动、主动递上来的"提案"，附理由和推理轨迹，你接受、改判或撤销都行。

实体合并决策：合并还是保留？

重复项卡片左右并排两张实体卡（见 Review.tsx），扫一眼就能做判断：

• 类型对不上就亮警告——两边都有类型且不同，多半是同名异义，合并即错；
• Agent 的建议显示在卡片顶部，Merge / Keep 两个按钮就是对它的回答；
• 相似度百分比告诉你它们为什么像，而不是一句"机器觉得"。

决策前记住三条判断口诀（来自 identity.md）：

1. 带版本号、分部的名字（v2、东区）是另一个东西；
2. 把名字装进短语里（"张伟的部门"）不等于名字本身；
3. 丢掉限定词、公司后缀、缩写展开后一致 → 大概率是同一个东西。

每次合并都会移动事实而不是删除，并且可以在两个时间轴上完整回滚（revert_merge）。想理解"为什么合并后不能随便撤"，读这篇决策记录：0027-an-automatic-merge-is-gated-by-what-it-can-undo.md。

事实确认：先看原句，再点头

"等你点头"队列排在最前面，规则很简单：原句在上，三元组在下（见 PendingFacts.tsx）。

• 只有三元组，等于要人凭空判断对错；
• 原句一出来，Acme 把总部迁到了深圳这种半截事实一眼就能拒。

确认后，事实才真正进入图，参与检索和推理；拒绝会留档，同一主谓宾组合下次抽取时不再重复打扰你。这条"记录一句话 ≠ 断言一个事实"的设计，完整背景见 0015 决策记录。

⚠️ 权限提示：确认/拒绝是写图动作，需要Editor 及以上角色。Viewer 看得到卡片但看不到按钮——不让你猜自己有没有权限。

Agent 自动裁决与人的否决权

打开治理开关（governance，默认开启）后，Agent 会先批量裁决重复对：

• 门槛是纯函数：置信度 0.85（有前人判例支持时降到 0.75），账本里人的历史决定就是"先例"；
• 影响闸门：一次合并如果会让某个实体同时挂上两个"CEO"值、推翻现有推导、或动了助手回答里点过名的实体——无论置信度多高，强制留给人，卡片上写明被扣住的原因；
• 保险丝：开关打开后 7 天内，人的两次"撤销 Agent 合并"会自动关掉开关并记一笔——这是账本里最强的"机器不可信"信号。

人做的每个决定（合并、保留、确认、拒绝）都是账本事件，可附一句**"什么让你这么定"（rationale）**，这句话将来会作为先例喂给 Agent——人写账本，机器读账本，闭环由此形成。

决策账本：每个操作可追溯

复核队列背后是 Utopia 的只增账本：谁、何时、对象当时长什么样，全有记录，且记录比对象活得久。合并后想反悔？实体历史页能看到"当时记作 X，后来改为 Y，是谁改的"。

• 账本设计：ledger.md
• 治理与闸门：governance.md
• 前端复核页：Review.tsx、PendingFacts.tsx
• 项目总览与快速启动：README.md

收尾清单：一次复核巡检怎么做

最后，把上面浓缩成一份可执行的巡检清单：

• 先看总览：最老的卡片等了几天，从最旧的清起
• "等你点头"优先：卡片最少、判断最快
• 重复项扫三遍：类型不一致 → 直接保留；Agent 建议 + 高相似 → 合并；拿不准 → 保留
• 冲突队列逐条选动作，别囤着
• 抽查 Agent 队列：它裁过的、递上来的，看看"为什么"
• 发现 Agent 连续错 → 撤销并附理由，保险丝会替你关掉它
• 每周回头看一眼总览柱状图：队列在消，说明人机协同在收敛

复核队列不是负担，而是企业知识底座的可信来源：机器负责快，人负责对，账本负责记住一切。

【免费下载链接】utopia首个开源企业世界模型项目地址: https://gitcode.com/deeplethe/utopia