核心用法
TRIGGERcmd Skill 允许用户通过命令行直接操控 TRIGGERcmd 生态中的远程计算机。其核心能力分为两大模块：
1. 命令枚举 (list_commands)：列出账户下所有已注册计算机及其可执行命令，支持按设备分组展示，便于快速定位目标指令。
2. 远程触发 (run_command)：通过解析计算机名与命令名的模糊匹配（不区分大小写），获取对应 ID 后向 API 发送执行请求，支持带参数的命令调用。
技能依赖 curl 进行 HTTP 通信，要求用户将个人 API Token 存放于 ~/.TRIGGERcmdData/token.tkn 并设置 600 权限，确保仅文件所有者可读。
显著优点
- 生态整合：无缝接入 TRIGGERcmd 既有设备网络，无需额外部署代理。
- 跨平台：基于标准 HTTP/JSON 接口，兼容任何支持 curl 的 Unix-like 环境。
- 参数化支持：区分
allowParams字段，灵活处理需要动态输入的场景（如调节灯光亮度）。 - 容错设计：内置计算机/命令未找到、Token 失效等常见错误的处理指引。
潜在缺点与局限性
- 单点依赖：完全依赖 TRIGGERcmd 云服务，网络中断或 API 变更将直接导致功能失效。
- 无本地回退：未提供局域网直连或离线执行方案，延迟受公网质量影响。
- 权限粒度粗：Token 为账户级全局凭证，无法针对单台计算机或单条命令细粒度授权。
- 审计追溯弱：输出中未体现命令执行日志查询接口，事后审计需登录 Web 控制台。
适合人群
- 已部署 TRIGGERcmd 代理的智能家居用户，希望通过 CLI 或脚本批量管理设备。
- DevOps/运维工程师需要临时远程触发测试环境脚本的场景。
- 自动化工作流构建者，拟将 TRIGGERcmd 集成至更大的 CI/CD 或家庭自动化链条。
常规风险
| 风险类型 | 说明 |
|---------|------|
| **凭证泄露** | Token 明文存储于本地文件，若备份或权限配置失误易被窃取，导致账户内所有设备遭控。 |
| **误操作** | 命令名匹配为模糊逻辑，大小写不敏感虽便利但也增加误触概率（如将 `reboot` 误认为 `reboot-server`）。 |
| **中间人攻击** | 文档未明确强制 TLS 证书校验，若用户环境 curl 配置不当可能遭受伪造服务器欺骗。 |
| **副作用不可逆** | 部分命令（如关机、删除文件）触发后无二次确认机制，需依赖调用方前置校验。 |
建议在生产环境使用前，配合 jq 对返回结果做严格校验，并在脚本层封装 dry-run 模式先打印解析出的 ID 而非直接 POST。