fix 注释+设备密码脱敏

Src/Dlhis.Basic/Device/Services/IDevicePermissionManuallyService.cs

@@ -3,39 +3,51 @@ using Dlhis.Basic.Device.Response;
 using Kurisu.AspNetCore.DataAccess.Dto;
 
 namespace Dlhis.Basic.Device.Services;
-
 /// <summary>
-/// 例外人员权限分配
+/// 例外人员权限分配服务接口，定义了对设备权限进行手动分配、查询及清理的相关操作。
 /// </summary>
 public interface IDevicePermissionManuallyService : IScopeDependency
 {
     /// <summary>
-    /// 获取例外分配分页
+    /// 获取例外分配的分页数据。
     /// </summary>
-    /// <param name="requestDto"></param>
-    /// <returns></returns>
+    /// <param name="requestDto">分页及筛选请求参数。</param>
+    /// <returns>包含例外分配信息的分页结果。</returns>
     Task<Pagination<DevicePermissionManuallyResponse>> GetPageAsync(DevicePermissionManuallyRequest requestDto);
 
     /// <summary>
-    /// 添加例外
+    /// 添加新的例外分配记录。
     /// </summary>
-    /// <param name="request"></param>
-    /// <returns></returns>
+    /// <param name="request">例外分配添加请求参数。</param>
+    /// <returns>异步操作任务。</returns>
     Task AddAsync(DevicePermissionManuallyAddRequest request);
 
     /// <summary>
-    /// 删除例外
+    /// 根据主键删除指定的例外分配记录。
     /// </summary>
-    /// <param name="id"></param>
-    /// <returns></returns>
+    /// <param name="id">要删除的记录主键ID。</param>
+    /// <returns>异步操作任务。</returns>
     Task DeleteAsync(long id);
 
     /// <summary>
-    /// 批量删除
+    /// 批量删除例外分配记录。
     /// </summary>
-    /// <param name="ids"></param>
-    /// <returns></returns>
+    /// <param name="ids">要删除的记录主键ID集合。</param>
+    /// <returns>异步操作任务。</returns>
     Task DeleteAsync(List<long> ids);
 
+    /// <summary>
+    /// 清除指定用户的所有设备例外权限。
+    /// </summary>
+    /// <param name="userNo">用户编号。</param>
+    /// <returns>异步操作任务。</returns>
+    Task ClearUserDeviceManuallyPermissionsAsync(string userNo);
+
+    /// <summary>
+    /// 清除指定工厂下指定用户的所有设备权限。
+    /// </summary>
+    /// <param name="factory">工厂编码。</param>
+    /// <param name="userCode">用户编码。</param>
+    /// <returns>异步操作任务。</returns>
     Task ClearAllDevicePermissions(string factory, string userCode);
 }