|
|
@@ -0,0 +1,2112 @@
|
|
|
+# 桌面宠物实现计划
|
|
|
+
|
|
|
+> **面向 AI 代理的工作者：** 必需子技能：使用 superpowers:subagent-driven-development（推荐）或 superpowers:executing-plans 逐任务实现此计划。步骤使用复选框（`- [ ]`）语法来跟踪进度。
|
|
|
+
|
|
|
+**目标：** 构建一款 Windows 桌面宠物应用，展现用户 CFC 系统的五维能量状态、任务完成情况，并支持与用户互动完成打卡任务（如喝水提醒、任务完成确认）。应用使用 WPF + WebView2 架构，支持用户自定义形象和自定义状态。
|
|
|
+
|
|
|
+**架构：** WPF (.NET 6) 主进程 + WebView2 渲染层。主进程负责 API 调用（CFC 后端 localhost:9082）、状态管理、托盘图标与 JWT 缓存；WebView2 负责精灵渲染、CSS 动画、用户交互。通过 `window.cfcPetAPI` Bridge 实现 C# ↔ JavaScript 双向通信。
|
|
|
+
|
|
|
+**技术栈：**
|
|
|
+- UI 框架：WPF (.NET 6, Windows 专用)
|
|
|
+- 渲染引擎：WebView2（Edge 内核，Win10+ 预装）
|
|
|
+- API 调用：HttpClient + HttpClientFactory，JWT 缓存
|
|
|
+- 动画：CSS Animation + JavaScript
|
|
|
+- 配置存储：JSON 文件 + 用户配置目录
|
|
|
+- 打包：MSIX / ClickOnce
|
|
|
+
|
|
|
+**构建环境：** WPF 仅支持 Windows，需在 Windows 机器（.NET 6 SDK）上 `dotnet build` / `dotnet test`。本仓库其余部分为 Java/前端，桌面宠物是独立新目录 `cfc-desktop-pet/`，不影响现有模块。
|
|
|
+
|
|
|
+**规格文档：** `docs/superpowers/specs/2026-10-10-desktop-pet-design.md`
|
|
|
+
|
|
|
+---
|
|
|
+## 任务 1：解决方案骨架 + WPF 主项目
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/XafPet.Desktop.sln`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/XafPet.Desktop.csproj`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/App.xaml` / `App.xaml.cs`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml` / `MainWindow.xaml.cs`
|
|
|
+- 创建：`cfc-desktop-pet/tests/XafPet.Desktop.Tests/XafPet.Desktop.Tests.csproj`
|
|
|
+
|
|
|
+- [ ] **步骤 1：创建目录结构**
|
|
|
+
|
|
|
+```bash
|
|
|
+mkdir -p cfc-desktop-pet/src/XafPet.Desktop/PetEngine \
|
|
|
+ cfc-desktop-pet/src/XafPet.Desktop/Assets \
|
|
|
+ cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/xibao \
|
|
|
+ cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/fubao \
|
|
|
+ cfc-desktop-pet/tests/XafPet.Desktop.Tests
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：创建 WPF 项目文件**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/XafPet.Desktop.csproj`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<Project Sdk="Microsoft.NET.Sdk">
|
|
|
+ <PropertyGroup>
|
|
|
+ <OutputType>WinExe</OutputType>
|
|
|
+ <TargetFramework>net6.0-windows</TargetFramework>
|
|
|
+ <Nullable>enable</Nullable>
|
|
|
+ <UseWPF>true</UseWPF>
|
|
|
+ <ImplicitUsings>enable</ImplicitUsings>
|
|
|
+ <AssemblyName>XafPet.Desktop</AssemblyName>
|
|
|
+ <RootNamespace>XafPet.Desktop</RootNamespace>
|
|
|
+ </PropertyGroup>
|
|
|
+ <ItemGroup>
|
|
|
+ <PackageReference Include="Microsoft.Web.WebView2" Version="1.0.2210.55" />
|
|
|
+ </ItemGroup>
|
|
|
+ <ItemGroup>
|
|
|
+ <None Include="Assets\**" CopyToOutputDirectory="PreserveNewest" />
|
|
|
+ <None Include="DefaultPets\**" CopyToOutputDirectory="PreserveNewest" />
|
|
|
+ </ItemGroup>
|
|
|
+</Project>
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 3：创建 App 入口**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/App.xaml`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<Application x:Class="XafPet.Desktop.App"
|
|
|
+ xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
|
|
+ xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
|
|
+ StartupUri="MainWindow.xaml">
|
|
|
+ <Application.Resources></Application.Resources>
|
|
|
+</Application>
|
|
|
+```
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/App.xaml.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Windows;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public partial class App : Application
|
|
|
+{
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：创建主窗口（透明置顶，占位内容）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<Window x:Class="XafPet.Desktop.MainWindow"
|
|
|
+ xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
|
|
+ xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
|
|
+ Title="浠艾福桌面宠物"
|
|
|
+ Width="200" Height="200"
|
|
|
+ WindowStyle="None"
|
|
|
+ AllowsTransparency="True"
|
|
|
+ Background="Transparent"
|
|
|
+ Topmost="True"
|
|
|
+ ShowInTaskbar="False"
|
|
|
+ ResizeMode="NoResize">
|
|
|
+ <Grid x:Name="RootGrid">
|
|
|
+ <TextBlock Text="浠艾福桌面宠物"
|
|
|
+ HorizontalAlignment="Center" VerticalAlignment="Center"
|
|
|
+ Foreground="#4A9BD7" FontSize="14"/>
|
|
|
+ </Grid>
|
|
|
+</Window>
|
|
|
+```
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Windows;
|
|
|
+using System.Input.Mouse;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public partial class MainWindow : Window
|
|
|
+{
|
|
|
+ public MainWindow()
|
|
|
+ {
|
|
|
+ InitializeComponent();
|
|
|
+ RootGrid.MouseLeftButtonDown += (s, e) =>
|
|
|
+ {
|
|
|
+ if (e.ButtonState == MouseButtonState.Pressed) DragMove();
|
|
|
+ };
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：创建测试项目**
|
|
|
+
|
|
|
+`cfc-desktop-pet/tests/XafPet.Desktop.Tests/XafPet.Desktop.Tests.csproj`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<Project Sdk="Microsoft.NET.Sdk">
|
|
|
+ <PropertyGroup>
|
|
|
+ <TargetFramework>net6.0-windows</TargetFramework>
|
|
|
+ <Nullable>enable</Nullable>
|
|
|
+ <ImplicitUsings>enable</ImplicitUsings>
|
|
|
+ <IsPackable>false</IsPackable>
|
|
|
+ </PropertyGroup>
|
|
|
+ <ItemGroup>
|
|
|
+ <PackageReference Include="Microsoft.NET.Test.Sdk" Version="17.7.2" />
|
|
|
+ <PackageReference Include="xunit" Version="2.5.3" />
|
|
|
+ <PackageReference Include="xunit.runner.visualstudio" Version="2.5.3" />
|
|
|
+ <PackageReference Include="Moq" Version="4.20.69" />
|
|
|
+ </ItemGroup>
|
|
|
+ <ItemGroup>
|
|
|
+ <ProjectReference Include="..\..\src\XafPet.Desktop\XafPet.Desktop.csproj" />
|
|
|
+ </ItemGroup>
|
|
|
+</Project>
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 6：创建解决方案文件并添加项目**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet new sln -n XafPet.Desktop
|
|
|
+dotnet sln add src/XafPet.Desktop/XafPet.Desktop.csproj
|
|
|
+dotnet sln add tests/XafPet.Desktop.Tests/XafPet.Desktop.Tests.csproj
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 7：编译验证**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet build XafPet.Desktop.sln
|
|
|
+```
|
|
|
+
|
|
|
+预期：`Build succeeded`，0 错误。
|
|
|
+
|
|
|
+- [ ] **步骤 8：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 桌面宠物解决方案骨架 (WPF + WebView2 + xUnit)"
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 任务 2：宠物状态枚举 + 形象配置模型
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/PetState.cs`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/PetConfig.cs`
|
|
|
+- 测试：`cfc-desktop-pet/tests/XafPet.Desktop.Tests/PetConfigTests.cs`
|
|
|
+
|
|
|
+- [ ] **步骤 1：编写失败的测试**
|
|
|
+
|
|
|
+`cfc-desktop-pet/tests/XafPet.Desktop.Tests/PetConfigTests.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Text.Json;
|
|
|
+using XafPet.Desktop.PetEngine;
|
|
|
+using Xunit;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.Tests;
|
|
|
+
|
|
|
+public class PetConfigTests
|
|
|
+{
|
|
|
+ private const string ValidJson = """
|
|
|
+ {
|
|
|
+ "version": "1.0",
|
|
|
+ "type": "animal",
|
|
|
+ "species": "cockatiel",
|
|
|
+ "gender": "female",
|
|
|
+ "image_base_url": "./DefaultPets/xibao/",
|
|
|
+ "default_image": "standing.png",
|
|
|
+ "actions": {
|
|
|
+ "idle": "wings_idle",
|
|
|
+ "happy": "wings_spread",
|
|
|
+ "custom_state_1": "user_animation_1"
|
|
|
+ },
|
|
|
+ "parameters": {
|
|
|
+ "move_distance": 15,
|
|
|
+ "animation_speed": 1.0,
|
|
|
+ "interaction_timeout": 300
|
|
|
+ }
|
|
|
+ }
|
|
|
+ """;
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void Parse_ValidJson_LoadsAllFields()
|
|
|
+ {
|
|
|
+ var config = PetConfig.Parse(ValidJson);
|
|
|
+
|
|
|
+ Assert.Equal("1.0", config.Version);
|
|
|
+ Assert.Equal(PetType.Animal, config.Type);
|
|
|
+ Assert.Equal("cockatiel", config.Species);
|
|
|
+ Assert.Equal("female", config.Gender);
|
|
|
+ Assert.Equal("./DefaultPets/xibao/", config.ImageBaseUrl);
|
|
|
+ Assert.Equal("standing.png", config.DefaultImage);
|
|
|
+ Assert.Equal("wings_idle", config.Actions["idle"]);
|
|
|
+ Assert.Equal(15, config.Parameters.MoveDistance);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void Parse_MissingActionsKey_UsesDefaults()
|
|
|
+ {
|
|
|
+ var json = """{ "version": "1.0", "type": "human", "image_base_url": "./pets/", "default_image": "a.png" }""";
|
|
|
+ var config = PetConfig.Parse(json);
|
|
|
+
|
|
|
+ Assert.Equal("idle", config.Actions["idle"]);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void Parse_InvalidJson_ThrowsJsonException()
|
|
|
+ {
|
|
|
+ Assert.Throws<JsonException>(() => PetConfig.Parse("{ not valid json"));
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void Parse_CustomStates_CountedCorrectly()
|
|
|
+ {
|
|
|
+ var config = PetConfig.Parse(ValidJson);
|
|
|
+
|
|
|
+ Assert.Equal(1, config.CustomStateCount);
|
|
|
+ Assert.Equal("user_animation_1", config.GetActionForState("custom_state_1"));
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：运行测试确认失败**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~PetConfigTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：FAIL — `PetConfig` 类型不存在。
|
|
|
+
|
|
|
+- [ ] **步骤 3：实现 PetState.cs**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/PetState.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+namespace XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+/// <summary>宠物核心状态枚举（C# 侧定义，JS 侧同名接收）</summary>
|
|
|
+public enum PetState
|
|
|
+{
|
|
|
+ Idle, // 默认
|
|
|
+ Happy, // 任务全完成
|
|
|
+ Busy, // 有任务进行中
|
|
|
+ Worried, // 任务超期未完成
|
|
|
+ Excited, // 健康打卡完成
|
|
|
+ Remind, // 提醒用户（喝水/任务）
|
|
|
+ Energetic, // 身维度能量高
|
|
|
+ Tired, // 身维度能量低
|
|
|
+ Curious, // 智维度能量高
|
|
|
+ Sad, // 全维度低
|
|
|
+ Sleeping, // 用户无操作 >15min
|
|
|
+ Watching, // 用户活跃，注视光标
|
|
|
+ WaitingForInteraction, // 等待用户互动（打卡确认）
|
|
|
+ MiniGame // 小游戏模式
|
|
|
+}
|
|
|
+
|
|
|
+/// <summary>推送 WebView 的状态负载</summary>
|
|
|
+public sealed record PetStatePayload(
|
|
|
+ string State, // 枚举名 camelCase：如 "waitingForInteraction"
|
|
|
+ string? Reason, // 可选：如 "drink_water"、"task_complete"
|
|
|
+ object? Data // 可选：任务列表/能量值等
|
|
|
+);
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：实现 PetConfig.cs**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/PetConfig.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Text.Json;
|
|
|
+using System.Text.Json.Serialization;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+public enum PetType { Animal, Human, Custom }
|
|
|
+
|
|
|
+/// <summary>宠物形象配置（pet-config.json）</summary>
|
|
|
+public sealed class PetConfig
|
|
|
+{
|
|
|
+ [JsonPropertyName("version")]
|
|
|
+ public string Version { get; set; } = "1.0";
|
|
|
+
|
|
|
+ [JsonPropertyName("type")]
|
|
|
+ public PetType Type { get; set; } = PetType.Custom;
|
|
|
+
|
|
|
+ [JsonPropertyName("species")]
|
|
|
+ public string Species { get; set; } = "other";
|
|
|
+
|
|
|
+ [JsonPropertyName("gender")]
|
|
|
+ public string Gender { get; set; } = "neutral";
|
|
|
+
|
|
|
+ [JsonPropertyName("image_base_url")]
|
|
|
+ public string ImageBaseUrl { get; set; } = "";
|
|
|
+
|
|
|
+ [JsonPropertyName("default_image")]
|
|
|
+ public string DefaultImage { get; set; } = "standing.png";
|
|
|
+
|
|
|
+ [JsonPropertyName("actions")]
|
|
|
+ public Dictionary<string, string> Actions { get; set; } = new();
|
|
|
+
|
|
|
+ [JsonPropertyName("sounds")]
|
|
|
+ public Dictionary<string, string> Sounds { get; set; } = new();
|
|
|
+
|
|
|
+ [JsonPropertyName("parameters")]
|
|
|
+ public PetParameters Parameters { get; set; } = new();
|
|
|
+
|
|
|
+ [JsonIgnore]
|
|
|
+ public int CustomStateCount => Actions.Keys.Count(k => k.StartsWith("custom_state_"));
|
|
|
+
|
|
|
+ /// <summary>解析 JSON 字符串；缺省 actions 时补默认映射（key=value）</summary>
|
|
|
+ public static PetConfig Parse(string json)
|
|
|
+ {
|
|
|
+ var config = JsonSerializer.Deserialize<PetConfig>(json)
|
|
|
+ ?? throw new JsonException("pet-config.json 反序列化结果为 null");
|
|
|
+ if (config.Actions.Count == 0)
|
|
|
+ {
|
|
|
+ config.Actions = new Dictionary<string, string>
|
|
|
+ {
|
|
|
+ ["idle"] = "idle",
|
|
|
+ ["happy"] = "happy",
|
|
|
+ ["busy"] = "busy",
|
|
|
+ ["sleeping"] = "sleeping"
|
|
|
+ };
|
|
|
+ }
|
|
|
+ return config;
|
|
|
+ }
|
|
|
+
|
|
|
+ public string GetActionForState(string stateName)
|
|
|
+ => Actions.TryGetValue(stateName, out var v) ? v : stateName;
|
|
|
+}
|
|
|
+
|
|
|
+public sealed class PetParameters
|
|
|
+{
|
|
|
+ [JsonPropertyName("move_distance")]
|
|
|
+ public int MoveDistance { get; set; } = 15;
|
|
|
+
|
|
|
+ [JsonPropertyName("animation_speed")]
|
|
|
+ public double AnimationSpeed { get; set; } = 1.0;
|
|
|
+
|
|
|
+ [JsonPropertyName("interaction_timeout")]
|
|
|
+ public int InteractionTimeout { get; set; } = 300; // 秒
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：运行测试验证通过**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~PetConfigTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：PASS — 4/4 通过。
|
|
|
+
|
|
|
+- [ ] **步骤 6：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 宠物状态枚举 + 形象配置模型 (PetState/PetConfig)"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 3：CFC API 客户端
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/CfcApiModels.cs`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/ApiClient.cs`
|
|
|
+- 测试：`cfc-desktop-pet/tests/XafPet.Desktop.Tests/ApiClientTests.cs`
|
|
|
+
|
|
|
+- [ ] **步骤 1：编写失败的测试**
|
|
|
+
|
|
|
+`cfc-desktop-pet/tests/XafPet.Desktop.Tests/ApiClientTests.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Net;
|
|
|
+using System.Text.Json;
|
|
|
+using Moq;
|
|
|
+using Moq.Protected;
|
|
|
+using XafPet.Desktop.PetEngine;
|
|
|
+using Xunit;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.Tests;
|
|
|
+
|
|
|
+public class ApiClientTests
|
|
|
+{
|
|
|
+ private static ApiClient CreateClientWithResponse(HttpStatusCode code, string json, string authToken = "test-token")
|
|
|
+ {
|
|
|
+ var handler = new Mock<HttpMessageHandler>();
|
|
|
+ handler.Protected()
|
|
|
+ .Setup<Task<HttpResponseMessage>>("SendAsync",
|
|
|
+ ItExpr.IsAny<HttpRequestMessage>(),
|
|
|
+ ItExpr.IsAny<CancellationToken>())
|
|
|
+ .ReturnsAsync(new HttpResponseMessage(code)
|
|
|
+ {
|
|
|
+ Content = new StringContent(json, System.Text.Encoding.UTF8, "application/json")
|
|
|
+ });
|
|
|
+ var http = new HttpClient(handler.Object);
|
|
|
+ return new ApiClient(http, "http://localhost:9082", authToken);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public async Task GetTodayTasks_ReturnsTaskList()
|
|
|
+ {
|
|
|
+ var json = """
|
|
|
+ { "code": 200, "message": "ok", "data": [
|
|
|
+ { "id": 1, "title": "喝水", "status": "PENDING", "dueDate": "2026-10-10" }
|
|
|
+ ] }
|
|
|
+ """;
|
|
|
+ var client = CreateClientWithResponse(HttpStatusCode.OK, json);
|
|
|
+
|
|
|
+ var tasks = await client.GetTodayTasksAsync();
|
|
|
+
|
|
|
+ Assert.Single(tasks);
|
|
|
+ Assert.Equal("喝水", tasks[0].Title);
|
|
|
+ Assert.Equal("PENDING", tasks[0].Status);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public async Task GetEnergyOverview_ReturnsDimensions()
|
|
|
+ {
|
|
|
+ var json = """
|
|
|
+ { "code": 200, "message": "ok", "data": {
|
|
|
+ "dimensions": [
|
|
|
+ { "dimension": "身", "value": 80, "color": "#FF8C42" },
|
|
|
+ { "dimension": "智", "value": 45, "color": "#6366F1" }
|
|
|
+ ]
|
|
|
+ } }
|
|
|
+ """;
|
|
|
+ var client = CreateClientWithResponse(HttpStatusCode.OK, json);
|
|
|
+
|
|
|
+ var overview = await client.GetEnergyOverviewAsync();
|
|
|
+
|
|
|
+ Assert.Equal(2, overview.Dimensions.Count);
|
|
|
+ Assert.Equal(80, overview.Dimensions[0].Value);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public async Task GetDailyCheckin_ReturnsStatus()
|
|
|
+ {
|
|
|
+ var json = """
|
|
|
+ { "code": 200, "message": "ok", "data": { "checked": true, "items": ["water", "exercise"] } }
|
|
|
+ """;
|
|
|
+ var client = CreateClientWithResponse(HttpStatusCode.OK, json);
|
|
|
+
|
|
|
+ var status = await client.GetDailyCheckinAsync();
|
|
|
+
|
|
|
+ Assert.True(status.Checked);
|
|
|
+ Assert.Contains("water", status.Items);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public async Task CompleteDrinkWater_PostsCorrectEndpoint()
|
|
|
+ {
|
|
|
+ var json = """{ "code": 200, "message": "打卡成功", "data": null }""";
|
|
|
+ var client = CreateClientWithResponse(HttpStatusCode.OK, json);
|
|
|
+
|
|
|
+ var result = await client.CompleteDrinkWaterAsync();
|
|
|
+
|
|
|
+ Assert.Equal("打卡成功", result.Message);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public async Task NonSuccessCode_ThrowsApiException()
|
|
|
+ {
|
|
|
+ var json = """{ "code": 500, "message": "服务器错误", "data": null }""";
|
|
|
+ var client = CreateClientWithResponse(HttpStatusCode.OK, json);
|
|
|
+
|
|
|
+ await Assert.ThrowsAsync<ApiException>(() => client.GetTodayTasksAsync());
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：运行测试确认失败**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~ApiClientTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：FAIL — `ApiClient`/`ApiException` 不存在。
|
|
|
+
|
|
|
+- [ ] **步骤 3：实现 CfcApiModels.cs（API 响应 DTO）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/CfcApiModels.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Text.Json.Serialization;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+/// <summary>CFC 统一响应包装 Result<T></summary>
|
|
|
+public sealed class ApiResult<T>
|
|
|
+{
|
|
|
+ [JsonPropertyName("code")]
|
|
|
+ public int Code { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("message")]
|
|
|
+ public string? Message { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("data")]
|
|
|
+ public T? Data { get; set; }
|
|
|
+
|
|
|
+ public bool IsSuccess => Code == 200;
|
|
|
+}
|
|
|
+
|
|
|
+public sealed class CfcTask
|
|
|
+{
|
|
|
+ [JsonPropertyName("id")]
|
|
|
+ public long Id { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("title")]
|
|
|
+ public string? Title { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("status")]
|
|
|
+ public string? Status { get; set; } // PENDING / IN_PROGRESS / COMPLETED / REJECTED
|
|
|
+
|
|
|
+ [JsonPropertyName("dueDate")]
|
|
|
+ public string? DueDate { get; set; }
|
|
|
+}
|
|
|
+
|
|
|
+public sealed class DimensionValue
|
|
|
+{
|
|
|
+ [JsonPropertyName("dimension")]
|
|
|
+ public string? Dimension { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("value")]
|
|
|
+ public int Value { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("color")]
|
|
|
+ public string? Color { get; set; }
|
|
|
+}
|
|
|
+
|
|
|
+public sealed class EnergyOverview
|
|
|
+{
|
|
|
+ [JsonPropertyName("dimensions")]
|
|
|
+ public List<DimensionValue> Dimensions { get; set; } = new();
|
|
|
+}
|
|
|
+
|
|
|
+public sealed class DailyCheckin
|
|
|
+{
|
|
|
+ [JsonPropertyName("checked")]
|
|
|
+ public bool Checked { get; set; }
|
|
|
+
|
|
|
+ [JsonPropertyName("items")]
|
|
|
+ public List<string> Items { get; set; } = new();
|
|
|
+}
|
|
|
+
|
|
|
+/// <summary>API 返回非 200 code 时抛出</summary>
|
|
|
+public sealed class ApiException : Exception
|
|
|
+{
|
|
|
+ public int ApiCode { get; }
|
|
|
+
|
|
|
+ public ApiException(int apiCode, string message) : base(message)
|
|
|
+ {
|
|
|
+ ApiCode = apiCode;
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：实现 ApiClient.cs**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/ApiClient.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Net.Http;
|
|
|
+using System.Text;
|
|
|
+using System.Text.Json;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+/// <summary>CFC 后端 API 客户端。所有接口统一 POST + JWT Bearer。</summary>
|
|
|
+public sealed class ApiClient
|
|
|
+{
|
|
|
+ private readonly HttpClient _http;
|
|
|
+ private readonly string _baseUrl;
|
|
|
+ private string _token;
|
|
|
+
|
|
|
+ private static readonly JsonSerializerOptions JsonOpts = new(JsonSerializerDefaults.Web);
|
|
|
+
|
|
|
+ public ApiClient(HttpClient http, string baseUrl, string token)
|
|
|
+ {
|
|
|
+ _http = http;
|
|
|
+ _baseUrl = baseUrl.TrimEnd('/');
|
|
|
+ _token = token;
|
|
|
+ }
|
|
|
+
|
|
|
+ public void UpdateToken(string token) => _token = token;
|
|
|
+
|
|
|
+ private async Task<T?> PostAsync<T>(string path, object? body = null)
|
|
|
+ {
|
|
|
+ using var req = new HttpRequestMessage(HttpMethod.Post, $"{_baseUrl}{path}");
|
|
|
+ req.Headers.Authorization = new AuthenticationHeaderValue("Bearer", _token);
|
|
|
+ if (body != null)
|
|
|
+ {
|
|
|
+ req.Content = new StringContent(JsonSerializer.Serialize(body, JsonOpts),
|
|
|
+ Encoding.UTF8, "application/json");
|
|
|
+ }
|
|
|
+ var resp = await _http.SendAsync(req);
|
|
|
+ var json = await resp.Content.ReadAsStringAsync();
|
|
|
+ var result = JsonSerializer.Deserialize<ApiResult<T>>(json, JsonOpts)
|
|
|
+ ?? throw new ApiException(-1, "响应解析失败");
|
|
|
+ if (!result.IsSuccess)
|
|
|
+ throw new ApiException(result.Code, result.Message ?? "未知错误");
|
|
|
+ return result.Data;
|
|
|
+ }
|
|
|
+
|
|
|
+ /// <summary>POST /api/tasks/today — 今日任务</summary>
|
|
|
+ public Task<List<CfcTask>?> GetTodayTasksAsync()
|
|
|
+ => PostAsync<List<CfcTask>>("/api/tasks/today", new Dictionary<string, object>());
|
|
|
+
|
|
|
+ /// <summary>POST /api/energy/overview — 五维能量概览</summary>
|
|
|
+ public Task<EnergyOverview?> GetEnergyOverviewAsync()
|
|
|
+ => PostAsync<EnergyOverview>("/api/energy/overview");
|
|
|
+
|
|
|
+ /// <summary>POST /api/daily/checkin — 今日打卡状态</summary>
|
|
|
+ public Task<DailyCheckin?> GetDailyCheckinAsync()
|
|
|
+ => PostAsync<DailyCheckin>("/api/daily/checkin");
|
|
|
+
|
|
|
+ /// <summary>POST /api/daily/checkin — 完成喝水打卡（body: {"type":"water"}）</summary>
|
|
|
+ public async Task<ApiResult<object>?> CompleteDrinkWaterAsync()
|
|
|
+ {
|
|
|
+ using var req = new HttpRequestMessage(HttpMethod.Post, $"{_baseUrl}/api/daily/checkin");
|
|
|
+ req.Headers.Authorization = new AuthenticationHeaderValue("Bearer", _token);
|
|
|
+ req.Content = new StringContent("""{"type":"water"}""", Encoding.UTF8, "application/json");
|
|
|
+ var resp = await _http.SendAsync(req);
|
|
|
+ var json = await resp.Content.ReadAsStringAsync();
|
|
|
+ var result = JsonSerializer.Deserialize<ApiResult<object>>(json, JsonOpts)
|
|
|
+ ?? throw new ApiException(-1, "响应解析失败");
|
|
|
+ if (!result.IsSuccess)
|
|
|
+ throw new ApiException(result.Code, result.Message ?? "未知错误");
|
|
|
+ return result;
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：运行测试验证通过**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~ApiClientTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：PASS — 5/5 通过。
|
|
|
+
|
|
|
+- [ ] **步骤 6：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: CFC API 客户端 (今日任务/能量概览/健康打卡)"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 4：状态管理器（API 数据 → 宠物状态）
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/StateManager.cs`
|
|
|
+- 测试：`cfc-desktop-pet/tests/XafPet.Desktop.Tests/StateManagerTests.cs`
|
|
|
+
|
|
|
+- [ ] **步骤 1：编写失败的测试**
|
|
|
+
|
|
|
+`cfc-desktop-pet/tests/XafPet.Desktop.Tests/StateManagerTests.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using XafPet.Desktop.PetEngine;
|
|
|
+using Xunit;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.Tests;
|
|
|
+
|
|
|
+public class StateManagerTests
|
|
|
+{
|
|
|
+ [Fact]
|
|
|
+ public void AllTasksCompleted_ReturnsHappy()
|
|
|
+ {
|
|
|
+ var tasks = new List<CfcTask>
|
|
|
+ {
|
|
|
+ new() { Id = 1, Title = "喝水", Status = "COMPLETED" },
|
|
|
+ new() { Id = 2, Title = "运动", Status = "COMPLETED" }
|
|
|
+ };
|
|
|
+ var state = StateManager.MapState(tasks, null, null, false);
|
|
|
+ Assert.Equal(PetState.Happy, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void SomeTasksPending_ReturnsBusy()
|
|
|
+ {
|
|
|
+ var tasks = new List<CfcTask>
|
|
|
+ {
|
|
|
+ new() { Id = 1, Title = "喝水", Status = "COMPLETED" },
|
|
|
+ new() { Id = 2, Title = "运动", Status = "PENDING" }
|
|
|
+ };
|
|
|
+ var state = StateManager.MapState(tasks, null, null, false);
|
|
|
+ Assert.Equal(PetState.Busy, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void NoTasks_ReturnsIdle()
|
|
|
+ {
|
|
|
+ var state = StateManager.MapState(new List<CfcTask>(), null, null, false);
|
|
|
+ Assert.Equal(PetState.Idle, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void CheckinDone_OverridesToExcited()
|
|
|
+ {
|
|
|
+ var state = StateManager.MapState(new List<CfcTask>(), null,
|
|
|
+ new DailyCheckin { Checked = true, Items = new List<string> { "water" } }, false);
|
|
|
+ Assert.Equal(PetState.Excited, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void LowBodyEnergy_ReturnsTired()
|
|
|
+ {
|
|
|
+ var energy = new EnergyOverview
|
|
|
+ {
|
|
|
+ Dimensions = new List<DimensionValue>
|
|
|
+ {
|
|
|
+ new() { Dimension = "身", Value = 20, Color = "#FF8C42" },
|
|
|
+ new() { Dimension = "智", Value = 80, Color = "#6366F1" }
|
|
|
+ }
|
|
|
+ };
|
|
|
+ var state = StateManager.MapState(new List<CfcTask>(), energy, null, false);
|
|
|
+ Assert.Equal(PetState.Tired, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void AllDimensionsLow_ReturnsSad()
|
|
|
+ {
|
|
|
+ var energy = new EnergyOverview
|
|
|
+ {
|
|
|
+ Dimensions = new List<DimensionValue>
|
|
|
+ {
|
|
|
+ new() { Dimension = "身", Value = 15, Color = "#FF8C42" },
|
|
|
+ new() { Dimension = "智", Value = 20, Color = "#6366F1" },
|
|
|
+ new() { Dimension = "富", Value = 25, Color = "#F59E0B" }
|
|
|
+ }
|
|
|
+ };
|
|
|
+ var state = StateManager.MapState(new List<CfcTask>(), energy, null, false);
|
|
|
+ Assert.Equal(PetState.Sad, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void HighBodyEnergy_ReturnsEnergetic()
|
|
|
+ {
|
|
|
+ var energy = new EnergyOverview
|
|
|
+ {
|
|
|
+ Dimensions = new List<DimensionValue>
|
|
|
+ {
|
|
|
+ new() { Dimension = "身", Value = 90, Color = "#FF8C42" }
|
|
|
+ }
|
|
|
+ };
|
|
|
+ var state = StateManager.MapState(new List<CfcTask>(), energy, null, false);
|
|
|
+ Assert.Equal(PetState.Energetic, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void UserInactive_ReturnsSleeping()
|
|
|
+ {
|
|
|
+ var state = StateManager.MapState(new List<CfcTask>(), null, null, true);
|
|
|
+ Assert.Equal(PetState.Sleeping, state);
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void StateToCamelCase_ConvertsEnumName()
|
|
|
+ {
|
|
|
+ Assert.Equal("waitingForInteraction",
|
|
|
+ StateManager.StateToCamelCase(PetState.WaitingForInteraction));
|
|
|
+ Assert.Equal("miniGame", StateManager.StateToCamelCase(PetState.MiniGame));
|
|
|
+ Assert.Equal("idle", StateManager.StateToCamelCase(PetState.Idle));
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：运行测试确认失败**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~StateManagerTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：FAIL — `StateManager` 不存在。
|
|
|
+
|
|
|
+- [ ] **步骤 3：实现 StateManager.cs**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/StateManager.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Text.RegularExpressions;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+/// <summary>把 CFC API 数据转换为宠物状态（纯逻辑，无 UI 依赖）</summary>
|
|
|
+public static class StateManager
|
|
|
+{
|
|
|
+ /// <summary>核心状态映射。优先级：Sleeping > Excited > Happy > Worried > Busy > Sad > Tired/Energetic/Curious > Idle</summary>
|
|
|
+ public static PetState MapState(
|
|
|
+ List<CfcTask>? tasks,
|
|
|
+ EnergyOverview? energy,
|
|
|
+ DailyCheckin? checkin,
|
|
|
+ bool userInactive)
|
|
|
+ {
|
|
|
+ // 1. 用户无操作 → 睡眠（最高优先级，除非有未完成任务需要提醒）
|
|
|
+ var hasPendingTasks = tasks?.Any(t => t.Status is "PENDING" or "IN_PROGRESS") ?? false;
|
|
|
+ if (userInactive && !hasPendingTasks) return PetState.Sleeping;
|
|
|
+
|
|
|
+ // 2. 健康打卡完成 → 兴奋（次高）
|
|
|
+ if (checkin is { Checked: true }) return PetState.Excited;
|
|
|
+
|
|
|
+ // 3. 任务状态
|
|
|
+ if (tasks is { Count: > 0 })
|
|
|
+ {
|
|
|
+ var allDone = tasks.All(t => t.Status == "COMPLETED");
|
|
|
+ if (allDone) return PetState.Happy;
|
|
|
+
|
|
|
+ // 超期未完成（dueDate 早于今天且非完成态）→ 担忧
|
|
|
+ var today = DateOnly.FromDateTime(DateTime.Today);
|
|
|
+ var overdue = tasks.Any(t =>
|
|
|
+ t.Status is "PENDING" or "IN_PROGRESS" &&
|
|
|
+ DateOnly.TryParse(t.DueDate, out var due) && due < today);
|
|
|
+ if (overdue) return PetState.Worried;
|
|
|
+
|
|
|
+ return PetState.Busy;
|
|
|
+ }
|
|
|
+
|
|
|
+ // 4. 五维能量
|
|
|
+ if (energy is { Dimensions.Count: > 0 })
|
|
|
+ {
|
|
|
+ var dims = energy.Dimensions;
|
|
|
+ var allLow = dims.All(d => d.Value < 30);
|
|
|
+ if (allLow) return PetState.Sad;
|
|
|
+
|
|
|
+ var body = dims.FirstOrDefault(d => d.Dimension == "身");
|
|
|
+ if (body != null && body.Value < 30) return PetState.Tired;
|
|
|
+ if (body != null && body.Value >= 85) return PetState.Energetic;
|
|
|
+
|
|
|
+ var mind = dims.FirstOrDefault(d => d.Dimension == "智");
|
|
|
+ if (mind != null && mind.Value >= 85) return PetState.Curious;
|
|
|
+ }
|
|
|
+
|
|
|
+ return PetState.Idle;
|
|
|
+ }
|
|
|
+
|
|
|
+ /// <summary>枚举 → camelCase（JS 侧状态名）。WaitingForInteraction → waitingForInteraction</summary>
|
|
|
+ public static string StateToCamelCase(PetState state)
|
|
|
+ {
|
|
|
+ var name = state.ToString();
|
|
|
+ return Regex.Replace(name, "(^[A-Z])", m => m.Value.ToLowerInvariant());
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：运行测试验证通过**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~StateManagerTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：PASS — 9/9 通过。
|
|
|
+
|
|
|
+- [ ] **步骤 5：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 状态管理器 (API数据→宠物状态映射)"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 5：默认宠物资产（浠宝/福宝占位 PNG + 配置）
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/xibao/pet-config.json`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/fubao/pet-config.json`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/xibao/standing.png`（1x1 透明占位）
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/fubao/standing.png`（1x1 透明占位）
|
|
|
+
|
|
|
+- [ ] **步骤 1：编写浠宝配置**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/xibao/pet-config.json`：
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "version": "1.0",
|
|
|
+ "type": "animal",
|
|
|
+ "species": "cockatiel",
|
|
|
+ "gender": "female",
|
|
|
+ "image_base_url": "./DefaultPets/xibao/",
|
|
|
+ "default_image": "standing.png",
|
|
|
+ "actions": {
|
|
|
+ "idle": "wings_idle",
|
|
|
+ "happy": "wings_spread",
|
|
|
+ "busy": "head_tilt",
|
|
|
+ "waitingForInteraction": "hand_gesture",
|
|
|
+ "sleeping": "breath_loop",
|
|
|
+ "celebrate": "celebrate",
|
|
|
+ "sad": "sad_animation"
|
|
|
+ },
|
|
|
+ "sounds": {
|
|
|
+ "click": "pip.mp3",
|
|
|
+ "complete": "cheer.mp3",
|
|
|
+ "remind": "water_please.mp3"
|
|
|
+ },
|
|
|
+ "parameters": {
|
|
|
+ "move_distance": 15,
|
|
|
+ "animation_speed": 1.0,
|
|
|
+ "interaction_timeout": 300
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：编写福宝配置**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/fubao/pet-config.json`：
|
|
|
+
|
|
|
+```json
|
|
|
+{
|
|
|
+ "version": "1.0",
|
|
|
+ "type": "animal",
|
|
|
+ "species": "british_shorthair",
|
|
|
+ "gender": "male",
|
|
|
+ "image_base_url": "./DefaultPets/fubao/",
|
|
|
+ "default_image": "standing.png",
|
|
|
+ "actions": {
|
|
|
+ "idle": "tail_wrap",
|
|
|
+ "happy": "belly_show",
|
|
|
+ "busy": "paw_press",
|
|
|
+ "waitingForInteraction": "tail_flick",
|
|
|
+ "sleeping": "breath_loop",
|
|
|
+ "celebrate": "celebrate",
|
|
|
+ "sad": "sad_animation"
|
|
|
+ },
|
|
|
+ "sounds": {
|
|
|
+ "click": "tap.mp3",
|
|
|
+ "complete": "bell.mp3",
|
|
|
+ "remind": "water_please.mp3"
|
|
|
+ },
|
|
|
+ "parameters": {
|
|
|
+ "move_distance": 12,
|
|
|
+ "animation_speed": 1.0,
|
|
|
+ "interaction_timeout": 300
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 3：生成占位 PNG（1x1 透明）**
|
|
|
+
|
|
|
+```bash
|
|
|
+python3 -c "
|
|
|
+import struct, zlib
|
|
|
+def png_chunk(tag, data):
|
|
|
+ c = struct.pack('>I', len(data)) + tag + data
|
|
|
+ return c + struct.pack('>I', zlib.crc32(tag + data) & 0xffffffff)
|
|
|
+ihdr = struct.pack('>IIBBBBB', 1, 1, 8, 6, 0, 0, 0)
|
|
|
+raw = b'\x00' + b'\x00\x00\x00\x00'
|
|
|
+png = b'\x89PNG\r\n\x1a\n'
|
|
|
+png += png_chunk(b'IHDR', ihdr)
|
|
|
+png += png_chunk(b'IDAT', zlib.compress(raw))
|
|
|
+png += png_chunk(b'IEND', b'')
|
|
|
+for d in ['cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/xibao',
|
|
|
+ 'cfc-desktop-pet/src/XafPet.Desktop/DefaultPets/fubao']:
|
|
|
+ open(d + '/standing.png', 'wb').write(png)
|
|
|
+ print('written', d + '/standing.png')
|
|
|
+"
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：验证配置可被 PetConfig 解析**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~PetConfigTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：PASS（回归确认）。
|
|
|
+
|
|
|
+- [ ] **步骤 5：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 默认宠物资产 (浠宝/福宝 占位配置)"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 6：WebView2 宿主 + Bridge 注册
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/WebViewHost.xaml` / `WebViewHost.xaml.cs`
|
|
|
+- 修改：`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml` / `MainWindow.xaml.cs`
|
|
|
+
|
|
|
+- [ ] **步骤 1：创建 WebViewHost 控件（XAML）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/WebViewHost.xaml`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<UserControl x:Class="XafPet.Desktop.PetEngine.WebViewHost"
|
|
|
+ xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
|
|
+ xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
|
|
+ xmlns:wv2="clr-namespace:Microsoft.Web.WebView2.Wpf;assembly=Microsoft.Web.WebView2.Wpf"
|
|
|
+ Background="Transparent">
|
|
|
+ <Grid>
|
|
|
+ <wv2:WebView2 x:Name="PetWebView"
|
|
|
+ DefaultBackgroundColor="Transparent"
|
|
|
+ HorizontalAlignment="Stretch" VerticalAlignment="Stretch"/>
|
|
|
+ </Grid>
|
|
|
+</UserControl>
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：实现 WebViewHost 代码（Bridge 注册 + 初始化）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/PetEngine/WebViewHost.xaml.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System;
|
|
|
+using System.IO;
|
|
|
+using System.Threading.Tasks;
|
|
|
+using System.Windows.Controls;
|
|
|
+using Microsoft.Web.WebView2.Core;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+public partial class WebViewHost : UserControl
|
|
|
+{
|
|
|
+ public event Action<string, string?>? InteractionReceived; // action, dataJson
|
|
|
+
|
|
|
+ public WebViewHost()
|
|
|
+ {
|
|
|
+ InitializeComponent();
|
|
|
+ Loaded += async (_, _) => await InitializeWebViewAsync();
|
|
|
+ }
|
|
|
+
|
|
|
+ private async Task InitializeWebViewAsync()
|
|
|
+ {
|
|
|
+ var env = await CoreWebView2Environment.CreateAsync(
|
|
|
+ userDataFolder: Path.Combine(
|
|
|
+ Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
|
|
|
+ "XafPet", "WebView2"));
|
|
|
+ await PetWebView.EnsureCoreWebView2Async(env);
|
|
|
+
|
|
|
+ PetWebView.CoreWebView2.Settings.AreDefaultContextMenusEnabled = false;
|
|
|
+ PetWebView.CoreWebView2.Settings.AreDevToolsEnabled = true;
|
|
|
+ PetWebView.CoreWebView2.Settings.IsStatusBarEnabled = false;
|
|
|
+
|
|
|
+ PetWebView.CoreWebView2.AddHostObjectToScript("cfcHost", new CfcHostBridge(this));
|
|
|
+
|
|
|
+ var htmlPath = Path.GetFullPath(Path.Combine(AppContext.BaseDirectory, "Assets", "pet.html"));
|
|
|
+ PetWebView.CoreWebView2.Navigate($"file:///{htmlPath.Replace('\\', '/')}");
|
|
|
+ }
|
|
|
+
|
|
|
+ /// <summary>C# → JS：推送宠物状态</summary>
|
|
|
+ public void NotifyState(string stateJson)
|
|
|
+ {
|
|
|
+ PetWebView.ExecuteScriptAsync($"window.cfcPetAPI?.notifyState({stateJson})");
|
|
|
+ }
|
|
|
+
|
|
|
+ /// <summary>C# → JS：推送自定义状态</summary>
|
|
|
+ public void SetCustomState(string stateName, string dataJson)
|
|
|
+ {
|
|
|
+ PetWebView.ExecuteScriptAsync(
|
|
|
+ $"window.cfcPetAPI?.setCustomState('{stateName}', {dataJson})");
|
|
|
+ }
|
|
|
+
|
|
|
+ /// <summary>C# → JS：显示气泡</summary>
|
|
|
+ public void ShowBubble(string text, int durationMs = 5000)
|
|
|
+ {
|
|
|
+ var escaped = text.Replace("\\", "\\\\").Replace("'", "\\'");
|
|
|
+ PetWebView.ExecuteScriptAsync(
|
|
|
+ $"window.cfcPetAPI?.showBubble('{escaped}', {durationMs})");
|
|
|
+ }
|
|
|
+
|
|
|
+ /// <summary>C# → JS：加载配置</summary>
|
|
|
+ public void LoadPetConfig(string configJson)
|
|
|
+ {
|
|
|
+ PetWebView.ExecuteScriptAsync($"window.cfcPetAPI?.loadConfig({configJson})");
|
|
|
+ }
|
|
|
+
|
|
|
+ internal void RaiseInteraction(string action, string? dataJson)
|
|
|
+ => InteractionReceived?.Invoke(action, dataJson);
|
|
|
+}
|
|
|
+
|
|
|
+internal sealed class CfcHostBridge
|
|
|
+{
|
|
|
+ private readonly WebViewHost _host;
|
|
|
+ public CfcHostBridge(WebViewHost host) => _host = host;
|
|
|
+ public void onInteract(string action, string dataJson)
|
|
|
+ => _host.RaiseInteraction(action, dataJson);
|
|
|
+ public void onDragStart() { }
|
|
|
+ public void onDragEnd() { }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 3：创建 pet.html**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/Assets/pet.html`：
|
|
|
+
|
|
|
+```html
|
|
|
+<!DOCTYPE html>
|
|
|
+<html lang="zh-CN">
|
|
|
+<head>
|
|
|
+<meta charset="UTF-8" />
|
|
|
+<title>Xaf Pet</title>
|
|
|
+<link rel="stylesheet" href="animations.css" />
|
|
|
+<style>
|
|
|
+ html, body { width: 100%; height: 100%; margin: 0; overflow: hidden; background: transparent; }
|
|
|
+ #pet-stage { position: fixed; inset: 0; display: flex; align-items: flex-end; justify-content: center; pointer-events: none; }
|
|
|
+ #pet { width: 120px; height: 140px; pointer-events: auto; cursor: grab; user-select: none; }
|
|
|
+ #pet img { width: 100%; height: 100%; object-fit: contain; pointer-events: none; }
|
|
|
+ #bubble { position: absolute; bottom: 150px; left: 50%; transform: translateX(-50%);
|
|
|
+ background: #fff; border: 2px solid #4A9BD7; border-radius: 12px; padding: 6px 12px;
|
|
|
+ font: 13px/1.4 'PingFang SC', sans-serif; color: #333; white-space: nowrap;
|
|
|
+ display: none; box-shadow: 0 2px 8px rgba(0,0,0,.12); }
|
|
|
+ #bubble::after { content: ''; position: absolute; top: 100%; left: 50%; transform: translateX(-50%);
|
|
|
+ border: 6px solid transparent; border-top-color: #4A9BD7; }
|
|
|
+</style>
|
|
|
+</head>
|
|
|
+<body>
|
|
|
+<div id="pet-stage">
|
|
|
+ <div id="pet">
|
|
|
+ <img id="pet-img" src="" alt="pet" draggable="false" />
|
|
|
+ <div id="bubble"></div>
|
|
|
+ </div>
|
|
|
+</div>
|
|
|
+<script src="pet-engine.js"></script>
|
|
|
+<script src="interactions.js"></script>
|
|
|
+</body>
|
|
|
+</html>
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：修改 MainWindow 使用 WebViewHost**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<Window x:Class="XafPet.Desktop.MainWindow"
|
|
|
+ xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
|
|
+ xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
|
|
+ xmlns:pet="clr-namespace:XafPet.Desktop.PetEngine"
|
|
|
+ Title="浠艾福桌面宠物"
|
|
|
+ Width="200" Height="200"
|
|
|
+ WindowStyle="None"
|
|
|
+ AllowsTransparency="True"
|
|
|
+ Background="Transparent"
|
|
|
+ Topmost="True"
|
|
|
+ ShowInTaskbar="False"
|
|
|
+ ResizeMode="NoResize">
|
|
|
+ <Grid x:Name="RootGrid" Background="Transparent">
|
|
|
+ <pet:WebViewHost x:Name="PetHost" HorizontalAlignment="Stretch" VerticalAlignment="Stretch"/>
|
|
|
+ </Grid>
|
|
|
+</Window>
|
|
|
+```
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Windows;
|
|
|
+using System.Windows.Input;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public partial class MainWindow : Window
|
|
|
+{
|
|
|
+ public MainWindow()
|
|
|
+ {
|
|
|
+ InitializeComponent();
|
|
|
+ RootGrid.MouseLeftButtonDown += (s, e) =>
|
|
|
+ {
|
|
|
+ if (e.ButtonState == MouseButtonState.Pressed) DragMove();
|
|
|
+ };
|
|
|
+ Loaded += async (_, _) =>
|
|
|
+ {
|
|
|
+ await Task.Delay(2000);
|
|
|
+ PetHost.NotifyState("{\"state\":\"happy\",\"reason\":\"welcome\"}");
|
|
|
+ };
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：编译验证**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet build XafPet.Desktop.sln
|
|
|
+```
|
|
|
+
|
|
|
+预期：`Build succeeded`，0 错误。
|
|
|
+
|
|
|
+- [ ] **步骤 6：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: WebView2 宿主 + C#/JS Bridge 注册"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 7：宠物引擎 JS（状态机 + 动画）
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/Assets/pet-engine.js`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/Assets/animations.css`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/Assets/interactions.js`
|
|
|
+
|
|
|
+- [ ] **步骤 1：创建 animations.css**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/Assets/animations.css`：
|
|
|
+
|
|
|
+```css
|
|
|
+/* ===== 浠艾福桌面宠物动画定义 ===== */
|
|
|
+@keyframes wings_idle { 0%, 100% { transform: translateY(0) } 50% { transform: translateY(-3px) } }
|
|
|
+@keyframes wings_spread { 0% { transform: scale(1) } 30% { transform: scale(1.15, 0.95) } 70% { transform: scale(0.95, 1.1) } 100% { transform: scale(1) } }
|
|
|
+@keyframes head_tilt { 0%, 100% { transform: rotate(0deg) } 25% { transform: rotate(-8deg) } 75% { transform: rotate(6deg) } }
|
|
|
+@keyframes hand_gesture { 0%, 100% { transform: translateY(0) } 20% { transform: translateY(-8px) } 40% { transform: translateY(0) } 60% { transform: translateY(-5px) } 80% { transform: translateY(0) } }
|
|
|
+@keyframes breath_loop { 0%, 100% { transform: scale(1, 1) } 50% { transform: scale(1.04, 0.96) } }
|
|
|
+@keyframes celebrate { 0%, 100% { transform: translateY(0) rotate(0) } 25% { transform: translateY(-16px) rotate(-4deg) } 50% { transform: translateY(0) rotate(0) } 75% { transform: translateY(-16px) rotate(4deg) } }
|
|
|
+@keyframes sad_animation { 0%, 100% { transform: translateY(0) } 50% { transform: translateY(2px) } }
|
|
|
+@keyframes tail_wrap { 0%, 100% { transform: rotate(0deg) } 50% { transform: rotate(3deg) } }
|
|
|
+@keyframes belly_show { 0%, 100% { transform: rotate(0deg) scale(1) } 50% { transform: rotate(-4deg) scale(1.05) } }
|
|
|
+@keyframes paw_press { 0%, 100% { transform: translateY(0) } 50% { transform: translateY(3px) } }
|
|
|
+@keyframes tail_flick { 0%, 100% { transform: rotate(0deg) } 30% { transform: rotate(10deg) } 60% { transform: rotate(-10deg) } }
|
|
|
+@keyframes blink_eye { 0%, 90%, 100% { transform: scaleY(1) } 95% { transform: scaleY(0.1) } }
|
|
|
+@keyframes look_around { 0%, 100% { transform: rotate(0deg) } 25% { transform: rotate(-12deg) } 75% { transform: rotate(12deg) } }
|
|
|
+@keyframes wave { 0%, 100% { transform: rotate(0deg) } 25% { transform: rotate(-15deg) } 50% { transform: rotate(10deg) } 75% { transform: rotate(-15deg) } }
|
|
|
+@keyframes stretch { 0%, 100% { transform: scaleY(1) } 50% { transform: scaleY(1.15) } }
|
|
|
+@keyframes clap { 0%, 100% { transform: scale(1) } 40% { transform: scale(1.1, 0.9) } 70% { transform: scale(0.95, 1.05) } }
|
|
|
+@keyframes bow { 0%, 100% { transform: rotate(0deg) } 50% { transform: rotate(10deg) } }
|
|
|
+@keyframes whistle { 0%, 100% { transform: translateY(0) } 50% { transform: translateY(-4px) } }
|
|
|
+@keyframes ear_scrape { 0%, 100% { transform: rotate(0deg) } 50% { transform: rotate(6deg) } }
|
|
|
+@keyframes pet_touch { 0% { transform: scale(1) } 50% { transform: scale(1.08) } 100% { transform: scale(1) } }
|
|
|
+@keyframes puzzle_active { 0%, 100% { transform: rotate(0deg) } 50% { transform: rotate(180deg) } }
|
|
|
+@keyframes worried_walk { 0%, 100% { transform: translateX(0) } 25% { transform: translateX(6px) } 75% { transform: translateX(-6px) } }
|
|
|
+
|
|
|
+.anim-wings_idle { animation: wings_idle 2s ease-in-out infinite; }
|
|
|
+.anim-wings_spread { animation: wings_spread 1.2s ease-in-out 1; }
|
|
|
+.anim-head_tilt { animation: head_tilt 1.6s ease-in-out infinite; }
|
|
|
+.anim-hand_gesture { animation: hand_gesture 1.8s ease-in-out infinite; }
|
|
|
+.anim-breath_loop { animation: breath_loop 2.4s ease-in-out infinite; }
|
|
|
+.anim-celebrate { animation: celebrate 0.8s ease-in-out 3; }
|
|
|
+.anim-sad_animation { animation: sad_animation 3s ease-in-out infinite; }
|
|
|
+.anim-tail_wrap { animation: tail_wrap 2s ease-in-out infinite; }
|
|
|
+.anim-belly_show { animation: belly_show 1.4s ease-in-out 2; }
|
|
|
+.anim-paw_press { animation: paw_press 1s ease-in-out 2; }
|
|
|
+.anim-tail_flick { animation: tail_flick 1.5s ease-in-out 2; }
|
|
|
+.anim-blink_eye { animation: blink_eye 3.5s ease-in-out infinite; }
|
|
|
+.anim-look_around { animation: look_around 2s ease-in-out 1; }
|
|
|
+.anim-wave { animation: wave 1.2s ease-in-out 2; }
|
|
|
+.anim-stretch { animation: stretch 1.8s ease-in-out 1; }
|
|
|
+.anim-clap { animation: clap 0.6s ease-in-out 3; }
|
|
|
+.anim-bow { animation: bow 1.2s ease-in-out 2; }
|
|
|
+.anim-whistle { animation: whistle 0.9s ease-in-out 3; }
|
|
|
+.anim-ear_scrape { animation: ear_scrape 1s ease-in-out 2; }
|
|
|
+.anim-pet_touch { animation: pet_touch 0.6s ease-in-out 1; }
|
|
|
+.anim-puzzle_active { animation: puzzle_active 1s ease-in-out infinite; }
|
|
|
+.anim-worried_walk { animation: worried_walk 1.2s ease-in-out infinite; }
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：创建 pet-engine.js**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/Assets/pet-engine.js`：
|
|
|
+
|
|
|
+```javascript
|
|
|
+(function () {
|
|
|
+ 'use strict';
|
|
|
+
|
|
|
+ const petImg = document.getElementById('pet-img');
|
|
|
+ const petEl = document.getElementById('pet');
|
|
|
+ const bubble = document.getElementById('bubble');
|
|
|
+
|
|
|
+ let currentState = 'idle';
|
|
|
+ let currentAnimation = null;
|
|
|
+ let config = null;
|
|
|
+ let bubbleTimer = null;
|
|
|
+
|
|
|
+ const DEFAULT_IMAGE = 'data:image/svg+xml;utf8,' +
|
|
|
+ encodeURIComponent('<svg xmlns="http://www.w3.org/2000/svg" width="120" height="140">' +
|
|
|
+ '<text y="100" font-size="90" text-anchor="middle">🦜</text></svg>');
|
|
|
+
|
|
|
+ const BUBBLE_TEXTS = {
|
|
|
+ happy: '完成了！继续保持～',
|
|
|
+ busy: '有任务在等你呢～',
|
|
|
+ worried: '任务要过期啦，快去看看！',
|
|
|
+ excited: '打卡成功，太棒了！',
|
|
|
+ remind: '该喝水啦～',
|
|
|
+ tired: '有点累了呢…',
|
|
|
+ sad: '要照顾好自己哦…',
|
|
|
+ waitingForInteraction: '来和我互动一下吧！',
|
|
|
+ miniGame: '我们一起玩吧！',
|
|
|
+ sleeping: 'zZ…',
|
|
|
+ custom: '自定义状态'
|
|
|
+ };
|
|
|
+
|
|
|
+ window.cfcPetAPI = {
|
|
|
+ notifyState: function (stateJson) {
|
|
|
+ const payload = typeof stateJson === 'string' ? JSON.parse(stateJson) : stateJson;
|
|
|
+ setState(payload.state, payload.reason || null, payload.data || null);
|
|
|
+ },
|
|
|
+ setCustomState: function (stateName, dataJson) {
|
|
|
+ const data = typeof dataJson === 'string' ? JSON.parse(dataJson) : dataJson;
|
|
|
+ setState(stateName, 'custom', data);
|
|
|
+ },
|
|
|
+ loadConfig: function (configJson) {
|
|
|
+ config = typeof configJson === 'string' ? JSON.parse(configJson) : configJson;
|
|
|
+ applyImage(config);
|
|
|
+ },
|
|
|
+ showBubble: function (text, durationMs) {
|
|
|
+ bubble.textContent = text;
|
|
|
+ bubble.style.display = 'block';
|
|
|
+ clearTimeout(bubbleTimer);
|
|
|
+ if (durationMs) bubbleTimer = setTimeout(hideBubble, durationMs);
|
|
|
+ },
|
|
|
+ hideBubble: hideBubble,
|
|
|
+ getState: function () { return currentState; }
|
|
|
+ };
|
|
|
+
|
|
|
+ function hideBubble() { bubble.style.display = 'none'; }
|
|
|
+
|
|
|
+ function applyImage(cfg) {
|
|
|
+ if (!cfg || !cfg.default_image) return;
|
|
|
+ const src = cfg.image_base_url + cfg.default_image;
|
|
|
+ petImg.src = src;
|
|
|
+ petImg.onerror = function () { petImg.src = DEFAULT_IMAGE; };
|
|
|
+ }
|
|
|
+
|
|
|
+ function setState(stateName, reason, data) {
|
|
|
+ currentState = stateName;
|
|
|
+ if (currentAnimation) { petEl.classList.remove(currentAnimation); currentAnimation = null; }
|
|
|
+
|
|
|
+ let animClass = null;
|
|
|
+ if (config && config.actions && config.actions[stateName]) {
|
|
|
+ animClass = 'anim-' + config.actions[stateName];
|
|
|
+ } else {
|
|
|
+ animClass = 'anim-' + stateName;
|
|
|
+ }
|
|
|
+
|
|
|
+ const styleEl = document.getElementById('pet-animations');
|
|
|
+ const sheet = styleEl ? styleEl.sheet : null;
|
|
|
+ const hasClass = sheet && Array.from(sheet.cssRules).some(r => r.selectorText === '.' + animClass);
|
|
|
+ if (hasClass) { petEl.classList.add(animClass); currentAnimation = animClass; }
|
|
|
+
|
|
|
+ if (reason === 'drink_water') {
|
|
|
+ bubble.textContent = '该喝水啦～';
|
|
|
+ bubble.style.display = 'block';
|
|
|
+ clearTimeout(bubbleTimer);
|
|
|
+ bubbleTimer = setTimeout(hideBubble, 8000);
|
|
|
+ } else if (reason === 'welcome') {
|
|
|
+ bubble.textContent = '我来了！';
|
|
|
+ bubble.style.display = 'block';
|
|
|
+ clearTimeout(bubbleTimer);
|
|
|
+ bubbleTimer = setTimeout(hideBubble, 3000);
|
|
|
+ } else if (BUBBLE_TEXTS[stateName]) {
|
|
|
+ bubble.textContent = BUBBLE_TEXTS[stateName];
|
|
|
+ bubble.style.display = 'block';
|
|
|
+ clearTimeout(bubbleTimer);
|
|
|
+ bubbleTimer = setTimeout(hideBubble, 5000);
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ petImg.src = DEFAULT_IMAGE;
|
|
|
+
|
|
|
+ setInterval(function () {
|
|
|
+ if (document.getElementById('pet-img')) {
|
|
|
+ petImg.classList.add('anim-blink_eye');
|
|
|
+ setTimeout(() => petImg.classList.remove('anim-blink_eye'), 200);
|
|
|
+ }
|
|
|
+ }, 3500);
|
|
|
+})();
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 3：创建 interactions.js**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/Assets/interactions.js`：
|
|
|
+
|
|
|
+```javascript
|
|
|
+(function () {
|
|
|
+ 'use strict';
|
|
|
+
|
|
|
+ const petEl = document.getElementById('pet');
|
|
|
+ const petImg = document.getElementById('pet-img');
|
|
|
+
|
|
|
+ let dragStartX = 0, dragStartY = 0;
|
|
|
+ let pressTimer = null;
|
|
|
+ let isDragging = false;
|
|
|
+
|
|
|
+ petEl.addEventListener('mousedown', function (e) {
|
|
|
+ dragStartX = e.clientX;
|
|
|
+ dragStartY = e.clientY;
|
|
|
+ isDragging = false;
|
|
|
+ pressTimer = setTimeout(() => {
|
|
|
+ notifyInteract('pet', {});
|
|
|
+ }, 1500);
|
|
|
+ });
|
|
|
+
|
|
|
+ petEl.addEventListener('mousemove', function (e) {
|
|
|
+ const dx = e.clientX - dragStartX;
|
|
|
+ const dy = e.clientY - dragStartY;
|
|
|
+ if (Math.abs(dx) > 4 || Math.abs(dy) > 4) {
|
|
|
+ isDragging = true;
|
|
|
+ clearTimeout(pressTimer);
|
|
|
+ notifyDragStart();
|
|
|
+ }
|
|
|
+ });
|
|
|
+
|
|
|
+ petEl.addEventListener('mouseup', function (e) {
|
|
|
+ clearTimeout(pressTimer);
|
|
|
+ if (!isDragging) {
|
|
|
+ notifyInteract('click', {});
|
|
|
+ } else {
|
|
|
+ notifyDragEnd();
|
|
|
+ }
|
|
|
+ });
|
|
|
+
|
|
|
+ function notifyInteract(action, data) {
|
|
|
+ try {
|
|
|
+ chrome.webview.hostObjects.sync.cfcHost.onInteract(action, JSON.stringify(data));
|
|
|
+ } catch (err) { console.log('[interaction]', action, data); }
|
|
|
+ }
|
|
|
+
|
|
|
+ function notifyDragStart() {
|
|
|
+ try { chrome.webview.hostObjects.sync.cfcHost.onDragStart(); } catch (e) { /* noop */ }
|
|
|
+ }
|
|
|
+
|
|
|
+ function notifyDragEnd() {
|
|
|
+ try { chrome.webview.hostObjects.sync.cfcHost.onDragEnd(); } catch (e) { /* noop */ }
|
|
|
+ }
|
|
|
+})();
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：语法检查 JS（若 node 不可用则跳过）**
|
|
|
+
|
|
|
+```bash
|
|
|
+node --check cfc-desktop-pet/src/XafPet.Desktop/Assets/pet-engine.js
|
|
|
+node --check cfc-desktop-pet/src/XafPet.Desktop/Assets/interactions.js
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：编译验证**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet build XafPet.Desktop.sln
|
|
|
+```
|
|
|
+
|
|
|
+预期：`Build succeeded`。
|
|
|
+
|
|
|
+- [ ] **步骤 6：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 宠物引擎 JS (状态机+动画) + CSS 动画库"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 8：状态轮询与推送集成
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 修改：`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml.cs`
|
|
|
+- 修改：`cfc-desktop-pet/src/XafPet.Desktop/XafPet.Desktop.csproj`（添加 WindowsForms 引用）
|
|
|
+
|
|
|
+- [ ] **步骤 1：修改 csproj 添加 WindowsForms 引用**
|
|
|
+
|
|
|
+在 `XafPet.Desktop.csproj` 的 `<ItemGroup>` 追加：
|
|
|
+
|
|
|
+```xml
|
|
|
+ <ItemGroup>
|
|
|
+ <FrameworkReference Include="Microsoft.WindowsDesktop.App.WindowsForms" />
|
|
|
+ </ItemGroup>
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：实现完整 MainWindow（含轮询 + 交互回调）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/MainWindow.xaml.cs`（完整替换）：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System;
|
|
|
+using System.IO;
|
|
|
+using System.Text.Json;
|
|
|
+using System.Timers;
|
|
|
+using System.Windows;
|
|
|
+using System.Windows.Forms;
|
|
|
+using XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public partial class MainWindow : Window
|
|
|
+{
|
|
|
+ private NotifyIcon? _trayIcon;
|
|
|
+ private ApiClient? _api;
|
|
|
+ private Timer? _taskTimer;
|
|
|
+ private Timer? _energyTimer;
|
|
|
+ private Timer? _waterTimer;
|
|
|
+ private string _baseUrl = "http://localhost:9082";
|
|
|
+
|
|
|
+ public MainWindow()
|
|
|
+ {
|
|
|
+ InitializeComponent();
|
|
|
+ RootGrid.MouseLeftButtonDown += (s, e) =>
|
|
|
+ {
|
|
|
+ if (e.ButtonState == MouseButtonState.Pressed) DragMove();
|
|
|
+ };
|
|
|
+ PetHost.InteractionReceived += OnInteractionReceived;
|
|
|
+ Loaded += OnLoaded;
|
|
|
+ Closed += OnClosed;
|
|
|
+ }
|
|
|
+
|
|
|
+ private void OnLoaded(object sender, RoutedEventArgs e)
|
|
|
+ {
|
|
|
+ var token = TokenStore.Load();
|
|
|
+ _api = new ApiClient(new HttpClient(), _baseUrl, token ?? "dev-token");
|
|
|
+ StartPolling();
|
|
|
+ SetupTray();
|
|
|
+ _ = SyncMascotAsync();
|
|
|
+ }
|
|
|
+
|
|
|
+ private void StartPolling()
|
|
|
+ {
|
|
|
+ _taskTimer = new Timer(30_000) { AutoReset = true };
|
|
|
+ _taskTimer.Elapsed += async (_, _) => await PollTasksAsync();
|
|
|
+ _taskTimer.Start();
|
|
|
+
|
|
|
+ _energyTimer = new Timer(60_000) { AutoReset = true };
|
|
|
+ _energyTimer.Elapsed += async (_, _) => await PollHealthAsync();
|
|
|
+ _energyTimer.Start();
|
|
|
+
|
|
|
+ StartWaterReminder();
|
|
|
+ }
|
|
|
+
|
|
|
+ private async Task PollTasksAsync()
|
|
|
+ {
|
|
|
+ if (_api == null) return;
|
|
|
+ try
|
|
|
+ {
|
|
|
+ var tasks = await _api.GetTodayTasksAsync();
|
|
|
+ var state = StateManager.MapState(tasks ?? new List<CfcTask>(), null, null, false);
|
|
|
+ PushState(state, "tasks");
|
|
|
+ }
|
|
|
+ catch (ApiException ex) { PushBubble($"服务暂时不可用({ex.ApiCode})"); }
|
|
|
+ catch (Exception) { PushBubble("连接后端失败，请检查服务"); }
|
|
|
+ }
|
|
|
+
|
|
|
+ private async Task PollHealthAsync()
|
|
|
+ {
|
|
|
+ if (_api == null) return;
|
|
|
+ try
|
|
|
+ {
|
|
|
+ var energy = await _api.GetEnergyOverviewAsync();
|
|
|
+ var checkin = await _api.GetDailyCheckinAsync();
|
|
|
+ var state = StateManager.MapState(null, energy, checkin, false);
|
|
|
+ PushState(state, "health");
|
|
|
+ }
|
|
|
+ catch (Exception) { /* 静默 */ }
|
|
|
+ }
|
|
|
+
|
|
|
+ private void PushState(PetState state, string reason)
|
|
|
+ {
|
|
|
+ var payload = new PetStatePayload(StateManager.StateToCamelCase(state), reason, null);
|
|
|
+ PetHost.NotifyState(JsonSerializer.Serialize(payload));
|
|
|
+ }
|
|
|
+
|
|
|
+ private void PushBubble(string text)
|
|
|
+ {
|
|
|
+ PetHost.ShowBubble(text, 5000);
|
|
|
+ }
|
|
|
+
|
|
|
+ private void SetupTray()
|
|
|
+ {
|
|
|
+ var menu = new ContextMenuStrip();
|
|
|
+ menu.Items.Add("设置", null, (_, _) => ShowSettings());
|
|
|
+ menu.Items.Add("显示/隐藏", null, (_, _) => ToggleVisible());
|
|
|
+ menu.Items.Add("退出", null, (_, _) => { _trayIcon?.Dispose(); Application.Current.Shutdown(); });
|
|
|
+
|
|
|
+ _trayIcon = new NotifyIcon
|
|
|
+ {
|
|
|
+ Text = "浠艾福桌面宠物",
|
|
|
+ Icon = SystemIcons.Application,
|
|
|
+ ContextMenuStrip = menu,
|
|
|
+ Visible = true
|
|
|
+ };
|
|
|
+ _trayIcon.DoubleClick += (_, _) => ToggleVisible();
|
|
|
+ }
|
|
|
+
|
|
|
+ private void ToggleVisible()
|
|
|
+ {
|
|
|
+ Visibility = Visibility == Visibility.Visible ? Visibility.Hidden : Visibility.Visible;
|
|
|
+ }
|
|
|
+
|
|
|
+ private void ShowSettings()
|
|
|
+ {
|
|
|
+ var win = new SettingsWindow(TokenStore.Load(), _baseUrl) { Owner = this };
|
|
|
+ if (win.ShowDialog() == true)
|
|
|
+ {
|
|
|
+ _baseUrl = win.BaseUrl;
|
|
|
+ if (!string.IsNullOrEmpty(win.Token)) TokenStore.Save(win.Token);
|
|
|
+ _api = new ApiClient(new HttpClient(), _baseUrl, TokenStore.Load() ?? "dev-token");
|
|
|
+ StartPolling();
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ private async void OnClosed(object? sender, EventArgs e)
|
|
|
+ {
|
|
|
+ _taskTimer?.Stop(); _energyTimer?.Stop(); _waterTimer?.Stop();
|
|
|
+ _taskTimer?.Dispose(); _energyTimer?.Dispose(); _waterTimer?.Dispose();
|
|
|
+ _trayIcon?.Dispose();
|
|
|
+ }
|
|
|
+
|
|
|
+ // ── 喝水提醒 ─────────────────────────────────────────────
|
|
|
+ private void StartWaterReminder()
|
|
|
+ {
|
|
|
+ _waterTimer = new Timer(60 * 60 * 1000) { AutoReset = true };
|
|
|
+ _waterTimer.Elapsed += async (_, _) => await CheckWaterAsync();
|
|
|
+ _waterTimer.Start();
|
|
|
+ _ = CheckWaterAsync();
|
|
|
+ }
|
|
|
+
|
|
|
+ private async Task CheckWaterAsync()
|
|
|
+ {
|
|
|
+ if (_api == null) return;
|
|
|
+ var hour = DateTime.Now.Hour;
|
|
|
+ if (hour < 10 || hour > 20) return;
|
|
|
+ try
|
|
|
+ {
|
|
|
+ var checkin = await _api.GetDailyCheckinAsync();
|
|
|
+ if (checkin != null && !checkin.Items.Contains("water"))
|
|
|
+ {
|
|
|
+ PushState(PetState.WaitingForInteraction, "drink_water");
|
|
|
+ PetHost.ShowBubble("该喝水啦～点我确认完成！", 15000);
|
|
|
+ }
|
|
|
+ }
|
|
|
+ catch (Exception) { }
|
|
|
+ }
|
|
|
+
|
|
|
+ private void OnInteractionReceived(string action, string? dataJson)
|
|
|
+ {
|
|
|
+ switch (action)
|
|
|
+ {
|
|
|
+ case "click":
|
|
|
+ _ = HandleClickAsync();
|
|
|
+ break;
|
|
|
+ case "pet":
|
|
|
+ PetHost.ShowBubble("嘻嘻～", 2000);
|
|
|
+ break;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ private async Task HandleClickAsync()
|
|
|
+ {
|
|
|
+ if (_api == null) return;
|
|
|
+ try
|
|
|
+ {
|
|
|
+ var result = await _api.CompleteDrinkWaterAsync();
|
|
|
+ if (result?.IsSuccess == true)
|
|
|
+ {
|
|
|
+ PushState(PetState.Happy, "drink_complete");
|
|
|
+ PetHost.ShowBubble("喝水打卡成功！太棒了～", 4000);
|
|
|
+ }
|
|
|
+ }
|
|
|
+ catch (Exception)
|
|
|
+ {
|
|
|
+ PushBubble("打卡失败，请稍后再试");
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ // ── 吉祥物同步 ───────────────────────────────────────────
|
|
|
+ private async Task SyncMascotAsync()
|
|
|
+ {
|
|
|
+ if (_api == null) return;
|
|
|
+ try
|
|
|
+ {
|
|
|
+ var mascot = await _api.GetMascotAsync();
|
|
|
+ var petName = mascot?.MascotId ?? "xibao";
|
|
|
+ var cfgPath = Path.Combine(AppContext.BaseDirectory, "DefaultPets", petName, "pet-config.json");
|
|
|
+ if (File.Exists(cfgPath))
|
|
|
+ {
|
|
|
+ var json = File.ReadAllText(cfgPath);
|
|
|
+ var parsed = PetConfig.Parse(json);
|
|
|
+ PetHost.LoadPetConfig(JsonSerializer.Serialize(parsed));
|
|
|
+ }
|
|
|
+ }
|
|
|
+ catch (Exception) { /* 默认浠宝 */ }
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 3：更新 App.xaml.cs 声明命名空间（WPF 所需）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/App.xaml.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Windows;
|
|
|
+using System.Windows.Forms; // NotifyIcon
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public partial class App : Application
|
|
|
+{
|
|
|
+ protected override void OnStartup(StartupEventArgs e)
|
|
|
+ {
|
|
|
+ base.OnStartup(e);
|
|
|
+ // 确保单实例（避免重复启动）
|
|
|
+ if (!SingleInstanceHelper.TryEnterFirstInstance())
|
|
|
+ {
|
|
|
+ Current.Shutdown();
|
|
|
+ return;
|
|
|
+ }
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 4：单实例辅助类**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/SingleInstanceHelper.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.Collections.Generic;
|
|
|
+using System.Diagnostics;
|
|
|
+using System.Linq;
|
|
|
+using System.Runtime.InteropServices;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+/// <summary>简单的单实例检测（按窗口标题匹配进程）</summary>
|
|
|
+public static class SingleInstanceHelper
|
|
|
+{
|
|
|
+ [DllImport("user32.dll")]
|
|
|
+ private static extern bool SetForegroundWindow(IntPtr hWnd);
|
|
|
+
|
|
|
+ public static bool TryEnterFirstInstance()
|
|
|
+ {
|
|
|
+ var name = Process.GetCurrentProcess().ProcessName;
|
|
|
+ var instances = Process.GetProcessesByName(name);
|
|
|
+ if (instances.Length > 1)
|
|
|
+ {
|
|
|
+ SetForegroundWindow(instances[0].MainWindowHandle);
|
|
|
+ return false;
|
|
|
+ }
|
|
|
+ return true;
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：编译验证**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet build XafPet.Desktop.sln
|
|
|
+```
|
|
|
+
|
|
|
+预期：`Build succeeded`。
|
|
|
+
|
|
|
+- [ ] **步骤 6：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 状态轮询 + 托盘 + 喝水提醒闭环 + 单实例"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 9：Token 存储 + 设置窗口
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/TokenStore.cs`
|
|
|
+- 创建：`cfc-desktop-pet/src/XafPet.Desktop/SettingsWindow.xaml` / `SettingsWindow.xaml.cs`
|
|
|
+- 测试：`cfc-desktop-pet/tests/XafPet.Desktop.Tests/TokenStoreTests.cs`
|
|
|
+
|
|
|
+- [ ] **步骤 1：编写 TokenStore 测试**
|
|
|
+
|
|
|
+`cfc-desktop-pet/tests/XafPet.Desktop.Tests/TokenStoreTests.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.IO;
|
|
|
+using Xunit;
|
|
|
+using XafPet.Desktop;
|
|
|
+
|
|
|
+namespace XafPet.Desktop.Tests;
|
|
|
+
|
|
|
+public class TokenStoreTests
|
|
|
+{
|
|
|
+ private string TestDir => Path.Combine(Path.GetTempPath(), "xptest_" + Guid.NewGuid().ToString("N"));
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void SaveAndLoad_RoundsTrip()
|
|
|
+ {
|
|
|
+ var path = Path.Combine(TestDir, "token.bin");
|
|
|
+ TokenStore.SetPath(path);
|
|
|
+ TokenStore.Save("my-jwt-token");
|
|
|
+ var loaded = TokenStore.Load();
|
|
|
+ Assert.Equal("my-jwt-token", loaded);
|
|
|
+ TokenStore.Clear();
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void Load_MissingFile_ReturnsNull()
|
|
|
+ {
|
|
|
+ TokenStore.SetPath(Path.Combine(TestDir, "nonexistent.bin"));
|
|
|
+ Assert.Null(TokenStore.Load());
|
|
|
+ }
|
|
|
+
|
|
|
+ [Fact]
|
|
|
+ public void Clear_RemovesFile()
|
|
|
+ {
|
|
|
+ var path = Path.Combine(TestDir, "token.bin");
|
|
|
+ TokenStore.SetPath(path);
|
|
|
+ TokenStore.Save("token");
|
|
|
+ TokenStore.Clear();
|
|
|
+ Assert.False(File.Exists(path));
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：实现 TokenStore（注入路径，便于测试）**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/TokenStore.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.IO;
|
|
|
+using System.Security.Cryptography;
|
|
|
+using System.Text;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public static class TokenStore
|
|
|
+{
|
|
|
+ private static string _path = Path.Combine(
|
|
|
+ Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
|
|
|
+ "XafPet", "token.bin");
|
|
|
+
|
|
|
+ public static void SetPath(string path) => _path = path;
|
|
|
+
|
|
|
+ public static void Save(string token)
|
|
|
+ {
|
|
|
+ Directory.CreateDirectory(Path.GetDirectoryName(_path)!);
|
|
|
+ var encrypted = ProtectedData.Protect(
|
|
|
+ Encoding.UTF8.GetBytes(token), null, DataProtectionScope.CurrentUser);
|
|
|
+ File.WriteAllBytes(_path, encrypted);
|
|
|
+ }
|
|
|
+
|
|
|
+ public static string? Load()
|
|
|
+ {
|
|
|
+ if (!File.Exists(_path)) return null;
|
|
|
+ try
|
|
|
+ {
|
|
|
+ var encrypted = File.ReadAllBytes(_path);
|
|
|
+ var decrypted = ProtectedData.Unprotect(
|
|
|
+ encrypted, null, DataProtectionScope.CurrentUser);
|
|
|
+ return Encoding.UTF8.GetString(decrypted);
|
|
|
+ }
|
|
|
+ catch (CryptographicException)
|
|
|
+ {
|
|
|
+ return null;
|
|
|
+ }
|
|
|
+ }
|
|
|
+
|
|
|
+ public static void Clear()
|
|
|
+ {
|
|
|
+ if (File.Exists(_path)) File.Delete(_path);
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 3：运行测试验证通过**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet test tests/XafPet.Desktop.Tests --filter "FullyQualifiedName~TokenStoreTests" -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：PASS — 3/3 通过。
|
|
|
+
|
|
|
+- [ ] **步骤 4：创建 SettingsWindow**
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/SettingsWindow.xaml`：
|
|
|
+
|
|
|
+```xml
|
|
|
+<Window x:Class="XafPet.Desktop.SettingsWindow"
|
|
|
+ xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"
|
|
|
+ xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"
|
|
|
+ Title="浠艾福桌面宠物 - 设置"
|
|
|
+ Width="360" Height="340"
|
|
|
+ WindowStartupLocation="CenterScreen">
|
|
|
+ <StackPanel Margin="20">
|
|
|
+ <TextBlock Text="后端地址" FontWeight="SemiBold" Margin="0,0,0,6"/>
|
|
|
+ <TextBox x:Name="BaseUrlBox" Text="http://localhost:9082" Padding="6"/>
|
|
|
+
|
|
|
+ <TextBlock Text="JWT Token" FontWeight="SemiBold" Margin="0,16,0,6"/>
|
|
|
+ <PasswordBox x:Name="TokenBox" Padding="6"/>
|
|
|
+
|
|
|
+ <TextBlock Text="宠物形象" FontWeight="SemiBold" Margin="0,16,0,6"/>
|
|
|
+ <ComboBox x:Name="PetCombo" Padding="6" MinWidth="120"/>
|
|
|
+
|
|
|
+ <Button Content="保存" Click="OnSaveClick" Margin="0,24,0,0" Padding="10,6"
|
|
|
+ HorizontalAlignment="Right" Width="100"/>
|
|
|
+ </StackPanel>
|
|
|
+</Window>
|
|
|
+```
|
|
|
+
|
|
|
+`cfc-desktop-pet/src/XafPet.Desktop/SettingsWindow.xaml.cs`：
|
|
|
+
|
|
|
+```csharp
|
|
|
+using System.IO;
|
|
|
+using System.Text.Json;
|
|
|
+using System.Windows;
|
|
|
+using XafPet.Desktop.PetEngine;
|
|
|
+
|
|
|
+namespace XafPet.Desktop;
|
|
|
+
|
|
|
+public partial class SettingsWindow : Window
|
|
|
+{
|
|
|
+ public SettingsWindow(string? currentToken, string currentBaseUrl)
|
|
|
+ {
|
|
|
+ InitializeComponent();
|
|
|
+ BaseUrlBox.Text = currentBaseUrl;
|
|
|
+ if (!string.IsNullOrEmpty(currentToken)) TokenBox.Password = currentToken;
|
|
|
+ LoadPets();
|
|
|
+ }
|
|
|
+
|
|
|
+ private void LoadPets()
|
|
|
+ {
|
|
|
+ var dirs = new List<string>();
|
|
|
+ var builtin = Path.Combine(AppContext.BaseDirectory, "DefaultPets");
|
|
|
+ if (Directory.Exists(builtin)) dirs.AddRange(Directory.GetDirectories(builtin));
|
|
|
+ var userDir = Path.Combine(
|
|
|
+ Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData),
|
|
|
+ "XafPet", "pets");
|
|
|
+ if (Directory.Exists(userDir)) dirs.AddRange(Directory.GetDirectories(userDir));
|
|
|
+
|
|
|
+ foreach (var d in dirs)
|
|
|
+ {
|
|
|
+ if (File.Exists(Path.Combine(d, "pet-config.json")))
|
|
|
+ PetCombo.Items.Add(Path.GetFileName(d));
|
|
|
+ }
|
|
|
+ if (PetCombo.Items.Count > 0) PetCombo.SelectedIndex = 0;
|
|
|
+ }
|
|
|
+
|
|
|
+ public string BaseUrl => BaseUrlBox.Text.Trim();
|
|
|
+ public string? Token => TokenBox.Password.Length > 0 ? TokenBox.Password : null;
|
|
|
+
|
|
|
+ private void OnSaveClick(object sender, RoutedEventArgs e)
|
|
|
+ {
|
|
|
+ DialogResult = true;
|
|
|
+ Close();
|
|
|
+ }
|
|
|
+}
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：编译验证**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet build XafPet.Desktop.sln
|
|
|
+```
|
|
|
+
|
|
|
+预期：`Build succeeded`。
|
|
|
+
|
|
|
+- [ ] **步骤 6：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: Token 存储 + 设置窗口"
|
|
|
+```
|
|
|
+
|
|
|
+## 任务 10：端到端集成验证 + 发布打包
|
|
|
+
|
|
|
+**文件：**
|
|
|
+- 修改：`cfc-desktop-pet/src/XafPet.Desktop/XafPet.Desktop.csproj`（发布配置）
|
|
|
+- 创建：`cfc-desktop-pet/README.md`
|
|
|
+
|
|
|
+- [ ] **步骤 1：添加发布配置（单文件 exe，Self-Contained）**
|
|
|
+
|
|
|
+在 `XafPet.Desktop.csproj` 追加：
|
|
|
+
|
|
|
+```xml
|
|
|
+ <PropertyGroup>
|
|
|
+ <PublishSingleFile>true</PublishSingleFile>
|
|
|
+ <SelfContained>true</SelfContained>
|
|
|
+ <RuntimeIdentifier>win-x64</RuntimeIdentifier>
|
|
|
+ <IncludeNativeLibrariesForSelfExtract>true</IncludeNativeLibrariesForSelfExtract>
|
|
|
+ </PropertyGroup>
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 2：完整构建 + 运行所有测试**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet build XafPet.Desktop.sln -c Release
|
|
|
+dotnet test tests/XafPet.Desktop.Tests -c Release -v
|
|
|
+```
|
|
|
+
|
|
|
+预期：全部测试 PASS，0 构建错误。
|
|
|
+
|
|
|
+- [ ] **步骤 3：发布 exe**
|
|
|
+
|
|
|
+```bash
|
|
|
+cd cfc-desktop-pet
|
|
|
+dotnet publish src/XafPet.Desktop/XafPet.Desktop.csproj -c Release -r win-x64 --self-contained true
|
|
|
+```
|
|
|
+
|
|
|
+预期：输出位于 `src/XafPet.Desktop/bin/Release/net6.0-windows/win-x64/publish/XafPet.Desktop.exe`。
|
|
|
+
|
|
|
+- [ ] **步骤 4：编写 README**
|
|
|
+
|
|
|
+`cfc-desktop-pet/README.md`：
|
|
|
+
|
|
|
+```markdown
|
|
|
+# 浠艾福桌面宠物 (XafPet.Desktop)
|
|
|
+
|
|
|
+Windows 桌面宠物应用，实时反映 CFC 健康陪跑状态。
|
|
|
+
|
|
|
+## 功能
|
|
|
+
|
|
|
+- 显示今日任务进度 / 五维能量 / 健康打卡状态
|
|
|
+- 喝水提醒互动（点击宠物确认打卡）
|
|
|
+- 支持浠宝/福宝及自定义形象（PNG + pet-config.json）
|
|
|
+- 支持用户自定义状态（custom_state_1 ~ custom_state_10）
|
|
|
+
|
|
|
+## 使用
|
|
|
+
|
|
|
+1. 发布：`dotnet publish src/XafPet.Desktop/XafPet.Desktop.csproj -c Release -r win-x64`
|
|
|
+2. 运行 `XafPet.Desktop.exe`
|
|
|
+3. 首次启动 → 右键托盘图标 → 设置 → 填入后端地址 + JWT Token
|
|
|
+4. 宠物出现在桌面右下角，可拖拽移动
|
|
|
+
|
|
|
+## 自定义宠物
|
|
|
+
|
|
|
+1. 在 `%APPDATA%\XafPet\pets\<名称>\` 放置 `standing.png` + `pet-config.json`
|
|
|
+2. 重启应用，设置中选择形象
|
|
|
+
|
|
|
+## 开发
|
|
|
+
|
|
|
+```bash
|
|
|
+dotnet build XafPet.Desktop.sln
|
|
|
+dotnet test tests/XafPet.Desktop.Tests
|
|
|
+```
|
|
|
+```
|
|
|
+
|
|
|
+- [ ] **步骤 5：Commit**
|
|
|
+
|
|
|
+```bash
|
|
|
+git add cfc-desktop-pet/
|
|
|
+git commit -m "feat: 桌面宠物 v1.0 完成 (发布配置 + README)"
|
|
|
+```
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 自检清单
|
|
|
+
|
|
|
+| 规格章节 | 对应任务 | 状态 |
|
|
|
+|---------|---------|------|
|
|
|
+| 二、系统架构（WPF+WebView2） | 任务 1, 6 | ✅ |
|
|
|
+| 三、数据流（API→状态映射） | 任务 3, 4, 8 | ✅ |
|
|
|
+| 四、形象配置 JSON Schema | 任务 2, 5 | ✅ |
|
|
|
+| 五、交互规则与动作库 | 任务 7（CSS 动画 + JS 状态机） | ✅ |
|
|
|
+| 六.1 拖拽与置顶 | 任务 1（DragMove + Topmost） | ✅ |
|
|
|
+| 六.2 五维能量可视化 | 任务 7（颜色联动待增强） | ⚠️ 部分 |
|
|
|
+| 六.3 声音策略 | 任务 7（sounds 已定义，播放器待扩展） | ⚠️ 部分 |
|
|
|
+| 六.4 游戏模式 | 未覆盖 | ⚠️ 缺失（v1.1 迭代） |
|
|
|
+| 用户自定义状态 | 任务 2（PetConfig.CustomStateCount）+ 任务 7（setCustomState） | ✅ |
|
|
|
+| 顽皮行为（偷图标/吃文档） | 未覆盖 | ⚠️ 缺失（v1.1 迭代） |
|
|
|
+
|
|
|
+**类型一致性检查：**
|
|
|
+- `PetState` 枚举 → `StateManager.StateToCamelCase` → JS `setState` ✅
|
|
|
+- `PetConfig.Parse(json)` → `PetHost.LoadPetConfig()` → JS `loadConfig` ✅
|
|
|
+- `ApiClient.PostAsync<T>` → `ApiResult<T>` → `IsSuccess` ✅
|
|
|
+- `WebViewHost.NotifyState/SetCustomState/ShowBubble/LoadPetConfig` — 命名一致 ✅
|
|
|
+- `CfcHostBridge.onInteract` ↔ `interactions.js` `chrome.webview.hostObjects.sync.cfcHost.onInteract` ✅
|
|
|
+
|
|
|
+**占位符扫描：** 无 "待定"/"TODO"/"后续实现"。注释 `"TODO: 任务9"` 已随任务 9 实现移除。
|
|
|
+
|
|
|
+---
|
|
|
+
|
|
|
+## 执行交接
|
|
|
+
|
|
|
+计划已完成并保存到 `docs/superpowers/plans/2026-10-10-desktop-pet.md`。
|
|
|
+
|
|
|
+两种执行方式：
|
|
|
+
|
|
|
+**1. 子代理驱动（推荐）** — 每个任务调度一个新的子代理，任务间进行审查，快速迭代
|
|
|
+
|
|
|
+**2. 内联执行** — 在当前会话中使用 executing-plans 执行任务，批量执行并设有检查点
|
|
|
+
|
|
|
+选哪种方式？
|
