更新日志 (Changelog)

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

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

[未发布]

新增

消息集成

• 登录方式、邮件、Webhook 与飞书目录同步现在集中在同一处「集成」配置中管理；已有的登录提供商、身份连接与回调地址保持不变，密钥加密保存且不会在界面中回显。详见消息集成。
• 集成的管理权限分为「登录」与「设置」两类，可以分别授予不同管理员；全局单点登录策略移到 设置 > 安全，各集成的实例卡片与已开启能力在 设置 > 集成 中查看。
• 飞书集成可单独开启网页登录：用户可用飞书账号登录，首次登录按飞书身份自动关联，不要求邮箱一致；开启集成本身不会自动打开登录。
• 飞书集成覆盖登录、通讯录与部门同步、通知（可向指定已绑定用户发送测试消息）、只读知识同步与 Agent 会话；关闭某项能力不会删除已同步的数据和已有绑定，重新开启即可继续。
• 飞书 Agent 会话支持两种接入方式：回调地址（校验签名、300 秒内有效、单条 64 KiB 上限）与长连接。长连接由平台自带的后台任务维护，不需要额外部署服务或执行额外命令。
• 飞书里的 Agent 回答以 Markdown 交互卡片发送；运行中断或重连后仍能找回此前生成的文件与结果。支持中英双语的 /agents、/use、/new、/stop、/status、/help 命令，结构化提问也可直接在会话里作答。详见飞书集成。
• 飞书附件上限为图片 10 MiB、MP4 30 MiB、其他文件 30 MiB；被拒收时按上传失败记录原始错误信息、状态与错误码，可在投递日志中查看。
• 新增飞书身份绑定：账户安全 > 连接账户 > 绑定飞书。绑定使用仅本人可用的限时授权会话，需要在同一标签页确认，遇到冲突直接拒绝；不会按邮箱自动匹配，也不改变当前登录方式。
• 飞书会话可用的 Agent 改为在个人设置中选择，与 /use 命令效果一致；个人开关只暂停新消息接收、排队处理与未发送回复，Agent 选择与会话历史都会保留。
• 新增微信（iLink）站点集成，Agent 会话与知识采集分别开关；个人二维码授权独立于功能配置，一个连接同时只处于「无 / 知识采集 / 单个已发布 Agent」三者之一。
• 微信知识采集支持文本、链接、文档、图片、音频与视频（按时间点抽帧），图片与音频的内容抽取需要团队授权；原始文件保留类型与文件名，只能通过受保护的方式下载，每类附件单独记录成功或失败。自托管部署已内置视频抽帧所需的媒体处理工具，无需额外安装。
• 微信里的 Agent 会话复用平台的持久化运行：支持文本、图片、文件、语音转写与视频输入，输出图片、视频和文件会直接发回微信；每次投递结果都会记录，结果不确定的消息不会自动重发，避免重复打扰。
• 微信消息按到达先后成批收取，积压过多时自动放慢，超时未处理的消息会被丢弃而不是重复处理；无需部署独立的消息接收服务。详见自托管架构。
• 微信命令支持 /new（/新对话）、/stop（/停止）、/status（/状态）、/help（/帮助）、/agents（/智能体）与 /use <n>（/使用 <编号>）；会话忙时拒绝切换，已接收消息仍绑定原运行。
• 飞书与微信的投递记录合并为一份统一的投递日志，升级时自动迁移历史记录并清理旧数据。升级时 API 与后台任务需保持同版本，不能只升级一侧。升级步骤见升级指南。
• 新增 投递日志 页面，可按集成（飞书／微信）、状态（待发送／发送中／已发送／失败／不可用／未知）、运行或文件名筛选；每页 1–100 条（默认 25），仅拥有集成设置查看权限的管理员可见，原始错误直接显示在表格中便于排查。
• 集成相关的定时任务按配置自动增删：开启或关闭某项能力后约 2 秒内生效，无需重启服务；读取配置失败时会暂停集成投递，其他日常维护任务照常运行。

Agent 运行时与聊天

