@alfe.ai/config

中文文档
0.6.1发布于 2026/10/28TypeScriptESM + CJS近 30 天下载 4333

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

中文使用文档
文档目录5 节
  1. 它会做什么
  2. 配置格式
  3. 发展
  4. 依赖关系
  5. 链接

@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) 解剖更新一个运行时表

配置格式

# ~/.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()。 。 。 .

发展

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 解析和序列化

版本与发布记录

@alfe.ai/config 共发布 18 个版本,首次发布于 2026/03/27;过去 12 个月发布了 18 个版本。

版本发布日期距今
0.6.1latest2026/10/289 天前
0.6.02026/10/2214 天前
0.5.02026/10/1917 天前
0.4.22026/10/1422 天前
0.4.12026/08/033 个月前
0.4.02026/07/313 个月前

关于 @alfe.ai/config 的常见问题

@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 和提交记录判断。