版本发布记录

重点修正

• 首轮嵌入握手在宿主已加载时仍可可靠抵达，避免 Cloud 已准备而 Solver 未收到握手。
• 宿主主题只在受信握手后同步，Solver 仍保留用户主动切换主题与系统设置的归属。
• Cloud 协商的文件菜单继续承载新建、打开、保存、另存、工程、版本和分享；已保存、保存中、只读与待保存状态使用清晰且可访问的视觉反馈。
• 修复嵌入工作台右侧参数面板在聚焦输入时的内容裁切，不改动任何结构模型或计算结果。

兼容边界

• Host Protocol 仍为 1.0.0；所有新行为均是已有协议上的兼容性修正，不引入账号、云存储、数据库迁移或新的求解域。
• 不修改梁系、平面桁架、平面框架、GNA/GNIA、线性屈曲、项目文件或导出数值。
• 候选、镜像、线上部署、annotated Tag 与公网验收分别记录在 [v1.9.1 发布验收](docs/verification/release-1-9-1-acceptance.md)；未完成项不提前表述为已发布。

重点改进

• 嵌入页头单一化：embed=1 使用 Solver 原生的 Host Portal 顶栏，保留真实 Solver 版本、验证投稿、主题和系统设置；文件与云端保存动作通过 Host Protocol 交给宿主。
• 工作区最大化：嵌入态不再叠加独立应用文件菜单，结构建模、计算和结果区获得完整可用高度与宽度。
• 宿主动作为可选能力：Protocol 1.0 新增可选 requestPortalAction capability 和 hostUiActions allowlist；旧 Host 与旧 Solver 仍可独立回滚。
• 保存闭环保持单一事实：顶栏保存继续复用 requestSave -> project.saveRequest -> saveResult，同一 requestId 贯穿快照、Cloud revision 与最终回执；只读、重复、保存中和非法动作在协议层拒绝。
• 公开案例边界更安全：嵌入页头从独立 Solver 新标签页打开案例库，避免用公开案例替换并误保存当前 host-managed 云工程。
• 主题与设置归属明确：宿主主题参数只作为初始值，用户可以继续切换主题；系统设置仍由 Solver 自己呈现，不在 Cloud 形成第二套配置源。

兼容边界

• Host Protocol 版本仍为 1.0.0；新能力是可选加法扩展，原五项 required capabilities 不变。
• 不改变结构求解算法、数值结果、项目文件 Schema、计算书或可信计算包格式，不新增数据库。
• Solver 不接触 Cloud token、IAM、租户授权、工程 API 或远程存储；这些职责仍由宿主拥有。
• 完整候选、上线、回滚与公网联调证据见 [v1.9.0 发布验收](docs/verification/release-1-9-0-acceptance.md)。

发行修订

• 首次不可变 v1.8.4 Tag 的 Release 工作流在公开制品创建前被 Trivy 正确阻断，未创建 GitHub Release、未推送 GHCR、未部署生产；公开制品改由不可变发行修订 v1.8.4-r1 承载，产品与 Python/npm 包版本仍为 1.8.4。
• v1.8.4-r1 仅把 Debian libssl3t64、openssl、openssl-provider-legacy 升级到修复 CVE-2026-14456 的 3.5.7-1~deb13u2，不改变 Solver 功能、数值结果、项目格式或 Host Protocol 契约。

重点改进

• 云端入口保持可选：独立 Solver 可按部署配置显示“前往云端保存”，跳转 cloud.archsight.cn/solver 登录和管理云项目；嵌入模式不重复显示入口，当前本地工程不会静默上传。
• 保存语义更清楚：工作台把仅作用于当前模型的修改统一称为“应用工程设置”，避免与本地文件保存、宿主保存请求或未来云端保存混淆。
• 错误契约更稳定：未知服务端异常统一返回 HTTP 500；敏感性分析的配置错误继续使用稳定客户端错误，前端先检查 HTTP 状态再消费 JSON。
• 复核数据跨栈对齐：框架与桁架请求的 reviewPoints 进入 JSON Schema、OpenAPI、生成 DTO 和 canonical 请求回显，外部调用方不再依赖未声明字段。
• 依赖边界收口：计算与敏感性应用编排直接依赖分析能力，移除经由工作台服务层的反向依赖；README、路线图和架构文档同步明确开源核心与可选 Cloud 宿主边界。

兼容边界

• v1.8.4 与 v1.8.3 使用相同的求解算法、项目文件、Host Protocol 1.0 和数值结果契约，不新增数据库迁移。
• 未预期的服务端异常由 HTTP 400 修正为 HTTP 500；调用方应继续按 4xx 表示请求问题、5xx 表示服务端问题处理，不应依赖旧的错误分类。
• 未配置云空间地址时入口保持隐藏；开源核心不包含账号、订阅、租户或云项目存储，相关能力仍由可选 Cloud 宿主提供。
• CalculationTrace canonical hash 语义迁移与共回转固定端非零指定位移的 Level 3 数值工作继续 HOLD，不纳入本补丁版本。
• 完整候选验证、镜像、上线与回滚证据见 [v1.8.4 发布验收](docs/verification/release-1-8-4-acceptance.md)。

重点改进

