KTeam/kt-template-admin
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
KT admin template based on vue-vben-admin 5.6.0
97 Commits 2 Branches 0 Tags 9.1 MiB
TypeScript 55.2%
Vue 40.4%
JavaScript 2%
CSS 1.2%
SCSS 1%
Other 0.2%
abc882f1e6
Go to file
sunlei abc882f1e6 fix: 收敛Markdown编辑器高度
2026-07-01 19:25:29 +08:00
.husky chore: 优化Husky提交钩子 2026-06-05 08:52:54 +08:00
.vscode feat(admin): 精简后台并接入真实接口 2026-05-16 20:14:13 +08:00
apps/web-antdv-next fix: 收敛Markdown编辑器高度 2026-07-01 19:25:29 +08:00
deploy ci: 接入NapCat WebUI网关上游网络 2026-06-24 17:26:33 +08:00
internal chore: 优化Husky提交钩子 2026-06-05 08:52:54 +08:00
packages fix: 修复后台菜单排序生效 2026-06-29 18:06:42 +08:00
skills docs: 更新Admin技能命令命名 2026-06-26 14:56:42 +08:00
.browserslistrc chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.dockerignore chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.editorconfig chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.gitattributes chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.gitconfig chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.gitignore chore: 忽略本地工作区产物 2026-06-17 17:35:17 +08:00
.node-version chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.npmrc chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.prettierignore chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.prettierrc.mjs chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
.stylelintignore chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
eslint.config.mjs chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
Jenkinsfile ci: 接入NapCat WebUI网关上游网络 2026-06-24 17:26:33 +08:00
LICENSE docs: 补充来源与许可证说明 2026-06-08 12:09:58 +08:00
package.json chore: 优化Husky提交钩子 2026-06-05 08:52:54 +08:00
pnpm-lock.yaml feat: 增加Tiptap富文本编辑器 2026-07-01 16:58:26 +08:00
pnpm-workspace.yaml feat: 增加Tiptap富文本编辑器 2026-07-01 16:58:26 +08:00
README.md fix: 收敛Markdown编辑器高度 2026-07-01 19:25:29 +08:00
stylelint.config.mjs chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00
turbo.json chore(admin): 精简后台模板并隐藏未接入模块 2026-05-17 12:32:25 +08:00
vitest.config.ts chore: 初始化后台模板仓库 2026-05-16 17:28:02 +08:00

README.md

KT Template Admin

kt-template-admin 是 KT 后台管理端项目，基于 Vben 5.6.0 精简后只保留 antdv-next 应用，接口统一接入 kt-template-online-api，生产发布走 Jenkins 静态构建和 Nginx 反向代理。

项目结构

apps/web-antdv-next       后台管理端入口
internal                  构建、Vite、Lint 等内部配置包
packages                  Vben 运行时依赖的核心包和组件包
deploy/nginx-admin.conf   Admin 静态站点和后端 /api 反向代理配置
Jenkinsfile               Jenkins 静态发布流水线

环境要求

  • Node.js 22.22.0
  • pnpm 10.28.2

建议通过 Corepack 固定 pnpm 版本：

corepack enable
corepack prepare pnpm@10.28.2 --activate

常用命令

pnpm install
pnpm run dev
pnpm run verify:commit
pnpm run build:antdv-next

环境变量

本地开发和 Jenkins 构建主要使用：

  • VITE_GLOB_API_URL：后端 API 前缀，本地和生产默认使用 /api
  • VITE_BASE：Vite base，默认 /
  • VITE_ROUTER_HISTORY：路由模式，可选 hash 或 html5
  • VITE_COMPRESS：构建压缩方式，可选 none、gzip、brotli
  • VITE_KT_BLOG_WEB_BASE_URL：博客文章预览 iframe 打开的 KT Blog Web 公共地址，本地默认 http://127.0.0.1:5173/，生产必须指向部署后的 KT Blog Web，而不是 WordPress 后台或 WordPress 基准站点。

