hono

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Hono Skill

Develop Hono applications efficiently using Hono CLI (

@hono/cli

使用Hono CLI（

@hono/cli

）高效开发Hono应用。

Setup

安装设置

You can use Hono CLI without global installation via npx:

bash

npx @hono/cli <command>

Or install globally (optional):

bash

npm install -g @hono/cli

你可以通过npx无需全局安装即可使用Hono CLI：

bash

npx @hono/cli <command>

或者全局安装（可选）：

bash

npm install -g @hono/cli

Commands for AI

面向AI的命令

1. Search Documentation

1. 搜索文档

bash

hono search "<query>" --pretty

Search for Hono APIs and features. Use

--pretty

for human-readable output.

bash

hono search "<query>" --pretty

搜索Hono的API和功能。使用

--pretty

参数可获得人类易读的输出格式。

2. View Documentation

2. 查看文档

bash

hono docs [path]

Display detailed documentation for a specific path found in search results.

Examples:

bash

hono docs /docs/api/context
hono docs /docs/api/hono
hono docs /docs/helpers/factory

bash

hono docs [path]

显示搜索结果中特定路径的详细文档。

示例：

bash

hono docs /docs/api/context
hono docs /docs/api/hono
hono docs /docs/helpers/factory

3. Request Testing

3. 请求测试

bash

undefined

bash

undefined

GET request

GET 请求

hono request [file] -P /path

POST request

POST 请求

hono request [file] -X POST -P /api/users -d '{"name": "test"}'

Request with headers

带请求头的请求

hono request [file] -H "Authorization: Bearer token" -P /api/protected


Uses `app.request()` internally, so no server startup required for testing.

hono request [file] -H "Authorization: Bearer token" -P /api/protected


内部使用`app.request()`，因此测试无需启动服务器。

4. Optimization & Bundling

4. 优化与打包

bash

undefined

bash

undefined

Bundle optimization

打包优化

hono optimize [entry] -o dist/index.js

With minification

启用压缩

hono optimize [entry] -o dist/index.js --minify

Specify target (cloudflare-workers, deno, etc.)

指定目标环境（cloudflare-workers、deno等）

hono optimize [entry] -t cloudflare-workers

undefined

hono optimize [entry] -t cloudflare-workers

undefined

Development Workflow

开发工作流

Research: Use
```
hono search
```
→
```
hono docs
```
to investigate APIs and features
Implement: Write the code
Test: Use
```
hono request
```
to test endpoints
Optimize: Use
```
hono optimize
```
for production builds when needed

调研：使用
```
hono search
```
→
```
hono docs
```
来研究API和功能
实现：编写代码
测试：使用
```
hono request
```
测试端点
优化：必要时使用
```
hono optimize
```
进行生产构建

Guidelines

指南

Always search with
```
hono search
```
before implementing unfamiliar APIs
Use
```
--pretty
```
flag with
```
hono search
```
(default output is JSON)
```
hono request
```
works without starting an HTTP server
Search for middleware usage with
```
hono search "middleware name"
```

在实现不熟悉的API前，务必使用
```
hono search
```
进行搜索
使用
```
hono search
```
时加上
```
--pretty
```
参数（默认输出为JSON格式）
```
hono request
```
无需启动HTTP服务器即可运行
使用
```
hono search "middleware name"
```
搜索中间件的用法