本项目遵循语义化版本。各版本及安装包均可在 Releases 查看。
- Windows 桌面端暂不执行旧知识库引擎迁移，升级后直接启用全新的 1.8.3 知识库工作区，保留账号、模型配置、上传文件及旧引擎数据，避免目录权限或占用导致 SAG 无法启动；旧知识库暂不展示，后续版本再提供恢复方案。
- 修复 Windows 存量知识库升级时 OCTX 临时目录变化或只读残留文件导致备份、存储切换失败的问题，支持中断后安全续跑。
- 修复 Web 端提交知识库存储选择后遇到网关超时仍重新开放选项的问题，以服务端权威状态继续迁移，避免并发选择冲突。
- 修复存量知识库迁移选择提交超时后界面重新开放选项、再次选择触发存储冲突的问题；首次确认后持续展示迁移进度，并以服务端已接受的选择为准。
- 修复 Windows 迁移备份 OCTX 产物时因复制只读或受限文件属性触发
WinError 5的问题，同时保持 macOS 迁移备份与存储切换兼容。
- 将
zleap-sag知识数据处理引擎升级至 0.10.0，并为存量 SQLite + LanceDB 用户提供启动时可选择、可备份恢复的数据迁移流程。 - 完善模型配置与知识库引擎实例同步，保留既有知识库的 Embedding 语义空间，并确保新增配置可用于后续文档处理与检索。
- 修复批量导入、暂停恢复、重新处理等文档操作中旧断点缺少代次信息导致无法入库的问题，同时兼容 DeepSeek 等模型返回的不完整抽取结构。
- 修复 OCTX 存量数据导出缺失产物、导入恢复及向量兼容处理问题，提升知识库跨版本迁移与备份的可靠性。
- 支持知识库文档、搜索摘要和问答内容中的行内及块级 LaTeX 数学公式渲染，兼容百分号、分式、上下标、希腊字母及长公式分块展示。
- 规范问答模型保留显式 LaTeX 定界符，并保护代码、金额、路径和链接等普通 Markdown 内容不被误判为数学公式。
- 优化复杂模型标识的查询分析与检索召回，避免英文数字组合在检索过程中被错误拆分。
- 修复包含失效图片关系的 DOCX 文档解析失败问题，兼容 Word 文档中的缺失图片引用。
- 完善 OCTX 0.1.6 向量导出与 partial 向量复用：兼容向量可直接复用，缺失或不兼容记录安全重建。
- 稳定桌面端 Web 端口复用与自动更新错误提示，避免启动时 origin 漂移，并为签名校验失败提供明确引导。
- 修复官方 MinerU PDF 解析链路的暂停回调接口不一致问题，避免
should_pause参数导致解析任务直接失败。
- 修复知识库文件夹导入长文件名/长路径超出弹窗边界的显示问题；冲突检查步骤新增「全部跳过 / 全部仍然添加」一键批量处理。
- 文件夹导入按相对路径去重：不同子目录下的同名文件不再被误判为重复冲突，正确支持含子文件夹的目录导入。
- 修复配置 DeepSeek 模型时空抽取结构（null 字段）导致的「Chunk 提取失败：'NoneType' object is not iterable」崩溃。
- 修复桌面端 Web 端口不稳定导致每次启动重复引导的问题。
- 修复上传文档长时间卡在「排队中」：MinerU 轮询期间实时透出解析进度，状态从「排队中」切换为「解析中」，并新增任务/轮询/超时日志。
- 修复删除信源 loading 很久后提示「网络超时」：新增 per-source 停止信号，在途处理任务在安全检查点快速让路并释放处理租约，删除在请求窗口内完成。
- MinerU SSRF 守卫放行 fake-ip 代理 DNS（198.18.0.0/15），代理环境下官方解析不再被误拒。
- 缺失切片向量自愈重建：向量索引瞬时失败不再导致整篇文档处理失败。
- MinerU 服务商与官方 URL 冲突时协议自动跟随 URL 主机切换，仅粘贴官方地址也能启用官方解析。
- 文档删除不再报资源占用错误，上传文档直接排队等待删除清理。
- 新增 MinerU 官方 API v4 文档解析：支持服务提供方配置、批量任务、签名 URL 上传、状态轮询与断点续跑，鉴权仅发送至官方 API；旧 302 配置与官方地址冲突时自动迁移修复。
- 文档列表与详情展示实际解析方式（MinerU 服务/模型或 MarkItDown）、解析进度与降级状态；解析错误写入前脱敏。
- 桌面端新增常驻更新状态提示：可查看新版本、下载进度并在下载完成后重启安装；左上角同步展示当前构建版本号，Web 与桌面端均可快速确认运行版本。
- 新增知识库单文档 OCTX 导出、任务诊断日志与自动下载失败反馈；隔离桌面端 OCTX Worker，并修复单文档事项关系裁剪及 macOS 导出异常问题。
- 新增本地文件夹批量导入：Web 与 macOS 桌面端支持扫描并筛选文件、处理同名冲突、展示批次进度，以及取消和失败重试。
- 新增 OCTX 信源导入与导出：支持完整性校验、冲突处理、进度恢复与失败清理，并在兼容时复用向量数据，便于知识库跨实例迁移和备份。
- 优化中文连续词检索：快速检索可对无空格中文查询进行分词与词项扩展，改善“肉类清汤”一类组合词的召回，同时保留原始查询参与检索。
- 完善文档生命周期控制：强化暂停、恢复、重处理与删除的并发状态一致性，隔离删除中数据，并自动修复异常中断的维护任务。
- 调整快速检索默认策略并补充相关性评估，提升多路快速召回的稳定性与可验证性。
- 修复大文件上传在大小校验前被完整读取的问题，以及详情栏分块原文显示异常；同步升级发布工作流依赖。
- 助手消息新增
status/error两列，失败或被取消时持久化已生成的 partial answer 与结构化错误，前端据此渲染独立失败气泡并支持页面刷新恢复；Message 的 SAEnum 使用values_callable确保按值存取，与server_default一致。 - 「清除日志」按钮真正清空诊断缓冲区，避免历史事件残留。
- 文档解析大内容渲染改为分块模式，修复右侧详情栏溢出问题。
- 新增诊断日志导出能力：自动记录模型配置、知识库上传与问答链路的关键事件，可在设置页「诊断」一键导出为 JSON 交研发排查；web 与桌面端通用，API Key 等敏感信息自动脱敏，桌面端另附运行日志文件。
- 错误响应新增分层归因（
layer责任层 /stage链路环节 /request_id），并将散落的错误码统一收敛到ErrorCode枚举，便于从日志直接定位失败发生在哪一层、哪个环节、是否可重试。
- 修复文档抽取时超出 SQLite 64 位整数范围的数值导致处理失败的问题：此类值会以文本保存，避免导入中断。
- 官方命令行客户端
@zleap-ai/sag-cli首次发布：一条命令即可把 SAG 知识库 MCP 挂载进 Codex 或 Claude Code；本机 Docker 免 Token，远程实例sag auth login后接入，全程不需要手改 Agent MCP 配置。 - 用户指南「MCP 指南」重构为以 SAG CLI 为主的三段式接入指引：推荐用
@zleap-ai/sag-cli一条命令挂载 Codex / Claude Code MCP（本机 Docker 免 Token；远程实例sag auth login后接入），可选 Skill 教 Agent 用好 SAG，备选保留原有手动复制 MCP 配置流程；中英文 README 同步更新。 - Skill 文件（
SKILL.md+references/）从 SAG 仓库迁移至@zleap-ai/sag-cli，随 npm 包发布；SAG README 第二步更新为从 CLI 包复制安装。
- 开源版本已基于
zleap-sag全新重构并采用全新 UI；旧版源码归档于v1分支，不再维护。 - 修复部分 OpenAI 兼容模型省略
is_valid时事项抽取失败的问题，并递归补齐子事项默认值。 - 更新 SAG 品牌图标，统一 Web、macOS 与 Windows 客户端视觉；桌面安装包默认隐藏系统菜单栏。
- README 社区入口新增 Discord，并将 Discord 与微信二维码统一移至文档底部。
- 知识宇宙探索模式重构为「时间即飞行」：源内滚轮沿计数轴驱动相机（惯性、轴端墙、窗口 fire-and-forget 跟随翻页，快速飞行按速度提前补页），拖拽/旋转与 pinch 缩放正交保留。
- 探索轴改为快照稳定的序数计数轴：后端时间线 canonical 序补充叙事 rank tie-break，
每个事件包下发
ordinal与total_events（timelineschema_version2→3）。整本导入、 全部事件同一时间戳的书籍从 UUID 随机序修正为按阅读顺序探索，且滚动翻页恢复可用。 - 近大远小改为相机相对：呈现尺寸/明暗按「节点深度 − 飞行深度」每帧计算（mesh/卡片/连线 三层一致），相机到达之处必然完全在场；翻页进出场改为就地凝现/原地溶解。
- 浏览态星云 = 探索走廊：入源后星系尘埃由 GPU 拉伸为沿计数轴分布的未加载历史，已加载 窗口带内让位给真实节点；粒子预算与上传纪律不变。
- 沉浸打磨：入源改为穿云潜入（相机落位走廊入口、沿轴回望纵深）；走廊自带光斑与远端 消融（浩瀚无墙）；高速飞行时卡片按自身形变阶段收拢为星点、停稳后展开；掠过的事件 保留余烬微光可回望来路；相机手势期间星云漂移冻结、入源尘埃提亮；书籍类源底部改显 「第 x–y 条 · 共 N 条」取代无意义的重复日期。
- 文档上传先统一转为 Markdown：PDF 可使用 302.AI MinerU 2.5，未配置或 MinerU 失败时自动回退本地 MarkItDown，其他文件默认走 MarkItDown。
- 302.AI 首次一键配置复用同一个 Key 启用 LLM、Embedding 与 MinerU；设置页新增文档解析配置。
- MinerU 任务状态与解析结果可续跑、可缓存，避免后台重试或并发重新处理造成重复计费。
- 新增 Electron 桌面客户端：macOS Apple Silicon 提供签名、公证安装包，Windows x64 暂以无签名安装包发布；两个平台均接入 GitHub Releases 稳定自动更新通道。
- 新增公开发布流水线与一键版本脚本：完整 CI 通过后原生构建双平台产物、校验更新元数据并生成 SHA-256 校验文件。
- 知识宇宙探索模式重构为「时间即飞行」：源内滚轮沿计数轴驱动相机（惯性、轴端墙、窗口 fire-and-forget 跟随翻页，快速飞行按速度提前补页），拖拽/旋转与 pinch 缩放正交保留。
- 探索轴改为快照稳定的序数计数轴：后端时间线 canonical 序补充叙事 rank tie-break，
每个事件包下发
ordinal与total_events（timelineschema_version2→3）。整本导入、 全部事件同一时间戳的书籍从 UUID 随机序修正为按阅读顺序探索，且滚动翻页恢复可用。 - 近大远小改为相机相对：呈现尺寸/明暗按「节点深度 − 飞行深度」每帧计算（mesh/卡片/连线 三层一致），相机到达之处必然完全在场；翻页进出场改为就地凝现/原地溶解。
- 浏览态星云 = 探索走廊：入源后星系尘埃由 GPU 拉伸为沿计数轴分布的未加载历史，已加载 窗口带内让位给真实节点；粒子预算与上传纪律不变。
- 沉浸打磨：入源改为穿云潜入（相机落位走廊入口、沿轴回望纵深）；走廊自带光斑与远端 消融（浩瀚无墙）；高速飞行时卡片按自身形变阶段收拢为星点、停稳后展开；掠过的事件 保留余烬微光可回望来路；相机手势期间星云漂移冻结、入源尘埃提亮；书籍类源底部改显 「第 x–y 条 · 共 N 条」取代无意义的重复日期。
- 文档上传先统一转为 Markdown：PDF 可使用 302.AI MinerU 2.5，未配置或 MinerU 失败时自动回退本地 MarkItDown，其他文件默认走 MarkItDown。
- 302.AI 首次一键配置复用同一个 Key 启用 LLM、Embedding 与 MinerU；设置页新增文档解析配置。
- MinerU 任务状态与解析结果可续跑、可缓存，避免后台重试或并发重新处理造成重复计费。
- 修复 v1.2.1 的
ModelConfigPatch类型错误；门禁改为完整运行并取真实退出码。
- 对话输入框对标主流：附件菜单（图片粘贴 / 文档自动入「对话上传」知识库）、
@呼出知识库范围 多选（针对性问答source_ids）、上下文占用圆环（CJK 感知 token 估算 + 可配上下文窗口）。 - 消息 hover：复制 / 重试 / 删除 / 时间；SSE 工具事件 → 流光文字执行反馈。
- 详情栏：官方 Resizable 拖宽（宽度记忆）、默认 Markdown 可切原文；窗口形态 crossfade + 可拖拽缩放（0709 回修）；宠物「小宇航员」（emoji 面罩、视口级、可关）。
- 视觉输入全链路：附件上传/取回端点、消息 attachments、OpenAI vision 多模态 prompt （当轮 base64、历史仅文本）、composer 附图与粘贴、鉴权图片渲染。
- 破坏性操作分层（侧栏归档可逆、删除只在归档区）；键盘 focus 态全覆盖； chat-live 流镜像（切页不断流 + 回附 + 生成中角标）；会话归档；上传真进度条；CI 门禁。
- 信源 MCP 工具面 3→7：
list_documents / outline / grep / read探索原语； 布局高度链根修（应用型内滚动）。
- 带知识库的 Agent 客户端：对话主入口（默认 agent=全部信源）、搜索（列表/图谱 + 动态时间线）、 知识库双视图、三栏详情（原文预览）、Mac 风窗口形态。
- 收敛为单用户 Agent 模型；信源即 MCP（HTTP/stdio），Agent 可挂载外部 MCP；品牌统一为 sag。