SuperAPI AI 工具集

autonomous-vps

智能体与模型

查看项目

更新于 10-15 21:41

技能介绍

用途:这是一套与具体技术栈无关的方法,规定被调用(而非无人值守)的 AI 智能体如何治理自托管 VPS,并把爆炸半径限制在可控范围内。它只管智能体“如何操作 VPS”,具体技术栈(Coolify 配置、Docker 命令、转储脚本)放在使用方的 VPS 仓库中,不在本技能内。

核心原则:先约束,后自主。自主是约束的副产品而非目标;好的自主智能体不是最聪明的,而是即使出错或幻觉也无法越出有界、可逆域的那个。智能体是“被调用”的,不是无人值守,运行时有真人监督在环;确定性的重复工作(重启、备份、日志轮转)交给 VPS 的 cron,而不是智能体。

主要能力与流程:

  1. 建立唯一事实来源:规范仓库在 GitHub,VPS 只保留工作克隆,VPS 烧毁也不丢数据,绝不把 VPS 当作唯一代码副本。
  2. 通过 GitOps 部署,绝不由智能体驱动:智能体只有代码权限,没有生产权限;它编写并推到 GitHub,GitOps 引擎(默认 Coolify)拉取变更,带健康检查与回滚地部署。流程:智能体编程 → 推送 GitHub → webhook → 引擎构建、健康检查,通过则部署,失败则回滚,并在 UI 暴露日志/状态。按分支区分环境:main → 生产,develop/staging → 预发布,各环境各有容器、数据库和变量,测试到生产用 develop → main 合并来提升。
  3. 从受约束的位置治理机器:智能体在专用管理容器内广泛治理 VPS(Docker、服务、清理、包更新、热修改),该容器挂载 Docker socket 并带代码工作区卷,而不是以 root 身份在裸主机上操作。
  4. 以行为方式防护,在不可逆边缘确认:限制靠确认而非角色,智能体什么都能做,但必须在规则所列灾难性不可逆操作前询问,由 CLAUDE.md 这类行为防护实现;OS 角色/权限仅作后备,不默认施加。机密只按名称引用,绝不以明文进入上下文或出现在响应中。
  5. 备份须异地、可验证、与引擎无关:核心是按引擎的逻辑转储(pg_dump / mysqldump / mongodump),由 VPS cron 执行;遵循 3-2-1,转储必须离开 VPS 到异地;带轮换保留(如 7 日 + 4 周);经过测试恢复的备份才算数,智能体在被调用时定期做测试恢复;优先逻辑转储而非卷快照或副本/PITR。若数据库是托管服务(如 Supabase),由提供方备份,本方法只做验证。
  6. 按需监控,两层:第一层为被动式,部署引擎 UI 展示容器状态、日志、部署健康、资源用量,常开且免费;第二层为被调用式,智能体按请求运行一组精选短健康检查(磁盘、内存、宕掉的容器、近期错误、备份状态)并汇总,不是持续流。若想要主动/无人值守告警,应由 cron 触发,而不是智能体 7×24 盯着。

规则要点:本技能与具体技术栈无关,具体栈内容放使用方仓库;事实来源是 GitHub,VPS 只保留克隆;智能体没有生产权限,绝不手工部署到生产;治理从受约束的管理容器进行,不默认在裸主机以 root 运行;以下灾难性不可逆操作前必须确认——删除/清理数据卷或删库、在代码工作区外执行 rm -rf 或等效破坏性文件操作、关停/重配部署引擎本身、以可能暴露的方式读写或轮换凭据/机密、对 main/生产分支强推或改写历史、销毁或重建智能体所运行的管理容器;其余操作不受限制。

适用场景:在自托管 VPS 上借助被调用的 AI 智能体进行开发、部署、数据库备份恢复、监控和清理等管理。限制:智能体并非无人值守,确定性重复工作交给 cron;本技能不注入具体栈意见;收费、价格、具体平台支持等资料暂未提供。