docs: 新增v1.3.0研发工单文档，清理旧文档引用

2026-06-15 23:24:02 +08:00
parent cf96c56bed
commit 2317c3c456
9 changed files with 345 additions and 1217 deletions
@@ -1,675 +0,0 @@
 # Hua.Todo 代码规范文档 v1.1.0
 ## 1. 概述
 本文档定义 Hua.Todo 项目的代码规范，包括 C#、JavaScript/TypeScript、Vue.js 和其他相关技术的编码标准。遵循这些规范有助于提高代码质量、可读性和可维护性。
 ## 2. 通用规范
 ### 2.1 命名约定
 - **使用有意义的名称**: 变量、函数、类名应清晰表达其用途
 - **避免缩写**: 除非是广泛认知的缩写（如 ID、URL、API）
 - **一致性**: 在整个项目中保持命名风格一致
 ### 2.2 注释规范
 - **公共 API 必须添加 XML 文档注释**
 - **复杂逻辑添加行内注释**
 - **避免注释显而易见的代码**
 - **保持注释与代码同步更新**
 ### 2.3 代码格式化
 - **使用统一的代码格式化工具**
 - **保持一致的缩进和空格**
 - **每行代码不超过 120 字符**
 - **文件末尾保留一个空行**
 ## 3. C# 代码规范
 ### 3.1 命名规范
 #### 类和接口
 ```csharp
 // 类名使用 PascalCase
 public class TaskService
 {
 }
 // 接口名使用 PascalCase，以 I 开头
 public interface ITaskService
 {
 }
 ```
 #### 方法和属性
 ```csharp
 // 方法名使用 PascalCase
 public Task<List<Task>> GetTasksAsync()
 {
 }
 // 属性名使用 PascalCase
 public string Title { get; set; }
 ```
 #### 变量和参数
 ```csharp
 // 私有字段使用 _camelCase
 private readonly ITaskRepository _taskRepository;
 // 局部变量使用 camelCase
 var taskList = await GetTasksAsync();
 // 方法参数使用 camelCase
 public void CreateTask(string title, TaskPriority priority)
 {
 }
 ```
 #### 常量
 ```csharp
 // 常量使用 PascalCase
 public const int MaxTaskTitleLength = 200;
 ```
 ### 3.2 代码组织
 #### 文件结构
 ```csharp
 // 1. using 语句（按字母顺序）
 using System;
 using System.Collections.Generic;
 using System.Threading.Tasks;
 // 2. 命名空间
 namespace Hua.Todo.Api.Services;
 // 3. XML 文档注释
 /// <summary>
 /// 任务服务实现
 /// </summary>
 public class TaskService : ITaskService
 {
    // 4. 私有字段
    private readonly ITaskRepository _taskRepository;
    // 5. 构造函数
    public TaskService(ITaskRepository taskRepository)
    {
        _taskRepository = taskRepository;
    }
    // 6. 公共方法
    public async Task<List<Task>> GetTasksAsync()
    {
        // 实现
    }
    // 7. 私有方法
    private bool ValidateTask(Task task)
    {
        // 实现
    }
 }
 ```
 #### 命名空间组织
 - 每个文件只包含一个命名空间
 - 命名空间结构应与目录结构一致
 - 使用 `.` 分隔层级
 ### 3.3 编码规范
 #### 异步编程
 ```csharp
 // 异步方法应以 Async 结尾
 public async Task<Task> GetTaskByIdAsync(int id)
 {
    return await _taskRepository.GetByIdAsync(id);
 }
 // 使用 await 而非 .Result 或 .Wait
 var task = await GetTaskByIdAsync(id);
 // 使用 ConfigureAwait(false) 在库代码中
 public async Task<List<Task>> GetTasksAsync()
 {
    return await _taskRepository.GetAllAsync().ConfigureAwait(false);
 }
 ```
 #### 依赖注入
 ```csharp
 // 优先使用构造函数注入
 public class TaskService : ITaskService
 {
    private readonly ITaskRepository _taskRepository;
    private readonly ILogger<TaskService> _logger;
    public TaskService(ITaskRepository taskRepository, ILogger<TaskService> logger)
    {
        _taskRepository = taskRepository;
        _logger = logger;
    }
 }
 ```
 #### 异常处理
 ```csharp
 // 使用具体的异常类型
 public async Task<Task> GetTaskByIdAsync(int id)
 {
    var task = await _taskRepository.GetByIdAsync(id);
    if (task == null)
    {
        throw new NotFoundException($"Task with id {id} not found");
    }
    return task;
 }
 // 使用 using 语句管理资源
 using var context = new TodoDbContext();
 ```
 #### LINQ 使用
 ```csharp
 // 优先使用方法语法
 var completedTasks = tasks.Where(t => t.IsCompleted).ToList();
 // 复杂查询使用查询语法
 var query = from task in tasks
            where task.IsCompleted
            orderby task.CreatedAt descending
            select task;
 ```
 ### 3.4 文档注释
 ```csharp
 /// <summary>
 /// 获取指定 ID 的任务
 /// </summary>
 /// <param name="id">任务 ID</param>
 /// <returns>任务对象</returns>
 /// <exception cref="NotFoundException">当任务不存在时抛出</exception>
 public async Task<Task> GetTaskByIdAsync(int id)
 {
    // 实现
 }
 ```
 ## 4. JavaScript/TypeScript 代码规范
 ### 4.1 命名规范
 #### 变量和函数
 ```typescript
 // 变量使用 camelCase
 const taskList = [];
 let currentTask = null;
 // 函数使用 camelCase
 function getTasks() {
  // 实现
 }
 // 常量使用 UPPER_SNAKE_CASE
 const MAX_TASK_TITLE_LENGTH = 200;
 ```
 #### 类和接口
 ```typescript
 // 类名使用 PascalCase
 class TaskService {
  // 实现
 }
 // 接口名使用 PascalCase
 interface Task {
  id: number;
  title: string;
 }
 // 类型别名使用 PascalCase
 type TaskPriority = 'high' | 'medium' | 'low';
 ```
 ### 4.2 代码组织
 #### 文件结构
 ```typescript
 // 1. 导入语句
 import { ref, computed } from 'vue';
 import { useTaskStore } from '@/stores/tasks';
 import type { Task } from '@/types/task';
 // 2. 类型定义
 interface TaskForm {
  title: string;
  priority: TaskPriority;
 }
 // 3. 常量定义
 const DEFAULT_PRIORITY: TaskPriority = 'medium';
 // 4. 组合式函数或组件
 export function useTasks() {
  // 实现
 }
 ```
 #### 模块导入
 ```typescript
 // 优先使用 ES6 模块语法
 import { ref } from 'vue';
 import axios from 'axios';
 // 导出使用具名导出
 export function useTasks() {
  // 实现
 }
 export default useTasks;
 ```
 ### 4.3 TypeScript 规范
 #### 类型定义
 ```typescript
 // 为所有函数参数和返回值添加类型
 function getTaskById(id: number): Task | null {
  // 实现
 }
 // 使用接口定义对象类型
 interface Task {
  id: number;
  title: string;
  priority: TaskPriority;
  isCompleted: boolean;
  createdAt: Date;
 }
 // 使用类型别名定义联合类型
 type TaskPriority = 'high' | 'medium' | 'low';
 // 使用泛型提高代码复用性
 interface ApiResponse<T> {
  data: T;
  message: string;
 }
 ```
 #### 类型断言
 ```typescript
 // 优先使用类型守卫而非类型断言
 function isTask(obj: unknown): obj is Task {
  return typeof obj === 'object' && obj !== null && 'id' in obj;
 }
 // 避免使用 as any
 const task = response.data as Task; // 避免
 ```
 ### 4.4 异步编程
 ```typescript
 // 使用 async/await 而非 Promise 链
 async function getTasks(): Promise<Task[]> {
  const response = await axios.get('/api/tasks');
  return response.data;
 }
 // 错误处理
 try {
  const tasks = await getTasks();
 } catch (error) {
  console.error('Failed to fetch tasks:', error);
 }
 ```
 ## 5. Vue.js 代码规范
 ### 5.1 组件命名
 ```vue
 <!-- 组件名使用 PascalCase -->
 <script setup lang="ts">
 // 组件名应与文件名一致
 </script>
 <template>
  <!-- 模板中使用 kebab-case -->
  <task-item :task="task" />
 </template>
 ```
 ### 5.2 组件结构
 ```vue
 <template>
  <!-- 1. 模板 -->
  <div class="task-list">
    <task-item
      v-for="task in tasks"
      :key="task.id"
      :task="task"
    />
  </div>
 </template>
 <script setup lang="ts">
 // 2. 导入
 import { ref, computed } from 'vue';
 import { useTaskStore } from '@/stores/tasks';
 import TaskItem from './TaskItem.vue';
 // 3. Props 定义
 interface Props {
  filter: 'all' | 'active' | 'completed';
 }
 const props = withDefaults(defineProps<Props>(), {
  filter: 'all'
 });
 // 4. Emits 定义
 const emit = defineEmits<{
  (e: 'task-created', task: Task): void;
 }>();
 // 5. 响应式状态
 const taskStore = useTaskStore();
 const tasks = computed(() => taskStore.filteredTasks(props.filter));
 // 6. 方法
 const handleCreateTask = async (title: string) => {
  const task = await taskStore.createTask(title);
  emit('task-created', task);
 };
 </script>
 <style scoped>
 /* 6. 样式 */
 .task-list {
  padding: 16px;
 }
 </style>
 ```
 ### 5.3 组合式函数规范
 ```typescript
 // composables/useTasks.ts
 import { ref, computed } from 'vue';
 import { useTaskStore } from '@/stores/tasks';
 export function useTasks() {
  const taskStore = useTaskStore();
  const loading = ref(false);
  const error = ref<string | null>(null);
  const tasks = computed(() => taskStore.tasks);
  const completedTasks = computed(() => taskStore.completedTasks);
  const fetchTasks = async () => {
    loading.value = true;
    error.value = null;
    try {
      await taskStore.fetchTasks();
    } catch (err) {
      error.value = 'Failed to fetch tasks';
      console.error(err);
    } finally {
      loading.value = false;
    }
  };
  return {
    tasks,
    completedTasks,
    loading,
    error,
    fetchTasks
  };
 }
 ```
 ### 5.4 状态管理规范
 ```typescript
 // stores/tasks.ts
 import { defineStore } from 'pinia';
 import { ref, computed } from 'vue';
 import type { Task } from '@/types/task';
 export const useTaskStore = defineStore('tasks', () => {
  // State
  const tasks = ref<Task[]>([]);
  const loading = ref(false);
  const error = ref<string | null>(null);
  // Getters
  const activeTasks = computed(() => 
    tasks.value.filter(task => !task.isCompleted)
  );
  const completedTasks = computed(() => 
    tasks.value.filter(task => task.isCompleted)
  );
  // Actions
  async function fetchTasks() {
    loading.value = true;
    try {
      const response = await fetch('/api/tasks');
      tasks.value = await response.json();
    } catch (err) {
      error.value = 'Failed to fetch tasks';
    } finally {
      loading.value = false;
    }
  }
  return {
    tasks,
    loading,
    error,
    activeTasks,
    completedTasks,
    fetchTasks
  };
 });
 ```
 ## 6. API 设计规范
 ### 6.1 RESTful API 设计
 ```csharp
 // 使用名词复数形式
 [HttpGet("tasks")]
 public async Task<ActionResult<List<Task>>> GetTasks()
 {
 }
 // 使用资源 ID
 [HttpGet("tasks/{id}")]
 public async Task<ActionResult<Task>> GetTask(int id)
 {
 }
 // 使用 HTTP 方法表示操作
 [HttpPost("tasks")]
 public async Task<ActionResult<Task>> CreateTask(CreateTaskDto dto)
 {
 }
 [HttpPut("tasks/{id}")]
 public async Task<ActionResult<Task>> UpdateTask(int id, UpdateTaskDto dto)
 {
 }
 [HttpDelete("tasks/{id}")]
 public async Task<ActionResult> DeleteTask(int id)
 {
 }
 ```
 ### 6.2 响应格式
 ```csharp
 // 统一的响应格式
 public class ApiResponse<T>
 {
    public bool Success { get; set; }
    public T Data { get; set; }
    public string Message { get; set; }
    public List<string> Errors { get; set; }
 }
 // 成功响应
 return Ok(new ApiResponse<Task>
 {
    Success = true,
    Data = task,
    Message = "Task created successfully"
 });
 // 错误响应
 return BadRequest(new ApiResponse<object>
 {
    Success = false,
    Message = "Validation failed",
    Errors = new List<string> { "Title is required" }
 });
 ```
 ## 7. Git 提交规范
 ### 7.1 提交信息格式
 ```
 <type>(<scope>): <subject>
 <body>
 <footer>
 ```
 ### 7.2 Type 类型
 - `feat`: 新功能
 - `fix`: 修复 bug
 - `docs`: 文档更新
 - `style`: 代码格式调整（不影响代码运行）
 - `refactor`: 重构（既不是新功能也不是修复 bug）
 - `perf`: 性能优化
 - `test`: 测试相关
 - `chore`: 构建过程或辅助工具的变动
 ### 7.3 示例
 ```
 feat(api): add task completion endpoint
 - Add PATCH /api/tasks/{id}/complete endpoint
 - Update task service to handle completion logic
 - Add unit tests for completion functionality
 Closes #123
 ```
 ## 8. 测试规范
 ### 8.1 单元测试
 ```csharp
 // 测试类命名: ClassName + Tests
 public class TaskServiceTests
 {
    [Fact]
    public async Task GetTasksAsync_ReturnsAllTasks()
    {
        // Arrange
        var mockRepository = new Mock<ITaskRepository>();
        var service = new TaskService(mockRepository.Object);
        // Act
        var result = await service.GetTasksAsync();
        // Assert
        Assert.NotNull(result);
        Assert.Equal(3, result.Count);
    }
 }
 ```
 ### 8.2 集成测试
 ```csharp
 public class ApiIntegrationTests : IClassFixture<WebApplicationFactory<Program>>
 {
    private readonly HttpClient _client;
    public ApiIntegrationTests(WebApplicationFactory<Program> factory)
    {
        _client = factory.CreateClient();
    }
    [Fact]
    public async Task GetTasks_ReturnsSuccessAndCorrectContentType()
    {
        // Act
        var response = await _client.GetAsync("/api/tasks");
        // Assert
        response.EnsureSuccessStatusCode();
        Assert.Equal("application/json", response.Content.Headers.ContentType?.MediaType);
    }
 }
 ```
 ## 9. 代码审查清单
 ### 9.1 代码质量
 - [ ] 代码符合项目规范
 - [ ] 变量和函数命名清晰
 - [ ] 没有重复代码
 - [ ] 复杂逻辑有注释说明
 - [ ] 没有硬编码的魔法数字
 ### 9.2 功能正确性
 - [ ] 功能实现符合需求
 - [ ] 边界条件已处理
 - [ ] 错误处理完善
 - [ ] 有相应的单元测试
 ### 9.3 性能和安全
 - [ ] 没有性能问题
 - [ ] 敏感数据已保护
 - [ ] 输入验证完善
 - [ ] 没有安全漏洞
 ## 10. 工具配置
 ### 10.1 C# 工具
 - **代码格式化**: dotnet format
 - **代码分析**: Roslyn Analyzers
 - **代码风格**: .editorconfig
 - **文档生成**: DocFX
 ### 10.2 JavaScript/TypeScript 工具
 - **代码格式化**: Prettier
 - **代码检查**: ESLint
 - **类型检查**: TypeScript
 - **代码风格**: .prettierrc
 ### 10.3 .editorconfig 示例
 ```ini
 root = true
 [*.cs]
 indent_style = space
 indent_size = 4
 end_of_line = crlf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 [*.{js,ts,vue}]
 indent_style = space
 indent_size = 2
 end_of_line = lf
 charset = utf-8
 trim_trailing_whitespace = true
 insert_final_newline = true
 ```
