ftai

ftai 平台 CLI — 安装与管理来自 ftai.chat 的 Skill。

设计

ftai 自身专注两件事：

1. 与 ftai 平台 API 通信（列表 / 详情 / 下载 ZIP）
2. 把 ZIP 解压到本地缓存

实际的 agent 探测、目录映射、symlink/copy、lock 文件、update 全部委托给 vercel-labs/skills — 自动支持 OpenClaw、Claude Code、Cursor、Codex、Pi、OpenCode 等 40+ 个 AI agent。

安装

# 全局
npm i -g ftai-cli

# 或直接 npx 使用
npx ftai-cli skill list

常用命令

# 列出可用 Skill
ftai skill list
ftai skill list --type official --category 行情
ftai skill list --keyword 黄金 --json

# 查看详情
ftai skill view 1
ftai skill view gold-tracker

# 安装 Skill
ftai skill install 1
ftai skill install gold-tracker

# 在 `--` 之后的所有参数会原样透传给 `npx skills add`：
ftai skill install 1 -- --agent claude-code -g -y
ftai skill install 1 -- --agent openclaw --copy

# 其它 flag
ftai skill install 1 --force         # 忽略本地缓存重新下载
ftai skill install 1 --no-rewrite    # 关闭中文名改写（见下文）

# 配置 / 缓存
ftai config
ftai cache path
ftai cache clear            # 清理 skills + zips
ftai cache clear --zips     # 仅清理 ZIP
ftai cache clear --skills   # 仅清理已解压副本

vercel-labs/skills 支持的 agent 与 flag 详见其 README。

中文 Skill 名改写

vercel-labs/skills 在安装时会对 SKILL.md 中的 name 做 sanitizeName。纯中文名（如“外汇”、“产业链解读”）经过 sanitize 后会全部变成 unnamed-skill，多个中文 Skill 会互相覆盖。

ftai 在安装前会检测这种情况，自动改写解压后缓存中的 SKILL.md：

# 改写前
---
name: 外汇
description: …
---

# 改写后（由 ftai 自动处理）
---
name: ftai-skill-74          # 稳定、幂等、基于平台 ID
description: …              # 不变
displayName: 外汇           # 原名保留到这里
metadata:
  ftai:
    originalName: 外汇
    skillId: 74
---

正文和其它字段不变。可用 --no-rewrite 关闭改写（此时多个中文 Skill 会落在同一个 unnamed-skill 目录并互相覆盖）。

配置

ftai 按以下优先级解析配置：

CLI flag (--api-base-url ...) > 环境变量 (FTAI_API_BASE_URL) > ~/.ftai/ftai.config.{ts,js,json} > 默认 (https://ftai.chat)

示例 ~/.ftai/ftai.config.ts：

export default {
  apiBaseUrl: "https://ftai-staging.example.com",
};

缓存目录

| 路径 | 用途 | |---|---| | ~/.ftai/cache/skills/<name>-<version>/ | 解压后的 Skill（vercel-labs/skills 安装的源） | | ~/.ftai/cache/zips/<id>-<version>.zip | 下载的 ZIP 原文件 |

开发

pnpm install

# 直接用 TS 跑（jiti）
pnpm dev skill list
pnpm dev skill install 1

# 类型检查 / lint / 测试 / 构建
pnpm typecheck
pnpm check
pnpm test
pnpm build

构建产物：dist/index.mjs（ESM，带 shebang，作为 ftai 命令入口）。

更新日志

见 CHANGELOG.md。从 v0.2.0 起由 changelogen 基于 Conventional Commits 自动生成。

许可证

MIT