Cat Chat 3.5.1 Beta

Cat Chat 3.5.1 Beta Windows build。媒体工具分流与「已附卡」事实回注，事件流断流不再改写正文。

• 附卡事实回注（本次重点）：扫描/出卡类工具实际产出媒体卡后，模型可见的工具结果尾部会注明"已附媒体卡"及其类型与文件名。模型不再对同一文件重复要求出卡、也不会凭空声称"已经展示"；采集失败、被用户拒绝或结果为空时不会出现这条注——防止"模型自称已展示但用户看不到"的幻觉。
• 指名出卡解析更稳：用户说「看看 01-09.mp4」时直接出卡（不再先扫目录）；模型说不出具体文件名而留空时，按会话记录的媒体自动判定（唯一才出，多个会先问）；Windows 短路径与真实路径归一化修复了"会话里明明有这张图却提示找不到"。
• 视频目标分流：只要求展示/播放某个已指名的视频时直接出卡，不再默认抽帧；询问内容时才走 probe/抽帧/视觉分析。
• 事件流断流保护：连接中断只挂一行提示，不再把整段已生成的回复替换成「恢复 Run 失败」；重连后按游标重放，正文不会丢失或被改写。
• 本次改动的缓存影响经真实供应商预热对照（DeepSeek 官方 deepseek-chat，纯文本/扫描出卡/指名出卡三场景）：缓存命中率中位数 96.8%~97.4%，与 3.5.0 基线持平；全量单测 2689 例通过。

Cat Chat 3.5.0 Beta

Cat Chat 3.5.0 Beta Windows build。支持按明确要求展示已有媒体，并完善后台工具与辅助对话的使用体验。

• 主对话明确要求展示已记录的媒体，或指定工作区媒体文件路径并要求展示时，可通过 show_media 将图片、视频或音频作为附件呈现；单文件上限 80 MB。辅助对话、计划模式与子代理无法调用此工具。
• 消息底部增加媒体产物清单，复用既有文件操作入口，便于查找产物与继续处理文件。
• 标准、长对话与 ComfyUI 预设默认配备后台工具；升级只补齐未修改的出厂工具范围，自定义配置保留，已有会话不会追加后台工具。
• 辅助对话可独立选择 Agent，继续保持只读工具边界。

Cat Chat 3.4.2 Beta

Cat Chat 3.4.2 Beta Windows build。修复 3.4.1 一启动就崩溃的打包问题，并新增发布前产物自检

本次重点，修复 3.4.1 启动崩溃：3.4.1 构建当天，PyMuPDF 恰好发布 2.0 大版本，而发布流水线安装依赖时没有锁定版本，把一个文件布局不完整的新版 PyMuPDF 打进了 exe。程序启动装配 PDF 工具时就报「Failed to execute script 'launcher' ... [Errno 2] No such file or directory: ..._MEI...」，根本进不到界面。这不是用户配置的问题，也不需要删除数据。本版把打包依赖全部锁到 3.4.0 实测可用的版本（PyMuPDF 1.28.2、PyInstaller 6.22.3 等），并新增一道发布前闸门：打包出来的 exe 必须先以 --self-check 启动，把 PDF、视频、子代理等重依赖全部导入一遍，失败就直接停止发布。

如果你安装的是 3.4.1：它无法自行更新（连界面都打不开），请直接下载本页的 zip，用里面的 cat-chat.exe 覆盖原来的 exe；聊天记录、设置和 API Key 都保存在数据目录，不会被改动。3.4.0 及更早的版本可以正常自动更新。

本版同时包含 3.4.1 的功能：新增「百度千帆 Token Plan」供应商模板，并修好「地址中间带版本号」的接口拼接——https://qianfan.baidubce.com/v2/tokenplan/personal 这类地址不再被多拼一段 /v1 导致 404。

验证：全量单测 2572 通过；打包产物在本机与 CI 都执行了 --self-check 启动自检并通过。

Cat Chat 3.4.0 Beta

Cat Chat 3.4.0 Beta Windows build。辅助对话换成与主对话一致的界面，并可自己选 API 供应商与模型；设置里新增独立的「MCP 连接器」分页。

