跳到正文
你的 AI@https://hoody.com Connect to Hoody
hoody / capabilities

Hoody 能做的一切

Hoody 能做的事
五个理念, 500 行

Hoody 是几个理念,反复使用。先看五个理念,再看用平实语言写成的基本构件: 500 行,分为 52 组。每行说明要对你的 AI 说什么。多数行还说明依赖这些功能前需要了解的事项,并附有文档链接。你的 AI 会把它们组合出更多用法。

用 id 链接到某一行,例如 /capabilities/#c120。用浏览器的查找功能搜索本页。

hoody / capabilities / ideas

列表之前

每行背后的五个理念

列表很长,理念很少。下面的每一行,都是这五个理念之一在起作用。

你的 AI

思考和对话。

Hoody AI 内置且免费。也可以用你的 ChatGPT 或 Claude 方案,或者其他 AI。

Hoody

归你所有的基础。

Hoody 替你托管并运行基础设施。你的 AI 可以使用其中的每个部分。

Kit

所有服务已包含,每个都有自己的 URL。

每台电脑里都有终端、桌面、文件、浏览器、数据库等。查看 Kit

  1. 始终在线的电脑

    Hoody 电脑是云端的一台完整 Linux 电脑,关闭标签页后仍会持续运行。

    一个请求即可创建POST https://api.hoody.com/api/v1/projects/{p}/computers
    这对你意味着什么

    你不在时,网站、任务和文件照常运行。向 AI 要一台电脑,电脑随即就绪。

    c01 始终在线的电脑a02 按需创建的电脑x04 快照与撤销docs / concepts / computers

  2. 每样东西都有 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

  3. 一个 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

  4. Bot 和智能体负责干活

    Bot 是一个长期运行的聊天。它把任务交给你电脑里的智能体,再汇报它们做了什么。

    有自己地址的 Bothttps://<label>.hoody.bot
    这对你意味着什么

    用日常语言说出你想要的。同一个 Bot 在 Telegram、Slack 和 Discord 里都会回答。

    b01 你的 Botb10 所有聊天应用里的同一个 Botb11 所有电脑上的 Hoody AgentBot 页面

  5. 私密链接,真正的锁

    生成的链接猜不出来,所以在你分享之前,它一直是隐藏的。可以用密码、登录或 IP 列表锁定任意链接。

    拒绝你的分组之外的所有人"default": "deny"
    这对你意味着什么

    谁能打开哪个工具,由你决定。在你设置规则之前,任何拿到链接的人都能打开。

    x05 私密链接x06 锁定任意链接x23 加密磁盘docs / concepts / security

hoody / capabilities / computers

01 264 行

电脑

浏览器里始终在线的电脑。每个工具都有自己的链接。

始终在线,带桌面 10

  • c01

    始终在线的电脑

    关闭标签页后,你的电脑仍然开机并持续运行。

    对 AI 这样说
    让它在我的 Hoody 电脑上持续运行。

    docs / foundation / computers / managing

  • c02

    标签页里的桌面

    在浏览器里打开完整的桌面。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com

    对 AI 这样说
    在我的电脑上打开桌面。

    须知在你设置代理权限之前,任何拿到链接的人都可以使用桌面。

    docs / kit / displays

  • c03

    任意 Linux 应用

    运行任意 Linux 应用,在任意浏览器里使用,手机也可以。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com

    对 AI 这样说
    运行 LibreOffice,把链接发给我。

    docs / kit / displays

  • c04

    你的 AI 使用屏幕

    让 AI 在桌面上点击、输入、读取窗口和截图。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/screenshot

    对 AI 这样说
    给我的桌面截个图,然后点击“保存”。

    docs / kit / displays

  • c05

    跨设备复制粘贴

    在你的设备和桌面之间复制粘贴。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com

    对 AI 这样说
    把这段文字粘贴到桌面应用里。

    须知粘贴生效前,浏览器可能会请求剪贴板权限。

    docs / kit / displays

  • c55

    暂停电脑

    暂停电脑,几秒内即可恢复,会话和内存保持不变。

    链接https://api.hoody.com/api/v1/computers/{id}/pause

    对 AI 这样说
    把我的开发电脑暂停到明天。

    须知暂停的电脑仍占用 RAM 和磁盘,在恢复前,其服务 URL 会返回错误。服务器重启后,暂停状态会丢失。

    docs / foundation / computers / managing

  • c56

    多个独立屏幕

    运行多个独立桌面,各有自己的分辨率、窗口和应用。

    对 AI 这样说
    给我的浏览器和编辑器分别配一个屏幕。

    须知会话必须先设置好每个屏幕编号,才能启动。

    docs / kit / displays

  • c57

    选择桌面环境

    用 Xfce 或 MATE 桌面环境启动屏幕。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    对 AI 这样说
    用 MATE 桌面启动一个屏幕。

    须知已有的终端会话保留其设置。

    docs / kit / displays

  • c58

    普通电脑设置

    创建不含 Kit 服务的电脑,运行你自己的 HTTP 服务器。

    链接https://api.hoody.com/api/v1/projects/{p}/computers

    对 AI 这样说
    为我自己的网站服务器创建一台普通电脑。

    须知普通电脑没有内置的浏览器 shell。设置 SSH 公钥,用于首次 SSH 访问。

    docs / foundation / computers / create-edit-delete

  • c59

    停止屏幕

    停止屏幕,并结束其中运行的程序。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/displays/{displayId}/stop

    对 AI 这样说
    停止屏幕 1 及其程序。

    须知停止屏幕会结束其上的所有程序,包括未保存的工作。

    docs / kit / displays

桌面查看器选项 9

  • c60

    传输桌面文件

    在浏览器和屏幕之间传输文件。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/

    对 AI 这样说
    把这个文件传到我的屏幕。

    docs / api / displays / feature-flags

  • c61

    收听桌面音频

    在查看屏幕的浏览器中播放屏幕音频。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?sound=true

    对 AI 这样说
    在这个浏览器中播放我的桌面音频。

    docs / api / displays / web-client

  • c62

    观看演示

    以不能点击或输入的查看者身份打开共享桌面。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?sharing=true&steal=false&readonly=true

    对 AI 这样说
    给我桌面演示的查看链接。

    须知只读查看模式不是访问控制:HTTP API 仍接受输入,代理权限中也没有仅查看级别。

    docs / kit / displays

  • c63

    从桌面打印

    把屏幕上的打印任务转发到浏览器。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/

    对 AI 这样说
    从我的桌面打印这份文档。

    docs / api / displays / feature-flags

  • c64

    选择键盘布局

    为桌面查看器选择键盘布局。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?keyboard_layout=gb

    对 AI 这样说
    在我的桌面上使用英式键盘布局。

    docs / kit / displays

  • c65

    触屏键盘

    在触屏上使用桌面时,显示虚拟键盘。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?keyboard=true

    对 AI 这样说
    在我的触屏笔记本电脑上显示虚拟键盘。

    docs / kit / displays / reference

  • c66

    限制屏幕带宽

    网速慢时,为桌面查看器设置带宽上限。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?quality_mode=reduced&bandwidth_limit=500000

    对 AI 这样说
    把我的桌面查看器限制在 500 Kbps。

    docs / kit / displays / reference

  • c67

    打开时聚焦应用

    打开查看器时,让指定名称的窗口最大化并获得焦点。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?app=Firefox

    对 AI 这样说
    打开我的桌面,让 Firefox 显示在最前面。

    须知这会为该屏幕的所有查看者最小化其他窗口。

    docs / api / displays / web-client

  • c68

    自定义查看器

    使用带悬浮菜单的深色桌面查看器。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?dark_mode=true&floating_menu=true

    对 AI 这样说
    用深色查看器和悬浮菜单打开我的桌面。

    docs / kit / displays

桌面自动化 7

  • c69

    移动和调整窗口大小

    用 API 移动、调整大小、最小化、还原或关闭桌面窗口。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/window/resize

    对 AI 这样说
    把我的浏览器窗口调整到铺满桌面。

    须知部分窗口操作需要带窗口管理器的桌面。

    docs / kit / displays

  • c70

    等待窗口

    等应用窗口出现后,再继续自动化。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/wait-until

    对 AI 这样说
    等 Firefox 打开后再继续。

    须知最多等待 25 秒。超时会返回 HTTP 200,且 timedOut 为 true。

    docs / kit / displays

  • c71

    批量桌面操作

    在一次 API 调用中运行一系列桌面操作。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/batch

    对 AI 这样说
    通过一次批量操作,在桌面浏览器中打开 hoody.com。

    须知一个批次运行 1 至 50 个操作,遇到第一个失败就停止。之前已完成的操作保持不变,其他输入可以在操作之间进行。

    docs / kit / displays

  • c72

    操作并获取结果

    一次调用运行桌面操作,并获取结果。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/input/act

    对 AI 这样说
    点击按钮,并截取结果画面。

    须知如果操作之后截图失败,该操作已经完成。

    docs / api / displays / input-actions

  • c73

    用 API 操作桌面剪贴板

    一次 API 调用即可读取或设置桌面剪贴板中的文本。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/clipboard

    对 AI 这样说
    把这个地址放到我的桌面剪贴板。

    docs / api / displays / screenshots

  • c74

    已存的桌面截图

    列出桌面已存的截图,按时间或文件名获取任意一张。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/screenshots

    对 AI 这样说
    给我看 10 分钟前的桌面截图。

    须知查询只搜索最新存储的 500 张截图。

    docs / api / displays / screenshots

  • c75

    桌面缩略图

    截取桌面的小图,用于图库。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/api/v1/display/thumbnail

    对 AI 这样说
    为我的桌面生成缩略图。

    须知缩略图缩放到屏幕尺寸的 20%。

    docs / api / displays / screenshots

终端和浏览器 12

  • c06

    链接里的终端

    在任意浏览器里使用完整的终端,不用设置 SSH 密钥。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com

    对 AI 这样说
    在我的电脑上打开终端。

    须知在你设置代理权限之前,任何拿到链接的人都可以使用终端。

    docs / kit / terminals

  • c07

    用链接运行命令

    你的 AI 运行命令,并拿回输出和报错。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    对 AI 这样说
    运行测试,告诉我哪些失败了。

    docs / kit / terminals

  • c08

    全屏终端应用

    你的 AI 可以逐个按键操作全屏终端程序。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com

    对 AI 这样说
    打开 htop,告诉我什么占用的内存最多。

    docs / kit / terminals / automation

  • c09

    连接你的其他服务器

    在网页终端里 SSH 登录你的其他服务器,不需要客户端。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com

    对 AI 这样说
    连接我的旧服务器,查看它的磁盘空间。

    docs / kit / terminals

  • c10

    由 AI 操作的浏览器

    运行 Chromium 或 Firefox,你的 AI 可以用它浏览、阅读和点击。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com

    对 AI 这样说
    打开定价页面,把各个方案整理成表格。

    须知默认情况下,浏览器闲置 1 小时后会停止,并丢失其中的标签页和 Cookie。下一次调用会启动一个全新的浏览器。

    docs / kit / browser

  • c11

    网页截图和 PDF

    用后台浏览器给任意网页截图,或存为 PDF。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/pdf

    对 AI 这样说
    把那篇文章保存为 PDF。

    须知PDF 需要后台运行的 Chromium;默认浏览器是看得见的那个。

    docs / kit / browser

  • c76

    独立终端会话

    打开独立的 shell 会话,共享电脑的文件和进程。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    对 AI 这样说
    为构建再打开一个终端。

    须知新会话的 ID 取 1 至 9999。ID 4501 至 5000 留给智能体,可同时运行的数量取决于电脑的资源。

    docs / kit / terminals

  • c77

    保留 shell 状态

    在同一个会话中运行相关命令,保留工作目录和变量。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    对 AI 这样说
    切换到我的项目目录,在那里运行构建。

    须知会话会在删除、电脑重启、终端服务重启或空闲清理时结束。

    docs / kit / terminals

  • c78

    查看长时间命令

    启动一个长时间运行的命令,运行期间查看它的输出和状态。

    对 AI 这样说
    启动构建并查看进度。

    须知持久会话的超时只是汇报期限,不会停止正在运行的命令。

    docs / kit / terminals

  • c79

    停止命令

    中断正在运行的终端命令,或在命令等待时取消它。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute/{command_id}/abort

    对 AI 这样说
    停止我启动的构建命令。

    须知超时后,只有在没有其他输入到达终端、且其 shell 仍在运行时,才能中止。

    docs / kit / terminals / reference

  • c80

    只看不输入

    以只读模式打开终端,查看会话但不发送输入。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?readonly=true

    对 AI 这样说
    给我这个终端的只读链接。

    须知只读模式只阻止该客户端的输入。谁能打开这个 URL,由代理权限决定。

    docs / kit / terminals

  • c81

    精确的命令输出

    运行命令,获取精确的输出字节,stdout 和 stderr 分开保存。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    对 AI 这样说
    运行这条命令,给我它精确的二进制输出。

    须知原始模式会等命令结束,并在终端会话之外运行。每个流的捕获量不超过服务器的上限。

    docs / api / terminal / commands

终端选项 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。

    docs / kit / terminals / reference

  • c83

    启动图形应用

    把终端和屏幕配对,在该屏幕上打开程序。

    对 AI 这样说
    从终端 2 在屏幕 2 上启动 Firefox。

    须知用 API 创建的会话会从创建请求的请求体中读取屏幕设置。

    docs / kit / terminals

  • c84

    用 SSH 加入 tmux

    用 SSH 和终端编号加入浏览器里的 tmux 会话。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?shell=tmux

    对 AI 这样说
    告诉我怎样用 SSH 加入终端 3。

    docs / kit / terminals

  • c85

    终端侧边栏

    在同一页面中,把 Hoody Agent、运行手册或仪表板显示在终端旁边。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?panel={url}

    对 AI 这样说
    在终端 1 旁边打开我的智能体。

    须知分享这个 URL 就会分享终端及其面板。

    docs / api / terminal / web-interface

  • c86

    临时 shell 会话

    创建一个临时终端,分配 ID,用完自动清理。

    对 AI 这样说
    在临时终端中运行这个脚本。

    须知服务会在 5,001 至 7,999 之间分配一个 ID。会话没有屏幕,已完成的结果默认保留 5 分钟,期间可以获取。

    docs / kit / terminals / reference

  • c87

    终端启动时运行

    在本地终端出现 shell 提示符之前,运行你的启动脚本。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    对 AI 这样说
    终端 2 启动时运行我的设置脚本。

    须知SSH 会话不会运行启动脚本。为会话选定的脚本必须使用绝对路径,且不含 `..`。

    docs / kit / terminals / reference

  • c88

    经代理的 SSH

    让终端的 SSH 连接经 SOCKS5 代理到达目标服务器。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/create

    对 AI 这样说
    经我的 SOCKS5 代理连接我的服务器。

    须知不检查 SSH 主机密钥。SSH 凭据和 SOCKS5 设置要放在创建请求的请求体中。

    docs / kit / terminals / reference

  • c89

    命令环境

    为本地终端会话中的一条命令提供环境变量。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute

    对 AI 这样说
    把 DEBUG 设为 1,运行测试。

    须知在 SSH 会话中,传入的变量会导出到远程 shell 并保留。

    docs / api / terminal / commands

  • c90

    自定义终端外观

    在终端链接中设置标签页标题、字体大小和背景颜色。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/

    对 AI 这样说
    放大终端文字,把标签页标题设为 Build。

    须知字号范围为 8 至 72 像素。标签页标题最多 200 个字符。

    docs / api / terminal / web-interface

  • c91

    屏幕阅读器模式

    在链接中为浏览器终端开启屏幕阅读器支持。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/?screenReaderMode=true

    对 AI 这样说
    打开终端并启用屏幕阅读器支持。

    docs / api / terminal / web-interface

终端自动化 6

  • c92

    等待终端输出

    等到出现匹配的提示符,或屏幕稳定后,再进行下一步。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/wait

    对 AI 这样说
    等到 Python 提示符出现。

    须知等待超时默认为 5,000 ms,可设为 10 至 300,000 ms。

    docs / kit / terminals / automation

  • c93

    搜索终端屏幕

    在终端屏幕或滚动历史中搜索某个模式,返回匹配位置。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/find

    对 AI 这样说
    在我的终端滚动历史里找出错误信息。

    须知模式最长 1,024 字节。搜索最多返回 1,000 条匹配,耗时预算为 500 ms。

    docs / kit / terminals / automation

  • c94

    终端命令历史

    获取会话保留的命令记录,包括状态和退出码。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/history/{terminal_id}

    对 AI 这样说
    显示终端 1 中运行过的命令。

    须知历史记录默认是 100 条记录的滚动窗口。想要完整记录,就边运行边拉取。

    docs / kit / terminals / reference

  • c95

    导出终端输出

    下载保留的终端输出,或以文本或 HTML 获取最后几行。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/raw

    对 AI 这样说
    下载终端 1 的最新输出。

    须知输出默认最多保留 8 MB,超出时丢弃最早的内容。

    docs / kit / terminals / reference

  • c96

    终端截图

    把终端输出变成图片,用在教程或仪表板里。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/screenshot

    对 AI 这样说
    把我的终端保存为 PNG 截图。

    须知可选 PNG、JPEG 或 GIF。默认同时保存图片。

    docs / kit / terminals / reference

  • c97

    终端鼠标输入

    在支持鼠标事件的终端程序里点击或滚动。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/mouse

    对 AI 这样说
    点击我的终端程序里的菜单项。

    须知程序只有开启了鼠标上报,才能收到鼠标事件。HTTP 每个请求最多接受 256 个事件。

    docs / kit / terminals / automation

读取网页 8

  • c98

    页面转 Markdown

    把网页转成 Markdown,附带标题和元数据。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    对 AI 这样说
    以 Markdown 读取这篇文章。

    须知只转换主框架,因此不包括 iframe 内容和 shadow DOM。

    docs / api / browser / interaction

  • c99

    提取文章内容

    获取页面正文,不含导航、侧边栏和评论。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    对 AI 这样说
    提取这个页面的文章正文。

    须知只转换主框架,因此不包括 iframe 内容和 shadow DOM。

    docs / api / browser / interaction

  • c100

    页面 HTML 或文本

    获取浏览器标签页的完整 HTML,或只获取可见文本。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/html

    对 AI 这样说
    显示这个标签页的 HTML。

    docs / kit / browser

  • c101

    收集页面链接

    获取页面中已排序、已去重的链接列表。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/markdown

    对 AI 这样说
    列出这篇文章里的链接。

    须知links 数组最多包含 10,000 项。只转换主框架。

    docs / api / browser / interaction

  • c102

    运行页面 JavaScript

    在浏览器标签页中运行 JavaScript,并取回结果。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/eval

    对 AI 这样说
    运行 JavaScript 读取页面标题。

    须知在默认的隐身实例上,脚本运行在隔离环境中,无法读取页面的全局变量。超时的默认值和最大值都是 30,000 ms。

    docs / kit / browser

  • c103

    截取单个元素

    按原尺寸截取页面上一个可见元素。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/screenshot

    对 AI 这样说
    只截取这个页面上的图表。

    须知选择器只截取第一个匹配的元素,不能与 clip 或 fullPage=true 同时使用。

    docs / api / browser / interaction

  • c104

    遮盖截图细节

    在截图中用不透明色块盖住选定的页面元素。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/screenshot

    对 AI 这样说
    盖住这张截图里的账号。

    须知遮罩不会覆盖 iframe 内的元素。选择器没有匹配到任何元素时调用仍会成功,所以要检查图片。

    docs / api / browser / interaction

  • c105

    页面无障碍快照

    获取页面的结构化快照,附带元素引用。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/snapshot

    对 AI 这样说
    显示这个页面上的无障碍控件。

    须知出现更新的快照或顶层文档导航后,引用会失效。已输入的表单值默认隐藏。

    docs / api / browser / interaction

