Chuyển tới nội dung chính

{/* Trang này được tạo tự động từ SKILL.md của kỹ năng bởi website/scripts/generate-skill-docs.py. Chỉnh sửa nguồn SKILL.md, không phải trang này. */}

Ở đây.Bây giờ

Xuất bản các trang web tĩnh lên {slug}.here.now và lưu trữ các tệp riêng tư trong Ổ đĩa đám mây để chuyển giao giữa các đại lý.

Siêu dữ liệu kỹ năng​

NguồnTùy chọn — cài đặt với
`Hermes skills install official/productivity/here-now
`
Đường dẫn

optional-skills/productivity/here-now ` | | Phiên bản |

1.15.3 ` | | Tác giả | ở đây.bây giờ | | Giấy phép | MIT | | Nền tảng | macOS, Linux | | Thẻ |

here.now

, `herenow

, `publish

, `deploy

, `hosting

, `static-site

, `web

, `share

, `URL

, `drive

, storage |

Tham khảo: đầy đủ SKILL.md​

thông tin

Sau đây là định nghĩa kỹ năng đầy đủ mà Hermes tải khi kỹ năng này được kích hoạt. Đây là những gì tác nhân coi là hướng dẫn khi kỹ năng được kích hoạt.

ở đây bây giờ`here.now cho phép các đại lý xuất bản trang web và lưu trữ các tệp riêng tư trong Ổ đĩa đám mây.

Sử dụng here.now cho hai công việc:

  • Trang web: xuất bản trang web và tệp tại

{slug}.here.now

.

  • Ổ đĩa: lưu trữ các tệp tác nhân riêng trong các thư mục đám mây.

Tài liệu hiện tại**Trước khi trả lời các câu hỏi về khả năng, tính năng hoặc quy trình làm việc của here.now, hãy đọc tài liệu hiện tại:**→ https://here.now/docs​

Đọc tài liệu:

  • ở lần tương tác đầu tiên liên quan đến here.now trong một cuộc trò chuyện
  • bất cứ khi nào người dùng hỏi cách làm điều gì đó
  • bất cứ khi nào người dùng hỏi những gì có thể, được hỗ trợ hoặc được đề xuất
  • trước khi thông báo cho người dùng một tính năng không được hỗ trợ

Các chủ đề yêu cầu tài liệu hiện tại (không chỉ dựa vào văn bản kỹ năng địa phương):

  • Ổ đĩa và chia sẻ Drive
  • tên miền tùy chỉnh
  • thanh toán và cổng thanh toán
  • rèn
  • các tuyến proxy và các biến dịch vụ
  • tay cầm và liên kết
  • giới hạn và hạn ngạch
  • Định tuyến SPA
  • xử lý và khắc phục lỗi
  • tính năng sẵn có`Nếu tài liệu và hành vi của API trực tiếp không đồng ý, hãy tin tưởng vào hành vi của API trực tiếp.

Nếu quá trình tìm nạp tài liệu không thành công hoặc hết thời gian, hãy tiếp tục với kỹ năng cục bộ và đầu ra API/tập lệnh trực tiếp. Ưu tiên hành vi API trực tiếp cho các hoạt động đang hoạt động.

Yêu cầu​

  • Các tệp nhị phân bắt buộc: `curl

, `file

, `jq

  • Biến môi trường tùy chọn:

$HERENOW_API_KEY

  • Biến mã thông báo Drive tùy chọn:

$HERENOW_DRIVE_TOKEN

  • Tệp thông tin xác thực tùy chọn:

~/.herenow/credentials

  • Đường dẫn trợ giúp kỹ năng:​

${Hermes_SKILL_DIR}/scripts/publish.sh ` dành cho các trang xuất bản​

${Hermes_SKILL_DIR}/scripts/drive.sh ` để lưu trữ Drive riêng

Tạo một trang web​

PUBLISH="$\{Hermes_SKILL_DIR}/scripts/publish.sh"
bash "$PUBLISH" \{file-or-dir} --CLIent Hermes

`
``Xuất URL trực tiếp (ví dụ: 
`https://bright-canvas-a7k2.here.now/

).

Dưới đây là quy trình gồm ba bước: tạo/cập nhật -> tải tệp lên -> hoàn thiện. Một trang web không tồn tại cho đến khi hoàn thiện thành công.

Nếu không có khóa API, điều này sẽ tạo ra một **trang web ẩn danh** hết hạn sau 24 giờ.
Với khóa API đã lưu, trang web sẽ tồn tại vĩnh viễn.

