🎉 NanZi AI Agent Platform v1.0.8 Release Notes

GitHub Repository: RandyChen1985/nanzi-ai-agent-platform

v1.0.8 版本是一次智能体主类型与委派就绪、会话资源范围与本轮元数据集挂载、证据时效与反幻觉语义帧、门户折叠体验、Embed 思考链与聊天交互升级，并集中修复一批线上体验缺陷的重大迭代版本。在本次更新中，平台引入智能体主类型（GENERAL / CHATBI / KNOWLEDGE_BASE）与委派就绪检查；会话资源范围可持久化，并支持本轮元数据集挂载优先于会话范围；统一请求语义帧与证据时效，阻断无据编造；新增可访问资源目录工具与 ChatBI 来源感知路由门控；数据/知识库门户支持卡片完全折叠、更新时间展示与视觉精简；EmbedChat 强化思考链移动端体验、排版样式偏好、专家/技能级联入口；并新增 PostgreSQL 数据源、配置 AI 润色；同时修复 MySQL 特殊字符密码、HTTP 智能体中心白屏、剪贴板复制、权限缓存失效、时长异常硬拦截误杀等关键缺陷。

本次变更范围自 d824dc69da1b9bce14acd707acb954d6febcbb1b（不含，为 v1.0.7 末提交）至 68e85aba380c98b8ca6ea9f540ca44fb22d146e9（含），共 100 个提交（其中非 Merge 提交 87 个），涉及 351 个文件、约 30,517 行新增代码。

🚀 Key Features

1. 🏷️ 智能体主类型、委派就绪与配置体验

主类型落地：智能体增加面向用户的主类型（GENERAL / CHATBI / KNOWLEDGE_BASE），保留 capabilities 兼容运行时；智能体中心支持按主类型筛选。
委派就绪检查：强委派按语义选型；场景模板对齐主类型；轮次成败仅以最终状态判定。
配置完成度与欢迎卡片：优化创建/编辑配置完成度计算与欢迎卡片规则提示；版本级 welcome_config 三卡片配置。
AI 润色：配置编辑器支持 AI 润色并扩展为 8 种范式；加固解析、可取消遮罩与只读禁用。
说明弹层：执行引擎说明弹窗；智能体类型与扩展能力说明改为置顶模态框。

2. 📦 会话资源范围、本轮元数据集与资源目录

会话资源持久化：项目/会话资源范围校验强化并持久化；门户挂载交互修复。
本轮元数据集挂载：支持本轮元数据集挂载，并优先于会话范围；修复 ChatBI 本轮范围与路由。
可访问资源目录：新增可访问资源目录系统工具，优化路由短路与聊天配置侧资源识别。
轻量数据集列表：通用助手可访问数据集轻量列表；工具结果快照与新会话菜单可达。
门户解耦：门户开关不再联动智能体路由；仅在唯一智能体时自动锁定。

3. 🛡️ 证据时效、语义帧与 ChatBI 可信路由

语义帧与证据状态：统一请求语义帧与证据状态，阻断无据编造并透出时效。
取时熔断与新问优先：取时熔断收敛、证据时效与 ChatBI 新问优先；泛化相对时间锚点，减少主助手重复取时。
来源感知路由：引入 ChatBI 来源感知资格判定与路由门控。
时长异常 soft tip：时长/时延异常由硬拦截改为 soft tip + soft repair，结果照常落库，降低误判无答。
澄清体验：优化澄清缺口自检与澄清卡片；Embed 默认开启反幻觉校验。
Mermaid 规范：平台提示词补充 Mermaid 图示规范。

4. 🗄️ 数据源与运维加固

PostgreSQL：新增 PostgreSQL 数据源支持。
MySQL 连接：密码含特殊字符时使用 URL 安全编码，修复 host 误解析；完善 SQL 导入与 ENCRYPTION_KEY 说明。
权限缓存：角色与权限变更后主动失效 API Key 与权限缓存。
工具接口：工具列表接口仅需 API Key 即可读取；会话工具快照空值防护。

5. 📊 数据 / 知识库门户体验

卡片完全折叠：数据集卡片支持完全折叠与多维 UX 交互增强。
更新时间：门户展示数据集更新时间。
视觉精简：精简数据门户 / 知识库门户装饰文案与挂载展示。

6. 💬 EmbedChat / 聊天交互与思考链

思考链升级：耗时冷暖渐变、折叠进度摘要、头部总耗时实时计时；移动端思考展示、跟底滚动与序号裁切修复。
排版样式：排版偏好 Redis 持久化；新增瑞士包豪斯、复古日报、北欧禅意三套样式。
输入入口：专家入口改为胶囊与级联菜单；技能选择改为加号级联子菜单；统一 @ 提及与专家中心展示。
侧栏与画布：侧栏抽屉与画布实时拖动平滑压缩、钉住响应式；消息气泡扁平化；快捷按钮触控与数据依据样式统一。
URL 锁定智能体：EmbedChat 支持 URL 锁定智能体与快捷指令交互优化；路由切换提示改用 Toast。
日志导出：聊天日志支持 Markdown 导出。