• 新增 Agent 向用户提问的能力，替代原先依赖文本标记的提问方式：可以一次提出一个问题或一组问题，会话在提问处暂停，收到回答后从原处继续；每个问题只能回答一次，必填项未完成不会继续运行。
• 提问能力由 Agent 配置中的开关控制（默认关闭）；它与图片生成、视频生成一样属于内置能力，不出现在工具列表中，也无法手动挂载。
• 流式、非流式、编辑与重新生成四条聊天路径统一为同一套执行逻辑：上下文构建、上下文压缩、模型轮次、用量统计、心跳与断线处理、工具事件顺序和最终消息组装在各路径下表现一致。
• 工具调用按共享与独占策略分批调度：可并发的只读内置工具同时执行，其余串行；事件与记录顺序仍与模型的原始调用顺序一致。
• 模型一轮未写完时可自动续写（最多连续 8 次），被截断的工具调用会自动补齐配对；单次运行仍受总时长上限约束。
• 聊天上下文达到预算的 90% 时自动摘要压缩，保留最近一段原文并统计节省的 Token，压缩过程在会话中可见。详见对话。
• 供应商返回的缓存命中用量会被记录，并统一计入统计、消息与配额，三处口径一致。
• 高并发下的流式输出更省资源：增量内容按 20 毫秒或 6 个 Token 打包推送，每 15 秒发送一次心跳；运行结束后的事件缓冲从 24 小时缩短到 10 分钟，缓冲上限 64 条以防过载。
• 切换会话后，后台仍在生成的内容会恢复显示；运行页提供运行状态标记与重连按钮，排队中的引导消息显示在输入框上方。
• 新增统一的来源引用：知识库检索、网页搜索与资产都使用同一种引用标记，正文内可点开引用详情；朴素知识库检索结果以可展开的思考步骤呈现。
• 文档附件改为按需读取文本内容，读取与搜索都有篇幅上限，并支持从上次位置继续读取超长内容；移除了会截断内容的旧解析方式与相关文本长度设置。
• 新增资产列表查询：可按文件名搜索、按媒体类型筛选、分页返回（默认 10 条、最多 30 条）；返回结果前先校验权限、有效期与当前分支可见性。
• 输入附件、生成的媒体与沙箱产物统一使用同一种资产引用格式；工具重放只保存引用与元数据，下一轮使用前重新加载并重新校验权限。
• 系统提示词统一由一套按能力生成的管理逻辑注入，聊天与工作流中的 Agent 节点行为一致；工作流 Agent 补齐沙箱、Markdown 与语言指引，并按用户语言归一化。
• 提示词生成器与实际可用能力对齐：会带上提问与引用开关、保留可调用的工具名称、说明知识库模式与记忆读写边界，已关闭的能力不再出现在生成内容中；供应商返回额度不足时提示为模型配额错误。

模型与供应商

• 供应商图标与名称统一显示，覆盖全部 23 个供应商；自定义 OpenAI 兼容网关会按模型名推断所属系列图标（gpt/o 系列、gemini、claude、LongCat、BAAI 等），无法判断时显示中性网关图标。
• 供应商名称优先使用自定义显示名，未设置时回退内置名称；图标与名称统一应用到模型管理、平台目录、团队页、知识库模型选择器以及 Agent/工作流选择器。详见模型供应商。
• 供应商连通性测试会按地址白名单校验目标（默认开启，最多 200 条），并只允许固定的探测路径，被拦截时给出明确错误；配置读取失败时不允许保存空列表。
• 模型统一按条目 ID 解析，不再按「供应商 + 模型名」查找，也不再默认回退到 gpt-4；同一供应商 + 模型名可以配置不同的密钥或接入地址。
• 媒体生成能力扩展：工作流新增媒体节点，支持 OpenAI Responses 图片、更多火山引擎媒体模型与 MiniMax，并可以把会话中的图片作为媒体引用复用。详见工作流节点。
• 向量化用量优先采用上游返回的实际数值而非本地估算；修复了记忆向量删除、向量维度变更与自定义接入地址相关的问题。

知识库与检索

