plugin-root-resolution

name	plugin-root-resolution
description	插件根目录定位协议。在命令执行前自动触发，确定 resource/、scripts/、references/ 等目录的绝对路径。

插件根目录定位协议

按以下优先级，命中即停：

优先级	来源	说明
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/...")）
• 文件缺失时直接跳过，不从其他路径补