jetson-headless-mode-nvidia-ai-iot-jetson-device-skills

1. 基本信息

项目	内容	数据来源
名称	jetson-headless-mode	GitHub API
作者/维护者	NVIDIA（Jetson Team），仓库归属 NVIDIA-AI-IOT	SKILL.md / skill-card.md
来源链接	https://github.com/NVIDIA-AI-IOT/jetson-device-skills/tree/main/skills/jetson-headless-mode	—
许可证	CC-BY-4.0（文档）+ Apache-2.0（代码），仓库整体双许可	LICENSE / skill-card.md
GitHub Stars	116（合集仓库整体，非本技能个体热度，见第 6 章说明）	GitHub API
Forks	21	GitHub API
最新版本	0.0.1（SKILL.md `version` 字段）	SKILL.md
安装方式	克隆仓库后运行 `./install.sh`，或手动复制目录	仓库 README

2. 功能介绍与亮点

jetson-headless-mode 把“这台 Jetson 要当无人值守的推理节点用，能不能把桌面和用不上的后台服务关掉多省点内存”这件事，变成一次“先出计划、看过再执行”的安全操作。

计划-确认-执行三段式：scripts/plan.sh 读取 jetson-memory-audit 的实时快照，只挑出标记为“安全可逆”的项生成计划；scripts/apply.sh 默认演练模式，仅在显式加 --apply 时才真正执行，且每一条改动都配有可逆命令。
白名单保护关键服务：SKILL.md 明确列出禁止触碰的服务清单（如串口控制台 nvgetty、摄像头管线 nvargus-daemon、功耗管理 nvpmodel），不做“未列入白名单就一律关掉”的激进操作，避免把设备锁死或关键功能失效。
覆盖全系 Jetson 产品线：同一套开关（桌面目标切换、显示管理器、蓝牙、打印服务、崩溃上报等约 10 项）适用于 Orin Nano/NX/AGX 与 Thor 全系列，最高单项预计可回收约 865MB 内存。
发布前经官方实测：仓库随附 BENCHMARK.md，显示该技能经 NVIDIA 内部评测框架用 Claude Code 与 Codex 各跑过 4 项任务，安全维度两个 agent 均 100% 通过，正确性、可发现性、有效性等指标在同仓库 14 个技能里名列前茅。

3. 适用场景

所属分类：DevOps 与基础设施（设备资源配置与运维调优，见第 7 章判定说明）。

面向把 NVIDIA Jetson 设备部署为无人值守边缘推理节点或嵌入式产品的开发者：设备默认启动桌面环境和一批用不上的后台守护进程，白白占用本就紧张的板载内存；这个技能把“关哪些、怎么关、能不能撤销”标准化成一次可审查、可回滚的操作，省去手动逐条排查 systemd 服务的工作。

4. 跨Agent兼容性

Claude Code：原生支持。安装脚本提供 --targets claude；NVIDIA 内部评测明确用 claude-code agent 实测过该技能（4 项任务，安全维度 100% 通过）。
Codex：原生支持。安装脚本提供 --targets codex；同一评测中 codex agent 同样实测通过（安全维度 100%）。
OpenClaw：原生支持。安装脚本提供 --targets nemoclaw，可直接安装进运行中的 NemoClaw/OpenClaw 沙箱。
Hermes Agent：未验证。仓库 README 与安装脚本均未提及 Hermes Agent 适配，未找到相关说明。

5. 推荐理由

它把“给 Jetson 关无用后台服务省内存”这件本来要手动逐条排查、一步弄错就可能锁死设备的运维活，变成默认先演练、白名单保关键服务、每步都可逆的标准操作；由 NVIDIA 官方维护，发布前用真实 Claude Code / Codex agent 实测过安全性与执行正确性，适合正在把 Jetson 转成无头推理节点的边缘 AI 开发者。

6. 评分

