AnQiCMS v3.6.7 更新说明

📅 2026-10-20 👁️ 6

2026 年 10 月 20 日发布

设置保存

这版改动最多的地方是设置保存。

后台设置页是一个页面分成多个标签，你在「基本设置」里改个东西点保存，程序会把整页一起提交过去——但那些你没打开过的标签上是空的，于是「SEO」「邮件」「水印」里你从来没碰过的设置就被清成默认值了。整个过程不报错，保存照样提示成功。

现在改成你改了哪几项就只存哪几项，没碰过的原样保留。前端也顺手修了另一个毛病：在标签页之间来回切的时候，填了一半的内容不会被丢掉。

涉及站点设置、内容设置、安全设置、联系方式这四页，以及 AI 设置、访问限制、多语言、站点地图这几个插件页。

升级后建议把这几页逐个打开看一遍。之前真被清空过的，得重新填。

图片的 alt 文字是搜索引擎和 AI 读取图片时唯一的说明，缺了它 AI 就不知道图里是什么，直接影响内容能不能被搜到和引用。

保存文章时会自动给正文里没写 alt 的图片补上文章标题，第一张用标题，后面几张加序号避免重复。你自己写过的不会被覆盖。

开关在「设置 → 内容设置」里的「图片Alt优化」，默认关闭，需要手动打开。打开后只对之后保存的文章生效；老文章要补的话跑一次 POST /archive/fill-img-alt，只填空缺不动已有的，执行完会告诉你处理了多少篇文章、补了多少张图。

用对象存储时部分文件上传会失败，比如 Zombie Nation (USA).zip 这种名字就传不上去。

原因是拼上传地址的时候把文件名里的特殊符号转义了，算上传凭证时用的却是转义之前的地址，两边对不上，服务端直接拒绝。这也解释了为什么只有部分文件出问题——photo.jpg 这类名字不受影响，带括号、空格、中文、%、# 的才会。

现在两边算法统一，这类名字都能正常上传。

站点地图的「手动生成」按钮以前会在生成前偷偷保存一次设置，只要那次拿不到完整设置值，站点地图配置就会被清成默认值，按钮照样提示成功。现在生成只读已保存的配置。

验证码图片是一次性的，浏览器或中间缓存把上一次的返回给页面，就会出现「点了图片不换」「怎么都填不对」。现在明确标记不缓存。

切换模板后某些情况下前台还显示旧模板，原因是模板加载器把模板目录记住了，切换时没重新加载。现在会彻底重载，同时清掉残留的页面缓存。

模板文件有语法错误时，以前只会看到一个空白 404 页，你根本不知道哪里写错了。现在会给具体错误提示，日志里也看得到，修好文件不用重启就生效。

AI 编辑器会给每个段落、标题、表格、图片生成一串唯一编号（data-id="40b375eb-..."）。这串东西是给多人协作编辑用的，单人站点用不上，却会跟着正文进数据库、进模板、进 AI 抓取结果，占地方又没含义，已经关掉。标题上用于生成文档目录的属性不受影响。

菜单改成三级之后，顶部搜索框只能搜到旧的两级菜单，三级功能一个都搜不到。现在改成递归查找，搜索结果带上所属分类，搜「SEO」会列出该分类下全部功能。

仪表盘新手引导里几步（伪静态、robots、站点地图）、附件替换、素材入口、关键词、留言邮件设置这些地方的链接还指着改造前的旧地址，点进去是空白页，都修了。

「一键复制 MCP 配置」里的服务名原来固定叫 anqicms，多站点时不好区分，现在跟随站点名称，页面上也显示当前用的名字。

改设置可以只传要改的字段，不用再「先读一遍再整包写回去」，也不会误伤其它配置项。

站点地图的调用参数做了清理。生成接口已经不读调用参数，之前工具还会传一堆配置项过去，属于看起来能设实际无效的假参数，去掉了。

先把数据库和 uploads 目录备份一份。这批改动涉及设置保存逻辑和模板加载，测试都覆盖了，但备份一次更稳妥。

如果你在用对象存储：这次修的是文件名字符导致的上传失败。要是遇到的是提示密钥无效，那属于另一类问题，得去存储服务商那边确认密钥有没有权限访问你填的存储桶名。

技术细节见 CHANGELOG.md。