跳转到正文
中文
获取 API 密钥
浏览文档

开始使用

管理 FlashData 技能

选择安装位置、验证技能包,并更新或移除技能。

本页内容

1. 安装到正确位置

使用已安装的 FlashData CLI。选择下方一种位置,并运行两条命令。--skip-auth 离线安装内置技能,不创建试用或修改凭据。

对应宿主将 codex 替换为 claude-code 或 cursor。其他项目使用 --directory PATH;它不能与 --global 同用。Codex 与 Cursor 共用项目安装。

安装并验证 · Codex
flashdata setup --agent codex --directory . --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --json

文件安装位置

其他宿主使用独立安装器,或从官方仓库复制完整目录。保留 SKILL.md 及其支持文件。

宿主项目用户目录
Codex.agents/skills~/.agents/skills
Claude Code.claude/skills~/.claude/skills or $CLAUDE_CONFIG_DIR/skills
Cursor.agents/skills~/.cursor/skills

2. 检查验证结果

skills verify 将所选安装与当前程序的内置版本比较。预期 ok: true、data.verified: true;data.directories 标识检查位置,data.sourceCommit 标识内置来源版本。这验证技能文件,不验证 API 访问。

skills list 列出此 CLI 可安装的内容,不是智能体已安装技能的清单。

列出内置技能及版本
flashdata skills list --json

仅安装指定技能

安装与验证使用相同的 --skill、--agent 和位置参数。省略 --skill 会检查默认技能包;若仅安装部分技能,将报告缺失文件。

仅 Google 搜索 · 当前项目
flashdata setup --agent codex --directory . --skill google-search --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --skill google-search --json

3. 重启智能体并检查访问

开启新智能体会话以加载已安装技能。在该会话中检查,使用与登录相同的系统用户、配置档及状态目录。FLASHDATA_API_KEY 会覆盖保存的密钥。自定义配置档需为 auth status 添加对应 --profile 和 --state-dir。

不执行付费查询
flashdata --version
flashdata doctor --offline
flashdata auth status --json

更新并保留本地修改

使用原安装方式升级 CLI,再运行第 1 步对应的安装与验证命令。保留相同宿主、位置及 --skill 选择。未修改的托管文件会更新;冲突或本地修改会使命令停止,等待检查。验证通过后重启智能体。

仓库安装需更新整个技能目录,包括 references、scripts 和 assets。CLI 内置版本可能与仓库最新提交不同。

修复检查失败

症状操作
缺少技能文件检查 --agent、--directory / --global 和 --skill。验证安装时相同的位置和选择。
哈希不匹配 / 本地修改对比报告文件与内置版本。替换前保留修改,再重新安装和验证。
符号链接或安装锁使用普通目录。处理过期锁前,检查是否另有安装进程正在运行;不要移除活动锁。
已验证,但智能体未发现打开目标项目,检查宿主技能路径并重启会话。
已验证,但 API 调用失败在智能体环境检查 auth status。技能文件不提供凭据或 Credits。

移除技能或撤销访问

在宿主禁用技能或移除已安装目录可停止加载指令。智能体访问需在已连接应用单独撤销;导入密钥则在 API Keys 撤销。移除技能不会撤销凭据。

继续使用 FlashData