diff --git a/.nvmrc b/.nvmrc
new file mode 100644
index 000000000..2bd5a0a98
--- /dev/null
+++ b/.nvmrc
@@ -0,0 +1 @@
+22
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 2cbd15a44..8b6fe16d0 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -41,9 +41,9 @@ This keeps Docker simple while still isolating schema and data.
 
 ## Prerequisites
 
-- Node.js `v20+`
-- `pnpm` `v10.28+`
-- Go `v1.26+`
+- Node.js `22`
+- `pnpm` `10.28.2`
+- Go `1.26.1`
 - Docker
 
 ## Important Rules
diff --git a/README.md b/README.md
index 4bef6f573..14534157a 100644
--- a/README.md
+++ b/README.md
@@ -221,7 +221,7 @@ Installing and authenticating them: [Install an agent runtime](https://multica.a
 
 Contributors: start with the [Contributing Guide](CONTRIBUTING.md).
 
-**Prerequisites:** [Node.js](https://nodejs.org/) v20+, [pnpm](https://pnpm.io/) v10.28+, [Go](https://go.dev/) v1.26+, [Docker](https://www.docker.com/)
+**Prerequisites:** [Node.js](https://nodejs.org/) 22, [pnpm](https://pnpm.io/) 10.28.2, [Go](https://go.dev/) 1.26.1, [Docker](https://www.docker.com/)
 
 ```bash
 make dev
diff --git a/README.zh.md b/README.zh.md
index b0ffbe197..b989b2e4e 100644
--- a/README.zh.md
+++ b/README.zh.md
@@ -213,7 +213,7 @@ Multica 不自带模型。它驱动的是你本来就装好、登录好的那些
 
 想参与贡献，先看[贡献指南](CONTRIBUTING.md)。
 
-**环境要求：**[Node.js](https://nodejs.org/) v20+、[pnpm](https://pnpm.io/) v10.28+、[Go](https://go.dev/) v1.26+、[Docker](https://www.docker.com/)
+**环境要求：**[Node.js](https://nodejs.org/) 22、[pnpm](https://pnpm.io/) 10.28.2、[Go](https://go.dev/) 1.26.1、[Docker](https://www.docker.com/)
 
 ```bash
 make dev
diff --git a/SELF_HOSTING_ADVANCED.md b/SELF_HOSTING_ADVANCED.md
index b74780a99..3952aa2e3 100644
--- a/SELF_HOSTING_ADVANCED.md
+++ b/SELF_HOSTING_ADVANCED.md
@@ -312,7 +312,7 @@ If you are upgrading from a binary that pre-dates MUL-2957 (or the auto-hook fai
 
 If you prefer to build and run services manually:
 
-**Prerequisites:** Go 1.26+, Node.js 20+, pnpm 10.28+, PostgreSQL 17 with pgvector.
+**Prerequisites:** Go 1.26.1, Node.js 22, pnpm 10.28.2, PostgreSQL 17 with pgvector.
 
 ```bash
 # Start your PostgreSQL (or use: docker compose up -d postgres)
diff --git a/package.json b/package.json
index 4157e1668..c31116a20 100644
--- a/package.json
+++ b/package.json
@@ -27,6 +27,9 @@
     "ui:add": "cd packages/ui && npx shadcn@latest add",
     "generate:reserved-slugs": "node scripts/generate-reserved-slugs.mjs"
   },
+  "engines": {
+    "node": ">=22"
+  },
   "packageManager": "pnpm@10.28.2",
   "pnpm": {
     "onlyBuiltDependencies": [
diff --git a/scripts/dev.sh b/scripts/dev.sh
index 71089542e..bc534c994 100755
--- a/scripts/dev.sh
+++ b/scripts/dev.sh
@@ -13,7 +13,7 @@ command -v docker >/dev/null 2>&1 || missing+=("docker")
 
 if [ ${#missing[@]} -gt 0 ]; then
   echo "✗ Missing prerequisites: ${missing[*]}"
-  echo "  Please install: Node.js v20+, pnpm v10.28+, Go v1.26+, Docker"
+  echo "  Please install: Node.js 22, pnpm 10.28.2, Go 1.26.1, Docker"
   exit 1
 fi