浏览器控制 15

  • c106

    连接浏览器自动化

    把 Playwright 或 Puppeteer 客户端连接到 Hoody 的 Chromium 实例。

    链接https://{p}-{c}-cdp-1.{node}.computers.hoody.com/

    对 AI 这样说
    把我的 Playwright 脚本连接到 Hoody 浏览器。

    须知需要开启远程调试的 Chromium;Firefox 会返回 501。

    docs / kit / browser

  • c107

    独立的浏览器会话

    运行多个独立的浏览器实例,各有自己的标签页和 Cookie。

    对 AI 这样说
    为这些网站打开两个独立的浏览器会话。

    须知实例默认闲置 1 小时就会停止,标签页和 Cookie 随之丢弃。

    docs / kit / browser

  • c108

    等待页面变化

    等待页面出现某段文本、跳转到某个 URL 或加载完成。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/wait

    对 AI 这样说
    等到页面显示订单已确认。

    须知超时默认 10,000 ms,最大 30,000 ms。此调用不会启动浏览器。

    docs / kit / browser / reference

  • c109

    处理页面对话框

    接受或关闭由浏览器操作弹出的页面对话框。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/action

    对 AI 这样说
    点击删除,并接受确认对话框。

    须知该策略只作用于操作触发的第一个匹配对话框;意外出现的对话框会关闭,操作随之失败。

    docs / kit / browser

  • c110

    管理浏览器标签页

    列出已打开的浏览器标签页(包括弹窗),并关闭不再需要的。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/tabs

    对 AI 这样说
    关闭浏览器里旧的购物标签页。

    须知不能关闭最后一个打开的标签页。

    docs / kit / browser

  • c111

    浏览器 Cookie

    读取、添加或清除浏览器实例中的 Cookie。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/cookies

    对 AI 这样说
    显示这个网站的 Cookie。

    须知添加的 Cookie 中只要有一个无效,就一个都不会设置。停止实例会丢弃其 Cookie。

    docs / kit / browser

  • c112

    设置浏览器所在地

    浏览器启动时设置语言区域、时区和地理位置。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    对 AI 这样说
    用伦敦时区启动浏览器。

    须知这些选项只在创建实例时生效。

    docs / kit / browser

  • c113

    浏览器走代理

    让浏览器流量经过 HTTP 或 SOCKS 代理。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    对 AI 这样说
    启动浏览器,并走我的代理。

    须知代理选项只在创建实例时生效。

    docs / kit / browser

  • c114

    Chromium 扩展

    在浏览器中加载 Chromium 扩展,例如广告拦截器。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    对 AI 这样说
    启动 Chromium 并加载我的广告拦截器。

    须知扩展需要可见的 Chromium 实例,且必须在创建实例时设置。

    docs / kit / browser

  • c115

    固定 Chrome 版本

    为浏览器实例选择 Chrome 版本或发布通道。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/start

    对 AI 这样说
    用 Chrome 136 启动浏览器。

    须知启动选项只在创建实例时生效。无法解析的主版本号按未填写处理,所以要查看元数据中的 browserFullVersion。

    docs / kit / browser

  • c116

    浏览器历史记录

    按日期或域名浏览浏览器历史记录,或删除记录。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/history

    对 AI 这样说
    删除 10 月之前的浏览器历史记录。

    须知历史默认保留 30 天,重启后仍然保留。删除后无法恢复。

    docs / kit / browser

  • c117

    浏览器控制台日志

    查看浏览器最近的控制台消息和页面错误。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/console

    对 AI 这样说
    显示我的测试页面的控制台错误。

    须知保留最近 500 条。默认的隐身实例只捕获浏览器上报的消息,不捕获页面的 console 调用或未捕获的错误。

    docs / api / browser / health

  • c118

    浏览器网络日志

    查看各浏览器标签页最近的网络请求和响应。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/network

    对 AI 这样说
    显示我的测试页面的网络请求。

    须知保留最近 500 条。

    docs / api / browser / health

  • c119

    打开浏览器 DevTools

    获取链接,在 DevTools 中检查你的 Chromium 实例。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/devtools-url

    对 AI 这样说
    为我的浏览器打开 DevTools。

    须知在 Firefox 上,或 Chromium 关闭远程调试时,无法使用 DevTools Protocol。

    docs / kit / browser

  • c120

    调整浏览器标签页大小

    为运行中浏览器的所有标签页设置固定的视口大小。

    链接https://{p}-{c}-browser-1.{node}.computers.hoody.com/api/v1/browser/viewport

    对 AI 这样说
    把浏览器标签页调整为 1280 × 800。

    须知宽和高是 1 至 8,192 的整数。已崩溃的标签页会跳过。

    docs / api / browser / control

文件和数据 8

  • c12

    链接里的文件

    在网页文件管理器中浏览、编辑和下载文件。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com

    对 AI 这样说
    显示我项目文件夹里的文件。

    须知在你设置代理权限之前,任何拿到链接的人都可以查看和修改你的文件。

    docs / kit / files

  • c13

    云盘集中在一处

    接入 Google Drive、Dropbox、S3 等共 49 种远程存储。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com

    对 AI 这样说
    把我 Dropbox 里的发票复制到项目里。

    docs / kit / files

  • c14

    文件历史

    用链接改过的小文本文件,可以恢复到更早的版本。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com

    对 AI 这样说
    显示 config.json 昨天的版本。

    须知通过 Hoody Files 修改的文本文件,最大 2 MiB,保留 90 天,或保留到历史记录达到 2 GiB。不记录构建文件夹和 URL 下载,记录也只是尽力而为,因此不是备份。

    docs / kit / files

  • c15

    笔记本电脑上的文件

    在 Finder 或 Explorer 中打开你电脑上的文件。

    对 AI 这样说
    把我的 Hoody 文件挂载到我的 Mac 上。

    须知在你设置代理权限之前,任何拿到 WebDAV 链接的人都可以挂载你的文件。

    docs / foundation / storage / mount-locally

  • c16

    笔记本文件夹出现在电脑里

    让笔记本电脑上的文件夹出现在你的电脑里。

    对 AI 这样说
    把我的下载文件夹分享给我的 Hoody 电脑。

    须知Linux 或 macOS 配合 rclone 1.61 或更高版本使用;暂不支持 Windows。文件夹只在你的机器在线且命令运行期间可用,停止时会等待待处理的写入完成。

    docs / foundation / storage / share-local-folder

  • c17

    跨电脑共享文件夹

    在同一台服务器上的电脑之间共享文件夹,只读或读写均可。

    对 AI 这样说
    把 assets 文件夹分享给这个项目里的所有电脑。

    须知同一台服务器上的电脑之间可用。跨服务器处于试用阶段,默认关闭。

    docs / foundation / storage / sharing-files

  • c18

    无需服务器的数据库

    保存 SQL 数据库和键值数据,用链接即可访问。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    对 AI 这样说
    为我的阅读清单建一个数据库。

    须知在你设置代理权限之前,任何拿到链接的人都可以访问数据库。

    docs / kit / sqlite

  • c19

    数据撤销

    查看并撤销对已保存键值数据的历史改动。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com

    对 AI 这样说
    撤销我设置的上一次改动。

    须知只记录通过键值 API 所做的更改。SQL 写入,以及关闭历史记录后发送的写入,无法撤销。

    docs / kit / sqlite

用链接打开的文件工具 17

  • c121

    从 URL 下载

    把远程文件直接下载到电脑,不经过你自己的设备。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/{folder}?download={url}

    对 AI 这样说
    把这个数据集直接下载到我的电脑。

    须知下载达到 100 GiB 或 12 小时就会停止。

    docs / kit / files

  • c122

    复制和移动文件

    用 Files API 复制或移动文件和文件夹。

    对 AI 这样说
    把我的报告复制到归档文件夹。

    须知移动绝不会替换已有的目标。复制只有带上 `?overwrite=true` 才会替换。

    docs / kit / files

  • c123

    查看压缩包内容

    列出压缩包内容,或不解压直接读取其中一个文件。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/{archive}?preview

    对 AI 这样说
    列出这个压缩包里的文件,并显示它的 README。

    须知支持 ZIP、TAR 和压缩的 TAR 归档。所选文件超过 100 MB 会被拒绝。

    docs / api / files / directories

  • 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。

    docs / api / files / file-operations

  • c125

    读取指定行

    用链接读取文件的指定范围或最后几行。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?lines={range}

    对 AI 这样说
    显示这份日志的最后 20 行。

    须知每个请求最多 100,000 行或 64 MB。

    docs / api / files / reading

  • c126

    只读文件页面

    在没有编辑控件的页面中打开文本文件。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/{path}?view

    对 AI 这样说
    用只读视图打开这条笔记。

    须知该视图不会阻止通过其他请求写入。要控制访问,设置代理权限即可。

    docs / kit / files

  • 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 后清理。

    docs / kit / files

  • c128

    追加到文件

    用链接把数据添加到文件末尾,文件不存在时自动创建。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/append/{path}

    对 AI 这样说
    把这条记录追加到我的日志文件。

    docs / api / files / file-operations

  • c129

    提取压缩包中的一项

    提取一个文件或文件夹,压缩包的其余部分保持不变。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/{archive}?extract_file&extract={member}

    对 AI 这样说
    只提取这个压缩包里的 images 文件夹。

    须知支持 ZIP、TAR 和压缩的 TAR 归档。

    docs / api / files / directories

  • c130

    按范围下载文件

    请求文件的指定字节,不必下载整个文件。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}

    对 AI 这样说
    获取这个文件的前 1 MB。

    须知对用 `backend` 指定的远程文件请求多个范围时,会返回整个文件。

    docs / api / files / reading

  • c131

    用链接查看文件详情

    查看文件的大小、所有者和权限,无需下载内容。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/stat/{path}

    对 AI 这样说
    查看这个文件的大小和所有者。

    docs / api / files / file-operations

  • c132

    检查文件完整性

    把文件的 SHA-256 哈希与你的副本比对,检查下载是否完整。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}?hash

    对 AI 这样说
    检查我下载的备份是否与原文件一致。

    docs / kit / files

  • c133

    管理 URL 下载

    查看电脑上 URL 下载的进度和历史,或取消下载。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/downloads

    对 AI 这样说
    显示我正在进行的下载,并取消卡住的那个。

    须知取消需要根目录的写权限。取消后留下的部分文件,在挂载盘或网络文件系统上会保留。

    docs / api / files / downloading

  • c134

    跟踪解压进度

    查看正在运行的解压任务的进度,或取消任务。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/extractions

    对 AI 这样说
    检查我的压缩包是否还在解压。

    须知取消解压需要根文件夹的写权限。

    docs / api / files / directories

  • c135

    文件变更审计

    按路径、操作和时间查找电脑上已记录的文件变更。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/journal

    对 AI 这样说
    显示今天这个文件夹里记录到的文件删除。

    须知变更日志记录通过 Hoody Files 所做的修改,不记录终端命令、脚本或程序所做的修改。

    docs / kit / files

  • c136

    条件式文件写入

    只有文件版本与预期版本一致时才写入。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/files/{path}

    对 AI 这样说
    仅当我读取后没人改动过,才保存。

    须知作用于电脑上的文件,不作用于已连接的云存储。

    docs / api / files / file-operations

  • 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`。

    docs / kit / files

云存储和共享存储 11

  • c138

    把远程存储当作文件夹

    挂载已连接的存储账号,让程序把它当作文件夹使用。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/mounts

    对 AI 这样说
    挂载我已连接的 Drive,供我的程序使用。

    须知写入会在 `write_back` 之后上传,默认 5 秒。两个写入方写同一个文件时,以最后一次上传为准。

    docs / kit / files

  • c139

    多个云存储账号

    连接同一个存储服务商的个人账号和工作账号。

    对 AI 这样说
    连接我个人和工作的两个 Google Drive。

    须知连接数默认总共最多 100 个,每个远程主机最多 10 个。

    docs / foundation / storage / cloud

  • c140

    在云存储服务商之间复制

    用电脑的带宽,在已连接的服务商之间复制文件。

    对 AI 这样说
    把这份 Drive 备份复制到我的 S3 存储桶。

    须知文件会先经过电脑上的一份临时副本。

    docs / foundation / storage / cloud

  • c141

    连接文件服务器

    把你的 SFTP、SMB、WebDAV、FTP、HDFS 或 HTTP 服务器连接到电脑。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/backends/{protocol}

    对 AI 这样说
    连接我团队的 SMB 文件服务器。

    须知连接时会检查你的登录信息;之后再把它挂载为文件夹。

    docs / api / files / mount / protocols

  • c142

    挂载到手机

    在手机的 WebDAV 应用里打开电脑上的文件。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/

    对 AI 这样说
    在手机文件应用里打开我电脑上的文件。

    须知在你设置代理权限之前,任何拿到 WebDAV 链接的人都可以挂载你的文件。

    docs / foundation / storage / mount-locally

  • c143

    一次性读取远程文件

    无需保存存储连接,就能读取或上传远程文件。

    对 AI 这样说
    从我的 SFTP 服务器读取一次这个文件。

    须知适用于 SFTP、WebDAV、FTP 和 S3。

    docs / kit / files

  • c144

    只读的笔记本文件夹

    让电脑读取笔记本上的文件夹,并防止写入。

    对 AI 这样说
    把我的文档文件夹以只读方式分享给这台电脑。

    须知需要 Linux 或 macOS,并使用 rclone 1.61 或更高版本。只有你的机器在线且命令在运行时,共享才有效。

    docs / foundation / storage / share-local-folder

  • c145

    会过期的文件夹分享

    为分享给另一台电脑的文件夹设置过期时间。

    链接https://api.hoody.com/api/v1/computers/{id}/storage/shares

    对 AI 这样说
    把这个文件夹分享给另一台电脑,到周五为止。

    须知共享到期后会删除,并从所有目标卸载。

    docs / foundation / storage / sharing-files

  • c146

    接受收到的分享

    接受或关闭另一台电脑向你的电脑发来的文件夹分享。

    链接https://api.hoody.com/api/v1/computers/{id}/storage/incoming/{shareId}/mount

    对 AI 这样说
    停止在这台电脑上挂载共享的素材文件夹。

    须知只有创建者的 enabled 标志和接收者的 mount 标志都为 true,共享才会挂载。

    docs / api / storage-shares

  • c147

    只读云端挂载

    让已挂载的远程文件夹拒绝通过挂载路径写入。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/mounts/{id}

    对 AI 这样说
    把这个已挂载的云端文件夹设为只读。

    须知`?backend=` 路径仍然可以写入。`box`、`onedrive` 和 `protondrive` 不支持自定义设置。

    docs / kit / files / reference

  • c148

    上传失败的文件

    找出云端挂载未能上传的文件,并下载留存的副本。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com/api/v1/pending-uploads

    对 AI 这样说
    显示正在等待上传到我的云端存储空间的文件。

    须知暂存的文件会一直保留,直到你交付或丢弃。暂存的副本可能不完整。

    docs / kit / files

数据库和键值存储 13

  • c149

    SQL 事务

    一起执行多条 SQL 语句,其中一条失败就全部回滚。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db

    对 AI 这样说
    在一个事务中更新订单及其库存。

    须知结果集最多 10,000 行,并带有 truncated: true;用 LIMIT 分页。

    docs / kit / sqlite

  • c150

    分享实时查询

    分享一个链接,它会对实时数据运行你的只读 SQL 查询。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/query

    对 AI 这样说
    生成一个显示当前订单数的链接。

    须知URL 携带一条只读的 SELECT,以 Base64URL 编码。

    docs / kit / sqlite

  • c151

    原生 SQLite 与 HTTP SQLite

    同时通过本地代码和 HTTP 使用你的 SQLite 数据库。

    对 AI 这样说
    让我的本地 worker 和仪表板使用同一个数据库。

    须知SQLite 每个数据库文件同一时间只允许一个写入方。不要通过存储共享在多台电脑之间共用数据库文件。

    docs / foundation / storage / sqlite-drive

  • c152

    数据库备份副本

    在使用过程中,为 SQLite 数据库创建一致的副本。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/maintenance

    对 AI 这样说
    为我的数据库创建一致的备份。

    须知副本会写到新路径。

    docs / kit / sqlite

  • c153

    跟踪数据库变更

    实时流式传输键值表的变更,包括 SQL 写入。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/changes/stream

    对 AI 这样说
    我的应用数据库中的键一有变化,就告诉我。

    须知日志保留 24 小时,最多 1,000,000 条变更。

    docs / kit / sqlite

  • c154

    让临时键过期

    为保存的键设置过期时间,之后也可以修改。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}/expire

    对 AI 这样说
    让这个会话键在 1 小时后过期。

    docs / kit / sqlite

  • c155

    并发安全的计数器

    多个客户端累加同一个共享计数器,不丢失任何更新。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}/incr

    对 AI 这样说
    统计我的主页的每次访问。

    docs / kit / sqlite

  • c156

    更新 JSON 字段

    读取、写入或递增已保存 JSON 值中的某一部分。

    对 AI 这样说
    修改 theme 字段,不替换其他设置。

    须知按路径设置时,存储的值需要 JSON 内容类型。

    docs / kit / sqlite

  • c157

    防止写入冲突

    仅当共享键的版本未变时,才更新它。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/kv/{key}

    对 AI 这样说
    仅当设置没有被别人先改过时,才更新。

    须知返回 412 表示另一个客户端先写入了:重新读取,再重做修改。

    docs / kit / sqlite

  • c158

    把键存成文件

    把键存放在一个目录中,其他工具可以把它们当作文件来编辑。

    对 AI 这样说
    把这些设置以文件形式存放在一个目录中。

    docs / kit / sqlite

  • c159

    批量传入 SQL 值

    用多组值执行同一条 SQL 语句。

    链接https://{p}-{c}-sqlite-1.{node}.computers.hoody.com/api/v1/sqlite/db

    对 AI 这样说
    用一条 SQL 语句插入这些行。

    docs / kit / sqlite

  • c160

    批量键操作

    一次请求最多读取、写入或删除 100 个键。

    对 AI 这样说
    把这些设置一次性保存。

    须知批量写入要么全部键生效,要么都不生效。

    docs / kit / sqlite

  • c161

    并发安全的列表

    推入、弹出或移除已保存列表中的项目,客户端之间不会发生竞争。

    对 AI 这样说
    把这件商品加入共享购物车。

    docs / kit / sqlite

网站、脚本和链接 10

  • c20

    脚本变成端点

    在脚本文件夹中保存一个 JavaScript 或 TypeScript 文件,它就是一个在线的 Web 端点。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    对 AI 这样说
    写一个把 CSV 转成 JSON 的端点。

    docs / kit / exec

  • c21

    脚本里的 AI

    脚本可以直接调用 AI 模型,无需设置密钥。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    对 AI 这样说
    做一个能总结任意网页的端点。

    须知默认模型在服务器限额内免费。付费模型按使用量计费。

    docs / kit / exec / ai-integration

  • c22

    私有端点

    用独立的私密令牌保护任意脚本端点。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    对 AI 这样说
    锁定这个端点,只允许我的应用调用。

    docs / kit / exec / authentication

  • c23

    脚本实时事件

    把运行中脚本的实时事件推送到任意页面。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/<script>

    对 AI 这样说
    把订单的实时更新推送到我的仪表板。

    须知按脚本单独开启。事件不会存储,所以页面只能看到连接期间发送的事件。发送私密数据前,先添加令牌或代理权限。

    docs / kit / exec / remote

  • c24

    网站和应用上线

    你运行的 HTTP 应用直接在各自的 HTTPS 链接上线,无需部署步骤。

    链接https://{p}-{c}-http-8080.{node}.computers.hoody.com

    对 AI 这样说
    做一个落地页,把链接发给我。

    须知在你为它设置代理权限之前,任何拿到链接的人都能打开。

    docs / concepts / everything-is-a-url

  • c25

    你自己的域名

    把任意网站或工具放到你拥有的域名上,HTTPS 已包含。

    链接https://www.yourdomain.com

    对 AI 这样说
    把我的网站放到 www.example.com 上。

    须知仅支持子域名,例如 www.example.com,不支持 example.com。每个子域名指向一个短链接;多个子域名可以共用同一个。

    docs / foundation / proxy / connect-domain

  • c26

    短链接

    为任意网站或工具生成一个简短好记的链接。

    链接https://{alias}.{node}.computers.hoody.com

    对 AI 这样说
    给我的仪表板一个短链接。

    须知短链接容易猜到,在你设置代理权限之前,任何人都能打开。Free 方案每台服务器 3 个,Plus 方案 50 个,Pro 方案 250 个。

    docs / foundation / proxy / aliases

  • c162

    会过期的演示链接

    为演示或活动链接设置过期时间。

    链接https://api.hoody.com/api/v1/proxy/aliases

    对 AI 这样说
    让这个演示链接在周五过期。

    须知到期后,别名返回 404,配置仍然保留。已停用和已到期的别名都计入服务器的别名数量上限。

    docs / foundation / proxy / aliases

  • c163

    把链接固定到一个页面

    让别名打开一个固定的页面或 API 端点。

    链接https://api.hoody.com/api/v1/proxy/aliases

    对 AI 这样说
    让这个链接只打开报告页面。

    须知关闭路径覆盖后,其他路径返回 404。方法、请求体、WebSocket 升级和其他参数仍会通过。

    docs / foundation / proxy / aliases

  • c164

    暂停短链接

    停用别名,之后可以恢复,配置不会丢失。

    链接https://api.hoody.com/api/v1/proxy/aliases/{id}/state

    对 AI 这样说
    把演示链接暂停到明天。

    须知停用期间,URL 返回 404。修改约 30 秒后到达别名 URL,有时更久。

    docs / foundation / proxy / aliases

编写脚本 12

  • c165

    脚本中的包

    导入 npm 包,脚本运行前会先安装它。

    对 AI 这样说
    在我的脚本中用 axios 请求那个 API。

    须知首次请求较慢,且需要电脑能访问 npm registry。不会检测通过计算得到的包名。

    docs / kit / exec / writing-scripts

  • c166

    动态脚本路由

    从 URL 路径中取值,供脚本使用。

    对 AI 这样说
    创建一个从 URL 中读取 ID 的用户端点。

    docs / kit / exec / routing

  • c167

    结构化 AI 回复

    让脚本请求 AI 按指定的 JSON 结构输出。

    对 AI 这样说
    把这段文字中的姓名和日期提取为 JSON。

    须知Zod schema 会自动校验响应;`jsonSchema(...)` schema 只会发送给模型,除非你传入 `validate` 函数。

    docs / kit / exec / ai-integration

  • c168

    流式 AI 回复

    脚本边生成文本,边以流式方式返回。

    对 AI 这样说
    让我的 AI 端点边写边流式返回答案。

    docs / kit / exec / ai-integration

  • c169

    脚本 WebSocket 服务

    在你自己的 worker 脚本中接受 WebSocket 连接。

    对 AI 这样说
    为我的聊天应用创建一个 WebSocket 端点。

    须知WebSocket 需要同时有 `// @mode worker` 和 `// @websocket`。

    docs / kit / exec / execution-modes

  • c170

    脚本请求中间件

    对文件夹中脚本的请求,在处理前后运行你自己的代码。

    对 AI 这样说
    为我的 API 文件夹中的脚本添加请求日志。

    docs / kit / exec / routing

  • c171

    脚本环境变量

    为脚本、文件夹或脚本根目录设置环境变量。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/env/update

    对 AI 这样说
    为我的发票脚本设置 API Key。

    须知请求必须带上文件的当前修订版本,以防止修改冲突。

    docs / api / exec / script-management

  • c172

    脚本共享缓存

    让临时值在对脚本的多次请求之间保持可用。

    对 AI 这样说
    在请求之间缓存最新汇率。

    须知重启后它会完全丢失,清除或闲置淘汰也会将其清空。

    docs / kit / exec

  • c173

    每次请求使用新的上下文

    每个请求都在新的 JavaScript 上下文中运行,适合相互独立的任务。

    对 AI 这样说
    让这个 Webhook 接收端为每个请求使用新的上下文。

    须知新的上下文只隔离变量,不隔离副作用:已写入的文件、已启动的子进程和已发出的网络调用都会保留。

    docs / kit / exec / execution-modes

  • c174

    从模板生成

    用内置或自定义模板生成脚本。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/templates/generate

    对 AI 这样说
    用模板生成我的新脚本。

    docs / api / exec / templates

  • c175

    运行前检查脚本

    一次调用就检查脚本的语法、依赖、指令和可选的类型。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/validate/script

    对 AI 这样说
    保存前检查这个脚本有没有错误。

    docs / api / exec / validation

  • c176

    锁定脚本依赖

    在包清单中锁定脚本依赖的版本。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/package/pin

    对 AI 这样说
    锁定我的脚本所用依赖的版本。

    docs / api / exec / package-management

