---
url: https://qiwuadmin.com/changelog.md
description: 栖梧版本说明与升级步骤：OA 办公、原生考勤、智能助手、工作流、移动端、多租户及安全更新。
---

# 更新日志

这里记录栖梧每个正式版本的变化。现在有哪些功能、各项的完成情况，见[介绍 · 功能一览](/guide/introduction#功能一览)。

## 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)。

* 新增[员工聊天](/features/im)：PC Web 与 App/H5 私聊、群聊和员工通讯录，文字、emoji、图片、文件、内置与个人表情，编辑、撤回、读位置和未读数。只面向租户内启用的员工，`APP_IM` 默认关闭，开启多租户时受套餐控制。
* 本地优先缓存：Web/H5 使用 IndexedDB，App 使用 SQLite；缓存按服务、租户、账号和同步时期隔离。发送队列持久保存，退出、被踢和换账号清理，会话过期只锁定。
* 语音消息：Web/H5 复用 recorder-core，App 复用系统录音，上传 WAV 并由服务端读取实际格式、时长和大小；语音独立于 LiveKit。失败语音随持久队列恢复、重试和清理。
* 前台音视频：一对一和最多 8 人的小群，接听、拒绝、静音、摄像头、镜头切换、扬声器偏好和挂断。使用官方 LiveKit SDK，App 通过 `qw-livekit` UTS API 和 nvue 原生视频组件接入；[自托管接入](/core/livekit)可配置，`im.call.enabled` 默认关闭。
* App 长期会话：`auth.mobile.session_days` 默认 `0`，使用时保持登录，连续 400 天未打开需要重登；默认单 App 会话，另一台 App 登录结束旧会话并清除聊天缓存。Web、H5 和小程序原期限规则保留。
* 公开组合继续只提供[基础办公申请和审批](/features/oa)，不包含完整协作、会议、知识、资产车辆或员工服务等私有办公能力。

本版发布自有源码、依赖坐标和声明，不附第三方 SDK 二进制或已签名的 Android/iOS 安装包。双平台插件有原生编译/链接和模拟器测试记录；产品宿主签名安装、真实 LiveKit/TURN、Android/iPhone 硬件媒体仍未验收。Android `android-jain-sip-ri:1.3.0-91` 的版本特定分发许可仍待[上游澄清](https://github.com/livekit/client-sdk-android/issues/1048)，不能把源码发布写成最终 App 可分发验收完成。

升级步骤：

1. 备份现有数据库和文件。更新代码后执行 `pnpm i --frozen-lockfile`，有移动端时再执行 `pnpm -C mobile install --frozen-lockfile`，然后 `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed`，不要用 `db:reset` 升级。
2. 保持聊天和通话默认关闭，先核对租户套餐与聊天保留参数，再按[员工聊天](/features/im#启用)启用。恢复备份或重置后，按文档更新同步时期，避免复用旧缓存。
3. App 必须重编原生整包或自定义基座，填写自己的标识、证书和 API 地址；仅更新 wgt 无法加入 SQLite、Record 和通话插件。
4. 通话另行部署 LiveKit v1.13.11，保持 `room.auto_create: false`，配置 HTTPS/WSS/TURN 和仅服务端保存的密钥，完成[真实服务验收](/core/livekit#接入验收)。小程序聊天、App 离线推送和后台来电没有实施。

更多步骤见[升级模板版本](/guide/upgrade#升级到-v1-16-0)。

## 1.15.0 · 2026-10-30

运维版本：进程角色拆分、连接池设置、卡顿诊断、模型提供方并发上限。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/a0be38c5c88d2cd5d67b2cc50ac6dc872ccd89ce)。
正式发布：[v1.15.0](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.15.0)。

* 进程角色：新增环境变量 `APP_ROLE`，可选 `all` / `api` / `worker`，默认 `all`，行为与以前完全相同。`api` 进程只处理页面请求和实时推送，不跑定时任务和队列任务，任务页的“执行一次”交给 worker 进程执行；`worker` 进程跑定时任务和全部队列任务，后台推送仍能送到浏览器。PM2 配置多了一个可选的 worker 应用（`QW_PM2_WORKER_INSTANCES`，默认 0 即保持单个应用），部署脚本会一并做健康检查。见[多实例部署 · 进程角色](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/scale-out.md#进程角色)。
* 数据库连接池：新增 `DB_POOL_SIZE`（默认 10）、`DB_POOL_ACQUIRE_TIMEOUT_MS` 和 `DB_POOL_QUEUE_LIMIT`（默认 0，不限，与以前相同）。请求在限定时间内拿不到数据库连接时，直接返回 503“服务繁忙”，不再一直等到浏览器超时。
* 卡顿诊断：服务监控页显示响应本次请求的那个实例的事件循环延迟（p50 / p99 / 最大值）和利用率；`LOG_SLOW_REQUEST_MS` 把慢请求在日志里标出，并附上当时同进程在跑的定时任务；`LOG_EVENT_LOOP_INTERVAL_MS` / `LOG_EVENT_LOOP_WARN_MS` 定期把事件循环延迟写进日志；调度日志多记执行实例和执行期间的事件循环最大延迟。这些默认都关闭。见[卡顿诊断](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/scale-out.md#卡顿诊断)。
* 模型提供方并发上限：[智能助手](/features/agent#配置模型)的每个模型提供方可以设置同时发出的调用上限，按所有实例、所有租户合计。超出上限的调用先排队等名额，等满 120 秒仍没有名额就提示“模型繁忙”；没等到名额的调用不计积分。
* 启动时多两处提示：`.env` 与 `.env.local` 同一个键写了不同值时给出警告（只列键名，以 `.env` 为准），并输出一行 `effective config`，列出当前生效的非秘密配置。
* 部署指南更新：所有 `pm2` 命令都以应用用户执行（`sudo -u qiwu -H pm2 …`），并说明出现 “Process or Namespace not found” 时怎么办；nginx 示例开启 HTTP/2；新增一段容量说明，把 PM2 实例数、连接池大小和 MySQL 的 `max_connections` 对起来。见[部署](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/deploy.md)。

升级步骤：

1. 照常执行 `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed`。迁移只新增三个可为空的列（调度日志的执行实例与事件循环最大延迟，模型提供方的并发上限），旧记录保持为空。
2. 新增的环境变量默认值都不改变原有行为，不设置就和 v1.14.1 一样。默认的 `all` 角色会多一个空闲的 `scheduler-run` 队列，在队列监控页能看到。
3. 要把后台任务拆到单独进程时，按[部署](/guide/deploy#使用-pm2-守护进程-可选)设置 `QW_PM2_WORKER_INSTANCES`；第一次开启和切回单个应用都要先 `pm2 delete` 再启动，并且至少保留一个 `all` 或 `worker` 实例，否则定时任务和队列都会停。

更多步骤见[升级模板版本](/guide/upgrade)。

## 1.14.1 · 2026-10-30

修复版本。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/1eb5fcf864cee59b776dbc564ce6312d38eb7551)。
正式发布：[v1.14.1](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.14.1)。

* 已经登录时再打开登录页（书签、链接、浏览器后退或新标签页）不再要求重新输入密码，直接进入原本要去的页面或首页。锁屏、会话已结束或会话加载失败时仍显示登录表单。

## 1.14.0 · 2026-10-29

助手原地回退、插话与租户工具限制。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/dc00fc39857fa69630bdf8037a6083de1a6d0eb1)。
正式发布：[v1.14.0](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.14.0)。

* [智能助手](/features/agent#对话页)的任意一条已发出消息都可以“从这里重新编辑”：这条消息及其后的内容从本会话删除，原文、附件和技能回到输入框；“重新生成”重做最后一轮，“撤回最后一轮”只删除。确认框列出被删内容里已经执行或结果不明的写入（含子任务）；写入、已提炼的记忆、模式切换和已用积分都不会撤销。别的窗口已有本页没看到的新内容时回退失败，不会多删。分叉仍是单独的动作。
* [租户工具限制](/features/agent#租户工具限制)：租户管理员可以在“技能管理 → 工具限制”把工具在本租户设为仅人工确认或停用；生效的是平台与租户中更严的一方，租户不能放宽，下一次调用就生效。只作用于站内智能助手，不影响个人访问令牌接入的 MCP 客户端。
* 输入框下方新增状态行：会话模式、上下文用量（有模型服务报告的实际输入时用它）、本轮和今日积分、本会话已放行的工具数。`/status` 另外列出模型、配置方案、已放行的工具，以及需要确认和不可用的工具各自的原因。
* 审批卡写明为什么要问你（需确认、平台仅人工确认、租户限制、设为询问的只读工具、须本人逐次确认）；被挡住的卡片区分权限、会话模式、平台策略、租户限制和技能 / 方案的工具清单。
* 运行中按 Enter 是插话：当前这次工具调用一结束就送进本轮，同一步后面会问人或会写入的调用以这条消息为说明记为拒绝。“排到下一轮”（Alt+Enter）只排队，等审批卡时也一样。
* 停止（Esc 或按钮）在输入框有字时也能用，草稿保留；排队的消息撤回并放回输入框，不再自动开始。排队中或作废、从未执行的消息不再发给模型或审查模型。

升级步骤：

1. 本版有新迁移。更新代码后照常执行 `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed`，不要用 `db:reset` 升级已有数据库。
2. 迁移新建一张租户表（租户的工具限制）；种子在技能管理页下新增“浏览 / 修改工具限制”两个动作，第一次建出时自动补进已经包含技能页的租户套餐。
3. 自己调用智能助手接口的前端或脚本须同步修改：停止接口的返回、回退接口、实时事件和 `/status` 字段都有变化，见[升级模板版本](/guide/upgrade)。

更多步骤见[升级模板版本](/guide/upgrade)，交互说明见[对话页](/features/agent#对话页)。

## 1.13.1 · 2026-10-28

修复版本。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/76d3df6edac268c2aa7bc672eddbf398bff0a576)。
正式发布：[v1.13.1](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.13.1)。

* 关闭 MCP 接入时，[智能助手](/features/agent)“配置方案”表单的工具列表也能正常载入，并且同时列出本人可用的本系统工具、联网工具、启用的内置工具和外部 MCP 工具。
* MCP 工具调用的参数在 HTTP 请求追踪里整体遮蔽，传给工具的业务内容不再留在追踪日志中。
* 测试修复：迁移防护测试在 Windows 上也能运行；等待防重复提交窗口的测试改为等记录真正过期，Docker Desktop 的 Redis 上不再偶发 429。

升级：没有新迁移，照常更新代码、构建、执行迁移和种子即可。

## 1.13.0 · 2026-10-28

助手会话模式、自动审查与方案批准。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/4d0a6393596e0612d9caaa63807a48d9f3839bdd)。
正式发布：[v1.13.0](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.13.0)。

* [智能助手](/features/agent#会话模式和工具策略)的每个会话改为一个会话模式：只读、计划、每次询问（默认）和自动审查，替代原来的审批模式下拉、计划开关和“信任本会话”；输入框里按 Shift+Tab 依次切换可用的模式。
* [自动审查](/features/agent#自动审查)选中即生效：所有需确认的写入先交审查模型，不再逐个工具开启。审查驳回时停下等人并附审查理由，不再退回给模型。
* 工具策略改为直接执行（`auto`）、需确认（`ask`）、仅人工确认（`human`）和停用（`deny`）。仅人工确认从不送审、不能本会话放行，建议用于删除、批量修改、对外发送和涉及金额的写入；读取类工具默认不问，除非超级管理员明确设为需确认。
* 审批卡片提供“允许这一次”“本会话内不再询问此工具”（可用时）和带说明的“拒绝”。放行的工具列在会话设置里，可逐个撤销，记下时和每次使用前都按当前策略复核；须本人逐次确认的工具、仅人工确认的工具和外部 MCP 工具不提供。卡片等待时发消息，等于带这条消息拒绝这一步待确认的调用，智能体立即继续；自动审查模式下，卡片写明这次为什么没有送审。
* [计划模式](/features/agent#计划模式)最后提交一张方案卡（步骤、预计改动、前提假设），由本人选择“批准并自动审查执行”“批准并逐个确认”或“继续完善”；只有本人能离开计划模式。
* 模型服务可以[从服务加载模型](/features/agent#配置模型)列表，在可搜索的列表里勾选添加，不用手抄模型标识；保存的密钥只发给保存的地址，不跟随跳转，返回内容有大小上限，只有超级管理员能用。
* 移除“信任本会话”模式和参数 `agent.trust_mode`；工具策略 `review` 并入 `ask`。

升级步骤：

1. 本版有新迁移。更新代码后照常执行 `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed`，不要用 `db:reset` 升级已有数据库。
2. 迁移自动转换：计划模式的会话保持计划；“信任本会话”的会话改为每次询问，按记录记下的信任一并清空；策略为 `review` 的工具改为 `ask`；参数 `agent.trust_mode` 删除。
3. 开放自动审查之前，超级管理员在 **智能体设置 → 工具审批** 逐个复核写入工具，把删除、批量修改、对外发送和涉及金额的设为“仅人工确认”。

更多步骤见[升级模板版本](/guide/upgrade)，模式与策略见[会话模式和工具策略](/features/agent#会话模式和工具策略)。

## 1.12.0 · 2026-10-27

助手桌面工作区、用量与设置页，以及积分升级修复。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/c52c361f2ca14336c97a1e3c3fdec85ed4430ea5)。
正式发布：[v1.12.0](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.12.0)。

* [智能助手](/features/agent)聊天改为桌面工作区：会话列表和右侧面板可拖动或用方向键调宽，宽度按用户和浏览器记住，双击恢复默认，列表可收成窄栏；工作面板和子任务详情可在主区域打开；专注模式隐藏系统菜单和标签页。头部只留“工作面板”“专注模式”“会话设置”三个带文字的按钮，其余放进会话设置弹层和操作菜单；消息操作悬停时显示为一行，回答使用居中阅读栏，输入框下方显示快捷键提示，计划模式改为开关。
* 用量页先显示关键数字，积分保留两位小数并带千位分隔，默认显示业务列，只在需要时说明数据完整性，按日图表带单位和空状态。
* 智能体设置页增加“开始使用”引导（模型、联网搜索、工具审批、试一试），页签按设置顺序排列并改用更直白的名称。
* 修复积分升级：没有费率的模型恢复可用，调用记为未计价，不计积分也不受额度限制。配了费率的模型总会计积分：用量未知时按请求与已输出内容估算，缺缓存细分或总数对不上时保守计价，都计入额度；用量页分别列出未计价与估算的调用，设置页在没有积分额度上限时提示。
* 模型服务不接受关闭思考时给出专门的错误，不再报笼统的上游失败。
* 开发服务编译到独立的 `dist-dev/` 目录，并行的生产构建不再打断正在运行的 `pnpm dev`；后端就绪前退出时自动重试一次。
* 服务端测试的临时监听绑定本机回环地址，每个测试文件从空的限流计数开始，不再因本机其他服务或前一个文件偶发 401、404、429。

升级步骤：

1. 本版没有新迁移。更新代码后照常执行 `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed`，不要用 `db:reset` 升级已有数据库。
2. 由旧模板派生的项目把 `dist-dev/` 加入 `.gitignore`。
3. v1.11.0 升级后被拒绝调用的无费率模型会恢复可用。需要积分额度的模型，由超级管理员配置费率和三项预算；三项都为 `0` 时设置页会提示当前没有积分额度上限。

更多步骤见[升级模板版本](/guide/upgrade)，积分语义见[限额、急停和用量](/features/agent#限额、急停和用量)。

## 1.11.0 · 2026-10-27

悬浮聊天、积分额度、断线恢复与开发热重载。公开版本：[源码提交](https://github.com/732124645/qiwu-vue-admin/commit/c83de79468f4aafc5559070365a6f8ee7abeac79)。
正式发布：[v1.11.0](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.11.0)。

* [智能助手](/features/agent)从业务页面右侧悬浮按钮打开，保留当前页面地址、会话和草稿；历史与工作面板按需展开。子任务按真实状态分组，在主任务旁只读查看，手机可返回主任务。通知、分享和旧会话地址继续兼容。
* 回答支持安全 Markdown 表格、嵌套列表、任务清单、代码复制和折行、原文切换与下载；工作面板集中阅读任务、来源和产物。
* 额度改为积分：每模型配置每百万普通输入、输出、缓存读取、缓存写入 Token 的费率；每轮、用户每日、租户每日预算支持 `0` 不限额。记录实际用量、推理与缓存细分、当次费率和积分，历史缺失标记为未知，不重算旧账。预算在下一次调用前检查，在途调用可能越过阈值。
* 模型默认思考行为和能力声明分开，支持明确关闭和 vLLM 开／关；外部 MCP 的直接执行由超级管理员明确核对并信任，不把供应商标签当证明，也不放宽原有逐次确认。
* 发送使用固定 UUID 与持久接收凭据，回执丢失后只查询，明确重试复用标识；流式文字先存后播，可补齐已显示前缀。重启恢复任务而非原上游 Token 连接，当前步骤可能重新生成；整页刷新不保证保留未发送正文。模型调用先记待核对记录，恢复保留真实用量和原费率，明细与各层汇总原子记一次，未知不造 0。
* 写入或付费图片结果未知时暂停相关后续操作，须本人核对当前风险；信任或自动化不能绕过，在途本地工作未结束不能解除，远程非幂等操作须到对方核对。旧轮次和队列不会自动重放，受影响自动化停用、撤销预授权，需重新配置。进行中或未核对的会话不能直接分叉、撤回或删除。
* 开发重载输出本次文件、编译与就绪耗时及上轮对比；共享编译完成后只触发一次后端重载，编译失败保留旧服务。修复文案热更新整页刷新、候选滚动、聊天工作区溢出、首轮长任务压缩、MCP 流取消，以及迁移测试超时后的恢复与污染隔离。
* 完整遮蔽的审计路由会隐藏整个载荷、URL 查询和错误自由文本；数据权限静态检查补齐委托持锁路径及同名服务歧义校验。

升级步骤：

1. 备份数据库、上传文件和密钥。首次升级在维护窗口停止发起新任务，等待旧任务自然结束，再开启 `agent.paused` 并停全部旧 worker。该开关会中断进行中的轮次；必须提前急停时，先人工确认操作已结束，并核对不确定结果和费用。更新代码后执行 `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed`，再启动新版；不要用 `db:reset` 升级已有数据库。

2. 超级管理员给旧模型填写积分费率，再设置三项积分预算。旧 Token 限额不会直接换算成积分；新预算默认 `0` 不限额。未配置费率的模型会在发请求前被拒绝。

3. 新增调用积分明细迁移和菜单／参数种子。Markdown 使用 MIT 许可的 `marked` 作语法分词，内容仍以安全组件渲染，不执行上游 HTML 或脚本。

4. **公开范围调整**：本版公开组合只保留基础请假、出差、报销、用印、通用申请、现有审批中心及所需附件、通知和基本移动办理。原生考勤、OA 助手代申请不在该组合中；两者曾在 v1.10.0 公开，旧标签和历史说明保留。已有项目使用这些能力时，先评估版本和扩展依赖，不能把菜单隐藏当成源码仍随包提供。

5. 保留数据库、Redis 和 `APP_SECRET`。旧版从未保存的回复与调用起点无法事后恢复，新恢复保障适用于后续任务；不能混跑旧 worker 或把回滚旧标签当恢复方案。正常关闭有界等待、取消与落盘，强制终止后等待租约接管。静态资源沿用现有部署策略保留旧版文件，恢复时间受队列和租约影响。详见[断线、刷新与发版](/features/agent#断线、刷新与发版)。

6. 确认新版全部实例已启动、模型费率和预算已配置，且旧任务结果已核对后，由 root 将 `agent.paused` 恢复为 `false`，再开放新任务。解除急停不会清除各会话的恢复标记，仍须会话本人核对处理。

更多步骤见[升级模板版本](/guide/upgrade)，积分语义见[限额、急停和用量](/features/agent#限额、急停和用量)。

## 1.10.0 · 2026-10-23

OA 办公与原生考勤。版本入口：[v1.10.0 发布说明](https://github.com/732124645/qiwu-vue-admin/releases/tag/v1.10.0) · [公开版本提交](https://github.com/732124645/qiwu-vue-admin/commit/35ce0e9e12c8b6e51bb956ef05bd5ff03be909ac)。

* [OA 办公](/features/oa)：请假、出差、报销、用印和通用申请，沿用工作流的我的申请、待办、已办与抄送；申请、附件、明细和流程状态同事务保存与回写。报销批准不代表付款，用印批准不代表已经盖章。
* 手机可查看完整申请和私有附件并办理；保留手机请假和动态表单发起。出差、报销、用印在电脑端创建和编辑。业务附件的元信息与下载统一检查单据和字段权限，全局文件管理身份不能绕过。
* [原生考勤](/features/attendance)：手机签到签退、租户时区与定位规则、办公地点、本人和部门记录及日汇总、批准假勤关联、按保留期清理。无需钉钉；不含排班、补卡、迟到早退判断或薪资结算。
* [助手](/features/agent#办公申请)：查询本人待办和参与申请，帮助准备五类申请。每张申请必须本人在单张卡片逐次确认，会话信任、自动审查、自动化和批量同意都不能代替；不提供代审批或代打卡工具。

升级步骤：

* 新增办公业务、请假附件和考勤数据库迁移。先备份数据库、上传文件与密钥，再按常规顺序更新代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务；详见[升级指南](/guide/upgrade)。原生办公和考勤不要求新增钉钉配置。
* 初始化保留管理员修改；新增出差、报销、用印和通用四模型默认由保护管理员角色明确办理、无人拒绝。**请假保留原示例既有配置**，不会自动替换其无人自动通过和自审跳过设置。正式使用前核对审批制度，并按需调整角色权限和租户套餐。
* App 新增前台定位原生能力，需重新打完整包并更新隐私说明；小程序需配置定位用途和平台授权。H5 自动化、App 和小程序构建已通过，**真实 App / 小程序定位授权及现场打卡仍未验收**；真实 SMTP / S3 也须部署方验证。钉钉独立集成尚未实现、未启用。

## 1.9.1 · 2026-10-22

改善[智能助手](/features/agent)和 [MCP 工具](/features/mcp)页面的可读性与布局。

* 已收录工具显示本地化名称和用途，已知权限显示易读名称；工具标识和协议保持不变，未知工具与权限保留原文。
* 配置方案的工具清单支持选择本人可用的系统工具或补录其他工具标识，留空表示不限；载入失败时保留已有选择，权限与审批检查照常生效。
* 调整设置、技能和自动化页面的标签与内容留白，限额按可用宽度分列，改善窄屏表单与说明展示。
* 恢复已打开的页面标签时使用当前菜单标题、图标与缓存配置，同时保留原地址的查询条件。

本版没有数据库迁移、新依赖或新环境变量。

## 1.9.0 · 2026-10-22

[智能助手](/features/agent)的第二批功能：可以让它在后台按时或在业务操作之后自动运行，记住你的偏好，把影响小的修改交给审查模型把关，还能分派子任务、做深度研究、画图表和导出结果。智能助手仍然默认关闭（开关 `APP_AGENT`）。仓库里的完整说明见[后台智能体文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/agent.md)。

新增：

* **自动化**：新页面 **智能体 → 自动化**（权限 `agent.automation.use`，共享给全租户另需 `agent.automation.share`）。把一个技能或一段提示词设成按定时（5 段 cron 加时区，最短 5 分钟一次）、在某个业务操作记进操作日志之后（创建人能看到这条记录时才运行）或手动运行；每次以创建人的身份在一个隐藏会话里执行，每次运行都重新检查权限。写入模式：只读（默认）、询问（确认卡发到收件箱）、预先同意（逐个勾选允许的写入工具，并输入当前密码）。预先同意只在创建人的权限、数据范围、部门、工具的开关，以及绑定的个人或平台技能、个人配置方案都没变时有效，否则写入停下等人确认。有运行历史，结果进收件箱，可选邮件；每人的条数和每天的运行次数有上限，同一条自动化同时只运行一次。
* **配置方案**：给模型、推理强度、审批模式、允许的工具和额外说明起个名字存成一套，分个人的和全租户共用的（全租户方案的审批模式只能是只读或询问），新建会话时选用，也可以设为默认。
* **个人记忆**：你说“记住……”时，经你确认才保存；可以打开后台提炼，它只读你自己发出的消息。保存前遮蔽密码、密钥等内容，临时会话从不使用，可以逐个会话关掉；在“我的记忆”里查看、编辑、删除，“全部忘记”要输入当前密码。
* **自动审查**：管理员把某个写入工具设为“自动审查”，会话也切到自动审查模式后，由审查模型（超级管理员的参数 `agent.review.model`）对每次写入放行、驳回或交给人；拿不准、内容被截断或审查出错的一律交给人；每轮最多送审 10 次。
* **子智能体、深度研究、图表和导出**：智能体可以把 1 到 3 个只读子任务并行交给子智能体；新增平台技能“深度研究”，有自己的步数和时长上限，最后写成带引用的报告；可以画图表（柱状图、折线图、饼图、表格），给标了“图片”的模型生成图片，并导出 xlsx、Markdown 或打印。
* **诊断页和个人设置**：**智能体设置** 新增“诊断”页签（超级管理员）：测试模型、搜索服务和外部 MCP 服务器能否连通，看各状态的轮次数、最近失败的轮次和孤儿轮次清理。每个人可以设置通知（站内信总会收到，邮件可选）、自定义对话页的快捷键，以及在新窗口打开会话。
* **给项目用**：新增三个扩展点，内置工具、上下文贡献者和审批审查者；新增配方 `docs/ai/recipes/agent-extension.md` 和对应的技能 `qiwu-agent-extension`。

变化：

* 智能助手的提醒不再带会话标题；早先装好的站内信模板里，原来显示标题的位置改为显示会话编号。
* 记忆内容和对话消息的正文在操作日志和接口日志里以 `***` 遮蔽，不留原文。

升级步骤：

* 本版有 1 个数据库迁移 `20261022091719-agent-automation`：创建配置方案、记忆、自动化和自动化运行记录 4 张表（`agent_profile`、`agent_memory`、`agent_automation`、`agent_automation_run`），并给会话表 `agent_thread` 加 4 列（使用的配置方案、是否使用记忆、子智能体的父会话、所属的自动化运行）。和上一版一样，**无论开关是否打开，这些表都会创建**。
* `pnpm db:seed` 写入 **自动化** 菜单和权限、新的系统参数、自动化相关的站内信和邮件模板、提醒的邮件模板，以及平台技能“深度研究”。已经存在的模板不会被覆盖。新参数（审查模型、记忆提炼、每轮记忆条数、深度研究的步数和时长、自动化的条数和每日次数）见仓库的[参数表](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/agent.md#限额暂停与用量)。
* 没有新的环境变量，没有新的依赖。
* 照常升级：更新到 v1.9.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.8.0 · 2026-10-22

新增后台**智能助手**，默认关闭。业务人员在对话页里用自然语言提要求，模型 / 智能体用后台自己的工具、以这个用户本人的身份去查数据、联网查资料、按要求修改数据，每次修改都先由人确认。见[智能助手](/features/agent)，仓库里的完整说明见[后台智能体文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/agent.md)。

新增：

* **开关**：在服务端环境变量里设 `APP_AGENT=true` 才加载这个模块，改完要重启。关闭时所有 `/api/agent/*` 接口返回 404，**智能体** 菜单组也看不到。它运行在现有的任务队列、Redis 和 Socket.IO 上，不需要新的服务。
* **对话页**：像桌面聊天软件一样的会话列表（搜索、改名、置顶、归档、删除，未读和进行中筛选，临时会话），逐字显示的回答，可折叠的工具调用、思考摘要、引用来源和后续建议；可以从任意消息分叉、编辑后重发、撤回最后一轮、在租户内分享只读链接、导出 Markdown、复制和评价消息。运行中发的消息可以追加到本轮或排到下一轮，随时可以停止。支持斜杠命令、用 `$` 调用技能、带文件管理里的附件（文本、xlsx 的第一张表、给能看图片的模型的图片）、上下文用量圆环和自动或手动压缩；一轮等你确认或回答、或较长的一轮完成时发站内信提醒。每个页面右下角的按钮带着当前页面和选中的行打开对话页。
* **只通过工具办事**：工具就是各模块的 `@McpTool` 方法（和 MCP 同一份清单、同一套检查），在进程内以登录用户本人的权限、数据范围和租户运行；另有内置的计划清单、带选项的反问和载入技能。每个会话可选审批模式：只读、询问（默认）、信任本会话。写入工具**从不在没人确认时执行**：审批卡片列出工具、记录、每个字段的旧值和新值，以及这一轮读过的网页来源。计划模式先列出步骤，再动手。
* **模型和联网**：经任何兼容 OpenAI 的 Chat Completions 接口接入模型（DeepSeek、通义千问、Kimi、智谱、Ollama、OpenAI 等），支持流式输出、工具调用和推理强度，每个会话可以选模型。联网搜索支持博查和 Tavily；读网页只限本轮搜索结果、用户给出的链接和白名单网站，每次跳转都检查是否公网地址；网页和外部输出作为不可信内容交给模型。外部 MCP 服务器（Streamable HTTP，请求头令牌或 OAuth 客户端凭据）的工具逐个启用、各设审批策略，服务器中途要求补充信息时显示为提问卡片。
* **技能、说明和模板**：平台、租户、个人三级技能（新建、编辑、启用，以 `SKILL.md` 导入导出，可以根据一次会话起草），用到时才载入；平台、租户、个人三级说明和语气预设；提示词模板。
* **平台设置（超级管理员）**：模型提供方、搜索服务商、外部 MCP 服务器、工具策略（写入工具只能“询问”或“不提供”）、平台技能、说明和限额（每轮步数、时长、token，每用户和每租户每日 token，每用户并发对话数），以及急停参数 `agent.paused`。密钥用 `APP_SECRET` 派生的密钥加密，从不返回。用量页按日、用户或模型汇总调用次数和 token；每次工具调用都记操作日志。
* **批量执行**：对列表里选中的行执行一个技能，每条记录一个会话，在并发上限内依次开始，结果在批次审批页逐条或一次确认。示例：**示例客户** 和平台技能“补齐客户信息”（联网补齐空字段并给出来源），配工具 `demo.customer.search`、`demo.customer.get`、`demo.customer.update`。
* **给项目用**：写入工具可以声明 `preview` 方法供审批卡片显示，`@AgentBatchTarget` 让列表的记录可以批量执行；新增配方 `docs/ai/recipes/agent-skill.md` 和对应的技能 `qiwu-agent-skill`。

升级步骤：

* 本版有 1 个数据库迁移：创建智能体的 14 张表（`agent_*`）和示例客户表 `demo_customer`，并给 MCP 工具停用记录表 `cfg_mcp_tool` 加一列审批策略。**无论开关是否打开，这些表都会创建**。`pnpm db:seed` 写入 **智能体** 菜单组、相关参数、两个站内信模板、示例客户菜单和示例数据，以及平台技能“补齐客户信息”（开关关闭时 **智能体** 菜单不显示）。
* 新增服务端环境变量 `APP_AGENT`，默认 `false`，不需要这个模块就不用设置。模型和搜索服务的密钥不放进环境变量，而是打开后在 **智能体 → 智能体设置** 页填写。打开的步骤和出口防火墙的要求见[部署 · 智能助手](/guide/deploy#智能助手)。
* 服务端新增一个依赖 `openai`（7.39.0，Apache-2.0 协议），用来调用兼容 OpenAI 接口的模型服务，没有安装脚本，`pnpm i` 会装好。
* 照常升级：更新到 v1.8.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.7.1 · 2026-10-22

修复列表操作列的按钮被截断成省略号、点到看不见的按钮的问题。

变化：

* **操作列按钮**：只直接显示前几个按钮（**页面设置** 里的“表格行内操作按钮数”，默认 2；单个表格可以用 `actions-visible` 覆盖），其余收进鼠标移上去就展开的“更多”菜单；危险操作总排在最后；没有权限的按钮不占位置；列宽按实际渲染出的按钮测量，手动写的 `actions-width` 仍然优先。见[系统管理 · 列表页的共同点](/features/system#列表页的共同点)和[列表页 · QwTable](/core/crud-list#qwtable)。
* 模板自带的页面去掉了手调的操作列宽度；代码生成器生成的树形页面也不再写死宽度。

升级步骤：

* 没有数据库迁移，没有环境变量和依赖的变化，只改了前端（和生成器的页面模板），重新构建前端即可。
* 项目自己的列表页不用改：写了 `actions-width` 的照旧按它的宽度；想让宽度自动计算，删掉它即可。操作列里已经有自己的“更多”下拉菜单的页面，给 `QwTable` 加 `:actions-visible="Infinity"`，避免出现两个“更多”。

## 1.7.0 · 2026-10-21

让 AI 编程工具读懂模板的开发约定，没有运行时的变化。见[用 AI 开发](/guide/ai)，仓库里的完整说明见[用 AI 开发文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/ai.md)。

新增：

* **开发规则**：仓库根目录的 `AGENTS.md` 写明在模板上开发业务要遵守的约定：目录与分层、命名、接口、多语言、多租户与数据范围、安全默认、增删改查套件、迁移与种子、生成器优先、测试与完成标准、命令，以及每类检查失败的含义。常用 AI 编程工具的入口文件都指向它，各工具读哪个文件见[用 AI 开发](/guide/ai#仓库里有哪些文件)。项目自己的规则写在 `docs/project-rules.md`，模板不提供这个文件，升级模板时不会冲突。
* **任务配方**：`docs/ai/recipes/` 下十篇分步配方，各带完成检查：新增业务模块（生成器优先）、建表与迁移、权限与菜单、字典与系统参数、数据权限、手写 SQL 与租户、队列任务与定时任务、MCP 工具、多语言词条、接口测试；每篇配方还有一个对应的技能（`qiwu-*`）。
* **项目地图**：`pnpm ai:map` 静态解析源码，生成 `docs/ai/project-map.md`，列出模块和功能开关、表、每个接口及其权限、权限码、菜单、字典、系统参数、队列、定时任务和 MCP 工具。项目地图过期时 `pnpm verify` 报错。

变化：

* **检查报错带改法**：架构检查、`i18n:check`、`originality:check` 和 `license:check` 失败时，报错末尾多一行 `fix:`（怎样改）和一行 `see:`（解释这条规则的文档链接）。新增的架构检查 `ai-docs` 核对 AI 文档里提到的脚本、路径、链接和锚点都真实存在。

升级步骤：

* 没有数据库迁移，没有环境变量和依赖的变化，服务端和前端的运行代码都没有改，不需要重新部署。
* 合并后 `pnpm verify` 会检查项目地图：项目里有自己的模块、表或接口时，它会报项目地图过期，运行 `pnpm ai:map` 重新生成并提交即可。以后每次合并模板新版本后都运行一次，见[升级模板版本](/guide/upgrade#合并后的检查)。
* 想让 AI 遵守项目自己的约定，新建 `docs/project-rules.md`，见[用 AI 开发](/guide/ai#写上项目自己的规则)。

## 1.6.1 · 2026-10-21

修复电脑端在服务端连不上时的体验。

变化：

* **后端连不上时停在原页面等待**：刷新页面或新开标签页时，如果服务端没有响应（正在重启、发布，或已经停了），地址栏会停在要打开的页面，屏幕上显示"正在连接服务器…恢复后自动打开页面"，服务端一回来就自己打开，不用手动刷新。不再约 20 秒后跳到单独的 503 页面，也没有"重试"和"登录"按钮了（`/503` 路由已删除）。这段加载期间的失败不再弹错误提示。服务端自己返回 5xx 并持续约 20 秒时，仍然进入登录页。见[接口请求 · 服务端暂时连不上](/core/web-request#服务端暂时连不上)。
* **README**：补充功能概览、截图和相关指南的链接。

升级步骤：

* 没有数据库迁移，没有环境变量和依赖的变化，只改了前端，重新构建前端即可。

## 1.6.0 · 2026-10-20

新增 MCP 智能体接入，默认关闭。**MCP**（模型上下文协议）是让智能体（AI 助手）发现和调用工具的公开标准；打开后，智能体可以以某个用户的身份调用后台的工具，权限不超过这个用户本人。见[MCP 智能体接入](/features/mcp)，仓库里的完整说明见[智能体接入文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/mcp.md)。

新增：

* **开关**：在服务端环境变量里设 `APP_MCP=true` 才加载这个模块，改完要重启。关闭时 `/api/mcp`、它的发现文档和所有管理接口都返回 404，**MCP 工具**、**访问令牌** 两个页面也看不到。运行中还可以用只有超级管理员能改的参数 `mcp.paused` 紧急停止所有工具调用。
* **端点**：`POST /api/mcp`，只提供工具（初始化、列出工具、调用工具），无状态。工具就是服务里加了 `@McpTool` 的方法，启动时自动注册，写法见[给模块加 MCP 工具](/core/mcp)。
* **两种接入方式**：个人访问令牌（在个人中心的 **访问令牌** 页签里用当前密码创建，只显示一次，有效期最长 90 天或不过期，可以限定工具和是否允许写入，随时可以吊销；用户被停用、删除、改密或重置密码、被管理员强制下线，或租户被停用时永久失效）；以及在客户端管理里登记的 OAuth2 客户端，使用新的授权范围 `mcp`、`mcp.write`。两种方式都以令牌所属用户本人的权限、数据范围和租户运行。
* **护栏**：急停、每个令牌限流、按工具停用、令牌的工具清单和写入许可、权限点、参数校验（最多 32 层、16 KiB）、超时、输出里的密钥字段遮蔽和 64 KiB 上限；每次调用在操作日志里记一条“智能体调用”，标明是智能体代用户做的。
* **示例工具**：`iam.me.get`、`iam.user.search`（和用户列表同样的数据范围）、`cfg.dict.options`，以及写入类工具 `demo.book.create`。

变化：

* **升级模板时冲突更少**：模板的服务端测试不再写死模板自己的结构（迁移清单从迁移目录读取，表和列改成按规则检查）；项目自己的平台表和全局唯一键登记在 `apps/server/src/db/project-tables.ts`，不用再改模板的清单。新增[升级模板版本](/guide/upgrade)指南。
* **服务端测试更快**：迁移往返测试在一个进程里完成，大约快一倍；脚本超时可以用 `QW_TEST_SCRIPT_TIMEOUT_MS` 调整，超时被终止时立即失败并写明脚本和用时；本地设 `QW_TEST_REUSE_DB=1` 时，迁移、种子和模块开关都没变就复用测试库（`pnpm ci:local` 和 CI 照常重建），见[后端测试 · 加快测试](/backend/testing#加快测试)。
* **迁移时间戳检查**：`pnpm verify` 拒绝时间戳重复或格式不对的迁移文件。新建迁移请用真实的当前时间，精确到秒。

升级步骤：

* 本版有 1 个数据库迁移，创建访问令牌表和工具停用记录表。**无论开关是否打开，这两张表都会创建**。`pnpm db:seed` 写入 **MCP 工具**、**访问令牌** 两个菜单和参数 `mcp.paused`（开关关闭时菜单不显示）。
* 新增服务端环境变量 `APP_MCP`，默认 `false`，不需要这个模块就不用设置。打开的步骤见[部署 · 智能体接入](/guide/deploy#智能体接入-mcp)。
* 服务端新增一个依赖 `@modelcontextprotocol/sdk`（1.32.1，MIT 协议），这是 MCP 的官方开发包，`pnpm i` 会装好。
* 要让 OAuth2 客户端接入时，反向代理必须把 `/.well-known/oauth-protected-resource` 和 `/.well-known/oauth-authorization-server` 转给服务端。很多 nginx 配置会拦截以点开头的路径，要在拦截之前单独放行这两个，见[部署 · 智能体接入](/guide/deploy#智能体接入-mcp)。只用个人访问令牌时不需要。
* 从模板建立的项目，合并新版本的方法见[升级模板版本](/guide/upgrade)。
* 照常升级：更新到 v1.6.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.5.0 · 2026-10-20

新增微信公众号管理模块，默认关闭。**公众号**是企业或个人在微信里开设的官方账号，这个模块让你在后台里管理一个或多个公众号。见[微信公众号](/features/wxoa)，仓库里的完整说明见[公众号管理文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/wxoa.md)。

新增：

* **开关**：在服务端环境变量里设 `APP_WXOA=true` 才加载这个模块，改完要重启。关闭时完全不加载：所有 `/api/wxoa/*` 接口（包括接收微信推送的回调地址）返回 404，不运行它的定时任务，不访问微信，侧栏和角色授权树里也看不到它的菜单。
* **接入与互动**：每个租户可以接入多个公众号，密钥只写不读；接收微信推送（明文、兼容、安全三种加密方式，校验签名、拒绝重放）；消息记录和会话，可以回复客服消息；自动回复（包括扫码回复）；自定义菜单和个性化菜单，带手机预览；粉丝、标签和黑名单，可以导出 Excel；永久素材；模板消息；渠道二维码，扫码关注的粉丝自动打标签。这一组已经用微信测试号验证过。
* **内容与运营**：图文草稿、发表和发表记录、群发（提交结果不明时，可以在微信 24 小时防重复的期限内重发）、数据统计图表、文章留言、订阅通知。按微信的规则需要已认证的服务号；目前只在模拟微信接口的测试环境里验证过。
* **多租户**：每个租户管理自己的公众号；一个 AppID 只能接入一个租户（打开多租户时，新建账号先用 AppSecret 向微信验证一次）；定时任务逐个处理可用的租户；平台人员可以按 AppID 查出是哪个租户占用了它。
* **测试**：服务端测试拒绝使用没有登记的数据库和 Redis 库号组合，并给每个测试数据库加运行锁，两个代码目录同时跑测试时不会再互相清掉对方的数据。

升级步骤：

* 本版有 4 个数据库迁移，用来创建公众号的数据表。**无论开关是否打开，这些表都会创建**；开关关闭时它们保持为空。`pnpm db:seed` 照常写入公众号的菜单、字典、参数和两个定时任务（开关关闭时这两个任务不按计划执行）。
* 新增服务端环境变量 `APP_WXOA`，默认 `false`，不需要这个模块就不用设置。打开的步骤见[部署 · 公众号模块](/guide/deploy#公众号模块)。
* 服务端新增一个依赖 `fast-xml-parser`（5.11.2），用来解析微信推送的 XML，`pnpm i` 会装好。
* 照常升级：更新到 v1.5.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.4.1 · 2026-10-20

界面细节调整，没有功能变化。

变化：

* **对话框底部**：按钮区改成横贯整个弹窗底部的浅色底带，上方有一条分隔线，按钮间距统一，窄屏上自动换行。
* **表格加载**：表格第一次加载时先显示真实的表头，下面是占位行；"加载中"的文字只给读屏软件（视障用户使用的朗读工具）读出。

升级步骤：

* 本版只改前端样式：没有数据库迁移，环境变量和依赖也没有变化。照常升级：更新到 v1.4.1 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。自己改过对话框样式的项目，升级时留意合并。

## 1.4.0 · 2026-10-15

安全修复版本。对模板做了一轮安全审查，这一版修复审查中确认的问题，另外修复一个日期显示的问题。升级前请先看下面的“升级步骤”，有两项可能需要你先处理。仓库里的完整防护清单见[安全文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/security.md#威胁防护与测试入口)。

安全：

* **重置密码、修改手机号按授予判断**：给别人重置密码，或者设置别人的登录手机号，等于拿到了这个账号。所以现在要求：你必须能把这个用户当前持有的全部角色（停用的也算）分配给别人，和分配角色的规则一样；否则返回 403，提示“该用户持有你不能授予的角色：只有能授予这些角色的管理员才能重置其密码或修改其手机号”。以前只有“重置密码”权限的人（比如服务台角色）可以重置比自己权限更大的用户，现在不行了。租户管理员只按它自己持有的权限点和平台专属的权限点判断，角色里停用菜单或套餐外菜单的权限点不会挡住它。见[防越权授予](/features/permission#防越权授予)。
* **移动部门按授予判断**：把部门移到新的上级部门下面，新上级里持有“本部门及下级”角色的人从此就能看到它，所以这也算一次授予，超出你的权限范围时返回 403，提示“不能授予超出自己权限或数据范围的角色”。
* **登录 CSRF 防护**：CSRF（跨站请求伪造）是指别的网站诱导你的浏览器向本系统发请求。密码登录和短信登录现在拒绝来自别的网站、或 `Origin` 为 `null` 的请求，返回 403（错误码 `A1007`，提示“请求来源不被允许”），这样别的网站没法把它自己的账号悄悄登录进你的浏览器。不带 `Origin` 头的请求（App、脚本）和手机端登录不受影响。
* **登录用户名格式**：登录时的用户名必须符合账号的保存格式（字母、数字和 `_ . @ -`，全角字符先转成半角），其他写法直接返回 400，不再能借此试探账号是否存在。
* **并发猜密码**：同时发出的多个密码尝试，最多只有“锁定阈值”那么多次能走到密码校验；密码正确、但后面的步骤失败时，这次尝试不计入失败次数。
* **Excel 导入**：导入前按文件的真实结构重建文件，并在解析前统计每个部分解压后的真实大小，谎报大小的文件直接返回 400（“不是有效的 Excel（.xlsx）文件”），不会再耗尽内存。
* **其他**：字典和参数的读取忽略不符合编码格式的写法（不会为每种写法各存一份缓存）；每个用户最多保存 200 份列表设置，超出返回 409，“恢复默认”会删除这一份、腾出名额；预签名下载链接在请求日志里打码；日志保留天数 `audit.retention_days` 只有超级管理员能改；已停用的用户不再收到微信订阅消息提醒。
* **移动端 H5 调试服务器**：只提供 App 和共享代码的源文件，关闭了 CORS，只回应本机名称和 IP 地址的访问；要用 `*.local` 名称或内网穿透域名访问时，设置环境变量 `QW_H5_ALLOWED_HOSTS`，见[移动端开发 · 在浏览器里调试（H5）](/core/mobile#在浏览器里调试-h5)。

修复：

* **日期列**：`DATE` 类型的列（比如图书的出版日期），在服务端进程所在时区比 UTC 晚（西半球）时不再提前一天。

升级步骤：

* 本版没有数据库迁移，依赖没有变化，服务端的环境变量也没有变化。新增的 `QW_H5_ALLOWED_HOSTS` 只给移动端 H5 调试服务器用，按需设置。改动了 `mobile/vite.config.ts`，自己的项目里改过它的，合并时留意。
* **反向代理**：控制台的密码登录和短信登录现在核对 `Origin`。反向代理必须把浏览器发来的 `Host` 和协议（http / https）原样转给服务端，或者把控制台的地址加进 `CORS_ORIGIN`，否则控制台登录会返回 403 `A1007`。按[部署](/guide/deploy#反向代理-nginx)里的 nginx 示例配置的，刷新令牌本来就要求这一点，不用改。见仓库的[部署文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/deploy.md#nginx-反向代理与-csp)。
* **不符合格式的用户名**：用户名不符合保存格式（字母、数字和 `_ . @ -`；全角字符先转成半角）的账号，比如用 SQL 直接导入的中文登录名，升级后登录会返回 400。升级前先把这些账号改成符合格式的用户名。
* 再照常升级：更新到 v1.4.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.3.1 · 2026-10-15

补丁版本，新增后端的断点调试开关，方便在开发时给服务端打断点。

新增：

* **后端断点调试**：用 `QW_INSPECT=1 pnpm dev`（PowerShell 用 `$env:QW_INSPECT=1; pnpm.cmd dev`）启动开发服务，只有后端应用进程在 `127.0.0.1:9229` 打开 Node 调试端口，并打开 source map，断点可以直接打在 TypeScript 源文件上；把 `1` 换成端口号（1024 到 65535）可以换端口。
* **VS Code 调试配置**：仓库里提交了 `.vscode/launch.json`，包括附加到后端的配置 **Server: attach (pnpm dev with QW_INSPECT=1)**（后端每次重启后自动重新附加），以及用 Edge / Chrome 打开 Vite 开发服务器调试前端的两个配置。用法见[断点调试](/backend/breakpoints#后端)。

升级步骤：

* 本版只改开发工具：没有数据库迁移，环境变量和依赖也没有变化，`QW_INSPECT` 只在本机开发时按需设置，不用写进 `.env`。改动的是开发启动脚本 `scripts/dev-server.mjs`、新增的 `.vscode/launch.json` 和 `.gitignore`（让 `.vscode/launch.json` 能被提交）；自己的项目里改过这几个文件的，合并时留意。照常升级：更新到 v1.3.1 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.3.0 · 2026-10-14

新增任务队列。任务队列用来把耗时的工作（比如生成报表）交给后台执行：页面上的请求只把一个**任务**放进队列就返回，由后台的**处理器**取出来执行。队列基于 BullMQ，直接用应用已有的 Redis，不需要另外部署消息服务。仓库里的完整说明见[任务队列文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/queue.md)。

新增：

* **任务队列**：模块用 `registerQueue` 声明队列，写一个继承 `TenantJobProcessor` 的处理器，再用 `QueueService.add` 添加任务。添加时自动记下当前租户，任务在这个租户里执行；任务里没有租户时立即失败，不重试。默认最多尝试 3 次，失败后等待的时间逐次加倍；保留最近 1000 个完成的任务和 5000 个失败的任务。任务至少执行一次，处理器要能安全地重复执行。每个实例都运行处理器，关闭时先等执行中的任务完成。
* **队列监控页**：**系统监控 → 队列监控**，属于平台页面，打开多租户时只有平台的 root 能打开。按队列显示各状态的任务数和是否暂停，按状态查看任务（任务数据里的秘密字段被遮蔽），可以重试失败的任务、删除任务。权限是 `monitor.queue.browse` / `retry` / `remove`，重试和删除记入操作日志。模板本身还没有注册队列，所以页面目前显示“还没有注册任何队列”。见[监控与日志 · 队列监控](/features/monitor#队列监控)。

升级步骤：

* 本版没有数据库迁移，环境变量也没有变化。服务端新增两个依赖：`bullmq`（^6.3.14）和 `@nestjs/bullmq`（^12.0.0），`pnpm i` 会装好。新菜单由种子写入，所以要执行 `pnpm db:seed`。
* 升级前先检查 Redis：
  * `maxmemory-policy` 必须是 `noeviction`。其他策略在内存不足时会淘汰键，排队中的任务会悄悄丢失。这个设置写在 `redis.conf` 里（应用的账号不能执行 `CONFIG`）；Homebrew 安装的默认值就是 `noeviction`。不符合时应用照常启动，只记一条警告日志。
  * 应用用的 Redis ACL 用户需要只读的 `INFO` 命令（例如在持久 ACL 里加 `+info`）：任务队列每条连接建立时读取 Redis 版本，启动时读取淘汰策略。
  * 每个处理器在每个实例上多占两条 Redis 连接，给连接数留出余量。
* 再照常升级：更新到 v1.3.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.2.1 · 2026-10-14

补丁版本，修复两个问题。

修复：

* **上次登录时间**：登录后显示的"上次登录时间"不再依赖应用服务器和数据库的时钟一致，登录日志的时间改由应用写入。升级前就已登录的会话，下次登录后显示正确。
* 三个服务端测试在 Windows 上，或在时钟和数据库有偏差的机器上，不再失败。

升级步骤：

* 本版只改代码：没有数据库迁移，环境变量和依赖也没有变化。照常升级：更新到 v1.2.1 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.2.0 · 2026-10-14

手写 SQL 也能加上数据范围了。数据范围决定一个人能看到哪些部门、哪些人的数据，见[权限与数据范围](/features/permission#数据范围)。用 `scopedQb`（带数据范围的查询构造器）写的查询一直自动带上数据范围；代码里手写的 SQL 不经过它，以前只能靠开发者自己记得加。

新增：

* **手写 SQL 的数据范围**：`dataScopeSql(alias, columns)` 和 `dataScopeSqlFor(实体, alias)` 返回和 `scopedQb` 同样的部门、本人条件，形式是带参数的 `{ sql, params }`，直接拼进手写 SQL。
* **新的检查**：`pnpm verify` 会报出读带数据范围的表、却既没用上面的函数、也没写 `qw:no-data-scope <理由>` 标记的手写 SQL，QueryBuilder 里用表名字符串查询或联表的写法也算在内。SQL 不会被自动改写。写法见[手写 SQL：dataScopeSql](/core/permission#手写-sql-datascopesql)，仓库里的完整说明见[数据权限 · 手写 SQL](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/data-scope.md#手写-sql)。

升级步骤：

* 本版只改代码：没有数据库迁移，环境变量和依赖也没有变化，可以回退到 1.1.0。照常升级：更新到 v1.2.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。
* 模板自带的手写 SQL 都已经处理好。项目自己写过手写 SQL、并且读带数据范围的表（实体带 `@DataScoped` 的表）时，升级后 `pnpm verify` 会报出这些查询，直到给它们拼入 `dataScopeSqlFor` / `dataScopeSql` 的条件，或写上 `qw:no-data-scope <理由>`。结果是给当前用户看的（列表、下拉选项、导出、页面上的统计）就拼入条件；登录、定时任务这类系统查询就写标记。

## 1.1.0 · 2026-10-14

新增多租户。多租户（multi-tenancy）是指一套部署同时服务多家公司或组织，每一家叫一个**租户**，各家的数据互相看不到。所有租户共用一个 MySQL 数据库，每行数据用 `tenant_id` 列标明属于哪个租户。多租户默认关闭；关闭时系统和 1.0.x 完全一样，所有数据都属于内置的**默认租户**（编码 `default`，也就是运营这套系统的平台方）。功能介绍见[多租户](/features/multi-tenancy)，仓库里的完整说明见[多租户文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/multi-tenancy.md)。

新增：

* **多租户开关**：服务端环境变量 `APP_MULTI_TENANT`，默认 `false`，只在启动时读取。界面上没有开关，改完要重启全部实例才算切换完成。
* **数据隔离**：属于租户的每行数据都带 `tenant_id`。ORM（把数据库表映射成代码对象的库，这里是 TypeORM）在读写时自动加上租户条件；手写的 SQL 要自己写租户条件，漏写时检查脚本和测试会报错。
* **租户管理**（平台页面）：一步开通租户，同时建好根部门、内置的“租户管理员”角色、流程模板和管理员账号，管理员的初始密码只显示一次。可以设到期时间、用户数上限、绑定多个域名、品牌名称和 logo，可以停用、启用和重置初始密码。租户停用或到期后，它的会话立即结束，数据保留。
* **租户套餐**：规定一个租户能用哪些菜单，由服务端强制执行：用户的权限等于角色授权和套餐的交集。不在套餐里的功能，接口返回 404。
* **按租户登录**：网页、H5、App 和小程序都可以填租户编码登录；网页和 H5 也可以按绑定的域名识别租户，不用填编码。编码不存在、租户停用或到期时，返回的结果和密码错误完全一样，别人无法借此试探哪些编码存在。登录失败锁定、短信验证码、找回密码、OAuth 授权同意和微信绑定都按租户分开。
* **平台人员进入租户**：有“进入租户”权限的平台人员可以进入某个租户排查问题，进入时必须填写原因。进入后页面顶部一直显示横幅，2 小时后自动退出；进入、退出和进入期间的每个请求都记入审计。
* **平台页面**：菜单、字典、参数、存储配置、消息模板、代码生成、定时任务、系统监控等平台页面属于默认租户，其他租户看不到。开关打开后，API 访问日志、API 错误日志和缓存列表只有平台的超级管理员能用。操作日志和登录日志会显示操作者所在的租户。
* **代码生成**：生成的代码带租户列和 `@TenantColumn()`，生成的接口测试包含“访问别的租户的数据返回 404”的用例。怎样编写支持租户的业务代码，见[仓库说明](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/multi-tenancy.md#编写租户感知的项目代码)。
* **演示数据**：`APP_DEMO_MODE` 和 `APP_MULTI_TENANT` 都打开时，会创建两个示例租户，各有自己的套餐和品牌。

变更：

* 新建的表默认是租户表。所有租户共用的平台表要登记到 `PLATFORM_TABLES`，在所有租户之间都不能重复的唯一键要登记到 `GLOBAL_UNIQUE`（都在 `apps/server/src/core/db/tenant-tables.ts`）。

升级步骤：

* 本版的数据库迁移只加列和索引，和上一版的代码兼容。开关保持关闭时，升级不用停服，也可以回退到上一版。
* 先备份数据库、上传文件和密钥，再照常升级：更新到 v1.1.0 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。
* 想打开多租户：新安装可以一开始就打开；已有的数据库要**分两次部署**。第一次保持开关关闭，升级到 1.1.0，确认全部实例都正常；第二次把开关改为 `true` 再部署，这时 `db:migrate` 会去掉租户列的默认值。默认值没去掉时，生产环境里开关打开的服务拒绝启动，所以两步不能合成一次。打开前，先复核默认租户里哪些角色有平台菜单：打开后，这些角色仍能使用影响全部租户的平台页面。步骤见[部署 · 打开或关闭多租户](/guide/deploy#打开或关闭多租户)和仓库的[部署文档](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/deploy.md#打开多租户开关)。
* 租户不能删除，只能停用或设到期时间。关闭开关前，先停用所有不再服务的租户，见仓库的[关闭多租户开关](https://github.com/732124645/qiwu-vue-admin/blob/main/docs/deploy.md#关闭多租户开关)。

::: warning 打开后不能退回旧版本
打开过多租户开关的数据库，不能再回到 1.1.0 以前的任何版本，包括 1.0 系列的补丁版。旧版本的代码不按租户过滤数据，插入数据时也会因为缺少租户列而报错。
:::

已知限制：

* 一个微信号只能绑定一个租户里的账号；
* 在主域名上，同一个浏览器同一时间只能登录一个租户；
* 改绑域名最多 60 秒后生效；
* 修改套餐后，所有会话都会重新加载一次权限。

## 1.0.3 · 2026-10-06

新增自动检查、自动发布和服务器部署套件，并修复几个问题。1.0.1 和 1.0.2 打了版本标签，但自动检查没有通过，所以没有发布；它们的内容都包含在 1.0.3 里。

新增：

* **自动检查（CI）**：CI 即持续集成（Continuous Integration），指每次提交代码后自动运行检查。公开仓库每次推送到 main 分支、每次提交合并请求（PR）时，都会用 GitHub Actions（GitHub 自带的自动化服务）启动 MySQL 8.4 和 Redis 8，运行完整检查 `pnpm ci:local`，包括电脑端和移动端的浏览器测试。也可以在 GitHub 上手动运行。
* **自动发布**：推送 `vX.Y.Z` 格式的版本标签后，先确认同一提交在 main 分支上已经通过自动检查，再用模板仓库 `CHANGELOG.md` 里对应版本的说明创建 GitHub 发布页；在 GitHub 的 `demo` 环境（仓库里的一项部署设置，可以指定审批人）审批通过后，通过 SSH 部署演示站。
* **服务器部署套件**（`scripts/deploy/`）：每个版本部署到单独的目录，`current` 链接一次切换到新版本；env 文件由各版本共用；PM2 以集群模式（同时运行多个进程）逐个重启进程，服务不中断；切换后做健康检查（确认服务能正常响应），失败时自动切回上一版本的代码，数据库不回退。部署用的 SSH 密钥只能执行部署命令。详见[部署 · GitHub Actions 自动部署](/guide/deploy#github-actions-自动部署)。

修复：

* `pnpm ci:local` 在 verify 之前先构建共享包 `@qiwu/shared`，刚克隆的仓库也能通过完整检查。
* 移动端：组件库 wot-ui 自带的文字（比如输入框的占位文字）在英文界面下显示英文，开发时和重启后的第一屏也一样。
* 移动端工作台：较长的英文副标题在顶部插画的左侧换行，不再压到插画下面。

升级步骤：

* 这个版本没有新的数据库迁移，依赖和 env 配置项也没有变化；
* 先备份数据库、上传文件和密钥，再照常升级：更新到 v1.0.3 的代码 → `pnpm i` → `pnpm -r build` → `pnpm db:migrate` → `pnpm db:seed` → 重启服务，详见[部署](/guide/deploy)。

## 1.0.0 · 2026-10-05

第一个正式版本，基于 MIT 协议开源。主要内容：

* **账号与权限**：账号密码登录、短信登录和找回密码、注册（默认关闭）、图形和滑块验证码、微信小程序登录；用户、角色、菜单、部门、岗位管理；五种数据范围；在线用户和强制下线。
* **界面与多语言**：中文和英文界面；侧边、顶部、混合三种布局，暗色模式，浅色 / 深色侧栏，多标签页，锁屏，用户名水印；统一的表格和表单，每个用户可以保存自己的列设置；工作台。
* **系统设置、审计与监控**：字典、参数设置、通知公告；操作日志、登录日志、API 访问日志和错误日志；服务器、MySQL、Redis 监控和缓存管理；地区和 IP 归属地；接口文档；定时任务。
* **文件、Excel 与消息**：本地和 S3 兼容存储、浏览器直传、私有文件鉴权下载；Excel 导入导出；站内信、邮件、短信；Socket.IO 实时推送。
* **代码生成**：单表、树表、主子表三种模板，页面和命令行两种用法，可以同时生成移动端页面；新项目初始化脚本。
* **工作流与表单**：树形流程设计器和 BPMN 设计器；会签、或签、条件分支、退回、转办、加签、撤回等审批操作；审批中心；表单设计器、动态表单审批、零代码审批；超时自动处理。
* **OAuth2 与单点登录**：授权码 + PKCE、刷新令牌、客户端凭证；客户端管理和授权同意页。
* **移动端（可选）**：基于 uni-app 的员工端，支持微信小程序、安卓和 iOS，包含登录、工作台、审批、消息、实时推送和浅色 / 深色主题；真机和应用商店发布前的核对仍在进行。
* **安全**：默认开启权限和数据范围检查、防重复提交、限流、富文本过滤、上传文件检查、防 SSRF、Excel 公式注入防护；生产环境拒绝使用测试密钥；演示模式拒绝大部分写操作（登录、切换语言、标为已读等少数操作除外），并对访客的 IP 和浏览器信息脱敏。
* **部署**：编译产物 + nginx 反向代理，可选 PM2；支持多实例部署（跨实例推送和共享限流）。
* **Windows**：Windows 11 + 自带的 PowerShell 5.1 可以完成全部开发和检查。

已知限制：

* 还不支持多租户；即时通讯和 App 离线推送计划在以后的版本中提供；
* OAuth2 只支持机密客户端，暂不支持公开客户端和 OIDC；
* BPMN 设计器支持的是一部分标准元素，发布时转换成树形流程运行；
* 后台管理界面面向电脑浏览器（宽度 1280～1920）；
* Docker 镜像和 docker-compose 方案还没有提供。

以后每个版本的变化和升级步骤，都会记录在这里。
