1.MAUI Android可以正常显示

docs/manual/代码规范文档.md

@@ -1,4 +1,4 @@
-# Hua.Todo 代码规范文档 v1.1.0
+# Hua.Todo 代码规范文档 v1.2.8
 
 ## 1. 概述
 本文档定义 Hua.Todo 项目的代码规范，包括 C#、JavaScript/TypeScript、Vue.js 和其他相关技术的编码标准。遵循这些规范有助于提高代码质量、可读性和可维护性。
@@ -10,21 +10,29 @@
 - **避免缩写**: 除非是广泛认知的缩写（如 ID、URL、API）
 - **一致性**: 在整个项目中保持命名风格一致
 
-### 2.2 注释规范
-- **公共 API 必须添加 XML 文档注释**
+### 2.2 注释规范 (强制)
+- **公共 API 必须添加 XML 文档注释** (包括 `public` / `protected` 的类、接口、方法、属性)
+- ** summary**：一句话说明用途
+- ** param / returns**：关键参数/返回值说明
+- ** 异常或副作用**：在 summary 中明确说明（例如会注册系统钩子/会启动后台服务）
 - **复杂逻辑添加行内注释**
-- **避免注释显而易见的代码**
-- **保持注释与代码同步更新**
+- **禁止在日志或注释中输出密钥、Token、用户隐私信息**
 
 ### 2.3 代码格式化
-- **使用统一的代码格式化工具**
+- **使用统一的代码格式化工具** (VS / IDE 默认格式化)
 - **保持一致的缩进和空格**
 - **每行代码不超过 120 字符**
 - **文件末尾保留一个空行**
 
 ## 3. C# 代码规范
 
-### 3.1 命名规范
+### 3.1 跨平台逻辑规范
+- **禁止混写 `#if`**：禁止在同一文件内混写多个平台的大段 `#if` 实现。
+- **优先使用 partial/接口**：应优先使用 `partial` 类、接口与平台目录分离。
+- **说明平台差异**：平台分离后的公共入口处必须说明“平台差异在哪里、默认实现是什么、为什么这么做”。
+
+### 3.2 异步/后台任务
+- **必须说明启动时机、错误处理策略、是否需要 UI 线程、以及是否可并发/可重入**。
 
 #### 类和接口
 ```csharp