Hoody 能做的一切
Hoody 能做的事
五个理念, 500 行
Hoody 是几个理念,反复使用。先看五个理念,再看用平实语言写成的基本构件: 500 行,分为 52 组。每行说明要对你的 AI 说什么。多数行还说明依赖这些功能前需要了解的事项,并附有文档链接。你的 AI 会把它们组合出更多用法。
用 id 链接到某一行,例如 /capabilities/#c120。用浏览器的查找功能搜索本页。
列表之前
每行背后的五个理念
列表很长,理念很少。下面的每一行,都是这五个理念之一在起作用。
你的 AI
思考和对话。
Hoody AI 内置且免费。也可以用你的 ChatGPT 或 Claude 方案,或者其他 AI。
Hoody
归你所有的基础。
Hoody 替你托管并运行基础设施。你的 AI 可以使用其中的每个部分。
-
始终在线的电脑
Hoody 电脑是云端的一台完整 Linux 电脑,关闭标签页后仍会持续运行。
一个请求即可创建POST https://api.hoody.com/api/v1/projects/{p}/computers这对你意味着什么你不在时,网站、任务和文件照常运行。向 AI 要一台电脑,电脑随即就绪。
-
每样东西都有 URL
电脑里的每个工具都有自己的 HTTPS 链接。改掉链接里的一个词,就进入另一个工具。
同一台电脑,两个工具https://{p}-{c}-terminal-1.{node}.computers.hoody.comhttps://{p}-{c}-display-1.{node}.computers.hoody.com这对你意味着什么无需安装。你、脚本和你的 AI 打开的是同一个链接。
x01 一切都是 URLc24 网站和应用上线x02 实时协作docs / concepts / everything-is-a-url
-
一个 API,普通 HTTP
你在 Hoody 里能做的事,AI 或脚本同样能做。API 是普通的 REST,走 HTTP。
列出你的项目curl "https://api.hoody.com/api/v1/projects/" \ -H "Authorization: Bearer $HOODY_TOKEN"或者用 SDKnpm install hoody-sdk这对你意味着什么SDK 是可选的。任何能发出 Web 请求的东西,都能操作 Hoody:curl、脚本或你的 AI。
a01 一个 API 管所有事x09 说 @hoody.comx10 ssh hoody.comdocs / foundation / hoody-apigithub / hoody-sdk
-
Bot 和智能体负责干活
Bot 是一个长期运行的聊天。它把任务交给你电脑里的智能体,再汇报它们做了什么。
有自己地址的 Bothttps://<label>.hoody.bot这对你意味着什么用日常语言说出你想要的。同一个 Bot 在 Telegram、Slack 和 Discord 里都会回答。
-
私密链接,真正的锁
生成的链接猜不出来,所以在你分享之前,它一直是隐藏的。可以用密码、登录或 IP 列表锁定任意链接。
拒绝你的分组之外的所有人"default": "deny"
再看列表 500 行
01 264 行
电脑
浏览器里始终在线的电脑。每个工具都有自己的链接。
始终在线,带桌面 10
- c01
始终在线的电脑
关闭标签页后,你的电脑仍然开机并持续运行。
对 AI 这样说让它在我的 Hoody 电脑上持续运行。 - c02
标签页里的桌面
在浏览器里打开完整的桌面。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com 对 AI 这样说在我的电脑上打开桌面。须知在你设置代理权限之前,任何拿到链接的人都可以使用桌面。
- c03
任意 Linux 应用
运行任意 Linux 应用,在任意浏览器里使用,手机也可以。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com 对 AI 这样说运行 LibreOffice,把链接发给我。 - c04
你的 AI 使用屏幕
让 AI 在桌面上点击、输入、读取窗口和截图。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ screenshot 对 AI 这样说给我的桌面截个图,然后点击“保存”。 - c05
跨设备复制粘贴
在你的设备和桌面之间复制粘贴。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com 对 AI 这样说把这段文字粘贴到桌面应用里。须知粘贴生效前,浏览器可能会请求剪贴板权限。
- c55
暂停电脑
暂停电脑,几秒内即可恢复,会话和内存保持不变。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ pause 对 AI 这样说把我的开发电脑暂停到明天。须知暂停的电脑仍占用 RAM 和磁盘,在恢复前,其服务 URL 会返回错误。服务器重启后,暂停状态会丢失。
- c56
多个独立屏幕
运行多个独立桌面,各有自己的分辨率、窗口和应用。
对 AI 这样说给我的浏览器和编辑器分别配一个屏幕。须知会话必须先设置好每个屏幕编号,才能启动。
- c57
选择桌面环境
用 Xfce 或 MATE 桌面环境启动屏幕。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ create 对 AI 这样说用 MATE 桌面启动一个屏幕。须知已有的终端会话保留其设置。
- c58
普通电脑设置
创建不含 Kit 服务的电脑,运行你自己的 HTTP 服务器。
链接
https:// api. hoody. com/ api/ v1/ projects/ {p}/ computers 对 AI 这样说为我自己的网站服务器创建一台普通电脑。须知普通电脑没有内置的浏览器 shell。设置 SSH 公钥,用于首次 SSH 访问。
- c59
停止屏幕
停止屏幕,并结束其中运行的程序。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ system/ displays/ {displayId}/ stop 对 AI 这样说停止屏幕 1 及其程序。须知停止屏幕会结束其上的所有程序,包括未保存的工作。
桌面查看器选项 9
- c60
传输桌面文件
在浏览器和屏幕之间传输文件。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ 对 AI 这样说把这个文件传到我的屏幕。 - c61
收听桌面音频
在查看屏幕的浏览器中播放屏幕音频。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?sound=true 对 AI 这样说在这个浏览器中播放我的桌面音频。 - c62
观看演示
以不能点击或输入的查看者身份打开共享桌面。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?sharing=true&steal=false&readonly=true 对 AI 这样说给我桌面演示的查看链接。须知只读查看模式不是访问控制:HTTP API 仍接受输入,代理权限中也没有仅查看级别。
- c63
从桌面打印
把屏幕上的打印任务转发到浏览器。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ 对 AI 这样说从我的桌面打印这份文档。 - c64
选择键盘布局
为桌面查看器选择键盘布局。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?keyboard_layout=gb 对 AI 这样说在我的桌面上使用英式键盘布局。 - c65
触屏键盘
在触屏上使用桌面时,显示虚拟键盘。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?keyboard=true 对 AI 这样说在我的触屏笔记本电脑上显示虚拟键盘。 - c66
限制屏幕带宽
网速慢时,为桌面查看器设置带宽上限。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?quality_mode=reduced&bandwidth_limit=500000 对 AI 这样说把我的桌面查看器限制在 500 Kbps。 - c67
打开时聚焦应用
打开查看器时,让指定名称的窗口最大化并获得焦点。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?app=Firefox 对 AI 这样说打开我的桌面,让 Firefox 显示在最前面。须知这会为该屏幕的所有查看者最小化其他窗口。
- c68
自定义查看器
使用带悬浮菜单的深色桌面查看器。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?dark_mode=true&floating_menu=true 对 AI 这样说用深色查看器和悬浮菜单打开我的桌面。
桌面自动化 7
- c69
移动和调整窗口大小
用 API 移动、调整大小、最小化、还原或关闭桌面窗口。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ window/ resize 对 AI 这样说把我的浏览器窗口调整到铺满桌面。须知部分窗口操作需要带窗口管理器的桌面。
- c70
等待窗口
等应用窗口出现后,再继续自动化。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ input/ wait- until 对 AI 这样说等 Firefox 打开后再继续。须知最多等待 25 秒。超时会返回 HTTP 200,且 timedOut 为 true。
- c71
批量桌面操作
在一次 API 调用中运行一系列桌面操作。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ input/ batch 对 AI 这样说通过一次批量操作,在桌面浏览器中打开 hoody.com。须知一个批次运行 1 至 50 个操作,遇到第一个失败就停止。之前已完成的操作保持不变,其他输入可以在操作之间进行。
- c72
操作并获取结果
一次调用运行桌面操作,并获取结果。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ input/ act 对 AI 这样说点击按钮,并截取结果画面。须知如果操作之后截图失败,该操作已经完成。
- c73
用 API 操作桌面剪贴板
一次 API 调用即可读取或设置桌面剪贴板中的文本。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ clipboard 对 AI 这样说把这个地址放到我的桌面剪贴板。 - c74
已存的桌面截图
列出桌面已存的截图,按时间或文件名获取任意一张。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ screenshots 对 AI 这样说给我看 10 分钟前的桌面截图。须知查询只搜索最新存储的 500 张截图。
- c75
桌面缩略图
截取桌面的小图,用于图库。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ api/ v1/ display/ thumbnail 对 AI 这样说为我的桌面生成缩略图。须知缩略图缩放到屏幕尺寸的 20%。
终端和浏览器 12
- c06
链接里的终端
在任意浏览器里使用完整的终端,不用设置 SSH 密钥。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com 对 AI 这样说在我的电脑上打开终端。须知在你设置代理权限之前,任何拿到链接的人都可以使用终端。
- c07
用链接运行命令
你的 AI 运行命令,并拿回输出和报错。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute 对 AI 这样说运行测试,告诉我哪些失败了。 - c08
全屏终端应用
你的 AI 可以逐个按键操作全屏终端程序。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com 对 AI 这样说打开 htop,告诉我什么占用的内存最多。 - c09
连接你的其他服务器
在网页终端里 SSH 登录你的其他服务器,不需要客户端。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com 对 AI 这样说连接我的旧服务器,查看它的磁盘空间。 - c10
由 AI 操作的浏览器
运行 Chromium 或 Firefox,你的 AI 可以用它浏览、阅读和点击。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com 对 AI 这样说打开定价页面,把各个方案整理成表格。须知默认情况下,浏览器闲置 1 小时后会停止,并丢失其中的标签页和 Cookie。下一次调用会启动一个全新的浏览器。
- c11
网页截图和 PDF
用后台浏览器给任意网页截图,或存为 PDF。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ pdf 对 AI 这样说把那篇文章保存为 PDF。须知PDF 需要后台运行的 Chromium;默认浏览器是看得见的那个。
- c76
独立终端会话
打开独立的 shell 会话,共享电脑的文件和进程。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ 对 AI 这样说为构建再打开一个终端。须知新会话的 ID 取 1 至 9999。ID 4501 至 5000 留给智能体,可同时运行的数量取决于电脑的资源。
- c77
保留 shell 状态
在同一个会话中运行相关命令,保留工作目录和变量。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute 对 AI 这样说切换到我的项目目录,在那里运行构建。须知会话会在删除、电脑重启、终端服务重启或空闲清理时结束。
- c78
查看长时间命令
启动一个长时间运行的命令,运行期间查看它的输出和状态。
对 AI 这样说启动构建并查看进度。须知持久会话的超时只是汇报期限,不会停止正在运行的命令。
- c79
停止命令
中断正在运行的终端命令,或在命令等待时取消它。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute/ {command_id}/ abort 对 AI 这样说停止我启动的构建命令。须知超时后,只有在没有其他输入到达终端、且其 shell 仍在运行时,才能中止。
- c80
只看不输入
以只读模式打开终端,查看会话但不发送输入。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?readonly=true 对 AI 这样说给我这个终端的只读链接。须知只读模式只阻止该客户端的输入。谁能打开这个 URL,由代理权限决定。
- c81
精确的命令输出
运行命令,获取精确的输出字节,stdout 和 stderr 分开保存。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute 对 AI 这样说运行这条命令,给我它精确的二进制输出。须知原始模式会等命令结束,并在终端会话之外运行。每个流的捕获量不超过服务器的上限。
终端选项 10
- c82
选择 shell
用 bash、zsh、fish、sh 或 tmux 启动浏览器终端。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?shell={shell} 对 AI 这样说用 zsh 打开我的终端。须知shell 设置在会话启动时生效。加上 reset=true 可更改运行中会话的 shell。
- c83
启动图形应用
把终端和屏幕配对,在该屏幕上打开程序。
对 AI 这样说从终端 2 在屏幕 2 上启动 Firefox。须知用 API 创建的会话会从创建请求的请求体中读取屏幕设置。
- c84
用 SSH 加入 tmux
用 SSH 和终端编号加入浏览器里的 tmux 会话。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?shell=tmux 对 AI 这样说告诉我怎样用 SSH 加入终端 3。 - c85
终端侧边栏
在同一页面中,把 Hoody Agent、运行手册或仪表板显示在终端旁边。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?panel={url} 对 AI 这样说在终端 1 旁边打开我的智能体。须知分享这个 URL 就会分享终端及其面板。
- c86
临时 shell 会话
创建一个临时终端,分配 ID,用完自动清理。
对 AI 这样说在临时终端中运行这个脚本。须知服务会在 5,001 至 7,999 之间分配一个 ID。会话没有屏幕,已完成的结果默认保留 5 分钟,期间可以获取。
- c87
终端启动时运行
在本地终端出现 shell 提示符之前,运行你的启动脚本。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ create 对 AI 这样说终端 2 启动时运行我的设置脚本。须知SSH 会话不会运行启动脚本。为会话选定的脚本必须使用绝对路径,且不含 `..`。
- c88
经代理的 SSH
让终端的 SSH 连接经 SOCKS5 代理到达目标服务器。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ create 对 AI 这样说经我的 SOCKS5 代理连接我的服务器。须知不检查 SSH 主机密钥。SSH 凭据和 SOCKS5 设置要放在创建请求的请求体中。
- c89
命令环境
为本地终端会话中的一条命令提供环境变量。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ execute 对 AI 这样说把 DEBUG 设为 1,运行测试。须知在 SSH 会话中,传入的变量会导出到远程 shell 并保留。
- c90
自定义终端外观
在终端链接中设置标签页标题、字体大小和背景颜色。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ 对 AI 这样说放大终端文字,把标签页标题设为 Build。须知字号范围为 8 至 72 像素。标签页标题最多 200 个字符。
- c91
屏幕阅读器模式
在链接中为浏览器终端开启屏幕阅读器支持。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ ?screenReaderMode=true 对 AI 这样说打开终端并启用屏幕阅读器支持。
终端自动化 6
- c92
等待终端输出
等到出现匹配的提示符,或屏幕稳定后,再进行下一步。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ wait 对 AI 这样说等到 Python 提示符出现。须知等待超时默认为 5,000 ms,可设为 10 至 300,000 ms。
- c93
搜索终端屏幕
在终端屏幕或滚动历史中搜索某个模式,返回匹配位置。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ find 对 AI 这样说在我的终端滚动历史里找出错误信息。须知模式最长 1,024 字节。搜索最多返回 1,000 条匹配,耗时预算为 500 ms。
- c94
终端命令历史
获取会话保留的命令记录,包括状态和退出码。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ history/ {terminal_id} 对 AI 这样说显示终端 1 中运行过的命令。须知历史记录默认是 100 条记录的滚动窗口。想要完整记录,就边运行边拉取。
- c95
导出终端输出
下载保留的终端输出,或以文本或 HTML 获取最后几行。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ raw 对 AI 这样说下载终端 1 的最新输出。须知输出默认最多保留 8 MB,超出时丢弃最早的内容。
- c96
终端截图
把终端输出变成图片,用在教程或仪表板里。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ screenshot 对 AI 这样说把我的终端保存为 PNG 截图。须知可选 PNG、JPEG 或 GIF。默认同时保存图片。
- c97
终端鼠标输入
在支持鼠标事件的终端程序里点击或滚动。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ mouse 对 AI 这样说点击我的终端程序里的菜单项。须知程序只有开启了鼠标上报,才能收到鼠标事件。HTTP 每个请求最多接受 256 个事件。
读取网页 8
- c98
页面转 Markdown
把网页转成 Markdown,附带标题和元数据。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ markdown 对 AI 这样说以 Markdown 读取这篇文章。须知只转换主框架,因此不包括 iframe 内容和 shadow DOM。
- c99
提取文章内容
获取页面正文,不含导航、侧边栏和评论。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ markdown 对 AI 这样说提取这个页面的文章正文。须知只转换主框架,因此不包括 iframe 内容和 shadow DOM。
- c100
页面 HTML 或文本
获取浏览器标签页的完整 HTML,或只获取可见文本。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ html 对 AI 这样说显示这个标签页的 HTML。 - c101
收集页面链接
获取页面中已排序、已去重的链接列表。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ markdown 对 AI 这样说列出这篇文章里的链接。须知links 数组最多包含 10,000 项。只转换主框架。
- c102
运行页面 JavaScript
在浏览器标签页中运行 JavaScript,并取回结果。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ eval 对 AI 这样说运行 JavaScript 读取页面标题。须知在默认的隐身实例上,脚本运行在隔离环境中,无法读取页面的全局变量。超时的默认值和最大值都是 30,000 ms。
- c103
截取单个元素
按原尺寸截取页面上一个可见元素。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ screenshot 对 AI 这样说只截取这个页面上的图表。须知选择器只截取第一个匹配的元素,不能与 clip 或 fullPage=true 同时使用。
- c104
遮盖截图细节
在截图中用不透明色块盖住选定的页面元素。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ screenshot 对 AI 这样说盖住这张截图里的账号。须知遮罩不会覆盖 iframe 内的元素。选择器没有匹配到任何元素时调用仍会成功,所以要检查图片。
- c105
页面无障碍快照
获取页面的结构化快照,附带元素引用。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ snapshot 对 AI 这样说显示这个页面上的无障碍控件。须知出现更新的快照或顶层文档导航后,引用会失效。已输入的表单值默认隐藏。
浏览器控制 15
- c106
连接浏览器自动化
把 Playwright 或 Puppeteer 客户端连接到 Hoody 的 Chromium 实例。
链接
https:// {p}- {c}- cdp- 1. {node}. computers. hoody. com/ 对 AI 这样说把我的 Playwright 脚本连接到 Hoody 浏览器。须知需要开启远程调试的 Chromium;Firefox 会返回 501。
- c107
独立的浏览器会话
运行多个独立的浏览器实例,各有自己的标签页和 Cookie。
对 AI 这样说为这些网站打开两个独立的浏览器会话。须知实例默认闲置 1 小时就会停止,标签页和 Cookie 随之丢弃。
- c108
等待页面变化
等待页面出现某段文本、跳转到某个 URL 或加载完成。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ wait 对 AI 这样说等到页面显示订单已确认。须知超时默认 10,000 ms,最大 30,000 ms。此调用不会启动浏览器。
- c109
处理页面对话框
接受或关闭由浏览器操作弹出的页面对话框。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ action 对 AI 这样说点击删除,并接受确认对话框。须知该策略只作用于操作触发的第一个匹配对话框;意外出现的对话框会关闭,操作随之失败。
- c110
管理浏览器标签页
列出已打开的浏览器标签页(包括弹窗),并关闭不再需要的。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ tabs 对 AI 这样说关闭浏览器里旧的购物标签页。须知不能关闭最后一个打开的标签页。
- c111
浏览器 Cookie
读取、添加或清除浏览器实例中的 Cookie。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ cookies 对 AI 这样说显示这个网站的 Cookie。须知添加的 Cookie 中只要有一个无效,就一个都不会设置。停止实例会丢弃其 Cookie。
- c112
设置浏览器所在地
浏览器启动时设置语言区域、时区和地理位置。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start 对 AI 这样说用伦敦时区启动浏览器。须知这些选项只在创建实例时生效。
- c113
浏览器走代理
让浏览器流量经过 HTTP 或 SOCKS 代理。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start 对 AI 这样说启动浏览器,并走我的代理。须知代理选项只在创建实例时生效。
- c114
Chromium 扩展
在浏览器中加载 Chromium 扩展,例如广告拦截器。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start 对 AI 这样说启动 Chromium 并加载我的广告拦截器。须知扩展需要可见的 Chromium 实例,且必须在创建实例时设置。
- c115
固定 Chrome 版本
为浏览器实例选择 Chrome 版本或发布通道。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ start 对 AI 这样说用 Chrome 136 启动浏览器。须知启动选项只在创建实例时生效。无法解析的主版本号按未填写处理,所以要查看元数据中的 browserFullVersion。
- c116
浏览器历史记录
按日期或域名浏览浏览器历史记录,或删除记录。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ history 对 AI 这样说删除 10 月之前的浏览器历史记录。须知历史默认保留 30 天,重启后仍然保留。删除后无法恢复。
- c117
浏览器控制台日志
查看浏览器最近的控制台消息和页面错误。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ console 对 AI 这样说显示我的测试页面的控制台错误。须知保留最近 500 条。默认的隐身实例只捕获浏览器上报的消息,不捕获页面的 console 调用或未捕获的错误。
- c118
浏览器网络日志
查看各浏览器标签页最近的网络请求和响应。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ network 对 AI 这样说显示我的测试页面的网络请求。须知保留最近 500 条。
- c119
打开浏览器 DevTools
获取链接,在 DevTools 中检查你的 Chromium 实例。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ devtools- url 对 AI 这样说为我的浏览器打开 DevTools。须知在 Firefox 上,或 Chromium 关闭远程调试时,无法使用 DevTools Protocol。
- c120
调整浏览器标签页大小
为运行中浏览器的所有标签页设置固定的视口大小。
链接
https:// {p}- {c}- browser- 1. {node}. computers. hoody. com/ api/ v1/ browser/ viewport 对 AI 这样说把浏览器标签页调整为 1280 × 800。须知宽和高是 1 至 8,192 的整数。已崩溃的标签页会跳过。
文件和数据 8
- c12
链接里的文件
在网页文件管理器中浏览、编辑和下载文件。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com 对 AI 这样说显示我项目文件夹里的文件。须知在你设置代理权限之前,任何拿到链接的人都可以查看和修改你的文件。
- c13
云盘集中在一处
接入 Google Drive、Dropbox、S3 等共 49 种远程存储。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com 对 AI 这样说把我 Dropbox 里的发票复制到项目里。 - c14
文件历史
用链接改过的小文本文件,可以恢复到更早的版本。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com 对 AI 这样说显示 config.json 昨天的版本。须知通过 Hoody Files 修改的文本文件,最大 2 MiB,保留 90 天,或保留到历史记录达到 2 GiB。不记录构建文件夹和 URL 下载,记录也只是尽力而为,因此不是备份。
- c15
笔记本电脑上的文件
在 Finder 或 Explorer 中打开你电脑上的文件。
对 AI 这样说把我的 Hoody 文件挂载到我的 Mac 上。须知在你设置代理权限之前,任何拿到 WebDAV 链接的人都可以挂载你的文件。
- c16
笔记本文件夹出现在电脑里
让笔记本电脑上的文件夹出现在你的电脑里。
对 AI 这样说把我的下载文件夹分享给我的 Hoody 电脑。须知Linux 或 macOS 配合 rclone 1.61 或更高版本使用;暂不支持 Windows。文件夹只在你的机器在线且命令运行期间可用,停止时会等待待处理的写入完成。
- c17
跨电脑共享文件夹
在同一台服务器上的电脑之间共享文件夹,只读或读写均可。
对 AI 这样说把 assets 文件夹分享给这个项目里的所有电脑。须知同一台服务器上的电脑之间可用。跨服务器处于试用阶段,默认关闭。
- c18
无需服务器的数据库
保存 SQL 数据库和键值数据,用链接即可访问。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com 对 AI 这样说为我的阅读清单建一个数据库。须知在你设置代理权限之前,任何拿到链接的人都可以访问数据库。
- c19
数据撤销
查看并撤销对已保存键值数据的历史改动。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com 对 AI 这样说撤销我设置的上一次改动。须知只记录通过键值 API 所做的更改。SQL 写入,以及关闭历史记录后发送的写入,无法撤销。
用链接打开的文件工具 17
- c121
从 URL 下载
把远程文件直接下载到电脑,不经过你自己的设备。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {folder}?download={url} 对 AI 这样说把这个数据集直接下载到我的电脑。须知下载达到 100 GiB 或 12 小时就会停止。
- c122
复制和移动文件
用 Files API 复制或移动文件和文件夹。
对 AI 这样说把我的报告复制到归档文件夹。须知移动绝不会替换已有的目标。复制只有带上 `?overwrite=true` 才会替换。
- c123
查看压缩包内容
列出压缩包内容,或不解压直接读取其中一个文件。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {archive}?preview 对 AI 这样说列出这个压缩包里的文件,并显示它的 README。须知支持 ZIP、TAR 和压缩的 TAR 归档。所选文件超过 100 MB 会被拒绝。
- c124
调整并转换图片
用链接缩放、转换图片,或把图片模糊、转为灰度。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {image}?thumbnail&size={size}&format={format} 对 AI 这样说把这张照片做成 256 像素的 WebP 缩略图。须知支持 JPEG、PNG、WebP、GIF 和 BMP,最大 2,000 × 2,000 像素。模糊半径为 0 至 50。
- c125
读取指定行
用链接读取文件的指定范围或最后几行。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?lines={range} 对 AI 这样说显示这份日志的最后 20 行。须知每个请求最多 100,000 行或 64 MB。
- c126
只读文件页面
在没有编辑控件的页面中打开文本文件。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {path}?view 对 AI 这样说用只读视图打开这条笔记。须知该视图不会阻止通过其他请求写入。要控制访问,设置代理权限即可。
- c127
比较文件修订
查看文件两个已记录版本之间的差异。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?diff&from_seq={from_seq}&to_seq={to_seq} 对 AI 这样说显示这两个修订之间有哪些变化。须知历史记录涵盖通过文件工具所做的修改。超过 2 MiB 的文件和二进制文件不保留差异,历史记录在 90 天后或超过 2 GiB 后清理。
- c128
追加到文件
用链接把数据添加到文件末尾,文件不存在时自动创建。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ append/ {path} 对 AI 这样说把这条记录追加到我的日志文件。 - c129
提取压缩包中的一项
提取一个文件或文件夹,压缩包的其余部分保持不变。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ {archive}?extract_file&extract={member} 对 AI 这样说只提取这个压缩包里的 images 文件夹。须知支持 ZIP、TAR 和压缩的 TAR 归档。
- c130
按范围下载文件
请求文件的指定字节,不必下载整个文件。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path} 对 AI 这样说获取这个文件的前 1 MB。须知对用 `backend` 指定的远程文件请求多个范围时,会返回整个文件。
- c131
用链接查看文件详情
查看文件的大小、所有者和权限,无需下载内容。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ stat/ {path} 对 AI 这样说查看这个文件的大小和所有者。 - c132
检查文件完整性
把文件的 SHA-256 哈希与你的副本比对,检查下载是否完整。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?hash 对 AI 这样说检查我下载的备份是否与原文件一致。 - c133
管理 URL 下载
查看电脑上 URL 下载的进度和历史,或取消下载。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ downloads 对 AI 这样说显示我正在进行的下载,并取消卡住的那个。须知取消需要根目录的写权限。取消后留下的部分文件,在挂载盘或网络文件系统上会保留。
- c134
跟踪解压进度
查看正在运行的解压任务的进度,或取消任务。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ extractions 对 AI 这样说检查我的压缩包是否还在解压。须知取消解压需要根文件夹的写权限。
- c135
文件变更审计
按路径、操作和时间查找电脑上已记录的文件变更。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ journal 对 AI 这样说显示今天这个文件夹里记录到的文件删除。须知变更日志记录通过 Hoody Files 所做的修改,不记录终端命令、脚本或程序所做的修改。
- c136
条件式文件写入
只有文件版本与预期版本一致时才写入。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path} 对 AI 这样说仅当我读取后没人改动过,才保存。须知作用于电脑上的文件,不作用于已连接的云存储。
- c137
设置上传权限
上传时设置新文件的权限位。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ files/ {path}?chmod={mode} 对 AI 这样说上传这个密钥,权限仅限所有者。须知确认 `GET /api/v1/version` 的 `features` 中列有 `put_chmod`;较旧的服务会忽略 `?chmod`。
云存储和共享存储 11
- c138
把远程存储当作文件夹
挂载已连接的存储账号,让程序把它当作文件夹使用。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ mounts 对 AI 这样说挂载我已连接的 Drive,供我的程序使用。须知写入会在 `write_back` 之后上传,默认 5 秒。两个写入方写同一个文件时,以最后一次上传为准。
- c139
多个云存储账号
连接同一个存储服务商的个人账号和工作账号。
对 AI 这样说连接我个人和工作的两个 Google Drive。须知连接数默认总共最多 100 个,每个远程主机最多 10 个。
- c140
在云存储服务商之间复制
用电脑的带宽,在已连接的服务商之间复制文件。
对 AI 这样说把这份 Drive 备份复制到我的 S3 存储桶。须知文件会先经过电脑上的一份临时副本。
- c141
连接文件服务器
把你的 SFTP、SMB、WebDAV、FTP、HDFS 或 HTTP 服务器连接到电脑。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ backends/ {protocol} 对 AI 这样说连接我团队的 SMB 文件服务器。须知连接时会检查你的登录信息;之后再把它挂载为文件夹。
- c142
挂载到手机
在手机的 WebDAV 应用里打开电脑上的文件。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ 对 AI 这样说在手机文件应用里打开我电脑上的文件。须知在你设置代理权限之前,任何拿到 WebDAV 链接的人都可以挂载你的文件。
- c143
一次性读取远程文件
无需保存存储连接,就能读取或上传远程文件。
对 AI 这样说从我的 SFTP 服务器读取一次这个文件。须知适用于 SFTP、WebDAV、FTP 和 S3。
- c144
只读的笔记本文件夹
让电脑读取笔记本上的文件夹,并防止写入。
对 AI 这样说把我的文档文件夹以只读方式分享给这台电脑。须知需要 Linux 或 macOS,并使用 rclone 1.61 或更高版本。只有你的机器在线且命令在运行时,共享才有效。
- c145
会过期的文件夹分享
为分享给另一台电脑的文件夹设置过期时间。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ storage/ shares 对 AI 这样说把这个文件夹分享给另一台电脑,到周五为止。须知共享到期后会删除,并从所有目标卸载。
- c146
接受收到的分享
接受或关闭另一台电脑向你的电脑发来的文件夹分享。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ storage/ incoming/ {shareId}/ mount 对 AI 这样说停止在这台电脑上挂载共享的素材文件夹。须知只有创建者的 enabled 标志和接收者的 mount 标志都为 true,共享才会挂载。
- c147
只读云端挂载
让已挂载的远程文件夹拒绝通过挂载路径写入。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ mounts/ {id} 对 AI 这样说把这个已挂载的云端文件夹设为只读。须知`?backend=` 路径仍然可以写入。`box`、`onedrive` 和 `protondrive` 不支持自定义设置。
- c148
上传失败的文件
找出云端挂载未能上传的文件,并下载留存的副本。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com/ api/ v1/ pending- uploads 对 AI 这样说显示正在等待上传到我的云端存储空间的文件。须知暂存的文件会一直保留,直到你交付或丢弃。暂存的副本可能不完整。
数据库和键值存储 13
- c149
SQL 事务
一起执行多条 SQL 语句,其中一条失败就全部回滚。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ db 对 AI 这样说在一个事务中更新订单及其库存。须知结果集最多 10,000 行,并带有 truncated: true;用 LIMIT 分页。
- c150
分享实时查询
分享一个链接,它会对实时数据运行你的只读 SQL 查询。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ query 对 AI 这样说生成一个显示当前订单数的链接。须知URL 携带一条只读的 SELECT,以 Base64URL 编码。
- c151
原生 SQLite 与 HTTP SQLite
同时通过本地代码和 HTTP 使用你的 SQLite 数据库。
对 AI 这样说让我的本地 worker 和仪表板使用同一个数据库。须知SQLite 每个数据库文件同一时间只允许一个写入方。不要通过存储共享在多台电脑之间共用数据库文件。
- c152
数据库备份副本
在使用过程中,为 SQLite 数据库创建一致的副本。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ maintenance 对 AI 这样说为我的数据库创建一致的备份。须知副本会写到新路径。
- c153
跟踪数据库变更
实时流式传输键值表的变更,包括 SQL 写入。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ changes/ stream 对 AI 这样说我的应用数据库中的键一有变化,就告诉我。须知日志保留 24 小时,最多 1,000,000 条变更。
- c154
让临时键过期
为保存的键设置过期时间,之后也可以修改。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ kv/ {key}/ expire 对 AI 这样说让这个会话键在 1 小时后过期。 - c155
并发安全的计数器
多个客户端累加同一个共享计数器,不丢失任何更新。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ kv/ {key}/ incr 对 AI 这样说统计我的主页的每次访问。 - c156
更新 JSON 字段
读取、写入或递增已保存 JSON 值中的某一部分。
对 AI 这样说修改 theme 字段,不替换其他设置。须知按路径设置时,存储的值需要 JSON 内容类型。
- c157
防止写入冲突
仅当共享键的版本未变时,才更新它。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ kv/ {key} 对 AI 这样说仅当设置没有被别人先改过时,才更新。须知返回 412 表示另一个客户端先写入了:重新读取,再重做修改。
- c158
把键存成文件
把键存放在一个目录中,其他工具可以把它们当作文件来编辑。
对 AI 这样说把这些设置以文件形式存放在一个目录中。 - c159
批量传入 SQL 值
用多组值执行同一条 SQL 语句。
链接
https:// {p}- {c}- sqlite- 1. {node}. computers. hoody. com/ api/ v1/ sqlite/ db 对 AI 这样说用一条 SQL 语句插入这些行。 - c160
批量键操作
一次请求最多读取、写入或删除 100 个键。
对 AI 这样说把这些设置一次性保存。须知批量写入要么全部键生效,要么都不生效。
- c161
并发安全的列表
推入、弹出或移除已保存列表中的项目,客户端之间不会发生竞争。
对 AI 这样说把这件商品加入共享购物车。
网站、脚本和链接 10
- c20
脚本变成端点
在脚本文件夹中保存一个 JavaScript 或 TypeScript 文件,它就是一个在线的 Web 端点。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> 对 AI 这样说写一个把 CSV 转成 JSON 的端点。 - c21
脚本里的 AI
脚本可以直接调用 AI 模型,无需设置密钥。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> 对 AI 这样说做一个能总结任意网页的端点。须知默认模型在服务器限额内免费。付费模型按使用量计费。
- c22
私有端点
用独立的私密令牌保护任意脚本端点。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> 对 AI 这样说锁定这个端点,只允许我的应用调用。 - c23
脚本实时事件
把运行中脚本的实时事件推送到任意页面。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ <script> 对 AI 这样说把订单的实时更新推送到我的仪表板。须知按脚本单独开启。事件不会存储,所以页面只能看到连接期间发送的事件。发送私密数据前,先添加令牌或代理权限。
- c24
网站和应用上线
你运行的 HTTP 应用直接在各自的 HTTPS 链接上线,无需部署步骤。
链接
https:// {p}- {c}- http- 8080. {node}. computers. hoody. com 对 AI 这样说做一个落地页,把链接发给我。须知在你为它设置代理权限之前,任何拿到链接的人都能打开。
- c25
你自己的域名
把任意网站或工具放到你拥有的域名上,HTTPS 已包含。
链接
https:// www. yourdomain. com 对 AI 这样说把我的网站放到 www.example.com 上。须知仅支持子域名,例如 www.example.com,不支持 example.com。每个子域名指向一个短链接;多个子域名可以共用同一个。
- c26
短链接
为任意网站或工具生成一个简短好记的链接。
链接
https:// {alias}. {node}. computers. hoody. com 对 AI 这样说给我的仪表板一个短链接。须知短链接容易猜到,在你设置代理权限之前,任何人都能打开。Free 方案每台服务器 3 个,Plus 方案 50 个,Pro 方案 250 个。
- c162
会过期的演示链接
为演示或活动链接设置过期时间。
链接
https:// api. hoody. com/ api/ v1/ proxy/ aliases 对 AI 这样说让这个演示链接在周五过期。须知到期后,别名返回 404,配置仍然保留。已停用和已到期的别名都计入服务器的别名数量上限。
- c163
把链接固定到一个页面
让别名打开一个固定的页面或 API 端点。
链接
https:// api. hoody. com/ api/ v1/ proxy/ aliases 对 AI 这样说让这个链接只打开报告页面。须知关闭路径覆盖后,其他路径返回 404。方法、请求体、WebSocket 升级和其他参数仍会通过。
- c164
暂停短链接
停用别名,之后可以恢复,配置不会丢失。
链接
https:// api. hoody. com/ api/ v1/ proxy/ aliases/ {id}/ state 对 AI 这样说把演示链接暂停到明天。须知停用期间,URL 返回 404。修改约 30 秒后到达别名 URL,有时更久。
编写脚本 12
- c165
脚本中的包
导入 npm 包,脚本运行前会先安装它。
对 AI 这样说在我的脚本中用 axios 请求那个 API。须知首次请求较慢,且需要电脑能访问 npm registry。不会检测通过计算得到的包名。
- c166
动态脚本路由
从 URL 路径中取值,供脚本使用。
对 AI 这样说创建一个从 URL 中读取 ID 的用户端点。 - c167
结构化 AI 回复
让脚本请求 AI 按指定的 JSON 结构输出。
对 AI 这样说把这段文字中的姓名和日期提取为 JSON。须知Zod schema 会自动校验响应;`jsonSchema(...)` schema 只会发送给模型,除非你传入 `validate` 函数。
- c168
流式 AI 回复
脚本边生成文本,边以流式方式返回。
对 AI 这样说让我的 AI 端点边写边流式返回答案。 - c169
脚本 WebSocket 服务
在你自己的 worker 脚本中接受 WebSocket 连接。
对 AI 这样说为我的聊天应用创建一个 WebSocket 端点。须知WebSocket 需要同时有 `// @mode worker` 和 `// @websocket`。
- c170
脚本请求中间件
对文件夹中脚本的请求,在处理前后运行你自己的代码。
对 AI 这样说为我的 API 文件夹中的脚本添加请求日志。 - c171
脚本环境变量
为脚本、文件夹或脚本根目录设置环境变量。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ env/ update 对 AI 这样说为我的发票脚本设置 API Key。须知请求必须带上文件的当前修订版本,以防止修改冲突。
- c172
脚本共享缓存
让临时值在对脚本的多次请求之间保持可用。
对 AI 这样说在请求之间缓存最新汇率。须知重启后它会完全丢失,清除或闲置淘汰也会将其清空。
- c173
每次请求使用新的上下文
每个请求都在新的 JavaScript 上下文中运行,适合相互独立的任务。
对 AI 这样说让这个 Webhook 接收端为每个请求使用新的上下文。须知新的上下文只隔离变量,不隔离副作用:已写入的文件、已启动的子进程和已发出的网络调用都会保留。
- c174
从模板生成
用内置或自定义模板生成脚本。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ templates/ generate 对 AI 这样说用模板生成我的新脚本。 - c175
运行前检查脚本
一次调用就检查脚本的语法、依赖、指令和可选的类型。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ validate/ script 对 AI 这样说保存前检查这个脚本有没有错误。 - c176
锁定脚本依赖
在包清单中锁定脚本依赖的版本。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ package/ pin 对 AI 这样说锁定我的脚本所用依赖的版本。
运行脚本 8
- c177
脚本版本历史
找回脚本的早期版本,或已删除但留有副本的脚本。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ scripts/ restore 对 AI 这样说恢复我的 Webhook 脚本的上一个版本。须知删除的脚本只有在删除时带了 `keepCopy=true`,才能恢复。
- c178
搜索脚本日志
在脚本日志中搜索文本或正则表达式。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ logs/ search 对 AI 这样说在我的脚本日志中查找超时错误。 - c179
脚本性能历史
查看脚本每小时的调用次数、失败次数和延迟。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ monitor/ script- usage 对 AI 这样说告诉我今天我的 Webhook 什么时候变慢了。须知历史记录涵盖最近 24 小时。
- c180
向运行中的脚本发消息
向运行中的脚本发送消息,并收到其处理函数的回复。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ {path} 对 AI 这样说向我正在运行的构建脚本发送一条 start 消息。须知为脚本开启 `@remote-messages`。远程操作不会运行目录中间件,所以要用令牌保护。
- c181
调用暴露的函数
调用运行中脚本暴露的函数,并获取返回结果。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ {path} 对 AI 这样说调用我正在运行的 worker 的 status 函数。须知为脚本开启 `@remote-call`。远程操作不会运行目录中间件,所以要用令牌保护。
- c182
检查运行中的脚本
调试时,针对脚本最近一次运行计算一个表达式。
对 AI 这样说检查我正在运行的 worker 中的计数器。须知它需要 `@remote-eval`,以及带有 `eval` 范围的 `@remote-token`;`@token` 解锁不了它。
- c183
脚本定时运行历史
查看过去的定时脚本运行记录,可按脚本或时间筛选。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ schedules/ history 对 AI 这样说显示我的定时报告脚本的运行时间。 - c184
测试脚本路由
一次对照脚本路由规则检查多个 URL 路径。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ route/ test 对 AI 这样说检查这些 URL 路径由哪些脚本处理。
自动运行 17
- c27
持续运行的程序
运行服务器和 worker 进程,崩溃后会自行重启。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com 对 AI 这样说让我的爬虫持续运行。须知启动时就反复失败的程序会标记为致命状态,不再重试。
- c28
给程序划边界
限制单个程序能写入、访问和使用的内容。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com 对 AI 这样说运行该工作进程,只开放 TCP 端口 443 和 53。须知适用于守护进程。只限制 TCP 端口,不针对主机;部分 Unix 套接字仍可访问,只读的根文件系统会阻止写入,但不阻止读取。
- c29
Docker 开箱即用,Kubernetes 也可以
开发 Kit 自带 Docker 和 Compose,Kubernetes 简单设置后即可在里面运行。
对 AI 这样说在 Docker 里运行测试套件。 - c30
定时任务
按计划运行任何内容,也可以让任务在设定的时间自行删除。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com 对 AI 这样说每晚 3 点备份我的数据库。 - c31
网络请求变成链接
把任意 API 调用变成可以点击、分享或按计划运行的链接。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com 对 AI 这样说做一个链接,向我的 Webhook 发送 POST 请求。须知任何拿到该链接的人都能读到其中的每个请求头和值,包括凭据。
- c32
重复调用,保存响应
按计划调用 API,把每次响应保存为文件。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com 对 AI 这样说每小时检查一次这个 API,并保存结果。 - c185
开机时启动程序
电脑每次开机,都自动启动你的程序。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ {id}/ boot 对 AI 这样说电脑每次开机,都启动我的 API 服务器。须知已启用的开机程序在你创建、启用或编辑后就可能立即启动。
- c186
首次请求时启动
有人首次请求服务的端口时,启动该服务。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add 对 AI 这样说只在有人打开我的应用时才启动它。须知需要 lazy_load 和 port_range。lazy_load 不能与 boot: true 同时使用。
- c187
读取程序日志
读取程序输出日志或错误日志的最后几行,也可以实时跟踪。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ {id}/ logs 对 AI 这样说显示我的 worker 最后 200 行错误日志。须知日志默认在达到 5 MiB 时轮转,保留 2 份备份;这两项设置都可以调整。
- c188
运行临时命令
启动一次性程序,并获取它的退出结果。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ quick- start 对 AI 这样说运行一次我的迁移,并检查退出码。须知命令运行时间超过启动窗口时,返回 running。命令结束后,状态和日志仍可访问 10 分钟。
- c189
等待服务器就绪
启动服务器,等它的端口开始接受连接后,才返回结果。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ {id}/ start 对 AI 这样说等我的 API 端口就绪后再继续。须知在程序上设置 ready_port,并使用等待式启动。
- c190
每个端口一个程序
在一段端口范围内,运行程序的多个独立实例。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add 对 AI 这样说在 8000 至 8003 端口上运行我的服务的 4 个副本。须知每个实例通过命令行参数接收自己的端口;命令中不要写端口。
- c191
可交互的守护进程
通过终端查看受管理的程序,并向它输入内容。
对 AI 这样说在终端中运行我的 worker,方便我与它交互。须知沙箱中的程序不能有 terminal_id。
- c192
程序状态概览
显示程序状态,不暴露命令或环境变量。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ overview 对 AI 这样说显示我的程序的安全状态概览。 - c193
离线沙箱工作进程
运行一个关闭了 IP 网络的工作进程,它无法访问互联网。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add 对 AI 这样说运行这个工作进程,不允许它访问 IP 网络。须知可通过路径访问的 Unix socket 仍然可用。程序必须是持久的、非 root 的 Daemons 程序。
- c194
沙箱连接速率
为沙箱中的服务设置每个来源的连接速率。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ edit/ {id} 对 AI 这样说把我的应用限制为每个来源每秒最多 50 个新连接。须知入站限制适用于新的 IPv4 TCP 连接。重建规则时,额度会重置;来源超过 65,535 个后,新的来源不再计量。
- c195
私有临时空间
给沙箱中的程序一套独立的空临时目录。
链接
https:// {p}- {c}- daemon- 1. {node}. computers. hoody. com/ api/ v1/ daemon/ programs/ add 对 AI 这样说给这个工作进程私有临时空间,每个上限 256 MiB。须知程序必须是持久的、非 root 的 Daemons 程序。临时空间在内存中,计入 max_memory。
定时任务工具 7
- c196
立即运行定时任务
立即运行已有的定时任务,并收到回执。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ users/ {user}/ entries/ {id}/ run 对 AI 这样说现在运行我的定时备份。须知条目必须存在且已启用。已暂停或已到期的条目,以及之前的 Run now 仍在运行的条目,不会运行。
- c197
检查 cron 定时设置
检查 cron 定时设置,用通俗的话读出含义,并查看接下来最多 3 次运行时间。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ schedule/ describe 对 AI 这样说检查这个 cron 表达式,显示它接下来的运行时间。须知只在重启时运行或从不触发的定时设置,下次运行时间为 null。
- c198
暂停定时任务
暂停定时任务,需要时再恢复。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ users/ {user}/ entries/ {id} 对 AI 这样说先暂停夜间备份任务。须知已暂停的任务会以注释行的形式保留在 crontab 中。
- c199
定时任务历史
查看托管任务的状态、退出码和运行时长。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ runs 对 AI 这样说我的夜间备份成功完成了吗?须知历史记录每个条目最多保留 50 次已结束的运行,保留 30 天,总共最多 10,000 次。原始行没有运行记录。
- c200
定时任务实时事件
实时跟踪任务的启动、结束和 crontab 变更。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ events/ sse 对 AI 这样说监视我的定时任务的变更和运行。须知只有托管条目会上报任务的开始和结束;你自己写的原始 crontab 行不会。
- c201
跨用户审查任务
列出电脑上各用户的托管任务,以及解析出的手写任务。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ entries 对 AI 这样说列出所有用户的定时任务。须知取回所有分页,检查 unreadable_users 和 job_lines 之后,才能认为审计完整。
- c202
编辑原始 crontab
读取并替换所选用户的完整 crontab。
链接
https:// {p}- {c}- cron- 1. {node}. computers. hoody. com/ api/ v1/ cron/ users/ {user}/ crontab 对 AI 这样说显示我的工作进程所用账号的原始 crontab。须知替换 crontab 会覆盖全部内容,包括托管条目。超过 256 KiB(262,144 字节)的请求体会被拒绝。
后台网络请求 5
- c203
后台网络请求
在后台运行耗时较长的网络请求,稍后再取结果。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request 对 AI 这样说启动这个耗时较长的 API 请求,稍后把结果给我。须知已完成的任务记录默认在 7 天后删除。
- c204
重试失败的请求
重试失败的网络传输,每次尝试之间留出间隔。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request 对 AI 这样说如果传输失败,重试这次下载。须知最多重试 5 次。重试会重新发送 POST 请求体。
- c205
Cookie 会话
用命名会话,在对同一网站的多次请求之间保留 Cookie。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request 对 AI 这样说登录后用这个会话获取我的账号数据。须知会话会保留到被删除或闲置 30 天;之后同一个 ID 会以没有 Cookie 的状态重新开始。
- c206
流式获取 API 事件
实时获取 API 的事件流,例如 AI 聊天流。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ request 对 AI 这样说实时流式获取这个 API 的事件。须知上游响应必须是带响应体的 2xx,且 Content-Type 为 text/event-stream。每个流默认最长 30 分钟。
- c207
后台请求事件
跟踪后台请求的开始、进度和完成事件。
链接
https:// {p}- {c}- curl- 1. {node}. computers. hoody. com/ api/ v1/ curl/ sse 对 AI 这样说后台下载完成时告诉我。
设备与网络之间 11
- c33
实时传送任何内容
把文件、屏幕、摄像头或数据从一台设备实时传到另一台设备。
链接
https:// {p}- {c}- pipe- 1. {node}. computers. hoody. com/ api/ v1/ pipe/ <name> 对 AI 这样说把这个文件发到我的手机。须知不存储任何内容:发送方和接收方都必须连接,先连接的一方默认最多等待 5 分钟。分享实时广播链接前,先设置发送方密钥。
- c34
桌面通知
从任意脚本在电脑桌面上弹出通知,同时在手机上收到提醒。
链接
https:// {p}- {c}- n- 1. {node}. computers. hoody. com 对 AI 这样说构建完成后,在手机上通知我。须知在每台设备的浏览器中开启一次提醒。送达尽力而为。在 iPhone 上,先把页面添加到主屏幕。
- c35
让笔记本电脑上线
把笔记本电脑上的服务器发布到电脑上该端口对应的链接。
链接
https:// {p}- {c}- http- 3000. {node}. computers. hoody. com 对 AI 这样说把我本地的 3000 端口发布上线。须知在你设置代理权限之前,任何拿到端口链接的人都可以访问。访客使用端口自己的链接;隧道链接只用于管理隧道。
- c36
连到笔记本电脑
只要笔记本电脑保持连接,电脑就能访问它上面的数据库或服务。
链接
https:// {p}- {c}- tunnel- 1. {node}. computers. hoody. com 对 AI 这样说让我的 Hoody 应用使用我笔记本电脑上的数据库。 - c37
选择流量的出口
让应用指向电脑的代理链接,它的请求就会经你选择的代理或你自己的设备发出。
链接
https:// {p}- {c}- egress. {node}. computers. hoody. com 对 AI 这样说让我的爬虫走我自己的代理。须知在你为它设置代理权限之前,任何拿到链接的人都能打开。
- c208
让电脑流量走代理
让电脑的出站 TCP 流量经由 SOCKS5、HTTP 或 HTTPS 代理。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ network 对 AI 这样说让这台电脑走我的 SOCKS5 代理。须知路由运行期间只承载 TCP。DNS 由平台解析器处理,其他出站 UDP 和 ICMP 会被阻止。
- c209
重连断开的隧道
连接断开后恢复隧道,并保留其端口。
对 AI 这样说网络短暂中断后,保持我的隧道可用。须知监听器默认保持运行 60 秒。中断期间,已打开的连接会被切断。
- c210
提供本地处理程序
无需另起服务器,就能对外提供笔记本电脑上的请求处理程序。
对 AI 这样说通过我的电脑对外提供这个本地请求处理程序。须知serve 辅助函数需要 Bun。在 Node 上,用 expose 搭配你自己的 HTTP 服务器。
- c211
查看隧道绑定
查看活跃的隧道会话及其绑定的端口。
链接
https:// {p}- {c}- tunnel- 1. {node}. computers. hoody. com/ api/ v1/ tunnel/ tunnels 对 AI 这样说显示我的隧道会话及其绑定。 - c212
临时代理出口
设置一个上游代理,客户端不续期它就会自动关闭。
链接
https:// {p}- {c}- egress- 1. {node}. computers. hoody. com/ api/ v1/ egress/ upstream?lease={seconds} 对 AI 这样说只在我的客户端持续续期时使用这个代理。须知租约时长为 5 至 3,600 秒。已有的 HTTPS 隧道在关闭前仍使用原来的出口。
- c213
独立的代理凭据
给不同客户端各自的出站代理凭据。
链接
https:// {p}- {c}- egress- 1. {node}. computers. hoody. com 对 AI 这样说给每个客户端各自的代理凭据。须知各个出站索引共用同一个上游。代理权限必须按索引分别配置。
实时传输 6
- c214
浏览器传输页面
从浏览器发送输入的文字、文件或粘贴的图片。
链接
https:// {p}- {c}- pipe- 1. {node}. computers. hoody. com/ api/ v1/ pipe/ 对 AI 这样说打开一个浏览器页面,让我发送粘贴的图片。须知电脑的访问规则必须允许该浏览器本身。
- c215
直播观看者
广播你的实时流,观看者可以随时加入和离开。
对 AI 这样说广播这份日志,让观看者在它运行期间加入。须知同时最多 256 位观看者。观看者从加入时开始接收流;无人观看时发送的字节会丢弃。
- c216
转发 TCP 端口
通过管道在两台机器之间传输 TCP 连接。
对 AI 这样说通过管道从另一台机器访问我的数据库。 - c217
双向管道
连接两个 WebSocket 对端,交换文本和二进制消息。
对 AI 这样说把这两个程序连起来,实现双向对话。须知第三个对端会收到 409。
- c218
传输进度
查看传输进度,不占用接收方名额。
链接
https:// {p}- {c}- pipe- 1. {node}. computers. hoody. com/ api/ v1/ pipe/ {name}?progress 对 AI 这样说显示这次传输的进度。 - c219
传输校验和
用服务器计算的 SHA-256 摘要校验已传输的字节。
对 AI 这样说发送这个磁盘镜像,并校验它的校验和。须知哈希命名或自命名的传输,其回执最多保留 10 分钟。
提醒和通知 4
- c220
实时通知流
把所选屏幕的通知实时推送到仪表板。
链接
https:// {p}- {c}- n- 1. {node}. computers. hoody. com/ api/ v1/ notifications/ stream 对 AI 这样说把屏幕 1 的通知实时推送到我的仪表板。须知屏幕过滤只是路由,不是访问控制。能访问流 URL 的人都可以请求所有屏幕。
- c221
通知历史
读取一个或多个屏幕上最近的通知。
链接
https:// {p}- {c}- n- 1. {node}. computers. hoody. com/ api/ v1/ notifications/ {display} 对 AI 这样说显示屏幕 1 上最近的通知。须知历史记录不含已关闭和已过期的通知,每个历史文件保留最新的 1,000 条。
- c222
选择通知紧急程度
设置通知的紧急程度和显示时长。
链接
https:// {p}- {c}- n- 1. {node}. computers. hoody. com/ api/ v1/ notifications/ notify 对 AI 这样说备份失败时显示严重警报。须知有效期可设为 0 至 300,000 毫秒。每个调用方每分钟最多可发送 10 条通知。
- c223
管理提醒设备
列出已订阅的浏览器,并从提醒中移除设备。
对 AI 这样说把我的旧浏览器从通知提醒中移除。须知默认上限为每个 Kit 50 个推送订阅。
工具和整台电脑 16
- c38
浏览器里的 VS Code
在任意浏览器里使用完整的 VS Code,手机也可以。
链接
https:// {p}- {c}- code- 1. {node}. computers. hoody. com 对 AI 这样说在 VS Code 中打开我的项目。须知扩展来自 Open VSX;其他扩展可以作为 .vsix 文件添加。
- c39
监视文件变化
文件一变化,就能实时看到动态。
链接
https:// {p}- {c}- watch- 1. {node}. computers. hoody. com 对 AI 这样说有新文件上传时通知我。须知监视服务重启后,监视器会丢失,需要重新创建。
- c40
查找任意应用
按名称在多个应用目录中查找应用,并得到运行它的命令。
链接
https:// {p}- {c}- run- 1. {node}. computers. hoody. com 对 AI 这样说帮我找找运行 Blender 的办法。 - c41
流量日志
查看到达你电脑的每个请求,可以实时看,也可以事后查。
链接
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com 对 AI 这样说今天谁访问了我的网站?须知默认每台电脑保留最近 7 天,最多 50,000 条记录或 100 MB。
- c42
防火墙
决定什么可以访问你的电脑,以及电脑可以连接到哪里。
对 AI 这样说对外部连接关闭我的数据库端口。须知仅支持 IPv4 地址和地址段,不支持域名。经由 Hoody 的 SSH 网关的 SSH 连接不受这些规则影响。
- c43
Linux 软件
安装你需要的 Linux 软件。电脑共用 Hoody 的内核,需要其他内核,就用虚拟机。
对 AI 这样说安装 Postgres,为我的应用建一个数据库。 - c44
完整的虚拟机
在电脑里以完整虚拟机运行 Windows 或另一个 Linux。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com 对 AI 这样说在我的电脑上启动一个 Windows 11 虚拟机。须知仅限租用或专用服务器,且需在电脑停止时开启 KVM。
- c224
查找失败的请求
按服务、路径、HTTP 状态或请求 ID 筛选流量日志。
链接
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com/ _logs 对 AI 这样说查找今天对我的应用的失败请求。须知日志访问遵循电脑的代理权限和已配置的保留期限。
- c225
读取已记录的消息体
检查电脑流量时,获取已存储的请求体或响应体。
链接
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com/ _logs 对 AI 这样说显示该请求已记录的响应体。须知名称看起来像机密的字段在存储前会脱敏。一页中的请求体超过 4 MiB 后,其余条目不再附带请求体。
- c226
按时间统计流量
按时间段统计匹配的代理日志条目。
链接
https:// {p}- {c}- logs- 1. {node}. computers. hoody. com/ _logs/ stats 对 AI 这样说统计我的应用今天每小时的错误数。须知每个时间桶至少 60,000 ms,每个窗口最多 240 个时间桶。
- c227
筛选监视的文件
监视所选路径,并按文件名模式或变更类型筛选事件。
链接
https:// {p}- {c}- watch- 1. {node}. computers. hoody. com/ api/ v1/ watch/ watchers 对 AI 这样说监视我的上传文件夹里的新 CSV 文件。须知监视器在服务重启后不会保留。排除模式优先于包含模式。
- c228
回放文件变更
获取监视器保留的文件事件,从指定事件 ID 或时间戳之后开始。
链接
https:// {p}- {c}- watch- 1. {node}. computers. hoody. com/ api/ v1/ watch/ watchers/ {id}/ events 对 AI 这样说显示今天早上以来保留的文件变更。须知历史记录是环形缓冲区,较早的事件可能被淘汰。监视器在服务重启后不会保留。
- c229
查找监听端口
列出监听端口,查看每个端口属于哪个程序和用户。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ system/ ports 对 AI 这样说找出监听 3000 端口的程序。 - c230
暂停和恢复进程
暂停一个进程或进程树,恢复时内存状态保持不变。
对 AI 这样说暂停我的构建,稍后恢复。须知部分系统和服务的 PID 受到保护,无法通过这些端点冻结或恢复。
- c231
服务器资源用量
查看服务器的 CPU、内存和存储空间用量。
链接
https:// api. hoody. com/ api/ v1/ rentals/ {id}/ runtime 对 AI 这样说显示我的服务器的 CPU 和内存用量。须知实时调用需要已登录的会话。与子服务器共用的租用服务器会返回 409。
- c232
暂停防火墙规则
停用单条防火墙规则,需要时再启用。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ firewall/ ingress 对 AI 这样说暂时停用这条入站防火墙规则。须知通过 Hoody 的 SSH 网关建立的 SSH 连接不受这些规则影响。
代码编辑器选项 6
- c233
用链接打开文件夹
用链接在编辑器里打开任意文件夹,无需重启编辑器。
链接
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code?folder={folder} 对 AI 这样说在编辑器中打开我的项目文件夹。须知传入已规范化的绝对路径。
- c234
团队成员各自的编辑器
给队友各自独立的编辑器实例,使用同一台电脑上的文件。
对 AI 这样说给我们各自独立的编辑器,使用同一份项目文件。须知各编辑器的设置和扩展相互独立;不支持共享光标。
- c235
独立的编辑器实例
打开独立的编辑器实例,各有自己的设置和扩展。
链接
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ 对 AI 这样说为我的客户项目打开一个独立的编辑器。须知实例共用电脑的文件和服务账号,所以互不信任的人应使用各自独立的电脑。
- c236
所有编辑器的扩展
把 URL 指向的 VS Code 扩展文件添加到电脑上的每个编辑器。
链接
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code/ extensions/ install 对 AI 这样说为我的编辑器暂存这个 VSIX 扩展。须知编辑器只在启动时安装它,所以要用 `restart=true` 重启正在运行的编辑器。
- c237
仅扩展的编辑器视图
打开一个聚焦于某个扩展侧边栏视图的编辑器链接。
链接
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code?folder={folder}&extension={extension} 对 AI 这样说单独打开 Python 扩展视图。须知如果 Code 找不到匹配的侧边栏视图,就改为显示 Explorer。
- c238
编辑器语言选择
实例启动时选择编辑器的显示语言。
链接
https:// {p}- {c}- code- 1. {node}. computers. hoody. com/ api/ v1/ code?folder={folder}&locale={locale} 对 AI 这样说用日语打开我的编辑器。须知启动选项在实例启动时生效;运行中的实例需要 `restart=true`。
查找和运行应用 4
- c239
浏览入门应用
浏览已测试的入门应用,查看每个应用在哪里打开。
链接
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ catalog 对 AI 这样说显示我电脑上的入门应用。 - c240
启动应用前预检
运行应用前,检查它的执行计划和缺少的依赖。
链接
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ preflight 对 AI 这样说检查运行这个应用需要什么。 - c241
保存应用配方
把选择和运行应用的方式保存为命名配方,之后按名称复用。
链接
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ recipes 对 AI 这样说把我偏好的 Firefox 选择保存为配方。 - c242
批量查找应用
一次请求搜索多个应用,或解析它们的命令。
链接
https:// {p}- {c}- run- 1. {node}. computers. hoody. com/ api/ v1/ run/ batch 对 AI 这样说查找这十个应用的启动命令。须知一个请求最多列出 100 项。更长的请求会整体拒绝,返回 400 `BATCH_TOO_LARGE`。
虚拟机 14
- c243
浏览器中的虚拟机屏幕
打开虚拟机的屏幕,向它发送按键和点击。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ display 对 AI 这样说打开我的虚拟机屏幕,我来完成 Linux 的安装。须知虚拟机需要配置自己的屏幕。浏览器中不支持复制粘贴,该屏幕有自己的代理权限。
- c244
虚拟机快照
有风险的改动前,先为已停止的虚拟机创建快照,改完后再恢复。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ snapshots 对 AI 这样说升级操作系统前,为我的虚拟机创建快照。须知虚拟机必须处于停止状态。恢复会替换它的磁盘、UEFI varstore 和 TPM 状态,且无法撤销。
- c245
虚拟机安装镜像下载
按 URL 为虚拟机下载安装镜像。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ isos/ downloads 对 AI 这样说为我的虚拟机下载这个 Linux 安装程序。须知有厂商提供的 SHA-256 时就填上。没有它,会在首次使用时直接信任该镜像。
- c246
暂停虚拟机
冻结虚拟机的 CPU,恢复后内存数据保持不变。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ pause 对 AI 这样说先暂停我的测试虚拟机,等我需要时再恢复。须知已暂停的虚拟机会保留其内存;停止它才能释放内存。
- c247
虚拟机端口转发
将电脑的端口转发到虚拟机内的服务。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms 对 AI 这样说将 2222 端口转发到我的虚拟机中的 SSH 服务。须知端口转发会在电脑的所有地址上打开宿主端口。要修改转发,先停止虚拟机。
- c248
虚拟机共享文件夹
在电脑和它的虚拟机之间共享文件夹。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms 对 AI 这样说给我的虚拟机一个共享文件夹,用来存放项目文件。须知虚拟机快照导出不包含共享文件夹中的文件。
- c249
克隆虚拟机磁盘
用另一台虚拟机的磁盘副本创建新虚拟机。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms 对 AI 这样说克隆我的测试虚拟机,我想试一下升级。须知源虚拟机必须处于停止状态。副本会获得新的标识和 TPM。
- c250
迁移虚拟机
导出虚拟机快照,并在另一台电脑上创建虚拟机。
对 AI 这样说把我的测试虚拟机迁移到我的另一台电脑。须知不包含共享文件夹中的文件。使用原来的磁盘总线,并在删除原件前确认目标无误。
- c251
调整虚拟机规格
修改已停止虚拟机的内存、CPU 和磁盘大小,下次启动时生效。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name} 对 AI 这样说给我已停止的虚拟机增加内存和 CPU。须知虚拟机必须处于停止状态。磁盘大小只能增大,且必须单独发送。
- c252
虚拟机自动启动
电脑重启后恢复运行时,自动启动其中的虚拟机。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name} 对 AI 这样说电脑重启后,自动启动我的虚拟机。须知自动启动默认关闭。更新它需要先停止虚拟机。
- c253
虚拟机串行控制台
读取虚拟机的串行控制台,并通过链接向它发送命令。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ console 对 AI 这样说读取我的虚拟机启动失败时的控制台输出。须知许多客户机控制台是 root shell,所以要把写入权限当作 shell 权限对待。
- c254
嵌套虚拟机
在虚拟机内运行硬件加速的虚拟机,用于测试或 CI。
对 AI 这样说在我的客户机里搭建虚拟机 CI。须知需要一台专用服务器,并通过 Hoody 客户支持申请开启嵌套虚拟化。
- c255
虚拟机客户机清单
读取虚拟机客户机的操作系统、网络地址和已登录用户。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ agent/ inventory 对 AI 这样说显示我的虚拟机内的 IP 地址。须知信息必须由 guest agent 上报。不支持或不可用的部分可能缺失。
- c256
虚拟机实时事件
实时获取虚拟机的状态和快照事件。
链接
https:// {p}- {c}- vm- 1. {node}. computers. hoody. com/ api/ v1/ vm/ vms/ {name}/ events 对 AI 这样说监视我的虚拟机的状态和快照变化。须知断开连接后不会重放事件;重新连接,再读取当前状态。
内置功能 10
- c45
共享笔记
写笔记,可加入表格、文件和评论,并实时共同编辑。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com 对 AI 这样说把今天的计划写成共享笔记。 - c46
你习惯的 SSH
用你自己的 SSH、SFTP 或 VS Code Remote 连接。
输入
ssh root@{p}-{c}- ssh. {node}. computers. hoody. com 对 AI 这样说给我电脑的 SSH 命令。须知仅限公钥,每台电脑一个密钥。
- c47
上传、搜索、压缩
上传和搜索文件,解压归档,把文件夹打包成 ZIP 下载。
链接
https:// {p}- {c}- files- 1. {node}. computers. hoody. com 对 AI 这样说压缩报告文件夹,给我一个下载链接。须知ZIP 不包含受保护的服务状态,最多包含 1,000,000 个文件。
- c48
查看运行中的程序
一眼看清 CPU、内存和磁盘的活动,并列出运行中的程序。
链接
https:/程序:用 /api/v1/system/processes。/ {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ system/ resources 对 AI 这样说我的电脑现在为什么这么慢? - c49
重启后保留的设置
把设置和密钥存为环境变量,重启后仍然保留。
链接
https:// api. hoody. com/ api/ v1/ computers/ {c}/ env 对 AI 这样说把我应用的 API Key 设为环境变量。须知运行中的程序重启后才会看到更改。任何能在电脑里运行命令的人都能读取它们。
- c50
内存级速度存储
把缓存和临时数据放在由内存支持的高速存储空间里。
对 AI 这样说把构建缓存放进 RAM 存储空间。须知默认 512 MiB,最多为服务器内存的一半,由服务器上的所有电脑共享。服务器重启时数据会清空。
- c52
电脑内 VPN
在电脑内运行 VPN 服务商提供的 WireGuard 文件,电脑的链接照常可用。
对 AI 这样说把这台电脑连接到我的 Mullvad VPN。须知用 wg-quick 启动 WireGuard 文件,不要用服务商的应用。删除其中的 IPv6 条目,保持 Network Configuration 路由为停止状态,并先添加 SSH 密钥。
- c53
录制桌面
直接在查看器里把桌面上发生的一切录制成视频文件。
链接
https:// {p}- {c}- display- 1. {node}. computers. hoody. com/ ?record=true 对 AI 这样说AI 运行演示时录制桌面。须知浏览器会录制并保存为 MP4、WebM 或 GIF。GIF 录制到 30 秒时停止,较长的录制在保存前可能会一直留在浏览器内存中。
- c54
把文件拖进终端
把文件交给终端里的程序,效果和手动拖入一样。
链接
https:// {p}- {c}- terminal- 1. {node}. computers. hoody. com/ api/ v1/ terminal/ drop 对 AI 这样说把这张截图放进我的 Claude Code 终端。 - c257
密钥不落盘
把解密后的密钥保存在内存中,不会写入磁盘、快照或备份。
对 AI 这样说在这个任务期间,把解密后的凭据保留在内存中。须知仅 Free 服务器和付费子服务器可用。宿主服务器重启时会丢失。
使用笔记 8
- c258
以 Markdown 读取笔记
以 Markdown 或 HTML 获取一页笔记,可取整页,也可按行范围取。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ document 对 AI 这样说以 Markdown 读取我的会议笔记页面。须知返回一个页面。要导出页面及其子页面,用 Notebook 导出。
- c259
查找最近的笔记
查看标题或文字最近有改动的 Notebook 页面,最新的排在最前。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ recent 对 AI 这样说显示最近改动过的页面。 - c260
追加笔记块
在笔记末尾添加文本或结构化块。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ document/ append 对 AI 这样说把今天的会议记录追加到那个页面。须知每个请求最多 100 个块。
- c261
保存笔记版本
把笔记保存为一个版本,之后可以恢复。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ versions 对 AI 这样说编辑前,先保存这条笔记的一个版本。须知恢复时,被替换的内容会保存为一个新版本。
- c262
导出笔记为 ZIP
下载整个 Notebook,或其中的某个分区、文件夹、页面或数据库,格式为 Markdown 或 HTML 的 ZIP。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ export 对 AI 这样说把我的 Notebook 导出为 Markdown ZIP。须知归档只包含你有权读取的项目。频道和消息、数据库视图和字段定义不包含在内。
- c263
笔记协作者角色
为笔记添加协作者,并选择其角色。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ nodes/ {nodeId}/ collaborators 对 AI 这样说把 Sam 添加为这条笔记的协作者。须知角色有 admin、editor、collaborator 或 viewer。你需要对该页面拥有 admin 权限。
- c264
筛选笔记记录
对笔记数据库中的记录筛选、排序,或按名称搜索。
链接
https:// {p}- {c}- notes- 1. {node}. computers. hoody. com/ api/ v1/ notes/ notebooks/ {notebookId}/ databases/ {databaseId}/ records 对 AI 这样说显示我的笔记数据库记录,按名称排序。须知列表是分页的。
- c265
可续传的笔记上传
分块上传文件到 Notebook,中断后可续传。
对 AI 这样说把这个大附件分块上传到我的 Notebook。须知只有创建该文件节点的用户才能向它上传。
02 114 行
Bots
用日常语言操作整个 Hoody。Bot 会把任务交给智能体团队。
你的 Bot 17
- b01
你的 Bot
只有一个长期聊天,用日常语言就能操作整个 Hoody。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {bot}?realm={realm} 对 AI 这样说让我的 Bot 帮我搭一个博客。 - b02
智能体团队
把任务交出去,由智能体团队完成并汇报。
对 AI 这样说让智能体团队修复失败的测试,并汇报。 - b03
不必重复说明
Bot 会跨消息保留对话,较长的对话可能会生成摘要。
对 AI 这样说从昨天停下的地方继续。 - b04
规则与范围
选择它可以操作哪些电脑,以及它必须遵守的规则。
对 AI 这样说只让我的 Bot 处理我的网站项目,绝不推送到 main。须知更改只影响新的委派。已在运行的智能体保留当初设定的限制。
- b05
分享你的 Bot
把 Bot 的 .hoody.bot 链接分享给你信任的人。他们用自己的密钥在任意浏览器里和它聊天,不需要账号。
链接
https:// <label>. hoody. bot 对 AI 这样说让我的联合创始人使用我的 Bot。须知所有人共用一个对话,每次调用都消耗你的额度或服务商密钥。可以暂停、撤销每个密钥,或按地址限制每个密钥。请求限额对所有密钥一视同仁,目前尚无支出上限。Bot URL 仅支持 IPv4。
- b06
其他 AI 应用里的 Bot
用 Bot 的 .hoody.bot URL 和一个命名密钥,连接其他 AI 应用和智能体。
链接
https:// <label>. hoody. bot/ v1 对 AI 这样说在这个应用里把我的 Hoody Bot 当作模型。须知Bot 保留自己的共享对话。只使用应用的最后一条消息,忽略它的系统提示词、工具和之前的消息。
- b07
和 Bot 说话
实时对 Bot 说话,或给它发送语音录音。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {bot}/ voice 对 AI 这样说让我开车时也能和 Bot 说话。须知每个 Bot 同一时间只能有一个语音连接,语音每天有用量限制。
- b08
语音应用里的 Bot
采用 OpenAI Realtime 的语音应用,例如 LiveKit 或 Pipecat,可以和 Bot 对话。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {bot}/ realtime 对 AI 这样说把我的语音助手连接到我的 Bot。须知每个 Bot 同一时间只能有一个语音连接。
- b10
所有聊天应用共用一个 Bot
Telegram、Slack 和 Discord 都连到同一个 Bot 和同一个对话。
对 AI 这样说也把我的 Bot 连接到团队的 Slack。须知Bot 只读取文本。文件、图片和语音消息不会转交,只转交其中的说明文字或文本。与你配对的每个人共用同一个对话。
- b29
每个 Bot 一个模型
为 Bot 自己的回复选择模型。
对 AI 这样说给我的研究 Bot 指定它自己的模型。须知Bot 启动的任务使用默认模型,除非你为该 Bot 开启了按任务选择模型。
- b30
Bot 独立默认值
为 Bot 单独设置默认模型,与你的 AI 助手分开。
对 AI 这样说给我的 Bot 使用另一个默认模型。须知跟随默认值的 Bot,会在对话重新开始时切换到它。
- b31
免提语音
免提交谈,Bot 会判断你何时开始说话、何时停止。
对 AI 这样说和我的 Bot 开始一次免提对话。须知使用耳机。全双工模式下,你可以说话打断回复。
- b32
语音提问,文字回复
用语音提问,阅读 Bot 的回答,不播放语音。
对 AI 这样说让我对 Bot 说话,并阅读它的回复。须知语音转文字仍会运行:Hoody Voice 计入你服务器的语音限额,其他服务商则会为此计费。
- b33
选择工作智能体
选择 Bot 转交工作时可以使用哪些智能体。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {id} 对 AI 这样说让这个 Bot 只使用我的审查智能体。须知列表为空表示任意智能体。
- b34
按规则检查任务
让 Bot 在开始每个新任务前,先对照它的防护规则检查。
对 AI 这样说对照我的 Bot 的防护规则检查新任务。须知严格模式下的 Bot,在检查器无法运行时会拒绝所有任务。
- b35
工作智能体自动批准
让 Bot 委派出去的智能体自动获得工具批准。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ bots/ {id} 对 AI 这样说为这个 Bot 的工作智能体开启工具自动批准。须知默认关闭。开启后,worker 会直接行动,不再先问你。
- b36
每日语音额度
为 Bot 的语音播报和转写设置每日上限。
对 AI 这样说为我的 Bot 设置每日语音额度。须知默认每个 UTC 日朗读 200,000 个字符,转写 14,400 秒。
聊天应用里的 Bot 11
- b37
配对聊天应用用户
给某人一个配对码,让对方在聊天应用中与你的 Bot 对话。
对 AI 这样说为 Sam 生成配对码,让他和我的 Bot 对话。须知将私信策略设为 pairing。新的配对码会替换上一个。
- b38
聊天中的更新
把 Bot 完成的工作、批准请求和错误发送到主聊天。
对 AI 这样说把我的 Bot 的工作更新发到我的私信。须知主聊天是聊天应用中的一个私信对话,或一个已批准的群组。
- b39
在聊天中停止
用聊天命令停止 Bot 正在做的事。
对 AI 这样说在 Telegram 中停止我的 Bot。须知发送者需要有控制权限。
- b40
选择聊天权限
选择已配对的人可以聊天、运行命令,还是决定批准。
对 AI 这样说让 Sam 可以和我的 Bot 聊天,但不能决定批准。须知开放访客只能聊天。
- b41
批准群聊
先批准一个群,群成员才能和你的 Bot 对话。
对 AI 这样说批准我们的项目群与我的 Bot 对话。须知已批准群组的每位成员都能看到 Bot 的回答。
- b42
屏蔽聊天用户
丢弃所选用户在 Bot 各个聊天中发来的消息。
对 AI 这样说禁止这个用户给我的 Bot 发消息。须知聊天应用的屏蔽用户列表最多包含 200 个平台用户 ID。
- b43
同步回复到聊天
把 Bot 从其他入口发出的回复,也发到它的主聊天。
对 AI 这样说把我的 Bot 在应用里的回复同步到它的主聊天。须知此设置默认关闭。
- b44
暂停所有聊天应用
一次暂停所有连接到 Bot 的聊天应用。
对 AI 这样说暂停我的 Bot 的所有聊天应用。须知每个聊天应用各自保存自己的启用值。
- b45
选择回复格式
为 Bot 的聊天回复选择富文本格式或纯文本。
对 AI 这样说让我的 Bot 以纯文本回复。 - b46
聊天消息频率限制
为使用 Bot 的人和聊天设置消息频率。
对 AI 这样说限制每人每分钟最多给 Bot 发 10 条消息。须知默认每人每分钟可发送 10 条消息。0 表示不做限制,最大可设为 600。
- b47
聊天通知语言
为 Bot 的聊天应用通知选择语言。
对 AI 这样说用法语显示我的聊天应用通知。须知不会翻译 Bot 自己的回答。可用语言有 en、de、fr、es、pt、it、ja 和 zh。
Bot URL 密钥和限制 6
- b48
用密钥查看 Bot 状态
检查 Bot 是否在工作,并查看待处理的批准。
对 AI 这样说检查我的 Bot 是在工作,还是在等待批准。须知需要 Bot URL Key。
- b49
跟进 Bot 事件
跟进 Bot 的实时事件,并从保存的游标继续。
对 AI 这样说从上次的游标继续跟进我的 Bot 的实时事件。须知需要 Bot URL Key。每个 Key 最多可同时打开 4 个流。
- b50
Bot 密钥到期
为 Bot URL 密钥设置到期时间,用于临时访问。
链接
https:// api. hoody. com/ api/ v1/ bot- urls/ {id}/ keys/ {keyId} 对 AI 这样说让 Sam 的 Bot 密钥在 12 月底到期。 - b51
Bot URL 访问日志
查看哪些命名密钥调用过你的 Bot,来自哪些地址。
对 AI 这样说查看我的 Bot 的访问日志,看有没有异常地址。须知尽力记录:部分拒绝不会留下日志行。日志不会保存说过的内容,也不会保存 Key 本身。
- b52
限制 Bot URL 流量
为 Bot URL 及其密钥设置请求数和并发限制。
对 AI 这样说调低我的 Bot URL 上每个密钥的请求限制。须知按 Key 设置的值适用于每个 Key。限额按请求次数计算,不按金额。
- b53
吊销所有 Bot 密钥
一次关闭 Bot URL,并吊销它的所有密钥。
链接
https:// api. hoody. com/ api/ v1/ bot- urls/ {id}/ panic 对 AI 这样说关闭我的 Bot URL,并吊销它的所有密钥。须知正在进行的调用会完成,Bot 已开始的工作会继续,直到你停止它。
你电脑里的智能体 22
- b11
所有电脑里都有 Hoody Agent
AI 智能体常驻在你的电脑中,可在标签页里打开,也可以用 SSH 或 CLI 连接。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com 对 AI 这样说打开我的 Hoody Agent。 - b12
持续运行的会话
关掉标签页,AI 仍会继续工作,可以在任意设备上接着用。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com 对 AI 这样说我不在的时候继续处理这个。 - b13
任意模型
从 100+ 家 AI 提供商中选择,或添加你自己的模型服务器。
对 AI 这样说把这个聊天换成更快的模型。须知你自己的模型服务器必须在公开的 HTTPS 地址上支持 OpenAI 或 Anthropic API。
- b14
同时使用多个模型
同时问多个模型,得到一个合并的答案。
对 AI 这样说问三个模型,把最好的答案给我。 - b15
内置 GitHub
直接在智能体里克隆、提交并发起 pull request。
对 AI 这样说用这个修复发起一个 pull request。 - b16
给 AI 添加工具
连接 MCP 服务器,给智能体添加新工具。
对 AI 这样说把我团队的 MCP 服务器添加到我的智能体。须知本地服务器以你的权限运行,没有沙箱隔离;远程服务器会收到你提供的标头。只添加你信任的服务器。
- b17
任何 AI 都能用的记忆
智能体可以保存和搜索记忆,不绑定在某一个 AI 应用上。
对 AI 这样说记住我的网站用的是 Postgres。 - b18
技能
安装技能,教智能体做新工作。
对 AI 这样说安装一个撰写发布说明的技能。 - b19
AI 按计划运行
让智能体按计划检查并执行操作。
对 AI 这样说今天每小时检查我的网站,如果哪里出了问题,告诉我。须知按设定的间隔重复,间隔至少 1 分钟,默认运行 50 次(可以设置其他次数),最多同时有 8 个活动中的循环。聊天关闭或智能体重启时停止。需要长期定时设置时,用 cron。
- b20
保存的 AI 工作流
保存 AI 工作流,想用时随时再运行。
对 AI 这样说把这个保存为我可以再次运行的工作流。 - b21
AI 的待办清单
查看 AI 排好的任务,以及它正在做什么。
对 AI 这样说你给我的项目列了哪些待办? - b22
分叉聊天
分叉一个聊天,尝试另一种思路,同时保留原来的。
对 AI 这样说分叉这个聊天,换一种设计再试。 - b23
查看 AI 用量
查看每个聊天和每个模型用了多少 AI。
对 AI 这样说我这周用了多少 AI? - b24
无需聊天的任务
给智能体派一个任务,稍后再取结果,不需要聊天。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com 对 AI 这样说在后台运行这份报告,给我一个稍后可以查看的任务。须知无头任务会自行批准每一次确认,并且可以在电脑上运行命令,所以先用代理权限锁定智能体的链接。你可以从该任务中获取结果。
- b25
智能体事件钩子
智能体启动、使用工具或结束时运行你自己的命令,沿用 Claude Code 的做法。
对 AI 这样说测试通过之前,不要让我的智能体结束。须知修改过的钩子要等你确认后才会运行。
- b26
你自己的智能体
创建你自己的智能体,每个都有自己的模型、工具和指令。
对 AI 这样说创建一个只读的审查智能体,使用便宜的模型。 - b27
先问再做
让智能体在每次执行会改动内容的操作前先问你。
对 AI 这样说改动或运行任何东西之前,先问我。须知读取无需询问即可通过。会拒绝无法询问的子智能体、工作流运行和其他嵌套运行,跳过你的钩子,也不启动 MCP 服务器。锁定模式在整个会话期间保持开启。
- b28
在手机上批准
Bot 的智能体在执行有风险的步骤前会先询问,你可以在 Telegram、Slack 或 Discord 中点按“批准”或“拒绝”。
对 AI 这样说部署任何东西之前,先在 Telegram 里问我。须知只有你允许的人才能点按这些按钮。
- b54
先规划再构建
把智能体切换到规划模式,先设计,再动手实现。
对 AI 这样说构建应用前,先规划架构。须知切回通用智能体,按计划开始构建。
- b55
应用实时预览
智能体修改文件时,实时查看应用预览更新。
对 AI 这样说构建我的应用时,启动实时预览。须知文档中的工作流会启动 Vite 开发服务器,并在电脑屏幕上的浏览器中打开它。
- b56
只看不改
用探索模式,以只读工具查看你的代码。
对 AI 这样说探索这个代码库,解释登录的工作方式。 - b57
流式查看智能体工作
智能体运行一轮时,实时查看它的工具调用、结果和消息。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {session_id}/ prompt:stream 对 AI 这样说智能体工作时,给我看它的工具调用。须知未配置代理权限时,电脑的 URL 本身就是凭证。
智能体会话 14
- b58
重命名聊天
给智能体会话起个标题,方便查找。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id} 对 AI 这样说把这个聊天重命名为“发布规划”。须知标题最多 120 个字符。
- b59
读取聊天记录
取回已保存的对话,包括工具调用及其结果。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ transcript 对 AI 这样说给我看上一个会话的记录。 - b60
截短对话
删除会话中靠后的轮次,从更早的位置继续。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ trim 对 AI 这样说把这个聊天截回到我上一次请求之前的那一轮。须知仅在两轮之间生效,一轮运行期间不生效。
- b61
同时监看多个会话
在一个流中跟踪最多 32 个实时会话的事件。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions:events 对 AI 这样说一起监控这几个智能体会话。须知只能查看实时会话。
- b62
调整推理强度
选择会话模型使用的推理强度。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ effort 对 AI 这样说把这个会话的推理强度设为高。须知级别有 low、medium、high、xhigh 和 max。
- b63
更简短的智能体回复
设置会话回复的详略程度,匹配你想要的细节量。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ verbosity 对 AI 这样说让这个会话的回复简洁些。 - b64
待回答的智能体问题
查看各个会话中等你回答的问题和确认。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ gates 对 AI 这样说给我看哪些智能体会话需要我回复。须知只列出该智能体当前持有的实时会话。
- b65
允许或拒绝工具
为会话设置规则,允许或拒绝某个智能体工具。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ approval/ rules/ {tool} 对 AI 这样说在当前会话中拒绝这个工具。须知会话策略已锁定,或每次操作前都要先询问时,不接受允许规则。
- b66
建议的问题答案
获取辅助模型对智能体挂起问题的建议答案。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ answer:assist 对 AI 这样说为我的智能体正在等待的问题建议答案。须知建议并不回答问题,真正的答案会单独发送。
- b67
引导运行中的工作流
在工作流运行时向它发送反馈。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ workflow/ messages 对 AI 这样说告诉运行中的工作流重点处理发布说明。须知仅在工作流运行期间使用。关卡挂起期间发送的消息会直接丢弃,需要在该轮结束后重新发送。
- b68
查看一轮的结果
断开连接或重启后,查询这一轮的状态和结果。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ turns/ {turn_id} 对 AI 这样说查看我的智能体上一轮是否已结束。须知对实时会话和休眠会话都有效。
- b69
等待另一个会话
让会话等待另一个会话的工作产生指定结果。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ waiters 对 AI 这样说等另一个会话汇报构建已完成。须知目标必须是同一领域中的另一个实时会话。智能体重启后,等待器不会保留。
- b70
摘要后的指令
智能体每次压缩对话时,重新带入你选定的指令。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ after- compaction 对 AI 这样说每次对话摘要之后,提醒智能体运行测试。须知最大 16 KiB。Claude Code 会话不可用。
- b71
暂停智能体工作
暂停智能体的会话,之后从停下的位置继续。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ pause 对 AI 这样说先暂停我的智能体,等我准备好再继续。须知暂停对所有领域的所有会话生效。已在运行的工作会先完成,部分独立的 Claude Code 工作不会暂停。
智能体记忆 4
- b72
关闭记忆
打开或关闭智能体的记忆隐私开关。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ enabled 对 AI 这样说关闭这个领域的记忆。 - b73
编辑记忆
更新已保存的记忆记录,你没有填写的字段保持不变。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ items/ {id} 对 AI 这样说把我保存的项目偏好更新为使用 TypeScript。 - b74
删除已保存的记忆
从智能体的记忆中删除一条或多条指定记录。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ items 对 AI 这样说删除这些过时的记忆记录。须知删除单条记录不会清除项目摘要、关系图或整合残留。
- b75
查看记忆关系
浏览项目记忆图谱中的节点和连接。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ memory/ graph 对 AI 这样说给我看这个项目记忆中的关系。
后台工作 9
- b76
立即运行循环
立即触发定时的智能体循环,不用等下一个间隔。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ loops/ {loopId}/ run- now 对 AI 这样说现在运行我的定时检查。须知已暂停的循环会触发一次,之后仍保持暂停。因熔断器而暂停的循环会恢复按计划运行。
- b77
设置循环预算
为重复运行的智能体循环设置费用和时间上限。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ loops/ {loopId} 对 AI 这样说为这个循环设置费用和时间预算。须知每次更新只改一项:暂停状态、到期时间或预算。0 表示取消上限。
- b78
按条件停止循环
让重复运行的智能体循环在满足所选条件时停止。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ loops 对 AI 这样说重复这项检查,直到满足停止条件。须知允许的最小间隔为 60 秒。max_runs 省略、为 0 或为负数时,使用默认上限 50 次运行。
- b79
流式查看无头运行
以实时事件流的形式接收智能体的无头运行。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ headless/ runs 对 AI 这样说以无头方式运行这个任务,并流式返回进度。须知无头运行会自动批准确认、计划和提问,并且可以执行代码。用代理权限保护智能体 URL。
- b80
取消智能体作业
停止排队中或运行中的异步智能体作业。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ jobs/ {id} 对 AI 这样说取消那个智能体作业。须知删除已完成的作业会同时删除它的历史记录。
- b81
读取子智能体记录
查看后台子智能体任务的记录和摘要。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ tasks/ {tid}/ transcript 对 AI 这样说给我看后台审查者做了什么。 - b82
取消子智能体任务
会话工作期间,停止一个后台子智能体任务。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ tasks/ {tid}/ cancel 对 AI 这样说取消后台调研任务。须知会话必须是实时的。
- b83
查看并停止后台 shell
列出智能体会话启动的后台 shell,并可停止其中一个。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ sessions/ {id}/ bash- jobs 对 AI 这样说给我看这个会话启动的后台 shell。 - b84
暂停钩子
停用或重新启用智能体的某个生命周期钩子。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ hooks/ toggle 对 AI 这样说关闭我的 lint 钩子。须知需要一个实时的智能体会话。
技能、工作流和任务 10
- b85
导入现有技能
把选中的 Claude 或 Codex 技能导入智能体的本地技能库。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ import/ apply 对 AI 这样说把我现有的 Claude 技能导入我的智能体。须知先扫描技能。目标位置已存在时会拒绝,除非请求覆盖。
- b86
预览技能
从技能中心预览技能,再安装到你的电脑上。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ hub/ preview 对 AI 这样说安装前先预览发布说明技能。须知预览需要搜索结果中的提供方、来源和技能 ID。
- b87
关闭技能
按名称停用某个技能,需要时再启用。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ toggle 对 AI 这样说先停用我的网页搜索技能。 - b88
编辑技能指令
读取并替换技能的源内容,改变智能体学到的东西。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ skills/ source 对 AI 这样说按我们的新格式更新我的发布说明技能。 - b89
继续工作流
从第一个未完成的步骤继续失败或已取消的工作流。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ workflows/ runs/ {run_id}/ resume 对 AI 这样说从中断的位置继续失败的工作流。须知实时会话必须处于空闲状态,并与该运行的领域、所有者、工作目录和电脑一致。一次运行只能恢复一次。
- b90
查看工作流步骤
查看每个工作流步骤的状态、耗时、token 用量和错误。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ workflows/ runs/ {run_id} 对 AI 这样说给我看那个工作流中哪一步失败了。须知运行记录仅在保留期内可用。
- b91
运行任务
启动后台 worker,自主处理你的任务。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos/ {id}/ run 对 AI 这样说为这个任务启动一个 worker。须知该请求视同人工批准,worker 不会再要求确认。检查任务本身来确认是否完成。
- b92
筛选任务
在智能体的任务列表中,按状态、标签或搜索文字查找任务。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos 对 AI 这样说给我看标记为“账单”的未完成任务。 - b93
延后任务
把任务延后到指定的唤醒时间,或清除已有的延后。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos/ {id}/ snooze 对 AI 这样说把这个任务延后到明天。 - b94
评论任务
在任务时间线上添加评论,不会再启动一轮智能体运行。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ todos/ {id}/ messages 对 AI 这样说把这条客户信息添加到任务里。
在智能体中使用 GitHub 6
- b95
审查仓库变更
以统一 diff 格式读取仓库中已暂存或未暂存的变更。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ diff 对 AI 这样说给我看我仓库里已暂存的变更。须知捕获的输出最多 1 MiB。
- b96
起草提交信息
让模型根据仓库中待提交的变更起草提交信息。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ commit/ suggest- message 对 AI 这样说为我的变更建议一条提交信息。须知diff 会发送给模型的提供方,该调用会计费。它不会提交。
- b97
GitHub 议题
在智能体中列出仓库议题,或新建议题。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ issues 对 AI 这样说为登录页面的故障新建一个议题。须知议题列表最多返回 200 个议题,按最近更新排序。
- b98
关联的工作树
创建关联的工作树,处理仓库的另一个分支。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ worktrees 对 AI 这样说为我的功能分支创建一个工作树。 - b99
切换 GitHub 账号
切换已关联的 GitHub 账号,用于智能体之后的操作。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ auth/ active 对 AI 这样说把我的智能体切换到我的工作 GitHub 账号。须知账号必须已关联。
- b100
检查远程分支
不改动当前检出,查看 GitHub 分支指向哪个提交。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ github/ remote- branch 对 AI 这样说检查我上一次推送是否已到达远程分支。须知它用你当前的账号读取 GitHub,不会改动你本地检出的任何内容。
智能体设置 15
- b101
设置 AI 支出上限
设置聊天和单轮的支出上限,用来停止工作或提醒你。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ settings/ spend- caps 对 AI 这样说为我的智能体聊天设置支出上限。须知上限以美元计,范围从 0(关闭)到 1,000,000。已在运行的工作不会中途停止。
- b102
轮换提供商账号
某个提供商的账号达到用量上限时,智能体会切换到该提供商另一个已登录的账号。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ settings/ features 对 AI 这样说为我的智能体开启账号轮换。 - b103
导入 MCP 设置
把 Claude、Cursor 或 VS Code 里的 MCP 服务器定义导入智能体。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ mcp/ import 对 AI 这样说导入我在 Cursor 里的 MCP 服务器设置。须知导入的服务器初始为禁用状态。有一个条目无效,整个导入就会中止。
- b104
测试 MCP 服务器
保存前,测试服务器配置并查看它的工具。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ mcp/ probe 对 AI 这样说在我保存前,测试这个 MCP 服务器配置。须知探测只能由人工发起,可能会启动进程或发出出站请求。
- b105
停用 MCP 服务器
关闭一个 MCP 服务器,保留它已保存的设置和凭据。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ mcp/ servers/ enable 对 AI 这样说先停用我的议题跟踪 MCP 服务器。须知禁用后,该服务器会立即在所有实时会话中断开。
- b106
领域范围的指令
设置领域内聊天、助手和工作流步骤共用的指令。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ settings/ agent- instructions 对 AI 这样说让这个领域里的每个智能体都使用美式英语。须知运行中的聊天从下一轮起生效。
- b107
复制智能体
用新名称复制智能体的定义,做出你自己的版本。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ agents/ {name}/ copy 对 AI 这样说复制我的审查智能体,方便我自定义。须知不允许复制到产品自带的 Bot 智能体名称上。
- b108
设置智能体轮次上限
设置单个智能体每次运行的最大轮次。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ agents/ {name}/ turns 对 AI 这样说给我的审查智能体设置轮次上限。须知不能用这种方式修改 Bot 智能体。
- b109
恢复智能体默认值
自定义之后,恢复内置智能体的原始定义。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ agents/ {name}/ reset- to- shipped 对 AI 这样说把这个智能体重置为内置默认值。须知重置会丢弃本地的自定义内容。
- b110
复制 Claude 设置
预览 Claude Code 配置,并在你的电脑之间复制。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ acp/ agents/ {agent}/ file- syncs 对 AI 这样说把我的 Claude Code 设置复制到我的另一台电脑。须知最多 200 个文件,总计 8 MiB,每个文件 2 MiB。凭证文件以及带有登录信息或对话的状态不包括在内。
- b111
测试提供商 API Key
检查已保存的提供商 API Key 是否有效,不会显示密钥内容。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ providers/ {id}/ auth/ test 对 AI 这样说测试我已保存的提供商 API Key。须知结论可能是有效、无效或无法确定。Key 必须已存储。
- b112
按账号查看用量
按提供商和账号分组查看 AI 用量,时间范围可选全部时间或从某个日期开始。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ usage/ by- account 对 AI 这样说显示我从周一起按账号统计的 AI 用量。须知用量按全局统计,而不是按领域划分。省略开始时间则统计全部历史用量。
- b113
选择智能体领域
选择智能体在新会话中默认使用的领域。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ hoody/ realm 对 AI 这样说新的智能体会话使用我的工作领域。须知所选内容对所有客户端生效。现有会话保留各自的领域,受领域限制的登录只能选择允许的领域。
- b114
搜索智能体日志
按会话、时间、级别或文本筛选智能体日志。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ logs 对 AI 这样说查找这个智能体会话最近 1 小时内的错误。须知每页最多 500 条,默认 200 条。
- b115
导出脱敏日志
把筛选后的智能体日志下载为脱敏的 JSONL 或文本。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ logs/ export 对 AI 这样说把智能体的错误导出为脱敏的文本文件。须知导出内容始终经过脱敏。来自平台的导出只含一页,默认 2,000 行。
03 64 行
API
在 Hoody 里能做的事,你的 AI 或脚本也都能做。
在 Hoody 上开发 13
- a01
一个 API 管所有事
在 Hoody 里能做的事,你的 AI 或脚本也都能做。
链接
https:// api. hoody. com 对 AI 这样说用 Hoody API 帮我设置好。 - a02
按需创建电脑
AI 在你的项目里创建电脑,并启动、停止或删除它们。
输入
POST https:// api. hoody. com/ api/ v1/ projects/ {p}/ computers 对 AI 这样说为这个客户项目添加电脑。 - a03
复制一套配置
把你的一台电脑复制到另一个项目或服务器。
链接
https:// api. hoody. com 对 AI 这样说复制一份我的预发布环境配置。须知副本不会带上 SSH 密钥。防火墙规则、代理别名和快照留在源电脑上。
- a04
Debian 13,开机即用
你的电脑运行 Debian 13,开发工具已装好。
链接
https:// api. hoody. com 对 AI 这样说为我的个人项目准备新电脑。 - a05
项目和领域
把电脑分组到项目里,再用领域限制每个令牌能看到和控制的内容。
链接
https:// api. hoody. com 对 AI 这样说确保这位客户的令牌只能看到他们的项目。 - a06
自动化用的令牌
给脚本和 AI 各自的令牌,只开放它们需要的权限。
链接
https:// api. hoody. com 对 AI 这样说为我的部署脚本创建一个令牌,30 天后过期,只能从我服务器的 IP 使用。 - a07
命令行
在笔记本电脑上用 `hoody` 命令完成 Hoody 的大部分操作。
输入
curl -fsSL https:/ / install. hoody. com | sh 对 AI 这样说安装 Hoody CLI 并让我登录。须知少数操作,例如立即运行 cron 任务,需要 SDK 或 HTTP API。
- a08
开源 SDK
用开源 SDK,在 TypeScript 里开发 Hoody 上的应用。
输入
npm install hoody-sdk 对 AI 这样说用 Hoody SDK 写一个列出我的电脑的脚本。 - a09
任何 AI 都能读的手册
任何 AI 读完一份手册,就会使用 Hoody。
链接
https:// hoody. com/ SKILLS/ 对 AI 这样说读取 hoody.com/SKILLS,帮我设置好。须知你的 AI 需要能联网运行代码,才能帮你登录。
- a19
从快照复制
用源电脑的指定快照创建一台独立的电脑。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ copy 对 AI 这样说用我测试过的快照创建一台预发布电脑。须知副本沿用源电脑当前的环境变量。快照历史和 SSH 密钥不会复制。
- a20
复制网络规则
把电脑的防火墙和网络规则带到新的副本中。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ copy 对 AI 这样说复制我的预发布电脑,连同它的防火墙和网络规则。须知默认不复制规则。网络或启动失败可能导致副本处于停止状态。
- a21
合并环境变量
更新多个环境变量,不会删除其他设置。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ env 对 AI 这样说在我的电脑上设置数据库 URL 和日志级别。须知每个请求可带 1 至 256 个变量。运行中的进程要重新执行后才会读取更改。
- a22
电脑状态历史
查看电脑的状态变化,排查意外停止或启动缓慢。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ status- logs 对 AI 这样说显示我的电脑何时停止,以及是什么触发的。
项目、令牌和登录 11
- a23
项目访问级别
授予其他用户项目的读取、编辑或删除权限。
链接
https:// api. hoody. com/ api/ v1/ projects/ {id}/ permissions 对 AI 这样说授予 Sam 我项目的读取权限。须知你必须是所有者,或有编辑权限。访问设置立即生效。
- a24
项目电脑配额
创建或更新项目时,设置项目的电脑数量上限。
链接
https:// api. hoody. com/ api/ v1/ projects/ {id} 对 AI 这样说把这个项目限制为 5 台电脑。须知你必须是所有者,或有编辑权限。配额最小值为 0。
- a25
项目资源统计
通过一次响应获取项目中每台电脑的资源统计。
链接
https:// api. hoody. com/ api/ v1/ projects/ {id}/ stats 对 AI 这样说显示我项目中各台电脑的资源用量。须知无法读取统计数据的电脑,可能会有一个占位条目。
- a26
项目月流量
获取整个项目每月经代理的请求数和响应字节数。
链接
https:// api. hoody. com/ api/ v1/ projects/ {id}/ proxy- usage 对 AI 这样说显示我的项目最近 3 个月经代理的流量。须知最多请求 12 个月。合计可能不完整,不含已删除的电脑、直连 SSH、原始出站流量和其他流量。
- a27
查看当前令牌
检查当前 API 令牌的权限和领域限制。
链接
https:// api. hoody. com/ api/ v1/ auth/ tokens/ me 对 AI 这样说显示我当前的令牌能访问什么。 - a28
令牌权限模板
创建令牌之前,列出权限模板及其解析后的权限。
链接
https:// api. hoody. com/ api/ v1/ auth/ tokens/ templates 对 AI 这样说显示可用的令牌权限模板。 - a29
复制令牌权限
用另一个令牌的权限、领域和 IP 白名单创建令牌。
链接
https:// api. hoody. com/ api/ v1/ auth/ tokens/ {id}/ copy 对 AI 这样说把这个令牌的限制复制到新令牌。须知副本的密钥值是新的。
- a30
调整令牌领域
为现有的受限令牌添加或移除领域。
对 AI 这样说把预发布领域添加到这个令牌。须知不能移除受领域限制的令牌的最后一个领域。
- a31
按领域统计资源
列出你的领域,并附上项目、电脑、服务器和令牌的数量。
链接
https:// api. hoody. com/ api/ v1/ realms/ ?include_usage=true 对 AI 这样说统计我每个领域中的资源。须知该请求需要 resources.realms 权限。
- a32
设备码登录
发起设备登录,用户输入一个短码即可。
链接
https:// api. hoody. com/ api/ v1/ auth/ device/ code 对 AI 这样说为我的应用发起设备码登录。须知该流程参考了 RFC 8628,但不是符合标准的设备授权。
- a33
应用身份声明
向你的应用证明这个用户已通过 Hoody 登录,并用公钥离线校验。
链接
https:// api. hoody. com/ api/ v1/ users/ auth/ identity- claim 对 AI 这样说为我的应用签发身份声明。须知仅限已登录的会话,不支持认证令牌。声明默认有效 1 小时,且不会超过你的会话时长。
命令行工具 5
- a34
CLI 账号配置
在不同账号或环境之间切换 CLI 设置和登录。
对 AI 这样说为预发布环境设置单独的 CLI 配置。 - a35
预览 CLI 请求
查看 CLI 命令将发送的 HTTP 请求,或获取对应的 curl 命令行。
对 AI 这样说显示删除这台电脑的 HTTP 请求。须知密钥值会脱敏,部分正文不返回。按名称查找仍可能发出 GET 请求。
- a36
等待 CLI 操作
让脚本等待耗时较长的操作完成。
对 AI 这样说复制这台电脑,并等到复制完成。须知默认等待超时为 10 分钟。
- a37
监视 CLI 列表
资源变化时,反复刷新 CLI 列表。
对 AI 这样说每 5 秒刷新一次我的电脑列表。须知需要交互式终端。默认间隔为 2 秒。
- a38
锁定本地 CLI 凭据
用密码加密已保存的 CLI 令牌和默认 ID。
对 AI 这样说用密码保护我已保存的 CLI 凭据。须知开启锁定会删除已保存的账号密码。
智能体构建模块 4
- a39
单次模型回复
为你的应用获取一次模型回复,可以是 JSON 或流式,不需要智能体会话。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ completions 对 AI 这样说为这段文本获取一次模型回复。须知没有会话、转录记录和工具调用。每次调用都计费。
- a40
直接运行工具
直接调用智能体工具,在你的应用中接收结果。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ tools/ {name}/ run 对 AI 这样说调用这个智能体工具并返回结果。须知会改动内容的工具只有在你选择启用时才会运行,运行前可能先要求确认。仅在这台电脑上运行。
- a41
查看智能体工具
列出智能体的内置工具,并查看它们的输入结构。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ tools 对 AI 这样说显示智能体内置工具的输入。 - a42
监视智能体数据变化
以流式推送变更通知,让你的应用刷新受影响的智能体数据。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ changes/ stream 对 AI 这样说智能体数据变化时,更新我的仪表板。须知令牌只表明哪些列表有变化,由你的应用重新读取这些列表。
你的应用和 AI 模型 14
- a10
嵌入实时工具
把实时的终端、桌面、编辑器或数据库放进你自己的页面。
链接
https:/在 iframe 中/ {p}- {c}- terminal- 1. {node}. computers. hoody. com 对 AI 这样说在我的仪表板页面里显示实时终端。须知嵌入他人可见的链接之前,先设置代理权限。
- a11
每个请求都先过你的 Exec 脚本
匹配的请求会先交给你的 Exec 脚本:检查、修改或直接应答。
对 AI 这样说加一道检查,拦截不带我指定请求头的请求。须知路径匹配时会拒绝 WebSocket 升级,所以匹配范围里不要包含这些路径。钩子在 500 ms 后超时,除非你设置更长的时间,最长 30 秒。
- a12
用链接调用 AI 模型
在你的电脑上调用众多 AI 模型,不需要 API Key。
对 AI 这样说用便宜的模型给这 1,000 张照片打标签。须知付费模型按用量从你的 AI 余额扣费,免费模型每台服务器有用量限制。不含 OpenAI、Anthropic 或 Google 的模型。
- a13
查看 AI 调用
让 AI 调用经过 Exec 脚本,记录日志、缓存或修改。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 对 AI 这样说记录我的应用发出的每次 AI 调用。 - a14
语音输入与输出
把文字转成语音,也把语音转成文字。
链接
https:/· `.../audio/transcriptions`/ ai. hoody. com/ api/ v1/ audio/ speech 对 AI 这样说把这篇文章朗读出来,保存为音频文件。须知在服务器的语音限额内免费,在你的电脑内使用。
- a16
免费网页搜索
电脑里的代码无需 API Key 就能搜索网页,在服务器限额内免费。
输入
POST https:// ai. hoody. com/ api/ v1/ coding_plan/ search 对 AI 这样说搜索网页,看看别人怎么修复这个错误。须知在服务器的限额内免费,在你的电脑内使用。
- a17
AI 的是/否回答
向 Hoody AI 提出是非题、单选题或打分题,得到每个答案的可能性。
输入
POST https:// ai. hoody. com/ api/ v1/ decisions 对 AI 这样说让 AI 判断每个支持工单是否紧急。须知在服务器的限额内免费,在你的电脑内使用。
- a18
每台电脑的 AI 开关
为每台电脑开启或关闭 AI,并查看各自的用量。
对 AI 这样说关闭我客户那台电脑上的 AI。 - a43
打开指定视图
生成指向所选文件编辑器、终端会话或数据库表视图的链接。
对 AI 这样说生成指向 users 表视图的链接。须知部分视图需要参数,禁止嵌入的视图必须在新标签页中打开。
- a44
导入 API
把另一个 API 的 OpenAPI 文档转成可转发调用的脚本端点。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ sdk/ import 对 AI 这样说把这份 API 规范导入为脚本端点。 - a45
为脚本 API 生成文档
为你的脚本生成 OpenAPI 规范。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1/ exec/ user- openapi/ generate 对 AI 这样说为我的脚本生成 OpenAPI 规范。 - a46
改写服务响应
在响应到达调用方之前,查看并修改服务的响应。
对 AI 这样说为我的应用的响应添加一个 header。须知会拒绝路径匹配某个 hook 的 WebSocket 升级。每个服务最多 8 个 hook,每台电脑最多 32 个。
- a47
读取访客 IP
在通过 Hoody 链接访问的应用中,读取访客的真实 IP 地址。
对 AI 这样说在我的应用访问日志中显示访客 IP。须知代理 hook 转发请求时,应用看到的是该 hook 的连接地址。
- a48
查询访客网络
查询访客公网 IPv4 地址所属的国家和网络信息。
链接
https:// api. hoody. com/ api/ v1/ ip/ lookup?ip={ips} 对 AI 这样说显示这些访客 IP 所属的国家。须知每次查询最多 25 个公网 IPv4 地址。Hoody 没有数据的地址会返回 null。
Hoody AI 模型 8
- a49
浏览模型目录
列出可用模型及其上下文长度、模态和当前价格。
链接
https:// api. hoody. com/ api/ v1/ ai/ models 对 AI 这样说列出可用的 AI 模型及其上下文长度。须知目录已缓存。不含 OpenAI、Anthropic 和 Google 的模型。
- a50
流式输出模型回答
模型生成回答的同时,把文本显示给你的用户。
对 AI 这样说把回答流式输出到我的聊天应用。须知在已启用 AI 的电脑内调用。
- a51
连接编程助手
在你的电脑上,让 Cline、Cursor 或 Windsurf 使用 Hoody AI。
对 AI 这样说在我的电脑上把 Cline 连接到 Hoody AI。须知该工具必须在电脑内运行。Cursor Tab 补全仍使用 Cursor 的内置模型。
- a52
使用模型工具调用
随聊天请求发送工具定义,供支持的模型使用。
对 AI 这样说让我的模型调用天气函数。须知回答的模型支持工具时才可用。在已启用 AI 的电脑内调用。
- a53
根据截图做判断
向 Hoody AI 询问关于截图的是非问题,例如页面是否出错。
对 AI 这样说检查这张结账截图是否看起来出错了。须知支持 PNG、JPEG、WebP 和 GIF,每个请求最多 4 张图片,解码后每张最大 1 MiB。不接受远程图片 URL。
- a54
用你自己的模型做判断
通过智能体提出是非、单选或打分问题,由你选择的模型作答。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ jev/ decide 对 AI 这样说让智能体用我配置的模型对这张工单分类。须知其他提供方的模型需要该提供方的 Key。
- a55
查看免费 AI 额度
大致查看你的账号已用掉每台服务器多少免费 AI 额度。
链接
https:// api. hoody. com/ api/ v1/ users/ me/ free- ai- usage 对 AI 这样说按服务器显示我的免费 AI 用量。须知读数是近似值。认证令牌需要 `computers.read`,受领域限制的令牌会得到 `403`。
- a56
删除 AI 用量记录
删除电脑中早于指定时间的 AI 用量记录。
对 AI 这样说删除这台电脑 1 月之前的 AI 用量记录。须知删除只作用于发起调用的电脑。处理中请求的行不会删除。
语音和音频 5
- a57
转写常见音频格式
把 WAV、MP3、WebM、OGG、M4A 或 FLAC 录音转成文本,可上传,也可用 base64。
对 AI 这样说转写这段 M4A 语音备忘录。须知音频最大 25 MB(25,000,000 字节),最长 600 秒。不接受音频 URL。可在电脑内调用。
- a58
选择朗读语音
从 4 种声音中选一种,把文本转成 PCM 或 MP3 音频。
对 AI 这样说用 Bella 的声音朗读这条笔记,输出 MP3。须知文本最多 4,096 个字符。Hoody Voice 在电脑内工作,受其服务器语音限额约束。
- a59
流式输出语音音频
语音生成后立即流式传输到你的应用。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ audio/ speech/ stream 对 AI 这样说把语音回答流式传输到我的应用。须知仅适用于能流式输出语音的模型。
- a60
为转录文本加时间戳
有分段和时间信息可用时,请求带分段和时间的转录文本。
对 AI 这样说转录这段录音,并附上分段时间戳。须知音频最大 25 MB(25,000,000 字节),最长 600 秒。分段字段可能缺失或为 null。
- a61
查找语音模型
列出语音模型,并按转录或语音能力筛选。
链接
https:// {p}- {c}- agent- 1. {node}. computers. hoody. com/ api/ v1/ agent/ audio/ models 对 AI 这样说列出我的智能体可用的语音转文字模型。须知列出的模型在某次调用时仍可能不可用。
AI 请求代理 4
- a62
审核有风险的 AI 请求
在你的代理中暂存 AI 请求,直到有人批准或拒绝。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 对 AI 这样说把有风险的 AI 请求暂存,等我批准后再放行。须知批准和拒绝脚本需要你自己添加。没有它们,挂起的请求会以 408 结束。
- a63
为提示词添加知识
用代理脚本把知识库结果加入提示词。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 对 AI 这样说把相关的公司文档加入每条 AI 提示词。须知分享代理前,先用脚本令牌和代理权限保护它。
- a64
转发到其他提供商
用代理脚本把 AI 请求发送到你选择的提供商。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 对 AI 这样说把这个应用的 AI 请求转发到我的提供商。须知提供方 Key 和代理安全由你自己管理。
- a65
改写 AI 工具调用
在客户端运行之前,用代理修改模型的工具调用。
链接
https:// {p}- {c}- exec- 1. {node}. computers. hoody. com/ api/ v1 对 AI 这样说把 AI 写入文件的操作重定向到我的审核文件夹。须知改写只是路由,不是隔离。限制要在执行调用的工具里落实。
04 58 行
所有功能通用
无论你从哪里进入,这些对全部功能都成立。
链接、分享和安全 12
- x01
一切都是 URL
每个工具、文件、应用和 Bot 都有自己的链接。
链接
https:// {p}- {c}- <kit>- 1. {node}. computers. hoody. com 对 AI 这样说把那个链接发给我。 - x02
实时协作
分享一个链接,大家同时在同一个终端、桌面或编辑器里工作。
对 AI 这样说把我的终端分享给 Sam,我们一起解决这个问题。须知链接里没有 ?sharing=true&steal=false 时,桌面上的第二个人会从第一个人手中接管。
- x03
人和 AI 一起
人和 AI 在同样的工具里并肩工作,怎么搭配都行。
对 AI 这样说让我的 AI 在同一个桌面上工作,我在旁边看。 - x04
快照与撤销
保存电脑存储空间的快照,一步恢复。
链接
https:// api. hoody. com 对 AI 这样说改动之前先创建快照。须知同一台服务器上的回滚点,不是备份:它会随电脑一起删除。恢复会替换当前存储空间,并丢弃之后的更改。已挂载的存储和运行中的进程不会保存。
- x05
私密链接
生成的链接很难猜到,但公开链接可能泄露,任何拿到它的人都能使用。短链接可以被猜到:要真正控制访问,就锁定任意链接。
对 AI 这样说这个链接是私密的吗? - x06
锁定任意链接
给电脑的链接加上密码、登录或 IP 列表,再选择该组可以打开哪些程序。
对 AI 这样说分享之前,给我的桌面链接设置密码。 - x07
查看发生了什么
查看登录记录、你已认证的 API 调用及所用的令牌,以及每台电脑提供的流量。
对 AI 这样说显示我的 AI 令牌本周发起了哪些 API 调用。 - x08
加密保险库
把密码和密钥存放在保险库里,并为每个条目开启加密。
对 AI 这样说把我的 Stripe 密钥存进保险库。 - x23
磁盘加密
在 Hoody 的每台服务器上,你的电脑磁盘都是静态加密的。
对 AI 这样说我的电脑磁盘加密了吗?须知磁盘加密不能保护运行中服务器上的数据。
- x24
暂停 URL 访问
排查事件期间,切断对你电脑 URL 的新请求。
链接
https:// api. hoody. com/ api/ v1/ computers/ {c}/ proxy/ permissions/ state 对 AI 这样说暂停访问这台电脑的 URL。须知生效可能需要几秒或更久。SSH 以及已建立的 WebSocket 或 CONNECT 隧道会保持打开。
- x25
会过期的快照
设置电脑快照在指定天数后过期。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ snapshots 对 AI 这样说创建一个部署前快照,30 天后过期。须知有效期是 1 至 3,650 之间的整数天数。创建后检查 `expires_at`:创建成功时它也可能为 null。
- x26
为快照加标签
修改快照的标签,标记电脑的已知良好状态。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ snapshots/ {name}/ alias 对 AI 这样说把那个快照标记为已测试的发布版本。须知别名最多 100 个字符。修改别名不会重命名快照。
链接访问规则 8
- x27
仅限 Hoody 用户
只允许已登录的 Hoody 用户,或你列出的用户 ID,调用你的服务。
对 AI 这样说只允许已登录的 Hoody 用户调用我的 API。须知调用方在请求头中发送已签名的 Hoody 身份声明。允许列表最多容纳 256 个用户 ID。
- x28
合作伙伴访问令牌
合作伙伴带上请求头、Cookie 或查询参数中的令牌,即可访问。
对 AI 这样说给我的合作伙伴一个 API 令牌。须知分组必须有程序授权,未匹配的调用方仍适用默认策略。
- x29
应用的 JWT 访问
让应用的用户用你的应用签发的令牌,打开指定的服务。
对 AI 这样说访问我的应用服务时,要求出示应用的 JWT。须知分组必须有程序授权,未匹配的调用方仍适用默认策略。
- x30
保护新服务
把默认设为拒绝,之后添加的程序在你授权前保持关闭。
对 AI 这样说新服务在我授权前保持关闭。须知先设置好分组。在 allow 策略下,新程序从一开始就是开放的。
- x31
项目级 URL 规则
在整个项目中应用 URL 访问规则,并可在单台电脑上覆盖。
对 AI 这样说把团队访问策略应用到这个项目。须知两者重叠时以电脑的值为准,电脑未提及的项目分组仍然有效。
- x32
开放指定的应用端口
为访问组开放 HTTP 或 HTTPS 应用的指定端口。
对 AI 这样说允许合作伙伴组访问 8080 端口。须知每个单元格最多开放 16,384 个端口。授权会开放这些端口上监听的所有内容。
- x33
选择终端实例
让一个组访问你电脑上的指定终端实例。
对 AI 这样说让团队使用终端 1 和 2。须知设置默认拒绝策略,把未匹配的调用方挡在外面。
- x34
查看服务访问
一并查看服务的组访问、钩子和生效的默认规则。
链接
https:// api. hoody. com/ api/ v1/ computers/ {id}/ proxy/ services/ {service} 对 AI 这样说显示我的终端的访问规则。
接入方式 7
- x09
说 @hoody.com
对你的 AI 说“@https://hoody.com Connect to Hoody”,即可开始。
输入
@https:// hoody. com 对 AI 这样说@https://hoody.com Connect to Hoody须知你的 AI 需要能联网运行代码,才能帮你登录。
- x10
ssh hoody.com
在任意终端输入 `ssh hoody.com`,或点击它在浏览器中打开。
输入
ssh hoody.· `https://ssh.hoody.com`com 对 AI 这样说我怎么从终端进入? - x11
在任意浏览器中打开
在任意设备上登录 hub.hoody.com,打开你的 Hub:电脑和智能体都在里面。
链接
https:// hub. hoody. com 对 AI 这样说在浏览器中打开我的 Hoody。 - x12
手机优先
在手机上使用全部功能,还能把你做的东西安装成应用。
对 AI 这样说让这个仪表盘可以安装到我的手机上。 - x13
搭建你自己的 OS
用纯 HTML 搭建你自己的网页桌面或完整工作流。
对 AI 这样说给我做一个主屏幕,放上我的终端、笔记和网站。 - x35
终端中的 Hub
在交互式终端中全屏打开你账号的 Hub。
对 AI 这样说在终端中打开我的 Hub。须知独立的终端版 Hub 支持 Linux x64 和 arm64,可在电脑内使用,也可通过托管 CLI 使用。npm 版本需要 Node.js 26 或更高版本。
- x36
试用示例账号
用示例账号体验终端版 Hub,无需登录。
对 AI 这样说打开 Hub 的示例账号。须知终端版 Hub 需要交互式终端。
你的 AI,你的方案 6
- x14
你的 ChatGPT 或 Claude 方案
使用 ChatGPT 方案,或通过 Claude Code 使用 Claude 方案,也可以用免费的内置 AI。
对 AI 这样说用我的 ChatGPT 方案登录。须知Claude 方案通过电脑上的 Claude Code 使用,用 Claude Code 自己的账号登录。适用于新的 Hub 对话,不适用于 Bot。
- x15
Hoody AI(免费)
免费的内置 AI,不需要 API Key,也无需设置,在你的电脑内直接使用。
对 AI 这样说先用免费模型。须知限额按服务器计算,由该服务器上的所有电脑共享。
- x16
换 AI,一切照旧
随时更换 AI;文件、项目、记忆和任务都会保留。
对 AI 这样说把我的工作转到新的 AI 上。 - x17
可免费开始
免费开始:一台免费服务器,最多 3 台持续运行的电脑,不会过期。
对 AI 这样说帮我开通 Free 方案。须知每个符合条件的账号可获得一台免费服务器,免费容量用完即止。
- x18
收益明显时再升级
需要更多空间时,添加 Plus 或 Pro 方案的服务器,或租用整台 Bare metal 服务器。
对 AI 这样说为这个项目租一台配置更高的服务器。须知免费服务器不能原地升级。付费服务器每月 10 美元起。
- x19
按你的方式付款
用银行卡或加密货币付款,并按角色与团队共享服务器。
对 AI 这样说用加密货币给我的余额充值。
服务器和方案 9
- x37
按地域查找服务器
租用前,按位置、配置和价格筛选可用的服务器。
对 AI 这样说找一台离我的欧洲用户近的服务器。须知起租 1 天;价格因商品和租期而异。
- x38
查看在售方案
列出在售的付费服务器方案,以及各自的短链接和 Bot URL 上限。
链接
https:// api. hoody. com/ api/ v1/ subserver- plans 对 AI 这样说显示在售的付费服务器方案。须知购买报价会说明该方案此刻能否购买。
- x39
把 Plus 升级到 Pro
把 Plus 服务器升级到 Pro,保留其 ID 和数据。
对 AI 这样说把我的 Plus 服务器升级到 Pro。须知升级会按当前周期剩余时间收取差价。运行中的电脑会重启,已停止的电脑保持停止。
- x40
查询服务器方案报价
购买前,查看付费服务器方案的当前价格和可用容量。
链接
https:// api. hoody. com/ api/ v1/ subserver- subscriptions/ quote 对 AI 这样说查询 Plus 服务器方案的当前价格。 - x41
检查免费服务器资格
检查你的账号能否领取免费服务器,以及不能领取的原因。
链接
https:// api. hoody. com/ api/ v1/ users/ me/ free- tier- status 对 AI 这样说我的账号能领取免费服务器吗?须知该端点只报告状态,不会认领服务器。认证令牌需要 resources.read_account 权限。
- x42
服务器续费设置
开启或关闭付费服务器的自动续费。
链接
https:// api. hoody. com/ api/ v1/ subserver- subscriptions/ {id}/ auto- renew 对 AI 这样说关闭这台服务器的自动续费。须知只有账号所有者或认证令牌可以开启。关闭后,服务器会在已付费周期结束时停止。
- x43
延长服务器租用期限
用 API 给现有的服务器租用增加天数。
链接
https:// api. hoody. com/ api/ v1/ rentals/ {id}/ extend 对 AI 这样说把我的服务器租用期限延长 30 天。须知追加天数为 1 至 3,650,且必须与服务器定价一致。
- x44
预订一台在售服务器
预订缺货的机器,到货后交付,并设置扣费上限。
链接
https:// api. hoody. com/ api/ v1/ offers/ {id}/ reserve 对 AI 这样说把这个服务器报价预留 30 天。须知预订会立即扣费。付费预订需要提供扣费上限和幂等键。
- x45
Bare metal 服务器命令
用 API 查看已租用的 Bare metal 服务器的运行时间或内存,或重启它。
链接
https:// api. hoody. com/ api/ v1/ servers/ {serverId}/ execute- command 对 AI 这样说查看我的 Bare metal 服务器的运行时间。须知仅限内置命令,且需在租期有效的专用 Bare metal 服务器上使用。
你的账号 12
- x20
双重验证登录
用验证器应用和备份码保护你的账号。
对 AI 这样说为我的账号开启双重验证登录。 - x21
赚取推荐额度
分享你的推荐链接,你邀请的人付费后,你会获得可用于服务器的额度。
对 AI 这样说把我的 Hoody 推荐链接给我。须知用银行卡或加密货币支付服务器费用后开放。额度在 60 天的保留期后到账,每位客户 12 个月,只能用于支付服务器费用。
- x22
支持工单
在 CLI 或 API 中提交支持工单,并跟进回复。
链接
https:// api. hoody. com/ api/ v1/ support/ tickets 对 AI 这样说提交一个支持工单,说明我的电脑无法启动。 - x46
结束一个登录会话
让一台忘记退出的设备退出登录,同时保留你的其他会话。
链接
https:// api. hoody. com/ api/ v1/ users/ auth/ sessions/ {id} 对 AI 这样说退出我旧笔记本电脑上的会话。须知只有你自己已登录的会话可以调用。结束会话不会删除会话期间创建的令牌。
- x47
退出其他设备
结束账号的其他所有会话,保留当前登录。
链接
https:// api. hoody. com/ api/ v1/ users/ auth/ sessions/ revoke- others 对 AI 这样说退出我的所有其他设备。须知只有你自己已登录的会话可以调用。结束会话不会删除这些会话期间创建的令牌。
- x48
更换备份码
如果旧的两步验证备份码已泄露,生成一组新的。
链接
https:// api. hoody. com/ api/ v1/ users/ auth/ 2fa/ backup- codes/ regenerate 对 AI 这样说为我的账号生成新的两步验证备份码。须知需要你的密码和当前 OTP 验证码。现有备份码会失效。
- x49
查看被拒绝的登录
查看账号安全历史时,包含失败的登录尝试。
链接
https:// api. hoody. com/ api/ v1/ users/ me/ security- history?include_failed=true 对 AI 这样说显示我账号上被拒绝的登录尝试。须知API 令牌需要 resources.read_account。账号审计记录保留 180 天。
- x50
更改账号邮箱
申请新的账号邮箱,并在新地址中确认。
链接
https:// api. hoody. com/ api/ v1/ users/ me/ email- change 对 AI 这样说更改我账号的邮箱地址。须知需要你自己已登录的会话和当前密码;如已启用两步验证,还需要验证码。确认链接 24 小时内有效。
- x51
客户支持回复提醒
客户支持回复你的工单时,收到应用内通知。
对 AI 这样说客户支持回复时通知我。须知同一工单的多条回复可以合并为一条通知,每个工单每 10 分钟最多一条。通知中不会标明是哪个工单。
- x52
自定义推荐码
为你邀请来 Hoody 的人创建一个好记的推荐码。
链接
https:// api. hoody. com/ api/ v1/ referrals/ me/ codes 对 AI 这样说创建一个名为 alex-builds 的推荐码。须知同一时间最多可有 3 个有效的自定义邀请码,账号累计最多 10 个。创建邀请码需要已登录的会话和推荐计划成员资格。
- x53
跟踪推荐收益
查看你的推荐码、等级、数量和额度总计。
链接
https:// api. hoody. com/ api/ v1/ referrals/ me 对 AI 这样说显示我的推荐等级和额度总计。须知不显示被推荐人的姓名和账号详情。认证令牌需要 financial.wallet.read,且不能受领域限制。
- x54
提取推荐额度
达到 Creator 等级后,可通过客户支持把可用的推荐额度提取为现金。
对 AI 这样说向客户支持咨询提取我的推荐额度。须知默认关闭,客户支持会核实每个请求。部分情况下通过银行转账或加密货币;冻结中的余额不能提现。
余额和发票 4
- x55
查看所有余额
一次调用查看你的通用余额、推荐额度和 AI 余额。
链接
https:// api. hoody. com/ api/ v1/ wallet/ balances 对 AI 这样说显示我所有的 Hoody 余额。须知使用已登录的会话,或拥有对应权限的账号级认证令牌。受领域限制的令牌不能读取余额。
- x56
查看钱包交易
在一份交易记录里查看你的付款、扣费、转账和退款。
链接
https:// api. hoody. com/ api/ v1/ wallet/ transactions 对 AI 这样说显示我最近的 Hoody 扣费和退款。须知使用已登录的会话,或拥有对应权限的账号级认证令牌。受领域限制的令牌不能读取交易记录。
- x57
下载发票 PDF
把发票下载为 PDF,用于记账、报税或向客户结算。
链接
https:// api. hoody. com/ api/ v1/ wallet/ invoices/ {id}/ pdf 对 AI 这样说下载我最新发票的 PDF。须知使用已登录的会话,或拥有对应权限的账号级认证令牌。受领域限制的令牌不能读取发票。
- x58
查询付款
按 intent ID 查询银行卡或加密货币付款。
对 AI 这样说查看我的加密货币充值是否已到账。须知查询支付记录需要已登录的会话。不接受认证令牌。