Ingot
目录

项目入门

Ingot 文档快速开始当前状态

集成与运维

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

系统与算法

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

验证与生产

场景验证生产架构

项目治理

发展规划品牌规范开源依赖

品牌规范

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

核心价值

把每次真实配方运行变成优化证据,在安全边界和历史覆盖范围内持续推荐下一份配方。

“减少无效实验”是产品要交付的结果,不是某一种算法的同义词。数据采集、工艺追因、实验设计、线性或二次响应面、贝叶斯优化、机理融合和模型交互都是服务于这个结果的手段。

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

从运行证据,到下一份配方。

这句话对应完整产品闭环:真实配方运行自动形成优化观察,系统在目标、安全边界和已观察覆盖范围内推荐下一份配方,工程师在既有生产流程中确认,后续运行继续回流。受控验证只在需要因果确认、外推或工艺操作域验证时使用。

产品定位

  • 产品类别:开源工艺追因与优化系统 / Open-source Process Diagnosis & Optimization
  • 主要用户:负责新产品、新材料和新工艺开发的工艺、质量、设备和研发工程师
  • 工作对象:真实配方运行的实际参数、过程轨迹、质量结果、工程判断和下一份配方
  • 产品职责:整理可信事实、自动形成优化观察、在约束内推荐下一份配方,并保留证据与适用边界
  • 工程师职责:确定目标、审核数据与约束、确认建议是否进入正常生产,并解释现场条件
  • 系统边界:Ingot 不代替工程师,不绕过安全约束、审批职责或设备控制系统

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

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

公开承诺

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

  • 关联实际生产条件、过程轨迹和检验结果;
  • 显示数据缺失、来源、版本和不确定性;
  • 帮助工程师比较运行、缩小候选原因范围;
  • 自动把符合准入要求的真实配方运行转成优化观察;
  • 在声明的变量、安全边界和历史覆盖内推荐下一份配方;
  • 在需要因果确认或外推时把候选原因转成可证伪的受控验证;
  • 将经过验证的结论保存为有适用范围的工艺知识。

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

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

观察数据只能形成候选原因、稳定关联或证据不足的判断。因果结论必须经过工程判断和适当的对照、重复、区组或干预实验。

规范用语

用途 中文 English
产品类别 开源工艺追因与优化系统 Open-source Process Diagnosis & Optimization
核心价值 少做无效实验,更快找到达标工艺 Avoid unproductive experiments and reach target process conditions faster
简短标语 从运行证据,到下一份配方。 From run evidence to the next recipe.
业务入口 工艺追因、配方优化 Process Diagnosis, Recipe Optimization
能力描述 运行比较、工艺追因、配方建议、受约束优化、受控验证 run comparison, process diagnosis, recipe recommendation, constrained optimization, controlled validation
数据单位 运行 / 过程执行 run / process execution
观察结论 候选原因、稳定关联、混杂关联、证据不足 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)”;仅开发者需要的字段名放在技术章节。
  • 算法、架构、验证协议和开发文档保留专业术语、公式条件和统计门槛;术语首次出现时补一句白话解释,不用模糊口号替代技术精度。
  • 同一事实允许分层表达:用户文档解释业务含义,技术文档给出模型名称和判定规则;两层的结论强度必须一致。
  • 先说明对象、能力和结果,再说明实现方法;不使用人格化的“思考”“理解”“大脑”代替具体计算或工作流。
  • 产品定义直接说明用户、工作对象、能力和输出;不使用泛指代词承接定义,也不向读者解释内部营销取舍。
  • 明确区分已实现能力、测试结果、开发期证据、外部验证和路线图,不把计划写成现状。
  • AILLM、高斯过程和贝叶斯优化只在说明具体技术职责时出现,不作为效果形容词。
  • 定量结果同时给出数据范围、比较基线、指标、置信区间和适用边界;没有这些要素时不写成收益结论。
  • 操作说明使用明确命令和预期结果;产品说明避免口号堆叠、反问、自我评价和对读者的推销式称呼。
  • 中英文文档保持相同的信息层级和结论强度。翻译可以调整句式,但不得增加能力、收益或保证。

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

标识释义

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 和产品介绍必须与本文件的核心价值、类别和承诺边界一致。

相关文档