真实环境变量不提交，示例配置以 .env.example 为准。

业务页面

  • 系统管理 / 菜单管理维护后端 admin_menu.sort 排序字段；/menu/all caller 会把后端 sort 映射到 Vben 菜单生成器读取的 meta.order，保证侧边栏菜单展示以后端返回顺序为准。默认首页入口收敛到环境总览 /analytics，不再保留假工作台 /workspace 页面。
  • 系统管理 / 站内信是日志级通知列表，只展示 API 错误、QQBot 下线、NapCat 离线等后端自动捕获事件；页面提供筛选、处理/重新打开、置顶和删除，不提供人工新增或编辑。
  • QQBot / 账号连接页拆分 OneBot 连接、QQ 登录、NapCat 运行和运行说明列；更新登录通过 SSE 展示 quick / password / captcha / new-device / qrcode 每步中文进度，密码登录触发 QQ 安全验证时在弹窗内完成腾讯验证码并回交 API，新设备验证二维码和腾讯验证码分开展示；行操作“运行态”打开只读抽屉，展示 NapCat runtime/protocol/session behavior profile、风险模式和登录事件证据。
  • QQBot / 插件平台页保留在线命令能力表，并提供 manifest 校验、本地插件安装、安装记录、运行事件和账号绑定抽屉，接口走 /qqbot/plugin-platform/*。
  • 博客管理 / 文章管理提供“预览”行操作，打开隐藏二级路由 /blog/article/:articleId/preview；预览页按 NapCat WebUI 的微服务嵌入形态实现，iframe 独占容器，文章标题、状态、预览 Host 和返回/刷新/新窗口操作放在右下角悬浮卡片，不占用 iframe 布局空间。新增隐藏路由和按钮权限需要同步 API blog-menu.sql / vben-admin-init.sql 中的 BlogArticlePreview 与 BlogArticlePreviewButton。
  • 博客管理 / 文章表单支持 Markdown、富文本 HTML、源码 HTML 三种编辑模式：Markdown 继续使用 Milkdown/Crepe 并保存 contentFormat=markdown；富文本 HTML 使用 Tiptap 并保存 contentFormat=html；源码 HTML 用于保留 WordPress/Argon 运行时 DOM，同样保存 contentFormat=html。Milkdown/Crepe 必须先引入 @milkdown/crepe/theme/common/style.css，再引入具体主题 CSS，否则生产包只有主题变量没有工具栏/菜单布局样式；组件 SCSS 还必须把 --crepe-color-* 映射到 Admin hsl(var(--...)) 主题 token，并用固定高度外壳、隐藏溢出的 root 和正文 flex 滚动区覆盖 common 默认大 padding/高度模型，避免暗色模式脱节和首次空编辑器出现内部滚动条。

部署说明

Jenkins 使用 Jenkinsfile 执行：

  1. 安装依赖
  2. pnpm run verify:commit
  3. pnpm run build:antdv-next
  4. 将 apps/web-antdv-next/dist 原子发布到 Nginx 挂载的 Admin 静态目录

Nginx 配置见 deploy/nginx-admin.conf，默认监听 5999，静态根目录为 /usr/share/nginx/html/admin，并将浏览器侧 /api/* 转发到后端 192.168.31.224:48085，将 /napcat-webui/* 转发到 NapCat WebUI Gateway 192.168.31.224:48086。配置保留 gzip、静态资源长缓存、入口 HTML 不缓存、WebUI WebSocket 转发和 SPA 回退。

提交规范

Husky 会在提交前执行 lint 和类型校验，并在 commit-msg 阶段校验提交信息格式：

feat(admin): 增加后台菜单配置
fix(api): 修复登录态刷新

要求使用英文类型前缀，描述部分包含中文。

来源与许可证

一级来源 使用方式 License
Vben Admin Admin 基础工程、Vben 工作区结构和后台运行时约定 MIT