高级
设置与工具
语言、主题、自动保存与日志设置
本章说明两个页面:Settings 用于控制界面行为和前端保护阈值,Logs 用于追踪计算、扫描和优化任务的执行过程。它们不改变光学模型本身,但会直接影响使用效率、可视化体验和排错速度。
Settings 页的作用
Settings 主要负责三类配置:界面偏好、模型保存行为、前端性能保护。

| 分组 | 当前作用 | 是否影响物理结果 |
|---|---|---|
| 语言 | 切换界面文案与文档语言入口 | 否 |
| 外观 | 切换 System / Light / Dark 主题 | 否 |
| 提示与自动保存 | 控制 Tooltip 与本地自动保存 | 否 |
| 性能限制 | 限制并发、扫描组合和前端承载数据量 | 会影响是否允许执行某些大规模任务,但不改变单次物理求解公式 |
语言、主题与交互辅助
| 项目 | 当前实现 | 默认值 | 使用建议 |
|---|---|---|---|
| 语言 | 支持 en 与 zh-CN | en | 团队协作时统一语言,避免截图与路径说明不一致 |
| 主题 | System / Light / Dark | System | 长时间看热图或深色环境可切换到 Dark |
| Tooltips | 悬停时显示字段说明 | 开启 | 初学阶段建议保持开启 |
| Local Auto Save | 自动把当前模型写入浏览器本地存储 | 开启(Beta) | 用于减少误刷新造成的配置丢失 |
Local Auto Save 目前带有 Beta 标识。对文档和示例案例来说,它适合做“防丢失”保护,但不应替代明确的案例导出与版本记录。
性能阈值:前端保护而不是物理参数
性能相关设置的职责,是避免前端在大 sweep 或大结果集下过载。
| 项目 | 当前 UI 范围 | 默认值 | 直接影响 |
|---|---|---|---|
Concurrent Requests | 1 ~ 32 | 4 | Sweep / Optimizer 并发请求数 |
Max Sweep Combinations | 1000 ~ 10000 | 4000 | 超过时会阻止过大的扫描组合 |
Max Calculation Data Points | 100,000 ~ 20,000,000 | 2,000,000 | 超过时会阻止前端承载过大的结果集 |
这三项的定位应这样理解:
- 它们控制的是“前端允许提交和渲染的数据规模”;
- 它们不会改变单次
Run的物理公式; - 若任务被阻止,优先缩小参数范围、增大波长步长或降低深度采样密度,而不是盲目把阈值拉满。
Logs 页的作用
Logs 页用于记录运行过程,而不是展示光学结果本身。它更接近一个前端任务监视器。

| 区域 | 当前作用 | 适合排查的问题 |
|---|---|---|
| 顶部工具栏 | 切换可视化模式、滚动、导出、清空 | 快速筛查与导出运行记录 |
| Visualization 面板 | timeline 或 matrix 方式显示最新任务 | 并发请求是否堆积、是否有长尾请求 |
| 日志列表 | 按条目显示任务状态、耗时、数据点数、请求数 | 失败原因与任务规模是否异常 |
| 详情折叠区 | 显示错误详情或附加信息 | 直接读取失败原因 |
日志条目包含什么
当前日志系统会为每次计算、扫描或优化记录一条主日志,并在需要时附带请求跨度信息。
| 字段 | 含义 | 典型用途 |
|---|---|---|
status | running / success / error / terminated | 判断任务当前状态 |
message | 任务摘要 | 快速识别任务类型 |
duration | 任务耗时 | 判断是否存在明显性能瓶颈 |
parallelRequests | 并发请求数 | 判断当前并发配置是否过激 |
totalRequests | 总请求数 | 对照 sweep 组合数判断规模 |
dataPointCount | 前端需要承载的数据点数 | 判断结果是否接近性能上限 |
details | 可展开的详细信息 | 读取错误说明与附加上下文 |
对 sweep 和优化而言,这些字段非常重要,因为它们能直接告诉你:问题是“模型无效”,还是“任务规模过大”,或是“某批请求失败”。
日志导出与可视化模式
日志页当前支持两种可视化模式和两种导出格式。
| 功能 | 当前实现 | 适合场景 |
|---|---|---|
timeline | 时间线展示最新任务的并发跨度 | 查看请求顺序与持续时间 |
matrix | 矩阵展示并发槽位占用 | 查看并发资源是否被打满 |
| 导出 JSON | 导出完整日志结构 | 保留完整上下文供排查 |
| 导出 CSV | 导出平面化日志表 | 做时间、次数与状态统计 |
日志导出与结果导出不同:它导出的是“运行过程”,不是物理结果数据。
排错顺序
当计算没有得到预期结果时,先查看 Logs,再回到具体页面排查。
- 最近一条日志的
status与message,确认任务类型。 dataPointCount / totalRequests / parallelRequests,判断是否属于规模问题。- 若状态为
error,展开details读取具体失败原因。 - 回到
Structure、Optics、Sweep或Optimizer修正模型或参数。
这样可以先确认失败层级:模型有效性、任务规模或请求执行。