here-now

name	here-now
description	`here.now` 允许代理在云驱动器中发布网站并存储私有文件。通过 `Sites` 功能，可以将 HTML、文档、图片、PDF、视频和静态文件发布到 `{slug}.here.now` 或自定义域名下的实时 URL。`Drives` 则作为私有云文件夹，代理可以在此存储文件（包括文档、计划、资产、媒体、代码等），并与其他代理共享这些文件，确保数据在会话和工具之间保持同步。当需要执行以下操作时，可以使用 `here.now`：发布内容、托管文件、在网页上共享内容、创建网站、将文件上传到云端、生成 URL、构建聊天机器人、将文件保存到自己的云驱动器中、稍后使用这些文件、将文件写入云存储、与其他代理共享文件夹，或使用自己的 `here.now` 云驱动器。

here.now

技能版本：1.15.3

here.now 允许代理在云驱动器中发布网站并存储私有文件。

您可以使用 here.now 完成以下两项任务：

• 发布网站：将网站和文件发布到 {slug}.here.now。
• 存储文件：将代理的私有文件存储在云驱动器中。

安装或更新（推荐使用）： npx skills add heredotnow/skill --skill here-now -g

对于通过仓库链接或本地安装的情况，请省略 -g 参数。

当前文档

在回答关于 here.now 的功能、特性或工作流程的问题之前，请先阅读当前文档：

→ https://here.now/docs

以下情况下请阅读文档：

• 在首次使用 here.now 时
• 当用户询问如何操作时
• 当用户询问某些功能是否可用或被支持时
• 在告知用户某个功能不受支持之前

需要查阅当前文档的主题（不要仅依赖本地文档）：

• 驱动器及驱动器共享
• 自定义域名
• 支付与支付权限控制
• 分支功能
• 代理路由与服务变量
• 文件处理与链接
• 限制与配额
• 单页应用（SPA）路由
• 错误处理与修复
• 功能可用性

如果文档内容与实时 API 行为不一致，请以实时 API 行为为准。

如果文档加载失败或超时，请继续使用本地技能及实时 API/脚本输出。在操作过程中，优先参考实时 API 的行为。

必需条件

• 必需的二进制文件：curl、file、jq
• 可选环境变量：$HERENOW_API_KEY
• 可选驱动器令牌变量：$HERENOW_DRIVE_TOKEN
• 可选凭据文件：~/.herenow/credentials
• 配置的辅助脚本：
  • ./scripts/publish.sh 用于发布网站
  • ./scripts/drive.sh 用于私有文件存储

创建网站

./scripts/publish.sh {file-or-dir}

脚本会输出网站的实时 URL（例如：https://bright-canvas-a7k2.here.now/）。

内部实现分为三个步骤：创建/更新 → 上传文件 → 完成发布。只有当更新操作成功完成，网站才会正式上线。

如果没有 API 密钥，创建的网站为匿名网站，有效期为 24 小时；使用保存的 API 密钥后，网站将永久保存。

文件结构：对于 HTML 网站，请将 index.html 文件放在发布的目录根目录下，不要放在子目录中。目录的所有内容将成为网站的根目录。例如，如果 my-site/index.html 存在，则发布 my-site/；不要发布包含 my-site/ 的父目录。

您也可以直接发布原始文件（无需 HTML 格式）。单个文件会自动生成丰富的查看器（支持图片、PDF、视频、音频格式）；多个文件会生成包含文件夹导航和图片库的目录列表。

更新现有网站

./scripts/publish.sh {file-or-dir} --slug {slug}

在更新匿名网站时，脚本会自动从 .herenow/state.json 文件中加载 claimToken。您可以通过 --claim-token {token} 参数覆盖该令牌。

进行身份验证后的更新需要使用保存的 API 密钥。

使用驱动器

当用户需要为代理文件（如文档、上下文数据、计划、资产、媒体、代码等）提供私有云存储空间时，可以使用驱动器。每个登录账户都有一个名为 My Drive 的默认驱动器。

./scripts/drive.sh default
./scripts/drive.sh ls My Drive
./scripts/drive.sh put My Drive notes/today.md --from ./notes/today.md
./scripts/drive.sh cat My Drive notes/today.md
./scripts/drive.sh share My Drive --perms write --prefix notes/ --ttl 7d

在代理之间传递文件时，请使用带有权限范围的驱动器令牌。如果您收到 herenow_drive 共享信息，请使用其 token，并在请求 API 时设置 Authorization: Bearer <token>。如果存在 pathPrefix，请确保将其包含在请求中；写入文件时请保留 ETags。pathPrefix 为 null 表示全驱动器访问权限。如果支持该功能，建议使用 ./scripts/drive.sh；否则请直接调用相应的 API 操作。

