Skip to content

CHANGELOG.md

Latest commit

 

History

History
447 lines (308 loc) · 34.8 KB

CHANGELOG.md

File metadata and controls

447 lines (308 loc) · 34.8 KB
Raw

变更日志（Changelog）

本项目的所有重要变更都记录在此文件。

格式遵循 Keep a Changelog， 版本号遵循 语义化版本（MAJOR.MINOR.PATCH）。

Unreleased

0.15.0 — 2026-07-30

变更（Changed）

  • 产品由 “MATLAB / Simulink Copilot” 正式更名为 Matlab-Simulink-SuperAgent，覆盖 MATLAB 包命名空间、主入口、面板与工具条名称、sidecar 包、环境变量、临时发现文件、安装包和 GitHub 仓库。
  • 主入口更新为 superagent()、superagent_doctor()、setupMatlabSimulinkSuperAgent()；旧 copilot* 入口保留为带弃用提示的兼容包装。
  • 版本升级到 0.15.0，继续复用既有 Toolbox GUID，使旧安装可直接覆盖升级。

迁移（Migration）

  • ~/.matlab-copilot 首次运行时迁移到 ~/.matlab-simulink-superagent；新旧目录并存时不覆盖旧证据。
  • 工程团队经验库由 .copilot_kb 迁移为 .superagent_kb；浏览器 mc-* 偏好和会话键迁移为 mssa-*。
  • 新环境变量统一使用 MATLAB_SIMULINK_SUPERAGENT_*，本版本继续读取旧 MATLAB_COPILOT_* 变量以便平滑升级。

验证（Verified）

  • 新增 Node 用户数据迁移、UI 本地存储迁移和 MATLAB 用户目录迁移回归测试。
  • 更新三张全屏 UI 截图、安装指南、发布清单和最终安装包验收规则。

0.14.5 — 2026-07-26

新增（Added）

  • 新增按会话隔离、与 Codex 一致触发语义的实时执行计划：仅多步骤任务或修改后验证闭环由后端创建步骤；普通问答、解释、单次查询和单一直接操作不显示计划。当前步骤、完成/失败/中断状态和计划结构修订动态原位更新；点击摘要条展开/收起完整计划，并只显示本轮工程变更增删行。
  • Claude Code 的 TodoWrite 与 Codex 的 todo_list（item.started / item.updated / item.completed）统一转换为 plan_update 快照；普通工具调用只显示当前操作，不再被误列为任务步骤。
  • 当前上下文浮层升级为可点击固定的工程环境面板；变更、本地路径、分支、子任务和附件来源均可点击独立展开详情。
  • 环境面板新增真实 Git 指标：变更文件、增删行、暂存/未暂存/未跟踪、ahead/behind；“提交或推送”和“比较分支”仅在用户点击后发起受权限门禁保护的任务。

修复（Fixed）

  • 修复安装多个 MATLAB MCP Toolbox 变体时的会话文件覆盖方向错误：不再把 MATLAB MCP Core Server 目录中的陈旧记录无条件覆盖到当前有效的 MATLAB MCP Server 会话。
  • 新增按当前 MATLAB PID 选择有效 sessionDetails.json 并双向同步的会话管理器；健康 Connector 在请求间保持同一端口和凭据，仅在会话缺失、漂移或不可达时重新共享，避免每轮刷新使既有 MCP 客户端失效。
  • MCP 会话文件在共享前和原子替换后均按 MathWorks Windows 规则收敛为当前用户、SYSTEM、Administrators 三个受信 SID 并禁用继承，可自愈旧文件的“不安全权限”错误。
  • superagent_doctor 现在验证会话 PID 属于当前 MATLAB 且 Connector 端口可连接，不再把“文件存在但进程已退出”误报为正常。
  • superagent_doctor 现在理解默认端口自动选择策略：8765/8766 被其他应用占用时不再误报失败，严格固定端口模式仍会给出阻塞诊断。
  • Add-On 安装验收改用 matlab.addons.install(...,'overwrite') 并按标识符和版本启用；同时明确安装门不得通过不受支持的 matlab -batch 执行。
  • 修复 release_acceptance 在 MCP/非默认工作目录中把相对安装包路径和报告路径解析到 Java 进程目录的问题；安装指南同时明确注册验收应只保留一个 MATLAB 实例。
  • 修复会话流式输出期间强制滚到底部的问题：用户向上滚动后暂停自动跟随，只有回到底部附近或主动发送新消息时才恢复。
  • 修复 git status -s 首行状态空格被裁掉后将未暂存文件误计为已暂存的问题。
  • Claude Code 进程正常退出但缺少 result 时补发确定终态；180 秒静默看门狗会结束挂起进程并解除 UI busy，避免请求永久无响应。
  • 修复记录器异常恢复或面板重连后“计数存在但时间线为空”，并在切换到新记录会话时清理上一会话的前端时间线。
  • 前端配置变更改为始终下发当前会话完整配置，避免局部配置在非默认启动后端下错误跳过 MCP 会话刷新。
  • Sidecar 新 UI 连接会显式替换旧 socket，避免重连重叠期间旧连接继续发送命令，同时旧 socket 关闭不会误触发宿主退出。
  • 安装包只纳入 README 当前版本引用的三张真实截图，并由 Node 与 MATLAB 发布门禁共同检查，避免安装版文档图片失效。
  • Add-On 安装重试不再依赖中英文错误文本；只有最终按标识符和版本确认启用后才判定通过。

