dsh-hmos-sidebar

配置

lib/environment.js 统一解析 cli / DevEco Studio / hdc / hvigor / json5 / 工程根，优先级 config → 环境变量 → 常见安装位置探测，每次调用实时解析（不缓存，安装/变更路径后无需重启）。全部字段可省略。

字段	说明	缺省行为（探测源）
cliPath	deveco-cli 入口（dist/cli.js）	环境变量 DEVECO_CLI_PATH → %APPDATA%\npm\node_modules\@deveco\deveco-cli\dist\cli.js 等常见位置
projectPath	Host 默认鸿蒙工程根	环境变量 PROJECT_PATH → Host 进程 cwd；Web 浮窗会优先传当前 GUI session 的 cwd
devEcoHome	DevEco Studio 安装目录	DEVECO_HOME → DEVECO_SDK_HOME 父目录 → 常见安装路径（C:\Program Files\Huawei\DevEco Studio 等）
projectRoots	当前工作区以外的附加工程发现根目录列表	默认空；Web 浮窗仍会有界递归扫描当前 GUI session 的 cwd
screenshotDir	截图默认保存目录	工程下 .dsh-screenshots → OS 临时目录 dsh-hmos-screenshots

包内不硬编码任何个人绝对路径。Web 浮窗通过官方 shell.overlay Slot 的 useSessions 标准属性取得当前 session cwd，并在首次挂载或切换会话时重新探测；若 cwd 是工程父目录，会跳过依赖/构建目录并进行有界递归查找。projectRoots 仅用于补充扫描当前工作区以外的位置。

双签名配置（dcli__configure_dual_signing）

dcli__configure_dual_signing 为工程根 build-profile.json5 合并 release（默认 default）与 debug 双签名、products 和模块 target 映射：

• 默认 apply=false，只校验材料并返回变更预览；apply=true 才写入。
• 写入前生成单份 build-profile.json5.dsh-backup，临时文件通过解析后再替换正式文件。
• .p12 / .p7b / .cer 必须存在且后缀正确；signAlg 固定为 SHA256withECDSA。
• 密码只写入目标配置，不在工具结果或错误中回显；备份同样包含签名配置，必须与正式文件按同等敏感级别保护且不得提交。
• 指定 modules 时为这些应用模块拆 release/debug targets；省略时优先处理 entry，其他模块复用现有 target 到两个 products。
• 当前版本写入时会把文件规范化为双引号、2 空格缩进；原始文本保存在备份中。