• 公开内容分层：把“验证算例”和“五分钟学习路径”拆成两个独立入口；学习路径只作为教学导航复用已验证模型，不再与工程算例混作同一级对象。
• 中文展示投影：公开案例的类型、指标、来源、状态、路径控制和容许误差统一使用专业中文；长英文 caseId、算法枚举和协议字段不再占据主阅读面，正式 BM/GNA 编号仍作为可追溯引用保留。
• 原始证据降噪：外文文献题名和原始出处默认折叠到“查看原始文献出处”，用户主动展开时仍可核对，不删除引用和来源链接。
• 图形真实边界适配：受力变形图、弯矩图、剪力图、局部挠度图、轴力图及计算书同源图形统一按真实几何边界缩放；修复 Williams 浅拱、短跨水平模型和纯竖向悬臂柱被压缩到角落、留白过大或文字裁切的问题。
• 验收覆盖加强：新增真实后端页面门禁，复算三杆桁架、Williams 浅拱和纯竖向悬臂柱，并同时核对受力变形图、工程图、节点标注和学习路径完成状态。

兼容边界

• v1.8.3 与 v1.8.2 使用相同的求解算法、数值契约、项目文件和导出格式，不改变计算结果，不新增数据库迁移。
• GNA、GNIA、P-Δ、SAP2000、Williams、Lee、单位和公式等必要专业缩写或专名继续保留；内部协议字段只进入技术审计信息、API 和可信计算包。
• 完整候选验证、镜像、上线与回滚证据见 [v1.8.3 发布验收](docs/verification/release-1-8-3-acceptance.md)。

重点改进

• 中文工程表达统一：关键点的类型、指标、来源、状态、方法名称和单位优先显示中文；loadFactor、max_displacement_mm 等机器字段改为“荷载因子”“最大位移”等用户术语，必要的 GNA、GNIA、P-Δ 等专业缩写保留并解释。
• 计算过程可读：输入规范化、自由度映射、单元处理、整体装配、边界约化和求解步骤显示中文摘要；完整请求哈希、模型哈希、算法标识和内部状态码集中到可折叠的技术审计信息。
• 图形标注降噪：端点、反弯点、局部极值、全局极值等标注可按类别控制，默认优先保留控制性结论；图面与计算书使用同一显示策略，避免屏幕简化而导出重新堆满标注。
• 布局与避碰修复：修复受力变形、内力图、几何非线性过程播放和稳定审查中的裁切、文字重叠及无意义横向滚动；关键数值保持可见，完整数据仍可从点表、计算书和可信计算包复核。
• 结果证据分层：工作台优先显示有界的控制点、复核点和包络记录，避免数百行内部证据直接铺满页面；未经删减的 canonical 证据继续保留在 API、详细计算书和可信计算包中。
• 公开案例与模板本地化：公开工程名称、验证来源、结构形式、方法说明和教学提示统一中文化，不改变 caseId、算法 ID、Schema 和结果哈希等机器契约。

兼容边界

• v1.8.2 与 v1.8.1 使用相同的结构分析域、求解算法和公开契约，不改变数值结果，不新增数据库迁移。
• corotational_newton_v1、initial_stress_v1、CalculationTrace@1、NonlinearPathTrace@1 等标识继续作为可复算协议事实保留；只改变其面向用户的呈现方式。
• 完整验证、镜像、上线与回滚证据见 [v1.8.2 发布验收](docs/verification/release-1-8-2-acceptance.md)。

核心新增

• 共回转全 Newton：新增 corotational_newton_v1，以当前几何组装完整残差与一致切线，支持确定性残差线搜索、自适应增步、cutback、多重收敛判据和最大接受步数保护；initial_stress_v1 继续保留用于 v1.8.0 结果复算。
• 平衡与稳定分离：equilibriumStatus 与 stabilityStatus 独立报告；荷载控制无法越过极限点时保留最后收敛状态、失败尝试、稳定指标和稳定错误码，不把 Newton 收敛写成安全结论。
• 初始缺陷与荷载路径：支持显式节点缺陷及首阶线性屈曲模态缺陷，记录模态号、幅值、归一化、来源和实际几何偏置；固定预荷载与变量荷载分别推进，不对非线性结果做线性叠加。
• 过程播放与方法比较：新增 NonlinearPathTrace@1 和 MethodComparison@1；首阶、兼容算法与共回转算法共享请求/模型签名及各自来源哈希，入门、工程、算法三层解释绑定确定性事实。
• 图形与交付证据：路径拐点、残差峰值、最小切线指标、cutback、最后收敛点和终止点均保留数值；标准/详细 DOCX、XLSX 与可信计算包同源记录路径、关键点、缺陷、方法比较和失败证据。
• 可信导出闭环：所选工况/组合先在后端统一投影再生成正文，避免“来源标签正确但表格仍是主结果”；零首阶横向响应不再写出 Infinity，而是返回可机读的不可比原因；详细计算书新增共回转当前弦、基本变形、残差方程、切线增量和代表单元状态。
• 失败与比较证据：部分收敛 GNA 作业可由服务端持久化结果生成失败审查材料，保留最后收敛点、失败尝试和路径签名；方法比较补充线性屈曲参考、目标荷载点、不可比原因及四种方法的来源哈希。
• 公开专业验证：公开验证集扩展到 71 个通过算例，新增受压梁柱解析放大、临界后平衡/不稳定分离、Williams toggle 极限点、Lee frame 极限点前多点路径和 Euler 初始缺陷柱解析基准。
• 关键正确性修复：长路径关键帧按全路径分布保留，避免只剩前段与终点；屈曲模态缺陷只叠加相对端点弦的形状残差，避免内部网格重复计算端点插值；模态方向采用确定性平动锚点规范化。

