官网 · 在线文档 · 报告问题 · 参与讨论
简体中文 · 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 | 测试、部署清单与架构门禁 |
快速开始
先按目标选择入口：
| 目标 | 路径 | 完成标志 |
|---|
| 本地启动 | 快速开始 | 迁移成功、服务健康并能登录；无需外部系统账号或设备连接 |
| 查看采集演示 | 快速开始 → 半导体采集演示 | 观察合成运行数据经过 Modbus 模拟器进入工作台；不代表真实设备互操作或现场收益 |
| 评估真实证据流程 | 当前状态 → 试点指南 | 使用经授权的真实运行与复核质量结果检查数据准入 |
| 参与贡献 | 贡献指南 | 按改动范围安装工具并验证；完整门禁见贡献指南 |
环境要求
试用完整栈需要 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 不会重置已有账户。完整步骤见快速开始。
使用
登录后先发布配方版本，明确变量和边界。已配置现场接入时，连接器自动采集并语义映射实际参数、过程轨迹和运行上下文，这是生产证据的首选路径；也可以关联人工录入或来自相邻系统的已有记录。只有可信运行事实与质量结果共同通过准入时，运行才会形成优化观察。
系统在安全边界和已观察范围内给出下一份配方，工程师采用为下一轮校正，或把显著变更做成修订草稿；后续真实运行、参数回读和检验记录用于一次性冻结结果。
工作台
AI 助手（Ingot Chat，独立调查入口）
现场运行 → 运行记录 / 生产切换 / 工装装卸 / 检验任务 / 质量偏差 / 数据质量
工艺洞察 → 工艺分析 / 工艺资料 / 机理知识
配方优化 → 配方版本 / 调整与验证
配置与接入 → 工艺与质量 / 现场接入 / 生产资源
系统管理 → 用户、状态、日志、原始事件和模型服务
这是当前工程工作台的功能导航，不是强制操作顺序。日常业务路径是现场运行 → 质量检验 → 工艺分析 → 配方优化；工艺洞察还提供工艺资料与机理知识。用户界面以工厂或独立生产现场作为数据与权限边界，系统内部使用 SiteId 标识。Ingot Chat 只在已授权范围内核对正式记录和已复核资料，并给出来源引用；它不替代工程师决定，也不会自动修改生产参数。
现场设备和企业系统连接器是可选的数据来源适配层。没有可信运行事实时，系统不生成建议。
| 相邻系统 | Ingot 的边界 |
|---|
| MES、ERP、SCADA、Historian | 可提供运行事实；不替代 MES 排程、生产执行、实时监控或实时控制 |
| LIMS、QMS、ELN | 可提供检验与研发上下文；不替代实验室、质量、样品、合规或文档管理 |
| 统计与优化方法 | 按数据条件选择；不把一种算法当作所有问题的答案 |
| Ingot Chat | 核对已授权事实与已复核工艺资料，返回来源引用；不直接生成数值设定或控制设备 |
业务记录以 Platform API 为准。Optimizer 无业务状态。Agent 只能通过授权的只读工具查询事实。生产拓扑见生产架构，第一份建议的操作顺序见配方优化试点指南。
文档
从文档首页或在线文档选择阅读路径：
仓库 Markdown 是文档源文件，文档站发布同一份内容。英文入口见 English documentation。
路线图
验收条件见发展规划。未关闭的问题见 Issues。
参与贡献
欢迎设备适配、统计方法、优化算法、测试和文档贡献。
- 先阅读贡献指南、行为准则和安全策略。
- 在 Issues 或 Discussions 中确认没有重复问题；较大变更先说明场景和验证方式。
- 提交 Pull Request。漏洞通过私密报告提交，不要开公开 Issue。
提交前运行 ./scripts/verify.sh。
许可证
本项目使用 Apache License 2.0。
联系方式
致谢
README 结构参考 Best-README-Template。
运行时依赖、许可证和引入要求见开源依赖。精确版本以 lockfile 和容器清单为准。
