Relay Knowledge CLI — Relay Knowledge 命令行界面（CLI）

使用编译好的relay-knowledge二进制文件作为控制面。为了实现自动化，首选JSON输出，并在执行不熟悉的命令之前读取命令元数据： relay-knowledge help --format json relay-knowledge help repo query --format json

在第一次操作之前，通过在PATH中查找已发布的relay-knowledge二进制文件来解析可执行文件： command -v relay-knowledge relay-knowledge version --format json Get-Command relay-knowledge relay-knowledge version --format json where.exe relay-knowledge relay-knowledge version --format json

不要使用源代码检出构建的工件或源代码构建作为安装路径。此技能旨在仅操作已发布的安装。如果二进制文件缺失，请先从已发布的通道安装它：首选从GitHub Release存档中验证，或者在Cargo是所选的已发布包通道时使用cargo install relay-knowledge从crates.io安装。

不要从此技能启动或配置MCP。如果任务要求MCP、Streamable HTTP、资源、提示、会话或协议工具，请使用项目MCP文档或单独的MCP技能。

当用户要求进行测试、烟雾检查或重现时，不应影响现有的运行时状态，请设置一个显式的临时RELAY_KNOWLEDGE_HOME，并在场景之后清理它。对于隔离测试，首选本地确定性检索后端，以便烟雾检查不依赖于外部嵌入服务。

POSIX shell： export RELAY_KNOWLEDGE_HOME="$(mktemp -d /tmp/relay-knowledge-skill.XXXXXX)" export RELAY_KNOWLEDGE_SEMANTIC_BACKEND=local export RELAY_KNOWLEDGE_VECTOR_BACKEND=local

PowerShell： $env:RELAY_KNOWLEDGE_HOME = Join-Path $env:TEMP ("relay-knowledge-skill-" + [guid]::NewGuid()) New-Item -ItemType Directory -Path $env:RELAY_KNOWLEDGE_HOME | Out-Null $env:RELAY_KNOWLEDGE_SEMANTIC_BACKEND = "local" $env:RELAY_KNOWLEDGE_VECTOR_BACKEND = "local"

cmd.exe： set "RELAY_KNOWLEDGE_HOME=%TEMP%\relay-knowledge-skill-%RANDOM%-%RANDOM%" mkdir "%RELAY_KNOWLEDGE_HOME%" set "RELAY_KNOWLEDGE_SEMANTIC_BACKEND=local" set "RELAY_KNOWLEDGE_VECTOR_BACKEND=local"

如果每个命令在新shell或工具调用中运行，请在每个relay-knowledge调用中内联传递这些环境变量，而不是依赖于之前的导出来持久化。首选工具的环境映射，当它可用时。否则，选择一个临时的绝对路径用于场景，将其代入每个命令，并在同一命令调用中包含shell特定的赋值。

POSIX每个命令调用： mkdir -p /tmp/relay-knowledge-skill-example && \ RELAY_KNOWLEDGE_HOME=/tmp/relay-knowledge-skill-example \ RELAY_KNOWLEDGE_SEMANTIC_BACKEND=local \ RELAY_KNOWLEDGE_VECTOR_BACKEND=local \ relay-knowledge status --format json

PowerShell每个命令调用： $relayKnowledgeHome = Join-Path $env:TEMP "relay-knowledge-skill-example"; New-Item -ItemType Directory -Force -Path $relayKnowledgeHome | Out-Null; $env:RELAY_KNOWLEDGE_HOME = $relayKnowledgeHome; $env:RELAY_KNOWLEDGE_SEMANTIC_BACKEND = "local"; $env:RELAY_KNOWLEDGE_VECTOR_BACKEND = "local"; relay-knowledge status --format json

cmd.exe每个命令调用： if not exist "%TEMP%\relay-knowledge-skill-example" mkdir "%TEMP%\relay-knowledge-skill-example" && set "RELAY_KNOWLEDGE_HOME=%TEMP%\relay-knowledge-skill-example" && set "RELAY_KNOWLEDGE_SEMANTIC_BACKEND=local" && set "RELAY_KNOWLEDGE_VECTOR_BACKEND=local" && relay-knowledge status --format json

捕获测试结果后删除临时目录。

就绪检查 检查CLI是否存在，然后检查运行时配置和实时健康状况： command -v relay-knowledge relay-knowledge version relay-knowledge setup doctor --format json relay-knowledge health --format json relay-knowledge service doctor --format json

在Windows上，在PowerShell中使用Get-Command relay-knowledge或在cmd.exe中使用where.exe relay-knowledge，然后运行相同的诊断。

在支持命令超时的主机shell中运行实时诊断，并将超时报告为诊断结果，而不是无限等待。

在Linux或具有GNU核心工具的主机上，超时是可以接受的： timeout 20s relay-knowledge health --format json timeout 20s relay-knowledge service doctor --format json timeout 20s relay-knowledge audit query --limit 50 --format json

在默认的macOS shell中，GNU超时没有安装，请使用命令运行器的超时设置，如果可用。

如果只有shell文本可用，请为每个诊断使用短POSIX看门狗： relay-knowledge health --format json & relay_knowledge_pid=$! ( sleep 20; kill "$relay_knowledge_pid" 2>/dev/null ) & relay_knowledge_watchdog=$! wait "$relay_knowledge_pid" relay_knowledge_status=$? kill "$relay_knowledge_watchdog" 2>/dev/null exit "$relay_knowledge_status"

对于在线安装或升级，请首选官方发布路径，然后是Cargo： cargo install relay-knowledge

对于在线安装或升级，请首选官方发布路径，然后是Cargo。