here-now

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

here.now

Skill version: 1.2

Publish any file or folder to the web and get a live URL back. Static hosting only.

技能版本：1.2

可将任意文件或文件夹发布至网页，并获取一个在线URL。仅支持静态托管。

Check for updates

检查更新

On first use in a session, check if a newer skill version is available:

bash

curl -s https://here.now/api/skill/version

If the returned

version

is higher than 1.2, fetch the latest skill before proceeding:

bash

curl -s https://here.now/skill.md

Let the user know you're updating to the latest version, then continue with their request.

在会话首次使用时，检查是否有更新的技能版本可用：

bash

curl -s https://here.now/api/skill/version

如果返回的

version

高于1.2，请先获取最新技能再继续操作：

bash

curl -s https://here.now/skill.md

告知用户你正在更新至最新版本，然后继续处理他们的请求。

Publish

发布内容

bash

./scripts/publish.sh <file-or-dir>

Outputs the live URL (e.g.

https://bright-canvas-a7k2.here.now/

Without an API key this creates an anonymous publish that expires in 24 hours. With

--api-key

$HERENOW_API_KEY

, the publish is permanent.

bash

./scripts/publish.sh <file-or-dir>

输出在线URL（例如

https://bright-canvas-a7k2.here.now/

）。

未使用API密钥时，将创建匿名发布，该发布24小时后过期。使用

--api-key

或设置环境变量

$HERENOW_API_KEY

时，发布内容将永久保留。

Update an existing publish

更新现有发布内容

bash

./scripts/publish.sh <file-or-dir> --slug <slug>

The script auto-loads the

claimToken

from

.herenow/state.json

when updating anonymous publishes. Pass

--claim-token <token>

to override.

Authenticated updates require

--api-key

$HERENOW_API_KEY

bash

./scripts/publish.sh <file-or-dir> --slug <slug>

更新匿名发布内容时，脚本会自动从

.herenow/state.json

加载

claimToken

。可传入

--claim-token <token>

来覆盖该值。

认证用户更新发布内容时需使用

--api-key

或设置环境变量

$HERENOW_API_KEY

。

State file

状态文件

After every publish, the script writes to

.herenow/state.json

in the working directory:

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"
    }
  }
}

Before publishing, check this file. If the user already has a publish for the same content, update it with

--slug

instead of creating a new one.

每次发布后，脚本会在工作目录下的

.herenow/state.json

中写入内容：

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"
    }
  }
}

发布前请检查该文件。如果用户已发布过相同内容，请使用

--slug

参数更新现有发布，而非创建新发布。

What to tell the user

需告知用户的信息

Always share the
```
siteUrl
```
.
For anonymous publishes, also share the
```
claimUrl
```
so they can keep it permanently.
Warn: the claim token is only returned once and cannot be recovered.

务必分享
```
siteUrl
```
。
对于匿名发布，还需分享
```
claimUrl
```
，以便用户将发布内容永久保留。
提醒用户：认领令牌仅返回一次，无法找回。

Limits

限制说明

	Anonymous	Authenticated
Max file size	250 MB	5 GB
Expiry	24 hours	Permanent (or custom TTL)
Rate limit	5 / hour / IP	Unlimited
Account needed	No	Yes (get key at here.now)

项目	匿名发布	认证发布
最大文件大小	250 MB	5 GB
有效期	24小时	永久（或自定义TTL）
请求频率限制	5次/小时/IP	无限制
是否需要账号	否	是（在here.now获取密钥）

Getting an API key

获取API密钥

To upgrade from anonymous (24h) to permanent publishing:

Ask the user for their email address.
Call the sign-up endpoint to send them a magic link:

bash

curl -sS https://here.now/api/auth/login \
  -H "content-type: application/json" \
  -d '{"email": "user@example.com"}'

Tell the user: "Check your inbox for a sign-in link from here.now. Click it, then copy your API key from the dashboard."
Once the user provides the key, pass it with
```
--api-key
```
or set
```
$HERENOW_API_KEY
```
.

如需从匿名发布（24小时有效期）升级为永久发布：

向用户索要邮箱地址。
调用注册接口为用户发送魔法链接：

bash

curl -sS https://here.now/api/auth/login \
  -H "content-type: application/json" \
  -d '{"email": "user@example.com"}'

告知用户：「请查收来自here.now的登录链接邮件。点击链接后，从控制面板复制你的API密钥。」
用户提供密钥后，可通过
```
--api-key
```
参数传入，或设置环境变量
```
$HERENOW_API_KEY
```
。

Script options

脚本选项

Flag	Description
`--api-key <key>`	API key (or set `$HERENOW_API_KEY` )
`--slug <slug>`	Update existing publish instead of creating
`--claim-token <token>`	Override claim token for anonymous updates
`--title <text>`	Viewer title (non-site publishes)
`--description <text>`	Viewer description
`--ttl <seconds>`	Set expiry (authenticated only)
`--base-url <url>`	API base URL (default: `https://here.now` )

标志位	说明
`--api-key <key>`	API密钥（或设置环境变量 `$HERENOW_API_KEY` ）
`--slug <slug>`	更新现有发布内容，而非创建新的发布
`--claim-token <token>`	覆盖匿名更新的认领令牌
`--title <text>`	查看器标题（非网站发布时使用）
`--description <text>`	查看器描述
`--ttl <seconds>`	设置有效期（仅认证用户可用）
`--base-url <url>`	API基础URL（默认值： `https://here.now` ）

Beyond the script

脚本之外的操作

For delete, metadata patch, claim, list, and other operations, see references/REFERENCE.md.

Full docs: https://here.now/docs

删除、元数据补丁、认领、列表及其他操作，请查看references/REFERENCE.md。

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