World's first open-source enterprise world model.
Rust agent-memorybitemporalgraphragknowledge-baseknowledge-graphllmontologypgvectorpostgresqlragrustself-hostedsemantic-searchtemporal-knowledge-graphworld-model
Move the default port from 8080 to 1516 (#52)
WaylandYang7e9a464a172f
diff --git a/.env.example b/.env.exampleindex b80bcc92..724320e1 100644--- a/.env.example+++ b/.env.example@@ -1,6 +1,6 @@# 复制为 .env 后按需修改。所有配置走 UTOPIA_ 前缀的环境变量。UTOPIA_DATABASE_URL=postgres://utopia:utopia@localhost:5432/utopia-UTOPIA_BIND_ADDR=0.0.0.0:8080+UTOPIA_BIND_ADDR=0.0.0.0:1516# 生产环境必须改成随机长密钥UTOPIA_JWT_SECRET=dev-secret-change-me# 前端构建产物目录(存在则由服务端托管 SPA)diff --git a/.github/workflows/release.yml b/.github/workflows/release.ymlindex a1bf3871..ed4627c4 100644--- a/.github/workflows/release.yml+++ b/.github/workflows/release.yml@@ -66,7 +66,7 @@ jobs:if docker exec pg pg_isready -U utopia -d utopia >/dev/null 2>&1; then break; fisleep 2done- docker run -d --name app --network smoke -p 8080:8080 \+ docker run -d --name app --network smoke -p 1516:1516 \-e UTOPIA_DATABASE_URL=postgres://utopia:utopia@pg:5432/utopia \-e UTOPIA_JWT_SECRET=smoke-test-secret \utopia:smoke@@ -75,7 +75,7 @@ jobs:# 而镜像带 SPA fallback——请求 /health 会拿到 200 的 index.html,看着像通过。ok=""for _ in $(seq 1 40); do- if curl -sf -m 3 http://localhost:8080/api/v1/health -o /tmp/h.json \+ if curl -sf -m 3 http://localhost:1516/api/v1/health -o /tmp/h.json \&& grep -q '"status":"ok"' /tmp/h.json; then ok=1; break; fisleep 2done@@ -83,7 +83,7 @@ jobs:# 注册一次,把迁移 + argon2 + JWT 签发整条链路真正走一遍code=$(curl -s -o /tmp/reg.json -w '%{http_code}' -m 10 \- -X POST http://localhost:8080/api/v1/auth/register \+ -X POST http://localhost:1516/api/v1/auth/register \-H 'Content-Type: application/json' \-d '{"email":"[email protected]","password":"smoke-password-123","display_name":"Smoke"}')if [ "$code" != "200" ]; thendiff --git a/README.md b/README.mdindex 51616fde..e9603fcc 100644--- a/README.md+++ b/README.md@@ -49,7 +49,7 @@ cd utopiadocker compose --profile app up -d```-Open http://localhost:8080 and register — the first account becomes the administrator. Then add an OpenAI-compatible endpoint under Settings, create a knowledge base, and drop in some files.+Open http://localhost:1516 and register — the first account becomes the administrator. Then add an OpenAI-compatible endpoint under Settings, create a knowledge base, and drop in some files.That pulls a prebuilt image from `ghcr.io/deeplethe/utopia`. Uploaded files and the search index live in `./data`, so back that up alongside the database. To build from source instead — after changing code, or to run an unreleased revision:@@ -63,7 +63,7 @@ docker compose -f docker-compose.yml -f docker-compose.build.yml --profile app u# 1. Postgres with pgvectordocker compose up -d db-# 2. Backend on :8080 — runs migrations on startup+# 2. Backend on :1516 — runs migrations on startupcargo run -p utopia-server# 3. Frontend on :5173, proxying /api to the backend@@ -77,7 +77,7 @@ Everything is an environment variable prefixed with `UTOPIA_`; copy [.env.exampl| Variable | Default | Purpose ||---|---|---|| `UTOPIA_DATABASE_URL` | `postgres://utopia:utopia@localhost:5432/utopia` | Postgres connection string |-| `UTOPIA_BIND_ADDR` | `0.0.0.0:8080` | Listen address |+| `UTOPIA_BIND_ADDR` | `0.0.0.0:1516` | Listen address || `UTOPIA_JWT_SECRET` | `dev-secret-change-me` | **Change this in production** || `UTOPIA_WEB_DIST` | `web/dist` | Built frontend; served as an SPA when present || `UTOPIA_DATA_DIR` | `data` | Original files and the full-text index |diff --git a/README.zh-CN.md b/README.zh-CN.mdindex 1c087795..4d659998 100644--- a/README.zh-CN.md+++ b/README.zh-CN.md@@ -13,12 +13,24 @@---+<!-- 视频:把 mp4 拖进任意 issue/PR 的评论框,GitHub 会返回一个+ https://github.com/user-attachments/assets/xxx 链接,+ 把那个链接单独一行粘在这里即可自动渲染成播放器。 -->++<div align="center">++https://github.com/user-attachments/assets/PLACEHOLDER++</div>++---+## 这个项目是什么?-一个 Agent Memory?-又一个 Graph RAG?-或者,又一套 DAG?-都可以是,但又不止于此。+> 这一章讲的是「乌托邦」的世界观与设计理念。+> **我们强烈建议阅读本章节**,约 5 分钟。++**一个 Agent Memory?又一个 Graph RAG?或者,又一套 DAG?** 都可以是,但又不止于此。我们想搭建的,是一个属于企业自己的世界模型:它知道企业里有哪些人、哪些事、哪些规则与关系;知道什么正在发生,什么曾经发生;知道一件事为什么成立,又会因为什么而失效。记忆、知识、规则、时间、推理与行动,都只是它的一部分。@@ -26,7 +38,16 @@但真正维护起来才会发现:建立一个世界并不难,难的是让它长期、稳定而可信地运转下去。要维持一个理想国度,需要一些伟大的制度。于是有了下面这些属于「乌托邦」的法则。-### 宙斯之律(Zeus's Law)+| | 法则 | |+|:---:|---|---|+| 🧓🏻 | **宙斯之律**<br/>Zeus's Law | 善待每一条来到这个世界的知识 |+| 📜 | **历史法则**<br/>Law of History | 知识不是一张静止的事实表,而是一段不断发生的历史 |+| ⛵ | **理想演绎**<br/>Law of Deduction | 从「理解现在」,进一步走向「推演未来」 |+| ⚖️ | **世界铁律**<br/>The Iron Law | 让规则托住智能,让逻辑约束行动 |++### 🧓🏻 宙斯之律(Zeus's Law)++> **善待每一条来到这个世界的知识。**在古希腊,宙斯守护陌生人与旅人。无论来者从哪里出发,在被了解之前,都应先得到接纳。「乌托邦」也希望如此对待每一条进入世界的知识。@@ -38,7 +59,9 @@这是「乌托邦」的宙斯之律:善待每一条来到这个世界的知识。-### 历史法则(Law of History)+### 📜 历史法则(Law of History)++> **知识不是一张静止的事实表,而是一段不断发生的历史。**传统的知识图谱,往往试图记录一个个确定的事实,并不断追求什么才是「正确」的知识。可是,知识是否正确,有时只有时间才能回答。@@ -48,54 +71,59 @@我们不仅记得地心说曾经存在,也记得它为什么会被相信、在什么时代被接受,又是如何被新的观测、理论与证据一步步修正和取代。因为一个真实的世界,需要记录的从来不只是「什么是正确的」,它还需要记录:我们曾经相信什么,又是如何走到今天的。-知识不是一张静止的事实表,而是一段不断发生的历史。-因此,在「乌托邦」中,一条知识不会因为新的事实出现便被简单覆盖或删除。系统会记录它何时被摄入、何时发生变更、在现实世界中的有效时间,以及我们在什么时候获知了这一变化。于是,我们不仅可以问「现在什么是真的?」,还可以追问:-> 「当时我们认为什么是真的?」-> 「这件事从什么时候起成立?」-> 「我们又是什么时候知道它变了?」+```+「当时我们认为什么是真的?」+「这件事从什么时候起成立?」+「我们又是什么时候知道它变了?」+```只有保存这些变化,知识才能真正参与历史进程的演绎。在工程上,我们称之为**双时态知识图谱(Bitemporal Knowledge Graph)**。-### 理想演绎(Law of Deduction)+### ⛵ 理想演绎(Law of Deduction)++> **从「理解现在」,进一步走向「推演未来」。**拉普拉斯曾设想:如果存在一个足够强大的智能,能够在某一瞬间知晓宇宙中所有粒子的状态,以及支配它们运动的全部规律,那么理论上,它便可以推演整个宇宙的过去与未来。这意味着,它不仅能够预测星辰的运行,也能够推演此刻正在编写 README 的我在想什么,以及正在阅读 README 的你,下一秒又会产生怎样的念头。在我们的「乌托邦」中,我们试图以一种工程化的方式逼近这一理想:通过前向链(Forward Chaining)驱动事实不断演绎,以符号系统表达规则、状态与因果关系,再辅以大语言模型处理难以被完全形式化的推理过程。如果能够掌握足够多的事实、规则与因果关系,我们或许可以让系统从「理解现在」,进一步走向「推演未来」。-### 世界铁律(The Iron Law)+### ⚖️ 世界铁律(The Iron Law)++> **让规则托住智能,让逻辑约束行动。**理想乡并不意味着随心所欲。恰恰相反,在这里,一切行为都应当运行于规律、规则与边界之内。我们最不希望看到的,是大模型的幻觉、人为疏忽或推理偏差,最终演变成逻辑错误、越权操作,甚至不可逆的错误执行。-因此,在「乌托邦」中,Agent 的判断并不天然等于行动。任何对下游服务的调用,在真正执行之前,都必须经过本体规则、约束条件与符号逻辑的共同校验:它是否符合事实?是否满足前置条件?是否拥有相应权限?是否触碰既定边界?其结果是否与当前世界状态相容?+因此,在「乌托邦」中,Agent 的判断并不天然等于行动。任何对下游服务的调用,在真正执行之前,都必须经过本体规则、约束条件与符号逻辑的共同校验:++```+它是否符合事实? 是否满足前置条件?+是否拥有相应权限? 是否触碰既定边界?+ 其结果是否与当前世界状态相容?+```只有通过这些规则,推理才能成为行动。大模型可以大胆思考,但执行必须克制;Agent 可以探索未知,但不能越过世界的铁律。让规则托住智能,让逻辑约束行动。-加油,Agent。-稳稳地接住每一个任务,也稳稳地守住每一道边界。+> 加油,Agent。+> 稳稳地接住每一个任务,也稳稳地守住每一道边界。## 功能系统的主体是一个二进制文件加一个 Postgres。我们通过引入 pgvector 和队列表设计,减轻了技术栈和服务依赖的负担 —— 部署时可以松口气。-**摄入:**支持 PDF、DOCX、PPTX、XLSX/XLS/ODS、CSV/TSV、Markdown、HTML 和纯文本,自动识别中文编码。网页和 RSS 可按 cron 定时同步,也可以通过来源级 ingest token 从任何地方推送文档。解析失败的文档可以原地重处理,无需重新上传;整个来源或整个知识库也可以批量重抽。--**搜索与对话:**混合检索采用 Tantivy 全文搜索和 pgvector 向量搜索,并通过 RRF 融合结果;中文全文检索使用 jieba 分词。回答支持流式输出和引用角标,点击引用可直接跳到原文段落。LLM 走 OpenAI 兼容协议,DeepSeek、Qwen、GLM、Ollama、vLLM 都可以接入,整套系统也可以运行在完全内网环境。--**本体与冷启动:**建库即自带一套内置本体(人、组织、项目、产品、事件、概念、地点,及其间的关系),无需先设计模型就能开始摄入。抽取过程中遇到本体之外的类型与谓语,会被记录并计数;高频项可由模型给出扩充建议,确认后并入本体。本体因此随语料生长,而不是要求你在第一天就把世界定义完整。--**双时态图谱:**基于可编辑的本体进行 LLM 抽取,生成实体与事实。每条事实都带有效区间与对应的证据行。修正事实时不会覆盖旧版本,而是闭合旧事实并链上新版本。图谱与邻域查询都可以指定任意历史时点回读。实体面板同时展示两条时间线:一件事在现实中何时成立,以及系统何时形成这一判断、又何时改变判断。--**实体消解与审核:**采用三段式实体消解,每一次合并都会写入日志,并且可以撤销。低置信抽取、待合并候选和基数冲突会进入审核队列,不会打断使用者。手工确认、驳回或闭合事实时,所有决策都会留痕。--**推理与派生:**规则以时态 Datalog 表达,通过前向链驱动事实不断演绎。派生出的事实与抽取事实一样带有效时间与来源,并可展开完整的推导路径——每一条结论都能追问「为什么」,一路回溯到最初的原文。本体公理(类型继承、关系层级、传递、对称、互逆、互斥、基数)同样编译为规则参与推理,约束违例进入冲突队列。--**基于本体的智能问数:**在系统层注册一次 Postgres 连接,再挂载到知识库,对话就可以同时查询文档和数据库。这条路线的方法([Ontology2SQL](https://github.com/deeplethe/ontology2sql))在 BIRD Mini-Dev 上取得 SQLite 70.20 / PostgreSQL 65.80,两项均为当前 SOTA,分别领先第二名 12.2 与 9.0 分([榜单提交](https://github.com/bird-bench/bird-bench.github.io/pull/218))。--**多用户与权限:**权限以知识库为单位,每个库有自己的成员与角色,公共库对部署内所有人可读,私有库仅受邀用户可访问。部署后会自动建立全员可读的公共空间(General Knowledge Base)。+| | |+|---|---|+| **摄入** | 支持 PDF、DOCX、PPTX、XLSX/XLS/ODS、CSV/TSV、Markdown、HTML 和纯文本,自动识别中文编码。网页和 RSS 可按 cron 定时同步,也可以通过来源级 ingest token 从任何地方推送文档。解析失败的文档可以原地重处理,无需重新上传;整个来源或整个知识库也可以批量重抽。 |+| **搜索与对话** | 混合检索采用 Tantivy 全文搜索和 pgvector 向量搜索,并通过 RRF 融合结果;中文全文检索使用 jieba 分词。回答支持流式输出和引用角标,点击引用可直接跳到原文段落。LLM 走 OpenAI 兼容协议,DeepSeek、Qwen、GLM、Ollama、vLLM 都可以接入,整套系统也可以运行在完全内网环境。 |+| **本体与冷启动** | 建库即自带一套内置本体(人、组织、项目、产品、事件、概念、地点,及其间的关系),无需先设计模型就能开始摄入。抽取过程中遇到本体之外的类型与谓语,会被记录并计数;高频项可由模型给出扩充建议,确认后并入本体。本体因此随语料生长,而不是要求你在第一天就把世界定义完整。 |+| **双时态图谱** | 基于可编辑的本体进行 LLM 抽取,生成实体与事实。每条事实都带有效区间与对应的证据行。修正事实时不会覆盖旧版本,而是闭合旧事实并链上新版本。图谱与邻域查询都可以指定任意历史时点回读。实体面板同时展示两条时间线:一件事在现实中何时成立,以及系统何时形成这一判断、又何时改变判断。 |+| **实体消解与审核** | 采用三段式实体消解,每一次合并都会写入日志,并且可以撤销。低置信抽取、待合并候选和基数冲突会进入审核队列,不会打断使用者。手工确认、驳回或闭合事实时,所有决策都会留痕。 |+| **推理与派生** | 规则以时态 Datalog 表达,通过前向链驱动事实不断演绎。派生出的事实与抽取事实一样带有效时间与来源,并可展开完整的推导路径——每一条结论都能追问「为什么」,一路回溯到最初的原文。本体公理(类型继承、关系层级、传递、对称、互逆、互斥、基数)同样编译为规则参与推理,约束违例进入冲突队列。 |+| **基于本体的智能问数** | 在系统层注册一次 Postgres 连接,再挂载到知识库,对话就可以同时查询文档和数据库。这条路线的方法([Ontology2SQL](https://github.com/deeplethe/ontology2sql))在 BIRD Mini-Dev 上取得 SQLite 70.20 / PostgreSQL 65.80,两项均为当前 SOTA,分别领先第二名 12.2 与 9.0 分([榜单提交](https://github.com/bird-bench/bird-bench.github.io/pull/218))。 |+| **多用户与权限** | 权限以知识库为单位,每个库有自己的成员与角色,公共库对部署内所有人可读,私有库仅受邀用户可访问。部署后会自动建立全员可读的公共空间(General Knowledge Base)。 |+| **决策台账** | 事实的确认与驳回、实体合并与撤销、图谱重建等操作均留有记录,含操作者、时间与当时的对象快照;对象被作废或重建后,记录依然可查。 |-**决策台账:**事实的确认与驳回、实体合并与撤销、图谱重建等操作均留有记录,含操作者、时间与当时的对象快照;对象被作废或重建后,记录依然可查。## 快速开始@@ -107,7 +135,7 @@ cd utopiadocker compose --profile app up -d```-打开 http://localhost:8080 注册 —— 第一个账号即管理员,公共知识库 `General` 会一并建好。然后在设置里填一个 OpenAI 兼容端点,把文件拖进去。+打开 http://localhost:1516 注册 —— 第一个账号即管理员,公共知识库 `General` 会一并建好。然后在设置里填一个 OpenAI 兼容端点,把文件拖进去。这会从 `ghcr.io/deeplethe/utopia` 拉预构建镜像。上传的原始文件与全文索引在 `./data`,备份时和数据库一起带上。改了代码、或者想跑未发布的版本,则从源码构建:@@ -121,7 +149,7 @@ docker compose -f docker-compose.yml -f docker-compose.build.yml --profile app u# 1. 启动数据库(pgvector 版 Postgres)docker compose up -d db-# 2. 启动后端(自动跑迁移,默认 :8080)+# 2. 启动后端(自动跑迁移,默认 :1516)cargo run -p utopia-server# 3. 启动前端(:5173,/api 代理到后端)@@ -135,7 +163,7 @@ cd web && pnpm install && pnpm dev| 变量 | 默认值 | 用途 ||---|---|---|| `UTOPIA_DATABASE_URL` | `postgres://utopia:utopia@localhost:5432/utopia` | Postgres 连接串 |-| `UTOPIA_BIND_ADDR` | `0.0.0.0:8080` | 监听地址 |+| `UTOPIA_BIND_ADDR` | `0.0.0.0:1516` | 监听地址 || `UTOPIA_JWT_SECRET` | `dev-secret-change-me` | **生产环境必须修改** || `UTOPIA_WEB_DIST` | `web/dist` | 前端构建产物;存在时由服务端托管 SPA || `UTOPIA_DATA_DIR` | `data` | 原始文件与全文索引 |diff --git a/crates/utopia-core/src/config.rs b/crates/utopia-core/src/config.rsindex fd6793b3..770abd9e 100644--- a/crates/utopia-core/src/config.rs+++ b/crates/utopia-core/src/config.rs@@ -31,7 +31,7 @@ impl Default for AppConfig {Self {database_url: "postgres://utopia:utopia@localhost:5432/utopia".into(),migration_url: None,- bind_addr: "0.0.0.0:8080".into(),+ bind_addr: "0.0.0.0:1516".into(),jwt_secret: "dev-secret-change-me".into(),web_dist: "web/dist".into(),data_dir: "data".into(),diff --git a/docker-compose.yml b/docker-compose.ymlindex 3b071667..adb747a7 100644--- a/docker-compose.yml+++ b/docker-compose.yml@@ -41,7 +41,7 @@ services:# 是因为那种嵌套替换没人读得懂,出错了也查不出来。UTOPIA_DATABASE_URL: ${UTOPIA_DATABASE_URL:-postgres://utopia:${UTOPIA_DB_PASSWORD:-utopia}@db:5432/utopia}UTOPIA_MIGRATION_URL: ${UTOPIA_MIGRATION_URL:-}- UTOPIA_BIND_ADDR: 0.0.0.0:8080+ UTOPIA_BIND_ADDR: 0.0.0.0:1516UTOPIA_JWT_SECRET: ${UTOPIA_JWT_SECRET:-please-change-me-in-production}UTOPIA_WEB_DIST: /app/web-distUTOPIA_DATA_DIR: /app/data@@ -55,7 +55,7 @@ services:# 备份 = 这个目录 + 数据库。- ./data:/app/dataports:- - "8080:8080"+ - "1516:1516"depends_on:db:condition: service_healthydiff --git a/docker/Dockerfile b/docker/Dockerfileindex 47f36a3f..7c5f4a71 100644--- a/docker/Dockerfile+++ b/docker/Dockerfile@@ -29,5 +29,5 @@ WORKDIR /appCOPY --from=build /src/target/release/utopia-server /usr/local/bin/utopia-serverCOPY --from=web /src/dist /app/web-distENV UTOPIA_WEB_DIST=/app/web-dist-EXPOSE 8080+EXPOSE 1516CMD ["utopia-server"]diff --git a/scripts/smoke.sh b/scripts/smoke.shindex c08bc439..81e558d1 100644--- a/scripts/smoke.sh+++ b/scripts/smoke.sh@@ -1,10 +1,10 @@#!/usr/bin/env bash# 端到端冒烟测试:注册 → 登录态 → 工作区 → 知识库 → 权限 → 任务队列-# 用法: ./scripts/smoke.sh [BASE_URL] (默认 http://localhost:8080)+# 用法: ./scripts/smoke.sh [BASE_URL] (默认 http://localhost:1516)# JSON body 走临时文件,避免 Windows shell 的编码转换问题。set -euo pipefail-BASE="${1:-http://localhost:8080}"+BASE="${1:-http://localhost:1516}"EMAIL="smoke-$(date +%s)@test.local"JAR="$(mktemp)"BODY="$(mktemp)"diff --git a/web/vite.config.ts b/web/vite.config.tsindex 3dfe10fc..97c5dbb2 100644--- a/web/vite.config.ts+++ b/web/vite.config.ts@@ -8,8 +8,8 @@ export default defineConfig({// 多会话并行开发:PORT 由启动器分配(5173 被占时换口),未设时保持默认port: process.env.PORT ? Number(process.env.PORT) : 5173,proxy: {- // 后端端口可用 UTOPIA_DEV_API 覆盖(默认 18080,与 .env 的 UTOPIA_BIND_ADDR 一致)- "/api": process.env.UTOPIA_DEV_API ?? "http://127.0.0.1:18080",+ // 后端端口可用 UTOPIA_DEV_API 覆盖(默认 1516,与 .env 的 UTOPIA_BIND_ADDR 一致)+ "/api": process.env.UTOPIA_DEV_API ?? "http://127.0.0.1:1516",},},});