运行脚本 8

  • c177

    脚本版本历史

    找回脚本的早期版本,或已删除但留有副本的脚本。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/scripts/restore

    对 AI 这样说
    恢复我的 Webhook 脚本的上一个版本。

    须知删除的脚本只有在删除时带了 `keepCopy=true`,才能恢复。

    docs / api / exec / script-management

  • c178

    搜索脚本日志

    在脚本日志中搜索文本或正则表达式。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/logs/search

    对 AI 这样说
    在我的脚本日志中查找超时错误。

    docs / api / exec / logs

  • c179

    脚本性能历史

    查看脚本每小时的调用次数、失败次数和延迟。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/monitor/script-usage

    对 AI 这样说
    告诉我今天我的 Webhook 什么时候变慢了。

    须知历史记录涵盖最近 24 小时。

    docs / api / exec / monitoring

  • c180

    向运行中的脚本发消息

    向运行中的脚本发送消息,并收到其处理函数的回复。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    对 AI 这样说
    向我正在运行的构建脚本发送一条 start 消息。

    须知为脚本开启 `@remote-messages`。远程操作不会运行目录中间件,所以要用令牌保护。

    docs / kit / exec / remote

  • c181

    调用暴露的函数

    调用运行中脚本暴露的函数,并获取返回结果。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/{path}

    对 AI 这样说
    调用我正在运行的 worker 的 status 函数。

    须知为脚本开启 `@remote-call`。远程操作不会运行目录中间件,所以要用令牌保护。

    docs / kit / exec / remote

  • c182

    检查运行中的脚本

    调试时,针对脚本最近一次运行计算一个表达式。

    对 AI 这样说
    检查我正在运行的 worker 中的计数器。

    须知它需要 `@remote-eval`,以及带有 `eval` 范围的 `@remote-token`;`@token` 解锁不了它。

    docs / kit / exec / remote

  • c183

    脚本定时运行历史

    查看过去的定时脚本运行记录,可按脚本或时间筛选。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/schedules/history

    对 AI 这样说
    显示我的定时报告脚本的运行时间。

    docs / api / exec / scheduling

  • c184

    测试脚本路由

    一次对照脚本路由规则检查多个 URL 路径。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/route/test

    对 AI 这样说
    检查这些 URL 路径由哪些脚本处理。

    docs / api / exec / routing

自动运行 17

  • c27

    持续运行的程序

    运行服务器和 worker 进程,崩溃后会自行重启。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com

    对 AI 这样说
    让我的爬虫持续运行。

    须知启动时就反复失败的程序会标记为致命状态,不再重试。

    docs / kit / daemons

  • c28

    给程序划边界

    限制单个程序能写入、访问和使用的内容。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com

    对 AI 这样说
    运行该工作进程,只开放 TCP 端口 443 和 53。

    须知适用于守护进程。只限制 TCP 端口,不针对主机;部分 Unix 套接字仍可访问,只读的根文件系统会阻止写入,但不阻止读取。

    docs / kit / program-sandbox

  • c29

    Docker 开箱即用,Kubernetes 也可以

    开发 Kit 自带 Docker 和 Compose,Kubernetes 简单设置后即可在里面运行。

    对 AI 这样说
    在 Docker 里运行测试套件。

    docs / foundation / computers / images

  • c30

    定时任务

    按计划运行任何内容,也可以让任务在设定的时间自行删除。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com

    对 AI 这样说
    每晚 3 点备份我的数据库。

    docs / kit / cron

  • c31

    网络请求变成链接

    把任意 API 调用变成可以点击、分享或按计划运行的链接。

    链接https://{p}-{c}-curl-1.{node}.computers.hoody.com

    对 AI 这样说
    做一个链接,向我的 Webhook 发送 POST 请求。

    须知任何拿到该链接的人都能读到其中的每个请求头和值,包括凭据。

    docs / kit / curl

  • c32

    重复调用,保存响应

    按计划调用 API,把每次响应保存为文件。

    链接https://{p}-{c}-curl-1.{node}.computers.hoody.com

    对 AI 这样说
    每小时检查一次这个 API,并保存结果。

    docs / kit / curl

  • c185

    开机时启动程序

    电脑每次开机,都自动启动你的程序。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/boot

    对 AI 这样说
    电脑每次开机,都启动我的 API 服务器。

    须知已启用的开机程序在你创建、启用或编辑后就可能立即启动。

    docs / kit / daemons

  • c186

    首次请求时启动

    有人首次请求服务的端口时,启动该服务。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    对 AI 这样说
    只在有人打开我的应用时才启动它。

    须知需要 lazy_load 和 port_range。lazy_load 不能与 boot: true 同时使用。

    docs / kit / daemons

  • c187

    读取程序日志

    读取程序输出日志或错误日志的最后几行,也可以实时跟踪。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/logs

    对 AI 这样说
    显示我的 worker 最后 200 行错误日志。

    须知日志默认在达到 5 MiB 时轮转,保留 2 份备份;这两项设置都可以调整。

    docs / kit / daemons

  • c188

    运行临时命令

    启动一次性程序,并获取它的退出结果。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/quick-start

    对 AI 这样说
    运行一次我的迁移,并检查退出码。

    须知命令运行时间超过启动窗口时,返回 running。命令结束后,状态和日志仍可访问 10 分钟。

    docs / kit / daemons

  • c189

    等待服务器就绪

    启动服务器,等它的端口开始接受连接后,才返回结果。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/{id}/start

    对 AI 这样说
    等我的 API 端口就绪后再继续。

    须知在程序上设置 ready_port,并使用等待式启动。

    docs / kit / daemons

  • c190

    每个端口一个程序

    在一段端口范围内,运行程序的多个独立实例。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    对 AI 这样说
    在 8000 至 8003 端口上运行我的服务的 4 个副本。

    须知每个实例通过命令行参数接收自己的端口;命令中不要写端口。

    docs / kit / daemons

  • c191

    可交互的守护进程

    通过终端查看受管理的程序,并向它输入内容。

    对 AI 这样说
    在终端中运行我的 worker,方便我与它交互。

    须知沙箱中的程序不能有 terminal_id。

    docs / kit / daemons

  • c192

    程序状态概览

    显示程序状态,不暴露命令或环境变量。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/overview

    对 AI 这样说
    显示我的程序的安全状态概览。

    docs / kit / daemons

  • c193

    离线沙箱工作进程

    运行一个关闭了 IP 网络的工作进程,它无法访问互联网。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    对 AI 这样说
    运行这个工作进程,不允许它访问 IP 网络。

    须知可通过路径访问的 Unix socket 仍然可用。程序必须是持久的、非 root 的 Daemons 程序。

    docs / kit / program-sandbox

  • c194

    沙箱连接速率

    为沙箱中的服务设置每个来源的连接速率。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/edit/{id}

    对 AI 这样说
    把我的应用限制为每个来源每秒最多 50 个新连接。

    须知入站限制适用于新的 IPv4 TCP 连接。重建规则时,额度会重置;来源超过 65,535 个后,新的来源不再计量。

    docs / kit / program-sandbox

  • c195

    私有临时空间

    给沙箱中的程序一套独立的空临时目录。

    链接https://{p}-{c}-daemon-1.{node}.computers.hoody.com/api/v1/daemon/programs/add

    对 AI 这样说
    给这个工作进程私有临时空间,每个上限 256 MiB。

    须知程序必须是持久的、非 root 的 Daemons 程序。临时空间在内存中,计入 max_memory。

    docs / kit / program-sandbox / reference

定时任务工具 7

  • c196

    立即运行定时任务

    立即运行已有的定时任务,并收到回执。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/entries/{id}/run

    对 AI 这样说
    现在运行我的定时备份。

    须知条目必须存在且已启用。已暂停或已到期的条目,以及之前的 Run now 仍在运行的条目,不会运行。

    docs / kit / cron

  • c197

    检查 cron 定时设置

    检查 cron 定时设置,用通俗的话读出含义,并查看接下来最多 3 次运行时间。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/schedule/describe

    对 AI 这样说
    检查这个 cron 表达式,显示它接下来的运行时间。

    须知只在重启时运行或从不触发的定时设置,下次运行时间为 null。

    docs / kit / cron

  • c198

    暂停定时任务

    暂停定时任务,需要时再恢复。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/users/{user}/entries/{id}

    对 AI 这样说
    先暂停夜间备份任务。

    须知已暂停的任务会以注释行的形式保留在 crontab 中。

    docs / kit / cron

  • c199

    定时任务历史

    查看托管任务的状态、退出码和运行时长。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/runs

    对 AI 这样说
    我的夜间备份成功完成了吗?

    须知历史记录每个条目最多保留 50 次已结束的运行,保留 30 天,总共最多 10,000 次。原始行没有运行记录。

    docs / kit / cron

  • c200

    定时任务实时事件

    实时跟踪任务的启动、结束和 crontab 变更。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/events/sse

    对 AI 这样说
    监视我的定时任务的变更和运行。

    须知只有托管条目会上报任务的开始和结束;你自己写的原始 crontab 行不会。

    docs / kit / cron

  • c201

    跨用户审查任务

    列出电脑上各用户的托管任务,以及解析出的手写任务。

    链接https://{p}-{c}-cron-1.{node}.computers.hoody.com/api/v1/cron/entries

    对 AI 这样说
    列出所有用户的定时任务。

    须知取回所有分页,检查 unreadable_users 和 job_lines 之后,才能认为审计完整。

    docs / kit / cron

  • 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 字节)的请求体会被拒绝。

    docs / kit / cron

后台网络请求 5

  • c203

    后台网络请求

    在后台运行耗时较长的网络请求,稍后再取结果。

    链接https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    对 AI 这样说
    启动这个耗时较长的 API 请求,稍后把结果给我。

    须知已完成的任务记录默认在 7 天后删除。

    docs / kit / curl

  • c204

    重试失败的请求

    重试失败的网络传输,每次尝试之间留出间隔。

    链接https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    对 AI 这样说
    如果传输失败,重试这次下载。

    须知最多重试 5 次。重试会重新发送 POST 请求体。

    docs / kit / curl

  • c205

    Cookie 会话

    用命名会话,在对同一网站的多次请求之间保留 Cookie。

    链接https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/request

    对 AI 这样说
    登录后用这个会话获取我的账号数据。

    须知会话会保留到被删除或闲置 30 天;之后同一个 ID 会以没有 Cookie 的状态重新开始。

    docs / kit / curl

  • 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 分钟。

    docs / kit / curl

  • c207

    后台请求事件

    跟踪后台请求的开始、进度和完成事件。

    链接https://{p}-{c}-curl-1.{node}.computers.hoody.com/api/v1/curl/sse

    对 AI 这样说
    后台下载完成时告诉我。

    docs / kit / curl

