更新日志 (Changelog)

本文档记录 Clouisle 项目的所有重要变更。

格式遵循 Keep a Changelog，版本号遵循语义化版本。

[未发布]

[0.2.9] - 2026-06-09

新增

管理后台与可观测性

• 新增管理后台可观测性仪表盘，用于查看平台用量、性能、错误和活动监控
• 新增 Agent 与工作流的管理后台管理面板和路由

包导入导出

• 新增 Clouisle 包导入导出能力，支持在不同环境之间迁移应用和资源

知识库

• 新增多模态知识库资源支持，支持上传图片和媒体引用
• 新增失败分块重试和知识库文档/分块批量操作

聊天与 Agent

• 新增上传聊天图片作为媒体引用的能力
• 扩展 Agent 配置中的提示词生成上下文

变更

聊天体验

• 重构聊天消息渲染、思维链展示、工具展示和滚动行为，减少闪烁和卡死
• 优化 AI 对话流式响应超时处理

平台与权限

• 支持超级管理员转移团队所有权
• 改进 Skill 能力视图，并补全 Skill 动作映射
• 媒体生成选择器简化为仅展示模型名称

自动化与依赖

• 更新 GitHub 自动化 Action 版本和依赖锁文件
• 从版本控制中移除生成的仓库活动和文档同步工作流报告

修复

聊天与工作流

• 修复 Agent 聊天闪烁、思维链滚动状态、聊天滚动、Agentic 工作流渲染和生产环境聊天折叠卡死问题
• 修复继续对话时 Agent 消息版本分支上下文问题

知识库

• 修复知识库批量操作评审问题，以及媒体资源处理和搜索路径问题

管理后台与工具

• 修复管理后台工具管理文案和 Skill 能力页面回归问题

安全

依赖

• 更新后端 aiohttp、starlette 和 idna 依赖以进行安全维护

[0.2.3] - 2026-05-19

修复

认证

• 未登录用户访问平台和仪表盘页面时，在渲染依赖凭证的内容前重定向到登录页
• 保留后端返回的登录凭证错误提示，避免误显示为会话已过期
• 居中卡片认证布局保留表单边框，分栏认证布局继续使用无边框表单

仪表盘

• 为仪表盘趋势图提供可测量容器，避免 Recharts 宽高无效警告

[0.2.2] - 2026-05-17

新增

认证

• 新增可配置的分栏认证布局，部署时可在居中布局和分屏布局之间切换

自动化

• 新增 GitHub issue 和 pull request 自动分配工作流支持

变更

前端与站点设置

• 更新站点设置界面和 API 接入，支持配置认证布局选项
• 优化后台和平台表单中的数字输入处理
• 更新前端依赖，包括 React、React DOM、shadcn、lucide-react、TypeScript 和 Next.js lint 配置

CI/CD

• 更新 GitHub Actions 发布和自动化依赖

修复

文档

• 修正部署文档中的 PostgreSQL 环境变量引用，将 POSTGRES_HOST 改为 POSTGRES_SERVER
• 完善仓库自动化相关的文档同步校验说明

[0.1.0] - 2025-02-07

Clouisle 首个公开发布版本 - 企业级知识库与 AI Agent 平台。

核心功能

Agent 系统

• Agent 类型：支持聊天 Agent 和工作流 Agent
• Agent 编排：现代化三栏布局，实时预览
  • 提示词编辑器，支持 AI 生成
  • 变量配置
  • 知识库关联
  • 工具配置
  • 视觉能力支持
• Agent 发布：发布/取消发布工作流，状态管理
• Agent API 访问：OpenAI 兼容 API，提供文档和代码示例
• Agent 监控：使用统计、对话趋势、Token 用量、响应时间指标

工作流引擎