验证（Verified）

  • 新增 MCP Server/Core 双方向兼容、陈旧 PID 拒绝和远程请求刷新边界测试；真实环境验证两个发现文件从已退出 PID 收敛到当前 MATLAB PID，Connector 端口可连接。
  • Sidecar 100/100、Playwright 桌面/窄屏 52/52、MATLAB R2025b 20/20 通过；专项覆盖复杂任务计划创建、简单问答不显示计划、完整会话配置下发、状态推进、中途增删/改名、失败/中断终态、点击展开环境详情、流式输出期间回看历史、记录器会话恢复、UI socket 替换和窄屏面板边界。
  • 真实 MATLAB R2025b 读取当前仓库验证 Git 变更文件数、暂存/未暂存/未跟踪和增删行统计。

0.14.3 — 2026-07-24

修复（Fixed）

  • Stop 不再本地提前恢复发送按钮；UI 等待 sidecar 的确定中断回执后再结束忙状态。
  • interrupted、error 或缺少 tool_result 的终态会结算本轮遗留工具卡，避免后台已停止但卡片仍永久显示“运行中”。
  • Claude Code / Codex 即使在收到 Stop 前子进程已退出，也会发送中断确认；引导模式只结算旧轮工具卡，不会被迟到回执清除新轮 busy 状态。

验证（Verified）

  • Sidecar 92 项 Node 测试与 Playwright 38 项桌面/窄屏测试通过；新增真实 Stop 状态流回归覆盖 运行中 → 正在停止 → 已中断。

0.14.2 — 2026-07-24

修复（Fixed）

  • 关闭 Copilot 面板或 MATLAB 侧 TCP 连接断开后，sidecar 立即执行幂等 shutdown，停止所有会话并清理仅属于自身 PID 的发现文件。
  • Windows 后端终止改为按精确 PID 执行进程树清理，避免 shell:true 的外层命令进程退出后仍遗留 Claude Code、Codex 或权限 MCP 子进程。
  • Bridge.close() 先释放 TCP 并等待 sidecar 优雅退出，超时后再逐级强制结束，避免面板关闭后后台继续请求模型。

验证（Verified）

  • Sidecar 90 项 Node 测试与 MATLAB R2025b 14 项测试通过；真实 Echo sidecar 在客户端断开后以退出码 0 自行结束并删除发现文件。
  • 真实 MATLAB Echo 面板关闭后，sidecar Java 进程不再存活，发现文件不存在。

0.14.1 — 2026-07-23

修复（Fixed）

  • Sidecar 启动前检测 client/control 端口；默认端口被 Codex 等本地服务占用时自动选择一对空闲端口，避免请求发送后无响应或误连外部服务。
  • superagent(..., AutoSelectPorts=false) 可为固定端口部署保留严格失败语义；Sidecar 提前退出时立即提示日志位置。
  • 恢复 v0.11.1 的消息操作条正常流展开交互，移除 v0.11.2 引入的绝对定位回归；四个操作按钮不再遮挡气泡正文、Fork 分支或后续权限卡。
  • Fork 内层消息只响应自己的直属操作条悬停，避免父级悬停同时展开分支中的其他按钮。
  • System Composer 架构重复构建前先关闭模型、数据字典、Profile 和 Allocation 句柄，避免 .sldd 磁盘状态陈旧。

验证（Verified）

  • Sidecar 86 项 Node 测试、Playwright 36 项桌面/窄屏测试和 MATLAB R2025b 14 项测试全部通过。
  • 在默认端口被占用的真实环境中验证自动选端口与 Echo 全链路；最终 .mltbx 已在 MATLAB R2025b 冷安装并核对安装版 UI 哈希。

