# @guren/cli 中文文档

规范地址：https://npmcn.com/package/%40guren/cli/

版本：2\.37\.0
npm 元数据更新时间：2026-11-16T14:14:42.585Z
中文译文更新时间：2026-11-17T03:48:52.146Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40guren/cli
原文对照：https://npmcn.com/package/%40guren/cli/?lang=original
项目主页：https://github.com/gurenjs/guren#readme
源码仓库：https://github.com/gurenjs/guren

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.5 MB，269 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：7 个
- peer 依赖：vite \>=7\.0\.0，oxlint ~1\.81\.0，@guren/openapi \>=1\.3\.0，@guren/plugin-ai \>=0\.2\.0
- 首次发布：2025-11-02T04:49:46.455Z
- 最新版本发布：2026-11-16T14:14:42.059Z
- 近 30 天下载量：11511（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：93（近 12 个月 85 个）

## 中文简介

古伦框架的CLI:脚手架(make:\*,添加),迁移,代码,以及检查,审计和闸门命令一个编码代理运行以验证其工作.

## 安装

```sh
npm install @guren/cli
```

也可以使用：`pnpm add @guren/cli`、`yarn add @guren/cli`、`bun add @guren/cli`

## README

# @guren/ cli (英语)

用于 [格伦](https://guren.dev/), 带有 Laravel 风格公约的 Bun- First Fullstack TypeScript 框架。 脚手架 迁移 代码 完整性检查一个编码代理运行来验证自己的工作.

您不直接安装此软件包 。 它作为附属船舶 `@guren/core`,所以每个古伦应用已经拥有它:

```bash
bunx create-guren-app my-app
```

在应用程序里,运行它 `bunx guren`编辑 `guren` 命令通过应用程序的本地解析 `@guren/cli`,因此它只能从项目目录中工作.

## 它会做什么

```bash
bunx guren make:feature Post --fields "title:string,body:text"  # CRUD scaffold
bunx guren add auth                 # registration, login, sessions, password flows
bunx guren db:migrate               # run pending migrations
bunx guren codegen                  # regenerate typed routes, pages, and API client
bunx guren gate                     # every CI stage under one exit code
```

`bunx guren --help` 列出所有命令。 这个 [CLI 指南](https://guren.dev/docs/guides/cli) 每个文件.

## 编码代理符的命令

这些存在是为了让代理能够读取工程并检查其工作而不是猜测:

| 命令 | 答复 |
| --- | --- |
| `guren context` | 这个项目是什么? 有 API 签名、 模型、 路线和页面的地图 |
| `guren context <Entity>` | 有关一个实体的一切:模型、路线、页面、资源、政策、链接的文件 |
| `guren check` | 路线、控制器和页面是否一致? 加上医生链接、光谱新鲜度和接线规则 |
| `guren audit` | 哪些变异路线没有验证或授权? 加上原始SQL、机密、CSRF豁免 |
| `guren doctor --next` | 错位了,怎么办 |
| `guren agent:init` | 安装代理吊带 : `CLAUDE.md`规则,技能,钩子, `.mcp.json` |

## 子路径导出

| 导入 | 目录 |
| --- | --- |
| `@guren/cli/arch` | `defineArchRules()` 页:1 `guren.arch.ts` 结构边界 |
| `@guren/cli/oxlint` | 林特规则运至脚手架应用,包括 `guren/await-async-assertion` 财务报告和审定财务报表 `guren/no-nullish-env-default` |
| `@guren/cli/vite` | 路由类型 Vite 插件 |

## 文档

[格伦.德夫/多克](https://guren.dev/docs)

## 许可证

麻省理工学院

## 常见问题

### @guren/cli 是什么？

古伦框架的CLI:脚手架\(make:\*,添加\),迁移,代码,以及检查,审计和闸门命令一个编码代理运行以验证其工作\.

### 如何安装 @guren/cli？

在项目目录运行 npm install @guren/cli，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：vite（\>=7\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。它还提供命令行工具 guren，可以用 npx guren 直接运行。

### @guren/cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @guren/cli 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @guren/cli 可以商用吗？

@guren/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @guren/cli 的下载量有多少？

根据 npm 官方下载统计，@guren/cli 在 2026/10/17 – 2026/11/15 这 30 天内被下载 11,511 次，日均约 384 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @guren/cli 还在维护吗？

最新版本 2\.37\.0 发布于 2026/11/16（今天）；至今共发布 93 个版本，其中过去 12 个月发布了 85 个；首次发布于 2025/11/02。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