• 新增跨团队知识库共享：共享后目标团队只读查看，计入共享数量，并可在 Agent 编排中选择；操作会记录审计前后差异，不能共享给自己的团队。详见创建知识库。
• Markdown 分块改进：跨块重复表头、保留章节层级、修复表格续行与列表边界；用户填写的换行、制表符等分隔符会先还原为真实字符再用于切分。详见分块。
• 批量文档处理完成时只发送一条汇总通知；刷新页面丢失进度时提供待处理批次恢复提示；批次标识不再放进地址栏，避免链接过长。
• 检索结果更稳定：以知识库内容为权威来源，语义检索与关键词检索混合召回后统一重排，多知识库的候选一起排序，最后按上下文预算组装结果；混合检索或重排不可用时会给出明确提示。详见检索。
• AUTO 模式会结合对话上下文理解提问；混合检索不可用时降级并给出诊断信息；重排失败按检索错误提示，不再透出供应商原始异常。
• 新增可选的灰度观察：可以并行跑一套新检索策略做对比，默认关闭；灰度结果与各阶段指标单独记录，不影响线上返回结果。
• 新增检索实验室：可即时对比两套检索配置，也可保存为评估任务；数据集与用例支持逐条增删改，导出为 JSON/CSV 后可原样导回，编辑冲突会被提示，单个数据集最多 1000 个用例。
• 支持参数扫描调优：一次最多 32 组参数、5000 次评估，任务中断后可恢复；推荐参数必须通过一次验证运行后才能应用。
• 检索评估权限分为平台级与团队级两类，可分别授予；可选的模型预标注默认关闭，需要时手动开启。详见权限。
• 记忆改为双轨：既可由 Agent 显式写入，也会在后台异步提取；记忆检索支持按时间窗（天数）、返回条数 1–10 与实体类型过滤，并按 30 天半衰期的时效衰减排序。详见记忆。

工具

• 新增数据库自定义工具，覆盖 PostgreSQL、MySQL、MongoDB 等常用数据库与键值型缓存数据库；连接配置包含超时与最大返回行数，并可先测试连接再保存。详见自定义工具。
• SQL 只读校验改为按数据库方言解析语句结构，不再匹配关键字，避免合法查询被误拦；采样前会安全引用从库中发现的表名。
• 新增内置 RSS 订阅阅读工具，空字段直接省略以节省 Token；网页抓取工具增加正文提取，并拒绝本地文件与非 HTTP(S) 地址。详见内置工具。
• 新增站点级网页搜索：管理员可选择 Tavily、Bocha、SearXNG 或 DeepSeek 作为搜索引擎，并为每个引擎单独开关；密钥加密保存且保存后不再显示，Agent 与团队不再各自配置搜索凭据。
• 不再提供无需密钥的搜索引擎，也不会在失败时自动切换到其他供应商；SearXNG 支持反向代理子路径与可选的 HTTPS Bearer Token，请求超时 30 秒。详见站点设置。
• Agent 编排与工作流中的网页搜索节点只列出站点已启用的引擎，执行时再次校验站点配置；工具测试页新增搜索引擎选择。
• 工作流工具节点会按声明的类型转换数字、布尔与 JSON 参数，非法值在节点处失败，不再把字符串直接传给工具。
• 工具跨团队共享对话框在没有其他团队可选时显示空状态，并展示已选团队名称，按钮文案统一为 共享。
• 工具执行出错时不再把原始异常返回给用户：已知的业务错误显示本地化提示，其余统一显示通用提示。

工作流

• 暂停节点的审批新增「全部批准后继续」策略（默认关闭）：逐位记录每位审批人的决定，全部批准后继续，任一拒绝即结束，并清理各审批人的待处理通知。
• 暂停描述模板支持变量：变量不可用时渲染为空，而不是留下花括号；文件变量显示为上传文件名。
• 暂停节点的请求表单支持全部 11 种参数类型，画布测试运行抽屉可直接填写并提交；历史中等待中的运行可直接取消。
• 迭代与循环变量按作用域就近解析：循环体内可直接用最短名称引用当前项、序号与结果，最内层优先；文件与图片变量仍是列表。
• 工作流运行页改为聊天式布局与纵向轨道时间线，节点详情可折叠查看输入与带类型的输出，支持拖拽上传、上拉加载历史，多输出节点堆叠展示。详见编排。
• 工作流 Agent 节点能力对齐：统一附件映射、保留结构化输出、变量约定一致，并提供更详细的运行记录。
• Agent 与工作流的监控仅创建者、团队管理员与超级管理员可见；私有工作流的写操作仅创建者可用。详见运行监控。

沙箱与网络