维度	分数	说明
受欢迎程度	7	NVIDIA 是 Jetson 平台的所有者，属第一方出品；合集仓库整体 116 星为合集热度，不代表本技能个体数据；仓库上线约两个半月，未检索到该子技能自身独立的第三方讨论
可用性	9	一条安装脚本命令即可装入目标 Agent；SKILL.md 含用途、前置条件、禁止项清单、安全说明与预计回收内存对照表；仓库最近一次更新在 4 天前；纯本地操作、无付费依赖；官方实测正确性/可发现性/有效性指标在同仓库技能中领先
安全性	9	默认演练模式、需显式 `--apply` 才生效；改动限定在白名单内的可逆项，明确列出禁止触碰的关键服务；不联网外发数据、不经手凭据；License 清晰；官方安全评测两个 agent 均 100% 通过
综合	8.3	三项均值

安全检查清单：①有 shell 执行（systemctl 服务开关），但限定在预先声明的安全可逆清单内，默认仅生成计划不执行，需显式 --apply 才真正改动系统；②不联网外发数据；③不需要 API key/凭据；④未发现可疑指令或混淆代码；⑤作者为 NVIDIA 官方 Jetson 团队，仓库随附密码学签名文件；⑥License 明确（CC-BY-4.0 + Apache-2.0）；⑦仓库整体最近一次更新为 4 天前，该技能本身最近一次改动为约两个月前。

7. 跟同类Skills相比的优势

工具	定位	与本技能的差异
`jetson-memory-audit`（同仓库）	只读采集 Jetson 设备的实时内存快照	不做任何修改，纯诊断；本技能消费它的快照数据，是“看数据”与“动手改”的分工关系
`jetson-inference-mem-tune`	针对推理引擎（vLLM/SGLang 等）给运行时选型与启动参数建议	作用在推理进程层面的参数调优，不涉及操作系统层的桌面/守护进程；两者面向不同的内存来源，可配合使用
手动 `systemctl disable` 系列命令	开发者自行逐条查找并关闭服务	需要自己判断哪些服务能关、会不会关坏设备；本技能把这层判断标准化进白名单，并默认先出计划再执行

8. 用户评价

该技能目前在第三方平台尚无已验证的具名用户评价。其所属的 “Jetson Device” 技能家族由 NVIDIA 官方论坛发帖介绍过定位与设计动机，但截至目前该帖尚无社区回复。

9. 其他补充

jetson-headless-mode 是 NVIDIA-AI-IOT/jetson-device-skills 家族（专注“运行中的 Jetson 设备”这一场景，覆盖诊断、内存审计、无头模式、LLM 服务与基准测试、视频编解码等共 14 个技能）之一，与专注刷机前 BSP 定制的姊妹仓库 jetson-bsp-skills 是两条不同产线。

10. 安装使用方式

推荐方式：

git clone https://github.com/NVIDIA-AI-IOT/jetson-device-skills.git
cd jetson-device-skills
./install.sh --targets claude

--targets 可换成 codex、cursor，或用逗号一次装多个（如 claude,codex）；OpenClaw 用户改用 --targets nemoclaw --nemoclaw-sandbox <沙箱名> 直接装进运行中的沙箱。装完重启 Agent 会话使新技能生效。

手动方式： 复制仓库 skills/jetson-headless-mode/ 整个目录（含 SKILL.md 与 scripts/plan.sh、scripts/apply.sh），放入对应 Agent 的技能目录，如 Claude Code 的 ~/.claude/skills/。

使用前需先有一份 jetson-memory-audit 生成的内存快照；向 Agent 描述“把这台 Jetson 转成无头模式、尽量省内存”即可触发。

11. 注意事项

依赖 jetson-memory-audit 提供的实时快照作为输入；没有当前快照时不建议直接估算能省多少内存。
仅适用于确认不需要本地桌面、显示输出或 kiosk UI 的场景；需要图形界面的设备不应使用。
需要 sudo 权限与用户显式批准才会执行改动；默认演练模式只输出计划，不修改系统。
当前版本号 0.0.1，属早期版本；覆盖 Jetson Orin 系列与 Thor，不适用于非 Jetson 平台。