Ingot
目录

项目入门

Ingot 文档快速开始当前状态

集成与运维

配方优化试点指南数据接入部署运维常见问题

系统与算法

系统设计分析与优化机理知识设计

验证与生产

场景评估边界生产架构

项目治理

发展规划品牌规范开源依赖术语表

品牌规范

文档状态:v1 规范基线。本文件是产品定位、核心价值和公开措辞的唯一事实源。除非产品方向真实改变,否则不重新定义核心价值。

核心价值

组织配方版本、实验记录与运行证据,支持质量分析、工艺追因和配方优化。

Ingot 面向工艺、质量、设备与研发工程师,贯穿配方版本、实验记录、运行证据、质量分析、工艺追因和配方优化。

面向产品传播时,优先使用更具体的行动主句:

从工艺数据,到有依据的研发决策。

系统概括应覆盖研发管理、数据与证据、分析和优化。具体流程以数据准入条件为前提,已实现能力与路线图以当前状态和发展规划为准。

产品定位

  • 产品类别:开源工艺研发与优化系统 / Open-source Process R&D and Optimization System
  • 主要用户:负责新产品、新材料和新工艺开发的工艺、质量、设备和研发工程师
  • 工作对象:工艺实验定义、实际参数、过程轨迹、结果、工程判断和后续实验
  • 产品职责:组织配方版本、记录和证据,支持质量分析与工艺追因,并在满足数据准入条件时提供受约束的下一配方建议
  • 工程师职责:确定目标、审核数据与约束、确认建议是否进入正常生产,并解释现场条件
  • 系统边界:工程师审核结论与配方建议;系统遵守安全约束、审批职责和设备控制边界

Ingot 的工作对象不是孤立点位或单一算法,而是可复核的工艺运行证据。系统根据具体问题选择稳健统计、对照比较、候选覆盖设计、因果验证、机器学习、贝叶斯优化、机理模型或语言模型。

“配方优化”是系统的业务能力,覆盖真实运行观察、下一配方建议、工程师决定和工艺知识;“优化”表示系统围绕明确目标、允许变量、安全边界和历史覆盖持续选择下一份候选工艺设置。它不是自动控制的同义词,也不表示系统已经证明真实工厂收益或可以绕过工程师确认。

公开承诺

公开内容可以承诺系统提供以下能力:

  • 通过工艺配置管理配方版本参数,以运行记录及质量结果组织实验事实,并按站点和配方生成、审核下一配方建议;
  • 关联实际生产条件、过程轨迹和检验结果;
  • 显示数据缺失、来源、版本和不确定性;
  • 帮助工程师比较运行、缩小候选原因范围;
  • 自动把符合准入要求的真实配方运行转成优化观察;
  • 在声明的变量、安全边界和历史覆盖内推荐下一份配方;
  • 将经过验证的结论保存为有适用范围的工艺知识。

每次运行就是一次实验,运行与质量记录承载实验事实;下一配方建议使用通过准入的运行证据。当前 Web 与 API 支持建议和工程师决定:采用校正后沿用当前已发布配方版本,显著变更才创建修订草稿。具体能力、数据条件与部署边界见当前状态。

公开内容不得在没有真实项目证据时声称:

  • 系统已经自动发现确定根因;
  • 系统已经减少某个百分比的试错成本或研发时间;
  • 模型推荐等同于现场保证;
  • 一个成功参数点已经证明完整工艺操作域;
  • 一个场景的结果可以无条件迁移到其他场景。

观察数据只能形成候选原因、稳定关联或证据不足的判断。系统不会把这些判断自动升级为根因或设备控制命令。

规范用语

用途 中文 English
产品类别 开源工艺研发与优化系统 Open-source Process R&D and Optimization System
核心价值 组织配方版本、实验记录与运行证据,支持质量分析、工艺追因和配方优化 Organize recipe versions, experiment records, and run evidence to support quality analysis, process diagnosis, and recipe optimization
简短标语 从工艺数据,到有依据的研发决策。 From process data to evidence-based R&D decisions.
业务能力 工艺追因、配方优化 Process Diagnosis, Recipe Optimization
能力描述 运行比较、工艺追因、配方建议、工程师决定、受约束优化 run comparison, process diagnosis, recipe recommendation, engineer decision, constrained optimization
数据单位 实验记录;工艺运行证据 experiment record; process-run evidence
观察结论 候选原因、稳定关联、混杂关联、证据不足 candidate cause, stable association, confounded association, insufficient evidence
证据结论 支持、否决、不确定、已验证原因 supported, rejected, inconclusive, validated cause
证据等级 证据不足、探索性证据、证据稳定、证据充分 insufficient, exploratory, stable, sufficient
优化结果 下一配方建议、候选工艺设置、已验证工艺操作域 next-recipe recommendation, candidate process setting, validated operating region

产品文案按对象选择术语:

  • 介绍整套产品时写“开源工艺研发与优化系统”,界面短名写“工艺研发与优化”;
  • 表示工程师查看真实运行、下一份配方和工程师决定的工作区时写“配方优化”;
  • 表示数值能力时写“受约束优化”或“序贯优化”,并同时说明目标、安全边界和方法准入;
  • 表示系统输出时写“下一配方建议”或“候选工艺设置”,不写“最优工艺”或“自动下发参数”;
  • 表示验证完成的成果时写“已验证工艺操作域”,不把单个成功设置升级成工艺窗口。

