Fx Base
/install fx-base
fx-base — feima-lab 公共基础
本 skill 是 feima-lab 后端 API 的公共基础模块。不直接面向用户调用,而是被领域 skill 的脚本通过 import 引用。
提供的函数
领域 skill 的脚本通过 import { fxCheckAuth, fxPost, fxCheckResponse, FX_BASE_URL } from './fx-api.mjs' 获得以下函数:
| 函数 | 说明 |
|---|---|
fxCheckAuth() |
校验环境变量 FX_AI_API_KEY,未设置时输出标准错误 JSON 并 exit 1 |
fxPost(endpoint, body, errMsg?) |
发送 POST 请求到 FX_BASE_URL/\x3Cendpoint>,自动拼接认证头。失败时 exit 1 |
fxCheckResponse(respJson) |
校验响应 JSON:code==200 返回 data,否则输出错误并 exit 1 |
常量:FX_BASE_URL=https://api-ai-brain.fenxianglife.com/fenxiang-ai-brain
环境变量
| 变量 | 必填 | 说明 |
|---|---|---|
FX_AI_API_KEY |
是 | 从 feima-lab 开放平台 登录获取 |
安装
# ClawHub(推荐)
npx skills install fangshan101-coder/fx-base
# npm
npx skills install fx-base
安装后确保 fx-base 与依赖它的领域 skill 在同一个 .claude/skills/ 目录下(即同级目录)。
领域 skill 如何引用
在领域 skill 的脚本头部添加:
import { fileURLToPath } from 'url';
import { join, dirname } from 'path';
import { existsSync } from 'fs';
const _scriptDir = dirname(fileURLToPath(import.meta.url));
const _fxApiPath = join(_scriptDir, '../../fx-base/scripts/fx-api.mjs');
if (!existsSync(_fxApiPath)) {
process.stderr.write(
'{"status":"error","error_type":"missing_dependency","suggestion":"缺少 fx-base,请安装:npx skills install fangshan101-coder/fx-base"}\
'
);
process.exit(1);
}
const { fxCheckAuth, fxPost, fxCheckResponse } = await import(_fxApiPath);
然后即可使用 fxCheckAuth()、fxPost()、fxCheckResponse()。
错误输出格式
所有错误统一为 JSON 到 stderr:
{"status":"error","error_type":"\x3C类型>","suggestion":"\x3C用户可见提示>"}
| error_type | 触发条件 |
|---|---|
missing_api_key |
FX_AI_API_KEY 环境变量未设置 |
api_unavailable |
curl 请求失败(超时、网络错误、HTTP 错误) |
api_error |
响应 code != 200,从 errorMessage 字段提取具体原因 |
missing_dependency |
领域 skill 找不到 fx-base(未安装) |
数据流向
用户提供的数据会被发送到 https://api-ai-brain.fenxianglife.com 进行处理,请确保信任该服务后再使用。
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install fx-base - 安装完成后,直接呼叫该 Skill 的名称或使用
/fx-base触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Fx Base 是什么?
feima-lab 后端公共基础模块:API 认证校验(FX_AI_API_KEY)、请求封装(POST + Bearer Token)、 通用错误处理(missing_api_key / api_unavailable / api_error)。 这是基础依赖 skill,被其他领域 skill(如 fanli... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 177 次。
如何安装 Fx Base?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install fx-base」即可一键安装,无需额外配置。
Fx Base 是免费的吗?
是的,Fx Base 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Fx Base 支持哪些平台?
Fx Base 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Fx Base?
由 fangshan101-coder(@fangshan101-coder)开发并维护,当前版本 v1.1.2。