Open-source LLM knowledge platform: turn raw documents into a queryable RAG, an autonomous reasoning agent, and a self-maintaining Wiki.
Go agentagenticaichatbotdsh-pluginembeddingsevaluationgenerative-aigolangknowledge-basellmmulti-tenantollamaopenaiquestion-answeringragrerankingsemantic-searchvector-searchwiki
fix(deploy): bump paradedb image to v0.25.11-pg17 (#4120)
LuckVd3c36cb19a2bb
diff --git a/docker-compose.dev.yml b/docker-compose.dev.ymlindex 39f9031b5..014404ede 100644--- a/docker-compose.dev.yml+++ b/docker-compose.dev.yml@@ -2,7 +2,7 @@services:# 只启动依赖的基础设施服务postgres:- image: paradedb/paradedb:v0.22.6-pg17+ image: paradedb/paradedb:v0.25.11-pg17container_name: WeKnora-postgres-devports:- "${DB_PORT:-5432}:5432"@@ -382,7 +382,7 @@ services:# ---------------------------------------------------------------------------# 复用 dev 已有的 ParadeDB 镜像,不额外拉 postgres 镜像langfuse-db-init:- image: paradedb/paradedb:v0.22.6-pg17+ image: paradedb/paradedb:v0.25.11-pg17container_name: WeKnora-langfuse-db-init-devdepends_on:postgres:diff --git a/docker-compose.yml b/docker-compose.ymlindex cfd23f4ab..dcf5539eb 100644--- a/docker-compose.yml+++ b/docker-compose.yml@@ -541,7 +541,7 @@ services:# 修改的PostgreSQL配置postgres:- image: paradedb/paradedb:v0.22.6-pg17+ image: paradedb/paradedb:v0.25.11-pg17container_name: WeKnora-postgresenvironment:- POSTGRES_USER=${DB_USER}@@ -819,7 +819,7 @@ services:# 一次性初始化脚本:在已有的 WeKnora-postgres 里创建 langfuse 数据库(幂等,数据库已存在则跳过)# 复用 WeKnora-postgres 的 ParadeDB 镜像,避免多拉一个 postgres 镜像langfuse-db-init:- image: paradedb/paradedb:v0.22.6-pg17+ image: paradedb/paradedb:v0.25.11-pg17container_name: WeKnora-langfuse-db-initdepends_on:postgres:diff --git a/internal/application/repository/chunk_image_assets_test.go b/internal/application/repository/chunk_image_assets_test.goindex ec938497a..d21fb42f6 100644--- a/internal/application/repository/chunk_image_assets_test.go+++ b/internal/application/repository/chunk_image_assets_test.go@@ -20,7 +20,7 @@ import (// both spellings need the same assertions. For example://// docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \-// paradedb/paradedb:v0.22.6-pg17+// paradedb/paradedb:v0.25.11-pg17// WEKNORA_REPOSITORY_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable//// Both runs apply the real chunk_images migration, so the triggers and thediff --git a/internal/database/migration_postgres_test.go b/internal/database/migration_postgres_test.goindex 575dae01e..e735f0a1e 100644--- a/internal/database/migration_postgres_test.go+++ b/internal/database/migration_postgres_test.go@@ -18,7 +18,7 @@ import (// at a disposable database, for example://// docker run -d --rm -e POSTGRES_PASSWORD=pg -e POSTGRES_DB=weknora -p 55432:5432 \-// paradedb/paradedb:v0.22.6-pg17+// paradedb/paradedb:v0.25.11-pg17// WEKNORA_MIGRATION_TEST_POSTGRES_DSN=postgres://postgres:pg@localhost:55432/weknora?sslmode=disable//// It checks what SQLite cannot: that 000106 builds its index CONCURRENTLYdiff --git a/migrations/versioned/000099_pg_search_0226.up.sql b/migrations/versioned/000099_pg_search_0226.up.sqlindex c1a257d2a..7c3a26f4c 100644--- a/migrations/versioned/000099_pg_search_0226.up.sql+++ b/migrations/versioned/000099_pg_search_0226.up.sql@@ -21,6 +21,15 @@ BEGINSELECT 1 FROM pg_available_extension_versionsWHERE name = 'pg_search' AND version = '0.22.6') THEN+ -- Newer images only ship the latest install script; 000115 upgrades+ -- them directly. Updating the catalog to 0.22.6 there would mismatch+ -- the shared library.+ IF EXISTS (+ SELECT 1 FROM pg_available_extension_versions+ WHERE name = 'pg_search' AND version = '0.25.11'+ ) THEN+ RETURN;+ END IF;RAISE NOTICE 'pg_search 0.22.6 is not available; update the server image and run ALTER EXTENSION pg_search UPDATE TO ''0.22.6'' manually';RETURN;END IF;diff --git a/migrations/versioned/000115_pg_search_02511.down.sql b/migrations/versioned/000115_pg_search_02511.down.sqlnew file mode 100644index 000000000..18f51c6d7--- /dev/null+++ b/migrations/versioned/000115_pg_search_02511.down.sql@@ -0,0 +1,2 @@+-- No-op: extension SQL upgrades cannot be reversed by a schema rollback.+-- Restore a pre-upgrade database backup together with the matching old image.diff --git a/migrations/versioned/000115_pg_search_02511.up.sql b/migrations/versioned/000115_pg_search_02511.up.sqlnew file mode 100644index 000000000..12ea9ce43--- /dev/null+++ b/migrations/versioned/000115_pg_search_02511.up.sql@@ -0,0 +1,34 @@+-- Complete the SQL side of the ParadeDB v0.22.x -> v0.25.11 image upgrade.+-- A catalog left at an older version than the server's shared library can+-- crash the whole server when its SQL functions are called (for example+-- paradedb.version_info()), so the catalog must follow the image.+DO $$+DECLARE+ search_version TEXT;+ vector_version TEXT;+BEGIN+ IF current_setting('app.skip_embedding', true) = 'true' THEN+ RETURN;+ END IF;++ -- Leave absent extensions and other release lines under operator control.+ -- Do not downgrade a newer extension or upgrade an external server to its+ -- potentially incompatible default version.+ SELECT extversion INTO search_version FROM pg_extension WHERE extname = 'pg_search';+ IF search_version ~ '^0\.(22|23|24|25)\.[0-9]+$' AND search_version <> '0.25.11'+ AND EXISTS (+ SELECT 1 FROM pg_available_extension_versions+ WHERE name = 'pg_search' AND version = '0.25.11'+ ) THEN+ ALTER EXTENSION pg_search UPDATE TO '0.25.11';+ END IF;++ SELECT extversion INTO vector_version FROM pg_extension WHERE extname = 'vector';+ IF vector_version IN ('0.8.0', '0.8.1', '0.8.2', '0.8.3')+ AND EXISTS (+ SELECT 1 FROM pg_available_extension_versions+ WHERE name = 'vector' AND version = '0.8.4'+ ) THEN+ ALTER EXTENSION vector UPDATE TO '0.8.4';+ END IF;+END $$;diff --git a/scripts/test_paradedb_upgrade.py b/scripts/test_paradedb_upgrade.pyindex 5aa020e37..ca2748fa0 100644--- a/scripts/test_paradedb_upgrade.py+++ b/scripts/test_paradedb_upgrade.py@@ -1,7 +1,7 @@"""Verify a ParadeDB patch upgrade using disposable Docker volumes and real migrations.Requires Python 3 and Docker; no database credentials or running WeKnora needed.-Run: python3 scripts/test_paradedb_upgrade.py+Run: python3 scripts/test_paradedb_upgrade.py [--to 0.25.11|0.22.6]Artifacts (snapshots, plans, logs and a synthetic-data backup) are kept in /tmp."""import argparse@@ -17,6 +17,12 @@ import uuidROOT = pathlib.Path(__file__).resolve().parents[1]OUT = NoneCONTAINER = 'weknora-pdb-upgrade-' + uuid.uuid4().hex[:12]+# target pg_search version -> (image, expected vector version or None if unchanged)+TARGETS = {+ '0.22.6': ('paradedb/paradedb:v0.22.6-pg17', None),+ '0.25.11': ('paradedb/paradedb:v0.25.11-pg17', '0.8.4'),+}+UPGRADES = ['000099_pg_search_0226.up.sql', '000115_pg_search_02511.up.sql']def sql(query, db='weknora'):p = subprocess.run(['docker', 'exec', '-i', CONTAINER, 'psql', '-X', '-qAt', '-U', 'postgres', '-d', db, '-v', 'ON_ERROR_STOP=1'], input=query, text=True, capture_output=True)@@ -126,7 +132,9 @@ def migrate(db, paths, label):with (OUT/(label+'.log')).open('w') as log:for path in paths:log.write(path.name+'\n')- sql('BEGIN;\n'+path.read_text()+'\nCOMMIT;', db)+ text = path.read_text()+ # CONCURRENTLY cannot run in a transaction block; golang-migrate does not add one either.+ sql(text if 'CONCURRENTLY' in text else 'BEGIN;\n'+text+'\nCOMMIT;', db)print(f'{label}: {len(paths)} SQL migrations passed', flush=True)@@ -149,6 +157,7 @@ def main():global OUTparser = argparse.ArgumentParser(description=__doc__)parser.add_argument('--output-dir', type=pathlib.Path)+ parser.add_argument('--to', choices=sorted(TARGETS), default='0.25.11', help='target pg_search version')args = parser.parse_args()OUT = args.output_dir or pathlib.Path(tempfile.mkdtemp(prefix='weknora-pdb-upgrade-'))OUT.mkdir(parents=True, exist_ok=True)@@ -156,19 +165,26 @@ def main():raise RuntimeError('Use an empty output directory')print('Evidence: '+str(OUT), flush=True)volume = CONTAINER+'-data'- old, new = 'paradedb/paradedb:v0.22.2-pg17', 'paradedb/paradedb:v0.22.6-pg17'+ old = 'paradedb/paradedb:v0.22.2-pg17'+ target = args.to+ new, vector_target = TARGETS[target]paths = sorted((ROOT/'migrations/versioned').glob('*.up.sql'))baseline = [p for p in paths if int(p.name.split('_')[0]) < 99]- upgrade = ROOT/'migrations/versioned/000099_pg_search_0226.up.sql'+ upgrade = [ROOT/'migrations/versioned'/name for name in UPGRADES]+ upgrade_sql = '\n'.join(p.read_text() for p in upgrade)+ search_version = "SELECT extversion FROM pg_extension WHERE extname='pg_search'"+ vector_version = "SELECT extversion FROM pg_extension WHERE extname='vector'"# Only resources created by this invocation are ever removed.docker('volume', 'create', volume)try:start(old, volume)migrate('weknora', baseline, 'old-migrations')- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'+ assert sql(search_version) == '0.22.2'+ old_vector = sql(vector_version)# Older external servers without the target package must remain usable.- migrate('weknora', [upgrade], 'unavailable-target')- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'+ migrate('weknora', upgrade, 'unavailable-target')+ assert sql(search_version) == '0.22.2'+ assert sql(vector_version) == old_vectorseed()snapshot('before')with (OUT/'before.dump').open('wb') as backup:@@ -177,12 +193,14 @@ def main():docker('rm', CONTAINER)start(new, volume)# Replacing the image alone leaves the SQL catalog at the old version.- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'- sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade.read_text()+"\nCOMMIT;")- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.2'- migrate('weknora', [upgrade, upgrade], 'extension-upgrade-and-idempotence')- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'") == '0.22.6'- assert sql('SELECT version FROM paradedb.version_info()') == '0.22.6'+ assert sql(search_version) == '0.22.2'+ sql("BEGIN; SET LOCAL app.skip_embedding='true';\n"+upgrade_sql+"\nCOMMIT;")+ assert sql(search_version) == '0.22.2'+ migrate('weknora', upgrade + upgrade, 'extension-upgrade-and-idempotence')+ assert sql(search_version) == target+ assert sql(vector_version) == (vector_target or old_vector)+ # Calls into the shared library crash the server if the catalog lags behind it.+ assert sql('SELECT version FROM paradedb.version_info()') == targetsnapshot('after')docker('restart', '-t', '60', CONTAINER)for _ in range(60):@@ -195,10 +213,10 @@ def main():check_writes()sql('CREATE DATABASE upgrade_fresh TEMPLATE template0')# The new migration must not install pg_search on non-search databases.- migrate('upgrade_fresh', [upgrade], 'absent-extension')- assert sql("SELECT count(*) FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0'+ migrate('upgrade_fresh', upgrade, 'absent-extension')+ assert sql("SELECT count(*) FROM pg_extension WHERE extname IN ('pg_search','vector')", 'upgrade_fresh') == '0'migrate('upgrade_fresh', paths, 'fresh-migrations')- assert sql("SELECT extversion FROM pg_extension WHERE extname='pg_search'", 'upgrade_fresh') == '0.22.6'+ assert sql(search_version, 'upgrade_fresh') == targetsql("INSERT INTO embeddings(source_id,source_type,content,dimension) VALUES ('fresh',0,'新安装检索',1024)", 'upgrade_fresh')assert sql("SELECT count(*) FROM embeddings WHERE content ||| '检索'", 'upgrade_fresh') == '1'print('PASS: fresh install and Chinese BM25 query', flush=True)diff --git a/website-docs/01-getting-started/02-installation.md b/website-docs/01-getting-started/02-installation.mdindex ca86f3ab5..a05182c66 100644--- a/website-docs/01-getting-started/02-installation.md+++ b/website-docs/01-getting-started/02-installation.md@@ -43,7 +43,7 @@ flowchart TB- **源码编译**:Go 1.26(见 `docker/Dockerfile.app` builder 阶段 `golang:1.26-bookworm`)、CGO(依赖 `libsqlite3-dev`)、Node.js + npm(前端)、Python 3.10 + uv(docreader)。- **Kubernetes**:>= 1.25.0(`helm/Chart.yaml`)。-Compose 默认 ParadeDB `v0.22.6-pg17` 的 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2。这不代表所有 ARM CPU 或其他可选服务均兼容。+Compose 默认 ParadeDB 镜像自 `v0.22.6-pg17` 起 x86 CPU 基线为 `x86-64-v2`(包括 SSE4.2、POPCNT),不再强制要求 AVX2;更高镜像版本的基线以 ParadeDB 官方发布说明为准。这不代表所有 ARM CPU 或其他可选服务均兼容。## 一、Docker Compose 标准部署(docker-compose.yml)@@ -88,7 +88,7 @@ docker compose up -d| `frontend` | `wechatopenai/weknora-ui:${WEKNORA_VERSION:-latest}` | `${FRONTEND_PORT:-80}:80` | app(healthy) | Nginx 托管 SPA 并反代到 app;`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远程后端 || `app` | `wechatopenai/weknora-app` | `${APP_PORT:-8080}:8080` | postgres(healthy)、redis、docreader(healthy) | Go 后端;挂载 `./config/config.yaml`、`data-files` 卷;健康检查 `GET /health` || `docreader` | `wechatopenai/weknora-docreader` | 仅 `expose: 50051`(不发布到宿主机) | — | 文档解析 gRPC 服务;健康检查 `grpc_health_probe`;与 app 共享 `docreader-tmp` 卷传递图片 |-| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 |+| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | 不映射宿主端口 | — | ParadeDB = PostgreSQL 17 + BM25/向量扩展,默认检索引擎 || `redis` | `redis:7.0-alpine` | 不映射宿主端口 | — | `--appendonly yes --requirepass ${REDIS_PASSWORD}` |### 可选服务与 profilesdiff --git a/website-docs/01-getting-started/06-paradedb-upgrade.md b/website-docs/01-getting-started/06-paradedb-upgrade.mdindex 53741552a..320e7e6a6 100644--- a/website-docs/01-getting-started/06-paradedb-upgrade.md+++ b/website-docs/01-getting-started/06-paradedb-upgrade.md@@ -1,6 +1,11 @@# ParadeDB 存量库升级-仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.22.6-pg17`。本文处理 **0.22.2 → 0.22.6、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。+仓库的生产与开发 Compose 使用 `paradedb/paradedb:v0.25.11-pg17`。本文处理 **0.22.x → 0.25.11、PostgreSQL 主版本保持 17** 的升级;不适用于 PostgreSQL 跨主版本升级,也不代表 Helm 中其他旧版本可以直接套用。++该版本线相对 `v0.22.6-pg17` 带来 PostgreSQL 17.9 → 17.11、pgvector 0.8.1 → 0.8.4(修复并行 HNSW 构建缓冲区溢出与 HNSW vacuum 期间的索引损坏)以及 pg_search 基于 WAL 的崩溃恢复(0.24.0 起,见 paradedb#4901)。++> [!WARNING]+> 替换镜像后**必须**把扩展 catalog 升级到与镜像一致的版本。catalog 停留在旧版本时,部分扩展 SQL 函数(例如 `paradedb.version_info()`)会因签名与新二进制不匹配而触发段错误,导致整个 PostgreSQL 实例崩溃并进入恢复。也**不要**在新镜像上执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`,它同样会造成上述不匹配。## 升级步骤@@ -31,35 +36,39 @@docker compose up -d --no-deps --wait postgres```-4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。+4. 完成扩展的 SQL 升级。仅替换镜像不会更新已有数据库内的 `pg_extension` 版本。新镜像自带 0.22.x 起的完整升级脚本链,任意 0.22.x 都可以一步升级到镜像默认版本:```bashdocker compose exec -T postgres sh -c 'psql -U "$POSTGRES_USER" -d "$POSTGRES_DB" -v ON_ERROR_STOP=1' <<'SQL'- ALTER EXTENSION pg_search UPDATE TO '0.22.6';+ ALTER EXTENSION pg_search UPDATE;+ ALTER EXTENSION vector UPDATE;SELECT extname, extversion FROM pg_extension WHERE extname IN ('pg_search', 'vector');SELECT * FROM paradedb.version_info();SQL```- 在**其他已安装 `pg_search` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。catalog 与 `paradedb.version_info()` 应均报告 0.22.6。+ 在**其他已安装 `pg_search` 或 `vector` 的数据库**中同样执行,包括安装过该扩展的 `postgres`、模板库或 Langfuse 库。不要为了升级而向原本不需要的数据库安装扩展。`pg_search` 的 catalog 与 `paradedb.version_info()` 应均报告 0.25.11,`vector` 应为 0.8.4。-5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。这个补丁升级无需专门重建全部索引或重新导入文档;保留备份直到验证完成。+5. 恢复原先运行的写入服务,确认数据库迁移状态,执行有代表性的关键词与向量检索。已有的 BM25 与 HNSW 索引在新版本下可继续读写,无需专门重建全部索引或重新导入文档;如遇异常可 `REINDEX`。保留备份直到验证完成。## 自动迁移的范围-迁移 `000099` 仅在 WeKnora 数据库内执行扩展升级:已安装版本须为 0.22.2–0.22.5,且服务器提供 0.22.6 扩展包。它遵守 `app.skip_embedding`,不安装缺失的扩展,也不处理其他版本线。+WeKnora 启动时的迁移只在 WeKnora 数据库内升级扩展,遵守 `app.skip_embedding`,不安装缺失的扩展,也不降级或处理其他版本线:++- `000115`:已安装的 `pg_search` 为 0.22.0–0.25.10 且服务器提供 0.25.11 时,升级到 0.25.11;已安装的 `vector` 为 0.8.0–0.8.3 且服务器提供 0.8.4 时,升级到 0.8.4。+- `000099`:历史迁移,仅在服务器提供 0.22.6 扩展包(即仍使用 `v0.22.6-pg17` 镜像)时把 0.22.2–0.22.5 升级到 0.22.6;新镜像上会跳过,交给 `000115`。-如果这条迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有 `000099` 的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。+如果这些迁移在替换数据库镜像**之前**已经执行,安装新镜像后不会自动再跑一次,需要手动执行上面的 SQL。没有对应迁移的旧应用也需手工升级。其他数据库的扩展不能靠 WeKnora 的迁移代管。## 回滚与复现验证-回滚需要将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更,`000099` 的 down 文件也不会尝试降级扩展。+回滚只能将升级前备份/快照恢复到独立数据卷,配合旧镜像使用。仅把镜像标签改回旧版不会撤销扩展 SQL 变更;而且 pg_search 0.24 起会向 WAL 写入自定义资源管理器记录,旧镜像无法重放这些记录。迁移的 down 文件也不会尝试降级扩展。-仓库提供隔离验证脚本:+仓库提供隔离验证脚本,默认验证 0.22.2 → 0.25.11,也可用 `--to 0.22.6` 验证历史补丁升级:```bashdocker pull paradedb/paradedb:v0.22.2-pg17-docker pull paradedb/paradedb:v0.22.6-pg17+docker pull paradedb/paradedb:v0.25.11-pg17python3 scripts/test_paradedb_upgrade.py```diff --git a/website-docs/02-architecture/01-overview.md b/website-docs/02-architecture/01-overview.mdindex d37691ad0..81ad9fa99 100644--- a/website-docs/02-architecture/01-overview.md+++ b/website-docs/02-architecture/01-overview.md@@ -13,7 +13,7 @@ WeKnora 采用"主服务 + 前端 + 文档解析微服务"的三进程核心架| `app` | `wechatopenai/weknora-app`(`docker/Dockerfile.app`,Go) | `8080` | 主后端:REST API、RAG 检索、Agent 引擎、异步任务 worker、IM/Embed 渠道接入。健康检查 `GET /health` || `frontend` | `wechatopenai/weknora-ui`(`frontend/`,NGINX + Vue3 静态产物) | `80` | Web UI;NGINX 同时充当反向代理,将 `/api` 转发到 `app`(`APP_HOST`/`APP_BACKEND_PORT`/`APP_SCHEME` 可指向远端后端) || `docreader` | `wechatopenai/weknora-docreader`(`docker/Dockerfile.docreader`,Python) | `50051`(仅 compose 网络内 expose,不映射宿主机) | 文档解析微服务:gRPC 服务端,PDF/DOCX/Excel/EPUB/网页等 25+ 格式解析与页面渲染。健康检查 `grpc_health_probe` |-| `postgres` | `paradedb/paradedb:v0.22.6-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) |+| `postgres` | `paradedb/paradedb:v0.25.11-pg17` | `5432`(网络内) | 主数据库。ParadeDB 发行版自带 BM25 全文检索与 pgvector 向量能力,因此**默认部署无需独立向量库**(`RETRIEVE_DRIVER=postgres`) || `redis` | `redis:7.0-alpine`(`appendonly` + `requirepass`) | `6379`(网络内) | Asynq 任务队列、SSE 流管理(跨实例)、system_settings 发布订阅、限流与分布式模型并发闸门 || `sandbox` | `wechatopenai/weknora-sandbox`(`docker/Dockerfile.sandbox`) | — | WeKnora 标准运行镜像;可直接用于空间 Docker 后端,接入 CubeSandbox/E2B 时则通过模板 API 自动注册并用于 Agent Skills |diff --git a/website-docs/06-development/01-dev-guide.md b/website-docs/06-development/01-dev-guide.mdindex 296f3beff..3e81b2cb0 100644--- a/website-docs/06-development/01-dev-guide.md+++ b/website-docs/06-development/01-dev-guide.md@@ -64,7 +64,7 @@ make dev-restart # 重启| 服务 | 镜像 | 端口(默认) | 启动条件 || --- | --- | --- | --- |-| `postgres` | `paradedb/paradedb:v0.22.6-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 |+| `postgres` | `paradedb/paradedb:v0.25.11-pg17`(自带 pg_search/BM25) | `5432` | 默认启动 || `redis` | `redis:7.0-alpine`(`--requirepass`) | `6379` | 默认启动 || `docreader` | 本地构建 `docker/Dockerfile.docreader` | `50051`(gRPC) | 默认启动 || `searxng`(+`searxng-init`) | `searxng/searxng:latest` | `127.0.0.1:8888` | `--searxng` / `--full`(compose profile `searxng`) |diff --git a/website-docs/06-development/02-database-schema.md b/website-docs/06-development/02-database-schema.mdindex 415532f4c..9c1176166 100644--- a/website-docs/06-development/02-database-schema.md+++ b/website-docs/06-development/02-database-schema.md@@ -413,7 +413,7 @@ make migrate-upBM25 索引(`USING bm25`、Lindera 中文分词)只在 ParadeDB 可用;原生 Postgres 部署需保证相应迁移的条件分支生效或改用 Elasticsearch 等外部检索引擎。存量原生 Postgres 库切到 ParadeDB 可参考 `migrations/paradedb/01-migrate-to-paradedb.sql`。-官方镜像自 v0.8.2 起为 `paradedb/paradedb:v0.22.6-pg17`。迁移 000099 只把已安装的 pg_search 0.22.2–0.22.5 升级到 0.22.6:若启动日志提示 `pg_search 0.22.6 is not available`,说明数据库镜像还没换,换镜像后手工执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`;其他版本线不会被自动升级或降级。+官方镜像为 `paradedb/paradedb:v0.25.11-pg17`(v0.8.2 起曾为 `v0.22.6-pg17`)。迁移 000115 在服务器提供对应扩展包时,把已安装的 pg_search 0.22.0–0.25.10 升级到 0.25.11、pgvector 0.8.0–0.8.3 升级到 0.8.4;历史迁移 000099 仅在仍使用 `v0.22.6-pg17` 镜像时生效。其他版本线不会被自动升级或降级。扩展 catalog 必须与镜像版本一致,否则调用部分扩展函数会使数据库崩溃;手工升级见《ParadeDB 存量库升级》,在新镜像上不要执行 `ALTER EXTENSION pg_search UPDATE TO '0.22.6'`。### 版本文件冲突 {#_7-5-版本文件冲突}