0.14.0 — 2026-07-22

新增（Added）

  • 新增 MBSEWorkflow 工程状态机，完整实现 R/F/L/P/V 的提案、批准、生成、执行和确认门禁。
  • 从版本化 CSV/JSON 幂等生成 Requirements Toolbox 原生 .slreqx；从三层架构 JSON 生成 System Composer Functional/Logical/Physical .slx 与接口 .sldd。
  • 功能架构提案强制需求覆盖、唯一功能名和有效连接端点，并建立 System Composer 组件到需求的 Implement 链接。
  • L/P 阶段强制上游分配全覆盖，生成并回读核对 F→L、L→P .mldatx；P 层生成并应用质量、功耗、成本 Profile。
  • V 阶段支持架构追溯、MATLAB Test、Test Manager 和人工评审证据，要求所有需求均有验证项并输出 JSON/Markdown 报告。
  • 提案绑定设计源 SHA-256；设计源漂移后拒绝继续批准/执行，支持重新提案并作废当前及下游阶段。
  • 工具栏新增 MBSE 工程流程弹窗，复用现有本地权限、Plan 只读、审计和工程变更记录器。
  • 支持复用既有需求并从 F 阶段进入。

修复（Fixed）

  • ReqTrace 和 MBSE 需求导入明确指定 CSV 逗号分隔，避免 MATLAB 在部分英文需求表上误判为空格分隔。
  • 工作流只允许重建清单登记过的生成物，拒绝覆盖同名但来源不明的 .slreqx/.slx/.sldd/.mldatx/Profile/报告。

验证（Verified）

  • Sidecar 86 项 Node 测试、Playwright 34 项桌面/窄屏测试通过。
  • MATLAB R2025b 真实生成并验证 .slreqx/.slx/.sldd/.mldatx/Profile；MBSE 测试覆盖状态迁移、三层架构、Implement 链接、分配回读、验证报告、幂等重建与未授权覆盖保护。

0.13.0 — 2026-07-20

新增（Added）

  • 工程变更集状态机：draft → approved → executing → validating → delivered/blocked，任务可声明计划模型、计划文件和验收准则。
  • 记录器异常恢复：自动发现同工程未正常停止的会话，恢复基线、时间线与任务，并对账停机期间变更。
  • 证据包 schema v2 与 evidence-integrity.json，支持重新载入和 SHA-256 篡改检测。
  • setupMatlabSimulinkSuperAgent 安装管理入口，支持 status/install/repair/uninstall，并以有界标记块维护用户启动路径。
  • GitHub Actions 增加 MATLAB R2023b / R2025b 与 Simulink 双版本兼容性门禁。

修复（Fixed）

  • MATLAB 工程根切换时保存并关闭旧工程会话，恢复新工程独立历史，避免会话、上下文和持久化数据串工程。
  • 关闭会话 tombstone 限制为 256 项，避免长期创建标签和 Fork 导致无界增长。
  • 交付判断改为每个受影响模型分别绑定最后变更后的测试和规范证据；多模型任务拒绝未绑定模型的验证结果。
  • 控制连接断开时同时清理事务准备请求；事务检查点失败和超时均确定性拒绝模型编辑。

安全（Security）

  • 记录器启用时，Auto 模型编辑必须先批准变更范围并进入执行阶段，之后仍需 MATLAB 检查点握手。
  • 追溯矩阵按显式需求、受影响模型和模型级验证结果收敛，不再把全部验证证据无差别关联到所有模型。

验证（Verified）

  • Sidecar 86 项 Node 测试、Playwright 32 项桌面/窄屏测试和 MATLAB R2025b 9 项测试。
  • CI 配置使用 matlab-actions/setup-matlab@v3 / run-command@v3，矩阵覆盖 R2023b 与 R2025b。
  • README、安装指南、开发计划、维护手册、贡献指南和 Release 清单已同步至 v0.13.0；两张 README 主图由当前前端源码可复现生成，旧版本截图从发布文档目录移除。

0.11.2 — 2026-07-20

安全（Security）

  • Codex 的 MATLAB MCP 接入零依赖权限代理，在真实工具执行前复用 sidecar 权限决策链。
  • Auto 模式改为显式编辑工具白名单，未知工具不再按“非执行类”自动放行。
  • Auto 模型编辑新增 MATLAB 检查点握手；事务基线阶段不再未经批准执行模型更新回调。
  • 本地权限批准时重新校验会话模式、窗口状态和 180 秒有效期；模型快照语义分析纳入本地权限卡。

