3 · 环境准备

动手前只需备好三样：Node、pnpm、Git；再确认目录约定、端口与网络。命令以 Windows / PowerShell 为主，附 Linux / macOS 版本。

前置一览

Node ≥ 22.19（建议 22.x LTS）、pnpm、Git，且能访问 GitLab 123.60.59.128:8888。本页末尾有验证清单，全部通过再进入第 4 章。

Node#

构建与运行都依赖 Node。建议 22.x LTS，最低 22.19；更高的 24.x 也可用（本机实测 v24 正常）。

powershellWindows · 安装与验证

# 从 https://nodejs.org/ 下载 22.x LTS 的 .msi，安装时勾选 "Add to PATH"
# 装完重开一个终端，再验证：
node -v      # 期望 v22.x（或 v24.x）
npm -v

bashLinux / macOS · 用 nvm 安装

# 推荐用 nvm 管理，避免动系统自带 Node
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# 重开终端后
nvm install 22
nvm use 22
node -v

老系统：CentOS 7 / glibc 2.17

官方 nodejs.org/dist 的 Linux 包要求 glibc ≥ 2.28，在 CentOS 7 上跑不起来。改用 unofficial-builds 的 glibc-217 版本：

bashCentOS 7 · 手工装 Node 22（glibc-217 版）

wget https://unofficial-builds.nodejs.org/download/release/v22.23.3/node-v22.23.3-linux-x64-glibc-217.tar.xz
tar -Jxf node-v22.23.3-linux-x64-glibc-217.tar.xz
mv node-v22.23.3-linux-x64-glibc-217 /usr/local/node22

echo 'export PATH=/usr/local/node22/bin:$PATH' >> /etc/profile
source /etc/profile

node -v
npm -v

注意：自动装包脚本拼的是 node-v<版本>-linux-<arch>.tar.gz（不带 -glibc-217 后缀），所以这类老系统只能按上面手工装；sudo 默认重置 PATH，若仍报缺 node，把 node/npm 软链到 /usr/local/bin 或用 sudo -E。

pnpm#

bash全局安装并验证

npm i -g pnpm
pnpm -v

bashLinux：权限不足时用 sudo

sudo npm i -g pnpm
pnpm -v

PATH 注意

Windows 上全局安装的 pnpm 落在 npm 全局目录（通常是 %AppData%\npm）。若 pnpm -v 报「命令不存在」，把该目录加入 PATH 后重开终端； Linux/macOS 同理，确认全局 bin 目录在 PATH 中。

Git 与 GitLab#

KTH 全部代码托管在 GitLab，基座地址 http://123.60.59.128:8888，命名空间 kunlun/harnessagentvm。

bash验证 Git 与仓库可达

git --version
git ls-remote http://123.60.59.128:8888/kunlun/harnessagentvm/kth.git HEAD

常用仓库：

KTH 基座（DSH 运行时）kunlun/harnessagentvm/kth.git

业务插件模板（永盈子智能体）kunlun/harnessagentvm/global-plugins/bus-yyjz-agents.git

配置中心（台账）kunlun/harnessagentvm/global-plugins/infra-configmanagement.git

数据库连接池kunlun/harnessagentvm/global-plugins/infra-database/infra-database-postgresql.git

账号 / 角色 / 菜单kunlun/harnessagentvm/global-plugins/base-permission.git

会话认证kunlun/harnessagentvm/global-plugins/infra-auth.git

目录约定 · 磁盘与端口#

基座与插件放在同一个父目录下，patch 里的相对路径（../../Infrastructure/...）才成立；结构与第 4 章一致：

text推荐工作目录

kth/
├── kth/                    # KTH 基座（DSH 运行时）
├── bus-yyjz-agents/        # 业务插件（模板）
├── infra-configmanagement/ # 按需：配置中心
├── infra-database-postgresql/
├── base-permission/
└── kth-deploys/            # 部署与本地覆盖层（local-dev/dev-plugins.patch.yml）

项	说明
磁盘	基座与各插件都要跑 `pnpm install`，`node_modules` 体积不小，建议预留数 GB。
端口（本地开发）	默认 `3080`，访问 `http://localhost:3080/`。
端口（测试环境）	`3081`，与生产错开，可同机并存。
端口（生产环境）	`3080`。

网络 / 代理（可选）#

GitLab 是内网地址，通常直连即可、无需代理。代理只在直连 GitHub 不稳定（如拉取 DSH 上游）时用。

bash单条命令走本地代理

git -c http.proxy=http://127.0.0.1:33210 -c https.proxy=http://127.0.0.1:33210 clone https://github.com/deepseek-ai/deepseek-harness.git

powershellWindows · 让 npm / pnpm 走代理

$env:HTTP_PROXY  = "http://127.0.0.1:33210"
$env:HTTPS_PROXY = "http://127.0.0.1:33210"

bashLinux / macOS

export HTTP_PROXY=http://127.0.0.1:33210
export HTTPS_PROXY=http://127.0.0.1:33210

提示

上面的 33210 是示例端口，换成你自己的本地代理端口即可；用不上代理就别设置，避免影响内网仓库访问。

验证清单#

全部满足后再进入 4 · 快速开始：

检查项	命令	期望输出
Node 版本	node -v	`v22.19.0` 及以上（或 v24.x）
npm 可用	npm -v	打印版本号
pnpm 可用	pnpm -v	打印版本号
Git 可用	git --version	`git version 2.x`
GitLab 可达	git ls-remote .../kth.git HEAD	列出一行 ref，且无认证错误
端口空闲	netstat -ano \| findstr :3080	无占用（Linux：`ss -ltnp \| grep 3080`）

下一步

环境就绪，去 4 · 快速开始拉取基座与模板插件，跑通第一个业务插件。