haos-ssh-maintenance

通过SSH维护Home Assistant OS,管理配置、组件及进行故障排查。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:haos-ssh-maintenance。
它的用途是:通过SSH维护Home Assistant OS,管理配置、组件及进行故障排查。
完整的 Skill 内容见:https://321skill.com/skills/haos-ssh-maintenance/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘通过SSH连接到我的Home Assistant主机,检查core容器的日志,看看为什么我的自动化规则没有触发。’,它会指导你建立SSH连接并执行 `docker logs homeassistant` 等命令来查看日志。或者,

对AI说:‘我想通过ha命令行添加一个新的集成。’,它会引导你使用SSH登录后,运行 `ha addons install` 或 `ha core restart` 等交互式命令。

介绍

haos-ssh-maintenance 是一个专为 Home Assistant OS 设计的 SSH 维护工具,旨在解决用户在管理智能家居系统时遇到的底层配置和故障排查难题。它提供了通过 SSH 安全访问 Home Assistant OS 核心系统的能力,允许用户直接操作配置文件、YAML 配置、自定义组件,并进行 shell 级别的故障诊断或使用交互式的 ha CLI。

使用该工具,用户可以通过 SSH 连接到 Home Assistant 主机,执行诸如编辑 configuration.yaml、安装自定义组件、查看系统日志、诊断服务状态等操作。它绕过了 Home Assistant 标准 Web 界面的限制,为高级用户和开发者提供了更深层次的控制权。

该技能非常适合需要对 Home Assistant 进行深度定制、开发自定义集成、或当系统出现 Web 界面无法解决的复杂问题时进行调试的用户。例如,当自动化脚本失效需要检查底层日志,或需要手动修改网络配置时,此工具就显得尤为重要。

在使用时,请确保您具备基本的 Linux 命令行操作知识,并理解对系统文件进行修改的风险。建议在操作前备份重要配置,并仅在必要时使用 root 权限,以避免意外损坏系统。

核心特点

与众多仅提供 Web UI 配置或简单 SSH 访问的 Home Assistant 工具不同,此技能专注于为 Home Assistant OS 提供一套完整的、面向系统维护和深度故障排查的 SSH 操作环境,集成了对 ha CLI 的直接交互支持,是进行底层系统管理和开发的专用工具。

注意事项

不适合仅通过 Home Assistant 标准前端界面进行常规配置和操作的普通家庭用户。

常见问题

这个工具能用来做什么?

主要用于通过SSH连接Home Assistant OS,管理配置文件、YAML、自定义组件,进行shell故障排查或使用ha命令行工具。

使用前需要什么前提条件?

需要已在Home Assistant OS上启用SSH功能,并具备相应的登录凭证和网络访问权限。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/haos-ssh-maintenance/raw/index.md 读取 haos-ssh-maintenance 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。