# @funky-dev/cli 中文文档

规范地址：https://npmcn.com/package/%40funky-dev/cli/

版本：0\.2\.0
npm 元数据更新时间：2026-11-11T03:37:34.242Z
中文译文更新时间：2026-11-15T21:49:59.774Z
软件包许可：MIT

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

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

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

- 包体积（解压后）：6.6 kB，4 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-29T18:05:39.907Z
- 最新版本发布：2026-11-11T03:37:33.895Z
- 近 30 天下载量：2301（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

以代码管理 Funky 代理

## 安装

```sh
npm install @funky-dev/cli
```

也可以使用：`pnpm add @funky-dev/cli`、`yarn add @funky-dev/cli`、`bun add @funky-dev/cli`

## README

# 风趣

管理 [风云](https://platform.funky.dev/) 特工作为代码。 在 YAML 中描述每个代理 文档,然后 `funky apply` 创建或更新它——如Terraform,用于代理配置.

## 安装

```bash
npm install -g @funky-dev/cli    # or, without installing: npx @funky-dev/cli login
```

或者从 macOS、 Linux 或 Windows 下载二进制 [最新发布](https://github.com/funkyhq/cli/releases/latest),或者,安装了Go:

```bash
go install github.com/funkyhq/cli/cmd/funky@latest
```

`funky --version` 显示已安装的版本.

## 快开始

```bash
funky login      # opens your browser: sign in, pick a project, approve this machine
funky init       # creates agents/
$EDITOR agents/researcher.yaml
funky apply      # shows the plan, asks, then creates or updates
```

## 代理文件

每个代理配置一个文件 `agents/`。这些字段是API的代理配置字段:

```yaml
# agents/researcher.yaml
inference:
  provider: anthropic
  model: claude-sonnet-5
  maxTokens: 2048
systemPrompt: You are an autonomous agent in a fresh Linux sandbox.
network:
  type: allowlist
  domains: [github.com]
packages:
  pip: [pandas==2.2.0]
setupCommands: []
credentials: []
resources: { cpuCount: 4, memoryMB: 4096 }
metadata: { team: research }
```

`inference`, (中文(简体) ), `systemPrompt` 财务报告和审定财务报表 `network` 需要; 其余默认为空. `resources` 在 vCPUs 和 MiB 内存中大小代理服务器的沙盒; 遗漏的字段是 默认, 2 vCPUs 和 1024 MiB.

代理人以其文件名或 `name:` 字段。 名称保存在配置中 元数据为 `funky.dev/name`,这就是下一个 `apply` 找到要更新的配置 .

`funky apply`数字 :

-   创建新文件的配置, 更新文件已更改的配置( 仅结束更改) 字段,因此每个字段最多增加一个版本),而留下其余部分;
-   将每个更新标注在它计划对应的版本上, 因此在其它版本中编辑了一个配置 与此同时,冲突失败,而不是被掩盖;
-   从不保存任何文件: 删除一个文件会留下它的配置 .

旗帜 : `--dry-run` 仅显示计划; `--auto-approve` 跳过确认.

## 认证

`funky login` 将CLI签入您, 在一个项目中—— 再次运行它来切换项目 。 这个 登录持续90天,生活在您的 OS 密钥链中,并可通过 `funky logout` 或从 网络应用程序中的设置 . `funky whoami` 显示CLI是谁和在哪里行动.

在一台没有浏览器的机器上, `funky login --no-browser` 打印链接并询问代码 页面显示.

在CI中,设置 `FUNKY_API_KEY` 键 [https://platform.funky.dev/api-keys (中文(简体) )](https://platform.funky.dev/api-keys) 相反;它需要 优先于登录.

## 发展

```bash
go test ./...
go run ./cmd/funky --help
```

`FUNKY_API_URL`, (中文(简体) ), `FUNKY_CONSOLE_URL` 财务报告和审定财务报表 `FUNKY_PLATFORM_URL` 将CLI指向非生产 服务; `FUNKY_CONFIG_DIR` 移动保存登录的地方.

## 释放

按下版本标签; 发布工作流程构建每个平台 [释放器](https://goreleaser.com/),发布 GitHub 发布,然后发布 `@funky-dev/cli` 至npm( 时间`npm/publish.mjs`;每个平台的二进制是自己的版本,比如 `0.1.1-darwin-arm64`,主要版本作为可选依赖性安装的:

```bash
git tag v0.1.0 && git push origin v0.1.0
```

带有后缀的标签( T)`v0.2.0-rc.1`)成为预发式,在npm的 `next` 标签。 试试这栋楼 当地: `goreleaser release --snapshot --clean && node npm/publish.mjs --dry-run` (产出) `dist/`) (中文(简体) ).

## 常见问题

### @funky-dev/cli 是什么？

以代码管理 Funky 代理

### 如何安装 @funky-dev/cli？

在项目目录运行 npm install @funky-dev/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 funky，可以用 npx funky 直接运行。

### @funky-dev/cli 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/funky-dev\_\_cli 是否存在。

### @funky-dev/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @funky-dev/cli 可以商用吗？

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

### @funky-dev/cli 的下载量有多少？

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

### @funky-dev/cli 还在维护吗？

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