• 每个沙箱任务拥有独立的工作区视图：真实工作区挂载为 /workspace，当前目录、命令与环境路径都映射到该目录，find / 等根目录扫描也只作用于工作区。详见沙箱。
• 新增三个独立的网络限制开关：模型地址白名单、外部请求防护与沙箱网络白名单，默认全部开启；关闭后已保存的名单仍然保留，可随时恢复；沙箱开关只影响新任务。详见安全。
• 审计日志记录字段级修改前后对比，覆盖 22 类资源；超长值截断到 500 字符，密码、Token、邮箱等敏感字段在写入前自动脱敏。详见审计日志。
• 加固人机验证：点击式验证码的答案与选项都在服务端校验，不会下发到浏览器；修改邮箱需先完成验证，并限制重发频率。

部署、存储与界面

• 新增可配置对象存储：默认使用本地存储，可切换为 S3 兼容对象存储（地址、存储桶、区域与密钥，路径风格与 HTTPS 默认开启）；知识库文档与 Skill 包统一走同一套存储。详见存储。
• 支持分布式上传：后台任务不再直接挂载上传目录，而是通过带认证的接口读写文件；补齐了工作流上传路径的权限校验。
• 新增单命令 Kubernetes 安装器与可填充密钥的单文件清单，生成过程不会隐式改动集群，并新增 Sealos 部署选项；Kubernetes 工作负载会等待数据库就绪后再启动。详见Kubernetes 部署。
• 站点设置新增可配置主题色，覆盖主要界面表面与强调色。
• 新增交互式引导：平台 10 步导览，以及模型、知识库、API Key、应用配置、能力与工作流编辑器的导览；支持前置步骤锁定、跨页衔接、一键重放与本地保存进度。
• 新增法务设置：可填写 ICP 备案号、服务条款与隐私政策并在登录、注册页展示，还可要求注册时接受条款。
• 快捷操作跳转后自动打开目标页面的创建对话框，打开后清理地址栏参数；工作台根路径统一跳转到应用列表。
• 高优先级通知改为在工作台以对话框展示，公告固定在通知分页之外；通知详情里的 Markdown 高度受限并可在内部滚动。详见通知。

管理后台可观测性

• 可观测性控制台重构为概览、运行、依赖、队列、基础设施与告警六个视图，可统一查看运行结果、追踪详情、模型/工具/检索依赖与运维状态。详见可观测性。
• 运行详情新增有界的工具与知识检索记录，并在「依赖」视图汇总工具与检索的成功率和延迟。
• 每次运行最多保留 128 条依赖记录，超出时详情会标明追踪已截断；历史运行不回填这些数据。
• 运行的各生命周期状态补齐中英文翻译；遇到将来新增的状态会安全回退显示原始状态值。
• 基础设施依赖新增有界的连通性探测，覆盖数据库、缓存、后台任务与向量检索，展示实测延迟并区分「不可用」与「未配置」。
• 新增每分钟一次的运行收尾核对，按批次修正过期的状态、时间、模型与 Token 统计，不会重放运行；同时修复了导致收尾摘要丢失的查询问题。
• 模型依赖卡片会把遥测中的模型解析为已配置的模型名称与供应商显示名，支持自定义网关名称，同名模型仍分别统计。
• 队列视图改为同时读取各类任务状态，降低加载延迟，并保留原有缓存与失败降级行为。
• 基础设施健康状态与慢查询统计改为并发采集，缩短等待时间，保留原有探测截止时间、失败降级与缓存行为。
• 新增实例发现：多实例部署时会列出所有保留的实例，展示可读名称、主机资源采样与过期/离线状态；基础设施面板不再只显示当前请求命中的实例。详见高可用部署。
• 可观测性新增双月日历区间选择器，弹层底部提供滚动时间预设，支持按本地时区选择完整日期、刷新后保留选择，并统一按同一时间基准过滤概览、运行列表与依赖统计。
• 仪表盘同步采用日历区间选择器，提供最近 7／30／90 天与全部时间快捷项；自定义日期会统一过滤趋势、排名、模型用量、工作流摘要与对话／消息／Token 统计，其他累计指标保持原定义。

沙箱出口

• 新增沙箱出口主机名的安全设置，可按精确主机名放行；保存后对新任务立即生效，无需重启后台任务。

沙箱生命周期审计

