目标： 在运行 HarmonyOS Next 的华为 MateBook Pro 上侧载安装第三方应用程序。
注：本教程同样适用于在运行 HarmonyOS Next 的华为手机上侧载安装第三方应用程序。
所需准备
一台运行 HarmonyOS Next 的华为 MateBook Pro。
一台 Windows 电脑。
一根数据线：
USB-A to Type-C
或 Type-C to Type-C (确保能将两台电脑连接)。
网络连接：两台电脑需在同一局域网下（用于无线调试连接）。
步骤详解
第一步：鸿蒙 PC (MateBook Pro) 端设置 (启用开发者模式与调试)
连接设备： 使用数据线将鸿蒙 MateBook Pro 连接到 Windows 电脑。
打开设置： 在鸿蒙 PC 上，进入
设置。进入关于本机： 在设置中，找到并点击
关于本机或您的电脑型号。启用开发者模式：
在“关于本机”界面，找到
软件版本或HarmonyOS 版本。连续点击
软件版本/HarmonyOS 版本文字 5 次以上。系统会提示“您已处于开发者模式”或提示重启进入开发者模式。按提示重启电脑（如果需要）。
打开开发者选项：
重启后，回到
设置->系统->开发者选项(路径可能略有不同，在“系统和更新”或“隐私与安全”下查找)。启用 USB 调试：
在开发者选项中，找到
USB 调试，将其开启。首次开启时，可能会弹出提示（连接线后或稍后操作时），点击
允许。注意提示：系统可能提示“Matebook Pro 上的右上角的 Type-C 口可以进行调试”，确保使用正确的接口连接调试线。如果弹出“始终允许本机调试”选项，勾选并允许。
启用并记录无线调试信息：
在开发者选项中，找到
无线调试，将其开启。开启后，系统会显示一个 IP 地址和端口号（例如
192.168.x.x:xxxxx）。务必准确记下这个 IP 地址和端口号，后续在 Windows 端连接时必须用到。至此，鸿蒙 PC 端的准备工作完成。
第二步：Windows 电脑端操作 (使用小白调试助手)
获取工具和 HAP 包：
访问包含 HarmonyOS Next 可用 HAP 包的资源（如 GitHub 上的相关仓库，搜索 “HarmonyOS Next HAP”）。
下载小白调试助手：
在工具仓库中找到
小白调试助手或类似名称。点击
Latest(最新版本)。点击
Download下载其 Windows 版压缩包（.zip文件）。下载目标应用的 HAP 包（以 ClashBox 为例，你也可以使用自己已有的 .hap 文件）：
在应用仓库中找到
ClashBox。同样点击
Latest->Download下载其 HAP 包（.hap文件）。准备小白调试助手：
将下载的小白调试助手压缩包解压到一个非中文且无空格路径的文件夹。
进入解压后的文件夹，找到可执行文件。双击运行。根据 Windows SmartScreen 或安全软件提示（若有），选择
更多信息->仍要运行。登录华为开发者账号 (强烈推荐)：
在小白调试助手界面，找到登录入口（通常在界面顶部或设置中），点击
登录。使用您的华为开发者账号登录（登录时，您的华为手机可能会收到验证码，或在鸿蒙PC上验证）。
输入验证码，并在授权请求页面点击
允许。登录成功后，界面通常会显示您的账号昵称或ID。重要： 开发者账号签发的应用证书有效期通常为 6 个月，普通账号仅 14 天。为方便使用，建议申请华为开发者账号。
连接鸿蒙设备：
在小白调试助手主界面，找到
连接设备、添加设备或类似功能的按钮并点击。在弹出的连接窗口（通常是输入IP和端口的对话框）中：
输入您在鸿蒙 PC 上
无线调试功能中记录的 IP 地址。输入记录的 端口号。
点击
确定、连接或OK。连接成功：如果地址和端口输入正确，且鸿蒙 PC 的开发者选项已开启无线调试：
鸿蒙 PC 可能弹出调试请求（“允许调试？”），勾选“始终允许”并点击
允许。小白调试助手界面会显示“连接成功”或目标设备信息。
（若未弹出提示框但连接成功，也属正常）
第三步：安装第三方 HAP 包
选择 HAP 包：
确保设备已连接成功。
在小白调试助手界面，找到
选择 HAP、加载 HAP、安装应用或类似按钮（通常在文件菜单或主功能区）。点击该按钮，浏览文件系统，找到您下载好的目标 HAP 文件（如
ClashBox-xxx.hap），选中并点击打开。开始安装：
选择好 HAP 文件后，小白调试助手界面通常会激活
开始调试、安装或运行按钮。点击
开始调试或安装。等待安装完成：
小白调试助手会开始处理 HAP 包：进行签名、推送到设备并安装。
观察进度条或日志输出，耐心等待直至提示“安装成功”。
第四步：在鸿蒙 PC 上使用安装的应用
安装完成后，返回您的鸿蒙 MateBook Pro。
在桌面或
开始菜单中，查找您刚刚安装的应用图标（如ClashBox）。点击图标即可启动使用该应用。
常见问题处理
签名错误/证书问题：在小白调试助手内寻找 **
清理缓存、重置证书、重新登录** 或类似选项。执行后，重新登录开发者账号，再尝试安装。确保登录的是开发者账号。Java 环境报错：如果小白调试助手提示需要 Java 环境（如
java命令未找到），按照其提示点击安装，它会引导下载并安装所需的 Java Runtime Environment (JRE)。连接失败：
检查鸿蒙 PC 的
无线调试IP 和端口号是否变化（息屏、重启、网络切换可能导致变化），在开发者选项里重新确认并输入。确保两台电脑在同一局域网。
检查鸿蒙 PC 的 **
USB 调试和无线调试是否已开启**。尝试在鸿蒙 PC 的开发者选项中关闭再重新开启
无线调试，获取新的端口号。其他报错：查阅小白调试助手官方的使用说明或 GitHub 仓库的 Issue 区寻求解决方案。
在代码中添加“不跟踪”（No-Tracking）功能，以提高查询性能（避免实体状态跟踪）。
确保后续操作无需更新返回的实体（如没有 SaveChanges 操作）。
在条件（Where）、排序（OrderBy、OrderByDescending）、分页（Skip、Take）等之前添加 .AsNoTracking()，如：db.Table.AsNoTracking().Where(...).ToList()。
如果查询中包含导航属性，它们也会因主查询的不跟踪而保持不跟踪状态。
AsNoTracking() 适用于查询简单无嵌套关系，若查询包含 Include/ThenInclude，建议用 AsNoTrackingWithIdentityResolution() 代替，后者更适合处理树形结构或循环引用数据。
添加（Add/AddRange）、修改、删除（Remove/RemoveRange）等有 SaveChanges 操作的场景不能加 .AsNoTracking()。
查询时是否需要加 .AsNoTracking() 参考下表：
数据查询操作体系
├── 限定符 (Any, All) ✔️ 推荐
├── 聚合函数 (Count, Sum, Min, Max, Average) ❌ 不需要（但在分页逻辑中 Count 与 ToList 使用共同条件筛选时建议加）
├── 集合操作 (Distinct, Union) ⚠️ 推荐用于只读
├── 元素操作 (First, Single) ⚠️ 推荐用于只读
└── 即时执行操作 (ToList, ToArray, ToDictionary) ⚠️ 推荐用于只读
现象：
VS2022 的“管理 nuget 程序包”页面的“更新”和“已安装”选项卡无限循环加载刷新，状态栏一直循环显示“正在还原 NuGet 程序包”、“就绪”。点开来有很多“正在加载 IntelliSense 任务已成功完成”。我有很多解决方案和项目，只有其中一个出现上述情况。
解决方法：
点击“设置”，在“常规”页面点击“清除所有 NuGet 存储”。
打开 .csproj 项目文件，在 <PropertyGroup> 标签内添加：
<Version>
1.0.$([System.Math]::Floor($([System.DateTime]::Now.Subtract($([System.DateTime]::Parse('2000-01-01T00:00:00Z'))).TotalDays))).$([MSBuild]::Divide($([System.Math]::Floor($([System.DateTime]::Now.TimeOfDay.TotalSeconds))), 2))
</Version>最终生成的版本号示例： 1.0.9238.28518
其中，Major 与 Minor 是固定的，Build 是2000年1月1日至今的天数，Revision 是今天的秒数 / 2 所得的值。（为了防止数值超过 65535）
程序中获取版本号：
var version = Assembly.GetExecutingAssembly().GetName().Version!; // 当前类库
var version = Assembly.GetEntryAssembly()?.GetName().Version!; // 入口项目从版本号获取发布时间：
DateTime versionTime = new DateTime(2000, 1, 1).AddDays(version.Build).AddSeconds(version.Revision * 2);在解决方案资源管理器中找到 Properties/AssemblyInfo.cs 文件。该文件存放程序集版本信息。
修改版本号格式
将以下代码片段中的 AssemblyVersion 改为使用星号通配符（建议保留主版本和次版本号）：
[assembly: AssemblyVersion("1.0.*")] // 自动生成构建号和修订号 // [assembly: AssemblyFileVersion("1.0.0.0")] // 注释或删除此行关闭确定性构建
用文本编辑器打开 .csproj 项目文件，在 <PropertyGroup> 标签内添加：
<Deterministic>false</Deterministic>此设置允许 MSBuild 生成动态版本号。
最终生成的版本号示例： 1.0.9238.28518
其中，Major 与 Minor 是固定的，Build 是2000年1月1日至今的天数，Revision 是今天的秒数 / 2 所得的值。（为了防止数值超过 65535）
程序中获取版本号：
var version = Assembly.GetExecutingAssembly().GetName().Version;从版本号获取发布时间：
DateTime versionTime = new DateTime(2000, 1, 1).AddDays(version.Build).AddSeconds(version.Revision * 2);查看 .NET Core / .NET 5+ 实现自动版本号的方法
通常，我们在更新一条数据库记录时，EF 先取出这一条记录：
var log = DbContext.MyTable.Find(id);然后赋值字段并保存：
log.Result = "OK";
DbContext.SaveChanges();这样就会产生两次数据库查询。
我们尝试用 Attach 方法。
先创建一个仅包含主键的对象：
var log = new MyTable { Id = id };将对象附加到上下文：
DbContext.MyTable.Attach(log);然后更新需要更新的字段：
log.Result = "OK";
DbContext.SaveChanges();这样，能在保留其它字段值的前提下，减少一次数据库查询。
但是需要注意的是：
当某非 null 字段需要恢复默认值时，EF 会忽略这个更改。（可能会因 EF 版本等原因有不同的结论）
举个例子：
某记录有个 int 型字段 a，在数据库中这个记录的 a 的值为 1，但 C# 中 int 型的默认值为 0，所以当 Attach 附加这个对象后，如果重新设置 log.a 为 0，那么保存后 a 的值仍为 1。
还有一种写法，利用 ExecuteUpdate 方法：
var affectedRows = DbContext.MyTable
.Where(c => c.Id == id)
.ExecuteUpdate(setters => setters
.SetProperty(c => c.Result, "OK")
);返回匹配的行数。
这种写法不会遇到“恢复为默认值不生效”的问题，推荐使用。
Tea.TeaException:“code: 400, Specified parameter Version is not valid. request id: ”可能是 AlibabaCloud.OpenApiClient.Models.Config 的 Endpoint 配置错误。
Tea.TeaException:“code: 400, The parameter IpProtocol must be specified with case insensitive TCP, UDP, ICMP, GRE or All. request id: ”必须指定 Permissions 参数。参考文档
Tea.TeaException:“code: 403, User not authorized to operate on the specified resource, or this API doesn't support RAM. request id: ”前往 RAM 访问控制配置用户的权限。
Tea.TeaException:“code: 401, The specified security group is not authorized to operate. request id: ”没有权限操作当前安全组。或者检查安全组的实例 ID 是否正确。
本文不定期更新。
本文介绍 Token 认证和 HMAC 认证两种方式。
一、Token 接口认证方式
原理：
客户端使用账号密码等信息登录，服务器验证通过后生成一个 Token 发送给客户端。客户端在后续的请求中携带这个 Token，服务器通过验证 Token 来确认用户的身份和权限。
应用场景：移动应用、Web 应用（特别是 SPA）
优点：
无状态性，即服务器不需要存储用户的会话信息。
易于实现跨域认证。
缺点：
Token 可能被窃取，应使用 HTTPS、不暴露在 URL 中、使用 HttpOnly 的 Cookie、对 Session ID 进行验证、设置合理过期时间、对 Token 进行加密等措施加强防范。
二、HMAC 接口认证方式
原理：
客户端将消息M与密钥K连接起来，通过哈希函数计算得到 HMAC 值，发送给服务器。服务器收到请求后，使用相同的密钥和请求参数重新计算 HMAC 值，如果与客户端发送的签名一致，即是合法请求。
优点：
安全性较高，攻击者很难伪造 HMAC 值，截获并篡改数据也无法通过服务端验证。
计算效率较高，哈希函数（如 MD5、SHA-1、SHA-256 等）计算效率比较高。
缺点：
密钥的更新和管理比较麻烦。
扩展：
在消息体中添加时间戳以防止重放攻击。
加密隐私数据：可以使用对称加密算法（如 AES）或非对称加密算法（如 RSA、ECC 等）对部分隐私数据进行加密。非对称算法虽然更安全，但速度较慢，如需加密大量数据，可以考虑使用对称加密算法进行加密，然后使用非对称加密算法对对称密钥进行加密。
以下列出本人所遇到的情况及处理方法，肯定不全，但都有用。
使用系统自带清理工具进行清理
Windows 7 / 8 / 8.1 / 10：在 C 盘上点击右键属性 - 磁盘清理 - 清理系统文件 - 视情况勾选 - 确定
Windows 11：在 C 盘上点击右键属性 - 详细信息 - 临时文件 - 视情况勾选 - 确定
关闭“传递优化”
设置 - Windowx 更新 - 高级选项 - 传递优化，关闭“允许从其他设备下载”
其实前面说到的清理临时文件中已经包含了“传递优化文件”，所以这里按个人喜好选择是否关闭。
更改虚拟内存路径
可以将虚拟内存路径更改为非系统盘，但建议是固态硬盘。
关闭系统还原
当遇到系统问题时，如果你喜欢重装系统，而不是系统还原，那么可以关闭它。
更改桌面、文档、下载等用户文件夹的位置
将这些目录路径更改到非系统，但仍然建议是固态硬盘。以 Windows 11 的桌面目录为例：
打开资源管理器 - 主文件夹，右键点击“桌面”属性，切换到“位置”，移动。
将软件安装到其它盘
有些电脑管理软件有软件迁移功能，但我还是建议先卸载软件，再安装到其它盘符。
将软件文档路径更改到其它盘
如果不想把软件安装到其它盘（譬如只有C盘是固态硬盘），那么可以将文档路径更改到其它盘，譬如：
微信：☰ - 设置 - 文件管理 - 更改
QQ：☰ - 设置 - 存储管理 - 更改存储路径（注意是聊天消息那个）
企业微信：头像 - 设置 - 存储管理
钉钉：头像 - 设置与隐私 - 通用 - 缓存目录
千牛：设置 - 数据存储文件夹
清理浏览器缓存
Chrome：┇ - 设置 - 隐私与安全 - 删除浏览数据
Edge：… - 设置 - 隐私、搜索和服务 - 删除浏览记录 - 选择要清除的内容
Firefox：☰ - 设置 - 隐私与安全 - 历史记录 - 清除历史记录
VMware 虚拟机
在已安装的镜像上点击右键 - 管理 - 清理磁盘
把已安装的镜像复制到其它磁盘，再添加到 VMware 中，删除原镜像文件。
更改 Navicat 数据库备份目录
如果你的 Navicat 启用了自动运行的备份任务，那么可以更改备份路径。
在连接上点击右键编辑连接，切换到高级，更改设置位置。
SQL Server 数据库文件瘦身
若 SQL Server 数据目录（C:\Program Files\Microsoft SQL Server\MSSQL16.MSSQLSERVER\MSSQL\DATA）中有很多较大的数据库日志文件（.ldf），可以按需采取以下措施：
使用 SSMS 连接到你的 SQL Server 实例；数据库恢复模式设置为“简单”；右键点击要压缩的数据库，选择“任务”->“收缩”->“文件”，选择“日志”，在“释放未使用的空间前重新组织页”一项中设置为 0MB，然后点击“确定”按钮。
最后推荐一款免费软件 TreeSize Free，可以查看磁盘中各目录和文件占用空间大小，小白不要乱删文件哦，删错了可就得重装系统了。
http {
...
lua_shared_dict cpu_cache 1m; # 定义共享字典用于缓存 CPU 使用率
access_by_lua_block {
local cpu_cache = ngx.shared.cpu_cache
local cache_time = cpu_cache:get("cache_time") or 0
local current_time = ngx.now()
if current_time - cache_time > 5 then -- 每 5 秒更新一次
local cpu_info = io.popen("top -bn1 | grep 'Cpu(s)'"):read("*all")
local cpu_usage = cpu_info:match("(%d+%.%d+) id") -- 获取空闲 CPU 百分比
local cpu_used = 100 - tonumber(cpu_usage) -- 计算使用率
cpu_cache:set("cpu_usage", cpu_used)
cpu_cache:set("cache_time", current_time)
end
local cpu_usage = cpu_cache:get("cpu_usage")
ngx.log(ngx.INFO, "CPU 使用率: " .. cpu_usage .. "%")
-- 将 cpu_usage 发送到远程鉴权接口，可根据服务器压力来决定是否拒绝一些不重要的请求
}
}代码解析：
共享字典：使用 lua_shared_dict 定义一个共享字典 cpu_cache，用于存储 CPU 使用率和缓存时间。
获取 CPU 使用率：在 access_by_lua_block 中，检查缓存时间，如果超过 5 秒，则重新获取 CPU 使用率，并更新共享字典。
记录日志：使用 ngx.log 将 CPU 使用率记录到 Nginx 日志中。
注意事项：
确保 Nginx 配置中已经加载了 Lua 模块（如 ngx_http_lua_module）。
根据实际需求调整缓存时间，以平衡性能和数据的实时性。
尝试过使用 ifconfig 或 ip 命令获取网卡流量，在宝塔面板中失败了，怀疑是权限问题，有空再研究。临时方案是鉴权接口定时调用宝塔面板 API 或阿里云控制台 API 来获取 ECS 的 CPU 和带宽使用率。