DSPEasy Framework

Dyson Sphere Program（戴森球计划）DSPEasy 系列模组共用的框架库。

这个包本身不提供任何玩法功能。 只有当你安装的其它模组（例如 DSPEasy Buildings、DSPEasy Exchange）依赖它时，或者你要基于它做开发时，才需要安装。

汇报问题(Bug/Issue)：github

包含什么

模块	能力
`DSPEasy.Framework.Save`	命名空间旁车存档：在存档旁边写一个 `.mod.dat`，数据块按 `命名空间/块ID` 分区，一个模组的数据不会踩到另一个模组；原子写入（先写 `.tmp` 再替换），文件格式 2，可读旧格式 1 并自动升级。
`DSPEasy.Framework.UI`	面板基座：`UiFactory` 提供文本 / 按钮 / 滑条的工厂方法与配色；`UiDrag` 处理窗口拖动（轮询式，口径同原版 `UIWindowDrag`）；`UiFocus` 处理层级——只在打开时提层一次，不会像每帧抢置顶那样把游戏的物品提示条压掉。
`DSPEasy.Framework.Recipes`	`RecipeSolver`：配方树递归展开，带环检测与深度上限，用于「需要哪些材料」这类计算。
`DSPEasy.Framework.Items`	物品栈辅助。
`DSPEasy.Framework.Blueprint`	模组之间的蓝图数据通道。
`DSPEasy.Framework.Abnormal`	异常状态守卫：动工厂之前先确认游戏状态正常。
`DSPEasy.Framework.Diagnostics`	性能面板统计：在原版「分析面板 → 性能测试 → CPU」列表里给依赖本框架的模组追加三级耗时行（模组 → 建筑/功能 → 主要逻辑），面板关闭或不勾「实时检测」时不采样。

安装

先装 BepInEx 5.4.17（x64，Mono）（已写在依赖里，模组管理器会自动处理）。
把 DSPEasy.Framework.dll 放进 BepInEx/plugins/（Thunderstore Mod Manager / r2modman 会自动放好）。
启动一次游戏，日志里能看到依赖它的模组正常加载。

⚠️ BepInEx/plugins/ 下只能有一份 DSPEasy.Framework.dll。 BepInEx 会递归加载 plugins/ 下所有 DLL，每一份都会建立自己的静态注册表——有了两份，一份写进去的数据另一份看不到，表现就是「设置存了，重进游戏却全没了」。升级时请把旧副本删干净。

兼容性

游戏：戴森球计划 0.10.35.29151（Unity 2022.3.62f3c1，64 位）。
BepInEx：5.4.17.0（Mono）。
旁车存档格式：2（能读格式 1，旧档会自动升级，不需要手动迁移）。

开发者参考

// 注册一个带命名空间的存档块（块 ID 必须是 4 个可打印 ASCII 字符）
ModSave.Register("MyMod", new MyStateChunk(MyState.Table));

// 显式指定命名空间读写（不传参数则读写「本程序集注册的全部块」）
ModSave.WriteForSaveName(saveName, "MyMod");

// 面板：自己拼控件 + 处理层级
var root = UiFactory.NewRect(transform, "MyPanel");
UiFactory.Place(root, ...).Pos(...);
UiFocus.BringToFront(root);   // 打开时提层一次即可，不要每帧抢置顶

// 性能面板：注册模块与子步骤，Measure() 之外的时间不计入
var module = ModProfiler.RegisterModule("模组 MyMod");
var step = module.GetOrAddChild("我的步骤");
using (step.Measure()) { /* 可能耗时的工作 */ }
ModProfiler.Install(LogInfo, LogWarn);   // 安装面板补丁；多次调用只装一次

命名空间：DSPEasy.Framework.Save / .UI / .Recipes / .Items / .Blueprint / .Abnormal / .Diagnostics。
依赖方向是单向的：框架只引用游戏的 Assembly-CSharp 与 BepInEx / 0Harmony，不引用任何使用它的模组。

DSPEasy Framework

Details

Categories

DSPEasy Framework

包含什么

安装

兼容性

开发者参考