发布验证

• 后端全量 736 passed, 2 skipped，前端单元测试 444/444，lint、TypeScript、生产构建和生产依赖审计通过；公开 benchmark 71/71 通过。
• Chromium 发布闭环 51/51、三浏览器 DOCX 导出 12/12、三浏览器稳定与关键点矩阵 15/15 通过；正式镜像的真实 GNA 教学链路与 Host 集成通过。
• Trivy 中“已有修复版本但未升级”的 HIGH/CRITICAL 为 0；原始扫描仍有 14 个 HIGH、3 个 CRITICAL 未提供上游修复版本，已如实保留在验收记录。SPDX SBOM 包含 109 个包、2959 个文件。
• v1.8.1 GitHub Release 已发布，7 份公开制品及 SHA256SUMS 完成核对；GHCR 与阿里云镜像摘要一致，官方演示站已使用阿里云精确标签上线，v1.8.0 精确镜像与离线归档作为直接回滚点保留。完整证据见 [v1.8.1 发布验收](docs/verification/release-1-8-1-acceptance.md)。

核心新增

• 二维框架稳定分析：新增真实 P-Delta 迭代和线性屈曲特征值求解，分别保留工况/组合、迭代收敛、屈曲模态、残差及接近临界时的失败证据。
• 计算过程与关键点复核：新增 CalculationTrace@1、工程关键点、用户复核点和控制包络；请求、模型、结果哈希及单位、符号、精度和控制来源均可追溯。
• 命名快照与方案比较：可保存当前计算快照并比较结果差异，明确区分模型变化、结果变化和不可比状态。
• 图形与计算书同源：梁、框架和桁架图形标注端点、极值、零点、跳变侧别或适用控制对象；屏幕、DOCX、XLSX 与可信计算包共享同一结果事实。
• 分层与失败审查材料：标准版和详细版计算书具有真实内容差异；校验阻断、矩阵奇异或不收敛时可导出失败审查材料，不伪造成功结果。

发布验证

• 66 个公开 benchmark、独立刚度法、后端与前端全量测试、三浏览器计算书导出、稳定分析、旧项目兼容、发行包隔离安装、Docker 镜像、安全扫描和回滚均已纳入发布门禁；证据见 [v1.8.0 发布验收](docs/verification/release-1-8-acceptance.md)。

重点变化

• 新增可信计算包：工作台、REST API、CLI 与 MCP 生成同一格式的计算证据，可校验完整性并独立复算。
• Python wheel、源码包、Host Client 与离线 Docker 镜像可直接获取；GitHub Release 同步提供校验和、安全报告与 SBOM。
• 新增中英文五分钟上手路径和三条黄金流程，覆盖结构工程师、开发者与 Agent Host。
• 梁、平面桁架、平面框架各提供一条学习复核路径，围绕三项枚举化预判、实际求解、图形核对和 A 级教材解析证据展开。
• DOCX、XLSX 与可信计算包记录路径、选择、标准结论和一致性状态；展示文案由 benchmark 事实源解析，不接受客户端伪造标签。
• 普通工程保持原有工作台，不新增账号、课程、班级、作业或订阅；匿名里程碑不采集模型、参数、结果、文件、自由文本或身份。

发布验证

• 后端、独立刚度法、前端、三浏览器导出与学习路径、真实 DOCX/XLSX、发行包隔离安装及 Docker 镜像均纳入发布门禁。

重点变化

• 修复前端 brace expansion 拒绝服务风险，并把生产依赖与构建工具链分别纳入漏洞门禁；首次克隆和 Windows CI 显式安装、校验 Rolldown 原生可选绑定，避免“本机缓存可构建、干净环境失败”。
• Docker 构建继续固定基础镜像 digest，并允许通过同 digest 的 Public ECR 镜像源规避失效代理缓存；部署脚本只有在 Compose 容器全部进入 healthy 后才返回成功，异常状态和超时会输出最近日志。
• /api/jobs 的 X-Tenant-Id 明确为 clientJobId 幂等命名空间，并同步进入 OpenAPI 与 CORS 预检；该字段不承担认证、授权或读取隔离，既有 jobId 访问边界不变。
• 公开验证集扩展到 66 个通过算例，其中 A 级 22 个、B 级 26 个、C 级 1 个、D 级 17 个；B 级算例均可由仓库内独立刚度法基线复跑，不再只是标签声明。
• 新增二维杆系坐标变换解析算例，覆盖斜构件端位移、刚体平移、桁架轴力、框架轴力与弯矩恢复；独立参考实现进一步覆盖 global_y 分布荷载、转动弹簧和轴向斜撑。
• 建立三类结构规模基线与 weekly nightly 质量任务，持续复跑性能漂移和 Chromium / Firefox / WebKit 计算书导出矩阵；不把单次性能数据写成营销承诺。

质量门禁

