feat: 完成云同步、语音控制与多平台扩展基础架构搭建
本次提交完成了项目核心基础架构升级: 1. 新增动态API中间件与权限控制系统,支持匿名/鉴权接口分离 2. 搭建云同步服务体系,包含认证、任务同步、安全策略等核心模块 3. 实现语音控制全链路,从STT/意图解析到命令执行 4. 新增任务类型、附件实体与相关仓储接口 5. 重构前端配置与代理规则,统一后端端口为5057 6. 新增多平台测试项目与CI脚本优化 7. 完善项目文档与代码注释规范 移除了旧版迁移文件与冗余代理配置,调整项目结构适配跨平台部署需求。
This commit is contained in:
@@ -41,7 +41,10 @@ Hua.Todo/
|
||||
│ ├── Hua.Todo.Maui/ # MAUI 客户端(Windows/macOS/Android/iOS)
|
||||
│ ├── Hua.Todo.Avalonia/ # Avalonia 客户端(Linux/Windows 桌面)
|
||||
│ ├── Hua.Todo.Web/ # Vue 3 前端(Vite)
|
||||
│ └── Hua.Todo.Tests/ # 单元测试与集成测试
|
||||
│ └── test/ # 测试项目
|
||||
│ ├── Hua.Todo.Host.Tests/ # Host 服务端测试
|
||||
│ ├── Hua.Todo.Maui.Tests/ # MAUI 客户端测试
|
||||
│ └── Hua.Todo.Avalonia.Tests/ # Avalonia 客户端测试
|
||||
├── docs/
|
||||
│ ├── manual/ # 项目手册
|
||||
│ ├── project/ # 产品需求文档与研发工单
|
||||
|
||||
@@ -103,9 +103,10 @@ Hua.Todo/
|
||||
│ │ ├── tsconfig.json
|
||||
│ │ └── index.html
|
||||
│ │
|
||||
│ └── Hua.Todo.Tests/ # 测试项目
|
||||
│ ├── Unit/
|
||||
│ └── Integration/
|
||||
│ └── test/ # 测试项目
|
||||
│ ├── Hua.Todo.Host.Tests/ # Host 服务端测试
|
||||
│ ├── Hua.Todo.Maui.Tests/ # MAUI 客户端测试
|
||||
│ └── Hua.Todo.Avalonia.Tests/ # Avalonia 客户端测试
|
||||
│
|
||||
├── publish.ps1 / publish-windows.ps1 / publish-linux.ps1
|
||||
├── Directory.Build.props
|
||||
|
||||
@@ -14,9 +14,11 @@
|
||||
|
||||
### 2.2 注释规范 (强制)
|
||||
- **公共 API 必须添加 XML 文档注释** (包括 `public` / `protected` 的类、接口、方法、属性)
|
||||
- ** summary**:一句话说明用途
|
||||
- ** param / returns**:关键参数/返回值说明
|
||||
- ** 异常或副作用**:在 summary 中明确说明(例如会注册系统钩子/会启动后台服务)
|
||||
- **summary**:一句话说明用途,不允许重复嵌套 `<summary>` 标签
|
||||
- **param / returns**:构造函数和方法的每个参数都必须有对应 `param`,包括可选参数、`logger` 等基础设施参数;有返回值时补充 `returns`
|
||||
- **异常或副作用**:在 summary 中明确说明(例如会注册系统钩子/会启动后台服务)
|
||||
- **XML 注释位置**:`///` 文档注释必须紧贴被说明的语言元素;若元素还有特性(如 `[AttributeUsage]`),顺序必须是 XML 注释、特性、类型/成员声明
|
||||
- **cref 使用**:`<see cref="..."/>` 只引用当前项目能解析的类型/成员;跨程序集或未引入命名空间时改用普通文本,避免 CS1574 警告
|
||||
- **复杂逻辑添加行内注释**
|
||||
- **禁止在日志或注释中输出密钥、Token、用户隐私信息**
|
||||
|
||||
@@ -92,10 +94,11 @@ using System.Threading.Tasks;
|
||||
// 2. 命名空间
|
||||
namespace Hua.Todo.Api.Services;
|
||||
|
||||
// 3. XML 文档注释
|
||||
// 3. XML 文档注释(必须位于特性和声明之前)
|
||||
/// <summary>
|
||||
/// 任务服务实现
|
||||
/// 任务服务实现。
|
||||
/// </summary>
|
||||
[SomeAttribute]
|
||||
public class TaskService : ITaskService
|
||||
{
|
||||
// 4. 私有字段
|
||||
|
||||
Reference in New Issue
Block a user