• 新增沙箱任务的启动、完成、失败、取消与恢复审计事件；记录任务、会话与执行上下文以及安全错误码，不记录代码、参数、输出或原始异常文本。

模型与工作流

• 新增 TypeSafe AI 决策模型供应商与「决策」模型类型：针对给定状态回答带类型的问题——选项（最多 255 个）、有序评分（2–10 级）或判断（真/假），返回带概率分布与置信度的结构化答案。详见模型供应商。
• 新增「决策」工作流节点：提出一个带类型的问题，按返回的答案（或概率最高的评分等级）分支，支持回退分支与可选的置信度阈值；节点输出包含答案、选中的分支、置信度、概率分布与用量。

聊天与文件预览

• 新增统一产物列表，显示文件数量与可展开结果，并为常见文档、媒体与代码格式提供共享预览与带认证的下载。
• 新增 Word 文档缩略图、页码同步、自适应宽度与缩放控制；新增只读 PDF 与电子表格预览控制。
• 新增 Agent「隐藏产物列表」设置（默认关闭）；开启后隐藏助手消息下方的生成文件列表。详见Agent 配置。

记忆与 RAG

• 管理后台新增「记忆」站点设置分类，可配置后台记忆提取使用的模型、去抖冷却时间与待处理轮次阈值。
• 新增有界的记忆子图查询工具，可按关系检索记忆。

变更

消息集成

• 通知渠道收敛为邮件、Webhook 与飞书三种；钉钉、企业微信与 Slack 渠道移除。飞书通知通过集成异步投递，并按已绑定的活跃收件人逐渠道报告状态。详见通知。
• 投递日志与审计日志统一使用多选筛选、地址栏保留搜索条件、每页条数与加载状态；原始错误直接换行展示，不再依赖悬停查看。
• 飞书 Agent 配置页常驻显示所需权限、事件订阅与发布／审批要求，并说明长连接建立成功不代表消息已经可用。
• 微信个人设置精简为头部授权与刷新、内联用途操作与响应式双列表单，移除 Agent 活动与采集历史面板及其请求。
• 微信回执去重提前到附件准备与运行提交之前；同一次响应中的相邻普通消息会合并为一个提示词，共用一个运行与一条回复。

Agent 与聊天

• Agent 输入不再自动附带资产目录，资产发现改为按需查询；原生 PDF 输入必须显式选择页码。
• 聊天附件与资产查看统一走授权的私有存储，并按所选模型实际支持的模态与文件类型序列化。
• 工具活动折叠为可展开的执行轨迹，思考过程与最终回答分开显示，各次工具调用的展开状态互不影响。
• 聊天空状态将欢迎内容与输入框垂直居中，页脚始终贴底；有消息后输入框恢复底部锚定。

工具

• 站点搜索密钥改为只写（保存后不再显示）；旧的 Agent／团队私有密钥仅加密归档，不会自动提升为站点配置。
• 工具测试表单改为选择已启用的搜索引擎，服务端在执行前重新校验站点配置。

工作流

• 工作流结果只渲染输出节点：实时运行合并所有输出节点的流式文本，历史运行按执行顺序堆叠每个输出节点，中间节点不再显示。

界面与国际化

• 后端静态提示与响应码本地化补全：全部 93 个响应码都有中英文案，并新增「模型已停用」提示；聊天校验、待交互提示与消息通知详情链接都使用用户语言。

依赖与工具链

• 升级 Next.js 16.3、React 19.3、Mermaid 12、Radix、TypeScript 与相关客户端／集成库，只做必要适配并保留异常信息；前后端测试覆盖率门槛统一为 95%，发布说明基于稳定标签生成，镜像发布流程也做了精简。

管理后台可观测性

• 页签与筛选控件统一为项目共享组件，控件高度统一。

Agent Studio

• 手机端 Agent 预览改为全屏抽屉式面板打开，避免并排显示时挤压编排区。

资源与媒体

• 生成的图片与视频持久化为带范围的资产，并提供会话／工作流范围内供模型使用的媒体引用。详见媒体。
• 更新 CSV 的 GBK/GB18030 编码处理，并移除电子表格查看器中的重复下载入口。

Agent 检索与聊天时间线