设备与网络之间 11

  • c33

    实时传送任何内容

    把文件、屏幕、摄像头或数据从一台设备实时传到另一台设备。

    链接https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/<name>

    对 AI 这样说
    把这个文件发到我的手机。

    须知不存储任何内容:发送方和接收方都必须连接,先连接的一方默认最多等待 5 分钟。分享实时广播链接前,先设置发送方密钥。

    docs / kit / pipe

  • c34

    桌面通知

    从任意脚本在电脑桌面上弹出通知,同时在手机上收到提醒。

    链接https://{p}-{c}-n-1.{node}.computers.hoody.com

    对 AI 这样说
    构建完成后,在手机上通知我。

    须知在每台设备的浏览器中开启一次提醒。送达尽力而为。在 iPhone 上,先把页面添加到主屏幕。

    docs / kit / notifications

  • c35

    让笔记本电脑上线

    把笔记本电脑上的服务器发布到电脑上该端口对应的链接。

    链接https://{p}-{c}-http-3000.{node}.computers.hoody.com

    对 AI 这样说
    把我本地的 3000 端口发布上线。

    须知在你设置代理权限之前,任何拿到端口链接的人都可以访问。访客使用端口自己的链接;隧道链接只用于管理隧道。

    docs / kit / tunnel

  • c36

    连到笔记本电脑

    只要笔记本电脑保持连接,电脑就能访问它上面的数据库或服务。

    链接https://{p}-{c}-tunnel-1.{node}.computers.hoody.com

    对 AI 这样说
    让我的 Hoody 应用使用我笔记本电脑上的数据库。

    docs / kit / tunnel

  • c37

    选择流量的出口

    让应用指向电脑的代理链接,它的请求就会经你选择的代理或你自己的设备发出。

    链接https://{p}-{c}-egress.{node}.computers.hoody.com

    对 AI 这样说
    让我的爬虫走我自己的代理。

    须知在你为它设置代理权限之前,任何拿到链接的人都能打开。

    docs / kit / egress

  • c208

    让电脑流量走代理

    让电脑的出站 TCP 流量经由 SOCKS5、HTTP 或 HTTPS 代理。

    链接https://api.hoody.com/api/v1/computers/{id}/network

    对 AI 这样说
    让这台电脑走我的 SOCKS5 代理。

    须知路由运行期间只承载 TCP。DNS 由平台解析器处理,其他出站 UDP 和 ICMP 会被阻止。

    docs / foundation / networking / network

  • c209

    重连断开的隧道

    连接断开后恢复隧道,并保留其端口。

    对 AI 这样说
    网络短暂中断后,保持我的隧道可用。

    须知监听器默认保持运行 60 秒。中断期间,已打开的连接会被切断。

    docs / kit / tunnel

  • c210

    提供本地处理程序

    无需另起服务器,就能对外提供笔记本电脑上的请求处理程序。

    对 AI 这样说
    通过我的电脑对外提供这个本地请求处理程序。

    须知serve 辅助函数需要 Bun。在 Node 上,用 expose 搭配你自己的 HTTP 服务器。

    docs / kit / tunnel

  • c211

    查看隧道绑定

    查看活跃的隧道会话及其绑定的端口。

    链接https://{p}-{c}-tunnel-1.{node}.computers.hoody.com/api/v1/tunnel/tunnels

    对 AI 这样说
    显示我的隧道会话及其绑定。

    docs / kit / tunnel

  • c212

    临时代理出口

    设置一个上游代理,客户端不续期它就会自动关闭。

    链接https://{p}-{c}-egress-1.{node}.computers.hoody.com/api/v1/egress/upstream?lease={seconds}

    对 AI 这样说
    只在我的客户端持续续期时使用这个代理。

    须知租约时长为 5 至 3,600 秒。已有的 HTTPS 隧道在关闭前仍使用原来的出口。

    docs / kit / egress

  • c213

    独立的代理凭据

    给不同客户端各自的出站代理凭据。

    链接https://{p}-{c}-egress-1.{node}.computers.hoody.com

    对 AI 这样说
    给每个客户端各自的代理凭据。

    须知各个出站索引共用同一个上游。代理权限必须按索引分别配置。

    docs / kit / egress

实时传输 6

  • c214

    浏览器传输页面

    从浏览器发送输入的文字、文件或粘贴的图片。

    链接https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/

    对 AI 这样说
    打开一个浏览器页面,让我发送粘贴的图片。

    须知电脑的访问规则必须允许该浏览器本身。

    docs / kit / pipe

  • c215

    直播观看者

    广播你的实时流,观看者可以随时加入和离开。

    对 AI 这样说
    广播这份日志,让观看者在它运行期间加入。

    须知同时最多 256 位观看者。观看者从加入时开始接收流;无人观看时发送的字节会丢弃。

    docs / kit / pipe

  • c216

    转发 TCP 端口

    通过管道在两台机器之间传输 TCP 连接。

    对 AI 这样说
    通过管道从另一台机器访问我的数据库。

    docs / kit / pipe

  • c217

    双向管道

    连接两个 WebSocket 对端,交换文本和二进制消息。

    对 AI 这样说
    把这两个程序连起来,实现双向对话。

    须知第三个对端会收到 409。

    docs / kit / pipe

  • c218

    传输进度

    查看传输进度,不占用接收方名额。

    链接https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name}?progress

    对 AI 这样说
    显示这次传输的进度。

    docs / kit / pipe

  • c219

    传输校验和

    用服务器计算的 SHA-256 摘要校验已传输的字节。

    对 AI 这样说
    发送这个磁盘镜像,并校验它的校验和。

    须知哈希命名或自命名的传输,其回执最多保留 10 分钟。

    docs / kit / pipe

提醒和通知 4

  • c220

    实时通知流

    把所选屏幕的通知实时推送到仪表板。

    链接https://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/stream

    对 AI 这样说
    把屏幕 1 的通知实时推送到我的仪表板。

    须知屏幕过滤只是路由,不是访问控制。能访问流 URL 的人都可以请求所有屏幕。

    docs / kit / notifications

  • c221

    通知历史

    读取一个或多个屏幕上最近的通知。

    链接https://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/{display}

    对 AI 这样说
    显示屏幕 1 上最近的通知。

    须知历史记录不含已关闭和已过期的通知,每个历史文件保留最新的 1,000 条。

    docs / kit / notifications

  • c222

    选择通知紧急程度

    设置通知的紧急程度和显示时长。

    链接https://{p}-{c}-n-1.{node}.computers.hoody.com/api/v1/notifications/notify

    对 AI 这样说
    备份失败时显示严重警报。

    须知有效期可设为 0 至 300,000 毫秒。每个调用方每分钟最多可发送 10 条通知。

    docs / kit / notifications

  • c223

    管理提醒设备

    列出已订阅的浏览器,并从提醒中移除设备。

    对 AI 这样说
    把我的旧浏览器从通知提醒中移除。

    须知默认上限为每个 Kit 50 个推送订阅。

    docs / kit / notifications

工具和整台电脑 16

  • c38

    浏览器里的 VS Code

    在任意浏览器里使用完整的 VS Code,手机也可以。

    链接https://{p}-{c}-code-1.{node}.computers.hoody.com

    对 AI 这样说
    在 VS Code 中打开我的项目。

    须知扩展来自 Open VSX;其他扩展可以作为 .vsix 文件添加。

    docs / kit / code

  • c39

    监视文件变化

    文件一变化,就能实时看到动态。

    链接https://{p}-{c}-watch-1.{node}.computers.hoody.com

    对 AI 这样说
    有新文件上传时通知我。

    须知监视服务重启后,监视器会丢失,需要重新创建。

    docs / api / watch

  • c40

    查找任意应用

    按名称在多个应用目录中查找应用,并得到运行它的命令。

    链接https://{p}-{c}-run-1.{node}.computers.hoody.com

    对 AI 这样说
    帮我找找运行 Blender 的办法。

    docs / api / run

  • c41

    流量日志

    查看到达你电脑的每个请求,可以实时看,也可以事后查。

    链接https://{p}-{c}-logs-1.{node}.computers.hoody.com

    对 AI 这样说
    今天谁访问了我的网站?

    须知默认每台电脑保留最近 7 天,最多 50,000 条记录或 100 MB。

    docs / api / proxy-logs

  • c42

    防火墙

    决定什么可以访问你的电脑,以及电脑可以连接到哪里。

    对 AI 这样说
    对外部连接关闭我的数据库端口。

    须知仅支持 IPv4 地址和地址段,不支持域名。经由 Hoody 的 SSH 网关的 SSH 连接不受这些规则影响。

    docs / foundation / networking / firewall

  • c43

    Linux 软件

    安装你需要的 Linux 软件。电脑共用 Hoody 的内核,需要其他内核,就用虚拟机。

    对 AI 这样说
    安装 Postgres,为我的应用建一个数据库。

    docs / concepts / computers

  • c44

    完整的虚拟机

    在电脑里以完整虚拟机运行 Windows 或另一个 Linux。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com

    对 AI 这样说
    在我的电脑上启动一个 Windows 11 虚拟机。

    须知仅限租用或专用服务器,且需在电脑停止时开启 KVM。

    docs / kit / vm

  • c224

    查找失败的请求

    按服务、路径、HTTP 状态或请求 ID 筛选流量日志。

    链接https://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    对 AI 这样说
    查找今天对我的应用的失败请求。

    须知日志访问遵循电脑的代理权限和已配置的保留期限。

    docs / api / proxy-logs

  • c225

    读取已记录的消息体

    检查电脑流量时,获取已存储的请求体或响应体。

    链接https://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs

    对 AI 这样说
    显示该请求已记录的响应体。

    须知名称看起来像机密的字段在存储前会脱敏。一页中的请求体超过 4 MiB 后,其余条目不再附带请求体。

    docs / concepts / auditing

  • c226

    按时间统计流量

    按时间段统计匹配的代理日志条目。

    链接https://{p}-{c}-logs-1.{node}.computers.hoody.com/_logs/stats

    对 AI 这样说
    统计我的应用今天每小时的错误数。

    须知每个时间桶至少 60,000 ms,每个窗口最多 240 个时间桶。

    docs / api / proxy-logs

  • c227

    筛选监视的文件

    监视所选路径,并按文件名模式或变更类型筛选事件。

    链接https://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers

    对 AI 这样说
    监视我的上传文件夹里的新 CSV 文件。

    须知监视器在服务重启后不会保留。排除模式优先于包含模式。

    docs / api / watch

  • c228

    回放文件变更

    获取监视器保留的文件事件,从指定事件 ID 或时间戳之后开始。

    链接https://{p}-{c}-watch-1.{node}.computers.hoody.com/api/v1/watch/watchers/{id}/events

    对 AI 这样说
    显示今天早上以来保留的文件变更。

    须知历史记录是环形缓冲区,较早的事件可能被淘汰。监视器在服务重启后不会保留。

    docs / api / watch

  • c229

    查找监听端口

    列出监听端口,查看每个端口属于哪个程序和用户。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/ports

    对 AI 这样说
    找出监听 3000 端口的程序。

    docs / api / terminal / monitoring

  • c230

    暂停和恢复进程

    暂停一个进程或进程树,恢复时内存状态保持不变。

    对 AI 这样说
    暂停我的构建,稍后恢复。

    须知部分系统和服务的 PID 受到保护,无法通过这些端点冻结或恢复。

    docs / api / terminal / monitoring

  • c231

    服务器资源用量

    查看服务器的 CPU、内存和存储空间用量。

    链接https://api.hoody.com/api/v1/rentals/{id}/runtime

    对 AI 这样说
    显示我的服务器的 CPU 和内存用量。

    须知实时调用需要已登录的会话。与子服务器共用的租用服务器会返回 409。

    docs / foundation / servers

  • c232

    暂停防火墙规则

    停用单条防火墙规则,需要时再启用。

    链接https://api.hoody.com/api/v1/computers/{id}/firewall/ingress

    对 AI 这样说
    暂时停用这条入站防火墙规则。

    须知通过 Hoody 的 SSH 网关建立的 SSH 连接不受这些规则影响。

    docs / foundation / networking / firewall

代码编辑器选项 6

  • c233

    用链接打开文件夹

    用链接在编辑器里打开任意文件夹,无需重启编辑器。

    链接https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}

    对 AI 这样说
    在编辑器中打开我的项目文件夹。

    须知传入已规范化的绝对路径。

    docs / api / code

  • c234

    团队成员各自的编辑器

    给队友各自独立的编辑器实例,使用同一台电脑上的文件。

    对 AI 这样说
    给我们各自独立的编辑器,使用同一份项目文件。

    须知各编辑器的设置和扩展相互独立;不支持共享光标。

    docs / guides / multiplayer

  • c235

    独立的编辑器实例

    打开独立的编辑器实例,各有自己的设置和扩展。

    链接https://{p}-{c}-code-1.{node}.computers.hoody.com/

    对 AI 这样说
    为我的客户项目打开一个独立的编辑器。

    须知实例共用电脑的文件和服务账号,所以互不信任的人应使用各自独立的电脑。

    docs / kit / code

  • c236

    所有编辑器的扩展

    把 URL 指向的 VS Code 扩展文件添加到电脑上的每个编辑器。

    链接https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code/extensions/install

    对 AI 这样说
    为我的编辑器暂存这个 VSIX 扩展。

    须知编辑器只在启动时安装它,所以要用 `restart=true` 重启正在运行的编辑器。

    docs / kit / code

  • c237

    仅扩展的编辑器视图

    打开一个聚焦于某个扩展侧边栏视图的编辑器链接。

    链接https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&extension={extension}

    对 AI 这样说
    单独打开 Python 扩展视图。

    须知如果 Code 找不到匹配的侧边栏视图,就改为显示 Explorer。

    docs / kit / code

  • c238

    编辑器语言选择

    实例启动时选择编辑器的显示语言。

    链接https://{p}-{c}-code-1.{node}.computers.hoody.com/api/v1/code?folder={folder}&locale={locale}

    对 AI 这样说
    用日语打开我的编辑器。

    须知启动选项在实例启动时生效;运行中的实例需要 `restart=true`。

    docs / api / code

查找和运行应用 4

  • c239

    浏览入门应用

    浏览已测试的入门应用,查看每个应用在哪里打开。

    链接https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/catalog

    对 AI 这样说
    显示我电脑上的入门应用。

    docs / api / run / resolve

  • c240

    启动应用前预检

    运行应用前,检查它的执行计划和缺少的依赖。

    链接https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/preflight

    对 AI 这样说
    检查运行这个应用需要什么。

    docs / api / run / resolve

  • c241

    保存应用配方

    把选择和运行应用的方式保存为命名配方,之后按名称复用。

    链接https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/recipes

    对 AI 这样说
    把我偏好的 Firefox 选择保存为配方。

    docs / api / run / recipes

  • c242

    批量查找应用

    一次请求搜索多个应用,或解析它们的命令。

    链接https://{p}-{c}-run-1.{node}.computers.hoody.com/api/v1/run/batch

    对 AI 这样说
    查找这十个应用的启动命令。

    须知一个请求最多列出 100 项。更长的请求会整体拒绝,返回 400 `BATCH_TOO_LARGE`。

    docs / api / run / resolve

虚拟机 14

  • c243

    浏览器中的虚拟机屏幕

    打开虚拟机的屏幕,向它发送按键和点击。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/display

    对 AI 这样说
    打开我的虚拟机屏幕,我来完成 Linux 的安装。

    须知虚拟机需要配置自己的屏幕。浏览器中不支持复制粘贴,该屏幕有自己的代理权限。

    docs / kit / vm

  • c244

    虚拟机快照

    有风险的改动前,先为已停止的虚拟机创建快照,改完后再恢复。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/snapshots

    对 AI 这样说
    升级操作系统前,为我的虚拟机创建快照。

    须知虚拟机必须处于停止状态。恢复会替换它的磁盘、UEFI varstore 和 TPM 状态,且无法撤销。

    docs / kit / vm

  • c245

    虚拟机安装镜像下载

    按 URL 为虚拟机下载安装镜像。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/isos/downloads

    对 AI 这样说
    为我的虚拟机下载这个 Linux 安装程序。

    须知有厂商提供的 SHA-256 时就填上。没有它,会在首次使用时直接信任该镜像。

    docs / kit / vm

  • c246

    暂停虚拟机

    冻结虚拟机的 CPU,恢复后内存数据保持不变。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/pause

    对 AI 这样说
    先暂停我的测试虚拟机,等我需要时再恢复。

    须知已暂停的虚拟机会保留其内存;停止它才能释放内存。

    docs / kit / vm

  • c247

    虚拟机端口转发

    将电脑的端口转发到虚拟机内的服务。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    对 AI 这样说
    将 2222 端口转发到我的虚拟机中的 SSH 服务。

    须知端口转发会在电脑的所有地址上打开宿主端口。要修改转发,先停止虚拟机。

    docs / kit / vm

  • c248

    虚拟机共享文件夹

    在电脑和它的虚拟机之间共享文件夹。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    对 AI 这样说
    给我的虚拟机一个共享文件夹,用来存放项目文件。

    须知虚拟机快照导出不包含共享文件夹中的文件。

    docs / kit / vm

  • c249

    克隆虚拟机磁盘

    用另一台虚拟机的磁盘副本创建新虚拟机。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms

    对 AI 这样说
    克隆我的测试虚拟机,我想试一下升级。

    须知源虚拟机必须处于停止状态。副本会获得新的标识和 TPM。

    docs / kit / vm

  • c250

    迁移虚拟机

    导出虚拟机快照,并在另一台电脑上创建虚拟机。

    对 AI 这样说
    把我的测试虚拟机迁移到我的另一台电脑。

    须知不包含共享文件夹中的文件。使用原来的磁盘总线,并在删除原件前确认目标无误。

    docs / kit / vm

  • c251

    调整虚拟机规格

    修改已停止虚拟机的内存、CPU 和磁盘大小,下次启动时生效。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    对 AI 这样说
    给我已停止的虚拟机增加内存和 CPU。

    须知虚拟机必须处于停止状态。磁盘大小只能增大,且必须单独发送。

    docs / kit / vm / reference

  • c252

    虚拟机自动启动

    电脑重启后恢复运行时,自动启动其中的虚拟机。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}

    对 AI 这样说
    电脑重启后,自动启动我的虚拟机。

    须知自动启动默认关闭。更新它需要先停止虚拟机。

    docs / kit / vm

  • c253

    虚拟机串行控制台

    读取虚拟机的串行控制台,并通过链接向它发送命令。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/console

    对 AI 这样说
    读取我的虚拟机启动失败时的控制台输出。

    须知许多客户机控制台是 root shell,所以要把写入权限当作 shell 权限对待。

    docs / kit / vm

  • c254

    嵌套虚拟机

    在虚拟机内运行硬件加速的虚拟机,用于测试或 CI。

    对 AI 这样说
    在我的客户机里搭建虚拟机 CI。

    须知需要一台专用服务器,并通过 Hoody 客户支持申请开启嵌套虚拟化。

    docs / foundation / servers / virtual-machines

  • c255

    虚拟机客户机清单

    读取虚拟机客户机的操作系统、网络地址和已登录用户。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/agent/inventory

    对 AI 这样说
    显示我的虚拟机内的 IP 地址。

    须知信息必须由 guest agent 上报。不支持或不可用的部分可能缺失。

    docs / api / vm / console

  • c256

    虚拟机实时事件

    实时获取虚拟机的状态和快照事件。

    链接https://{p}-{c}-vm-1.{node}.computers.hoody.com/api/v1/vm/vms/{name}/events

    对 AI 这样说
    监视我的虚拟机的状态和快照变化。

    须知断开连接后不会重放事件;重新连接,再读取当前状态。

    docs / kit / vm