• 后端全量测试、前端 lint / TypeScript、400 项单元测试和生产构建通过。
• 独立刚度法基线 26/26 通过；公开 benchmark 66/66 通过，发布工程与版本一致性检查通过。
• v1.6.2 工程生命周期、诊断与结果有效性在 Chromium / Firefox / WebKit 共 39/39 通过；Chromium 跨版本回归 19/19 通过，覆盖 v1.6.1 Reference Host、v1.6 Host、v1.5 快速建模与荷载场景。
• 框架 / 桁架 DOCX 同源工程图与数据曲线选项在 Chromium / Firefox / WebKit 共 12/12 通过。
• CI 与 Tag Release 直接阻断 Chromium 工程生命周期、诊断、结果有效性和 DOCX 导出回归；weekly nightly 继续阻断完整三浏览器 DOCX 矩阵。
• Tag 发布仍必须复跑完整 CI、构建后镜像 Host 验收、依赖审计、Trivy HIGH / CRITICAL 门禁、SPDX SBOM 和制品校验和；候选提交、GitHub Release、目标镜像仓库推送与线上更新保持为四个独立状态。

重点变化

• 统一独立与嵌入模式的工程生命周期，避免异步保存、打开失败、恢复和只读切换破坏当前工程或错误清除未保存状态。
• 将建模问题和求解失败收敛为带对象定位、原因与处理建议的结构化诊断，用户可以从问题直接回到对应建模入口。
• 为结果增加对象、模型签名、工程修订、后端模型哈希和请求哈希来源；模型变化后立即标记结果失效并禁止导出，迟到响应不能覆盖新模型。
• 固化 Host Protocol 1.0 状态机、请求关联、超时、迟到消息和错误语义，并明确 1.x 兼容、弃用与升级规则。
• 新增无框架 TypeScript SolverHostClient，统一精确 origin、会话校验、保存握手与超时处理；仓库内 Reference Host 已迁移使用该 Client，不再直接编写 postMessage。
• 新增 v1.6.2 canonical 工程统一验收，同一份 .slv 在独立模式和真实双 origin 嵌入模式完成计算、修改失效、重算、导出、保存、刷新重开和只读审阅。
• 增加后端架构依赖门禁，解除求解、归一化、工作流和 API 层之间的反向依赖；内部计算结果收敛为唯一 canonical 契约，兼容字段只在 HTTP 边界组装。
• 将结构化领域异常、异步作业生命周期和跨栈 JSON Schema / TypeScript DTO 纳入统一契约，生成类型与后端 Schema 漂移会直接阻断发布。
• 拆分 json_schemas.py、structural_model.py、model-workflow-actions.ts、App.tsx 和 Canvas 等深层热点，前端运行结果收敛到工程对象这一唯一状态源。
• 优化交付体积与依赖卫生：生产主入口约 390 kB（gzip 约 107 kB），候选镜像约 352 MB，并保留非 root、健康检查与精确 Host origin 约束。

质量门禁

• 保留 v1.6.1 Reference Host、v1.6 Host 和 v1.5 工作台跨版本回归，并将 v1.6.2 统一验收接入 CI 与 tag release。
• Docker 门禁对构建后的镜像运行健康检查和 v1.6.2 canonical Host 接入，不以本地开发服务器结果替代镜像验收。
• Docker 依赖安装在瞬态网络中断后保留 pip 缓存并有界重试，候选镜像仍以构建后验收和漏洞扫描结果为准。
• Playwright 发布验收独占 Solver/Host 测试服务并使用严格端口，避免并行测试进程复用服务后在长 WebKit 套件中途被回收；长场景统一使用明确的 120 秒测试预算。
• Flask 更新至 3.1.3、pytest 锁定至 9.1.1，关闭 GitHub 已识别且已有修复版本的运行时与开发依赖告警。
• tag release 继续执行生产依赖审计、Trivy 已修复 HIGH / CRITICAL 漏洞零容忍、SPDX SBOM、制品哈希和 GitHub Release 门禁。

重点变化

• 将 examples/host-iframe-demo 升级为零框架 Reference Host，使用真实双 origin、精确 targetOrigin、session/nonce 会话绑定和浏览器 localStorage 托管保存。
• 重构 Reference Host 的产品边界：宿主顶栏负责工程新建、打开、保存和只读审阅，Solver 通过 embed=1 只展示工程树、参数建模、结构计算、敏感性分析和结果工作台，协议诊断默认收起。
• 为 Host 保存链路增加 requestId 确定快照握手与本地修订校验，避免陈旧回执清除后续编辑；无效工程打开会回滚并恢复既有会话。
• 嵌入模式停止读写 Solver 本地项目草稿，避免外部宿主工程与独立工具或其他宿主会话发生浏览器存储串扰。
• 新增 python scripts/run_host_iframe_demo.py 一条命令启动 Solver 与 Reference Host；支持连接已有 Solver 的 --host-only 模式，并补充 VS Code Host iframe demo 启动入口。
• 新增容器运行时 ARCHSIGHT_SOLVER_HOST_ALLOWED_ORIGINS 配置，已发布镜像可按部署环境设置精确宿主白名单，不需要重新构建前端。
• 修正 bootstrap ready 与公开 solver-host-message JSON Schema 的差异：bootstrap ready 可省略会话字段，launch 后的 session ready 必须回显 sessionId 与 nonce。
• 从 document.referrer 只解析 allowlist 内的精确 http/https origin，不再使用 postMessage(..., "*")；无 referrer 时由宿主在 iframe load 后主动 launch。
• origin 配置会忽略 *、子域通配、opaque origin、带路径/query/hash 或认证信息的无效值，继续保持精确白名单边界。
• Reference Host 会在 launch 前协商五项必要 capability；缺少 acceptHostSaveRequest 等能力的旧 Solver 会显示不兼容并禁用工程操作，不再出现“已连接但无法保存”的假成功。
• 宿主发起保存后增加 8 秒响应超时与重复请求门禁；Solver 未返回确定快照时保持现有保存状态并给出可见失败信息。
• 正式 HTML 响应新增与运行时 allowlist 同源的 CSP frame-ancestors，在浏览器渲染层阻止未授权站点嵌入。
• 新增 canonical sample-project.slv，由前端 parser、后端项目健康检查和发布门禁共同验证，避免示例项目契约漂移。