本次重点一，辅助对话界面重做：此前消息是自己一套左右气泡，和主对话长得不一样；它其实一直在调用只读工具（搜索、读取、查询），但界面上完全看不到。现在消息直接复用主对话的渲染，工具卡片、用量与媒体显示和主对话同源；底部输入区改成和主对话一样的箭头发送键。供应商与模型也搬到了面板底部，各有两个下拉——辅助对话有自己的 API 供应商与模型，不会再被顶栏或左侧的选择牵动，关掉标签重开、页面重载都还在。面板顶部新增一行「跟随」，显示这个辅助窗是从哪个主对话旁边开的，切换主对话时自动切到它对应的辅助窗；它只表示入口关系，辅助对话仍然读不到主对话的历史，也不能修改文件。

本次重点二，MCP 连接器独立成页：设置里原来的「连接状态」把 MCP 和局域网访问混在一起，现在拆成「MCP 连接器」和「局域网访问」两页。列表一行一个服务，带状态点与一句摘要，点开可看启动命令、环境变量名（只显示名字，不显示值）、错误全文和工具清单，并可直接测试、重连、编辑、删除。新增长错误文本会整行截断，不再把操作按钮挤成一团。新建与编辑支持表单和 JSON 两种方式：表单里有名称、启动命令、参数、环境变量和「超时时间 MS」；JSON 模式可直接粘贴 {"名称": {...}} 或 {"mcpServers": {"名称": {...}}}。每个服务可以单独配置「连接建立」超时——首次要拉包的 npx 服务常常 20 秒连不上，现在可以调大，默认仍与以前一致，已保存的配置行为不变。编辑时不动环境变量那一栏，原来的值会原样保留。

验证：全量单测 2570 通过（与改动前基线逐条一致、零新增失败）。本版新增 MCP 连接器守门 21 例、辅助对话守门 4 例；两套真后端冒烟全部通过（辅助对话 17 项、MCP 连接器 34 项），重新打包后核对打包资源与源文件逐字节一致。

Cat Chat 3.3.3 Beta

Cat Chat 3.3.3 Beta Windows build。修复全新用户看不到「辅助对话」入口（死锁），并补上空态新建按钮

本次重点：辅助对话之前全新用户根本进不去。顶栏那个「辅助」按钮要「已经存在一个辅助对话标签」才显示，而唯一能新建辅助对话的 ＋ 号又在辅助面板里面，面板又只能靠顶栏那个按钮打开——三条互相依赖，谁都迈不出第一步。只要从没用过这个功能，按钮就永远不出现；只有当机器上恰好残留过一条辅助会话（或旧版本用过）才会显示。这是 3.3.0 引入辅助对话时就在的死锁，3.3.2 修顶栏挤压时又顺着加了一条更严的门槛，问题更明显。

修法分两处：顶栏「辅助」按钮改成恒常可见（只在面板已经打开时隐藏，避免重复占位），零标签时计数显示「＋」而不是一个看着像故障的裸 0，点了就打开面板；辅助面板的空态从"只有一句提示文字"改成带一个「＋ 开一个辅助对话」按钮，点它直接建会话并聚焦输入框。

另外保留 3.3.2 的所有修复：顶栏按主区实际宽度两档降级、面板宽度 28% 封顶、面板打开时按钮不重复占位。

实测：全新零数据实例下「顶栏辅助按钮可见 → 点击打开面板 → 空态按钮可见 → 点击真的建出会话 → 计数变 1 → 收起后面板按钮带回数量」全链路通过；同时验证多辅助对话场景不受影响。

验证：全量单测 2545 通过（与改动前基线逐条一致、零新增失败）；本版新增「零数据可达性」守门 3 例（入口不被标签数量卡死、空态有可点新建按钮、零态计数显示＋）。

Cat Chat 3.3.2 Beta

Cat Chat 3.3.2 Beta Windows build。修复右侧面板打开后顶栏按钮挤成一团（新增辅助对话后凸显）

