Linux Omniscient:在 Linux 上把 Agent 接到系统操控与编排

前言

在 Linux 服务器或桌面上用 Agent 时,常见做法是让它写 shell、查日志、改配置。一旦任务涉及窗口切换、音量、WiFi、串口或摄像头,模型往往只能给出命令片段,缺少统一的任务路由、安全边界和可复用的操控脚本。

下面介绍 SkillHub 上的 Linux Omniscient:在「全知全能」三层架构基础上,把操控层改成面向 Linux 的 Python 脚本集,并保留认知层与执行层、编排引擎,适合需要跨「想—写代码—控机器」的运维与桌面自动化场景。

这是什么

Linux Omniscient 在 SkillHub 上的简介为「全知全能技能 Linux 版」,分类为 it-ops-security(页面标签对应 IT 运维与安全、服务器运维、故障排查等)。作者为 王教成 Wang Jiaocheng(波动几何)。

技能包遵循通用 SKILL.md 格式:用任务路由器把请求分到认知层、编程执行层或系统操控层;复杂多步任务由编排引擎把脚本命令、代码执行、工具调用、其他技能与纯 LLM 输出组合成链条。包内 name 字段为 omniscient,与展示名 Linux Omniscient 对应同一套能力定义。

官方入口:https://api.skillhub.cn/user_e02e04b8/linux-omniscient
SkillHub 展示页:https://skillhub.cn/skills/linux-omniscient

平台侧可见数据(截至撰稿时线索):SkillHub 评分 99478,下载约 572 次;展示页另有 AI 评分约 4.4/5 及安全审核标注(以页面为准)。

核心功能

以下能力均来自 Linux 版 SKILL.md 与包内 scripts/、references/。

三层能力与编排

  1. 认知层:四种思维操作码——直用、改进、迁移、构建,用于分析、创作、方案优化等以 LLM 为主的任务。
  2. 执行层:「思考 → 执行 → 修复 → 总结」工作流;通过命令执行工具跑 shell 或 Python,并对高危命令(如 rm -rf /)要求用户确认。
  3. 操控层:18 个独立 Python 脚本,覆盖窗口、进程、硬件、网络/WiFi、GPU、存储、电池/电源、音频、显示器、温度、输入设备、串口、蓝牙、物联网、打印机、扫描仪、摄像头、GUI 自动化。
  4. 编排引擎:将上述操作与工具调用、其他技能统一为五类基元,支持拆解、依赖规划、失败修复与条件/循环编排。

系统操控模块(脚本)

模块 脚本
窗口管理 window_manager.py
进程管理 process_manager.py
硬件控制 hardware_controller.py
网络与 WiFi network_controller.py
GPU gpu_controller.py
存储磁盘 storage_controller.py
电池与电源 battery_controller.py
音频 audio_controller.py
显示器 display_controller.py
温度与风扇 thermal_controller.py
输入设备 input_controller.py
串口 serial_comm.py
蓝牙 bluetooth_controller.py
物联网 iot_controller.py
打印机 printer_controller.py
扫描仪 scanner_controller.py
摄像头 camera_controller.py
GUI 自动化 gui_controller.py

操控层约定:始终用命令执行工具运行 scripts/ 下脚本;详细子命令见 references/command_reference.md,新增或审计脚本时可参照 references/security_checklist.md。

依赖(SKILL.md frontmatter)

Python 依赖(节选,版本以包内 SKILL.md 为准)包括 psutil、pyautogui、Pillow、pyserial、requests、bleak、sounddevice、opencv-python、numpy、pytesseract 等。

系统包(Debian/Ubuntu 示例,写在 dependency.system 中):

apt-get update && apt-get install -y x11-utils wmctrl xdotool alsa-utils pulseaudio-utils lm-sensors upower sane-utils

文档建议的可选虚拟环境:

python3 -m venv ~/.venv/omniscient
~/.venv/omniscient/bin/pip install psutil pyautogui pillow pyserial requests bleak sounddevice opencv-python pytesseract

安装与启用

通过 SkillHub 安装(推荐)

SkillHub 安装说明要求 Agent 先阅读 https://skillhub.cn/install/skillhub.md,再安装命名空间技能:

请根据 https://skillhub.cn/install/skillhub.md,安装 `@indiv-wangjiaocheng/linux-omniscient`。

若本机已有 skillhub CLI,可将技能装到当前 Agent 的 skills 目录(必须使用 --dir,否则默认 ./skills/ 可能不会被识别):

command -v skillhub && skillhub --version
skillhub install linux-omniscient --dir ~/.cursor/skills/

常见路径(来自 SkillHub 安装文档):

  • Cursor:~/.cursor/skills/
  • Claude Code:~/.claude/skills/
  • Codex:~/.codex/skills/ 或项目下 .agents/skills/

未安装 CLI 时,可按同一文档执行官方安装脚本(需联网权限):

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装后重启或刷新 Agent,使技能目录生效。

启用后的运行约定

操控层在 Linux 上使用 python3 或 /usr/bin/python3,脚本相对路径为技能包内的 scripts/。Agent 加载本技能后,应按 SKILL.md 中的任务路由器选择层级,并在执行破坏性操作前征得用户确认。

典型用法

下列示例摘自官方 SKILL.md 中的模块调用说明,可在技能目录下用命令执行工具复现(先 cd 到含 scripts/ 的路径)。

进程与窗口

python3 scripts/process_manager.py start "code"
python3 scripts/window_manager.py list
python3 scripts/window_manager.py activate --title "微信"

网络

python3 scripts/network_controller.py wifi scan
python3 scripts/network_controller.py connectivity ping --host baidu.com

GPU(需系统具备 nvidia-smi 等条件,见脚本说明)

python3 scripts/gpu_controller.py info
python3 scripts/gpu_controller.py monitor --interval 2 --count 5

GUI

python3 scripts/gui_controller.py screenshot full
python3 scripts/gui_controller.py visual ocr

编排示例(逻辑层面)
任务「读取数据生成报告并调低屏幕亮度」在文档中被拆为:窗口/截图脚本 → 认知规划 → Python 处理 → hardware_controller.py screen brightness 等基元顺序执行。实际链条由 Agent 按编排协议生成,不必手写全部步骤。

适用场景与注意

适合谁

  • 在 Linux 桌面或带 GUI 的运维环境中,希望 Agent 按统一协议操控窗口、网络、外设,而不是每次临时拼命令。
  • 需要把「写脚本跑一遍」和「点鼠标、截图、串口」放在同一套任务路由与编排规则下的团队。

限制与注意

  1. 环境:操控层依赖 X11 相关工具(wmctrl、xdotool 等)及文档列出的系统包;无图形界面或权限受限的纯容器环境,多数 GUI/窗口能力不可用。
  2. 安全:关机、杀进程、关窗口、改网络等被标记为需确认;执行层对高危 shell 同样要求确认。安装前建议通读 references/security_checklist.md 与包内脚本。
  3. 硬件差异:GPU 监控、蓝牙 BLE、扫描仪等能力依赖具体驱动与外围工具;文档中部分说明仍带跨平台表述,以 Linux 脚本实际行为为准。
  4. 版本:SkillHub 展示页标注版本约为 v1.0.1;与同一作者的 Windows 向 Omniscient 技能为不同 slug,勿混装路径。

结尾

Linux Omniscient 把认知、代码执行与 Linux 系统操控收成一套 SKILL.md 协议,并用 18 个脚本覆盖日常运维与桌面自动化常见触点;适合已使用 Cursor、Claude Code 等支持 Skills 的 Agent、又希望在 Linux 上可控扩展的场景。

官方地址:https://api.skillhub.cn/user_e02e04b8/linux-omniscient

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