质量门禁

• Chromium 直接运行公开 Reference Host，覆盖跨 origin 可编辑接入、项目变更、保存、刷新重开、只读和非法 origin 拒绝。
• Reference Host 浏览器验收额外锁定嵌入模式不渲染独立应用 Header，并覆盖宿主新建、打开、保存工程生命周期。
• 原 v1.6 同源 Host 回归继续覆盖 launch/change/save/result、只读锁定和非父窗口拒绝。
• Host Bridge 单元测试和后端 JSON Schema 测试覆盖 bootstrap/session ready、严格 origin 归一化和 canonical 示例文件。
• CI 与 tag release 同时运行 v1.6.1 Reference Host 和既有 v1.6/v1.5 发布回归。
• Docker 发布门禁在构建后注入运行时 allowlist，并复用同一 Playwright 用例验证独立 Host 的握手、保存与刷新重开，不再只检查容器 health。

重点变化

• 新增中性 Host iframe 协议，贯通 launch、project changed、save request、save result 和 error 消息；跨域宿主必须进入 origin allowlist，会话使用协议版本、sessionId、nonce 和父窗口来源共同约束。
• Host readonly 由状态标签升级为真实只读边界，统一锁定建模 mutation、工程新建/导入/保存、分析对象增删和项目设置，同时保留分析对象浏览与结果审阅。
• 新增 .slv 项目文件 manifest、artifact manifest、稳定 integration errorCode 和四类 JSON Schema registry，明确 single-json 当前能力与未来容器格式边界。
• 新增 project_document_health 能力，CLI / MCP 可检查项目文件版本、ASMS-JSON 契约版本、manifest、对象分布、活动对象、迁移诊断和 host readiness。
• 工作台项目信息弹窗新增“项目契约”页签，展示项目文档 kind、schema、manifest、活动对象、导出 manifest、host 会话和证据链状态。
• project_template_registry 通过 CLI / MCP 暴露 24 个内置模板的结构体系、主要结果指标、入口、支持动作和 benchmark 证据；公开 templateId 可直接进入 Host load / solve / export，不再存在发现契约与执行契约断链。
• README、快速开始、API 参考、Agent 集成指南和 host iframe demo 同步补充项目健康检查与模板 registry 调用方式。
• ECharts 升级到 6.1.0，关闭旧版公开 XSS 风险；CI 和 tag 发布对 production npm dependency 的 moderate 及以上漏洞执行硬门禁。
• lxml 升级到 6.1.1，修复镜像扫描检出的高危漏洞 CVE-2026-41066；tag 发布对镜像中已有修复版本的 HIGH / CRITICAL 漏洞保持零容忍。

质量门禁

• 后端全量测试通过：517 passed，2 skipped；benchmark、项目健康、运行时 schema、MCP、模板 registry、CLI 和三类结构 Host-to-export 回归均通过。
• 前端 lint、TypeScript、366 项单元测试和生产构建通过；Chromium 发布主链路 10 项通过，Chromium / Firefox / WebKit DOCX 同源工程图矩阵 12 项通过。
• v1.6 Host iframe 验收覆盖 editable、真实 readonly、save handshake 和非父窗口消息拒绝；v1.5 首算与工况组合验收继续作为跨版本回归保留。
• 版本一致性门禁覆盖 pyproject.toml、uv.lock、前端 package/lockfile、CHANGELOG 和公开 release notes。
• Docker 发布门禁覆盖非 root 运行、容器健康检查、镜像漏洞扫描、SPDX SBOM、制品 SHA-256 哈希和 tag 驱动的 GitHub Release。

重点变化