7. 🔔 通知、任务与 Skills 工作台

站内通知：通知详情与任务中心可视化结果通知；任务结果通知调度兜底。
用户权限：细化用户管理权限，支持报表订阅页签跳转。
Skills 工作台：展示公共 Skill 显式绑定智能体；剪贴板统一降级与一键复制。
业务简报：导出走 AI 分析正文为主并附证据附录。

🐛 Bug Fixes

ChatBI / AI 运行时

时长/时延异常误杀：由硬拦截改为 soft tip + soft repair，结果照常落库，避免合法负值/大延迟导致无答。
本轮元数据集范围与路由：修复本轮挂载数据集未正确参与 ChatBI 范围与路由的问题。
工具循环熔断：熔断状态锁存，并补充模型停调工具引导，防止重复空转。
会话工具快照空值：工具快照为空时避免 NoneType.get 异常。
轮次成败判定：仅以最终状态判定轮次成败，修正中途失败被误记的问题。
非流式消息重复：修复非流式场景下消息重复展示。

认证 / 数据源 / 接口

MySQL 密码特殊字符：密码含 @ 等字符时 URL 安全编码，修复 host 被误解析；完善 SQL 导入与 ENCRYPTION_KEY 说明。
权限缓存：角色与权限变更后主动失效 API Key 与权限缓存，避免鉴权滞后。
工具列表鉴权：工具列表接口仅需 API Key 即可读取。
RAGFlow 原档下载：改用数据集接口，修复原档下载失败。

前端 / Embed / 管理端

HTTP 智能体中心白屏：修复协程序列化异常导致的中心页白屏。
剪贴板复制：统一 HTTP 环境下复制降级；修复 AgentDebug 复制反馈；Skills 编辑器支持一键复制。
Embed 路由提示抖动：路由切换提示改用 Toast，避免顶栏横幅导致页面抖动。
快捷按钮与思考序号：修复移动端快捷按钮需二次点击、思考步骤序号被裁切；统一数据依据样式。
AI 润色：加固解析与可取消遮罩；修复批量勾选；只读模式禁用润色；结果弹层置顶。
新建向导门禁：修复向导步骤门禁与跳步问题。
门户自动锁定：数据/知识库门户仅在唯一智能体时自动锁定，避免误锁。
工作台欢迎语：正确读取品牌名；澄清用户额度页保存入口。
智能体列表布局：引擎/类型徽标纵向排列、操作列保持横向可点选、列宽优化。
场景模板交付完成步：完成并进入智能体中心，修正错误落点。
通知弹框：智能体消息点击后自动收回通知弹框。

⚠️ Breaking Changes & Migration Notes

从 v1.0.7 升级至 v1.0.8 时，请特别注意以下变更：

项目	说明
数据库变更	升级前须执行 `V103` ~ `V104` 两个增量脚本（见下方数据库升级说明）。
智能体主类型	`ai_agents.agent_type` 为面向用户的主类型字段；历史数据会按 capabilities / 名称回填。列表筛选、场景模板与委派文案已对齐主类型，请回归智能体中心与委派路径。
欢迎卡片配置	版本表新增 `welcome_config`；依赖旧欢迎页硬编码文案的定制需迁移到版本配置。
会话资源范围	会话级资源范围持久化后，跨会话/跨项目挂载行为更严格；本轮元数据集挂载优先于会话范围，请回归 ChatBI 与门户挂载。
Embed 反幻觉默认	Embed 默认开启反幻觉（Grounding）校验；调试入口仍可按会话关闭。
时长异常策略	ChatBI 时长/时延异常不再硬拦截回答，改为提示 + soft repair；依赖旧「异常即无答」行为的自动化断言需调整。
门户与路由	门户开关不再联动智能体路由；仅唯一智能体时自动锁定，多智能体场景需显式选择。

🗄️ Database Incremental Upgrades (数据库增量升级说明)

从 v1.0.7 升级至 v1.0.8 期间，平台数据库共引入了 2 个增量 SQL 升级脚本（存放于 db-prod/ 目录下）：

脚本文件	核心变更内容
V103-add-agent-primary-type.sql	智能体增加主类型 `agent_type`、onboarding 字段，并按历史 capabilities 回填。
V104-add-agent-welcome-cards.sql	智能体版本增加欢迎页三卡片配置字段 `welcome_config`。

Warning

