# CoatStar 帮助

CoatStar 是面向光学工程的 AI 辅助镀膜设计工作空间。它帮助工程师整理规格、搜索参考设计、生成候选膜系，并对结果进行可追溯的数值验证。

用户手册：[中文](../CoatStar_v3_mac/docs/COATSTAR_USER_GUIDE_ZH.md) · [English](../CoatStar_v3_mac/docs/COATSTAR_USER_GUIDE_EN.md) · [Deutsch](../CoatStar_v3_mac/docs/COATSTAR_USER_GUIDE_DE.md)

## 可以完成什么

- 可见光和其他波段的增透、宽带增透、带通、长波通、短波通、高反和分光设计；
- 处理多入射角、S/P 偏振、非偏振、吸收材料和角度分布；
- 根据基底、材料库、波长网格、性能目标和工艺限制搜索候选结构；
- 以后台任务运行较长优化，并显示阶段、运行时间、候选数量、当前最佳已验证指标；
- 在任务完成、部分完成、失败、超时或取消后保留结构化结果和最后一个已验证候选。

## 推荐输入

请尽量提供：

- 基底材料及是否考虑背面反射；
- 波长起点、终点和采样步长；
- 入射角、偏振方式和目标指标；
- 允许的材料及材料数据来源；
- 每层最小/最大膜厚、最大层数、总厚度和工艺限制。

开始计算前，CoatStar 会先生成结构化规格供确认。规格变更后应重新确认，避免在错误假设上继续优化。

支持上传 PDF 规格文件、CSV/TSV 光谱、XLSX 表格以及受支持的文本或 JSON 数据。上传文件会经过类型、大小和安全内容检查；公共演示账户不开放文件上传。

## 一次完整任务怎么做

1. 登录后点击“新任务”。
2. 选择一种输入方式：直接输入文字，上传 PDF/PNG/JPG/JPEG 图纸或 RFQ，或者在语音功能可用时录音/选择音频。
3. 查看系统生成的结构化 Specification，补齐 `MISSING`，解决 `CONFLICT`，复核 `REVIEW_REQUIRED` 和字段证据。
4. 点击“确认规格并开始”，等待后台设计和验证任务完成。
5. 查看膜层表、R/T/A 光谱、不同角度/偏振结果、制造约束、容差/Yield 和独立验证。
6. 工程师审阅报告并审批后，生成 `CONTROLLED_TRIAL_ONLY` 受控试镀交付包。
7. 试镀后录入批次、设备、逐层膜厚/折射率、AOI 和实测光谱，查看相关性结果；异常会重新打开审批，不会自动放行。

图纸识别完成后要先检查原图、字段证据和识别草稿，再“保存修改”→“确认草稿”→“生成正式 Specification”。语音录入也必须先预览、显式提交、修订转写，再抽取和确认规格。完整中文手册位于 `CoatStar_v3_mac/docs/COATSTAR_USER_GUIDE_ZH.md`。

## 工程评审工具

在任务对话中可以直接要求 CoatStar：

- 根据当前 Specification 生成 SRF，检查材料来源、设备能力、风险和签核条件；
- 比较两个规格版本，说明会影响哪些设计、验证、报告和审批记录；
- 比较设计与实测光谱，组织厚度比例、折射率、AOI、设备漂移和测量基线等偏差假设；
- 生成 FAT/试镀等阶段门，列出进入条件、退出条件、证据、责任人和阻断项；
- 为已确认或待确认问题生成 CAPA 草稿，包含遏制、根因假设、纠正/预防措施和效果验证。

这些记录用于工程评审和追溯；`VERIFIED` 只表示独立计算和硬约束复核通过，不等于设备校准、试镀合格或量产放行。

## 结果和验证

结果页面会显示完整层表、每个角度的 R_avg、R_max、最差波长、总厚度和制造约束检查。光谱图、JSON、表格和验证报告来自同一次运行，并关联以下信息：

- run ID；
- 薄膜计算引擎版本；
- 材料数据库版本；
- 算法、随机种子和数值容差；
- 独立 verification run 及其状态。

`VERIFIED` 表示候选已通过独立复算和硬约束检查；`DRAFT` 表示仍需验证；`PARTIAL` 表示任务在超时、取消或重启后保留了当前最佳结果；`FAILED` 表示计算或验证失败。工具未收敛、超出时间预算和物理目标不可满足会分别说明，不会互相混淆。

## 长任务控制

普通设计会在有限时间预算内返回已验证结果，或转入可追踪的后台任务。刷新页面或短暂断线不会丢失任务状态。用户可以取消任务，或选择停止并返回最后一个已验证候选；取消不会覆盖较早的 global best。

## 数据与隐私

- 注册用户的数据按账户隔离，其他用户不能读取任务、材料或结果；
- 文件下载使用不透明的 artifact 标识，不显示服务器文件位置；
- 公共演示数据与注册用户数据分开存储，并受调用次数、并发、运行时间和上传限制；公共演示内容可能被其他试用者看到；
- 试用任务会按部署方设定的保留策略定期清理；注册用户可通过支持入口申请导出或删除数据；
- 是否将数据发送给第三方模型、是否用于训练以及企业私有部署方式，以当前试用协议和部署说明为准。

## 已知限制

CoatStar 的结果是工程分析和候选设计，不等同于生产放行、设备控制或最终质量判定。材料色散、膜厚误差、粗糙度、应力、工艺漂移和测量不确定度需要由工程师结合实际设备和样品复核。

如需支持，请提供任务 ID、run ID 和错误类别；请勿在消息中粘贴密码、令牌或其他凭据。