• 梁系模板页新增连续梁快速生成和“生成并计算”，可按跨数、单跨长度和全跨均布荷载生成跨段、支座和荷载，继续保持“跨段 / 支座 / 荷载”的梁系建模心智。
• 平面框架模板页新增规则框架快速生成和“生成并计算”，可按跨数、层数、跨度、层高、梁面均布荷载和顶层水平荷载生成节点、构件、支座和荷载。
• 平面桁架模板页新增平行弦桁架快速生成和“生成并计算”，可按节间数、节间长度、桁高和上弦节点荷载生成节点、杆件、支座和节点荷载，不引入弯矩主指标。
• 三类快速生成入口增加工程预设和“即将生成”摘要；三类内置模板增加“打开并计算”，从公开验证映射模板直接进入首算结果。
• 新建分析对象增加建模路径选择：快速生成、对象编辑、文本导入分别直接打开模板、对象、文本页，减少创建后再次寻找入口的操作成本。
• 梁系补齐荷载工况和荷载组合编辑入口，覆盖均布、集中、线性分布荷载，并在对象导航和表格摘要中形成统一入口。
• 平面桁架补齐荷载工况和荷载组合编辑入口；节点、杆件、荷载复制 / 镜像 / 阵列、重命名和删除时同步维护工况内引用与组合系数。
• 结果页统一“主结果 / 工况 / 组合”来源切换，不再只支持平面框架；梁系和桁架的受力变形图、数据曲线和摘要会随当前来源切换。
• DOCX / XLSX 导出记录当前结果来源，并在 DOCX 导出图像生成时使用与界面一致的选中结果来源。
• 新增结构模型诊断中心，三类模块求解前统一提示支座约束不足、孤立节点/杆件、荷载工况/组合引用、单位/刚度异常和桁架不适用字段，让用户知道“为什么不能算”或“为什么结果可疑”。
• 新增计算书审阅模式，导出设置可选择“草稿 / 可审阅”，DOCX / XLSX 同步写入审阅状态、ASMS-JSON 契约版本、模型假定、结果来源、诊断警告和公开 benchmark 参考。
• ASMS-JSON 契约治理纳入 v1.5.0：三类求解 payload、JSON Schema、OpenAPI、前端类型和公开文档统一声明 schemaVersion，项目文件导入旧格式时给出迁移与契约版本校准提示。
• API envelope 前端归一化补齐梁系和桁架的 loadCaseResults / loadCombinationResults，避免后端已返回但前端视图丢失。
• 新增 v1.5 发布验收清单和 Playwright 荷载场景验收，覆盖梁系 / 平面桁架工况组合、结果来源切换和 XLSX 导出来源记录。
• 新增快速建模生成器单元测试，锁定连续梁、规则框架和平行弦桁架的生成数量、对象类型和专业指标边界。
• 新增模型诊断、项目文件契约迁移、ASMS-JSON schemaVersion 漂移和计算书审阅状态测试，锁定 v1.5.0 的可审阅交付边界。
• 版本号统一提升到 1.5.0，同步 package.json、frontend/package.json、pyproject.toml、uv.lock 和 lockfile 顶部项目版本。

质量门禁

• 前端 npm --prefix frontend run lint 通过。
• 前端 npm --prefix frontend run test:unit 通过：360 passed。
• 前端 npm --prefix frontend run build 通过；Vite 仍提示部分 chunk 超过 500 kB，这是既有包体提示，不影响构建产物生成。
• 后端 python -m pytest backend/tests -q 通过：479 passed，2 skipped。
• 版本一致性检查 python scripts/check_versions.py 通过：根包、前端包、pyproject.toml、uv.lock 和 CHANGELOG.md 均为 1.5.0。
• Playwright release-1-5-quick-modeling.spec.ts 覆盖梁系、平面框架、平面桁架“生成并计算”到求解 payload 的首算路径。
• Playwright release-1-5-quick-modeling.spec.ts 覆盖三类内置模板“打开并计算”到求解 payload 的首算路径。
• Playwright release-1-5-quick-modeling.spec.ts 覆盖新建分析对象后直接进入指定建模路径。
• Playwright release-1-5-load-scenarios.spec.ts 覆盖梁系和平面桁架工况 / 组合发布验收。
• 前端单元测试覆盖求解前诊断中心、ASMS-JSON payload schemaVersion 和项目文件导入迁移诊断。
• 后端测试覆盖 JSON Schema / OpenAPI schemaVersion 漂移、计算书审阅状态和导出证据表。

相对 v1.3.0 的主要变化

• 平面框架补齐构件均匀温度荷载闭环，覆盖文本模型、求解 payload、材料默认线膨胀系数、支座反力、杆端内力、节点位移和结果图切换。
• 平面框架新增支座位移约束，统一前端输入、ASMS-JSON / OpenAPI 契约、后端归一化和求解链路。
• 工作台增加撤销 / 重做、节点坐标网格吸附、表格批量编辑、复制、镜像、阵列和选中节点直连构件，降低显式节点 / 构件模型的编辑成本。
• 主控画布和结果图改进标注避让、尺寸标注偏移、选择状态、底部状态栏和紧凑布局；梁系、平面框架、平面桁架的常用模板在桌面与移动视口下保持可读。
• 多工况 / 荷载组合状态在工程文件恢复、求解 payload 和结果页切换中保持一致，降低模式切换或项目往返时的工况数据丢失风险。
• 结构化诊断优先展示后端 diagnostics.issues 明细，避免求解器已经返回工程诊断时被前端通用 fallback 文案覆盖。
• 公开 benchmark 扩展到 61 个通过算例，补充验证等级证据链，并同步更新验证报告与目录摘要。
• 后端收紧大请求体限制、异步作业幂等作用域、导出缓存一致性和响应 envelope 处理，降低长时间运行和重复请求下的状态漂移风险。

质量门禁