@@ -1,19 +0,0 @@
 # 其他信息
 ## 🤝 贡献指南
 1. Fork 项目
 2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
 3. 提交更改 (`git commit -m 'Add some AmazingFeature'`)
 4. 推送到分支 (`git push origin feature/AmazingFeature`)
 5. 打开 Pull Request
 ## 📄 许可证
 本项目采用 AGPL-3.0 许可证 - 查看 [LICENSE](LICENSE) (英文) 或 [LICENSE.zh-CN](LICENSE.zh-CN) (中文) 文件了解详情
 ## 📞 联系方式
 - 项目作者：ShaoHua
 - 项目地址：https://git.we965.cn/Tools/Hua.Todo
 - QQ 交流群：2167048911 (Hua.Todo 交流群)
@@ -1,39 +0,0 @@
 # 技术栈与模块说明
 ## 🛠️ 技术栈
 ### 后端技术栈
 - **开发语言**：C# 10
 - **框架**：.NET 10
 - **UI 框架**：MAUI (Multi-platform App UI)
 - **Web 服务器**：Kestrel (ASP.NET Core 内置)
 - **API 框架**：ASP.NET Core Web API
 - **数据访问**：Entity Framework Core
 - **数据库**：SQLite (本地存储)
 - **依赖注入**：Microsoft.Extensions.DependencyInjection
 ### 前端技术栈
 - **开发语言**：TypeScript
 - **框架**：Vue.js 3
 - **构建工具**：Vite
 - **HTTP 客户端**：Axios
 - **状态管理**：Pinia
 - **UI 组件库**：Element Plus / Vant (移动端)
 - **CSS 预处理器**：SCSS
 ## 🎯 核心模块说明
 ### Hua.Todo.Core
 领域实体层，定义核心实体（TaskEntity）、枚举（TaskPriority）以及仓储接口（ITaskRepository）。
 ### Hua.Todo.Application
 应用层实现，包含业务逻辑、动态 API 生成逻辑、EF Core 数据库上下文以及具体的服务实现（TaskService）。
 ### Hua.Todo.Host
 后端 API 宿主，提供运行环境和配置，是后端服务的启动入口。
 ### Hua.Todo.Web
 前端 Web 项目，基于 Vue.js 3 + TypeScript + Vite，提供用户界面，通过 HTTP API 与后端通信。
 ### Hua.Todo.Maui
 跨平台客户端项目，将 Web 内容嵌入到原生容器中，支持 Windows、Android、iOS 和 macOS。