内置功能 10

  • c45

    共享笔记

    写笔记,可加入表格、文件和评论,并实时共同编辑。

    链接https://{p}-{c}-notes-1.{node}.computers.hoody.com

    对 AI 这样说
    把今天的计划写成共享笔记。

    docs / api / notes

  • c46

    你习惯的 SSH

    用你自己的 SSH、SFTP 或 VS Code Remote 连接。

    输入ssh root@{p}-{c}-ssh.{node}.computers.hoody.com

    对 AI 这样说
    给我电脑的 SSH 命令。

    须知仅限公钥,每台电脑一个密钥。

    docs / foundation / networking / ssh

  • c47

    上传、搜索、压缩

    上传和搜索文件,解压归档,把文件夹打包成 ZIP 下载。

    链接https://{p}-{c}-files-1.{node}.computers.hoody.com

    对 AI 这样说
    压缩报告文件夹,给我一个下载链接。

    须知ZIP 不包含受保护的服务状态,最多包含 1,000,000 个文件。

    docs / kit / files

  • c48

    查看运行中的程序

    一眼看清 CPU、内存和磁盘的活动,并列出运行中的程序。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/system/resources 程序:用 /api/v1/system/processes。

    对 AI 这样说
    我的电脑现在为什么这么慢?

    docs / kit / terminals

  • c49

    重启后保留的设置

    把设置和密钥存为环境变量,重启后仍然保留。

    链接https://api.hoody.com/api/v1/computers/{c}/env

    对 AI 这样说
    把我应用的 API Key 设为环境变量。

    须知运行中的程序重启后才会看到更改。任何能在电脑里运行命令的人都能读取它们。

    docs / api / computer-env

  • c50

    内存级速度存储

    把缓存和临时数据放在由内存支持的高速存储空间里。

    对 AI 这样说
    把构建缓存放进 RAM 存储空间。

    须知默认 512 MiB,最多为服务器内存的一半,由服务器上的所有电脑共享。服务器重启时数据会清空。

    docs / foundation / storage / ramdisk

  • c52

    电脑内 VPN

    在电脑内运行 VPN 服务商提供的 WireGuard 文件,电脑的链接照常可用。

    对 AI 这样说
    把这台电脑连接到我的 Mullvad VPN。

    须知用 wg-quick 启动 WireGuard 文件,不要用服务商的应用。删除其中的 IPv6 条目,保持 Network Configuration 路由为停止状态,并先添加 SSH 密钥。

    docs / foundation / networking / vpn

  • c53

    录制桌面

    直接在查看器里把桌面上发生的一切录制成视频文件。

    链接https://{p}-{c}-display-1.{node}.computers.hoody.com/?record=true

    对 AI 这样说
    AI 运行演示时录制桌面。

    须知浏览器会录制并保存为 MP4、WebM 或 GIF。GIF 录制到 30 秒时停止,较长的录制在保存前可能会一直留在浏览器内存中。

    docs / kit / displays

  • c54

    把文件拖进终端

    把文件交给终端里的程序,效果和手动拖入一样。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/drop

    对 AI 这样说
    把这张截图放进我的 Claude Code 终端。

    docs / api / terminal / file-drop

  • c257

    密钥不落盘

    把解密后的密钥保存在内存中,不会写入磁盘、快照或备份。

    对 AI 这样说
    在这个任务期间,把解密后的凭据保留在内存中。

    须知仅 Free 服务器和付费子服务器可用。宿主服务器重启时会丢失。

    docs / foundation / storage / ramdisk

使用笔记 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 导出。

    docs / api / notes / nodes

  • c259

    查找最近的笔记

    查看标题或文字最近有改动的 Notebook 页面,最新的排在最前。

    链接https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/recent

    对 AI 这样说
    显示最近改动过的页面。

    docs / api / notes / nodes

  • c260

    追加笔记块

    在笔记末尾添加文本或结构化块。

    链接https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/document/append

    对 AI 这样说
    把今天的会议记录追加到那个页面。

    须知每个请求最多 100 个块。

    docs / api / notes / nodes

  • c261

    保存笔记版本

    把笔记保存为一个版本,之后可以恢复。

    链接https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/nodes/{nodeId}/versions

    对 AI 这样说
    编辑前,先保存这条笔记的一个版本。

    须知恢复时,被替换的内容会保存为一个新版本。

    docs / api / notes / versions

  • 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。

    须知归档只包含你有权读取的项目。频道和消息、数据库视图和字段定义不包含在内。

    docs / api / notes / notebooks

  • 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 权限。

    docs / api / notes / collaborators

  • c264

    筛选笔记记录

    对笔记数据库中的记录筛选、排序,或按名称搜索。

    链接https://{p}-{c}-notes-1.{node}.computers.hoody.com/api/v1/notes/notebooks/{notebookId}/databases/{databaseId}/records

    对 AI 这样说
    显示我的笔记数据库记录,按名称排序。

    须知列表是分页的。

    docs / api / notes / databases

  • c265

    可续传的笔记上传

    分块上传文件到 Notebook,中断后可续传。

    对 AI 这样说
    把这个大附件分块上传到我的 Notebook。

    须知只有创建该文件节点的用户才能向它上传。

    docs / api / notes / files

hoody / capabilities / bots

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 帮我搭一个博客。

    docs / api / agent / bots

  • b02

    智能体团队

    把任务交出去,由智能体团队完成并汇报。

    对 AI 这样说
    让智能体团队修复失败的测试,并汇报。

    docs / api / agent / bots

  • b03

    不必重复说明

    Bot 会跨消息保留对话,较长的对话可能会生成摘要。

    对 AI 这样说
    从昨天停下的地方继续。

    docs / api / agent / bots

  • b04

    规则与范围

    选择它可以操作哪些电脑,以及它必须遵守的规则。

    对 AI 这样说
    只让我的 Bot 处理我的网站项目,绝不推送到 main。

    须知更改只影响新的委派。已在运行的智能体保留当初设定的限制。

    docs / api / agent / bots

  • b05

    分享你的 Bot

    把 Bot 的 .hoody.bot 链接分享给你信任的人。他们用自己的密钥在任意浏览器里和它聊天,不需要账号。

    链接https://<label>.hoody.bot

    对 AI 这样说
    让我的联合创始人使用我的 Bot。

    须知所有人共用一个对话,每次调用都消耗你的额度或服务商密钥。可以暂停、撤销每个密钥,或按地址限制每个密钥。请求限额对所有密钥一视同仁,目前尚无支出上限。Bot URL 仅支持 IPv4。

    docs / kit / agent / bot-urls

  • b06

    其他 AI 应用里的 Bot

    用 Bot 的 .hoody.bot URL 和一个命名密钥,连接其他 AI 应用和智能体。

    链接https://<label>.hoody.bot/v1

    对 AI 这样说
    在这个应用里把我的 Hoody Bot 当作模型。

    须知Bot 保留自己的共享对话。只使用应用的最后一条消息,忽略它的系统提示词、工具和之前的消息。

    docs / kit / agent / bot-urls / calling

  • b07

    和 Bot 说话

    实时对 Bot 说话,或给它发送语音录音。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{bot}/voice

    对 AI 这样说
    让我开车时也能和 Bot 说话。

    须知每个 Bot 同一时间只能有一个语音连接,语音每天有用量限制。

    docs / kit / agent / voice

  • 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 同一时间只能有一个语音连接。

    docs / api / agent / bots / voice

  • b10

    所有聊天应用共用一个 Bot

    Telegram、Slack 和 Discord 都连到同一个 Bot 和同一个对话。

    对 AI 这样说
    也把我的 Bot 连接到团队的 Slack。

    须知Bot 只读取文本。文件、图片和语音消息不会转交,只转交其中的说明文字或文本。与你配对的每个人共用同一个对话。

    docs / kit / agent / chat-apps

  • b29

    每个 Bot 一个模型

    为 Bot 自己的回复选择模型。

    对 AI 这样说
    给我的研究 Bot 指定它自己的模型。

    须知Bot 启动的任务使用默认模型,除非你为该 Bot 开启了按任务选择模型。

    docs / kit / agent / ai-models

  • b30

    Bot 独立默认值

    为 Bot 单独设置默认模型,与你的 AI 助手分开。

    对 AI 这样说
    给我的 Bot 使用另一个默认模型。

    须知跟随默认值的 Bot,会在对话重新开始时切换到它。

    docs / kit / agent / ai-models

  • b31

    免提语音

    免提交谈,Bot 会判断你何时开始说话、何时停止。

    对 AI 这样说
    和我的 Bot 开始一次免提对话。

    须知使用耳机。全双工模式下,你可以说话打断回复。

    docs / kit / agent / voice

  • b32

    语音提问,文字回复

    用语音提问,阅读 Bot 的回答,不播放语音。

    对 AI 这样说
    让我对 Bot 说话,并阅读它的回复。

    须知语音转文字仍会运行:Hoody Voice 计入你服务器的语音限额,其他服务商则会为此计费。

    docs / kit / agent / voice

  • b33

    选择工作智能体

    选择 Bot 转交工作时可以使用哪些智能体。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    对 AI 这样说
    让这个 Bot 只使用我的审查智能体。

    须知列表为空表示任意智能体。

    docs / api / agent / bots

  • b34

    按规则检查任务

    让 Bot 在开始每个新任务前,先对照它的防护规则检查。

    对 AI 这样说
    对照我的 Bot 的防护规则检查新任务。

    须知严格模式下的 Bot,在检查器无法运行时会拒绝所有任务。

    docs / kit / agent / ai-models

  • b35

    工作智能体自动批准

    让 Bot 委派出去的智能体自动获得工具批准。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/bots/{id}

    对 AI 这样说
    为这个 Bot 的工作智能体开启工具自动批准。

    须知默认关闭。开启后,worker 会直接行动,不再先问你。

    docs / api / agent / bots

  • b36

    每日语音额度

    为 Bot 的语音播报和转写设置每日上限。

    对 AI 这样说
    为我的 Bot 设置每日语音额度。

    须知默认每个 UTC 日朗读 200,000 个字符,转写 14,400 秒。

    docs / api / agent / bots

聊天应用里的 Bot 11

  • b37

    配对聊天应用用户

    给某人一个配对码,让对方在聊天应用中与你的 Bot 对话。

    对 AI 这样说
    为 Sam 生成配对码,让他和我的 Bot 对话。

    须知将私信策略设为 pairing。新的配对码会替换上一个。

    docs / kit / agent / chat-apps

  • b38

    聊天中的更新

    把 Bot 完成的工作、批准请求和错误发送到主聊天。

    对 AI 这样说
    把我的 Bot 的工作更新发到我的私信。

    须知主聊天是聊天应用中的一个私信对话,或一个已批准的群组。

    docs / kit / agent / chat-apps

  • b39

    在聊天中停止

    用聊天命令停止 Bot 正在做的事。

    对 AI 这样说
    在 Telegram 中停止我的 Bot。

    须知发送者需要有控制权限。

    docs / kit / agent / chat-apps

  • b40

    选择聊天权限

    选择已配对的人可以聊天、运行命令,还是决定批准。

    对 AI 这样说
    让 Sam 可以和我的 Bot 聊天,但不能决定批准。

    须知开放访客只能聊天。

    docs / kit / agent / chat-apps / settings

  • b41

    批准群聊

    先批准一个群,群成员才能和你的 Bot 对话。

    对 AI 这样说
    批准我们的项目群与我的 Bot 对话。

    须知已批准群组的每位成员都能看到 Bot 的回答。

    docs / kit / agent / chat-apps

  • b42

    屏蔽聊天用户

    丢弃所选用户在 Bot 各个聊天中发来的消息。

    对 AI 这样说
    禁止这个用户给我的 Bot 发消息。

    须知聊天应用的屏蔽用户列表最多包含 200 个平台用户 ID。

    docs / kit / agent / chat-apps / settings

  • b43

    同步回复到聊天

    把 Bot 从其他入口发出的回复,也发到它的主聊天。

    对 AI 这样说
    把我的 Bot 在应用里的回复同步到它的主聊天。

    须知此设置默认关闭。

    docs / kit / agent / chat-apps / settings

  • b44

    暂停所有聊天应用

    一次暂停所有连接到 Bot 的聊天应用。

    对 AI 这样说
    暂停我的 Bot 的所有聊天应用。

    须知每个聊天应用各自保存自己的启用值。

    docs / kit / agent / chat-apps / settings

  • b45

    选择回复格式

    为 Bot 的聊天回复选择富文本格式或纯文本。

    对 AI 这样说
    让我的 Bot 以纯文本回复。

    docs / kit / agent / chat-apps / settings

  • b46

    聊天消息频率限制

    为使用 Bot 的人和聊天设置消息频率。

    对 AI 这样说
    限制每人每分钟最多给 Bot 发 10 条消息。

    须知默认每人每分钟可发送 10 条消息。0 表示不做限制,最大可设为 600。

    docs / kit / agent / chat-apps / settings

  • b47

    聊天通知语言

    为 Bot 的聊天应用通知选择语言。

    对 AI 这样说
    用法语显示我的聊天应用通知。

    须知不会翻译 Bot 自己的回答。可用语言有 en、de、fr、es、pt、it、ja 和 zh。

    docs / kit / agent / chat-apps / settings

Bot URL 密钥和限制 6

  • b48

    用密钥查看 Bot 状态

    检查 Bot 是否在工作,并查看待处理的批准。

    对 AI 这样说
    检查我的 Bot 是在工作,还是在等待批准。

    须知需要 Bot URL Key。

    docs / kit / agent / bot-urls / calling

  • b49

    跟进 Bot 事件

    跟进 Bot 的实时事件,并从保存的游标继续。

    对 AI 这样说
    从上次的游标继续跟进我的 Bot 的实时事件。

    须知需要 Bot URL Key。每个 Key 最多可同时打开 4 个流。

    docs / kit / agent / bot-urls / calling

  • b50

    Bot 密钥到期

    为 Bot URL 密钥设置到期时间,用于临时访问。

    链接https://api.hoody.com/api/v1/bot-urls/{id}/keys/{keyId}

    对 AI 这样说
    让 Sam 的 Bot 密钥在 12 月底到期。

    docs / api / bot-urls

  • b51

    Bot URL 访问日志

    查看哪些命名密钥调用过你的 Bot,来自哪些地址。

    对 AI 这样说
    查看我的 Bot 的访问日志,看有没有异常地址。

    须知尽力记录:部分拒绝不会留下日志行。日志不会保存说过的内容,也不会保存 Key 本身。

    docs / kit / agent / bot-urls / status

  • b52

    限制 Bot URL 流量

    为 Bot URL 及其密钥设置请求数和并发限制。

    对 AI 这样说
    调低我的 Bot URL 上每个密钥的请求限制。

    须知按 Key 设置的值适用于每个 Key。限额按请求次数计算,不按金额。

    docs / kit / agent / bot-urls / security

  • b53

    吊销所有 Bot 密钥

    一次关闭 Bot URL,并吊销它的所有密钥。

    链接https://api.hoody.com/api/v1/bot-urls/{id}/panic

    对 AI 这样说
    关闭我的 Bot URL,并吊销它的所有密钥。

    须知正在进行的调用会完成,Bot 已开始的工作会继续,直到你停止它。

    docs / kit / agent / bot-urls / security

你电脑里的智能体 22

  • b11

    所有电脑里都有 Hoody Agent

    AI 智能体常驻在你的电脑中,可在标签页里打开,也可以用 SSH 或 CLI 连接。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com

    对 AI 这样说
    打开我的 Hoody Agent。

    docs / kit / agent

  • b12

    持续运行的会话

    关掉标签页,AI 仍会继续工作,可以在任意设备上接着用。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com

    对 AI 这样说
    我不在的时候继续处理这个。

    docs / kit / agent

  • b13

    任意模型

    从 100+ 家 AI 提供商中选择,或添加你自己的模型服务器。

    对 AI 这样说
    把这个聊天换成更快的模型。

    须知你自己的模型服务器必须在公开的 HTTPS 地址上支持 OpenAI 或 Anthropic API。

    docs / kit / agent

  • b14

    同时使用多个模型

    同时问多个模型,得到一个合并的答案。

    对 AI 这样说
    问三个模型,把最好的答案给我。

    docs / kit / agent / ai-models

  • b15

    内置 GitHub

    直接在智能体里克隆、提交并发起 pull request。

    对 AI 这样说
    用这个修复发起一个 pull request。

    docs / kit / agent

  • b16

    给 AI 添加工具

    连接 MCP 服务器,给智能体添加新工具。

    对 AI 这样说
    把我团队的 MCP 服务器添加到我的智能体。

    须知本地服务器以你的权限运行,没有沙箱隔离;远程服务器会收到你提供的标头。只添加你信任的服务器。

    docs / kit / agent

  • b17

    任何 AI 都能用的记忆

    智能体可以保存和搜索记忆,不绑定在某一个 AI 应用上。

    对 AI 这样说
    记住我的网站用的是 Postgres。

    docs / api / agent / memory

  • b18

    技能

    安装技能,教智能体做新工作。

    对 AI 这样说
    安装一个撰写发布说明的技能。

    docs / api / agent / skills

  • b19

    AI 按计划运行

    让智能体按计划检查并执行操作。

    对 AI 这样说
    今天每小时检查我的网站,如果哪里出了问题,告诉我。

    须知按设定的间隔重复,间隔至少 1 分钟,默认运行 50 次(可以设置其他次数),最多同时有 8 个活动中的循环。聊天关闭或智能体重启时停止。需要长期定时设置时,用 cron。

    docs / api / agent / loops

  • b20

    保存的 AI 工作流

    保存 AI 工作流,想用时随时再运行。

    对 AI 这样说
    把这个保存为我可以再次运行的工作流。

    docs / api / agent / workflows

  • b21

    AI 的待办清单

    查看 AI 排好的任务,以及它正在做什么。

    对 AI 这样说
    你给我的项目列了哪些待办?

    docs / api / agent / todos

  • b22

    分叉聊天

    分叉一个聊天,尝试另一种思路,同时保留原来的。

    对 AI 这样说
    分叉这个聊天,换一种设计再试。

    docs / api / agent / sessions

  • b23

    查看 AI 用量

    查看每个聊天和每个模型用了多少 AI。

    对 AI 这样说
    我这周用了多少 AI?

    docs / api / agent / statistics

  • b24

    无需聊天的任务

    给智能体派一个任务,稍后再取结果,不需要聊天。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com

    对 AI 这样说
    在后台运行这份报告,给我一个稍后可以查看的任务。

    须知无头任务会自行批准每一次确认,并且可以在电脑上运行命令,所以先用代理权限锁定智能体的链接。你可以从该任务中获取结果。

    docs / api / agent / headless

  • b25

    智能体事件钩子

    智能体启动、使用工具或结束时运行你自己的命令,沿用 Claude Code 的做法。

    对 AI 这样说
    测试通过之前,不要让我的智能体结束。

    须知修改过的钩子要等你确认后才会运行。

    docs / api / agent / hooks

  • b26

    你自己的智能体

    创建你自己的智能体,每个都有自己的模型、工具和指令。

    对 AI 这样说
    创建一个只读的审查智能体,使用便宜的模型。

    docs / api / agent / agents

  • b27

    先问再做

    让智能体在每次执行会改动内容的操作前先问你。

    对 AI 这样说
    改动或运行任何东西之前,先问我。

    须知读取无需询问即可通过。会拒绝无法询问的子智能体、工作流运行和其他嵌套运行,跳过你的钩子,也不启动 MCP 服务器。锁定模式在整个会话期间保持开启。

    docs / api / agent / sessions / approvals

  • b28

    在手机上批准

    Bot 的智能体在执行有风险的步骤前会先询问,你可以在 Telegram、Slack 或 Discord 中点按“批准”或“拒绝”。

    对 AI 这样说
    部署任何东西之前,先在 Telegram 里问我。

    须知只有你允许的人才能点按这些按钮。

    docs / kit / agent / chat-apps / approvals

  • b54

    先规划再构建

    把智能体切换到规划模式,先设计,再动手实现。

    对 AI 这样说
    构建应用前,先规划架构。

    须知切回通用智能体,按计划开始构建。

    docs / guides / vibe-coding

  • b55

    应用实时预览

    智能体修改文件时,实时查看应用预览更新。

    对 AI 这样说
    构建我的应用时,启动实时预览。

    须知文档中的工作流会启动 Vite 开发服务器,并在电脑屏幕上的浏览器中打开它。

    docs / guides / vibe-coding

  • b56

    只看不改

    用探索模式,以只读工具查看你的代码。

    对 AI 这样说
    探索这个代码库,解释登录的工作方式。

    docs / guides / vibe-coding / reference

  • b57

    流式查看智能体工作

    智能体运行一轮时,实时查看它的工具调用、结果和消息。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{session_id}/prompt:stream

    对 AI 这样说
    智能体工作时,给我看它的工具调用。

    须知未配置代理权限时,电脑的 URL 本身就是凭证。

    docs / guides / ai-agents