修复（Fixed）

  • 修复记录器启动/停止竞态、超限文件误判删除、监视器失效仍显示健康和旧验证证据误判 ready。
  • 模型语义结果被截断时保持 not_ready，要求补齐分析证据。
  • 修复 Markdown 链接属性注入、编辑重发未裁剪持久化历史、记录器刷新丢失焦点与光标。
  • 修复旧 Claude/Codex 子进程迟到输出污染新一轮状态，并限制 JSONL 行缓冲区大小。

验证（Verified）

  • Sidecar 79 项 Node 测试与 Playwright 28 项桌面/窄屏场景覆盖新增安全和可靠性边界。
  • 发布门禁校验安装包内容与 SHA256SUMS.txt 实际哈希一致，并扩展冷安装入口核对。

0.11.1 — 2026-07-19

修复（Fixed）

  • 修复工程模型变更记录器弹窗点击任务名称、需求/工单 ID、责任人或描述输入框时，被全局点击监听立即关闭的问题。
  • 文件变更和记录器状态事件触发弹窗重绘时，保留尚未保存的任务草稿，避免编辑内容和焦点被重置。

验证（Verified）

  • Playwright 22 项桌面/窄屏回归全部通过；记录器场景新增真实输入与异步模型变更后草稿保持断言。
  • Sidecar 72 项 Node 测试、MATLAB R2025b 8 项测试和最终安装包发布门禁全部通过。

0.11.0 — 2026-07-19

新增（Added）

  • 新增 ChangeTransaction 可信模型变更事务：model_edit 前创建模型检查点并记录基线，执行后强制更新编译和新增规范错误检查。
  • 对修改前已保存且干净、基线可编译的模型，验证失败时自动恢复检查点；存在未保存内容时禁止自动回退，避免覆盖用户工作。
  • 每次事务在 ~/.matlab-simulink-superagent/runs/<runId>/manifest.json 写入机器可读证据，敏感字段自动脱敏，UI 显示验证和回退结果卡。
  • 新增工程级 ProjectChangeRecorder：用户显式启动后建立当前工程基线，持续记录 .slx/.mdl/.sldd/.slreqx/.mldatx/.m/.mlx/.mat 及常用工程文本文件的新增、修改和删除。
  • 每个保存事件保留前后快照、SHA-256、文件大小和文本行变化摘要；AI model_edit 事务同步写入同一工程时间线。
  • 工具栏新增独立录制入口，可查看状态和最近记录，并导出 change-report.md、manifest.json、changes.jsonl 完整证据包。
  • 新增 ModelFileDiff：人工或脚本保存 .slx/.mdl 后，隔离加载记录器的前后快照并提取块参数变化、新增块和删除块；结果原位富化同一变更点，不产生重复记录。
  • 语义分析结果以独立 enrichment 事件追加到 JSONL；加载失败只标记失败原因，不阻断文件级快照、哈希和后续持续记录。
  • 记录会话升级为工程变更任务，支持任务名称、需求/工单 ID、责任人和变更说明，并可在记录期间更新。
  • 建模规范、Test Manager、覆盖率、需求矩阵和影响扫描的确定性结果自动汇入验证矩阵；变更数量与验证证据数量分别统计。
  • 最终证据包新增 evidence-index.json 与 traceability.json，汇总影响文件/模型/块、验证状态、未闭环风险、交付判断和按模型关联的定向测试建议。
  • 只有模型语义分析完成、无失败项、规范检查通过且 Test Manager 通过时，模型变更任务才会判为 ready。

验证（Verified）

  • MATLAB R2025b：8 项测试通过，覆盖事务验证/回退/脏模型/中断、保存快照语义对比、覆盖率摘要及确定性证据映射辅助逻辑。
  • Sidecar：72 项 Node 测试全部通过，新增任务元数据、需求追溯、验证矩阵、风险判断、证据索引及停止前最终对账覆盖。
  • UI：22 项 Playwright 桌面/窄屏回归通过，新增工程记录器状态、时间线和报告反馈覆盖。
  • 发布包：Matlab-Simulink-SuperAgent.mltbx 使用 ToolboxVersion=0.11.0 构建，静态发布门禁 9/9、MATLAB 最终包验收通过，并生成 SHA-256。
  • README 两张主界面图由当前 ui/index.html 全屏浏览器预览重新生成，覆盖可信变更事务和工程模型变更记录器。

0.10.3 — 2026-07-19