• 未关联知识库的 Agent 现在以知识库检索关闭的状态保存并运行；选择知识库前，Agent 编辑器隐藏检索模式选择器。
• 聊天思考过程按检索、压缩、推理、工具与生成步骤的实际发出顺序渲染。
• 未执行检索时显示为「未检索」，执行检索但没有命中时显示为「无结果」。

修复

消息集成

• 修复飞书已完成回执但回复未发出的问题，恢复任务会继续发送；微信 Agent 首次派发不再被重试延迟；回执完成、回复发出与会话释放现在一次性完成。
• 修复飞书图片、文件与富文本消息被静默拒绝的问题：可接收的资源会转为会话私有资产与持久输入，超出限制与失败都有明确回复。
• 飞书与微信回复按段落、行与句子边界拆分，单条不超过 3500 字节；长表格重复表头、长代码块重复语言标记，超长表头回退为有界纯文本切分。
• 修复 /skip 失败被当作等待中运行的回答；修复微信链接主机校验只做子串匹配的问题，以及飞书失败日志泄露供应商响应内容的问题。

Agent 与聊天

• 修复编辑后消息标识错位、切换会话重复出现思考占位、发送后未立即滚到底部、加载历史消息后阅读位置跳动、Mermaid 预览溢出与拖拽缩放漂移等问题。
• 修复分支与版本完整性、历史消息元数据与继续对话的上下文；修复聊天记录刷新闪烁、提示加载失败，以及工具执行完成后仍显示运行中。

模型与嵌入

• 修复记忆向量删除在集合不存在时失败、向量维度变更与自定义接入地址的兼容问题；补齐向量化用量配额错误提示与审计差异记录。

知识库与检索

• 修复批量任务派发失败未回滚、分块删除结果不一致、分块变更非事务性、关键词索引身份错配与启动迁移语句未拆分等问题。
• 修复检索灰度数据混入线上、AUTO 检索未设上限、多知识库候选未全局融合，以及评估指标把未标注用例计入平均值的问题。

工具

• 修复 API 工具测试对布尔值与空参数的处理、模型发现绕过地址白名单，以及数据库连接测试、知识库链接导入与预览、工作流 HTTP 节点中的外部请求防护问题（回环、私网、链路本地、组播与云元数据地址一律拒绝）。

工作流

• 修复运行链接刷新后反复触发、等待中的运行缺少取消入口、多输出节点只显示一个结果、文件变量被转成字符串与迭代作用域解析错误。

权限与审计

• 修复团队管理员可越权写入他人私有工作流，以及仪表盘统计范围错误。
• 统计接口安全修复：Agent 统计统一走同一套访问校验，工作流运行与统计统一按可见性过滤（包含无创建者的历史私有工作流），并移除会泄露他人会话标题的近期会话入口。
• 权限整改：超级管理员拥有全部权限，工作台按范围化权限判断，工具删除与知识库／工具可见性显式校验，管理端页面默认拒绝访问。
• 统计聚合改为共享并发额度，同时执行的统计查询有上限，避免单个请求耗尽数据库连接；「已中断」计入终态并单独展示。

认证与 SSO

• 修复单点登录新用户未分配默认团队（现在会重试分配）、登录失败未跳回前端、资料邮箱修改未验证（并限制重发频率）、嵌入组件通配符来源支持等问题，同时保留后端返回的登录错误提示。

界面与国际化

• 修复公共主题覆盖用户主题偏好、超长团队所有者名换行、移动端头部重叠、Markdown 表格与公式渲染、对话框内容溢出等问题。

管理后台可观测性

• 修复工具与检索记录缺少 Token 统计时「依赖」视图报错的问题；这类行现在显示为不可用，而不是让整个视图失败。
• 修复旧数据库升级时启动失败与概览查询报错的问题：在生成新表结构前，先为已有运行记录补齐模型名与消息开始时间字段。

沙箱会话

