KTH 全栈 AI 开发指引

基于 DeepSeek Harness（DSH）· 一切皆插件 的企业级 AGI 平台开发手册。 从拉取基座，到跑通一个「前端业务应用 + 后台管理配置 + DSH 运行时」的业务插件，一条链路讲清。 参考实现：bus-yyjz-agents（永盈子智能体平台）。

DSH 底座 四组件：kth-runtime / kth-infra / kth-base / kth-bus patch.yaml 装配 本地 localhost:3080

章节目录#

1 · 概览与架构
KTH 是什么、四平台与四组件、为什么「不另起平台」。
2 · 核心概念
插件、cordis.patch.yml、装配 id 与访问路径、lib 构建产物。
3 · 环境准备
Node / pnpm 版本、GitLab 地址、目录约定与代理。
4 · 快速开始
拉基座 + 拉模板 → 各仓库 install/build → patch → 启动 → 访问。
5 · 按需拉取插件
配置中心 / 数据库 / 权限 / 认证，需要什么拉什么。
6 · 最小 patch 与访问
单页面开发只需三行；访问 localhost:3080/<路径> 的规则。
7 · 业务插件开发（模板）
以 bus-yyjz-agents 为模板：目录、路由、领域表、运行时装配。
8 · DSH 运行时能力
ctx.agents / llm / tools / skills / mcp / subagents / jobs 映射。
9 · 配置与凭据
台账 > 代码缺省；环境变量不参与业务配置；凭据红线。
10 · 打包发布与 FAQ
四组件打包、交付与现场常见问题。

五分钟跑起来#

先建立目录约定：把基座与插件放在同一个父目录下，patch 里的相对路径才成立。

bash拉取基座与模板插件
# 1) 建立工作目录
mkdir -p ~/kth && cd ~/kth

# 2) 拉取 KTH 基座（DSH）
git clone http://123.60.59.128:8888/kunlun/harnessagentvm/kth.git

# 3) 拉取业务插件模板（永盈子智能体平台）
git clone http://123.60.59.128:8888/kunlun/harnessagentvm/global-plugins/bus-yyjz-agents.git
bash分别构建（每个仓库内各跑一次）
# 基座
cd kth && pnpm install && pnpm run build

# 业务插件模板
cd ../bus-yyjz-agents && pnpm install && pnpm run build
powershell准备 patch 并启动（Windows / PowerShell）
# 用 kth-deploys 的本地覆盖层（或按第 6 章建一个最小 patch）
$env:DSH_HOME = "$HOME\kth\.dsh-home"
cd $HOME\kth\kth
pnpm dsh web --patch "$HOME\kth\kth-deploys\local-dev\dev-plugins.patch.yml" --no-open

# 浏览器打开
#   http://localhost:3080/            平台首页
#   http://localhost:3080/bus-yyjz-agents/   本插件「业务前台」
关于访问路径

patch 行的 id 是装配标识（通常等于包名，如 kth-bus-yyjz-agents）； 页面 URL 由插件自己注册（如注册 /bus-yyjz-agents/）。 因此访问的是 localhost:3080/bus-yyjz-agents/，而不是 id。详见第 6 章。

仓库清单（速查）#

用途仓库地址（GitLab 123.60.59.128:8888）
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
从第 4 章开始

想直接动手？按 4 · 快速开始 逐步执行； 只想做一个页面？看 6 · 最小 patch 与访问。