# @forgeailab/smith 中文文档

规范地址：https://npmcn.com/package/%40forgeailab/smith/

版本：0\.8\.1
npm 元数据更新时间：2026-10-28T06:22:45.946Z
中文译文更新时间：2026-11-15T08:20:57.632Z
软件包许可：\(MIT OR Apache-2\.0\)

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

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

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

- 包体积（解压后）：26.9 kB，4 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：0 个
- 首次发布：2026-08-06T17:41:38.005Z
- 最新版本发布：2026-10-28T06:22:45.548Z
- 近 30 天下载量：2093（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：46（近 12 个月 46 个）

## 中文简介

用于 Smith 终端首个编码代理的 NPX 靴取器

## 安装

```sh
npm install @forgeailab/smith
```

也可以使用：`pnpm add @forgeailab/smith`、`yarn add @forgeailab/smith`、`bun add @forgeailab/smith`

## README

# Smith npm 脚踏车

先从 npm 运行 Smith 不安装平台二进制 :

```bash
npx @forgeailab/smith
```

软件包下载匹配的 Smith GitHub 发布归档 macOS 或 Linux, 验证它反对 `SHA256SUMS` 可用时将其缓存于 `~/.smith/npx`开始 `smith` 二进制. Linux 总是使用 Smith 的 完全静态的 musl 存档,所以同一软件包在 glibc 和 musl 主机上工作. 明确名称 `smith-<arch>-linux-gnu.tar.gz` 档案保留 用于更喜欢Ubuntu 22.04-基线GNU构建的用户.

有用命令 :

```bash
npx @forgeailab/smith -p "explain this repo"   # one headless turn
npx @forgeailab/smith setup                     # guided provider/model setup
npx @forgeailab/smith --help
```

## 安装永久 `smith` 命令

`--install` 将下载的二进制复制到您的 PATH 上, 因此稍后运行跳过 npm 完全没有。 它写给用户拥有的目录,所以它从不需要sudo:

```bash
npx @forgeailab/smith --install                      # -> ~/.local/bin/smith
npx @forgeailab/smith --install --install-dir ~/bin  # somewhere else
SMITH_INSTALL_DIR=~/bin npx @forgeailab/smith --install
npx @forgeailab/smith --uninstall                    # remove it again
```

如果安装目录不在您身上 `PATH`,命令打印 `export PATH=...` 线条将添加到您的外壳配置中.

默认情况下, 包装器会下载匹配 npm 的 GitHub 释放标记 软件包版本。 用于测试不同的发布 :

```bash
npx @forgeailab/smith --release latest
SMITH_NPX_TAG=v0.1.0 npx @forgeailab/smith
```

## 常见问题

### @forgeailab/smith 是什么？

用于 Smith 终端首个编码代理的 NPX 靴取器

### 如何安装 @forgeailab/smith？

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

### @forgeailab/smith 支持 TypeScript 吗？

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

### @forgeailab/smith 需要什么版本的 Node\.js？

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

### @forgeailab/smith 可以商用吗？

@forgeailab/smith 使用 \(MIT OR Apache-2\.0\) 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @forgeailab/smith 的下载量有多少？

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

### @forgeailab/smith 还在维护吗？

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