# @alfe\.ai/config 中文文档

规范地址：https://npmcn.com/package/%40alfe.ai/config/

版本：0\.6\.1
npm 元数据更新时间：2026-10-28T04:40:57.994Z
中文译文更新时间：2026-11-06T06:48:58.603Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40alfe.ai/config
原文对照：https://npmcn.com/package/%40alfe.ai/config/?lang=original
项目主页：https://alfe.ai/

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

- 包体积（解压后）：211 kB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：1 个
- 首次发布：2026-03-26T19:44:24.475Z
- 最新版本发布：2026-10-28T04:40:57.800Z
- 近 30 天下载量：4333（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：18（近 12 个月 18 个）

## 中文简介

读写 `~/.alfe/config.toml` 用于 Alfe CLI,网关,运行时间,并发布插件.

## 安装

```sh
npm install @alfe.ai/config
```

也可以使用：`pnpm add @alfe.ai/config`、`yarn add @alfe.ai/config`、`bun add @alfe.ai/config`

## README

# `@alfe.ai/config`

读写 `~/.alfe/config.toml` 用于 Alfe CLI、网关、运行时间和 已发布插件.

## 它会做什么

Alfe用户端工具(CLI,网关守护进程,插件)共享配置管理. 读取和写入用户的本地配置文件 `~/.alfe/config.toml`。 。 。 .

-   **`readConfig()`** 阅读和剖析 `~/.alfe/config.toml`
-   **`writeConfig(config)`** ——将配置写入 `~/.alfe/config.toml`
-   **`configExists()`** ——检查配置文件是否存在
-   **`resolveConfig()`** ——解决环境覆盖,文件值,运行时间, 工作空间、 API 来源和语音 HTTP 来源
-   **`getEndpointFromToken(token)`** ——从符号前缀获取 API 端点( )`alfe_dev_`, (中文(简体) ), `alfe_test_`, (中文(简体) ), `alfe_live_`(中文(简体) )
-   **`mergeAndWriteConfig(partial)`** ——解剖更新自有顶级字段 不删除运行时表
-   **`writeRuntimeConfig(name, config)`** 解剖更新一个运行时表

## 配置格式

```toml
# ~/.alfe/config.toml
api_key = "alfe_live_xxxx..."
gateway = "https://api.alfe.ai"  # optional override
gateway_url = "wss://gateway.alfe.ai/ws" # optional daemon relay override
runtime = "openclaw"

[runtimes.openclaw]
workspace = "/home/alfe/.openclaw"
```

决议优先 `ALFE_API_KEY` 编号 : `ALFE_API_URL`,然后是配置文件, 然后是符号前缀的终点。 接受 Plaintext HTTP/WS 覆盖 只用于回放开发. 证书文件在解剖上被替换为 模式 `0600` 仅在所有者体内 `~/.alfe` 目录; 并行作者为 跨进程序列化.

`writeConfig()` 故意替换完整的文档。 图标 只拥有必须使用的子集 `mergeAndWriteConfig()`。 。 。 .

## 发展

```bash
pnpm install
pnpm --filter @alfe.ai/config lint
pnpm --filter @alfe.ai/config typecheck
pnpm --filter @alfe.ai/config test
pnpm --filter @alfe.ai/config build
```

## 依赖关系

-   **闪闪发光** - TOML 解析和序列化

## 链接

-   网站: [https://alfe.ai (英语)](https://alfe.ai/)
-   医生: [https://docs.alfe.ai (英语)](https://docs.alfe.ai/)

## 常见问题

### @alfe\.ai/config 是什么？

读写 ~/\.alfe/config\.toml 用于 Alfe CLI,网关,运行时间,并发布插件\.

### 如何安装 @alfe\.ai/config？

在项目目录运行 npm install @alfe\.ai/config，或使用 pnpm add / yarn add / bun add。

### @alfe\.ai/config 支持 TypeScript 吗？

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

### @alfe\.ai/config 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @alfe\.ai/config 可以商用吗？

@alfe\.ai/config 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @alfe\.ai/config 的下载量有多少？

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

### @alfe\.ai/config 还在维护吗？

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