---
url: https://qiwuadmin.com/guide/introduction.md
description: >-
  栖梧（Qiwu）是基于 NestJS 和 Vue 3 的 Node 全栈管理后台模板：在线演示账号、适合人群、技术栈、与 RuoYi 等 Java
  模板的区别和完整功能清单。
---

# 介绍

栖梧（Qiwu，项目名 `qiwu-vue-admin`）是一个 **Node 全栈的管理后台模板**。它提供企业后台常用的基础能力，包括登录、单点登录、权限、组织架构、字典、日志、监控、定时任务、消息、文件、代码生成和审批流程。你只需要在上面写自己的业务。

![工作台首页](/screenshots/zh-home.webp)

想知道我为什么做这个项目，见[项目由来](/guide/story)。

::: info 当前状态

v1.16.0 新增[员工聊天、语音消息和前台音视频](/features/im)，PC Web 与 App/H5 共用聊天；实时通话通过可配置的自托管 LiveKit，群通话含本人最多 8 人。`APP_IM` 默认关闭，`im.call.enabled` 默认关闭。App 增加长期会话和单 App 会话规则。变化与升级步骤见 [v1.16.0 更新日志](/changelog#_1-16-0-·-2026-11-09) · [公开源码提交](https://github.com/732124645/qiwu-vue-admin/commit/0c0c2b6bd1b3b7dd117dde4752c8b56f987877f5)。
正式发布：[v1.16.0](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.16.0)。

本版发布自有源码、依赖坐标与接入说明，不附第三方 SDK 二进制或已签名安装包。插件编译和模拟器测试已有记录；真实 LiveKit/TURN、宿主签名安装及 Android/iPhone 硬件媒体仍未验收。Android 一项传递依赖的分发许可仍待澄清，详见[App 要求](/features/im#app-要求与验收)。小程序聊天和 App 离线推送未实施。

当前公开组合提供[基础 OA 申请与审批](/features/oa)，包括请假、出差、报销、用印、通用申请及所需附件、通知和基本移动办理。原生考勤和 OA 助手代申请曾在 v1.10.0 公开，但不在当前 v1.16.0 组合中；[历史说明](/features/attendance)与旧标签保留。会议、知识、物资等完整办公业务不属于当前公开版本。

栖梧按 **MIT 协议**开源。登录、权限、多租户、代码生成、工作流、消息、文件、通用助手等能力见下表；移动端可本机构建和调试，真实设备、应用商店、SMTP 与 S3 仍需部署方验收。版本历史见[更新日志](/changelog)。
:::

## 在线演示

无需安装环境，可以直接访问[在线演示](https://demo.qiwuadmin.com)。

演示站打开了[多租户](/features/multi-tenancy)：一套系统同时服务多家公司，每一家叫一个**租户**，各家的数据互相看不到。所以登录页多了一个“租户编码”输入框，用来说明你要登录哪家公司。用平台账号（运营这套系统的一方使用的账号）登录时，租户编码留空：

| 登录信息 | 内容 |
| --- | --- |
| 租户编码 | 留空 |
| 账号 | `admin` |
| 密码 | `admin@123` |

![带租户编码的登录页](/screenshots/zh-tenant-login.webp)

想看看一家公司登录后看到的样子，可以用两个示例租户登录。每个租户有一个**套餐**，规定这个租户能用哪些功能：

| 示例租户 | 租户编码 | 账号 | 密码 |
| --- | --- | --- | --- |
| 云杉科技（示例）：品牌名“云杉协同”，套餐包含租户能用的全部功能 | `yunshan` | `admin` | `KnjUB2fTabw2wnxL` |
| 青禾商贸（示例）：品牌名“青禾办公”，套餐里没有流程审批 | `qinghe` | `admin` | `KnjUB2fTabw2wnxL` |

用平台账号登录后，在 **系统管理 → 租户管理** 里点某个租户的“进入”，填写原因，再点“进入租户”，就能以平台人员的身份查看这个租户。进入期间，页面顶部会一直显示一条横幅，提醒你正在操作别的租户；点横幅上的“退出租户”就回到平台。

登录时会显示滑块验证码，把拼图块拖到缺口的位置即可。

::: warning 演示模式
访客可以浏览全部功能。除登录、退出、切换语言、保存表格列设置、标为已读、进入和退出租户等少数操作外，写入操作都会被拒绝，并提示“演示模式下不能执行此操作”。访客的 IP 和 User-Agent（UA）会脱敏展示。请勿输入真实个人信息。
:::

源码仓库：[732124645/qiwu-vue-admin](https://github.com/732124645/qiwu-vue-admin)。想在本机运行并修改代码，见[快速开始](/guide/getting-started)。

## 适合谁用

* **学生和编程新手**：从安装环境、终端用法讲起，一步步带你做出第一个功能模块。有专门的[从零开始教程](/beginner/)。
* **想做全栈的前端开发者**：会 Vue 就能上手，后端同样使用 TypeScript，不需要再学一门语言。有专门的[后端入门](/backend/)。
* **从 Java 转到 Node 的后端开发者**：功能和 RuoYi 这类后台对应，概念一看就懂。有专门的[对照文档](/java/)。
* **全栈小团队和外包工作室**：一个仓库交付整套后台，前后端共用类型和校验规则。
* **独立开发者**：做 SaaS 或内部工具时，直接拿它当后台底座。

## 技术栈

| 部分 | 选型 |
| --- | --- |
| 后端 | NestJS 12（ESM）、TypeORM、MySQL 8.4、Redis 7+、Socket.IO |
| 前端 | Vue 3.5、Vite 8、Element Plus、Pinia、vue-i18n |
| 共享 | `@qiwu/shared`：zod 校验规则、类型、错误码、权限常量 |
| 工程 | pnpm workspace、TypeScript 6、Vitest、Playwright、oxlint + ESLint |

## 和 Java 后台模板有什么不同

功能范围参考了 RuoYi 和芋道的 system/infra 部分。表名、接口、权限写法、字典编码和界面文字都不相同，接口协议也不兼容。

主要区别在于：

* **一种语言**：前后端都是 TypeScript，同一个 zod 规则同时用于后端校验、前端表单和接口文档。
* **更严格的默认安全**：数据范围越界统一返回 404，不泄露记录是否存在；防越权授予、密钥加密存储、上传文件按内容识别类型等措施默认开启。详见[安全基线](/features/security)。
* **原生国际化**：从第一行代码起，所有文案都通过翻译键输出，不是事后补充的。
* **Node 生态的取舍**：Java 专属的功能（比如 Druid 监控、JVM 面板）换成了对应的替代品，例如 MySQL 状态卡和 Node 运行时面板。

## 功能一览

✅ 已完成　🚧 开发中　⏸ 以后再做

每个功能的详细介绍见[功能总览](/features/)。

### 系统管理

| 功能 | 状态 |
| --- | --- |
| 用户（部门树筛选、导入导出、重置密码、分配角色） | ✅ |
| 角色（菜单授权、数据范围、分配用户、防越权授予） | ✅ |
| 菜单（目录/页面/操作三种类型，"操作"即按钮权限；外链、内嵌页面、缓存） | ✅ |
| 部门、岗位 | ✅ |
| 字典、参数设置 | ✅ |
| 通知公告（富文本、铃铛提醒、已读统计） | ✅ |
| 个人中心（资料、改密、头像裁剪、手机号换绑、访问令牌） | ✅ |
| App 版本（登记移动端 App 的热更新包和整包，App 启动时提示更新） | ✅ |

### 安全与审计

| 功能 | 状态 |
| --- | --- |
| 账号密码登录、短信登录、注册（默认关闭）、短信找回密码 | ✅ |
| 图形验证码 / 滑块验证码 | ✅ |
| 登录失败锁定、IP 黑名单、首次登录强制改密、密码过期 | ✅ |
| 微信小程序登录、账号绑定（默认关闭） | ✅ |
| 在线用户、强制下线（对方实时掉线） | ✅ |
| 操作日志、登录日志、API 访问日志、API 错误日志 | ✅ |
| 演示模式（只读） | ✅ |

### 系统工具与监控

| 功能 | 状态 |
| --- | --- |
| 代码生成（单表 / 树表 / 主子表，页面与命令行两种方式，可以同时生成移动端页面） | ✅ |
| [用 AI 开发](/guide/ai)（一份开发规则供各种 AI 编程工具读取、项目自己的规则文件、十个任务配方、自动生成的项目地图、检查报错带改法） | ✅ |
| 定时任务（可视化 Cron、错过策略、重试、超时、执行日志） | ✅ |
| 文件存储（本地 / S3 兼容、浏览器直传、私有文件鉴权下载） | ✅ |
| 站内信、邮件、短信（阿里云 / 腾讯云） | ✅ |
| 服务器、MySQL、Redis 监控，缓存管理 | ✅ |
| 任务队列（用已有的 Redis，任务在添加它的租户里执行，失败自动重试），队列监控 | ✅ |
| 地区树、IP 归属地 | ✅ |
| 接口文档（Swagger） | ✅ |
| 表单设计器（人员、部门、字典、附件、地区组件，自动算天数和明细合计，导出 JSON 和 Vue 代码） | ✅ |

### 工作流

| 功能 | 状态 |
| --- | --- |
| 流程引擎（会签 / 或签 / 依次、并行与条件分支、退回、转办、加签、撤回、超时提醒） | ✅ |
| 审批中心（待办、已办、我的发起、抄送我的、催办、打印） | ✅ |
| [OA 办公](/features/oa)（请假、出差、报销、用印和通用申请；共用审批中心、私有附件、通知与基本手机办理） | ✅ |
| [打卡考勤](/features/attendance)（v1.10.0 历史能力，不含在当前公开组合） | 历史版本 |
| 流程设计器（仿钉钉树形，发布前检查并定位出错节点） | ✅ |
| BPMN 设计器（标准流程图画法，发布时转换为树形运行；导入导出 `.bpmn`、实例详情只读流程图） | ✅ |
| 超时自动处理（到期后自动通过、自动驳回或转给上级） | ✅ |
| 流程模型管理（分类、版本、JSON 导出导入）、进度树 | ✅ |
| 动态表单审批（字段权限、表单中的人作审批人、私有附件） | ✅ |
| 零代码审批（新建审批向导，内置通用审批、请假、报销、加班模板） | ✅ |
| 审批数据（按表单字段筛选、导出 Excel） | ✅ |

### 其他

| 功能 | 状态 |
| --- | --- |
| 三种布局、多标签页、暗色模式、浅色 / 深色侧栏、锁屏、用户名水印、中英文切换 | ✅ |
| 多实例部署（跨实例实时推送、Redis 共享限流） | ✅ |
| 服务器部署套件（每个版本一个目录、PM2 集群逐个重启、健康检查、失败自动切回上一版本的代码）和 GitHub Actions 自动检查、自动发布 | ✅ |
| 新项目初始化脚本（独立的数据库、Redis 库号、密钥和系统名称） | ✅ |
| OAuth2 授权服务 / 单点登录（授权码 + PKCE，其他系统用这里的账号登录；客户端管理、授权同意页、记住授权） | ✅ |
| [多租户](/features/multi-tenancy)（一套部署服务多家公司，共用一个数据库、按租户隔离数据；租户管理、租户套餐、绑定域名、品牌，平台人员进入租户排查问题；默认关闭） | ✅ |
| [微信公众号](/features/wxoa)（多账号接入、消息与会话、自动回复、自定义菜单、粉丝与标签、素材、模板消息、渠道二维码；图文草稿、发表、群发、数据统计、留言、订阅通知需要已认证的服务号，目前只在模拟环境里验证过；默认关闭） | ✅ |
| [MCP 智能体接入](/features/mcp)（智能体以用户本人的权限调用后台工具；个人访问令牌或 OAuth2、急停、限流、按工具停用、操作日志；默认关闭） | ✅ |
| [智能助手](/features/agent)（右侧悬浮聊天：积分费率和真实用量明细、接入兼容 OpenAI 接口的模型，联网搜索、外部 MCP 服务器、技能，默认在改数据前由人确认，可对列表选中的记录批量执行；自动化、配置方案、记忆、自动审查、深度研究和图表；默认关闭） | ✅ |
| 移动端（uni-app：微信小程序、安卓、iOS；登录、工作台、消息、审批（含动态表单）、实时推送、微信订阅消息提醒、App 更新检查已完成，支持浅色和深色主题；发布前的真机核对还在进行） | 🚧 |
| 其他第三方登录（GitHub、钉钉、企业微信、飞书、微信扫码等） | ⏸ |
| [员工聊天与通话](/features/im)（私聊、群聊、通讯录、文字/图片/文件/表情/语音；前台最多 8 人音视频） | 源码与工程验证完成；真实媒体、真机及原生分发条件另验 |
| 小程序聊天、App 离线推送和后台来电 | ⏸ |

![暗色模式下的工作台](/screenshots/zh-home-dark.webp)

## 免责声明

本项目按 MIT 许可"按原样"提供，不提供任何担保。用它做什么由使用者自行决定并承担责任，不得用于违法违规用途。完整内容见[免责声明](/guide/disclaimer)。

## 参与贡献

栖梧是开源项目，欢迎参与。按你想做的事找入口：

| 想做什么 | 去哪里 |
| --- | --- |
| 提问，交流用法和想法 | [讨论区（Discussions）](https://github.com/732124645/qiwu-vue-admin/discussions) |
| 报告缺陷，提出功能建议 | [问题（Issues）](https://github.com/732124645/qiwu-vue-admin/issues)，请用问题模板，写明版本、环境和复现步骤 |
| 提交代码，或改进模板仓库里的文档 | 先读[贡献指南](https://github.com/732124645/qiwu-vue-admin/blob/main/CONTRIBUTING.md)，再发起合并请求（PR）；较大的改动请先在讨论区或问题里商量方案 |
| 报告安全漏洞 | **不要公开提交**，按[报告安全漏洞](/features/security#报告安全漏洞)里的步骤私密报告 |
| 指出本文档站的错误 | 点页面底部的"在 GitHub 上编辑此页"，或在页面下方的评论区留言 |

## 下一步

* [快速开始](/guide/getting-started)：在本机跑起来
* [目录结构](/guide/structure)：了解代码怎么组织
* [新增业务模块](/guide/new-module)：用代码生成器写第一个业务页面
