浏览文档
开始使用
选择安装位置、验证技能包,并更新或移除技能。
本页内容
1. 安装到正确位置
使用已安装的 FlashData CLI。选择下方一种位置,并运行两条命令。--skip-auth 离线安装内置技能,不创建试用或修改凭据。
对应宿主将 codex 替换为 claude-code 或 cursor。其他项目使用 --directory PATH;它不能与 --global 同用。Codex 与 Cursor 共用项目安装。
flashdata setup --agent codex --directory . --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --jsonflashdata setup --agent codex --global --skip-auth --non-interactive --json
flashdata skills verify --agent codex --global --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 会检查默认技能包;若仅安装部分技能,将报告缺失文件。
flashdata setup --agent codex --directory . --skill google-search --skip-auth --non-interactive --json
flashdata skills verify --agent codex --directory . --skill google-search --json3. 重启智能体并检查访问
开启新智能体会话以加载已安装技能。在该会话中检查,使用与登录相同的系统用户、配置档及状态目录。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 撤销。移除技能不会撤销凭据。