本补丁版本解决 GitHub Issue #1 中 MATLAB R2023b / 高显示缩放下底部功能区占用过大的问题，并完成快捷功能的响应式三态交互。

新增（Added）

  • 快捷功能增加隐藏、单行、多行三态控制，控件位于沙漏按钮右侧，用户选择保存到本地并在下次打开时恢复。
  • 单行模式按屏幕宽度自然显示按钮，隐藏滚动条，支持鼠标滚轮、触控板横滑和左右箭头浏览后续功能。

修复（Fixed）

  • 将快捷功能从多行默认布局改为单行横向浏览，减少 MATLAB R2023b 或高显示缩放环境中的底栏占用；输入框与配置工具栏不参与切换。
  • 修复快捷按钮悬停上移后，上边缘被单行容器轻微裁切的问题。
  • 修复 capabilities 尚未返回或模型列表为空时，工具栏出现孤立原生下拉箭头的问题。

变更（Changed）

  • 三态控件移动到沙漏按钮右侧；隐藏模式只隐藏快捷功能行，配置工具栏和输入框保持可用。
  • README、安装指南、开发计划、维护手册和发布清单同步至 v0.10.3；两张主界面图由当前源码在 MATLAB R2025b 中重新执行 exportapp 生成。

验证（Verified）

  • Sidecar：65 项 Node 测试全部通过。
  • UI：18 项 Playwright 用例通过，覆盖桌面/窄屏、明暗主题、快捷功能三态、无滚动条滚轮横移、悬停边界、空模型下拉、标签隔离和 Fork 附件隔离。
  • MATLAB：R2025b Panel / Bridge 静态检查完成，matlabsimulinksuperagent.Panel 类加载通过。

0.10.2 — 2026-07-18

本补丁版本完成标签页与 Fork 的上下文、附件资源隔离，避免后台事件和分支粘贴污染当前会话。

变更（Changed）

  • MATLAB Panel 使用 ContextByConv 与 AttachmentsByConv 保存每会话快照和待发送附件。
  • 上下文、附件、移除、清空、消费、关闭和临时文件清理均显式携带并使用目标 convId。
  • UI 标签状态保存独立上下文与附件；切换标签时恢复目标状态并请求刷新，后台事件不覆盖当前页。
  • Fork 输入框粘贴和附件列表固定绑定对应分支会话。

验证（Verified）

  • Sidecar：65 项 Node 测试全部通过。
  • UI：8 项 Playwright 用例通过，覆盖桌面/窄屏、明暗主题、标签隔离和 Fork 附件隔离。
  • MATLAB：R2025b checkcode、类加载及真实 Panel 双会话附件消费/临时文件清理/上下文缓存测试通过。
  • 发布包：Matlab-Simulink-SuperAgent.mltbx 使用 ToolboxVersion=0.10.2 构建并执行最终包验收。

0.10.1 — 2026-07-18

本补丁版本建立可重复执行的发布质量门禁，重点防止安装包内容漂移和 UI 文字越界回归。

新增（Added）

  • 新增 scripts/release-check.mjs，检查版本一致性、运行时零依赖、Git/MLTBX 清单、关键图标、UTF-8、UI 脚本语法、打包排除项和 SHA-256，并可输出机器可读 JSON。
  • 新增 Playwright 桌面与窄屏布局回归，覆盖明暗主题、代表性对话/工具状态、页面横向溢出和快捷按钮文字边界。
  • 新增 release_acceptance.m，从最终 .mltbx 解包执行 MATLAB 类加载、checkcode、superagent_doctor 和 Echo TCP 全链路；Add-On 注册安装保持显式启用和替换保护。
  • 新增 Windows GitHub Actions 质量门禁与 Release 验收清单。

变更（Changed）

  • superagent_doctor 在保留原有可读输出的同时返回结构化检查结果。
  • 将 Simulink 工具栏 16/24 px 图标纳入版本控制，保证干净检出后的安装包可重复构建。
  • Playwright 仅作为开发依赖；sidecar 运行时依赖仍为零，.mltbx 继续排除 node_modules。

验证（Verified）

  • Sidecar：65 项 Node 测试全部通过。
  • UI：4 项 Playwright 场景通过，覆盖 1100×1000 和 520×900 两种视口及明暗主题。
  • MATLAB：R2025b checkcode、结构化 superagent_doctor、包内类加载和 Echo TCP 全链路验收。
  • 发布包：Matlab-Simulink-SuperAgent.mltbx 使用 ToolboxVersion=0.10.1 重新构建并通过内容清单与 SHA-256 门禁。

