SuperAPI AI 工具集

afs

通用与其它

查看项目

更新于 10-15 19:57

技能介绍

AFS 是 ARC 的路径寻址世界。实时智能体工作建议优先使用 MCP(arc skill show mcp)或守护进程 HTTP API(在实例自身端口上 POST /afs),二者都绑定到已知实例,避免歧义。

用途与用法:arc afs <cmd> 用于从终端对命名实例做临时检查。它不会静默选择世界:需传 --instance <name> 附加到指定实例的守护进程,或传 --standalone 构建无守护进程、无运行时状态的临时 AFS。裸 arc afs <cmd>(无标志)指向默认实例,若该实例无守护进程运行则失败关闭(非零退出)。

核心操作:arc afs ls [path]、read <path>、write <path> [content]、stat <path>、exec <executable_path> --args '<json-object>'、search <path> <query>、explain [topic|path],均需 --instance <name>;换成 --standalone 同样可用,首行输出标记 [standalone]。

mount 例外:arc afs mount 不按实例作用域,其 add/remove/list/validate 只读写从当前目录向上查找的 .afs-config/config.toml,并拒绝 --instance/-i/--home。要把路径挂载到运行中的实例,用 arc attach --to ws://localhost:<port> --namespace <ns> --source <dir>。

exec 参数:以单个 JSON 对象传入,如 arc afs exec /some/.actions/foo --args '{"key":"value"}' --instance <name>;不要臆造裸 key=value,除非 exec --help 有说明。

确认实例:arc service list 查看已注册实例名称与状态;arc service status --instance <name> --print port 确认守护进程在运行。路径 404 或看似过期时,应重新确认所附加的实例,而非信任返回的树。

UI 设备:UI 是 /dev/ui 下的系统设备(非裸 /ui)。Web 多终端是 WM 面板加叶子终端表面,而非单设备内的 tmux。无浏览器会话可用 create-named-session 动作创建,同名会替换会话。panels 策略为全幅网格,floating 为可拖动桌面窗口。open-surface 需传 name(表面句柄),不要只传 id。

限制:破坏性操作(删除、危险 exec)需明确的人类或智能体意图,不确定时失败关闭;不要离线臆造挂载表,连接后再列出实时路径。安装手册见 arc skill install afs。