• 会话任务改为按执行节点分配并记录绑定关系；过期批次的消息会被拒绝，执行结果不确定的命令不会自动重放。
• 新增执行节点就绪心跳、同节点监督重启与检查点恢复；原节点存储不可用时，会以有界、原子流程切换到新的工作区代际，会话收到重置通知后重新规划，不再复用过期路径或进程状态。
• 每个执行节点的工作区与检查点保留在该节点本地存储（Docker Compose 使用命名卷，Kubernetes 使用节点本地目录）；同节点进程替换可恢复检查点数据，节点或磁盘永久丢失则无法恢复。详见Kubernetes 部署。
• 拒绝符号链接形式的工作区路径，避免借路径绕过隔离。
• 延迟清理与空闲回收的重试不再共用同一个通道，避免其中一个不可用就阻塞后续会话；首次会话分配会在就绪节点间分散，并为绑定与回收保留期设置上限。
• 拒绝将恢复超时设置为零，避免误配置导致会话无法恢复。
• 隔离沙箱与依赖安装的出口改走按任务建立的 HTTPS 代理，按精确主机名放行；被拦截的主机会出现在执行诊断信息中。
• 旧版代码执行与工作流代码节点统一收敛到沙箱之后；运行时被禁用、不可用或失败时直接失败，不在调用方执行负载。
• Python 与 Node 依赖安装默认限制 300 秒；超时的安装会被终止，未完成的环境会被丢弃。
• 沙箱输出在内存中按上限捕获，并对每个进程应用资源限制；直接执行的负载不保留任何系统权限，可信出口在隔离网络中就绪后再收紧权限。自托管部署需为相关后台任务保留网络管理权限。详见安全清单。

资源访问与预览

• 为生成图片、生成视频与沙箱产物增加按范围的授权，客户端下载也需通过认证。
• 保留文件过大、未登录、无权限、不支持类型与解析失败等明确的预览状态，不再回退到未受保护的链接。

聊天体验

• Agent 会话在开始发送时（流式输出之前）即固定到最新消息。
• 合并重叠的会话分页，刷新聊天侧栏时保留已加载的分页位置。

依赖兼容

• 适配缓存、MCP、邮件、沙箱会话、React、Radix、TypeScript 与 ICU 消息格式等集成库的新接口，并保留异常信息。

[0.2.9] - 2026-06-09

新增

管理后台与可观测性

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

包导入导出

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

知识库

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

聊天与 Agent

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

变更

聊天体验

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

平台与权限

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

自动化与依赖

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

修复

聊天与工作流

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

知识库

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

管理后台与工具

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

安全

依赖

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

[0.2.5] - 2026-05-20

变更

界面一致性

• 统一平台菜单与对话框中的删除操作样式，包括 SSO 提供商、知识库与能力操作。
• 悬停删除菜单项时通知徽标文字保持可读。
• 统一工作流日志、运行详情与活动日志中的运行状态标签与徽标样式。

部署