本次重点：右侧面板（文件 / 辅助）打开后，顶栏不再挤成一团。此前主区被面板吃掉宽度后，顶栏操作区（辅助 / 任务 / Skill / MCP / 刷新）会整组向左溢出、盖住 API 与 Agent 下拉——窗口明明不小也照样挤，1200 宽实测重叠 77px，1100 重叠 104px，1024 重叠 142px。

根因三条：一是操作区最小宽度写的是 0，设计上指望「轮次下拉」吸收压缩量，但轮次下拉要么根本没出现（新会话/单轮），要么自己先被压成一根 18px 的箭头，最后压缩量依然全部转成按钮组左溢；二是降级规则只看视口宽度，面板打开并不会改变视口，一条规则都不命中；三是「辅助」重开按钮缺少「面板开着就隐藏」的条件（文件按钮有这个条件），面板常开时白占 94px。

修法：操作区最小宽度改为「不许比内容更窄」（放不下时挤压左段的模型 / Agent，而不是让按钮压到别人身上）；顶栏改为按主区实际宽度两档降级（观察容器而不是视口），窄档收起有图标按钮的文字、把轮次下拉从 260px 收到 96px，更窄一档收到 64px 并把 MCP 收成状态点；面板宽度上限从窗口一半收到 28%（280-420px），并去掉辅助对话里那份丢了边界钳制的宽度副本；「辅助」按钮与文件按钮同口径，面板打开即隐藏，收起即回来。

实测：1400 / 1280 / 1200 / 1100 / 1024 五档 × 面板开合，全部不重叠、不右溢；手机端形态不变。

验证：全量单测 2542 通过（与改动前基线逐条一致、零新增失败）；本版新增窄容器降级与辅助按钮联动守门 9 例。

Cat Chat 3.3.1 Beta

Cat Chat 3.3.1 Beta Windows build from 641eacae46539c78863f5407efdc080612fb8a89。内置供应商预设表变更，无新增功能。

预设表调整：新增供应商时的模板名单有变动；已保存的供应商卡片不受影响——连接信息存在卡片本身，API Key 与地址原样保留，无需任何操作。其余内容与 3.3.0 相同。

验证：全量单测 2535 通过；供应商预设与发布清单相关守门已同步。

Cat Chat 3.3.0 Beta

Cat Chat 3.3.0 Beta Windows build from 4d2dde6fa6732f04976d66c02ead4be172020c68。新增辅助对话（主对话旁的轻量并行聊天）+ 文件预览编码选择与错误卡片

新增「辅助对话」：右侧面板「文件 | 辅助」分组共存，标签随手开随手关，与主对话上下文隔离、互不打扰。后端只读锁死（工具白名单 + 只读执行器双层防线，前端无任何权限开关）；AI 回复可一键「发送到主任务」复制进主输入框，人工确认后再发送，守住不污染。不进会话列表/历史检索/全文搜索/用量统计；关标签即删（有内容弹一次确认），页面重载可恢复未关闭标签，服务端 7 天过期清扫兜底。辅助对话可独立换模型：默认跟随主对话当前选择，可切换为其他已检测模型并记住。

文件预览升级：GBK 等非 UTF-8 文本不再静默显示乱码，改为结构化提示选择正确编码重新打开（gb18030/big5/shift_jis/euc_kr/cp1252）；非 UTF-8 打开的文本强制只读并在工具栏标注实际编码；文件不存在/过大/不可预览返回结构化错误卡片与可操作按钮。

其他：Skill 引用说明文案按固化/追加双通道语义修订（快速引用弹窗 + 设置页）。

验证：全量单测 2535 通过（与改动前基线逐条一致、零新增失败）；本版新增 tests/test_aux_chat.py 9 例（迁移 v25/只读收口/排除规则/过期清扫）与文件预览编码/错误码 10 例守门。存储迁移 v25：conversations 表新增 conv_kind 列（纯加列，存量自动归 main）。

Cat Chat 3.2.2 Beta

Cat Chat 3.2.2 Beta Windows build from 72b5340b5a33622d4376623ab53c1f879f74aaeb。

