Skip to content

World's first open-source enterprise world model.

Move the default port from 8080 to 1516 (#52)

WaylandYang7e9a464a172f
diff --git a/.env.example b/.env.example
index 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.yml
index 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; fi
sleep 2
done
- 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; fi
sleep 2
done
@@ -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" ]; then
diff --git a/README.md b/README.md
index 51616fde..e9603fcc 100644
--- a/README.md
+++ b/README.md
@@ -49,7 +49,7 @@ cd utopia
docker 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 pgvector
docker compose up -d db
-# 2. Backend on :8080 — runs migrations on startup
+# 2. Backend on :1516 — runs migrations on startup
cargo 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.md
index 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 utopia
docker 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.rs
index 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.yml
index 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:1516
UTOPIA_JWT_SECRET: ${UTOPIA_JWT_SECRET:-please-change-me-in-production}
UTOPIA_WEB_DIST: /app/web-dist
UTOPIA_DATA_DIR: /app/data
@@ -55,7 +55,7 @@ services:
# 备份 = 这个目录 + 数据库。
- ./data:/app/data
ports:
- - "8080:8080"
+ - "1516:1516"
depends_on:
db:
condition: service_healthy
diff --git a/docker/Dockerfile b/docker/Dockerfile
index 47f36a3f..7c5f4a71 100644
--- a/docker/Dockerfile
+++ b/docker/Dockerfile
@@ -29,5 +29,5 @@ WORKDIR /app
COPY --from=build /src/target/release/utopia-server /usr/local/bin/utopia-server
COPY --from=web /src/dist /app/web-dist
ENV UTOPIA_WEB_DIST=/app/web-dist
-EXPOSE 8080
+EXPOSE 1516
CMD ["utopia-server"]
diff --git a/scripts/smoke.sh b/scripts/smoke.sh
index 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.ts
index 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",
},
},
});