**Cấu trúc tệp:** Đối với các trang web HTML, đặt 
`index.html
` ở thư mục gốc của thư mục bạn xuất bản, không phải bên trong thư mục con. Nội dung của thư mục trở thành thư mục gốc của trang web. Ví dụ: xuất bản 
`my-site/
` nơi 
`my-site/index.html
` tồn tại — không xuất bản thư mục mẹ chứa 
`my-site/

.

Bạn cũng có thể xuất bản các tệp thô mà không cần bất kỳ HTML nào. Các tệp đơn lẻ có được trình xem tự động phong phú (hình ảnh, PDF, video, âm thanh). Nhiều tệp có danh sách thư mục được tạo tự động với điều hướng thư mục và thư viện hình ảnh.

## Cập nhật trang web hiện có

`bash
PUBLISH="$\{Hermes_SKILL_DIR}/scripts/publish.sh"
bash "$PUBLISH" \{file-or-dir} --slug \{slug} --CLIent Hermes

`
``Tập lệnh tự động tải 
`claimToken
` từ 

.herenow/state.JSON
` khi cập nhật các trang web ẩn danh. Vượt qua 

`
--claim-token \{token}
` để ghi đè.

Các bản cập nhật được xác thực yêu cầu khóa API đã lưu.

## Sử dụng Ổ đĩa

Sử dụng Drive khi người dùng muốn bộ nhớ đám mây riêng cho các tệp tác nhân: tài liệu, ngữ cảnh, bộ nhớ, kế hoạch, tài sản, phương tiện, nghiên cứu, mã và bất kỳ thứ gì khác cần tồn tại mà không được xuất bản dưới dạng trang web.

Mọi tài khoản đã đăng nhập đều có Drive mặc định có tên 
`My Drive

.

``` bash
DRIVE="$\{Hermes_SKILL_DIR}/scripts/drive.sh"
bash "$DRIVE" default
bash "$DRIVE" ls "My Drive"
bash "$DRIVE" put "My Drive" notes/today.md --from ./notes/today.md
bash "$DRIVE" cat "My Drive" notes/today.md
bash "$DRIVE" share "My Drive" --perms write --prefix notes/ --ttl 7d

`
``Sử dụng mã thông báo Drive có phạm vi để chuyển giao giữa các đại lý. Nếu bạn nhận được khối chia sẻ 
`herenow_drive

, hãy sử dụng 
`token
` của nó làm 
`Authorization: Bearer <token
` chống lại 
`API_base

, tôn trọng 
`pathPrefix
` khi xuất hiện và duy trì các thẻ ETag khi ghi. 
`pathPrefix
` của 
`null
` có nghĩa là truy cập toàn bộ Drive. Nếu có kỹ năng, hãy ưu tiên 
`drive.sh

; nếu không hãy gọi trực tiếp các hoạt động API được liệt kê.

## Lưu trữ khóa APITập lệnh xuất bản đọc khóa API từ các nguồn này (trận đầu tiên thắng):
1. Cờ 

`
--API-key \{key}
` (chỉ CI/tập lệnh - tránh sử dụng tương tác)
2. Biến môi trường 

$HERENOW_API_KEY

3. Tệp 