智能体会话 14

  • b58

    重命名聊天

    给智能体会话起个标题,方便查找。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}

    对 AI 这样说
    把这个聊天重命名为“发布规划”。

    须知标题最多 120 个字符。

    docs / api / agent / sessions

  • b59

    读取聊天记录

    取回已保存的对话,包括工具调用及其结果。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/transcript

    对 AI 这样说
    给我看上一个会话的记录。

    docs / api / agent / sessions / streaming

  • b60

    截短对话

    删除会话中靠后的轮次,从更早的位置继续。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/trim

    对 AI 这样说
    把这个聊天截回到我上一次请求之前的那一轮。

    须知仅在两轮之间生效,一轮运行期间不生效。

    docs / api / agent / sessions

  • b61

    同时监看多个会话

    在一个流中跟踪最多 32 个实时会话的事件。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions:events

    对 AI 这样说
    一起监控这几个智能体会话。

    须知只能查看实时会话。

    docs / api / agent / sessions / streaming

  • b62

    调整推理强度

    选择会话模型使用的推理强度。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/effort

    对 AI 这样说
    把这个会话的推理强度设为高。

    须知级别有 low、medium、high、xhigh 和 max。

    docs / api / agent / sessions / settings

  • b63

    更简短的智能体回复

    设置会话回复的详略程度,匹配你想要的细节量。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/verbosity

    对 AI 这样说
    让这个会话的回复简洁些。

    docs / api / agent / sessions / settings

  • b64

    待回答的智能体问题

    查看各个会话中等你回答的问题和确认。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/gates

    对 AI 这样说
    给我看哪些智能体会话需要我回复。

    须知只列出该智能体当前持有的实时会话。

    docs / api / agent / sessions / approvals

  • b65

    允许或拒绝工具

    为会话设置规则,允许或拒绝某个智能体工具。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/approval/rules/{tool}

    对 AI 这样说
    在当前会话中拒绝这个工具。

    须知会话策略已锁定,或每次操作前都要先询问时,不接受允许规则。

    docs / api / agent / sessions / approvals

  • b66

    建议的问题答案

    获取辅助模型对智能体挂起问题的建议答案。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/answer:assist

    对 AI 这样说
    为我的智能体正在等待的问题建议答案。

    须知建议并不回答问题,真正的答案会单独发送。

    docs / api / agent / sessions / approvals

  • b67

    引导运行中的工作流

    在工作流运行时向它发送反馈。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/workflow/messages

    对 AI 这样说
    告诉运行中的工作流重点处理发布说明。

    须知仅在工作流运行期间使用。关卡挂起期间发送的消息会直接丢弃,需要在该轮结束后重新发送。

    docs / api / agent / sessions / turns

  • b68

    查看一轮的结果

    断开连接或重启后,查询这一轮的状态和结果。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/turns/{turn_id}

    对 AI 这样说
    查看我的智能体上一轮是否已结束。

    须知对实时会话和休眠会话都有效。

    docs / api / agent / sessions / turns

  • b69

    等待另一个会话

    让会话等待另一个会话的工作产生指定结果。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/waiters

    对 AI 这样说
    等另一个会话汇报构建已完成。

    须知目标必须是同一领域中的另一个实时会话。智能体重启后,等待器不会保留。

    docs / api / agent / sessions / waiters

  • b70

    摘要后的指令

    智能体每次压缩对话时,重新带入你选定的指令。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/after-compaction

    对 AI 这样说
    每次对话摘要之后,提醒智能体运行测试。

    须知最大 16 KiB。Claude Code 会话不可用。

    docs / api / agent / sessions / settings

  • b71

    暂停智能体工作

    暂停智能体的会话,之后从停下的位置继续。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/pause

    对 AI 这样说
    先暂停我的智能体,等我准备好再继续。

    须知暂停对所有领域的所有会话生效。已在运行的工作会先完成,部分独立的 Claude Code 工作不会暂停。

    docs / api / agent / system

智能体记忆 4

  • b72

    关闭记忆

    打开或关闭智能体的记忆隐私开关。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/enabled

    对 AI 这样说
    关闭这个领域的记忆。

    docs / api / agent / memory

  • b73

    编辑记忆

    更新已保存的记忆记录,你没有填写的字段保持不变。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items/{id}

    对 AI 这样说
    把我保存的项目偏好更新为使用 TypeScript。

    docs / api / agent / memory

  • b74

    删除已保存的记忆

    从智能体的记忆中删除一条或多条指定记录。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/items

    对 AI 这样说
    删除这些过时的记忆记录。

    须知删除单条记录不会清除项目摘要、关系图或整合残留。

    docs / api / agent / memory

  • b75

    查看记忆关系

    浏览项目记忆图谱中的节点和连接。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/memory/graph

    对 AI 这样说
    给我看这个项目记忆中的关系。

    docs / api / agent / memory

后台工作 9

  • b76

    立即运行循环

    立即触发定时的智能体循环,不用等下一个间隔。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}/run-now

    对 AI 这样说
    现在运行我的定时检查。

    须知已暂停的循环会触发一次,之后仍保持暂停。因熔断器而暂停的循环会恢复按计划运行。

    docs / api / agent / loops

  • b77

    设置循环预算

    为重复运行的智能体循环设置费用和时间上限。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops/{loopId}

    对 AI 这样说
    为这个循环设置费用和时间预算。

    须知每次更新只改一项:暂停状态、到期时间或预算。0 表示取消上限。

    docs / api / agent / loops

  • b78

    按条件停止循环

    让重复运行的智能体循环在满足所选条件时停止。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/loops

    对 AI 这样说
    重复这项检查,直到满足停止条件。

    须知允许的最小间隔为 60 秒。max_runs 省略、为 0 或为负数时,使用默认上限 50 次运行。

    docs / api / agent / loops

  • b79

    流式查看无头运行

    以实时事件流的形式接收智能体的无头运行。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/headless/runs

    对 AI 这样说
    以无头方式运行这个任务,并流式返回进度。

    须知无头运行会自动批准确认、计划和提问,并且可以执行代码。用代理权限保护智能体 URL。

    docs / api / agent / headless

  • b80

    取消智能体作业

    停止排队中或运行中的异步智能体作业。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jobs/{id}

    对 AI 这样说
    取消那个智能体作业。

    须知删除已完成的作业会同时删除它的历史记录。

    docs / api / agent / jobs

  • b81

    读取子智能体记录

    查看后台子智能体任务的记录和摘要。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/transcript

    对 AI 这样说
    给我看后台审查者做了什么。

    docs / api / agent / tasks

  • b82

    取消子智能体任务

    会话工作期间,停止一个后台子智能体任务。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/tasks/{tid}/cancel

    对 AI 这样说
    取消后台调研任务。

    须知会话必须是实时的。

    docs / api / agent / tasks

  • b83

    查看并停止后台 shell

    列出智能体会话启动的后台 shell,并可停止其中一个。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/sessions/{id}/bash-jobs

    对 AI 这样说
    给我看这个会话启动的后台 shell。

    docs / api / agent / tasks

  • b84

    暂停钩子

    停用或重新启用智能体的某个生命周期钩子。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hooks/toggle

    对 AI 这样说
    关闭我的 lint 钩子。

    须知需要一个实时的智能体会话。

    docs / api / agent / hooks

技能、工作流和任务 10

  • b85

    导入现有技能

    把选中的 Claude 或 Codex 技能导入智能体的本地技能库。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/import/apply

    对 AI 这样说
    把我现有的 Claude 技能导入我的智能体。

    须知先扫描技能。目标位置已存在时会拒绝,除非请求覆盖。

    docs / api / agent / skills

  • b86

    预览技能

    从技能中心预览技能,再安装到你的电脑上。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/hub/preview

    对 AI 这样说
    安装前先预览发布说明技能。

    须知预览需要搜索结果中的提供方、来源和技能 ID。

    docs / api / agent / skills

  • b87

    关闭技能

    按名称停用某个技能,需要时再启用。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/toggle

    对 AI 这样说
    先停用我的网页搜索技能。

    docs / api / agent / skills

  • b88

    编辑技能指令

    读取并替换技能的源内容,改变智能体学到的东西。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/skills/source

    对 AI 这样说
    按我们的新格式更新我的发布说明技能。

    docs / api / agent / skills

  • b89

    继续工作流

    从第一个未完成的步骤继续失败或已取消的工作流。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}/resume

    对 AI 这样说
    从中断的位置继续失败的工作流。

    须知实时会话必须处于空闲状态,并与该运行的领域、所有者、工作目录和电脑一致。一次运行只能恢复一次。

    docs / api / agent / workflows

  • b90

    查看工作流步骤

    查看每个工作流步骤的状态、耗时、token 用量和错误。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/workflows/runs/{run_id}

    对 AI 这样说
    给我看那个工作流中哪一步失败了。

    须知运行记录仅在保留期内可用。

    docs / api / agent / workflows

  • b91

    运行任务

    启动后台 worker,自主处理你的任务。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/run

    对 AI 这样说
    为这个任务启动一个 worker。

    须知该请求视同人工批准,worker 不会再要求确认。检查任务本身来确认是否完成。

    docs / api / agent / todos

  • b92

    筛选任务

    在智能体的任务列表中,按状态、标签或搜索文字查找任务。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos

    对 AI 这样说
    给我看标记为“账单”的未完成任务。

    docs / api / agent / todos

  • b93

    延后任务

    把任务延后到指定的唤醒时间,或清除已有的延后。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/snooze

    对 AI 这样说
    把这个任务延后到明天。

    docs / api / agent / todos

  • b94

    评论任务

    在任务时间线上添加评论,不会再启动一轮智能体运行。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/todos/{id}/messages

    对 AI 这样说
    把这条客户信息添加到任务里。

    docs / api / agent / todos

在智能体中使用 GitHub 6

  • b95

    审查仓库变更

    以统一 diff 格式读取仓库中已暂存或未暂存的变更。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/diff

    对 AI 这样说
    给我看我仓库里已暂存的变更。

    须知捕获的输出最多 1 MiB。

    docs / api / agent / github

  • b96

    起草提交信息

    让模型根据仓库中待提交的变更起草提交信息。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/commit/suggest-message

    对 AI 这样说
    为我的变更建议一条提交信息。

    须知diff 会发送给模型的提供方,该调用会计费。它不会提交。

    docs / api / agent / github

  • b97

    GitHub 议题

    在智能体中列出仓库议题,或新建议题。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/issues

    对 AI 这样说
    为登录页面的故障新建一个议题。

    须知议题列表最多返回 200 个议题,按最近更新排序。

    docs / api / agent / github

  • b98

    关联的工作树

    创建关联的工作树,处理仓库的另一个分支。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/worktrees

    对 AI 这样说
    为我的功能分支创建一个工作树。

    docs / api / agent / github

  • b99

    切换 GitHub 账号

    切换已关联的 GitHub 账号,用于智能体之后的操作。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/auth/active

    对 AI 这样说
    把我的智能体切换到我的工作 GitHub 账号。

    须知账号必须已关联。

    docs / api / agent / github

  • b100

    检查远程分支

    不改动当前检出,查看 GitHub 分支指向哪个提交。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/github/remote-branch

    对 AI 这样说
    检查我上一次推送是否已到达远程分支。

    须知它用你当前的账号读取 GitHub,不会改动你本地检出的任何内容。

    docs / api / agent / github

智能体设置 15

  • b101

    设置 AI 支出上限

    设置聊天和单轮的支出上限,用来停止工作或提醒你。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/spend-caps

    对 AI 这样说
    为我的智能体聊天设置支出上限。

    须知上限以美元计,范围从 0(关闭)到 1,000,000。已在运行的工作不会中途停止。

    docs / api / agent / settings

  • b102

    轮换提供商账号

    某个提供商的账号达到用量上限时,智能体会切换到该提供商另一个已登录的账号。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/features

    对 AI 这样说
    为我的智能体开启账号轮换。

    docs / api / agent / settings

  • b103

    导入 MCP 设置

    把 Claude、Cursor 或 VS Code 里的 MCP 服务器定义导入智能体。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/import

    对 AI 这样说
    导入我在 Cursor 里的 MCP 服务器设置。

    须知导入的服务器初始为禁用状态。有一个条目无效,整个导入就会中止。

    docs / api / agent / mcp

  • b104

    测试 MCP 服务器

    保存前,测试服务器配置并查看它的工具。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/probe

    对 AI 这样说
    在我保存前,测试这个 MCP 服务器配置。

    须知探测只能由人工发起,可能会启动进程或发出出站请求。

    docs / api / agent / mcp

  • b105

    停用 MCP 服务器

    关闭一个 MCP 服务器,保留它已保存的设置和凭据。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/mcp/servers/enable

    对 AI 这样说
    先停用我的议题跟踪 MCP 服务器。

    须知禁用后,该服务器会立即在所有实时会话中断开。

    docs / api / agent / mcp

  • b106

    领域范围的指令

    设置领域内聊天、助手和工作流步骤共用的指令。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/settings/agent-instructions

    对 AI 这样说
    让这个领域里的每个智能体都使用美式英语。

    须知运行中的聊天从下一轮起生效。

    docs / api / agent / settings

  • b107

    复制智能体

    用新名称复制智能体的定义,做出你自己的版本。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/copy

    对 AI 这样说
    复制我的审查智能体,方便我自定义。

    须知不允许复制到产品自带的 Bot 智能体名称上。

    docs / api / agent / agents

  • b108

    设置智能体轮次上限

    设置单个智能体每次运行的最大轮次。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/turns

    对 AI 这样说
    给我的审查智能体设置轮次上限。

    须知不能用这种方式修改 Bot 智能体。

    docs / api / agent / agents

  • b109

    恢复智能体默认值

    自定义之后,恢复内置智能体的原始定义。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/agents/{name}/reset-to-shipped

    对 AI 这样说
    把这个智能体重置为内置默认值。

    须知重置会丢弃本地的自定义内容。

    docs / api / agent / agents

  • 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。凭证文件以及带有登录信息或对话的状态不包括在内。

    docs / api / agent / settings

  • 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 必须已存储。

    docs / api / agent / models

  • b112

    按账号查看用量

    按提供商和账号分组查看 AI 用量,时间范围可选全部时间或从某个日期开始。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/usage/by-account

    对 AI 这样说
    显示我从周一起按账号统计的 AI 用量。

    须知用量按全局统计,而不是按领域划分。省略开始时间则统计全部历史用量。

    docs / api / agent / statistics

  • b113

    选择智能体领域

    选择智能体在新会话中默认使用的领域。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/hoody/realm

    对 AI 这样说
    新的智能体会话使用我的工作领域。

    须知所选内容对所有客户端生效。现有会话保留各自的领域,受领域限制的登录只能选择允许的领域。

    docs / api / agent / discovery

  • b114

    搜索智能体日志

    按会话、时间、级别或文本筛选智能体日志。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs

    对 AI 这样说
    查找这个智能体会话最近 1 小时内的错误。

    须知每页最多 500 条,默认 200 条。

    docs / api / agent / logs

  • b115

    导出脱敏日志

    把筛选后的智能体日志下载为脱敏的 JSONL 或文本。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/logs/export

    对 AI 这样说
    把智能体的错误导出为脱敏的文本文件。

    须知导出内容始终经过脱敏。来自平台的导出只含一页,默认 2,000 行。

    docs / api / agent / logs

hoody / capabilities / api

03 64 行

API

在 Hoody 里能做的事,你的 AI 或脚本也都能做。