客户端标识

使用 --client 参数，以便 here.now 能够追踪每个代理的使用情况：

./scripts/publish.sh {file-or-dir} --client cursor

在调用发布 API 时，该参数会发送 X-HereNow-Client: cursor/publish-sh 标头。如果省略此参数，脚本会使用默认值。

API 密钥的存储

发布脚本从以下来源读取 API 密钥（优先选择第一个匹配的来源）：

1. --api-key {key} 参数（仅用于持续集成/脚本环境，避免在交互式使用中使用）
2. $HERENOW_API_KEY 环境变量
3. ~/.herenow/credentials 文件（推荐使用）

要保存 API 密钥，请将其写入凭据文件：

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

重要提示：收到 API 密钥后，请立即保存它——请自行执行上述命令。切勿让用户手动操作。在交互式会话中，不要通过命令行参数（如 --api-key）传递密钥；建议使用凭据文件进行存储。

切勿将凭据文件或本地状态文件（~/.herenow/credentials、.herenow/state.json）提交到版本控制系统中。

获取 API 密钥

要将匿名网站升级为永久网站，请按照以下步骤操作：

1. 向用户索取他们的电子邮件地址。
2. 向用户请求一次性登录代码：

curl -sS https://here.now/api/auth/agent/request-code \
  -H "content-type: application/json" \
  -d '{"email": "[e-mail]"}'

3. 告诉用户：“请查看您的收件箱，查找来自 here.now 的登录代码，并将其粘贴到这里。”
4. 验证代码并获取 API 密钥：

curl -sS https://here.now/api/auth/agent/verify-code \
  -H "content-type: application/json" \
  -d '{"email":"[e-mail]","code":"ABCD-2345"}'

5. 请自行保存返回的 apiKey（不要让用户执行此操作）：

mkdir -p ~/.herenow && echo "{API_KEY}" > ~/.herenow/credentials && chmod 600 ~/.herenow/credentials

状态文件

每次创建或更新网站后，脚本会向工作目录下的 .herenow/state.json 文件写入相关信息：

{
  "publishes": {
    "bright-canvas-a7k2": {
      "siteUrl": "https://bright-canvas-a7k2.here.now/",
      "claimToken": "abc123",
      "claimUrl": "https://here.now/claim?slug=bright-canvas-a7k2&token=abc123",
      "expiresAt": "2026-02-18T01:00:00.000Z"
    }
  }
}

在创建或更新网站之前，您可以查看该文件以获取之前的站点地址。请将 .herenow/state.json 视为内部缓存文件，切勿将其作为 URL 或身份验证、过期时间或共享链接的依据。

如何告知用户

对于已发布的网站：

• 始终提供当前脚本运行生成的 siteUrl。
• 阅读脚本标准输出（stderr）中的 publish_result.* 行以确定身份验证模式。
• 当 publish_result.auth_mode=authenticated 时，告知用户网站是永久保存的，并已保存在用户的账户中（无需提供共享链接）。
• 当 publish_result.auth_mode=anonymous 时，告知用户网站将在 24 小时后过期，并提供共享链接（如果 publish_result.claim_url 不为空且以 https:// 开头），以便用户可以永久保存该链接。请注意，共享令牌仅提供一次，无法重新获取。
• 切勿 告诉用户通过查看 .herenow/state.json 来获取共享链接或身份验证状态。

对于驱动器：

• 不要将驱动器文件作为公共 URL 提供给用户。
• 告诉用户，除非使用带有权限范围的令牌，否则驱动器内容是私有的。
• 在与其他代理共享访问权限时，建议使用具有特定 pathPrefix 和较短有效期的令牌。

publish.sh 的选项

参数	说明
--slug {slug}	更新现有网站而非创建新网站
--claim-token {token}	为匿名更新覆盖共享令牌
--title {text}	查看器标题（非 HTML 网站适用）
--description {text}	查看器描述
--ttl {seconds}	设置过期时间（仅限身份验证用户）
--client {name}	用于标识代理的名称（例如：cursor）
--base-url {url}	API 基础 URL（默认：https://here.now）
--allow-nonherenow-base-url	允许将身份验证信息发送到非默认的 --base-url
--api-key {key}	API 密钥（建议使用凭据文件）
--spa	启用单页应用路由（未知路径时返回 index.html）
--forkable	允许其他代理复制当前网站

更详细的操作说明

有关驱动器操作的更多信息，请使用 ./scripts/drive.sh 或直接调用 Drive API。关于账户和网站管理的更多内容（如删除、元数据管理、密码设置、域名配置、文件链接、变量管理、代理路由、分支功能等），请参阅当前文档：

→ https://here.now/docs

完整文档：https://here.now/docs