Phase 1: data models and local storage service

- Add Models: Category, ToolItem (IsValid runtime-only, not stored), AppConfig

- Add Services: IDataService + JsonDataService (JSON load/save)

- Path validation on Load(): File.Exists check, logs warning for missing paths

- Startup: auto-calls dataService.Load() to load config
This commit is contained in:
2026-05-09 20:34:36 +08:00
parent 875e331116
commit 752f09a7e4
6 changed files with 222 additions and 0 deletions

View File

@@ -0,0 +1,27 @@
namespace PersonalToolBox.Models;
/// <summary>
/// 应用全局配置,对应 config.json 的顶层结构
/// </summary>
public class AppConfig
{
/// <summary>
/// 主题模式 (Dark / Light)
/// </summary>
public string Theme { get; set; } = "Dark";
/// <summary>
/// 是否开机自启动
/// </summary>
public bool AutoStart { get; set; } = false;
/// <summary>
/// 工具分类列表
/// </summary>
public List<Category> Categories { get; set; } = new();
/// <summary>
/// 工具项列表
/// </summary>
public List<ToolItem> Tools { get; set; } = new();
}

View File

@@ -0,0 +1,17 @@
namespace PersonalToolBox.Models;
/// <summary>
/// 工具标签页分类
/// </summary>
public class Category
{
/// <summary>
/// 分类唯一标识
/// </summary>
public string Id { get; set; } = Guid.NewGuid().ToString();
/// <summary>
/// 分类显示名称(如:开发工具、常用脚本)
/// </summary>
public string Name { get; set; } = string.Empty;
}

View File

@@ -0,0 +1,50 @@
using System.Text.Json.Serialization;
namespace PersonalToolBox.Models;
/// <summary>
/// 工具项模型,表示用户添加的一个可执行工具
/// </summary>
public class ToolItem
{
/// <summary>
/// 工具唯一标识 (UUID)
/// </summary>
public string Id { get; set; } = Guid.NewGuid().ToString();
/// <summary>
/// 工具显示名称
/// </summary>
public string Name { get; set; } = string.Empty;
/// <summary>
/// 内置图标库的字符编码
/// </summary>
public string IconCode { get; set; } = string.Empty;
/// <summary>
/// 可执行文件路径或 URL
/// </summary>
public string ExecutablePath { get; set; } = string.Empty;
/// <summary>
/// 运行参数(选填)
/// </summary>
public string Arguments { get; set; } = string.Empty;
/// <summary>
/// 所属分类 ID
/// </summary>
public string CategoryId { get; set; } = string.Empty;
/// <summary>
/// 全局快捷键(如 Ctrl+Alt+T选填
/// </summary>
public string HotKey { get; set; } = string.Empty;
/// <summary>
/// 路径是否有效(仅运行时计算,不存入 JSON
/// </summary>
[JsonIgnore]
public bool IsValid { get; set; } = true;
}