“智能工艺”含义不完整,容易被理解为工艺本身已经自治,不作为产品类别、菜单或能力名称。正式产品描述优先使用“配方优化”“下一配方建议”“工程师决定”和“受约束优化”。当前配方运行及其质量结果通过准入后可形成优化观察。系统不会把生产运行重新包装成另一类业务记录,也不会自动下发配方。

“过程执行”是平台中的标准业务对象;面向工程师的简短文案可使用“运行”,但代码、接口和跨场景文档不使用特定设备的周期名称代替它。

证据等级回答“当前支撑有多强”,观察结论回答“观察到了什么关系”,证据结论回答“干预是否支持假设”,三者不得互换。“仅稳健筛选”(screening)和“证据有限”(limited)是第一、第二级的降级说明,不新增结论类别。

“根因”只在已经说明验证证据时使用。“AI 配方优化”可以描述交互方式,但不能替代产品类别。具体算法名只出现在技术说明中,不作为产品价值本身。

不得把长期自动化愿景、尚未形成外部采用的规范候选或未来受控行动能力表述为当前产品类别、行业标准或已实现收益。

简短标语是核心价值的传播缩写,不是另一套产品定义。

文档语体

公开文档采用正式、直接、可核验的工程语体:

  • 面向工程师的首页、入门、FAQ 和界面先说“系统建议做什么、为什么、风险是什么”,不要求用户理解模型名称;例如写“沿当前稳定趋势继续试”,不先写“使用线性响应面”。
  • 对外入口先回答“这是什么、解决什么问题、现在能做什么”,再出现架构名、接口字段和统计术语;不得用一串缩写代替产品说明。
  • 缩写第一次出现时先写中文含义,例如“传统候选覆盖设计(DOE)”“语言模型(LLM)”“模型上下文协议(MCP)”;仅开发者需要的字段名放在技术章节。
  • 算法、架构、验证协议和开发文档保留专业术语、公式条件和统计门槛;术语首次出现时补一句白话解释,不用模糊口号替代技术精度。
  • 同一事实允许分层表达:用户文档解释业务含义,技术文档给出模型名称和判定规则;两层的结论强度必须一致。
  • 先说明对象、能力和结果,再说明实现方法;不使用人格化的“思考”“理解”“大脑”代替具体计算或工作流。
  • 产品定义直接说明用户、工作对象、能力和输出;不使用泛指代词承接定义,也不向读者解释内部营销取舍。
  • 明确区分已实现能力、测试结果、开发期证据、外部验证和路线图,不把计划写成现状。
  • AI、LLM、高斯过程和贝叶斯优化只在说明具体技术职责时出现,不作为效果形容词。
  • 定量结果同时给出数据范围、比较基线、指标、置信区间和适用边界;没有这些要素时不写成收益结论。
  • 操作说明使用明确命令和预期结果;产品说明避免口号堆叠、反问、自我评价和对读者的推销式称呼。
  • 中英文文档保持相同的信息层级和结论强度。翻译可以调整句式,但不得增加能力、收益或保证。

允许使用“帮助”“建议”和“候选”,前提是同时明确工程师审核、安全边界和证据等级。界面名称、接口字段和命令保持原样,不为追求文风而改写技术标识。

标识释义

Ingot 的标识由三块锭的截面堆叠而成:

  • 两块钢色底锭代表持续积累的运行数据、运行记录和工程知识;
  • 顶部金锭代表从证据中形成、仍可追溯和复核的当前判断;
  • 三块锭之间的等距缝隙表示事实、分析和结论保留独立来源。

命名资产

资产 值
产品名 Ingot
官方域名 ingotstack.com
仓库 github.com/liuweichaox/Ingot
.NET 命名空间 Ingot.*

域名不改变品牌称谓,不使用“IngotStack”作为产品名。

资产与色板

apps/website/public/brand/ 是品牌源文件的规范位置:

文件 用途
ingot-lockup.svg 浅色背景横排标识
ingot-lockup-dark.svg 深色背景横排标识
ingot-mark-dark.svg 深色背景图标源文件
色名 值 用途
Evidence Gold #E8AD56 建议、行动和主要强调
Trajectory Cyan #5FD4C8 过程、连接与可信状态
Deep Coal #07100E 主背景
Process Panel #0E1D19 卡片与数据面板
Fog #EEF5F1 深色背景文字

使用规则

  • 最小展示尺寸为 16px,四周留白不小于单块锭高度的一半。
  • 不改变三块锭的比例、位置关系与配色,不额外添加描边、阴影或倾斜。
  • 字标使用 Inter / Segoe UI Bold 回退族。
  • 公开视觉以设备信号、阶段轨迹、检验记录和工程决策为主体,不使用火焰、熔融材料、加热容器或神秘主义意象。
  • 产品效果必须区分示意数据、自动化测试和部署者基于自身生产数据的效果评估。
  • README、文档站、官网 metadata 和产品介绍必须与本文件的核心价值、类别和承诺边界一致。

相关文档