在 Hoody 上开发 13

  • a01

    一个 API 管所有事

    在 Hoody 里能做的事,你的 AI 或脚本也都能做。

    链接https://api.hoody.com

    对 AI 这样说
    用 Hoody API 帮我设置好。

    docs / foundation / hoody-api

  • a02

    按需创建电脑

    AI 在你的项目里创建电脑,并启动、停止或删除它们。

    输入POST https://api.hoody.com/api/v1/projects/{p}/computers

    对 AI 这样说
    为这个客户项目添加电脑。

    docs / foundation / computers / create-edit-delete

  • a03

    复制一套配置

    把你的一台电脑复制到另一个项目或服务器。

    链接https://api.hoody.com

    对 AI 这样说
    复制一份我的预发布环境配置。

    须知副本不会带上 SSH 密钥。防火墙规则、代理别名和快照留在源电脑上。

    docs / foundation / computers / copy-sync

  • a04

    Debian 13,开机即用

    你的电脑运行 Debian 13,开发工具已装好。

    链接https://api.hoody.com

    对 AI 这样说
    为我的个人项目准备新电脑。

    docs / foundation / computers / images

  • a05

    项目和领域

    把电脑分组到项目里,再用领域限制每个令牌能看到和控制的内容。

    链接https://api.hoody.com

    对 AI 这样说
    确保这位客户的令牌只能看到他们的项目。

    docs / concepts / realms-projects

  • a06

    自动化用的令牌

    给脚本和 AI 各自的令牌,只开放它们需要的权限。

    链接https://api.hoody.com

    对 AI 这样说
    为我的部署脚本创建一个令牌,30 天后过期,只能从我服务器的 IP 使用。

    docs / foundation / hoody-api / authentication

  • a07

    命令行

    在笔记本电脑上用 `hoody` 命令完成 Hoody 的大部分操作。

    输入curl -fsSL https://install.hoody.com | sh

    对 AI 这样说
    安装 Hoody CLI 并让我登录。

    须知少数操作,例如立即运行 cron 任务,需要 SDK 或 HTTP API。

    docs / foundation / cli

  • a08

    开源 SDK

    用开源 SDK,在 TypeScript 里开发 Hoody 上的应用。

    输入npm install hoody-sdk

    对 AI 这样说
    用 Hoody SDK 写一个列出我的电脑的脚本。

    docs / getting-started / quickstart

  • a09

    任何 AI 都能读的手册

    任何 AI 读完一份手册,就会使用 Hoody。

    链接https://hoody.com/SKILLS/

    对 AI 这样说
    读取 hoody.com/SKILLS,帮我设置好。

    须知你的 AI 需要能联网运行代码,才能帮你登录。

    docs / foundation / agent-skill-bundle

  • a19

    从快照复制

    用源电脑的指定快照创建一台独立的电脑。

    链接https://api.hoody.com/api/v1/computers/{id}/copy

    对 AI 这样说
    用我测试过的快照创建一台预发布电脑。

    须知副本沿用源电脑当前的环境变量。快照历史和 SSH 密钥不会复制。

    docs / foundation / computers / copy-sync

  • a20

    复制网络规则

    把电脑的防火墙和网络规则带到新的副本中。

    链接https://api.hoody.com/api/v1/computers/{id}/copy

    对 AI 这样说
    复制我的预发布电脑,连同它的防火墙和网络规则。

    须知默认不复制规则。网络或启动失败可能导致副本处于停止状态。

    docs / foundation / computers / copy-sync

  • a21

    合并环境变量

    更新多个环境变量,不会删除其他设置。

    链接https://api.hoody.com/api/v1/computers/{id}/env

    对 AI 这样说
    在我的电脑上设置数据库 URL 和日志级别。

    须知每个请求可带 1 至 256 个变量。运行中的进程要重新执行后才会读取更改。

    docs / api / computer-env

  • a22

    电脑状态历史

    查看电脑的状态变化,排查意外停止或启动缓慢。

    链接https://api.hoody.com/api/v1/computers/{id}/status-logs

    对 AI 这样说
    显示我的电脑何时停止,以及是什么触发的。

    docs / foundation / computers / managing

项目、令牌和登录 11

  • a23

    项目访问级别

    授予其他用户项目的读取、编辑或删除权限。

    链接https://api.hoody.com/api/v1/projects/{id}/permissions

    对 AI 这样说
    授予 Sam 我项目的读取权限。

    须知你必须是所有者,或有编辑权限。访问设置立即生效。

    docs / api / projects

  • a24

    项目电脑配额

    创建或更新项目时,设置项目的电脑数量上限。

    链接https://api.hoody.com/api/v1/projects/{id}

    对 AI 这样说
    把这个项目限制为 5 台电脑。

    须知你必须是所有者,或有编辑权限。配额最小值为 0。

    docs / api / projects

  • a25

    项目资源统计

    通过一次响应获取项目中每台电脑的资源统计。

    链接https://api.hoody.com/api/v1/projects/{id}/stats

    对 AI 这样说
    显示我项目中各台电脑的资源用量。

    须知无法读取统计数据的电脑,可能会有一个占位条目。

    docs / api / projects

  • a26

    项目月流量

    获取整个项目每月经代理的请求数和响应字节数。

    链接https://api.hoody.com/api/v1/projects/{id}/proxy-usage

    对 AI 这样说
    显示我的项目最近 3 个月经代理的流量。

    须知最多请求 12 个月。合计可能不完整,不含已删除的电脑、直连 SSH、原始出站流量和其他流量。

    docs / api / projects

  • a27

    查看当前令牌

    检查当前 API 令牌的权限和领域限制。

    链接https://api.hoody.com/api/v1/auth/tokens/me

    对 AI 这样说
    显示我当前的令牌能访问什么。

    docs / api / auth-tokens

  • a28

    令牌权限模板

    创建令牌之前,列出权限模板及其解析后的权限。

    链接https://api.hoody.com/api/v1/auth/tokens/templates

    对 AI 这样说
    显示可用的令牌权限模板。

    docs / api / auth-tokens

  • a29

    复制令牌权限

    用另一个令牌的权限、领域和 IP 白名单创建令牌。

    链接https://api.hoody.com/api/v1/auth/tokens/{id}/copy

    对 AI 这样说
    把这个令牌的限制复制到新令牌。

    须知副本的密钥值是新的。

    docs / api / auth-tokens

  • a30

    调整令牌领域

    为现有的受限令牌添加或移除领域。

    对 AI 这样说
    把预发布领域添加到这个令牌。

    须知不能移除受领域限制的令牌的最后一个领域。

    docs / api / auth-tokens

  • a31

    按领域统计资源

    列出你的领域,并附上项目、电脑、服务器和令牌的数量。

    链接https://api.hoody.com/api/v1/realms/?include_usage=true

    对 AI 这样说
    统计我每个领域中的资源。

    须知该请求需要 resources.realms 权限。

    docs / api / realms

  • a32

    设备码登录

    发起设备登录,用户输入一个短码即可。

    链接https://api.hoody.com/api/v1/auth/device/code

    对 AI 这样说
    为我的应用发起设备码登录。

    须知该流程参考了 RFC 8628,但不是符合标准的设备授权。

    docs / api / authentication

  • a33

    应用身份声明

    向你的应用证明这个用户已通过 Hoody 登录,并用公钥离线校验。

    链接https://api.hoody.com/api/v1/users/auth/identity-claim

    对 AI 这样说
    为我的应用签发身份声明。

    须知仅限已登录的会话,不支持认证令牌。声明默认有效 1 小时,且不会超过你的会话时长。

    docs / api / authentication

命令行工具 5

  • a34

    CLI 账号配置

    在不同账号或环境之间切换 CLI 设置和登录。

    对 AI 这样说
    为预发布环境设置单独的 CLI 配置。

    docs / foundation / cli

  • a35

    预览 CLI 请求

    查看 CLI 命令将发送的 HTTP 请求,或获取对应的 curl 命令行。

    对 AI 这样说
    显示删除这台电脑的 HTTP 请求。

    须知密钥值会脱敏,部分正文不返回。按名称查找仍可能发出 GET 请求。

    docs / foundation / cli

  • a36

    等待 CLI 操作

    让脚本等待耗时较长的操作完成。

    对 AI 这样说
    复制这台电脑,并等到复制完成。

    须知默认等待超时为 10 分钟。

    docs / foundation / cli / reference

  • a37

    监视 CLI 列表

    资源变化时,反复刷新 CLI 列表。

    对 AI 这样说
    每 5 秒刷新一次我的电脑列表。

    须知需要交互式终端。默认间隔为 2 秒。

    docs / foundation / cli / reference

  • a38

    锁定本地 CLI 凭据

    用密码加密已保存的 CLI 令牌和默认 ID。

    对 AI 这样说
    用密码保护我已保存的 CLI 凭据。

    须知开启锁定会删除已保存的账号密码。

    docs / foundation / cli / reference

智能体构建模块 4

  • a39

    单次模型回复

    为你的应用获取一次模型回复,可以是 JSON 或流式,不需要智能体会话。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/completions

    对 AI 这样说
    为这段文本获取一次模型回复。

    须知没有会话、转录记录和工具调用。每次调用都计费。

    docs / api / agent / models

  • a40

    直接运行工具

    直接调用智能体工具,在你的应用中接收结果。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools/{name}/run

    对 AI 这样说
    调用这个智能体工具并返回结果。

    须知会改动内容的工具只有在你选择启用时才会运行,运行前可能先要求确认。仅在这台电脑上运行。

    docs / api / agent / tools

  • a41

    查看智能体工具

    列出智能体的内置工具,并查看它们的输入结构。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/tools

    对 AI 这样说
    显示智能体内置工具的输入。

    docs / api / agent / tools

  • a42

    监视智能体数据变化

    以流式推送变更通知,让你的应用刷新受影响的智能体数据。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/changes/stream

    对 AI 这样说
    智能体数据变化时,更新我的仪表板。

    须知令牌只表明哪些列表有变化,由你的应用重新读取这些列表。

    docs / api / agent / changes

你的应用和 AI 模型 14

  • a10

    嵌入实时工具

    把实时的终端、桌面、编辑器或数据库放进你自己的页面。

    链接https://{p}-{c}-terminal-1.{node}.computers.hoody.com 在 iframe 中

    对 AI 这样说
    在我的仪表板页面里显示实时终端。

    须知嵌入他人可见的链接之前,先设置代理权限。

    docs / guides / embed-urls

  • a11

    每个请求都先过你的 Exec 脚本

    匹配的请求会先交给你的 Exec 脚本:检查、修改或直接应答。

    对 AI 这样说
    加一道检查,拦截不带我指定请求头的请求。

    须知路径匹配时会拒绝 WebSocket 升级,所以匹配范围里不要包含这些路径。钩子在 500 ms 后超时,除非你设置更长的时间,最长 30 秒。

    docs / foundation / proxy / hooks

  • a12

    用链接调用 AI 模型

    在你的电脑上调用众多 AI 模型,不需要 API Key。

    对 AI 这样说
    用便宜的模型给这 1,000 张照片打标签。

    须知付费模型按用量从你的 AI 余额扣费,免费模型每台服务器有用量限制。不含 OpenAI、Anthropic 或 Google 的模型。

    docs / foundation / hoody-ai

  • a13

    查看 AI 调用

    让 AI 调用经过 Exec 脚本,记录日志、缓存或修改。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    对 AI 这样说
    记录我的应用发出的每次 AI 调用。

    docs / foundation / hoody-ai / mitm

  • a14

    语音输入与输出

    把文字转成语音,也把语音转成文字。

    链接https://ai.hoody.com/api/v1/audio/speech · `.../audio/transcriptions`

    对 AI 这样说
    把这篇文章朗读出来,保存为音频文件。

    须知在服务器的语音限额内免费,在你的电脑内使用。

    docs / foundation / hoody-ai / usage

  • a16

    免费网页搜索

    电脑里的代码无需 API Key 就能搜索网页,在服务器限额内免费。

    输入POST https://ai.hoody.com/api/v1/coding_plan/search

    对 AI 这样说
    搜索网页,看看别人怎么修复这个错误。

    须知在服务器的限额内免费,在你的电脑内使用。

    docs / foundation / hoody-ai / usage

  • a17

    AI 的是/否回答

    向 Hoody AI 提出是非题、单选题或打分题,得到每个答案的可能性。

    输入POST https://ai.hoody.com/api/v1/decisions

    对 AI 这样说
    让 AI 判断每个支持工单是否紧急。

    须知在服务器的限额内免费,在你的电脑内使用。

    docs / foundation / hoody-ai / decisions

  • a18

    每台电脑的 AI 开关

    为每台电脑开启或关闭 AI,并查看各自的用量。

    对 AI 这样说
    关闭我客户那台电脑上的 AI。

    docs / foundation / hoody-ai / security

  • a43

    打开指定视图

    生成指向所选文件编辑器、终端会话或数据库表视图的链接。

    对 AI 这样说
    生成指向 users 表视图的链接。

    须知部分视图需要参数,禁止嵌入的视图必须在新标签页中打开。

    docs / guides / embed-urls

  • a44

    导入 API

    把另一个 API 的 OpenAPI 文档转成可转发调用的脚本端点。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/sdk/import

    对 AI 这样说
    把这份 API 规范导入为脚本端点。

    docs / kit / exec / reference

  • a45

    为脚本 API 生成文档

    为你的脚本生成 OpenAPI 规范。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1/exec/user-openapi/generate

    对 AI 这样说
    为我的脚本生成 OpenAPI 规范。

    docs / api / exec / routing

  • a46

    改写服务响应

    在响应到达调用方之前,查看并修改服务的响应。

    对 AI 这样说
    为我的应用的响应添加一个 header。

    须知会拒绝路径匹配某个 hook 的 WebSocket 升级。每个服务最多 8 个 hook,每台电脑最多 32 个。

    docs / foundation / proxy / hooks

  • a47

    读取访客 IP

    在通过 Hoody 链接访问的应用中,读取访客的真实 IP 地址。

    对 AI 这样说
    在我的应用访问日志中显示访客 IP。

    须知代理 hook 转发请求时,应用看到的是该 hook 的连接地址。

    docs / foundation / proxy

  • a48

    查询访客网络

    查询访客公网 IPv4 地址所属的国家和网络信息。

    链接https://api.hoody.com/api/v1/ip/lookup?ip={ips}

    对 AI 这样说
    显示这些访客 IP 所属的国家。

    须知每次查询最多 25 个公网 IPv4 地址。Hoody 没有数据的地址会返回 null。

    docs / foundation / proxy

Hoody AI 模型 8

  • a49

    浏览模型目录

    列出可用模型及其上下文长度、模态和当前价格。

    链接https://api.hoody.com/api/v1/ai/models

    对 AI 这样说
    列出可用的 AI 模型及其上下文长度。

    须知目录已缓存。不含 OpenAI、Anthropic 和 Google 的模型。

    docs / api / ai-models

  • a50

    流式输出模型回答

    模型生成回答的同时,把文本显示给你的用户。

    对 AI 这样说
    把回答流式输出到我的聊天应用。

    须知在已启用 AI 的电脑内调用。

    docs / foundation / hoody-ai / usage

  • a51

    连接编程助手

    在你的电脑上,让 Cline、Cursor 或 Windsurf 使用 Hoody AI。

    对 AI 这样说
    在我的电脑上把 Cline 连接到 Hoody AI。

    须知该工具必须在电脑内运行。Cursor Tab 补全仍使用 Cursor 的内置模型。

    docs / foundation / hoody-ai

  • a52

    使用模型工具调用

    随聊天请求发送工具定义,供支持的模型使用。

    对 AI 这样说
    让我的模型调用天气函数。

    须知回答的模型支持工具时才可用。在已启用 AI 的电脑内调用。

    docs / foundation / hoody-ai / models

  • a53

    根据截图做判断

    向 Hoody AI 询问关于截图的是非问题,例如页面是否出错。

    对 AI 这样说
    检查这张结账截图是否看起来出错了。

    须知支持 PNG、JPEG、WebP 和 GIF,每个请求最多 4 张图片,解码后每张最大 1 MiB。不接受远程图片 URL。

    docs / foundation / hoody-ai / decisions

  • a54

    用你自己的模型做判断

    通过智能体提出是非、单选或打分问题,由你选择的模型作答。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/jev/decide

    对 AI 这样说
    让智能体用我配置的模型对这张工单分类。

    须知其他提供方的模型需要该提供方的 Key。

    docs / foundation / hoody-ai / decisions

  • a55

    查看免费 AI 额度

    大致查看你的账号已用掉每台服务器多少免费 AI 额度。

    链接https://api.hoody.com/api/v1/users/me/free-ai-usage

    对 AI 这样说
    按服务器显示我的免费 AI 用量。

    须知读数是近似值。认证令牌需要 `computers.read`,受领域限制的令牌会得到 `403`。

    docs / foundation / hoody-ai / models

  • a56

    删除 AI 用量记录

    删除电脑中早于指定时间的 AI 用量记录。

    对 AI 这样说
    删除这台电脑 1 月之前的 AI 用量记录。

    须知删除只作用于发起调用的电脑。处理中请求的行不会删除。

    docs / foundation / hoody-ai / security / reference

语音和音频 5

  • a57

    转写常见音频格式

    把 WAV、MP3、WebM、OGG、M4A 或 FLAC 录音转成文本,可上传,也可用 base64。

    对 AI 这样说
    转写这段 M4A 语音备忘录。

    须知音频最大 25 MB(25,000,000 字节),最长 600 秒。不接受音频 URL。可在电脑内调用。

    docs / foundation / hoody-ai / models / reference

  • a58

    选择朗读语音

    从 4 种声音中选一种,把文本转成 PCM 或 MP3 音频。

    对 AI 这样说
    用 Bella 的声音朗读这条笔记,输出 MP3。

    须知文本最多 4,096 个字符。Hoody Voice 在电脑内工作,受其服务器语音限额约束。

    docs / foundation / hoody-ai / models / reference

  • a59

    流式输出语音音频

    语音生成后立即流式传输到你的应用。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/speech/stream

    对 AI 这样说
    把语音回答流式传输到我的应用。

    须知仅适用于能流式输出语音的模型。

    docs / api / agent / audio

  • a60

    为转录文本加时间戳

    有分段和时间信息可用时,请求带分段和时间的转录文本。

    对 AI 这样说
    转录这段录音,并附上分段时间戳。

    须知音频最大 25 MB(25,000,000 字节),最长 600 秒。分段字段可能缺失或为 null。

    docs / foundation / hoody-ai / models / reference

  • a61

    查找语音模型

    列出语音模型,并按转录或语音能力筛选。

    链接https://{p}-{c}-agent-1.{node}.computers.hoody.com/api/v1/agent/audio/models

    对 AI 这样说
    列出我的智能体可用的语音转文字模型。

    须知列出的模型在某次调用时仍可能不可用。

    docs / api / agent / audio

AI 请求代理 4

  • a62

    审核有风险的 AI 请求

    在你的代理中暂存 AI 请求,直到有人批准或拒绝。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    对 AI 这样说
    把有风险的 AI 请求暂存,等我批准后再放行。

    须知批准和拒绝脚本需要你自己添加。没有它们,挂起的请求会以 408 结束。

    docs / foundation / hoody-ai / mitm

  • a63

    为提示词添加知识

    用代理脚本把知识库结果加入提示词。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    对 AI 这样说
    把相关的公司文档加入每条 AI 提示词。

    须知分享代理前,先用脚本令牌和代理权限保护它。

    docs / foundation / hoody-ai / mitm

  • a64

    转发到其他提供商

    用代理脚本把 AI 请求发送到你选择的提供商。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    对 AI 这样说
    把这个应用的 AI 请求转发到我的提供商。

    须知提供方 Key 和代理安全由你自己管理。

    docs / foundation / hoody-ai / mitm

  • a65

    改写 AI 工具调用

    在客户端运行之前,用代理修改模型的工具调用。

    链接https://{p}-{c}-exec-1.{node}.computers.hoody.com/api/v1

    对 AI 这样说
    把 AI 写入文件的操作重定向到我的审核文件夹。

    须知改写只是路由,不是隔离。限制要在执行调用的工具里落实。

    docs / foundation / hoody-ai