关于文件名的说明：仓库已更名为 cat-chat（旧链接由 GitHub 自动跳转）。本次 Release 同时提供 cat-chat.exe 与 naiba-chat.exe——这是同一个文件，SHA-256 完全相同；两个 ZIP 内容也等价，只有包内 exe 的文件名不同。应用内自动更新仍使用 naiba-chat.exe 资产与原有清单协议，你不需要做任何操作，已安装的旧版本会照常收到更新。

本次变化：修复「更新后手机/局域网页面白屏报错」的缺陷，并按真实语义修正技能说明。 有用户实测反馈：应用更新后，电脑端一切正常，手机端打开却是一片白屏 + 一行 JSON 报错（No such file or directory: …\Temp\_MEIxxxx\public\index.html）。根因是 onefile 打包的临时资源目录在更新重启窗口被删除，而服务进程还活着占着端口——现在这种情况会返回一个自恢复的引导页而不是报错。

本次更新（完整清单见 release_notes.json / 应用内「更新说明」）：

• 手机白屏修复（本次重点）：资源目录失效时返回内嵌引导页（说明原因 + 每 5 秒自动重试 + 恢复指引），不再是一屏 JSON 报错；桌面端行为不变。
• 技能语义说明修正：中途手动输入 /技能名 追加的技能同样全程有效（随对话历史留在上下文），与首轮固化的差别只在注入位置——固化的写在系统提示最前面、模型最优先看到；追加的以补充指令进入历史、模型关注度可能略低。此前「仅当轮生效」的说法是错的，消息行分组也已去掉该标注（保留「本轮追加」组名与琥珀色芯片，只表达注入位置不同）。
• 文档补漏：CHANGELOG 补上 3.2.1 条目（上版发布时漏写）。
• 升级须知：无数据迁移、无新设置项；历史会话、收藏、分支、Agent、Skill 与 MCP 配置原样保留，直接覆盖安装即可。

本地验证：全量单测 2511 通过；本版新增 5 例守门测试（资源目录失效降级页、正常路径字节不变、越界路径 403 维持）。
The application verifies naiba-chat.exe against the SHA-256 value
in naiba-chat-update.json before installing an update.

Cat Chat 3.2.1 Beta

Cat Chat 3.2.1 Beta Windows build from 83495b5c472b4aff63965ae1f4d2344b9ecad6ef。

关于文件名的说明：仓库已更名为 cat-chat（旧链接由 GitHub 自动跳转）。本次 Release 同时提供 cat-chat.exe 与 naiba-chat.exe——这是同一个文件，SHA-256 完全相同；两个 ZIP 内容也等价，只有包内 exe 的文件名不同。应用内自动更新仍使用 naiba-chat.exe 资产与原有清单协议，你不需要做任何操作，已安装的旧版本会照常收到更新。

本次变化：Skill 弹窗交互修复、引用说明改白话，以及消息行「固化 / 追加」分组显示。 3.2.0 引入的 Skill 管理页与快速引用弹窗在真实使用中收到两条反馈——「查看说明」收起要点两次、引用说明术语看不懂——本版一并修复；技能状态条现在会区分「固化名单」与「本轮追加」，一眼分清哪些技能全程有效、哪些只管这一轮。

本次更新（完整清单见 release_notes.json / 应用内「更新说明」）：

• 「查看说明」一步收起：完整说明原位替换该行的一行截断描述（列表不再跳位），点说明块任意处即收起。
• 引用说明改白话：第一条消息发出后，里面引用的技能固定下来、整个会话全程有效；发送前可随意增删；中途手输 /技能名 仅当轮生效（想换名单开新会话）；Agent 固定的技能在第一条消息发出后同样全程有效。
• 消息行「固化 / 追加」分组显示：固化技能=紫色芯片（全程有效），本轮追加=琥珀色芯片（仅当轮）；旧会话回放自动按固化组显示，不报错。
• 升级须知：纯前端交互与显示优化 + skills 事件加一个只读字段，无数据迁移、无新设置项；历史会话、收藏、分支、Agent、Skill 与 MCP 配置原样保留，直接覆盖安装即可。

本地验证：全量单测 2511 通过；本版新增 5 例守门测试（skills 事件 frozen 分组标记）。
The application verifies naiba-chat.exe against the SHA-256 value
in naiba-chat-update.json before installing an update.