@@ -1,356 +0,0 @@
 # Hua.Todo 技术设计文档 v1.1.0
 ## 1. 项目概述
 本文档描述 Hua.Todo v1.1.0 的技术设计方案，包括项目文件目录结构、模块划分、技术选型和实现细节。
 ## 2. 技术栈
 ### 2.1 后端技术栈
 - **开发语言**: C# 10
 - **框架**: .NET 10
 - **UI 框架**: MAUI (Multi-platform App UI)
 - **Web 服务器**: Kestrel (ASP.NET Core 内置)
 - **API 框架**: ASP.NET Core Web API
 - **数据访问**: Entity Framework Core
 - **数据库**: SQLite (本地存储)
 - **日志**: Serilog
 - **依赖注入**: Microsoft.Extensions.DependencyInjection
 ### 2.2 前端技术栈
 - **开发语言**: JavaScript/TypeScript
 - **框架**: Vue.js 3
 - **构建工具**: Vite
 - **HTTP 客户端**: Axios
 - **状态管理**: Pinia
 - **UI 组件库**: Element Plus / Vant (移动端)
 - **CSS 预处理器**: SCSS
 ## 3. 项目目录结构
 ```
 Hua.Todo/
 ├── docs/                              # 文档目录
 │   ├── manual/                        # 用户/开发者手册
 │   │   ├── 技术栈与模块.md
 │   │   ├── 版本记录.md
 │   │   ├── 技术设计文档.md（本文件）
 │   │   └── 代码规范文档.md
 │   └── project/                       # 项目进度/需求文档
 │       ├── 产品需求文档.md
 │       └── ...
 │
 ├── src/                               # 源代码目录
 │   ├── Hua.Todo.Maui/                 # MAUI 主项目（跨平台入口）
 │   │   ├── Platforms/                 # 平台特定代码
 │   │   │   ├── Windows/               # Windows 平台代码
 │   │   │   │   ├── App.xaml           # Windows 应用入口
 │   │   │   │   └── Services/          # Windows 平台服务
 │   │   │   │       └── HotKeyService.cs
 │   │   │   ├── MacCatalyst/           # macOS 平台代码
 │   │   │   │   ├── App.xaml
 │   │   │   │   └── Services/
 │   │   │   │       └── HotKeyService.cs
 │   │   │   ├── Android/               # Android 平台代码
 │   │   │   │   ├── MainActivity.cs
 │   │   │   │   └── Services/
 │   │   │   │       └── NotificationService.cs
 │   │   │   └── iOS/                   # iOS 平台代码
 │   │   │       ├── AppDelegate.cs
 │   │   │       └── Services/
 │   │   │           └── NotificationService.cs
 │   │   ├── Resources/                 # 资源文件
 │   │   │   ├── Images/                # 图片资源
 │   │   │   ├── Styles/                # 样式资源
 │   │   │   └── Fonts/                 # 字体资源
 │   │   ├── Controls/                  # 自定义控件
 │   │   │   └── WebViewContainer.xaml
 │   │   ├── Services/                  # 服务层
 │   │   │   ├── IHotKeyService.cs
 │   │   │   ├── IPlatformService.cs
 │   │   │   └── AppLifecycleService.cs
 │   │   ├── App.xaml                   # MAUI 应用入口
 │   │   ├── App.xaml.cs
 │   │   ├── MauiProgram.cs             # MAUI 程序配置
 │   │   └── Hua.Todo.Maui.csproj       # MAUI 项目文件
 │   │
 │   ├── Hua.Todo.Api/                  # 后端 API 项目
 │   │   ├── Controllers/               # API 控制器
 │   │   │   ├── TasksController.cs
 │   │   │   ├── SettingsController.cs
 │   │   │   └── SyncController.cs
 │   │   ├── Models/                    # 数据模型
 │   │   │   ├── Task.cs
 │   │   │   ├── TaskDto.cs
 │   │   │   └── ApiResponse.cs
 │   │   ├── Services/                  # 业务服务
 │   │   │   ├── ITaskService.cs
 │   │   │   ├── TaskService.cs
 │   │   │   ├── ISyncService.cs
 │   │   │   └── SyncService.cs
 │   │   ├── Data/                      # 数据访问层
 │   │   │   ├── TodoDbContext.cs
 │   │   │   ├── Repositories/
 │   │   │   │   ├── ITaskRepository.cs
 │   │   │   │   └── TaskRepository.cs
 │   │   │   └── Migrations/            # 数据库迁移
 │   │   ├── Middleware/                # 中间件
 │   │   │   └── ExceptionMiddleware.cs
 │   │   ├── Extensions/                # 扩展方法
 │   │   │   └── ServiceCollectionExtensions.cs
 │   │   ├── Program.cs                 # API 入口
 │   │   ├── appsettings.json           # 配置文件
 │   │   └── Hua.Todo.Api.csproj        # API 项目文件
 │   │
 │   ├── Hua.Todo.Core/                 # 核心业务逻辑层
 │   │   ├── Entities/                  # 实体类
 │   │   │   ├── Task.cs
 │   │   │   └── TaskPriority.cs
 │   │   ├── Interfaces/                # 接口定义
 │   │   │   ├── ITaskRepository.cs
 │   │   │   └── IUnitOfWork.cs
 │   │   ├── ValueObjects/              # 值对象
 │   │   │   └── TaskTitle.cs
 │   │   ├── Specifications/            # 规范模式
 │   │   │   └── TaskSpecifications.cs
 │   │   └── Hua.Todo.Core.csproj       # Core 项目文件
 │   │
 │   ├── Hua.Todo.Web/                  # 前端 Web 项目 (Vue.js)
 │   │   ├── public/                    # 静态资源
 │   │   │   └── index.html
 │   │   ├── src/                       # 源代码
 │   │   │   ├── api/                   # API 调用
 │   │   │   │   ├── client.ts         # HTTP 客户端配置
 │   │   │   │   ├── tasks.ts          # 任务相关 API
 │   │   │   │   └── settings.ts       # 设置相关 API
 │   │   │   ├── assets/                # 资源文件
 │   │   │   │   ├── images/
 │   │   │   │   └── styles/
 │   │   │   ├── components/            # Vue 组件
 │   │   │   │   ├── TaskList.vue
 │   │   │   │   ├── TaskItem.vue
 │   │   │   │   ├── QuickEntry.vue
 │   │   │   │   └── Settings.vue
 │   │   │   ├── composables/           # 组合式函数
 │   │   │   │   ├── useTasks.ts
 │   │   │   │   └── useHotKey.ts
 │   │   │   ├── stores/                # 状态管理 (Pinia)
 │   │   │   │   ├── tasks.ts
 │   │   │   │   └── settings.ts
 │   │   │   ├── types/                 # TypeScript 类型定义
 │   │   │   │   ├── task.ts
 │   │   │   │   └── api.ts
 │   │   │   ├── utils/                 # 工具函数
 │   │   │   │   ├── date.ts
 │   │   │   │   └── storage.ts
 │   │   │   ├── App.vue                # 根组件
 │   │   │   └── main.ts                # 应用入口
 │   │   ├── package.json               # 依赖配置
 │   │   ├── vite.config.ts             # Vite 配置
 │   │   ├── tsconfig.json              # TypeScript 配置
 │   │   └── index.html                 # HTML 模板
 │   │
 │   └── Hua.Todo.Tests/                # 测试项目
 │       ├── Unit/                      # 单元测试
 │       │   ├── Services/
 │       │   │   └── TaskServiceTests.cs
 │       │   └── Controllers/
 │       │       └── TasksControllerTests.cs
 │       ├── Integration/               # 集成测试
 │       │   └── ApiIntegrationTests.cs
 │       └── Hua.Todo.Tests.csproj
 │
 ├── .gitignore                         # Git 忽略文件
 ├── Hua.Todo.sln                       # 解决方案文件
 └── README.md                          # 项目说明文档
 ```
 ## 4. 模块设计
 ### 4.1 MAUI 主项目 (Hua.Todo.Maui)
 **职责**: 
 - 应用程序入口和生命周期管理
 - 平台特定功能封装
 - WebView 容器管理
 - 本地 HTTP 服务器启动
 **关键组件**:
 - `MauiProgram.cs`: 配置 MAUI 应用和依赖注入
 - `App.xaml.cs`: 应用程序主入口
 - `WebViewContainer`: 封装 WebView 控件
 - 平台特定服务: 快捷键、通知等
 ### 4.2 后端 API 项目 (Hua.Todo.Api)
 **职责**:
 - 提供 RESTful API 接口
 - 业务逻辑处理
 - 数据访问和持久化
 - 本地 HTTP 服务器托管
 **关键组件**:
 - `Controllers`: API 端点实现
 - `Services`: 业务逻辑服务
 - `Data`: 数据访问层和数据库上下文
 - `Program.cs`: API 服务器配置和启动
 ### 4.3 核心业务层 (Hua.Todo.Core)
 **职责**:
 - 定义领域模型和业务规则
 - 提供核心业务接口
 - 实现领域驱动设计模式
 **关键组件**:
 - `Entities`: 领域实体
 - `Interfaces`: 业务接口定义
 - `ValueObjects`: 值对象
 - `Specifications`: 业务规范
 ### 4.4 前端 Web 项目 (Hua.Todo.Web)
 **职责**:
 - 用户界面展示
 - 用户交互处理
 - HTTP API 调用
 - 状态管理
 **关键组件**:
 - `components`: Vue 组件
 - `api`: API 调用封装
 - `stores`: 状态管理
 - `composables`: 组合式函数
 ## 5. HTTP API 设计
 ### 5.1 API 基础配置
 - **基础 URL**: `http://localhost:5000/api`
 - **数据格式**: JSON
 - **认证方式**: 暂无（本地应用）
 - **跨域配置**: 允许本地跨域请求
 ### 5.2 API 端点设计
 #### 任务管理 API
 ```
 GET    /api/tasks              # 获取任务列表
 GET    /api/tasks/{id}         # 获取单个任务
 POST   /api/tasks              # 创建任务
 PUT    /api/tasks/{id}         # 更新任务
 DELETE /api/tasks/{id}         # 删除任务
 PATCH  /api/tasks/{id}/complete # 标记任务完成
 ```
 #### 设置管理 API
 ```
 GET    /api/settings          # 获取设置
 PUT    /api/settings          # 更新设置
 ```
 #### 同步 API
 ```
 POST   /api/sync/pull         # 拉取远程数据
 POST   /api/sync/push         # 推送本地数据
 ```
 ## 6. 数据库设计
 ### 6.1 数据库表结构
 #### Tasks 表
 ```sql
 CREATE TABLE Tasks (
    Id INTEGER PRIMARY KEY AUTOINCREMENT,
    Title TEXT NOT NULL,
    Priority INTEGER NOT NULL DEFAULT 0,
    IsCompleted INTEGER NOT NULL DEFAULT 0,
    CreatedAt TEXT NOT NULL,
    UpdatedAt TEXT NOT NULL
 );
 ```
 #### Settings 表
 ```sql
 CREATE TABLE Settings (
    Key TEXT PRIMARY KEY,
    Value TEXT NOT NULL,
    UpdatedAt TEXT NOT NULL
 );
 ```
 ### 6.2 数据访问策略
 - 使用 Entity Framework Core 进行数据访问
 - 采用 Repository 模式封装数据访问
 - 支持 LINQ 查询和异步操作
 - 数据库迁移管理
 ## 7. 通信机制
 ### 7.1 HTTP 通信流程
 1. **C# 后端启动**: MAUI 应用启动时启动本地 Kestrel 服务器
 2. **Vue 前端加载**: WebView 加载 Vue 应用
 3. **API 调用**: Vue 通过 Axios 调用本地 HTTP API
 4. **数据处理**: C# 后端处理请求并返回 JSON 数据
 5. **界面更新**: Vue 接收响应并更新界面
 ### 7.2 错误处理
 - 统一的错误响应格式
 - 异常中间件捕获和处理
 - 前端错误提示和重试机制
 ## 8. 部署和打包
 ### 8.1 开发环境
 - **后端调试**: 使用 Visual Studio 调试 MAUI 应用
 - **前端调试**: 使用 Vite 开发服务器
 - **热重载**: 支持前后端热重载
 ### 8.2 生产构建
 - **前端构建**: `npm run build` 生成静态文件
 - **后端打包**: MAUI 发布各平台应用
 - **静态文件嵌入**: 将前端静态文件嵌入到 MAUI 应用中
 ### 8.3 平台特定配置
 - **Windows**: WebView2 运行时要求
 - **macOS**: 代码签名和公证
 - **移动端**: 应用商店发布配置
 - **Linux**: .NET MAUI 无官方 Linux 目标，需要引入独立桌面宿主（例如基于 WebKitGTK 的方案）并处理运行时依赖与打包格式
 ## 9. 性能优化
 ### 9.1 前端优化
 - 组件懒加载
 - 虚拟滚动（长列表）
 - 图片懒加载
 - 缓存策略
 ### 9.2 后端优化
 - 数据库查询优化
 - 响应缓存
 - 异步处理
 - 连接池管理
 ## 10. 安全考虑
 ### 10.1 本地安全
 - 本地服务器仅监听 localhost
 - 防止外部访问
 - 数据加密存储（可选）
 ### 10.2 数据安全
 - 数据库文件权限控制
 - 定期备份机制
 - 敏感数据保护
 ## 11. 测试策略
 ### 11.1 单元测试
 - 核心业务逻辑测试
 - 服务层测试
 - 工具函数测试
 ### 11.2 集成测试
 - API 集成测试
 - 数据库集成测试
 - 前后端集成测试
 ### 11.3 端到端测试
 - 跨平台功能测试
 - 用户流程测试
 - 性能测试