• Docker 镜像中以后端字节码形式打包应用。
• Docker standalone 前端部署支持将 /api/* 请求代理到内部后端服务。
• 公共 API 地址为相对路径时，为前端 SSR 请求新增服务端 API 地址解析。

修复

聊天与日志

• 修复 Docker 构建排除 logs 路由目录、导致生产环境日志页 404 的问题。
• 修复聊天流式失败时的 UnboundLocalError。
• 修复 Docker 部署中认证与公开聊天 SSR 元数据请求失败的问题。
• 修复从工作流日志页选择运行后运行详情丢失的问题。
• 修复工作流日志筛选使用后端运行状态值，并修正从日志页跳转工作流监控的导航。
• 本地化工作流运行详情的开始时间、结束时间与调试模式标签。

Skill 与自动化

• 在 Skill 导入环境中安装 Git，使 Git 托管的 Skill 导入可以完成。

安全

聊天流式

• 移除聊天流式错误响应中的堆栈暴露。

[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.2.1] - 2026-05-11

修复

聊天与 Agent 运行时

• 跨 Agent 会话保留上传文件上下文：缓存解析后的文件内容并在后续轮次复用。
• 恢复后端聊天工具处理中的知识检索工具执行。
• 避免用完整消息容器包裹出错的 Agent 消息，使错误展示与手动中断一致。
• 对不支持的 HTTP 工具 URL 模板返回结构化本地化校验错误。

安全与依赖

• 将 langchain-core 升级到已修复安全公告的后端依赖版本。
• 调整 Dependabot 前端更新分组，使不兼容的前端依赖升级单独处理。

文档

• 修正英文 README、中文指南 README 与快速入门中的后端启动命令。
• 修正文档中的后端启动命令说明。

[0.1.2] - 2026-03-04

新增

用户记忆系统

• 基于 D3.js 力导向布局的交互式记忆图谱可视化。
• 支持完整增删改查的记忆管理面板。
• 基于 LLM 函数调用的自主记忆创建与更新。
• 支持语义搜索（按含义相近程度检索）。
• 基于用户的多租户数据隔离。
• 10 种颜色区分的实体类型（person、preference、skill、project、goal、fact、concept、organization、location、custom）。
• 9 种颜色区分的关系类型（prefers、works_on、knows、uses、works_at、located_in、has_goal、related_to、part_of）。
• 可配置的自动提取、重要度阈值与单次检索记忆上限。
• 图谱的搜索、筛选与缩放控制。
• 带关系导航的实体详情面板。

Agent 功能

• Agent 交互式提问工具，支持结构化多问题输入。
• 对话中的多选选项支持。
• 聊天流程中的动态问题生成。
• Agent 编排表单中的记忆配置。

工作流增强

• 面向工作流集成的知识检索节点。
• 面向数据处理的参数提取器节点。
• 面向模块化设计的子工作流支持。
• 变量引用校验系统。
• 带内部变量访问的循环迭代。
• 带断点与时间旅行调试的调试模式。
• 带流式更新的实时执行监控。

文档

• 18000+ 行的中英双语完整文档。
• 架构指南与 API 参考。
• Docker 与 Kubernetes 部署指南。
• MCP（Model Context Protocol）文档。
• 沙箱执行文档。
• 文档自动生成脚本。

认证与安全

• SSO 提供商名称路由。
• SSO 属性映射中的 JSONPath 支持。
• 密码重置与验证的邮件模板。
• 注册时的默认角色分配。
• 基于团队成员关系的全局角色同步。

通知

• 新消息的浏览器推送通知。
• 按用户语言投递的通知。
• 面向触发用户的工作流运行通知。
• 知识库文档处理通知。

国际化

• 模块化结构的前端完整 i18n 支持。
• 系统消息的后端完整 i18n 支持。
• 用户语言持久化与自动同步。
• 面向 Agent 的语言感知系统提示词。
• 用户语言的内置工具展示名。
• 默认语言站点设置。

基础设施

• 面向容器编排的健康检查端点。
• 自动构建 Docker 镜像的 CI/CD 流水线。
• 优化镜像体积的多阶段 Docker 构建。
• 无 YAML 锚点的 Kubernetes manifest。

变更

• 按逻辑分组重排平台头部下拉菜单。
• 改进会话列表更新与状态管理。
• 增强错误处理与用户反馈。
• 用批量更新优化分块重建索引。
• 重构 LLM 聊天适配器以提高模块化程度。
• 提升向量存储服务性能。

修复

前端

• TCP 分片时 SSE 解析器丢事件（#61）。
• 工具调用完成后状态卡在“运行中”（#60）。
• 提示词编辑器换行保留（#59）。
• 多行文本的聊天输入框自适应高度（#59）。
• 开发页自动刷新与认证重定向循环（#58）。
• 密码校验与邮箱验证（#57）。
• 语言同步与 favicon 主题切换。
• 会话列表更新与推理块状态管理。
• 使用绝对 URL 的浏览器通知图标。

后端

• 直接使用 bcrypt 兼容 Bcrypt 5.0。
• 用预加载数据修复用户序列化的 N+1 查询（#56）。
• 使用公开 site_url 构造 SSO 回调地址。
• SSO 登录 URL 中重复的 /api/v1 前缀。
• 从 user.locale 而非请求头检测语言。
• 使用触发用户语言发送工作流运行通知。
• 使用上传者语言发送知识库文档通知。
• 对 SSE 流式响应跳过日志中间件。

部署

• Docker 构建中的 Bun lockfile 兼容（#52）。
• 使用 JSON 数组格式的 CORS 配置（#51）。
• 面向 kubectl 的 Kubernetes manifest 兼容。

安全

• 增强密码校验。
• 自定义工具凭据的安全存储。
• 带过期跟踪的 API Key 范围访问。

[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 中文分词）
  • 混合搜索（语义 + 关键词加权融合）
• 动态 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 的组件

技术栈

后端

• 异步任务与后台处理
• 缓存与实时推送
• 向量检索

运行这些能力所需的具体组件、版本与部署要求见部署架构。

前端

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

贡献指南

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

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

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

Closes #12