Ingot

官网 · 在线文档 · 报告问题 · 参与讨论

简体中文 · English

• 关于项目
• 快速开始
• 使用
• 文档
• 路线图
• 参与贡献
• 许可证
• 联系方式
• 致谢

关于项目

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

它服务配方成本较高、样本有限、质量目标和安全边界明确的研发工作。工程师在同一处核对实际条件、过程变化和质量结果，比较可比运行，并在约束内决定下一份配方；建议不会自动下发到设备。

核心链路是：运行证据 → 质量检验 → 工艺分析 → 下一配方建议 → 工程师决定 → 结果冻结。

仓库只声明代码、自动化测试和可复现的软件行为。适用性、安全性和收益由部署者用自己的数据评估。已实现范围见当前状态。

技术栈

部分	技术
业务服务	.NET 10
工程工作台	React 19、Vite
数据	PostgreSQL 17、TimescaleDB
数值优化	Python 3.12
部署	Docker Compose

仓库结构

路径	职责
src/platform	业务 API、正式记录、证据装配与后台任务
src/edge	现场采集、语义映射、离线缓冲与重放
src/agent	只读分析、知识检索与证据说明
src/shared	领域模型与跨模块契约
optimizer	响应面、约束判断与序贯优化
apps/platform	工程工作台
apps/website、apps/docs-site	官网与文档站
tests、deploy、scripts	测试、部署清单与架构门禁

快速开始

环境要求

试用完整栈需要 Git、Docker Engine 或 Docker Desktop，以及 Docker Compose v2。这条路径不要求本机预装 .NET、Node.js 或 Python。

参与开发另需 .NET SDK 10、Node.js 22.22+ 和 uv 0.12.5。命令与约束见贡献指南。

安装

git clone https://github.com/liuweichaox/Ingot.git
cd Ingot
cp .env.example .env

启动前替换 .env 中所有 change-this- 占位值。数据库密码使用随机值。管理员口令可设置为另一随机值，也可保持空值，由首次迁移生成。PowerShell 用户将复制命令替换为 Copy-Item .env.example .env。

docker compose -f docker-compose.app.yml config --quiet
docker compose -f docker-compose.app.yml up -d --build
docker compose -f docker-compose.app.yml ps -a

确认 platform-migrate 成功退出，数据库、API、Worker、Optimizer 和 Web 健康后，打开 http://localhost:3000。使用 .env 中的管理员账户登录；口令留空时，在 docker compose -f docker-compose.app.yml logs platform-migrate 中读取首次生成的口令。修改 .env 不会重置已有账户。完整步骤见快速开始。

使用

登录后先发布配方版本，明确变量和边界。已配置现场接入时，连接器自动采集并语义映射实际参数、过程轨迹和运行上下文，这是生产证据的首选路径；也可以关联人工录入或来自相邻系统的已有记录。只有可信运行事实与质量结果共同通过准入时，运行才会形成优化观察。

系统在安全边界和已观察范围内给出下一份配方，工程师采用为下一轮校正，或把显著变更做成修订草稿；后续真实运行、参数回读和检验记录用于一次性冻结结果。

工作台
Ingot Chat（独立调查入口）
现场运行 → 生产运行 / 生产切换 / 质量检验 / 质量偏差 / 按需工装装卸
工艺洞察 → 工艺分析 / 工艺资料 / 机理知识
配方优化 → 配方版本 / 调整与验证
配置与接入 → 工艺、质量、采集、现场节点和按需工装配置
系统管理 → 用户、状态、日志、原始事件和模型服务

这是当前工程工作台的功能导航，不是强制操作顺序。日常业务路径是现场运行 → 质量检验 → 工艺分析 → 配方优化；工艺洞察还提供工艺资料与机理知识。用户界面以工厂或独立生产现场作为数据与权限边界，系统内部使用 SiteId 标识。Ingot Chat 只在已授权范围内核对正式记录和已复核资料，并给出来源引用；它不替代工程师决定，也不会自动修改生产参数。

现场设备和企业系统连接器是可选的数据来源适配层。没有可信运行事实时，系统不生成建议。

相邻系统	Ingot 的边界
MES、ERP、SCADA、Historian	可提供运行事实；不替代 MES 排程、生产执行、实时监控或实时控制
LIMS、QMS、ELN	可提供检验与研发上下文；不替代实验室、质量、样品、合规或文档管理
统计与优化方法	按数据条件选择；不把一种算法当作所有问题的答案
Ingot Chat	核对已授权事实与已复核工艺资料，返回来源引用；不直接生成数值设定或控制设备

业务记录以 Platform API 为准。Optimizer 无业务状态。Agent 只能通过授权的只读工具查询事实。生产拓扑见生产架构，第一份建议的操作顺序见配方优化试点指南。

文档

从文档首页或在线文档选择阅读路径：

• 首次使用：快速开始 → 配方优化试点指南。
• 理解系统：系统设计、数据模型与分析与优化。
• 接入与运维：数据接入、生产架构与部署运维。
• 连接器演示：半导体晶圆刻蚀采集演示可启动独立 Modbus TCP 模拟器，验证 19 项过程数据、20 个演示参数和 300 秒运行链路。
• 判断适用范围：当前状态、场景评估边界与常见问题。
• 参与建设：贡献指南与开源依赖。

仓库 Markdown 是文档源文件，文档站发布同一份内容。英文入口见 English documentation。

路线图

• 在已发布配方版本上记录建议的采用、修改、拒绝和结果冻结
• 完整呈现运行证据：实际值、来源、缺失项和质量复核
• 说明推荐准入，并把拒绝原因追溯到运行和质量记录
• 用来源、范围和冲突检查约束后续建议
• 使备份恢复、容量和告警可以独立验收

验收条件见发展规划。未关闭的问题见 Issues。

参与贡献

欢迎设备适配、统计方法、优化算法、测试和文档贡献。

1. 先阅读贡献指南、行为准则和安全策略。
2. 在 Issues 或 Discussions 中确认没有重复问题；较大变更先说明场景和验证方式。
3. 提交 Pull Request。漏洞通过私密报告提交，不要开公开 Issue。

提交前运行 ./scripts/verify.sh。

许可证

本项目使用 Apache License 2.0。

联系方式

• 官网：https://ingotstack.com
• 文档：https://docs.ingotstack.com/zh
• 问题：https://github.com/liuweichaox/Ingot/issues
• 讨论：https://github.com/liuweichaox/Ingot/discussions
• 安全：https://github.com/liuweichaox/Ingot/security/advisories/new

致谢

README 结构参考 Best-README-Template。

运行时依赖、许可证和引入要求见开源依赖。精确版本以 lockfile 和容器清单为准。