hoody / capabilities / across

04 58 行

所有功能通用

无论你从哪里进入,这些对全部功能都成立。

链接、分享和安全 12

  • x01

    一切都是 URL

    每个工具、文件、应用和 Bot 都有自己的链接。

    链接https://{p}-{c}-<kit>-1.{node}.computers.hoody.com

    对 AI 这样说
    把那个链接发给我。

    docs / concepts / everything-is-a-url

  • x02

    实时协作

    分享一个链接,大家同时在同一个终端、桌面或编辑器里工作。

    对 AI 这样说
    把我的终端分享给 Sam,我们一起解决这个问题。

    须知链接里没有 ?sharing=true&steal=false 时,桌面上的第二个人会从第一个人手中接管。

    docs / guides / multiplayer

  • x03

    人和 AI 一起

    人和 AI 在同样的工具里并肩工作,怎么搭配都行。

    对 AI 这样说
    让我的 AI 在同一个桌面上工作,我在旁边看。

    docs / guides / multiplayer

  • x04

    快照与撤销

    保存电脑存储空间的快照,一步恢复。

    链接https://api.hoody.com

    对 AI 这样说
    改动之前先创建快照。

    须知同一台服务器上的回滚点,不是备份:它会随电脑一起删除。恢复会替换当前存储空间,并丢弃之后的更改。已挂载的存储和运行中的进程不会保存。

    docs / concepts / snapshots

  • x05

    私密链接

    生成的链接很难猜到,但公开链接可能泄露,任何拿到它的人都能使用。短链接可以被猜到:要真正控制访问,就锁定任意链接。

    对 AI 这样说
    这个链接是私密的吗?

    docs / concepts / security

  • x06

    锁定任意链接

    给电脑的链接加上密码、登录或 IP 列表,再选择该组可以打开哪些程序。

    对 AI 这样说
    分享之前,给我的桌面链接设置密码。

    docs / foundation / proxy / permissions

  • x07

    查看发生了什么

    查看登录记录、你已认证的 API 调用及所用的令牌,以及每台电脑提供的流量。

    对 AI 这样说
    显示我的 AI 令牌本周发起了哪些 API 调用。

    docs / concepts / auditing

  • x08

    加密保险库

    把密码和密钥存放在保险库里,并为每个条目开启加密。

    对 AI 这样说
    把我的 Stripe 密钥存进保险库。

    docs / kit / agent / reference

  • x23

    磁盘加密

    在 Hoody 的每台服务器上,你的电脑磁盘都是静态加密的。

    对 AI 这样说
    我的电脑磁盘加密了吗?

    须知磁盘加密不能保护运行中服务器上的数据。

    docs / concepts / security

  • x24

    暂停 URL 访问

    排查事件期间,切断对你电脑 URL 的新请求。

    链接https://api.hoody.com/api/v1/computers/{c}/proxy/permissions/state

    对 AI 这样说
    暂停访问这台电脑的 URL。

    须知生效可能需要几秒或更久。SSH 以及已建立的 WebSocket 或 CONNECT 隧道会保持打开。

    docs / concepts / security

  • x25

    会过期的快照

    设置电脑快照在指定天数后过期。

    链接https://api.hoody.com/api/v1/computers/{id}/snapshots

    对 AI 这样说
    创建一个部署前快照,30 天后过期。

    须知有效期是 1 至 3,650 之间的整数天数。创建后检查 `expires_at`:创建成功时它也可能为 null。

    docs / foundation / computers / snapshots

  • x26

    为快照加标签

    修改快照的标签,标记电脑的已知良好状态。

    链接https://api.hoody.com/api/v1/computers/{id}/snapshots/{name}/alias

    对 AI 这样说
    把那个快照标记为已测试的发布版本。

    须知别名最多 100 个字符。修改别名不会重命名快照。

    docs / foundation / computers / snapshots

链接访问规则 8

  • x27

    仅限 Hoody 用户

    只允许已登录的 Hoody 用户,或你列出的用户 ID,调用你的服务。

    对 AI 这样说
    只允许已登录的 Hoody 用户调用我的 API。

    须知调用方在请求头中发送已签名的 Hoody 身份声明。允许列表最多容纳 256 个用户 ID。

    docs / api / proxy-permissions

  • x28

    合作伙伴访问令牌

    合作伙伴带上请求头、Cookie 或查询参数中的令牌,即可访问。

    对 AI 这样说
    给我的合作伙伴一个 API 令牌。

    须知分组必须有程序授权,未匹配的调用方仍适用默认策略。

    docs / foundation / proxy / permissions

  • x29

    应用的 JWT 访问

    让应用的用户用你的应用签发的令牌,打开指定的服务。

    对 AI 这样说
    访问我的应用服务时,要求出示应用的 JWT。

    须知分组必须有程序授权,未匹配的调用方仍适用默认策略。

    docs / foundation / proxy / permissions

  • x30

    保护新服务

    把默认设为拒绝,之后添加的程序在你授权前保持关闭。

    对 AI 这样说
    新服务在我授权前保持关闭。

    须知先设置好分组。在 allow 策略下,新程序从一开始就是开放的。

    docs / foundation / proxy / permissions

  • x31

    项目级 URL 规则

    在整个项目中应用 URL 访问规则,并可在单台电脑上覆盖。

    对 AI 这样说
    把团队访问策略应用到这个项目。

    须知两者重叠时以电脑的值为准,电脑未提及的项目分组仍然有效。

    docs / foundation / proxy / permissions

  • x32

    开放指定的应用端口

    为访问组开放 HTTP 或 HTTPS 应用的指定端口。

    对 AI 这样说
    允许合作伙伴组访问 8080 端口。

    须知每个单元格最多开放 16,384 个端口。授权会开放这些端口上监听的所有内容。

    docs / foundation / proxy / permissions

  • x33

    选择终端实例

    让一个组访问你电脑上的指定终端实例。

    对 AI 这样说
    让团队使用终端 1 和 2。

    须知设置默认拒绝策略,把未匹配的调用方挡在外面。

    docs / foundation / proxy / permissions

  • x34

    查看服务访问

    一并查看服务的组访问、钩子和生效的默认规则。

    链接https://api.hoody.com/api/v1/computers/{id}/proxy/services/{service}

    对 AI 这样说
    显示我的终端的访问规则。

    docs / api / proxy-discovery

接入方式 7

  • x09

    说 @hoody.com

    对你的 AI 说“@https://hoody.com Connect to Hoody”,即可开始。

    输入@https://hoody.com

    对 AI 这样说
    @https://hoody.com Connect to Hoody

    须知你的 AI 需要能联网运行代码,才能帮你登录。

    docs / getting-started / quickstart

  • x10

    ssh hoody.com

    在任意终端输入 `ssh hoody.com`,或点击它在浏览器中打开。

    输入ssh hoody.com · `https://ssh.hoody.com`

    对 AI 这样说
    我怎么从终端进入?

    docs / foundation / cli

  • x11

    在任意浏览器中打开

    在任意设备上登录 hub.hoody.com,打开你的 Hub:电脑和智能体都在里面。

    链接https://hub.hoody.com

    对 AI 这样说
    在浏览器中打开我的 Hoody。

    docs / kit / agent

  • x12

    手机优先

    在手机上使用全部功能,还能把你做的东西安装成应用。

    对 AI 这样说
    让这个仪表盘可以安装到我的手机上。

    docs / vision / embeddability

  • x13

    搭建你自己的 OS

    用纯 HTML 搭建你自己的网页桌面或完整工作流。

    对 AI 这样说
    给我做一个主屏幕,放上我的终端、笔记和网站。
  • x35

    终端中的 Hub

    在交互式终端中全屏打开你账号的 Hub。

    对 AI 这样说
    在终端中打开我的 Hub。

    须知独立的终端版 Hub 支持 Linux x64 和 arm64,可在电脑内使用,也可通过托管 CLI 使用。npm 版本需要 Node.js 26 或更高版本。

    docs / foundation / cli

  • x36

    试用示例账号

    用示例账号体验终端版 Hub,无需登录。

    对 AI 这样说
    打开 Hub 的示例账号。

    须知终端版 Hub 需要交互式终端。

    docs / foundation / cli

你的 AI,你的方案 6

  • x14

    你的 ChatGPT 或 Claude 方案

    使用 ChatGPT 方案,或通过 Claude Code 使用 Claude 方案,也可以用免费的内置 AI。

    对 AI 这样说
    用我的 ChatGPT 方案登录。

    须知Claude 方案通过电脑上的 Claude Code 使用,用 Claude Code 自己的账号登录。适用于新的 Hub 对话,不适用于 Bot。

    docs / kit / agent

  • x15

    Hoody AI(免费)

    免费的内置 AI,不需要 API Key,也无需设置,在你的电脑内直接使用。

    对 AI 这样说
    先用免费模型。

    须知限额按服务器计算,由该服务器上的所有电脑共享。

    docs / foundation / hoody-ai / models

  • x16

    换 AI,一切照旧

    随时更换 AI;文件、项目、记忆和任务都会保留。

    对 AI 这样说
    把我的工作转到新的 AI 上。
  • x17

    可免费开始

    免费开始:一台免费服务器,最多 3 台持续运行的电脑,不会过期。

    对 AI 这样说
    帮我开通 Free 方案。

    须知每个符合条件的账号可获得一台免费服务器,免费容量用完即止。

    docs / foundation / pricing

  • x18

    收益明显时再升级

    需要更多空间时,添加 Plus 或 Pro 方案的服务器,或租用整台 Bare metal 服务器。

    对 AI 这样说
    为这个项目租一台配置更高的服务器。

    须知免费服务器不能原地升级。付费服务器每月 10 美元起。

    docs / foundation / pricing

  • x19

    按你的方式付款

    用银行卡或加密货币付款,并按角色与团队共享服务器。

    对 AI 这样说
    用加密货币给我的余额充值。

    docs / foundation / billing

服务器和方案 9

  • x37

    按地域查找服务器

    租用前,按位置、配置和价格筛选可用的服务器。

    对 AI 这样说
    找一台离我的欧洲用户近的服务器。

    须知起租 1 天;价格因商品和租期而异。

    docs / foundation / servers

  • x38

    查看在售方案

    列出在售的付费服务器方案,以及各自的短链接和 Bot URL 上限。

    链接https://api.hoody.com/api/v1/subserver-plans

    对 AI 这样说
    显示在售的付费服务器方案。

    须知购买报价会说明该方案此刻能否购买。

    docs / foundation / pricing

  • x39

    把 Plus 升级到 Pro

    把 Plus 服务器升级到 Pro,保留其 ID 和数据。

    对 AI 这样说
    把我的 Plus 服务器升级到 Pro。

    须知升级会按当前周期剩余时间收取差价。运行中的电脑会重启,已停止的电脑保持停止。

    docs / foundation / pricing

  • x40

    查询服务器方案报价

    购买前,查看付费服务器方案的当前价格和可用容量。

    链接https://api.hoody.com/api/v1/subserver-subscriptions/quote

    对 AI 这样说
    查询 Plus 服务器方案的当前价格。

    docs / api / servers

  • x41

    检查免费服务器资格

    检查你的账号能否领取免费服务器,以及不能领取的原因。

    链接https://api.hoody.com/api/v1/users/me/free-tier-status

    对 AI 这样说
    我的账号能领取免费服务器吗?

    须知该端点只报告状态,不会认领服务器。认证令牌需要 resources.read_account 权限。

    docs / api / users

  • x42

    服务器续费设置

    开启或关闭付费服务器的自动续费。

    链接https://api.hoody.com/api/v1/subserver-subscriptions/{id}/auto-renew

    对 AI 这样说
    关闭这台服务器的自动续费。

    须知只有账号所有者或认证令牌可以开启。关闭后,服务器会在已付费周期结束时停止。

    docs / api / servers

  • x43

    延长服务器租用期限

    用 API 给现有的服务器租用增加天数。

    链接https://api.hoody.com/api/v1/rentals/{id}/extend

    对 AI 这样说
    把我的服务器租用期限延长 30 天。

    须知追加天数为 1 至 3,650,且必须与服务器定价一致。

    docs / api / servers

  • x44

    预订一台在售服务器

    预订缺货的机器,到货后交付,并设置扣费上限。

    链接https://api.hoody.com/api/v1/offers/{id}/reserve

    对 AI 这样说
    把这个服务器报价预留 30 天。

    须知预订会立即扣费。付费预订需要提供扣费上限和幂等键。

    docs / api / servers

  • x45

    Bare metal 服务器命令

    用 API 查看已租用的 Bare metal 服务器的运行时间或内存,或重启它。

    链接https://api.hoody.com/api/v1/servers/{serverId}/execute-command

    对 AI 这样说
    查看我的 Bare metal 服务器的运行时间。

    须知仅限内置命令,且需在租期有效的专用 Bare metal 服务器上使用。

    docs / api / server-management

你的账号 12

  • x20

    双重验证登录

    用验证器应用和备份码保护你的账号。

    对 AI 这样说
    为我的账号开启双重验证登录。

    docs / api / authentication

  • x21

    赚取推荐额度

    分享你的推荐链接,你邀请的人付费后,你会获得可用于服务器的额度。

    对 AI 这样说
    把我的 Hoody 推荐链接给我。

    须知用银行卡或加密货币支付服务器费用后开放。额度在 60 天的保留期后到账,每位客户 12 个月,只能用于支付服务器费用。

    docs / foundation / wallet / referral-program

  • x22

    支持工单

    在 CLI 或 API 中提交支持工单,并跟进回复。

    链接https://api.hoody.com/api/v1/support/tickets

    对 AI 这样说
    提交一个支持工单,说明我的电脑无法启动。

    docs / foundation / support

  • x46

    结束一个登录会话

    让一台忘记退出的设备退出登录,同时保留你的其他会话。

    链接https://api.hoody.com/api/v1/users/auth/sessions/{id}

    对 AI 这样说
    退出我旧笔记本电脑上的会话。

    须知只有你自己已登录的会话可以调用。结束会话不会删除会话期间创建的令牌。

    docs / api / authentication

  • x47

    退出其他设备

    结束账号的其他所有会话,保留当前登录。

    链接https://api.hoody.com/api/v1/users/auth/sessions/revoke-others

    对 AI 这样说
    退出我的所有其他设备。

    须知只有你自己已登录的会话可以调用。结束会话不会删除这些会话期间创建的令牌。

    docs / api / authentication

  • x48

    更换备份码

    如果旧的两步验证备份码已泄露,生成一组新的。

    链接https://api.hoody.com/api/v1/users/auth/2fa/backup-codes/regenerate

    对 AI 这样说
    为我的账号生成新的两步验证备份码。

    须知需要你的密码和当前 OTP 验证码。现有备份码会失效。

    docs / api / authentication

  • x49

    查看被拒绝的登录

    查看账号安全历史时,包含失败的登录尝试。

    链接https://api.hoody.com/api/v1/users/me/security-history?include_failed=true

    对 AI 这样说
    显示我账号上被拒绝的登录尝试。

    须知API 令牌需要 resources.read_account。账号审计记录保留 180 天。

    docs / concepts / auditing

  • x50

    更改账号邮箱

    申请新的账号邮箱,并在新地址中确认。

    链接https://api.hoody.com/api/v1/users/me/email-change

    对 AI 这样说
    更改我账号的邮箱地址。

    须知需要你自己已登录的会话和当前密码;如已启用两步验证,还需要验证码。确认链接 24 小时内有效。

    docs / api / users

  • x51

    客户支持回复提醒

    客户支持回复你的工单时,收到应用内通知。

    对 AI 这样说
    客户支持回复时通知我。

    须知同一工单的多条回复可以合并为一条通知,每个工单每 10 分钟最多一条。通知中不会标明是哪个工单。

    docs / foundation / support

  • x52

    自定义推荐码

    为你邀请来 Hoody 的人创建一个好记的推荐码。

    链接https://api.hoody.com/api/v1/referrals/me/codes

    对 AI 这样说
    创建一个名为 alex-builds 的推荐码。

    须知同一时间最多可有 3 个有效的自定义邀请码,账号累计最多 10 个。创建邀请码需要已登录的会话和推荐计划成员资格。

    docs / foundation / wallet / referral-program

  • x53

    跟踪推荐收益

    查看你的推荐码、等级、数量和额度总计。

    链接https://api.hoody.com/api/v1/referrals/me

    对 AI 这样说
    显示我的推荐等级和额度总计。

    须知不显示被推荐人的姓名和账号详情。认证令牌需要 financial.wallet.read,且不能受领域限制。

    docs / foundation / wallet / referral-program

  • x54

    提取推荐额度

    达到 Creator 等级后,可通过客户支持把可用的推荐额度提取为现金。

    对 AI 这样说
    向客户支持咨询提取我的推荐额度。

    须知默认关闭,客户支持会核实每个请求。部分情况下通过银行转账或加密货币;冻结中的余额不能提现。

    docs / foundation / wallet / referral-program

余额和发票 4

  • x55

    查看所有余额

    一次调用查看你的通用余额、推荐额度和 AI 余额。

    链接https://api.hoody.com/api/v1/wallet/balances

    对 AI 这样说
    显示我所有的 Hoody 余额。

    须知使用已登录的会话,或拥有对应权限的账号级认证令牌。受领域限制的令牌不能读取余额。

    docs / foundation / billing

  • x56

    查看钱包交易

    在一份交易记录里查看你的付款、扣费、转账和退款。

    链接https://api.hoody.com/api/v1/wallet/transactions

    对 AI 这样说
    显示我最近的 Hoody 扣费和退款。

    须知使用已登录的会话,或拥有对应权限的账号级认证令牌。受领域限制的令牌不能读取交易记录。

    docs / foundation / billing

  • x57

    下载发票 PDF

    把发票下载为 PDF,用于记账、报税或向客户结算。

    链接https://api.hoody.com/api/v1/wallet/invoices/{id}/pdf

    对 AI 这样说
    下载我最新发票的 PDF。

    须知使用已登录的会话,或拥有对应权限的账号级认证令牌。受领域限制的令牌不能读取发票。

    docs / foundation / billing

  • x58

    查询付款

    按 intent ID 查询银行卡或加密货币付款。

    对 AI 这样说
    查看我的加密货币充值是否已到账。

    须知查询支付记录需要已登录的会话。不接受认证令牌。

    docs / foundation / billing

始于 2021年

从隐私到智能体基础设施

hoody / kit

你的电脑自带什么

每个服务都有自己的链接。可以打开它、分享它,或交给你的 AI。拿到链接的人都可以打开,直到你锁定。Kit 链接的格式是 https://{p}-{c}-<kit>-1.{node}.computers.hoody.com:{p} 是你的项目,{c} 是某一台电脑,{node} 是它的服务器。

电脑

Bots

API