feat: 完善嵌入式应用 PC 端调试技能

references/build-workflow.md

@@ -7,7 +7,7 @@
 | 项目 | 默认值 |
 |---|---|
 | SSH Host | `emb.eapil.com` |
-| 工程根目录 | `/CamTells` |
+| 工程搜索根 | 当前远程工作区、`~/work/develop/gitcode`、实际挂载点；`/CamTells` 仅作兼容候选 |
 | Public 来源 | `~/work/develop/gitcode/EMX2.1` |
 | 本地归档根目录 | `F:\tmp\embedded-app-pc-debug` |
 
@@ -16,9 +16,10 @@
 ## 工程定位
 
 1. 先用现有 SSH/VS Code 配置解析 Host，不猜测用户名、端口或私钥路径。
-2. 将用户给出的项目名视为 `/CamTells` 下的相对路径并精确匹配。
-3. 如果有多个候选，列出远程绝对路径等待选择；不要凭目录修改时间挑选。
-4. 确认工程目录包含待用脚本，再确定真实命令行参数。
+2. 优先使用用户给出的绝对路径。只给项目名时，从 VS Code 最近工作区、`~/work/develop/gitcode`、`/CamTells` 和实际挂载点按目录名精确搜索；搜索深度至少覆盖从用户目录起 12 层，并为每个根设置独立合理超时。
+3. PowerShell 调用远端 Shell 时，避免让本地提前展开远端 `$HOME` 等变量。记录每个搜索根的退出码并明确区分：没有匹配、无权访问、路径未挂载、命令不存在和搜索超时。超时不等于项目不存在。
+4. 如果有多个候选，列出远程绝对路径等待选择；不要凭目录修改时间挑选。
+5. 确认工程目录包含待用脚本，再确定真实命令行参数。类似 `product/CamTells/EPM21C` 的深层产品目录不能因浅层 `find -maxdepth` 被排除。
 
 ## 构建顺序