zhizhunbao 插件根目录定位协议
按以下优先级，命中即停：
| 优先级 | 来源 | 说明 |
|---|---|---|
| 1 | YD_CODEBUDDY_PLUGIN_ROOT |
自定义/内测插件路径，优先使用 |
| 2 | CODEBUDDY_PLUGIN_ROOT |
官方插件路径 |
| 3 | 兜底 | ~/.codebuddy/plugins/marketplaces/codebuddy-plugins-official/plugins/security-scan/ |
定位步骤
不要一次性执行多行脚本（按以下顺序逐条执行单行命令，命中即停：
步骤 1：检查 YD_CODEBUDDY_PLUGIN_ROOT
echo "${YD_CODEBUDDY_PLUGIN_ROOT:-EMPTY}" && [ -d "${YD_CODEBUDDY_PLUGIN_ROOT:-/nonexistent}/resource" ] && echo "OK" || echo "SKIP"
- 输出路径 +
OK→plugin_root= 该路径，停止，不执行后续步骤 - 输出
SKIP→ 继续步骤 2
步骤 2：检查 CODEBUDDY_PLUGIN_ROOT
echo "${CODEBUDDY_PLUGIN_ROOT:-EMPTY}" && [ -d "${CODEBUDDY_PLUGIN_ROOT:-/nonexistent}/resource" ] && echo "OK" || echo "SKIP"
- 输出路径 +
OK→plugin_root= 该路径，停止 - 输出
SKIP→ 继续步骤 3
步骤 3：检查兜底路径
[ -d "$HOME/.codebuddy/plugins/marketplaces/codebuddy-plugins-official/plugins/security-scan/resource" ] && echo "$HOME/.codebuddy/plugins/marketplaces/codebuddy-plugins-official/plugins/security-scan OK" || echo "SKIP"
- 输出路径 +
OK→plugin_root= 该路径 - 输出
SKIP→ 三级都未命中，以无资源模式继续执行
定位结果处理
- OK → 记住
plugin_root，以下子目录可用：$plugin_root/resource/— 规则、配置等 YAML 资源$plugin_root/scripts/— 可执行脚本$plugin_root/references/— 编排器参考文档（orchestrator-rules、lsp-setup 等）
- WARN → 无插件资源可用，跳过所有需要
plugin_root的步骤，继续执行扫描
命令中出现的 references/xxx.md 引用，实际路径为 $plugin_root/references/xxx.md。
隔离规则
plugin_root 存在时：
- 所有插件内文件引用必须用
$plugin_root/...绝对路径前缀 - 禁止 Glob 搜索插件文件（如
glob("**/security-scan/...")） - 文件缺失时直接跳过，不从其他路径补