@@ -1,36 +0,0 @@
 # 版本更新历史
 ## 🔄 版本更新
 ### 版本策略
 - 采用语义化版本号：`MAJOR.MINOR.PATCH`
 - v1.0.0：初始 WPF 版本
 - v1.1.0：MAUI + WebView 跨平台版本
 - v1.2.0 (规划中)：Linux 支持与增强功能
 ### v1.1.1 (2026-04-06)
 - **文档规范增强**：新增文档同步规则，强制代码变更与文档更新保持同步。
 - **项目结构说明校准**：修正 README.md 和技术文档中对 `Hua.Todo.Host`、`Hua.Todo.Application` 等模块的路径与职责描述。
 - **端口配置校准**：修正文档中关于前端与后端 API 的端口说明（5173/5174）。
 - **PRD 校准**：移除 v1.2.0 PRD 中“本地迭代不支持”表述与“数据迁移（导入/导出）”小节。
 - **PRD 校准**：移除 v1.2.0 PRD 中“云同步”需求。
 ### v1.1.0 更新内容
 - 重构为 MAUI + WebView 架构
 - 实现跨平台支持 (Windows, macOS, Android, iOS)
 - 使用 HTTP API 进行前后端通信
 - 采用 Vue.js 3 作为前端框架
 - 使用 SQLite 作为本地数据库
 - 实现子任务支持
 ### v1.2.0 规划内容 (即将推出)
 - **Linux 官方支持**：正式适配 Linux 平台。
 - **关键词检索**：支持按任务标题关键词搜索。
 - **标签系统**：引入多标签支持，提升任务组织效率。
 - **暗色模式**：全平台适配暗色/深色主题。
 - **数据导出导入（后续）**：支持 JSON 格式数据备份与迁移（延期到后续版本）。
