技能介绍

要解决什么问题

在信创或内网环境里，麒麟 / 飞腾 ARM64 机器往往和日常开发机（常见是 Windows）不在同一套运维习惯里：你要查磁盘、装包、跑脚本，通常得单独 SSH 登录、记账号，或者在每台麒麟上手工搭一套远程执行入口。若还要让 QClaw 这类 Agent 代你操作，缺少一条稳定、可脚本化的「Windows → 麒麟」通道，对话里很难把「连那台 192.168.1.7 看看 df」变成可重复的动作。

技能如何工作

麒麟指挥官（Kylin Relay）在麒麟侧跑预编译的 qt-relay，在 QClaw 侧用 relay_client.py 经 TCP:12345 收发 JSON 行协议：先 auth，再 exec / status，服务端用 QProcess → bash 执行命令并回传 stdout、stderr 与退出码。

首次部署：deploy 通过 SSH 校验架构、SCP 二进制、按需补 Qt5 库，再以 nohup DISPLAY=:0 ./qt-relay --bind 0.0.0.0 拉起服务；凭据写入 ~/.qclaw/kylin-relay.json。
日常使用：已部署机器只需 status 与 exec "…"；多机时在命令前加 IP 即可，无需重复传 SSH 密码。
Agent 侧：用户说「部署麒麟」「看磁盘」时，对应调用 deploy / exec，配置可由 Agent 按用户提供的账号维护。

适用边界与注意点

QClaw 端需要 Python 3 与系统自带 SSH；麒麟端需要 openssh-server 与 Qt5 运行库（离线环境可能需手工 apt install）。
中继默认 token 为 qclaw-relay；出现 Not connected 时往往是 qt-relay 进程停了，需 SSH 上去重启。
无 X11 :0 时 GUI 可能不可见，但 exec 仍可用；改密码可编辑 JSON 或重新 deploy。

截图预览

使用场景

在 Windows 上通过 QClaw 对话，让 Agent 对指定 IP 的麒麟机调用 `status`，确认中继在线、用户与 hostname。
多台内网麒麟/飞腾主机需要查磁盘或内核信息时，用 `exec "df -h"`、`exec "uname -a"` 而不用逐台开 SSH 会话。
新入网或未装中继的 ARM64 麒麟，首次提供 SSH 账号密码，由 `deploy` 传二进制、补 Qt5 并后台启动 `qt-relay`。
同一套 QClaw 技能管理 192.168.1.7、192.168.1.100 等多 IP 时，在 `relay_client.py` 命令前加目标 IP 切换机器。

适合人员

维护内网多台麒麟/飞腾 ARM 机、希望在 Windows 上用 QClaw 代发 status/exec 而不是手工 SSH 的运维工程师。
做信创或 ARM 桌面/server 交付、需要把「查状态、装 nginx、跑 apt」收敛成 Agent 可调用命令的实施与集成人员。
在 QClaw 技能目录维护 `~/.qclaw/kylin-relay.json`、按用户提供的 IP 与 SSH 凭据完成首次 deploy 的自动化编排者。
Windows 侧负责 QClaw 环境、需跨平台复制 kylin-relay 技能并对接多台 Kylin 中继的桌面运维支持。