• 可视化工作流编辑器：基于 React Flow 的拖拽式工作流构建器
• 节点类型：
  • 开始/结束节点
  • LLM 节点（支持模型选择和参数调优）
  • 条件节点（分支逻辑）
  • 代码节点（JavaScript/Python 执行）
  • 工具节点（HTTP API、MCP、内置工具）
  • 迭代/循环节点
  • 变量赋值/聚合节点
  • 子工作流节点
  • 问题分类器节点
  • 参数提取器节点
• 变量系统：上游变量引用与校验
• 执行：实时流式执行，节点级状态跟踪

知识库

• 文档管理：
  • 多格式支持：PDF、DOCX、TXT、MD、HTML、CSV、XLSX、JSON、PPTX
  • URL 导入
  • 拖拽批量上传
• 文档处理：
  • 智能文本分块（可配置 chunk_size、chunk_overlap、separator）
  • 提交前分块预览
  • 文本清洗选项
• 搜索模式：
  • 向量搜索（语义相似度）
  • 全文搜索（jieba 中文分词）
  • 混合搜索（RRF 算法）
• 动态 Embedding：支持多种 embedding 维度（768、1024、1536、3072）

聊天系统

• 通用聊天组件：可复用的聊天组件库
• 消息类型：文本、推理（思维链）、工具调用、文件、来源
• 流式输出：实时流式响应，Streamdown 渲染
• 多轮对话：对话历史管理

工具系统

• 内置工具：计算器、时间/时区
• HTTP API 工具：可配置 URL、方法、Headers、Body 模板
• MCP 服务器工具：stdio/sse 传输、命令执行
• 代码工具：在线 JavaScript/Python 编辑器

平台功能

用户管理

• 认证：用户名/密码、SSO（OIDC、SAML、CAS）
• 注册：可配置注册、审批流程、邮箱验证
• 密码策略：可配置强度要求
• 会话管理：超时、单一会话模式
• 登录安全：最大尝试次数、锁定、验证码

团队管理

• 多租户：基于团队的资源隔离
• 基于角色的访问控制：可自定义角色和权限
• 团队成员：邀请、移除、角色分配

模型管理

• 多供应商支持：OpenAI、Anthropic、Azure、本地模型
• 模型授权：团队级模型访问控制
• 用量跟踪：按团队统计 Token 用量

API 密钥管理

• API 密钥 CRUD：创建、轮换、过期 API 密钥
• Agent 绑定：限制 API 密钥访问特定 Agent
• 速率限制：可配置速率限制

站点设置

• 常规：站点名称、描述、URL、图标
• 默认语言：可配置系统消息的默认语言
• 安全：注册、密码策略、会话、登录安全
• 通知：邮件（SMTP）、钉钉、企业微信、飞书、Slack、Webhook
• 自动通知：可配置系统事件通知
• SSO：OIDC、SAML、CAS 提供商配置
• 存储：审计日志保留和归档

审计日志

• 全面记录：记录所有用户操作
• 日志查看器：可筛选、可搜索的审计日志界面
• 导出：支持 CSV 导出
• 归档：可配置保留期限，自动归档

国际化

• 语言：英语、简体中文
• 用户语言：每用户语言偏好
• 站点默认：可配置系统消息的默认语言
• 动态 i18n：所有用户界面消息国际化

UI/UX

• 主题：明/暗模式，支持系统偏好检测
• 动态 Favicon：主题感知的 Favicon 切换
• 响应式设计：桌面端优化的仪表板
• 组件库：基于 shadcn/ui 的组件

技术栈

后端

• Python 3.13、FastAPI
• Tortoise ORM + AsyncPG
• Celery 后台任务
• Redis 缓存和发布/订阅
• Qdrant 向量存储

前端

• Next.js 15、React 19
• TypeScript
• Tailwind CSS
• shadcn/ui 组件
• Bun 包管理器

贡献指南

在提交代码时，请在提交信息中关联相关 Issue，格式如：

feat(knowledge-base): 实现知识库搜索功能

- 添加向量搜索、全文搜索、混合搜索三种模式
- 集成 jieba 中文分词

Closes #12