@@ -1,92 +0,0 @@
 # Android 端显示 “Not Found” 排查计划（Hua.Todo.Maui）
 ## 目标
 - 找出 Android 模拟器里只显示 `Not Found` 的根因（是 Web 资源缺失、内嵌 Web Server 路由/解析问题，还是 WebView 加载了错误地址）
 - 给出可验证的修复方案，并确保修复后能在 Android 上正常加载前端页面
 ## 背景（当前实现快速定位）
 - Android 使用自建 TCP HTTP Server，静态资源从 APK 的 `Assets/wwwroot/*` 读取：[MobileEmbeddedWebServerService](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/Platforms/Android/MobileEmbeddedWebServerService.cs)
 - WebView 默认加载内嵌服务器地址（`IsUsingStatic=true` 时）：[MainPage.xaml.cs](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/Views/MainPage.xaml.cs)
 - Android 端静态文件找不到时返回纯文本 `Not Found`：[HandleStaticAsync](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/Platforms/Android/MobileEmbeddedWebServerService.cs#L214-L255)
 ## 排查顺序（从“最可能 & 最省时间”到“深入原因”）
 ### 1) 确认 WebView 实际加载的 URL
 - 在 Android Debug 输出里确认 WebView Source（期望是 `http://localhost:5057` 或 `http://localhost:5057/`）
 - 如果不是内嵌地址，检查 `appsettings.json` 的 `WebServer.IsUsingStatic` 与 `ForEndUrl` 配置：[appsettings.json](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/appsettings.json)
 判定：
 - 若加载的是内嵌地址 → 继续第 2 步
 - 若加载的是外部地址（ForEndUrl）→ 重点查 ForEndUrl 对应服务是否启动/路由是否正确
 ### 2) 确认前端 dist 是否存在且可用于打包
 - 检查 `src/Hua.Todo.Web/dist/index.html` 是否存在
 - 如果不存在：在 `src/Hua.Todo.Web` 下执行 `npm ci` + `npm run build`，确保产物生成
 判定：
 - dist 不存在/为空 → “Not Found”高概率来自 Android 静态资源根本没被构建或没被打进 APK
 ### 3) 确认 Android APK 内是否真的包含 `Assets/wwwroot/index.html`
 - 重点验证打包结果是否存在：
  - `assets/wwwroot/index.html`
  - `assets/wwwroot/assets/*`（至少有 js/css）
 - 项目里通过 MSBuild 目标把 `Hua.Todo.Web/dist` 映射为 AndroidAsset（Link 到 `wwwroot/...`）：[Hua.Todo.Maui.csproj](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/Hua.Todo.Maui.csproj#L150-L175)
 判定：
 - APK 内没有 `wwwroot/index.html` → 修复构建/打包流程（第 6 步会给方案）
 - APK 内有 `wwwroot/index.html` → 继续第 4 步
 ### 4) 记录 Android 内嵌服务器的“收到的请求 Path”与“找不到的 assetPath”
 目的：判断是否是“请求行解析不兼容”或“路径格式异常”导致找不到资源。
 - 在 `ReadRequestAsync`、`HandleStaticAsync` 临时输出：
  - requestLine / target / path
  - 计算出的 assetPath
  - TryOpenAsset 失败的 assetPath
 高频根因候选：
 - WebView 请求行使用 absolute-form（例如 `GET http://localhost:5057/ HTTP/1.1`），当前解析逻辑会把整个 URL 当作 path，最终拼成无效 `wwwroothttp://...`，导致 404
 ### 5) 排除 WebView/网络限制类问题（只在必要时做）
 - 如果看到的不是纯文本 `Not Found`，而是加载错误/空白：
  - 检查 Android 明文 HTTP（`http://localhost`）是否被允许
  - 检查 `network_security_config.xml` 与 Manifest 配置：[network_security_config.xml](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/Platforms/Android/Resources/xml/network_security_config.xml)、[AndroidManifest.xml](file:///d:/Proj/Hua.Todo/src/Hua.Todo.Maui/Platforms/Android/AndroidManifest.xml)
 ### 6) 修复与验证（根据前面判定选择）
 #### A. 资源缺失/未打包
 - 让构建流程更“硬性”：
  - 若 dist 不存在则强制构建，或在 Debug 也保证 `AndroidAsset` 包含 dist
  - 可选：把 dist 复制进 `Hua.Todo.Maui/wwwroot` 再用 `<Content Include="wwwroot\**" />`/`<MauiAsset />` 统一打包（减少条件目标的不确定性）
 验证：
 - APK 内能看到 `assets/wwwroot/index.html`，启动后不再返回 `Not Found`
 #### B. 请求路径解析不兼容（absolute-form 等）
 - 改进 `ReadRequestAsync`：当 target 是 `http(s)://...` 时解析出其中的 Path + Query，再走现有逻辑
 验证：
 - 记录到的 path 变为 `/` 或 `/index.html`，能成功打开 `wwwroot/index.html`
 #### C. 资源引用路径问题（js/css 请求 404）
 - 检查 dist 中 `index.html` 对 `assets/*` 的引用路径是否与 AndroidAsset 的 Link 一致
 - 若 Vite 输出含子目录（例如 `assets/chunks/...`），需要在 csproj 里用 `dist\**\*` 并保留 `%(RecursiveDir)`，避免扁平化导致引用断裂
 验证：
 - WebView 网络请求里 js/css 全部 200，页面正常渲染
 ## 本次排查的“最短闭环”
 - 先确认 dist 是否存在 + APK 是否包含 `assets/wwwroot/index.html`
 - 若存在仍 Not Found，再用日志确认 requestLine/target/path 是否被解析成异常值（absolute-form 是最高优先级怀疑点）
@@ -0,0 +1,107 @@
 # 研发工单 v1.3.0 - 总览
 > 术语澄清：本文件中"研发工单"指智能体/开发者执行的**编码工作项**，与业务侧的 Todo 待办项无关。详见 [.trae/rules/全局/05-研发工单规则.md](../../../.trae/rules/全局/05-研发工单规则.md)。
 ---
 ## 一、背景与目标
 Hua.Todo v1.3.0 版本聚焦于两个核心能力的升级：
 | 序号 | 能力 | 描述 |
 |---|---|---|
 | 1 | **MCP 服务映射** | 将现有 HTTP 服务转换为 MCP（Model Context Protocol）服务，提升服务调用效率与可扩展性 |
 | 2 | **语音交互** | 实现语音通话数据传输与语音控制功能，支持通过语音指令操作 Todo 待办项 |
 ---
 ## 二、工单拆分
 ### 2.1 并行工单（可同步执行）
 | 工单编号 | 标题 | 负责人 | 状态 |
 |---|---|---|---|
 | 01 | HTTP 服务转换为 MCP 服务 | - | 待开始 |
 | 02 | 语音通话与语音控制功能 | - | 待开始 |
 ### 2.2 串行工单（依赖前置工单完成）
 当前版本暂无串行工单依赖。
 ---
 ## 三、各子工单摘要
 ### 3.1 工单 01 - HTTP 服务转换为 MCP 服务
 **目标**：基于 C# 现有映射框架，将 Hua.Todo 的 HTTP API 转换为 MCP 服务
 **核心需求**：
 - 将现有的 HTTP API 端点映射为 MCP 工具描述符
 - 生成符合 MCP 规范的契约文档
 - 验证 MCP 服务的可用性与正确性
 **验收标准**：
 - MCP 服务可正常对外提供接口
 - 所有原有 HTTP API 功能在 MCP 服务中可正常使用
 ### 3.2 工单 02 - 语音通话与语音控制功能
 **目标**：实现语音通话数据传输与语音控制功能
 **核心需求**：
 - 语音通话数据传输能力
 - 语音指令识别与解析
 - 语音控制 Todo 待办项操作（创建、编辑、删除、完成等）
 - 与现有业务系统对接
 **验收标准**：
 - 语音通话功能可正常使用
 - 语音控制可准确执行 Todo 业务操作
 ---
 ## 四、待验证表
 | 子工单 | 验证项 | 状态 | 备注 |
 |---|---|---|---|
 | 01 | MCP 服务契约文档生成 | 待验证 | - |
 | 01 | MCP 服务可用性测试 | 待验证 | - |
 | 01 | 原有 API 功能兼容性 | 待验证 | - |
 | 02 | 语音通话连接测试 | 待验证 | - |
 | 02 | 语音指令识别准确率 | 待验证 | - |
 | 02 | Todo 业务操作覆盖度 | 待验证 | - |
 ---
 ## 五、关键决策
 | 决策点 | 结论 |
 |---|---|
 | MCP 框架选择 | 使用 TRAE 平台内置的 MCP 服务框架 |
 | 语音识别方案 | 集成平台语音识别能力 |
 | 服务注册方式 | 遵循平台标准注册流程 |
 ---
 ## 六、依赖与前置条件
 | 依赖项 | 状态 | 来源 |
 |---|---|---|
 | TRAE MCP SDK | 已就绪 | 平台内置 |
 | 语音识别服务 | 已就绪 | 平台内置 |
 | Hua.Todo v1.2.0 | 已完成 | 上一版本 |
 ---
 ## 七、风险与回滚
 | 风险 | 影响 | 应对策略 |
 |---|---|---|
 | MCP 服务注册失败 | 无法对外提供服务 | 保留 HTTP API 作为降级方案 |
 | 语音识别准确率不足 | 用户体验下降 | 提供文字输入作为备选方案 |
 ---
 **创建日期**：2026-06-15
 **版本**：v1.3.0
@@ -0,0 +1,104 @@
 # 研发工单 v1.3.0 - 01 HTTP 服务转换为 MCP 服务
 ---
 ## 一、目标与范围
 ### 1.1 目标
 基于 C# 现有映射框架，将 Hua.Todo 的 HTTP API 转换为 MCP（Model Context Protocol）服务，提升服务调用效率与可扩展性。
 ### 1.2 范围
 **包含**：
 - 任务管理 API 的 MCP 映射
 - 云同步 API 的 MCP 映射
 - MCP 服务契约文档生成
 - MCP 服务可用性验证
 **不包含**：
 - 新增业务功能开发
 - 前端 UI 修改
 ---
 ## 二、前置条件
 | 条件 | 说明 |
 |---|---|
 | Hua.Todo v1.2.0 | 已完成，提供基础 HTTP API |
 | TRAE MCP SDK | 平台内置，已就绪 |
 | 现有 API 文档 | 参考 [README.md](../../../README.md) |
 ---
 ## 三、需求规格
 ### 3.1 MCP 服务描述符生成
 为以下 HTTP API 端点生成 MCP 工具描述符：
 #### 任务管理 API
 | HTTP 端点 | MCP 工具名 | 功能描述 |
 |---|---|---|
 | `GET /api/task` | `getTaskList` | 获取任务列表 |
 | `GET /api/task/{id}` | `getTaskById` | 获取单个任务 |
 | `POST /api/task` | `createTask` | 创建任务 |
 | `PUT /api/task` | `updateTask` | 更新任务 |
 | `PATCH /api/task/{id}/toggle` | `toggleTaskStatus` | 切换完成状态 |
 | `DELETE /api/task/{id}` | `deleteTask` | 删除任务 |
 | `GET /api/task/{parentTaskId}/subtasks` | `getSubtasks` | 获取子任务列表 |
 #### 云同步 API（Host 模式）
 | HTTP 端点 | MCP 工具名 | 功能描述 |
 |---|---|---|
 | `POST /auth/login` | `cloudLogin` | 用户登录 |
 | `POST /auth/logout` | `cloudLogout` | 用户注销 |
 | `GET /tasks/` | `getCloudTasks` | 获取云端任务 |
 | `POST /sync/` | `syncTasks` | 推送/拉取合并同步 |
 | `GET /security/policy` | `getSecurityPolicy` | 获取安全策略 |
 ### 3.2 契约文档生成
 生成符合 MCP 规范的 JSON 契约文档，包含：
 - 工具名称
 - 参数定义（名称、类型、是否必填）
 - 返回值定义
 - 错误处理说明
 ### 3.3 服务注册与验证
 - 按照平台标准流程注册 MCP 服务
 - 验证所有工具的调用可用性
 ---
 ## 四、验收标准
 | 验收项 | 验证方法 | 预期结果 |
 |---|---|---|
 | MCP 服务注册 | 检查服务列表 | 服务成功注册 |
 | 工具描述符生成 | 查看 JSON 输出 | 所有工具描述符生成完整 |
 | getTaskList | 调用工具 | 返回任务列表 |
 | createTask | 调用工具 | 创建成功，返回任务 ID |
 | updateTask | 调用工具 | 更新成功 |
 | deleteTask | 调用工具 | 删除成功 |
 | cloudLogin | 调用工具 | 登录成功，返回 Token |
 | syncTasks | 调用工具 | 同步成功 |
 ---
 ## 五、Touch List
 | 文件路径 | 修改类型 | 说明 |
 |---|---|---|
 | `src/Hua.Todo.Application/Mcp/` | 新增 | MCP 服务实现目录 |
 | `src/Hua.Todo.Application/Mcp/McpServiceCollectionExtensions.cs` | 新增 | MCP 服务注册扩展 |
 | `src/Hua.Todo.Application/Mcp/TaskMcpService.cs` | 新增 | 任务管理 MCP 服务 |
 | `src/Hua.Todo.Application/Mcp/CloudSyncMcpService.cs` | 新增 | 云同步 MCP 服务 |
 | `src/Hua.Todo.Application/Mcp/Models/` | 新增 | MCP DTO 模型 |
 ---
 **工单编号**：01
 **标题**：HTTP 服务转换为 MCP 服务
 **版本**：v1.3.0
@@ -0,0 +1,134 @@
 # 研发工单 v1.3.0 - 02 语音通话与语音控制功能
 ---
 ## 一、目标与范围
 ### 1.1 目标
 实现语音通话数据传输与语音控制功能，支持通过语音指令操作 Todo 待办项，提升用户交互体验。
 ### 1.2 范围
 **包含**：
 - 语音通话数据传输能力
 - 语音指令识别与解析
 - 语音控制 Todo 待办项操作
 - 与现有业务系统对接
 **不包含**：
 - 语音通话 UI 界面设计（仅提供能力层）
 - 第三方语音服务集成（使用平台内置能力）
 ---
 ## 二、前置条件
 | 条件 | 说明 |
 |---|---|
 | Hua.Todo v1.2.0 | 已完成，提供基础业务能力 |
 | 平台语音服务 | 已就绪 |
 | 工单 01（可选） | MCP 服务就绪后可通过 MCP 调用 |
 ---
 ## 三、需求规格
 ### 3.1 语音通话数据传输
 **功能描述**：支持语音通话数据的实时传输
 **接口设计**：
 ```
 工具名：startVoiceCall
 参数：
  - target: string - 通话目标标识
 返回：
  - callId: string - 通话 ID
  - status: string - 通话状态（connected/disconnected）
 ```
 ```
 工具名：endVoiceCall
 参数：
  - callId: string - 通话 ID
 返回：
  - success: boolean - 是否成功结束
 ```
 ### 3.2 语音指令控制
 **功能描述**：支持通过语音指令操作 Todo 待办项
 **支持的语音指令**：
 | 指令类型 | 示例指令 | 对应操作 |
 |---|---|---|
 | 创建任务 | "创建任务 开会" | 创建标题为"开会"的任务 |
 | 创建任务（带优先级） | "创建高优先级任务 提交报告" | 创建高优先级任务 |
 | 完成任务 | "完成任务 开会" | 标记任务"开会"为已完成 |
 | 删除任务 | "删除任务 开会" | 删除任务"开会" |
 | 更新任务 | "更新任务 开会 改为 团队会议" | 更新任务标题 |
 | 查询任务 | "查询未完成任务" | 获取未完成任务列表 |
 | 添加子任务 | "给任务开会添加子任务 准备PPT" | 为任务添加子任务 |
 **接口设计**：
 ```
 工具名：executeVoiceCommand
 参数：
  - command: string - 语音指令文本
 返回：
  - success: boolean - 是否执行成功
  - message: string - 执行结果描述
  - data: object - 返回数据（如任务列表）
 ```
 ### 3.3 语音状态管理
 **接口设计**：
 ```
 工具名：getVoiceStatus
 参数：无
 返回：
  - isListening: boolean - 是否正在监听
  - isSpeaking: boolean - 是否正在播报
 ```
 ```
 工具名：speakText
 参数：
  - text: string - 要播报的文本
 返回：
  - success: boolean - 是否成功
 ```
 ---
 ## 四、验收标准
 | 验收项 | 验证方法 | 预期结果 |
 |---|---|---|
 | 创建任务指令 | 说出"创建任务 测试" | 成功创建标题为"测试"的任务 |
 | 创建带优先级任务 | 说出"创建高优先级任务 紧急" | 成功创建高优先级任务 |
 | 完成任务指令 | 说出"完成任务 测试" | 任务状态变为已完成 |
 | 删除任务指令 | 说出"删除任务 测试" | 任务被成功删除 |
 | 查询任务指令 | 说出"查询未完成任务" | 返回未完成任务列表 |
 | 语音播报 | 调用 speakText | 成功播放指定文本 |
 | 语音通话 | 调用 startVoiceCall | 通话连接成功 |
 ---
 ## 五、Touch List
 | 文件路径 | 修改类型 | 说明 |
 |---|---|---|
 | `src/Hua.Todo.Application/Voice/` | 新增 | 语音服务目录 |
 | `src/Hua.Todo.Application/Voice/VoiceService.cs` | 新增 | 语音服务实现 |
 | `src/Hua.Todo.Application/Voice/VoiceCommandParser.cs` | 新增 | 语音指令解析器 |
 | `src/Hua.Todo.Application/Voice/Models/` | 新增 | 语音相关 DTO |
 | `src/Hua.Todo.Application/Voice/VoiceServiceCollectionExtensions.cs` | 新增 | 服务注册扩展 |
 ---
 **工单编号**：02
 **标题**：语音通话与语音控制功能
 **版本**：v1.3.0