中文 | English
本文说明 ArchSight Solver 公开核心的功能范围、适用人群和非目标。工程安全结论、规范设计和施工签审仍需具备资质的专业人员复核。
- 结构工程师：快速复核常见梁系、二维桁架和二维框架工况。
- 高校教师与学生：用于结构力学教学、作业验证和算例演示。
- 开发者：基于 REST API、CLI、MCP 和 ASMS-JSON 集成确定性求解能力。
- 开源贡献者：补充 benchmark、改善前端交互、增强导出和测试。
- 连续梁、简支梁、悬臂梁。
- 均布荷载、集中荷载、线性分布荷载和叠加荷载。
- 支座反力、剪力、弯矩、挠度和控制位置。
- 典型屋架、桥式桁架、悬挑桁架和教学算例。
- 节点荷载、杆件自重等效节点荷载和杆件均匀温度荷载；温度作用限定为线弹性静力下的均匀温差。
- 节点位移、支座反力、杆件轴力和杆件轴应力。
- 门式刚架、显式二维框架和框架梁退化验证。
- 节点荷载、构件分布荷载、构件集中荷载、构件均匀温度荷载和基础荷载组合；温度荷载当前限定为二维框架静力线弹性均匀温差，不覆盖温度梯度或瞬态热传导。
- 节点位移、支座反力、杆端轴力/剪力/弯矩和构件控制值。
- 可选的二维弹性几何非线性与整体线性特征屈曲分析：
corotational_newton_v1按工况/组合独立执行共回转全 Newton 荷载路径，记录多重收敛判据、线搜索、cutback、平衡/稳定分离、最后收敛点和失败证据；显式或屈曲模态初始缺陷进入模型几何后形成 GNIA。initial_stress_v1只作为 v1.8.0 复算兼容算法。构件 Euler K=1 结果仅用于定位复核对象，不等于整体屈曲结论或规范稳定设计。
- 模板库、基准模板和项目快照。
- 右侧参数面板统一使用“模板 / 基本 / 对象 / 文本 / 表格”五类入口；对象页承载节点、跨段/杆件/构件、支座、荷载和当前对象属性。
- 材料编号用于保留工程语义和导出摘要；线弹性求解仍以各跨段/构件/杆件的 E、A、I 等刚度输入为准。
- 支座编辑按结构体系区分自由度：梁系为 v / θz，平面桁架仅为 ux / uy 平动自由度，平面框架为 ux / uy / rz。
- 结构图、荷载图、内力图、挠度曲线和结果摘要。
- 单因素参数敏感性分析，用于趋势解释和方案比选。
- WORD / XLSX 计算书导出。
- 可信计算包导出；保存当前求解输入、完整记录结果、结果来源、provenance、诊断、版本、SHA-256 完整性摘要和固定复算规则。
- 公开验证工程入口，可直接打开 benchmark 生成的验证模型。
- DOCX / XLSX 记录材料适用范围、支座体系说明、单位换算、计算方法、平衡校核、公开验证集覆盖和适用边界。
[email protected]可在 Web、REST、CLI 与 MCP 间携带，并区分同版本通过、跨版本人工审阅和格式/完整性/复算失败。- SHA-256 只用于发现包内内容变化，不是数字签名、身份认证、第三方认证或工程签审。
- 平面桁架和平面框架 DOCX 仅使用前端同源受力变形图和模型叠加工程图；缺失时跳过对应插图并写入说明，不插入后端简化兜底图。
- DOCX 图形导出链路提供 Chromium / Firefox / WebKit 三浏览器矩阵入口：
npm --prefix frontend run test:visual:export-docx。
- REST API：同步求解、异步作业、预览、敏感性分析、导出、可信计算包和公开案例。
- ASMS-JSON：梁系、二维平面桁架和二维平面框架的统一结构模型协议。
- CLI：本地自动化、批处理、计算包生成/复算和 CI 复核。
- MCP：Agent Host 发现工具、读取 schema、执行公开验证集算例和计算包生成/复算。
- Benchmark：公开验证集、误差阈值和回归报告。
/api/jobs是本地轻量异步求解入口，用于本机批量计算、Agent 自动调用和避免同步请求阻塞。- 状态与结果默认写入本地 SQLite，可通过
ARCHSIGHT_SOLVER_JOB_DB_PATH覆盖；每个服务 worker 在首次收到请求时启动自己的ThreadPoolExecutor和心跳线程，进程退出时关闭，并记录执行进程 ID。 - 同一容器内多个 Gunicorn worker 共享 SQLite 中的状态与结果，但不共享内存 future 或执行器；轮询可由任一 worker 响应，取消和调度不具备跨进程队列语义。
- 进程重启或线程句柄丢失后，旧的
queued/running记录会在查询时标记为COMMON_ASYNC_JOB_ORPHANED失败，避免永久挂起；调用方应重新提交作业。 - 该入口不承诺生产级多实例队列、幂等重试、跨主机调度或高吞吐任务编排；生产化部署应接入共享数据库、Redis 或专用任务队列。
当前开源核心默认直接进入本地工作台，不内置登录、组织、权限或会话管理。
如果后续需要统一身份或多用户能力，应由外部网关、宿主平台或独立集成服务提供身份、权限和审计上下文；Solver 本身只消费这些结果，不在本仓库内实现认证平台。
- 三维杆系、Frame3D 或空间结构求解。
- 动力分析、材料非线性、接触、规范稳定设计或弧长/位移控制的屈曲后路径；二维框架 GNA/GNIA 限于二维 Euler-Bernoulli 梁柱、材料线弹性、保守静力荷载与荷载控制。它支持显式和线性屈曲模态初始缺陷，但不覆盖塑性、局部/侧扭屈曲、GMNIA 或极限点后的完整平衡支路。
- 规范设计、施工安全专项业务和工程签审。
- OpenSeesPy 或其他外部求解器作为运行时内核。
- 云协作、多用户平台、组织权限系统和插件化生态。
- 数字签名、证书颁发、发布者身份认证或替代注册工程师责任。
这些方向不进入当前开源核心。新增能力应优先服务梁系、二维平面桁架和二维平面框架的可信计算、结果表达、导出质量和 benchmark 覆盖。可信计算包的公开契约和处置方式见可信计算包 1.0，三类角色验收路径见三条黄金流程。