RadishFlow

RadishFlow 是一个以 Rust 为核心、以 Rust UI 为主界面、以 .NET 10 负责 CAPE-OPEN/COM 适配的稳态流程模拟软件。

项目定位

第一阶段只追求最小可运行闭环：

• Rust 实现稳态模拟核心
• Rust 实现桌面 UI
• .NET 10 暴露自有 CAPE-OPEN Unit Operation PMC
• 外部 PME 能识别并调用至少一个自有模型

当前状态

截至 2026-03-29，仓库已经完成以下初始化工作：

• Rust workspace 骨架已建立并可 cargo check
• 第一批基础 crate 已从空壳推进到可继续开发的边界结构
• rf-ui 已建立 AppState、授权态、求解态与控制面 DTO 骨架
• rf-store 已建立项目文件 / 授权缓存索引的 JSON 读写与迁移分发入口
• apps/radishflow-studio 已建立 auth cache sync 桥接、控制面 HTTP client、entitlement/lease/download/offline refresh 应用层编排，以及下载缓存落盘与回滚链路
• .NET 10 适配层目录与解决方案骨架已初始化
• MVP 边界、迁移边界和协作约定已在 docs/ 与 AGENTS.md 中冻结
• 仓库治理、拆分式 PR 检查、文本格式约束和基础协作规则已完成第一版收口
• 基于 Rust xtask 的跨平台仓库校验入口已接通，.ps1 / .sh 脚本只保留为平台包装层

当前仍未开始的内容：

• 真正的二元 TP Flash 数值实现
• 单元模块与 flowsheet 求解闭环
• Rust FFI 与 .NET 10 运行时联通
• 外部 PME 冒烟验证

当前阶段优先项

现阶段优先项暂时从“推进功能主线”切换为“先夯地基”：

• 完善仓库规范与协作约定
• 建立分支、PR 和 CI 规则
• 完善代码与文档格式约束
• 完善 App 架构规划与功能边界文档
• 建立稳定的阶段目标、进度记录和设计口径

当前分支策略

• dev 是当前常态开发分支
• master 是稳定主线，只接受 PR 合并
• 当前阶段只要求保护 master
• 管理员可通过 PR 方式绕过 master 规则，但不应直接 push 到 master

快速开始

本仓库当前以 Rust workspace 为主工作入口：

cargo check
pwsh ./scripts/check-repo.ps1

cargo check
./scripts/check-repo.sh

scripts/check-repo.ps1 与 scripts/check-repo.sh 当前复用同一套 Rust xtask 实现；前者面向本地 Windows 使用习惯，后者面向 Linux/macOS runner 与后续自动化场景。

.NET 10 适配层目前仍处于目录与职责冻结阶段，当前阶段不作为主开发入口。

仓库结构

• apps/radishflow-studio/: Rust 桌面应用
• crates/: Rust 核心、UI、求解与 FFI crates
• adapters/dotnet-capeopen/: .NET 10 CAPE-OPEN/COM 适配层
• docs/: 架构、MVP、边界、周志与迁移文档
• examples/: 示例流程与 PME 验证样例
• tests/: 数值回归与互操作测试
• assets/: 图标、主题与示例数据占位目录

文档入口

• docs/README.md: 文档总索引
• docs/architecture/overview.md: 当前仓库分层与模块边界
• docs/architecture/versioning.md: 项目版本命名、tag 与发布轨道约定
• docs/architecture/app-architecture.md: 桌面 App 架构规划
• docs/architecture/auth-entitlement-architecture.md: 桌面登录、授权与远端物性资产架构
• docs/mvp/scope.md: MVP 范围、非目标与近期开发节奏
• docs/thermo/mvp-model.md: 热力学与闪蒸的当前契约
• docs/capeopen/boundary.md: Rust 与 .NET 10 的 CAPE-OPEN 边界
• docs/adr/0001-branch-and-pr-governance.md: 分支与 PR 治理策略
• .github/rulesets/master-protection.json: master 分支保护规则模板
• docs/devlogs/README.md: 周志规范与索引

协作入口

• AGENTS.md: 仓库协作约定、阶段边界与工作流
• docs/devlogs/2026-W13.md: 当前阶段首份开发日志

版本与 Tag

RadishFlow 当前参考 Radish 的版本命名方式，采用日历版本号：

vYY.M.RELEASE

发布轨道 tag 当前继续采用：

• v*-dev
• v*-test
• v*-release

当前仓库检查工作流默认响应两类事件：

• 指向 master 的 Pull Request，由 PR Checks 执行 Repo Hygiene 与 Rust Baseline
• 规范发布 tag 的 push 与手动补跑，由 Release Checks 执行同一组检查

详细规则见 docs/architecture/versioning.md。

许可

当前仓库采用自定义的 source-available 许可。 默认允许阅读源码用于个人参考和学习，但不默认授予复制、分发、修改、衍生开发或商业使用权利。

完整条款见 LICENSE 文件。

参考仓库

• CapeOpenCore: 当前阶段用于提取 CAPE-OPEN 接口、GUID、异常语义与注册语义的参考仓库。
• D:\Code\Radish: 当前阶段用于参考 OIDC / Auth / Client Registration 能力的统一平台仓库。