发布v2.17.8版本，更新内容请查看：https://github.com/bufanyun/hotgo/blob/v2.0/docs/guide-zh-CN/start-update-log.md

docs/guide-zh-CN/start-deploy.md

@@ -78,7 +78,7 @@ pnpm run build 或 npm run build
 ### Nginx配置
 ```
       # websocket
-      location ^~ /socket  {
+      location = /socket  {
   			proxy_pass http://127.0.0.1:8000/socket;
   			proxy_set_header X-Real-IP $remote_addr;
   			proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
@@ -98,7 +98,9 @@ pnpm run build 或 npm run build
           proxy_set_header  X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
           proxy_set_header X-Forwarded-Proto $scheme;
-          proxy_pass http://127.0.0.1:8000/; # 设置代理服务器的协议和地址
+          proxy_pass http://127.0.0.1:8000/;
+          proxy_redirect off;
+          proxy_buffering off;
           proxy_http_version 1.1;
           proxy_set_header Upgrade $http_upgrade;
           proxy_set_header Connection upgrade;

docs/guide-zh-CN/start-issue.md

@@ -22,7 +22,7 @@
 
 #### 1、安装数据库出现 json 报错不支持
 
-请安装 mysql5.7 及以上版本的数据库
+请安装 mysql5.7 及以上版本的数据库。如果你使用的是mariadb请确认版本号，mariadb从 10.2 版本开始支持 json 数据类型。
 
 
 
@@ -50,7 +50,31 @@
 
 系统运行目录下配置hack/config.yaml文件。如果是生产环境运行，并且不需要开发工具相关功能，可以将`manifest/config/config.yaml`配置文件中的`system.mode`值改为`product`，这样启动时不会加载开发工具相关功能
 
+#### 4、非超管角色提示：你没有访问权限！
+![1.4.0.png](./images/issue/1.4.0.png)
 
+此问题因当前角色访问的页面包含未分配权限的接口所致，在多角色场景中较为常见，解决步骤如下：
+
+1. 定位缺失权限的接口
+- 用超管账号进入系统应用 -> 日志管理 -> 全局日志，搜索状态码为`62 无访问权限`的记录
+- 示例：若请求接口为`/admin/hgexample/treeTable/list`，需处理的权限路径为`/hgexample/treeTable/list`（去除`/admin`前缀）
+
+![1.4.1.png](./images/issue/1.4.1.png)
+
+假如查到请求接口是：`/admin/hgexample/treeTable/list`，那需要分配的菜单权限就是：`/hgexample/treeTable/list`,要把`/admin`去掉
+
+2. 配置菜单权限
+- 进入权限管理 -> 菜单权限：
+- 若目标菜单不存在，先新增菜单
+- 若菜单已存在但未配置接口权限，就把步骤1中的权限路径添加到【分配权限】中（已配置则跳过）
+  
+![1.4.2.png](./images/issue/1.4.2.png)
+
+3. 分配权限给角色
+- 进入权限管理 -> 角色权限，找到对应角色并点击【菜单权限】
+- 勾选步骤2中配置的菜单权限，保存即可
+
+![1.4.3.png](./images/issue/1.4.3.png)
 
 ### 四、前端相关
 

docs/guide-zh-CN/start-update-log.md

@@ -11,6 +11,20 @@
 
 > 如果升级(覆盖)代码后打开会出现 sql 报错, 请检查更新的数据库格式或自行调整
 
+
+### v2.17.8
+updated 2025.7.13
+
+- 优化：表格排序处理器兼容关联表别名
+- 优化：优化动态统计数字在0值时显示问题
+- 优化：优化首页快捷菜单点击事件范围
+- 优化：优化短信、邮件验证码相关验证类数据排序
+- 优化：优化Nginx配置，支持流式请求和兼容部分版本无法匹配到websocket规则问题
+- 优化：naive-ui版本升级到2.42.0
+- 优化：vue3-json-viewer版本升级到2.4.1
+- 修复：修复可选用户选项`Fields`生成错误问题
+
+
 ### v2.16.10
 updated 2025.3.22
 

docs/guide-zh-CN/sys-code.md

@@ -176,7 +176,7 @@ CREATE TABLE `hg_test_category` (
 
 1.3 插入测试数据
 ```mysql
-INSERT INTO `hg_test_table` (`id`, `category_id`, `title`, `description`, `content`, `image`, `attachfile`, `city_id`, `switch`, `sort`, `status`, `created_by`, `updated_by`, `created_at`, `updated_at`, `deleted_at`) VALUES (1, 1, '测试标题', '描述', '<h2><strong>不知道写点啥！</strong></h2><p><br></p><iframe class=\"ql-video\" frameborder=\"0\" allowfullscreen=\"true\" src=\"https://media.w3.org/2010/05/sintel/trailer.mp4\"></iframe><p><br></p><p><img src=\"http://bufanyun.cn-bj.ufileos.com/hotgo/attachment/2023-02-09/cqdq9iuv0phsg8patk.png\"></p>', 'https://bufanyun.cn-bj.ufileos.com/hotgo/logo.sig.png', 'http://bufanyun.cn-bj.ufileos.com/hotgo/attachment/2022-12-30/cpf1x44idoycrtajf2.xlsx', 110102, 1, 10, 1, 0, 1, '2022-12-15 19:30:14', '2023-02-23 13:55:32', NULL);
+INSERT INTO `hg_test_table` (`id`, `category_id`, `title`, `description`, `content`, `image`, `attachfile`, `city_id`, `switch`, `sort`, `status`, `created_by`, `updated_by`, `created_at`, `updated_at`, `deleted_at`) VALUES (1, 1, '测试标题', '描述', '<h2><strong>不知道写点啥！</strong></h2><p><br></p><iframe class=\"ql-video\" frameborder=\"0\" allowfullscreen=\"true\" src=\"https://media.w3.org/2010/05/sintel/trailer.mp4\"></iframe><p><br></p><p><img src=\"https://gmycos.facms.cn/hotgo/attachment/2023-02-09/cqdq9iuv0phsg8patk.png\"></p>', 'https://gmycos.facms.cn/hotgo/logo.sig.png', 'https://gmycos.facms.cn/hotgo/attachment/2022-12-30/cpf1x44idoycrtajf2.xlsx', 110102, 1, 10, 1, 0, 1, '2022-12-15 19:30:14', '2023-02-23 13:55:32', NULL);
 
 ```