0.10.0 — 2026-07-11

本版本完成半成品功能收口，重点统一多会话配置、MATLAB 本地操作权限和资源生命周期，并修复会话启动/关闭时的异步竞态。

新增（Added）

  • 每会话完整配置：user_message 与 slash_command 可携带完整 config；新标签、Fork 和隐藏体检会话在 adapter 创建前原子继承 UI 配置。
  • MATLAB 本地权限控制器：版本对比、需求锚定、经验库保存、测试、覆盖率、参数扫描和 SWDD 等副作用操作统一显示确认卡并写审计。
  • 本地权限审计状态机：操作先记录 pending，执行、拒绝或失败后更新为 ok / failed。
  • 权限 MCP 独立测试：覆盖 JSON-RPC 初始化、tools/list、tools/call、请求转发、审批响应和异常输入。
  • 发布证据：新增真实 MATLAB R2025b 内嵌截图，以及运行时架构、消息流、权限和会话生命周期静态图。

变更（Changed）

  • Sidecar 会话增加 ready / generation / dispatchEpoch / closed 屏障，配置重建期间等待新 adapter，Stop 可取消未派发消息。
  • Panel 使用 ConfigByConv 保存完整 per-conv 配置；插入、搜索与本地权限 pending 都按发起会话隔离。
  • 附件改为一次性派发语义：仅成功派发后消费，Stop、关闭会话和销毁面板时清理临时图片。
  • Plan 模式从只约束后端/MCP 扩展到 MATLAB 本地确定性副作用操作，形成双层强制只读。
  • README、INSTALL、开发计划、功能清单、目录结构和全部发布图与当前代码同步。

修复（Fixed）

  • 修复新会话先按默认配置启动、随后才收到 UI 配置造成的后端/模式短暂错配。
  • 修复配置重建、Stop 或关闭期间待派发消息仍可能落入旧 adapter 的竞态。
  • 修复关闭标签或 Fork 后旧 adapter 迟到事件重新写入 UI 的问题。
  • 修复一次性附件重复注入、临时粘贴图片长期残留和跨回合误复用。
  • 修复 Plan 模式可通过 MATLAB 本地确认卡执行写入/仿真/测试的权限缺口。
  • 加固 Git ref、项目路径、规则/需求/经验文件、参数扫描值、Stateflow 与 SDI 数据输入边界。
  • 修复浅色主题中权限卡次级文字对比度不足，并补齐全局 --text2 颜色变量。

验证（Verified）

  • Sidecar：65 个测试，11 个测试文件，全部通过。
  • UI：两段内联 JavaScript 语法检查与浏览器运行时注入检查通过。
  • MATLAB：R2025b checkcode、关键类加载、真实 Panel 启动和两张 exportapp 截图通过。
  • 发布包：Matlab-Simulink-SuperAgent.mltbx 使用 ToolboxVersion=0.10.0 构建并生成 SHA-256。

0.9.0 — 2026-07-07

面向团队赋能的大版本:新增 14 项能力,核心思路是「确定性优先」——检查/对比/统计由本地代码保证准确可复现(零 token、秒回),AI 只做它擅长的解释、归因与建议。

新增 — MBD 工程套件(Added)

  • ◈ 模型语义 diff:AI 每次 model_edit 前后自动快照,卡片展示 参数改前→改后表 / 新增删除块 / 父系统前后截图——slx 二进制改动第一次"看得见"。
  • ✔ 建模规范检查器:8 项确定性检查(未连接/端口·子系统·信号命名/魔术数字白名单/禁用块/层深/单层块数),规则读项目根 modeling_rules.json(内置 MAB 子集默认);报告卡上按需「AI 解释修复」「深查 Simulink Check」。
  • 🧪 Test Manager 深度集成:项目里有 .mldatx 直接本地真跑并结构化汇总;coverage_check 输出决策/条件/MCDC 覆盖率 + 块级缺口 + AI 补例建议(无 license 优雅降级)。
  • 📋 需求双向追溯:需求源=飞书多维表格导出的 requirements.csv(或 json),锚定关系存 req_links.json(纯文本可进 git);画布选中块 + 输入需求 ID 一键锚定,矩阵卡未覆盖高亮、点块画布跳转。