~/.herenow/credentials
` (được khuyến nghị cho đại lý)

Để lưu trữ khóa, hãy ghi nó vào tệp thông tin xác thực:

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

`
``**QUAN TRỌNG**: Sau khi nhận được khóa API, hãy lưu nó ngay lập tức — hãy tự chạy lệnh ở trên. Đừng yêu cầu người dùng chạy nó theo cách thủ công. Tránh chuyển khóa qua cờ CLI (ví dụ: 

`
--API-key

) trong các phiên tương tác; tệp thông tin xác thực là phương thức lưu trữ ưa thích.

Không bao giờ cam kết thông tin xác thực hoặc tệp trạng thái cục bộ (

~/.herenow/credentials

, 

.herenow/state.JSON

) cho kiểm soát nguồn.

## Lấy khóa API

Để nâng cấp từ trang ẩn danh (24h) lên trang cố định:
1. Hỏi người dùng địa chỉ email của họ.
2. Yêu cầu mã đăng nhập một lần:

``` bash
curl -sS https://here.now/API/auth/agent/request-code \

  -H "content-type: application/JSON" \
  -d '\{"email": "user@example.com"}'

`

3. Nói với người dùng: "Kiểm tra hộp thư đến của bạn để tìm mã đăng nhập từ đây.now và dán mã vào đây."
4. Xác minh mã và lấy khóa API:

``` bash
curl -sS https://here.now/API/auth/agent/verify-code \

  -H "content-type: application/JSON" \
  -d '\{"email":"user@example.com","code":"ABCD-2345"}'

`

5. Hãy tự lưu 
`APIKey
` được trả về (không yêu cầu người dùng thực hiện việc này):

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

`

## Tệp trạng thái

Sau mỗi lần tạo/cập nhật trang web, tập lệnh sẽ ghi vào 

.herenow/state.JSON
` trong thư mục làm việc:

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

`
``Trước khi tạo hoặc cập nhật trang web, bạn có thể kiểm tra tệp này để tìm các phần mở rộng trước đó.
Chỉ coi 

.herenow/state.JSON
` là bộ đệm trong.
Không bao giờ hiển thị đường dẫn tệp cục bộ này dưới dạng URL và không bao giờ sử dụng nó làm nguồn thông tin chính xác cho chế độ xác thực, thời hạn sử dụng hoặc URL xác nhận quyền sở hữu.

## Điều cần nói với người dùng

Đối với các trang web đã xuất bản:
- Luôn chia sẻ 
`siteUrl
` từ lần chạy tập lệnh hiện tại.

- Đọc và làm theo các dòng 
`publish_result.*
` từ script stderr để xác định chế độ xác thực.
- Khi 
`publish_result.auth_mode=authenticated

: cho người dùng biết trang web **vĩnh viễn** và được lưu vào tài khoản của họ. Không cần URL xác nhận quyền sở hữu.
- Khi 
`publish_result.auth_mode=anonymous

: thông báo cho người dùng trang web **hết hạn sau 24 giờ**. Chia sẻ URL xác nhận quyền sở hữu (nếu 
`publish_result.claim_url
` không trống và bắt đầu bằng 
`https://

) để họ có thể giữ URL đó vĩnh viễn. Cảnh báo rằng mã thông báo xác nhận quyền sở hữu chỉ được trả lại một lần và không thể khôi phục được.
- Không bao giờ yêu cầu người dùng kiểm tra 

.herenow/state.JSON
` để biết URL xác nhận quyền sở hữu hoặc trạng thái xác thực.

Đối với ổ đĩa:
- Không mô tả tệp Drive là URL công khai.
- Cho người dùng biết nội dung Drive là riêng tư trừ khi được chia sẻ bằng mã thông báo có phạm vi.
- Khi chia sẻ quyền truy cập với một đại lý khác, hãy ưu tiên mã thông báo có phạm vi có 
`pathPrefix
` hẹp và TTL ngắn.

## tùy chọn xuất bản.sh

| Cờ | Mô tả |
| ---------------------- | -------------------------------------------- |
| 

--slug \{slug}
` | Cập nhật trang web hiện có thay vì tạo |
| 

--claim-token \{token}

| Ghi đè mã thông báo xác nhận quyền sở hữu đối với các cập nhật ẩn danh |
| 

--title \{text}
` | Tiêu đề của người xem (trang web không phải HTML) |
| 

--description \{text}
` | Mô tả của người xem |
| 

--ttl \{seconds}
` | Đặt thời hạn (chỉ được xác thực) |
| 

--CLIent \{name}
` | Tên đại lý để phân bổ (ví dụ: 
`Hermes

) |
| 

--base-url \{url}
` | URL cơ sở API (mặc định: 
`https://here.now

) |
| 

--allow-nonherenow-base-url
` | Cho phép gửi xác thực tới 

--base-url
` không mặc định |
| 

--API-key \{key}
` | Ghi đè khóa API (ưu tiên tệp thông tin xác thực) |
| 

--spa
` | Bật định tuyến SPA (phục vụ index.html cho các đường dẫn không xác định) |
| 

--forkable
` | Cho phép người khác phân nhánh trang web này |

## Ngoài xuất bản.sh

Đối với các hoạt động của Drive, hãy sử dụng 
`drive.sh
` hoặc API Drive. Để quản lý trang web và tài khoản rộng hơn — xóa, siêu dữ liệu, mật khẩu, thanh toán, tên miền, tên miền, liên kết, biến, tuyến proxy, phân nhánh, sao chép, v.v. — hãy xem tài liệu hiện tại:`→ **https://here.now/docs**

Tài liệu đầy đủ: https://here.now/docs