前言¶
在 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/。
三层能力与编排¶
- 认知层:四种思维操作码——直用、改进、迁移、构建,用于分析、创作、方案优化等以 LLM 为主的任务。
- 执行层:「思考 → 执行 → 修复 → 总结」工作流;通过命令执行工具跑 shell 或 Python,并对高危命令(如
rm -rf /)要求用户确认。 - 操控层:18 个独立 Python 脚本,覆盖窗口、进程、硬件、网络/WiFi、GPU、存储、电池/电源、音频、显示器、温度、输入设备、串口、蓝牙、物联网、打印机、扫描仪、摄像头、GUI 自动化。
- 编排引擎:将上述操作与工具调用、其他技能统一为五类基元,支持拆解、依赖规划、失败修复与条件/循环编排。
系统操控模块(脚本)¶
| 模块 | 脚本 |
|---|---|
| 窗口管理 | 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 按统一协议操控窗口、网络、外设,而不是每次临时拼命令。
- 需要把「写脚本跑一遍」和「点鼠标、截图、串口」放在同一套任务路由与编排规则下的团队。
限制与注意
- 环境:操控层依赖 X11 相关工具(
wmctrl、xdotool等)及文档列出的系统包;无图形界面或权限受限的纯容器环境,多数 GUI/窗口能力不可用。 - 安全:关机、杀进程、关窗口、改网络等被标记为需确认;执行层对高危 shell 同样要求确认。安装前建议通读
references/security_checklist.md与包内脚本。 - 硬件差异:GPU 监控、蓝牙 BLE、扫描仪等能力依赖具体驱动与外围工具;文档中部分说明仍带跨平台表述,以 Linux 脚本实际行为为准。
- 版本: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