• 后端全量测试通过：477 passed, 1 skipped。
• 前端单元测试通过：344 passed；lint、TypeScript 检查、生产构建和版本一致性检查通过。
• Playwright 发布验收覆盖三类内置模板冒烟、平面框架多工况 / 温度结果切换、网格吸附、撤销 / 重做、复制 / 镜像 / 阵列后的拓扑一致性。

相对 v1.2.0 的发布定位

• v1.2.0 已经交付公开验证工程、投稿闭环和基础工程图；v1.3.0 的核心是把梁系、平面框架和平面桁架推进到“建模入口清楚、结果口径稳定、计算书图形可信、公开验证可复核”的专业工作台闭环。
• 这不是新增第四类分析域的版本，而是对三类二维线弹性静力分析对象做交付质量收口：对象建模、文本模型、结果图、DOCX / XLSX 计算书、ASMS-JSON、API、CLI/MCP、benchmark 和公开文档围绕同一套结构对象语义对齐。
• 重点修复 v1.2.0 后暴露出的可信度短板：框架/桁架计算书不能再退回与页面口径不一致的降级示意图，梁系不能因为三类模块统一而丢失“跨段 / 支座 / 荷载”的行业常用建模心智。

工作台建模与交互

• 三类结构模块统一为“模板 / 基本 / 对象 / 文本 / 表格”五页签；梁系、平面框架和平面桁架共享入口秩序，但保留各自正确的专业对象口径。
• 梁系拆出模板、基本、跨段、支座、荷载、文本模型和表格摘要入口，恢复梁系以“跨段 / 支座 / 荷载”为第一建模心智，并在文本模型中保留支座自由度语义。
• 平面框架补齐节点、构件、材料截面、端部释放、节点弹性约束、荷载、荷载工况和荷载组合编辑入口，支持选中节点直连新增构件，减少手工维护节点连接的摩擦。
• 平面桁架补齐节点、杆件、支座、荷载和文本模型编辑入口，统一杆件编号、节点连接、材料标签和支座节点摘要，避免把桁架杆件误导为受弯构件。
• 对象摘要、基本页、结果页受力变形、荷载编辑器、模板库和计算书选项统一使用共享对象词表；框架使用“构件”，桁架使用“杆件”，梁系使用“跨段 / 支座”，降低跨模块术语漂移。
• 主控建模画布改为按模型规模自适应显示，普通模板默认完整可读，高密度模型才进入低倍缩放与可平移画布；标签布局增加遮挡控制，降低大模型节点、构件/杆件、荷载和尺寸标注混叠风险。
• 结果页收敛为统一的内容区、指标选择器、结果工具栏和工程图预览结构，敏感性分析响应指标从共享结果指标目录派生。
• **受力变形主视图升级**：统一三类分析对象的“受力变形”主视图，支持位移倍率和未变形结构、极值、荷载图层的动态显隐控制；优化实际变形比例下大跨结构内力图和位移图的视觉表现与可读性。
• **视觉风格与信息密度收口**：收紧基本页、系统设置面板、模板库等界面的文本说明与密度，降低用户的视觉断层；统一应用内 SVG 工程图（字重、标号）、ECharts 数据曲线与 DOCX 计算书导出图形的线条粗细（统一向 1.5 基准靠拢），消除视觉割裂。

模板、公开案例与验证集

• 新增 4 个高频专业模板并写入模板 benchmark 映射：梁系“两端固结均布荷载”“一端固结一端简支”，平面框架“坡屋面门式刚架”，平面桁架“平行弦桁架”。
• 所有内置模板均维护 data/verification/template_benchmark_map.json 映射；无法完全对应公开 benchmark 的模板明确标注“相近/相关”，不把相近算例包装成完全验证。
• 公开验证工程继续由 benchmark catalog 生成，覆盖 33 个公开算例：梁系 12 个、平面桁架 8 个、平面框架与框架梁退化验证 13 个；前端“公开案例”和 GET /api/examples/projects 使用同一份数据。
• 公开案例、计算书和 API 文档继续携带 caseId、验证来源、标准值、容许误差和校核指标，方便第三方平台、教学场景和 Agent Runtime 复核。
• BM-006 作为公开的框架梁退化样例保留在验证工程中，但机器预期状态仍为 REVIEW；发布说明和验证材料明确其人工复核边界，不把它表述成完全合格样例。

计算书与导出

• 框架与桁架 DOCX 导出改为使用前端同源工程图 PNG，保留节点、构件/杆件、支座、滚动支座角度、荷载、尺寸、结果图名称和控制值标注，不再混入旧的非 UI 同源曲线或降级结构图。
• 缺少前端同源图片时，DOCX 导出会明确暴露缺图语义；测试锁定“不能伪装成已有工程图”的行为，避免计算书交付材料出现静默降级。
• 计算书图形范围、插图模式、图形 key 和排版选项收敛到共享图形目录和共享导出选项，后端 DOCX 插图断言、前端 reportImages 和 Playwright 导出矩阵围绕同一目录验证。
• 大模型计算书插图按节点规模扩展画布，超宽图形自动切换横向页面，降低固定画布导致的裁切、二次压缩和图例拥挤风险。
• 梁系计算书补齐材料与跨段刚度语义，框架/桁架计算书补齐材料截面摘要、支座节点摘要、验证来源证据链和适用边界说明。
• 导出文件名统一按分析对象和导出类型生成，WORD 计算书、XLSX 参数表与前端下载状态使用一致口径。

