高级

设置与工具

语言、主题、自动保存与日志设置

本章说明两个页面:Settings 用于控制界面行为和前端保护阈值,Logs 用于追踪计算、扫描和优化任务的执行过程。它们不改变光学模型本身,但会直接影响使用效率、可视化体验和排错速度。

Settings 页的作用

Settings 主要负责三类配置:界面偏好、模型保存行为、前端性能保护。

分组当前作用是否影响物理结果
语言切换界面文案与文档语言入口
外观切换 System / Light / Dark 主题
提示与自动保存控制 Tooltip 与本地自动保存
性能限制限制并发、扫描组合和前端承载数据量会影响是否允许执行某些大规模任务,但不改变单次物理求解公式

语言、主题与交互辅助

项目当前实现默认值使用建议
语言支持 enzh-CNen团队协作时统一语言,避免截图与路径说明不一致
主题System / Light / DarkSystem长时间看热图或深色环境可切换到 Dark
Tooltips悬停时显示字段说明开启初学阶段建议保持开启
Local Auto Save自动把当前模型写入浏览器本地存储开启(Beta)用于减少误刷新造成的配置丢失

Local Auto Save 目前带有 Beta 标识。对文档和示例案例来说,它适合做“防丢失”保护,但不应替代明确的案例导出与版本记录。

性能阈值:前端保护而不是物理参数

性能相关设置的职责,是避免前端在大 sweep 或大结果集下过载。

项目当前 UI 范围默认值直接影响
Concurrent Requests1 ~ 324Sweep / Optimizer 并发请求数
Max Sweep Combinations1000 ~ 100004000超过时会阻止过大的扫描组合
Max Calculation Data Points100,000 ~ 20,000,0002,000,000超过时会阻止前端承载过大的结果集

这三项的定位应这样理解:

  1. 它们控制的是“前端允许提交和渲染的数据规模”;
  2. 它们不会改变单次 Run 的物理公式;
  3. 若任务被阻止,优先缩小参数范围、增大波长步长或降低深度采样密度,而不是盲目把阈值拉满。

Logs 页的作用

Logs 页用于记录运行过程,而不是展示光学结果本身。它更接近一个前端任务监视器。

区域当前作用适合排查的问题
顶部工具栏切换可视化模式、滚动、导出、清空快速筛查与导出运行记录
Visualization 面板timelinematrix 方式显示最新任务并发请求是否堆积、是否有长尾请求
日志列表按条目显示任务状态、耗时、数据点数、请求数失败原因与任务规模是否异常
详情折叠区显示错误详情或附加信息直接读取失败原因

日志条目包含什么

当前日志系统会为每次计算、扫描或优化记录一条主日志,并在需要时附带请求跨度信息。

字段含义典型用途
statusrunning / success / error / terminated判断任务当前状态
message任务摘要快速识别任务类型
duration任务耗时判断是否存在明显性能瓶颈
parallelRequests并发请求数判断当前并发配置是否过激
totalRequests总请求数对照 sweep 组合数判断规模
dataPointCount前端需要承载的数据点数判断结果是否接近性能上限
details可展开的详细信息读取错误说明与附加上下文

对 sweep 和优化而言,这些字段非常重要,因为它们能直接告诉你:问题是“模型无效”,还是“任务规模过大”,或是“某批请求失败”。

日志导出与可视化模式

日志页当前支持两种可视化模式和两种导出格式。

功能当前实现适合场景
timeline时间线展示最新任务的并发跨度查看请求顺序与持续时间
matrix矩阵展示并发槽位占用查看并发资源是否被打满
导出 JSON导出完整日志结构保留完整上下文供排查
导出 CSV导出平面化日志表做时间、次数与状态统计

日志导出与结果导出不同:它导出的是“运行过程”,不是物理结果数据。

排错顺序

当计算没有得到预期结果时,先查看 Logs,再回到具体页面排查。

  1. 最近一条日志的 statusmessage,确认任务类型。
  2. dataPointCount / totalRequests / parallelRequests,判断是否属于规模问题。
  3. 若状态为 error,展开 details 读取具体失败原因。
  4. 回到 StructureOpticsSweepOptimizer 修正模型或参数。

这样可以先确认失败层级:模型有效性、任务规模或请求执行。

Copyright © 2026 Dreapex