Agent 能调用的客户端动作

你在对话里说“把文件浏览器收起来”“把这几个旧任务归档”，Agent 会用一个叫 host_action 的工具替你去做。它能做的事是一份固定的清单，清单外的事它做不了，也绕不过去。

这一页把这份清单完整列出来，一共 106 个动作。拿不准能不能交给它某件事，或者在「工作细节」里看到一行 host_action 不知道是什么意思，来这里查就行。想先学怎么跟它说，看让 Floatboat 替你动手。

查表前先知道两件事复制锚点链接

它不会先问你。 这些动作执行前都不弹确认框，你一说它就做。所以要删东西、装东西、往外发东西时，把“是哪一个”说清楚。

「类型」一栏告诉你这个动作影响有多大：

• 只读：只看，什么都不改。
• 改界面：只改你眼前这个窗口的样子。关掉或切回去，就恢复原样。
• 改数据：会改你电脑上的数据，但都能改回来，比如重命名、归档、换快捷键。
• 影响大：删除、安装、对外发布、运行自动化、联网检查更新，或者退出应用。交代这类事时多说一句具体是哪个。

类型后面跟着「当前窗口」的，只在你正在聊天的这个 Floatboat 窗口里能用。如果请求来自手机上的聊天软件、定时任务、日程或 Memo，就没有“当前窗口”可用，这些动作会直接失败，不会跑去动别的窗口。

空间与任务复制锚点链接

整理空间和任务时用到的都在这里：查找、新建、重命名、置顶、归档、删除。

批量归档、批量删除一次最多 50 个。要清理的任务更多，分几次说就好。

界面与预览复制锚点链接

想让它帮你收起面板、打开设置、在预览里翻到某一页，用的是这些。它们大多只改眼前的窗口，不碰你的数据；往输入框附上引用这一项例外，算「改数据」。

设置、快捷键、通知和账号复制锚点链接

这里能查设置、改快捷键、处理通知、看账号余额。

命令、Skill、Combo 和工作台复制锚点链接

这一组管的是你装进 Floatboat 的东西：保存的命令、Skill、Combo 和工作台。每个动作影响多大，以表里的类型为准：大部分安装、登记、提交、删除类的动作都算「影响大」。

Memo、自动化和日历复制锚点链接

记一条 Memo、手动跑一次自动化、订阅一个日历，都在这一组。

页面和更新复制锚点链接

可以让它看看你发布过的页面，或者检查、下载、安装新版本。

如果你的 Floatboat 是由应用商店负责更新的，就没有这 4 个 update.* 动作。

两个辅助动作复制锚点链接

这两个不替你做事，是它用来确认自己能做什么、做成了没有的。

host.list_capabilities 里没列出某个动作，只说明这次对话里用不了，不代表 Floatboat 没有这个功能。

清单里没有的复制锚点链接

下面这些事它不用 host_action 做，或者干脆做不了：

• 读写文件、运行命令、操作 Git。 这些走 Agent 平常的文件和终端工具。它要写文件、跑命令时，你会先看到「需要权限确认」。
• 上面四项以外的设置。 其它设置要你自己到设置页里改。
• 发布或取消发布页面。 它只能查看已发布页面的信息。
• 操作别的软件。 它只管 Floatboat 自己。

遇到问题？复制锚点链接

它说某个动作不能用。 看看这个动作是不是标着「当前窗口」。是的话，要在你正在聊天的 Floatboat 窗口里说；从手机聊天软件或定时任务发起时用不了。

它说找不到要删的东西。 删除只对已归档的空间和任务有效。先让它归档，再让它删除。

某个动作一直没返回结果。 跟它说“查一下刚才那一步做成了没有”。它会用 host.get_action_status 去确认，不会再做一遍。

接下来复制锚点链接

• 怎么跟它说、怎么看它做了什么：让 Floatboat 替你动手
• 自己写一个工作台：用外部 Agent 开发工作台