模型(回退 Flutter 内嵌 → Avalonia):
- 恢复 model/_sdk、5 个模型 src/、GC-DRAW/PlayerWindow、ModelHost/AvaloniaHost(源自 5b62897)
- FlutterShell 主线程承载 Avalonia 事件循环,根治 1.1.1 的 AppKit 崩溃
- /api/models/{id}/launch 由后端开独立 Avalonia 窗口
- 前端删除 Flutter 模型实现与 ModelViewPage 死代码(13 个文件)
积分:
- Points/ThemePaid int → decimal,精确到 0.01;pw.yaml 兼容旧整数格式
- 主题色退款保留 2 位小数;前端新增 formatPoints 显示
人品值/二选一计费(原前端本地免费随机 → 后端计费):
- 新增 POST /api/user/fortune、/api/user/pick,随机数与扣费都在服务端
- 人品值阶梯:当日免费 1 次 → 0.1×5 → 0.2×5 → 0.5×15 → 1.0 起
- 二选一:当日免费 1 次 → 0.5/次;计数按 UTC 日期持久化,跨天清零
- 前端两个功能需登录,扣费后提示本次消耗
附 RELEASE-1.1.2.md 更新日志。
78 lines
3.4 KiB
C#
78 lines
3.4 KiB
C#
using System;
|
||
using Avalonia.Controls;
|
||
|
||
namespace GC.ModelSdk;
|
||
|
||
/// <summary>
|
||
/// 模型入口契约。模型程序集里必须有一个公开、无参构造的 <see cref="IModelFactory"/> 实现,
|
||
/// 启动器按模型清单里的 <c>assembly</c> + <c>type</c> 定位并创建它。
|
||
/// </summary>
|
||
public interface IModelFactory
|
||
{
|
||
/// <summary>
|
||
/// 契约版本。启动器目前支持 <b>1</b>。
|
||
/// 协商规则:必须与启动器支持的版本**相等**,否则启动器拒绝加载并提示用户更新;
|
||
/// 模型清单里还可以写 <c>minAppVersion</c> 要求更高的启动器版本。
|
||
/// 提升版本时必须保留旧接口的适配层,避免老客户端加载新模型后崩溃。
|
||
/// </summary>
|
||
int ApiVersion { get; }
|
||
|
||
/// <summary>创建一个模型运行时实例(每个窗口一个实例)。</summary>
|
||
IModelRuntime Create();
|
||
}
|
||
|
||
/// <summary>
|
||
/// 模型运行时:负责把模型自己的界面交给启动器。
|
||
/// 启动器只负责开窗口,**不参与任何渲染**。
|
||
///
|
||
/// 生命周期:<c>Create()</c> → <c>Prepare()</c>(后台线程,一次)→ <c>CreateView()</c>(UI 线程,一次)
|
||
/// → 用户关窗 → <c>Dispose()</c>(UI 线程)。<c>Dispose</c> 之后不要再调用任何
|
||
/// <see cref="IModelContext"/> 成员。
|
||
/// </summary>
|
||
public interface IModelRuntime : IDisposable
|
||
{
|
||
/// <summary>
|
||
/// 在**后台线程**准备数据(读文件、算纹理等),期间禁止创建或操作任何 UI 控件。
|
||
/// 启动器的进度窗会显示 <see cref="IModelContext.ReportProgress"/> 汇报的进度。
|
||
/// 默认空实现:模型也可以把准备工作留到 CreateView 里(那样会占用 UI 线程)。
|
||
/// </summary>
|
||
void Prepare(IModelContext context) { }
|
||
|
||
/// <summary>
|
||
/// 在 UI 线程创建模型窗口的内容。模型可以自由组合控件、自己画图、自己管动画。
|
||
/// 返回的控件会被直接放进窗口,铺满客户区。
|
||
/// </summary>
|
||
Control CreateView(IModelContext context);
|
||
}
|
||
|
||
/// <summary>启动器提供给模型的环境信息与能力。</summary>
|
||
public interface IModelContext
|
||
{
|
||
/// <summary>模型 id(即模型目录名)。</summary>
|
||
string ModelId { get; }
|
||
|
||
/// <summary>模型目录:<c>model/<id></c>。</summary>
|
||
string ModelDirectory { get; }
|
||
|
||
/// <summary>模型数据目录:<c>model/<id>/<id>.model</c>,模型自己的场景数据、贴图、语言包都放这里。</summary>
|
||
string DataDirectory { get; }
|
||
|
||
/// <summary>界面语言(zh-CN / en)。模型应按它选择自己的文案。</summary>
|
||
string Language { get; }
|
||
|
||
/// <summary>用户在设置里分配的运行内存预算(MB),模型可据此控制缓存规模。</summary>
|
||
int MemoryBudgetMb { get; }
|
||
|
||
/// <summary>请求关闭承载此模型的窗口。**线程安全**,任意线程可调用。</summary>
|
||
void RequestClose();
|
||
|
||
/// <summary>
|
||
/// 汇报加载进度(0–1)与当前阶段文案。启动器的加载进度条会实时显示,
|
||
/// 也可以在任何时候调用(例如切换数据集时)。**线程安全**,任意线程可调用。
|
||
/// </summary>
|
||
void ReportProgress(double value, string? message = null);
|
||
|
||
/// <summary>输出日志(启动器会写到控制台)。**线程安全**,任意线程可调用。</summary>
|
||
void Log(string message);
|
||
}
|