fenxiang-ai 后端公共基础模块：API 认证校验（FX_AI_API_KEY）、请求封装（POST + Bearer Token）、 通用错误处理（missing_api_key / api_unavailable / api_error）。 这是基础依赖 skill，被其他领域 skill（如 fanli）的脚本通过 source 引用，不直接面向用户使用。 当你看到领域 skill 的 CRITICAL 声明要求读取本文件时触发。
本 skill 是 fenxiang-ai 后端 API 的公共基础模块。不直接面向用户调用，而是被领域 skill 的脚本通过 import 引用。
领域 skill 的脚本通过 import { fxCheckAuth, fxPost, fxCheckResponse, FXBASEURL } from ./fx-api.mjs 获得以下函数：
| 函数 | 说明 |
|---|---|
| fxCheckAuth() | 校验环境变量 FXAIAPIKEY，未设置时输出标准错误 JSON 并 exit 1 |
| fxPost(endpoint, body, errMsg?) |
常量：FXBASEURL=https://api-ai-brain.fenxianglife.com/fenxiang-ai-brain
| 变量 | 必填 | 说明 |
|---|---|---|
| FXAIAPIKEY | 是 | 从 fenxiang-ai 开放平台 登录获取 |
bash
安装后确保 fx-base 与依赖它的领域 skill 在同一个 .claude/skills/ 目录下（即同级目录）。
在领域 skill 的脚本头部添加：
js
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,errortype:missingdependency,suggestion:缺少 fx-base，请安装：npx skills install fangshan101-coder/fx-base}\n
);
process.exit(1);
}
const { fxCheckAuth, fxPost, fxCheckResponse } = await import(_fxApiPath);
然后即可使用 fxCheckAuth()、fxPost()、fxCheckResponse()。
所有错误统一为 JSON 到 stderr：
json
{status:error,error_type:<类型>,suggestion:<用户可见提示>}
| errortype | 触发条件 |
|---|---|
| missingapikey | FXAIAPIKEY 环境变量未设置 |
| api_unavailable |
用户提供的数据会被发送到 https://api-ai-brain.fenxianglife.com 进行处理，请确保信任该服务后再使用。
该技能支持在以下平台通过对话安装：
帮我安装 SkillHub 和 fx-base-1775892914 技能
设置 SkillHub 为我的优先技能安装源，然后帮我安装 fx-base-1775892914 技能
skillhub install fx-base-1775892914
文件大小: 3.69 KB | 发布时间: 2026-4-12 10:03