请在升级后通过执行 ./db-prod/apply-sql-native.sh 脚本，将增量 SQL 自动、安全地导入到目标 MySQL 数据库中。

📦 Upgrade Guide

从 v1.0.7 升级

# 1. 拉取最新代码
git fetch origin && git checkout main && git pull origin main

# 2. 更新依赖
source .venv/bin/activate
pip install -r requirements.txt

# 3. 执行数据库迁移（V103 ~ V104）
./db-prod/apply-sql-native.sh

# 4. 重新编译前端并启动
cd frontend && npm install && npm run build && cd ..
./dev.sh

✅ Test Checklist

升级后建议验证以下核心场景：

完整测试清单见 tests/CHECKLIST.md。

📋 Commit Log

Hash	描述
`68e85aba`	fix(chatbi): 将时长/时延异常从硬拦截改为 soft tip 与 repair
`8925e6ca`	修复快捷按钮触控与思考序号裁切，并统一数据依据样式
`ceec5622`	优化 EmbedChat 思考过程的移动端展示与跟底滚动
`942375d5`	refactor(frontend): 拆分聊天表面模态组件并忽略 .ruff_cache
`2a06b133`	fix: MySQL 密码特殊字符 URL 编码，并完善 SQL 导入与 ENCRYPTION_KEY 说明
`b2a30a6b`	docs: 更新 CHECKLIST，记录剪贴板统一与权限缓存失效验收项
`d8fca7ba`	fix(auth): 角色与权限变更后主动失效 API Key 与权限缓存
`eb378ba1`	fix(frontend): 修复 AgentDebug 复制反馈，并柔化 Toast 与权限加载态
`3e8d03e4`	style(frontend): 统一 Toast 为顶部居中实心样式，复制浮标改为悬停显示
`0afcb7d4`	fix(frontend): 统一剪贴板复制降级，并支持 Skills 编辑器一键复制
`db5db5a8`	fix(agent): 轮次成败仅以最终状态判定，并补充平台选型盘外文
`7a8ef26e`	feat(portal): 展示数据集更新时间
`636fd406`	refactor(portal): 门户开关不再联动智能体路由
`89c2a5b7`	refactor(knowledge): 精简知识库门户视觉与文案装饰
`ad0ef675`	refactor(portal): 精简数据门户视觉与挂载文案
`9d09808a`	fix(embed): 路由切换提示改用 Toast，避免顶栏横幅导致页面抖动
`9a964df0`	feat(agent): 优化智能体创建/编辑配置完成度计算与欢迎卡片规则提示
`872f619f`	feat(portal): 支持数据集卡片完全折叠与多维 UX 交互体验增强
`4f11d8b1`	fix(chatbi): 修复本轮元数据集范围与路由
`204e8b94`	feat(ai): 支持本轮元数据集挂载并优先于会话范围
`947588b9`	docs: 补充元数据集本轮挂载实现计划
`7eb939c6`	docs: 补充 ChatBI 元数据集本轮挂载设计说明
`ac1cc4c6`	feat(ai): 统一请求语义帧与证据状态，阻断无据编造并透出时效
`36aff12d`	fix: 工具列表接口仅需 API Key 即可读取
`1aa34c17`	docs: 更新测试清单覆盖证据时效与 Mermaid 图示规范
`adf18ea4`	feat(ai): 平台提示词补充 Mermaid 图示规范
`3adef34e`	feat(ai): 取时熔断收敛、证据时效与 ChatBI 新问优先
`87fadafe`	feat: 优化资源目录识别与聊天配置交互
`af083409`	feat(ai): 新增可访问资源目录系统工具并优化路由短路
`14f0f989`	feat(ai): 引入 ChatBI 来源感知资格判定与路由门控
`b3a574ec`	refactor(ai): 优化系统提示词编排与执行上下文
`f381b306`	feat: 强化项目会话资源范围校验与门户交互修复
`7de4f23e`	feat: EmbedChat URL 锁定智能体与快捷指令交互优化
`bae400d1`	docs: 更新会话工具快照空值防护测试清单
`445f1bc3`	fix: 会话工具快照为空时避免 NoneType.get 异常
`0d3f9883`	feat: 通用助手工具结果快照、可访问数据集轻量列表与新会话菜单可达
`418f7c7d`	feat(ai): 泛化相对时间锚点并减少主助手重复取时
`d857abf1`	feat: 会话资源范围持久化与聊天日志 Markdown 导出
`6541ba60`	feat: 新增 PostgreSQL 数据源支持，并默认开启 Embed 反幻觉校验
`1815378c`	feat(frontend): 统一 @ 提及列表与专家中心的展示与交互
`1e756feb`	feat(frontend): 输入框专家入口改为胶囊与级联菜单并优化移动端体验
`e7da50fb`	feat(frontend): 技能选择改为加号级联子菜单并优化输入框提示文案
`261b2de1`	feat(frontend): 优化侧栏抽屉与画布实时拖动平滑压缩及钉住响应式交互
`2ae458e0`	style(frontend): 将站内消息详情复制按钮重构为内容区域右上角微型悬浮图标
`fa9ab717`	fix(frontend): 智能体配置只读模式下禁用提示词AI润色并支持智能体消息点击自动收回通知弹框
`1cf117ce`	style: 优化 EmbedChat 消息气泡为纯扁平无阴影风格并保留经典左侧蓝条
`ed66269d`	feat: 修复非流式消息重复、升级定时任务三段式提示词及站内消息复制浮标
`d0d03a8f`	style: 排版样式切换时添加 Toast 交互提示
`2218b027`	docs: 更新自动化测试清单 tests/CHECKLIST.md 记录 AI 思考链与 Toast 优化功能
`b4966e84`	style: 实现 AI 思考期间头部总耗时实时跳动计时
`4970b8c3`	style: 智能特性开关切换时添加 Toast 交互提示
`e43db54b`	style: 实现 AI 思考链折叠状态下的进度摘要展示
`6f894046`	style: 实现 AI 思考链的耗时冷暖渐变、技术日志降维和初始骨架屏加载
`14ed972b`	style: 优化 AI 思考步骤的耗时对齐与折叠箭头，引入局部温和呼吸动效
`2665fd64`	style: 移除 AI 思考卡片的思维链扫光动效
`abcc24fd`	feat: 实现排版样式偏好后端 Redis 持久化，新增瑞士包豪斯、复古日报和北欧禅意三套排版样式，修复预览弹窗遮挡及按钮对齐问题
`e723df0a`	feat: 任务结果通知调度兜底，外部引擎固定通用类型
`cc06c06b`	fix: 工具循环熔断锁存并补充模型停调工具引导
`c4aab511`	docs: 新增南子平台微信公众号系列 HTML 文稿与排期计划
`f5e8ffdd`	feat: 技能工作台展示公共 Skill 显式绑定智能体
`57c956f7`	fix: 修复 HTTP 智能体中心白屏与协程序列化异常
`0299c7c6`	feat: 智能体类型与扩展能力说明改为置顶模态框
`cc2e3370`	feat: 执行引擎说明弹窗，并优化无权限落地与刷新
`2c9dd88d`	docs: 同步 AI 润色、门户锁定与工作台品牌化测试清单
`6f3d9b8f`	fix: 工作台欢迎语读取品牌名，并澄清用户额度页保存入口
`4639ad7e`	fix: 数据/知识库门户仅在唯一智能体时自动锁定
`375ec998`	fix: 加固 AI 润色解析与可取消遮罩，并修复批量勾选
`0941efa4`	fix: 新建向导步骤门禁，并置顶 AI 润色结果弹层
`5893b7c9`	feat: 配置编辑器支持 AI 润色并扩展为 8 种范式
`6583c849`	fix: 加宽智能体列表引擎类型列并收窄状态列
`bdff2d3a`	fix: 智能体列表引擎与类型徽标改为纵向排列
`76c14544`	fix: 智能体列表操作列保持横向可点选
`cd103274`	feat: 智能体中心按主类型筛选展示，并重置仪表盘滚动
`d1f2ef33`	fix: 场景模板交付完成步改为完成并进入智能体中心
`69adf0ac`	test: 同步场景模板页搜索框可清空契约
`4f49a534`	feat: 统一可清空搜索框并优化智能体编辑文案
`092ad039`	feat: 强委派按语义选型，并收紧智能体编辑布局
`f018fa04`	feat: 场景模板对齐主类型并统一配置与发布文案
`88a3de0c`	revert: 撤回误推到 main 的智能体主类型改动
`d6f29294`	feat: 智能体主类型与委派就绪检查
`dcb4b7ce`	修复: RAGFlow 原档下载改用数据集接口
`6325d25e`	feat: 业务简报导出以 AI 分析正文为主并附证据附录
`a9bb8c8b`	feat: 细化用户管理权限并支持报表订阅页签跳转
`05ef3019`	feat: 站内通知详情与任务中心可视化结果通知
`d86e72a0`	docs: 固化 Agent 协作规范（PR 模板与禁止代跑 dev.sh）
`659d4c24`	docs: 更新澄清体验相关自动化测试清单
`12bb4fad`	feat(chatbi): 优化澄清缺口自检与澄清卡片体验

🤝 Contributors

感谢所有参与 v1.0.8 版本发布的开发者！

Navigation Menu

🎉 v1.0.8 Release Notes

Choose a tag to compare

Sorry, something went wrong.