新增 — 高阶九连(Added)

  • /mdiff <ref> 版本对比:当前模型 vs git 历史版本的结构/参数/截图级 diff。
  • /sf Stateflow 解析:状态/迁移表 + 不可达/无出口死逻辑检测 + mermaid 输出。
  • /impact <名> 影响分析:改接口前扫全部已加载模型的使用点(参数引用/命名信号/Goto tag),点击跳画布。
  • /siminsight 仿真分析:SDI 最近 run 的终值/超调/2% 稳定时间 + 曲线图 + AI 动态特性解读。
  • /sweep 变量 值列表 参数敏感度扫描:批量仿真出 取值×输出 对照表,自动恢复工作区。
  • /silcheck MIL vs SIL:license 探测 + 引导式一致性验证编排(需 Embedded Coder)。
  • /night HH:MM 任务;任务 夜间批跑:定时灌入队列逐条执行,完成自动导出 Markdown 晨报。
  • 📌 经验沉淀 + 自动召回:气泡一键存入 .copilot_kb/(可进 git 共享);新消息按报错指纹自动召回相似经验注入上下文。
  • /checkup 并行体检:3 个隐藏子会话同查 结构/风险/可测性,完成后自动汇总成体检报告。

新增 — 文档与可发现性(Added)

  • /swdd SWDD 设计文档生成:确定性提取 接口表/标定参数/子系统树/Stateflow 模式 成 Markdown 骨架落盘,AI 按需补全【待补】描述。
  • 🧭 功能发现系统:输入「? 你的需求」本地秒匹配功能(零 token,候选点击即执行,兜底 AI 选);情境自动建议(报错→诊断、AI 改模型 3 处→复核规范、工具失败→自愈,每类一次可关);斜杠菜单支持中文描述搜索;首次使用引导。
  • 上下文感知 addpath 路径:快照携带用户加载到 MATLAB 路径的文件夹,AI 直接知道共享库在哪。

性能(Performance)

  • asciiJson 向量化:旧实现含中文时逐字符循环,大事件(截图 base64)一次序列化卡数秒且阻塞 MATLAB 主线程(连带拖慢 MCP 工具执行)→ 改按非 ASCII 位置分段拼接,293KB 事件 0.001s(千倍级)。
  • 模型 diff:大画布(>60 块)跳过截图;diff 计算移到事件转发之后——"AI 操作模型慢"的三个根因全部消除。

修复(Fixed)

  • 导航轨把 Fork 分支对话计入主会话轮次;Fork 气泡内批注错发主会话。
  • KnowledgeBase 错误标识符大小写不匹配致召回失效;SfExplain 无出口检测被守卫误杀;DocGen 字符串行/列向量拼接崩溃。

测试(Tests)

  • sidecar 56 → 57;新增 MATLAB 综合功能测试(11 个模块全覆盖,含 asciiJson 性能断言);UI Playwright 断言累计 100+ 全过。

0.7.5 — 2026-06-28

新增（Added）

  • 对话轮次导航轨（minimap + 跳转锚点）：长对话左侧多出一条紧凑的刻度轨（圆角框包裹），把「找回之前某轮问答」从线性滚动变成可视化的轮次索引。
    • 等距紧凑刻度：每条用户消息一个刻度、等距排列、自适应缩距，压缩成一小块、永不松散到要滚动；轮次 ≥ 3 才出现，空/短会话自动隐藏。
    • 悬停富预览：移到刻度弹出预览卡，显示该轮的 第 N / 总 轮、用户问、调用过的工具名，以及元信息徽章——💬 N 答（回合数）、N ✓ / M ✕（工具成功/失败）、⟨⟩ 代码、◈ diff。
    • 点击跳转 + scroll-spy：点刻度平滑滚动到那一轮并整轮高亮；滚动时高亮当前所在轮的刻度（「我在哪」）。
    • per-tab 隔离：导航轨始终针对当前标签页的会话重建，切换会话正确跟随。

修复（Fixed）

  • 切换到空/短会话时，导航轨没清掉上一个会话残留的刻度与预览卡（仅 display:none 隐藏）→ 现在主动清空。
  • 后建会话（会话三及以后）的预览卡因缺 z-index 且 DOM 排在新建 pane 之前，被后续 pane 遮挡/挤偏（错位到下方、压成窄条）→ 给预览卡加 z-index，并在新建标签页后把导航轨/预览卡移到 #panes 末尾。

0.7.0 — 2026-06-27

本次聚焦对话中的交互增强：让用户能针对长回答里的具体段落批量追问，并在 AI 回答过程中即时干预（中断 / 排队 / 引导）。同时修复了一批伴随这些新交互暴露出的健壮性问题。

