rhdh-local

RHDH 本地

自行执行本地操作，并将证据返回给调用工作流。所有命令 均使用此技能的独立 CLI；无需安装其他技能。

能力检查

1. 运行 uv run scripts/rhdh-local --help。
2. 通过 RHDH_LOCAL_SETUP_DIR 定位 rhdh-local-setup，或从 当前目录逐级向上查找。运行 uv run scripts/rhdh-local --json status。
3. 如果缺少设置目录，说明所需的环境变量或检出目录结构，然后仅停止运行时分支。
4. 绝不将 .env 中的机密读入对话上下文。只询问缺少的变量名，并让容器运行时读取其值。

按结果选择路径

结果	加载并遵循
在覆盖分支或标签中读取插件版本或制品	运行 python3 scripts/fetch-plugin-metadata.py <plugin-name> --branch <branch-or-tag> --json；默认引用为 main，无需运行时设置
启用目录或 PR 制品	workflows/enable-plugin.md
禁用插件	workflows/disable-plugin.md
切换原始／自定义模式	workflows/switch-mode.md
端到端验证插件	workflows/test-plugin.md 和 references/dynamic-plugin-testing.md
检查状态或已启用的软件包	运行 uv run scripts/rhdh-local --json status 或 uv run scripts/rhdh-local --json plugins list
应用自定义项	运行 uv run scripts/rhdh-local --json apply
启动或停止	运行 uv run scripts/rhdh-local --json up [flags] 或 uv run scripts/rhdh-local --json down
检查健康状态	运行 uv run scripts/rhdh-local --json health
备份或还原	运行 uv run scripts/rhdh-local --json backup 或 uv run scripts/rhdh-local restore <archive>；还原在指定 --force 前为试运行
排查启动、网络或 504 问题	references/troubleshooting.md
配置环境变量	references/env-reference.md

不变要求

• 仅编辑 rhdh-customizations/ 下的源文件。每次编辑后都运行 apply，以保持 rhdh-local/ 下的副本同步。
• 启用 Lightspeed 或 Orchestrator 时，使用此 CLI 的 up 和 down 命令； 它们负责管理 compose 生命周期和共享网络。
• 从 spec.dynamicArtifact 或调用者提供的引用中获取软件包引用。绝不根据命名约定构造 OCI 引用。
• 保留动态插件覆盖配置中的 includes: 块。将后端软件包放在前端软件包之前。
• 只有在记录了与请求相关的安装、启动、健康状态和 UI 结果后，插件测试才算成功。区分预期的凭据错误与加载失败。

调用者提供的内容

调用者通过名称调用此技能，并在对话中说明：

• 要启用的每个软件包引用，以及对应的插件配置或 none
• 插件所需的环境变量，仅提供变量名
• 插件要渲染的目录测试实体
• 要运行的检查：安装、启动、健康状态、UI
• 之后是否需要清理

原样使用这些引用。缺少引用时应询问，不要根据命名约定自行构造。

此技能报告的内容

在对话中向调用者报告。不要写入其他技能的目录。

• 测试对象及运行模式：自定义或原始
• 每项所请求检查各占一行——安装、启动、健康状态、UI——注明通过、失败，或跳过及跳过原因
• 实际启用的软件包及其准确引用
• 支持各项结果的日志摘录
• 清理状态：已完成、保留或未请求

完成条件

报告必须列出每个已更改的源自定义文件、运行的每条 CLI 命令、观察到的健康状态和 UI 证据、清理状态，以及调用者请求的每项检查结果。