专业契约、API 与 Agent 集成

• 新增共享目录：材料、支座、结果指标、计算假定、计算书图形、导出选项和 ASMS 关键字段；前端、后端、API 文档、文本模型和导出逻辑通过共享事实源减少字段漂移。
• JSON Schema、OpenAPI、ASMS-JSON 文档和 MCP 能力说明同步扩展，覆盖公开案例、benchmark 投稿、计算书导出、异步作业和 schema registry 等集成入口。
• 收紧桁架输入契约：拒绝弹性支座、滚动支座法向角、凝聚自由度、转角释放等不符合桁架假定的高级框架字段；桁架支座类型在前端契约中排除不适用的 fixed 口径。
• 收敛框架支座类型、节点弹性约束、滚动支座角度、材料默认值和构件连接规则，减少 UI、payload、schema 与计算书之间的专业边界不一致。
• 文本模型解析能力集中到共享基础函数，梁系、框架、桁架分别复用支座解析、荷载解析和对象归一化规则，降低新增语法膨胀风险。
• 本地异步作业文档和行为明确为轻量队列：状态默认写入本地 SQLite，执行由当前服务进程承担；失联时显式失败，不承诺多实例分布式调度或生产级幂等重试。

文档、部署与开发体验

• 新增结构力学入门文档，覆盖三类分析对象、支座类型、梁系、桁架、框架、符号与方向约定，帮助开发者、学生和贡献者理解当前开源核心的力学边界。
• 更新 README、能力边界、API Reference、ASMS-JSON、Agent 工程流、Agent 集成和公开路线图，明确“可验证、可复核、可导出”的开源核心定位。
• 新增部署模板与运维脚本：Docker Compose 示例、Nginx 示例、部署说明、镜像构建脚本、远程部署脚本和端口清理脚本，补齐公开发布后的私有部署入口。
• 新增 AGENTS.md、CLAUDE.md、GEMINI.md 和 AI_CODING_RULES.md，把项目定位、结构工程术语、中文输出、版本同步和验证要求沉淀为 AI 编码入口。特别固化了强制结构化提交流程（包含 Constraint, Rejected, Directive 等字段）以保证协作上下文透明。
• 前端单元测试入口收敛为 npm --prefix frontend run test:unit，计算书图形导出增加 Chromium / Firefox / WebKit 三浏览器矩阵入口，发布构建前自动从 CHANGELOG.md 同步前端 release notes。
• 梳理 VS Code 及本地全栈调试（Antigravity）入口，修复调试启动顺序。

质量门禁

• 后端测试覆盖公开 benchmark、公开案例、JSON Schema / OpenAPI、材料/支座/结果指标共享目录、报告图形目录、计算书文件名、异步作业、文本模型和三类工作台 payload。
• 前端测试覆盖模板 benchmark 映射、材料与支座词表、对象术语漂移、节点连接、文本模型、主控画布尺寸、报告图形生成、计算书选项、结果指标和导出视觉契约。
• Playwright 视觉链路锁定框架/桁架 DOCX 导出必须携带前端同源图片，并通过媒体字节比对防止同源插图退化。
• 当前发布验证保留公开验证集 33 个算例全部通过的证据，同时保留 BM-006 的 REVIEW 治理标记，区分“自动回归通过”和“工程结论已完全背书”。

主要变化

• 新增公开验证工程入口与验证投稿闭环，覆盖公开案例浏览、投稿包生成、Issue 模板和后端投稿预审。
• 增强工作台工程图可读性，补充梁系、平面桁架、平面框架的尺寸标注、关键结果图和视觉基线。
• 统一计算书图形契约，导出报告优先使用前端同源工程图，并增加导出图形前置校验。
• 扩展公开 benchmark 数据、验证目录摘要、OpenAPI / JSON Schema 契约和 MCP 能力文档。
• 优化大模型编辑、工程树信息密度、公开案例可读性和桁架支座/杆件长度建模表达。
• 修复图表 tooltip HTML 注入风险，补充 HTML 转义、图形契约、投稿包和大模型限制相关测试。

主要变化

• 新增 /api/jobs 异步作业接口与 /api/contracts/schemas JSON Schema 契约入口。
• 新增 archsight-solver-tool CLI 通用入口，扩展 MCP 计算、敏感性分析和 benchmark 工具。
• 新增公开 benchmark catalog、runner、report，并在 CI 中生成验证报告。
• 新增 API Reference、ASMS-JSON 结构力学数据协议、AIOS 集成文档和 benchmark 验证报告。
• 引入 SciPy sparse 求解后端、跨数上限配置、输出精度控制和求解器诊断，增强大跨数与大自由度模型支撑。

主要功能

• 首个公开版本，交付梁系、平面桁架、平面框架三类线弹性静力分析工作台。
• 支持参数建模、结构计算、敏感性分析、结果图表、模板库和 Word / Excel 计算书导出。
• 提供 /api/calculate、/api/sensitivity、/api/export 等基础接口。
• 结果口径覆盖挠度、弯矩、剪力、节点位移、杆件轴力、轴应力和支座反力。