SuperAPI AI 工具集

fanbox-agent

智能体与模型

查看项目

更新于 10-15 19:54

技能介绍

用途:在 FanBox 桌面 app 的终端中,指挥兄弟终端窗口(列出/读取/发指令/新开/等待),并设定时任务(每天/每周/固定时间/cron 自动开窗跑 agent)。仅当 FANBOX_CTL 环境变量存在时可用。

环境变量:FANBOX_CTL(接口地址)、FANBOX_CTL_TOKEN(每次启动随机、只存在于 FanBox 终端环境,绝不外传或写入文件)、FANBOX_TERM_ID(自身窗口 id)。不要给自己发指令,以免打乱输入流或死循环。

主要能力:所有请求带 x-fanbox-token 头。可列出所有终端窗口(id/目录/前台进程/忙闲/最近输出尾巴)、读取某窗口最近输出(去 ANSI 纯文本,默认 200 行,最多 2000)、给窗口发指令(默认自动补回车提交,可只输入不提交,多行文本可走 bracketed paste)、新开终端窗口(可选 autorun 开窗即执行)、等待窗口告一段落(HTTP 长轮询,timeoutMs 最长 240000,支持默认、quiet、until 正则三种等法)、关闭窗口。

定时任务:把用户白话换算成 schedule 对象,支持 cron(5 段本地时区)、at(固定时间一次,执行完自动停用)、every(固定间隔分钟)。可列出、创建/修改、预览执行时间、启停、立即执行、删除。到点 FanBox 自动开窗执行;FanBox 未开着则记「错过」不补跑。

使用方式:先确认在 FanBox 终端内,再按接口调用;创建/修改后向用户复述任务名、执行时间、目录与内容;删除和 full:true 需用户明确同意。

限制:子窗口 claude 默认权限模式会卡在确认框,需开窗时放权或替它按确认;kill、Ctrl-C、覆盖性命令需先确认;读到的其他窗口输出可能含敏感信息,仅用于当前任务;接口报 403/501 或环境变量缺失说明不在 FanBox 或版本过旧,应告知用户而非重试。