新增（Added）

  • 选区批注 / 便签卡片：在助手气泡内右键选中有疑问的文字 → 弹出批注框 → 可添加多条批注，以便签卡片形式贴在发送区，一键合并发送。被批注的文字段持久黄色高亮，清晰标识每条追问的对象。批注状态按标签页隔离，不再跨标签串台。
  • 每个气泡的操作按钮：每条助手气泡（含会话恢复出的历史气泡）都带 复制 / 批注 / Fork 按钮，并以配色与图标和气泡正文区分（复制=青、批注=黄、Fork=紫）。
  • 回答中插入新需求：AI 回答时即可输入下一条指令，两种模式（底部图标栏一键切换）：
    • 队列模式：新消息排队，在右下角灰显回显（虚线边 / 淡化 / 灰字，与主会话区分），上一轮结束后逐条自动发送。
    • 引导模式：立即中断当前回答，优先执行新指令。
  • Esc 即时中断：回答过程中按 Esc 立即中断；Stop 按钮与 Send 互斥醒目显示；并加 MATLAB figure 键盘兜底，规避 uihtml 吞键。

变更（Changed）

  • 待发送队列由右上角移到右下角并灰显，避免挤占对话流、与主会话视觉区分。

修复（Fixed）

  • 批注浮框定位：footer 的 backdrop-filter: blur() 会成为定位包含块、破坏内部 position: fixed → 把批注框 / 队列面板移为 <body> 直接子节点。
  • 「上一轮尚未结束」：后端 result 事件先于进程 close 触发，UI 在 result 后立即发下一条会撞上「子进程仍在」→ 新增后端排队（_pending）兜底，进程退出后自动续发。
  • 流式气泡禁批注：流式回答 DOM 持续变更会使保存的 Range 失效（高亮静默失败但便签照加）→ 右键 / 批注入口在 .streaming 气泡上拒绝，提示结束后再批注。
  • 跨块选区高亮安全：跨 <p> / 代码块的选区改为放弃高亮（返回 null，不破坏 DOM），不再用 extractContents 兜底产生不平衡标签；选区落在已有高亮内则复用、不嵌套 <mark>。
  • 后端排队健壮性：_pending 改为 FIFO 队列（收尾期连发多条不互相覆盖）；interrupt / stop / resetSession 显式清空排队；close 续发包裹同步抛错与异步 reject，避免拖垮 sidecar；统一 Codex 看门狗超时与用户主动中断对排队的处理（仅用户中断清队列，超时保留续发）。

测试（Tests）

  • sidecar 单测 52 → 56（新增 claudeCode 多条 FIFO 续发、Codex FIFO 入队 / killChild 标志 / resetSession 清队列）。

0.6.0 — 2026-06

首个公开发布版。内嵌 MATLAB / Simulink 的 AI Copilot 侧边栏，对标官方 Simulink Copilot 六项能力并补齐 MBD 工程化。

新增（Added）

  • 进程内可停靠面板：uifigure + uihtml 原生停靠，无第二窗口 / 无外部浏览器；流式渲染、思考 / 工具可视化。
  • 双后端运行时切换：Claude Code ↔ Codex，会话 / 线程各自 resume；Claude 可选常驻进程消除每轮冷启。
  • 上下文自动感知：当前文件 / 模型 / 选中 block / 工作区 / 最近报错；工程级全工程索引（git 状态 + slx/m/数据字典/Bus 清单）。
  • 对标官方六项能力：对话、解释模型/模块、搜索组件（画布高亮）、排查错误（结构化诊断 + 一键跳转出错 block）、答案锚定 MathWorks 文档（在线 RAG + 本地 help 兜底）、自动执行预定义任务（自适应任务流）。
  • MBD 工程化：批量编辑（逐处 diff 确认）、测试编排闭环、需求追溯矩阵、代码评审（MISRA-C / 复杂度 / Coder 估算）、自愈验证环、画布截图分析。
  • 会话与平台：多标签 + 卡片 Fork、会话持久化按项目恢复、导出 Markdown、成本 / token 显示、Ctrl+K 命令面板、主题三选。
  • 权限与安全模型：只读自动放行 + 破坏性操作经独立控制端口转 UI 确认卡；Ask / Auto / Plan 三档；面板未连接默认拒绝、确认 180s 超时默认拒绝、全程审计留痕；绝不使用 --dangerously-skip-permissions。

修复（Fixed）

  • 零 npm 依赖打包：sidecar（含权限 MCP）改为零依赖、手写 JSON-RPC，不打包 node_modules → 根治旧版（≤ 0.5.0）node_modules 深层路径超 Windows 260 MAX_PATH 导致文件丢失、权限模块 approval not found 的问题。