开始之前
- ✓已初始化 Git 的项目
- ✓Node.js 18 或更高版本
- ✓AIFlare 账户·还没有账户？
API 密钥设置
在 aiflare.dev 注册账户后，前往项目设置 → API 密钥管理生成 API Key。将下载的 aiflare.yml 放置在项目根目录中。
安装 CLI
通过 Homebrew、npm 或 curl 安装 `aiflare` CLI。
Homebrew (macOS / Linux)
brew install aiflare/tap/aiflare
npm
npm install -g @aiflare/cli
curl
curl -fsSL https://aiflare.dev/install.sh | bash
每台机器认证一次（device-flow）
aiflare login
连接项目 + 签发 ApiKey + 安装技能·hook·MCP
cd your-project aiflare init
在已安装代理的技能列表中确认 context-capture（Claude Code、Codex 中输入 /skills）。
> /skills Project skills (.claude/skills) context-capture
如未列出，请检查 .claude/skills/context-capture/ (Claude Code) 或 .agents/skills/context-capture/ (Codex、Gemini CLI、Copilot CLI) 目录是否存在。
首次捕获验证
让您的 AI 代理完成一个简单任务并提交——仅此而已。
AIFlare 仅在 AI 代理提交时工作。手动执行 git commit 不会被捕获。
在 README.md 中添加一行项目描述并提交
✓ 如果仪表板上出现时间线条目，说明配置成功！
在仪表板中浏览时间线
捕获的条目按时间顺序显示在仪表板时间线中。每个条目自动记录提交的意图、变更摘要和分类。
Added a project introduction at the top of README.md per user request
featureExtracted JWT validation logic into a separate module for testability
refactor点击时间线中的条目可查看详情。
条目详情 — 查看相关提示词
点击时间线中的条目打开详情模态框。查看提交的意图、变更摘要和变更文件，右侧面板可查看相关提示词（对话记录）。
Added a description of the project's purpose and key features at the top of README.md per user request.
Added a project introduction section at the top of README.md and organized the key feature list
Add a one-line project description to README.md and commit it
I'll add a project description to README.md and commit it.
💡 通过右侧提示词面板，无需代码审查即可快速了解变更的上下文。
通过工作会话了解工作流程
从侧边栏选择工作会话，查看该会话的提交列表。使用"查看提示词"按钮查看会话的完整对话。
点击"查看提示词"打开会话提示词模态框，显示该会话中用户与 AI 的完整对话。
💡 工作会话让你了解为达成目标经历了哪些步骤，结合提示词掌握完整上下文。
项目设置
在项目设置中创建/删除 API 密钥、管理成员、编辑项目信息。
遇到问题了？
出现 API Key 错误
确认 aiflare.yml 文件存在于项目根目录中，且 api_key 和 endpoint 已正确设置。
Skill 未被识别
确认 .claude/skills/context-capture/ (Claude Code) 或 .agents/skills/context-capture/ (Codex、Gemini CLI、Copilot CLI) 目录存在于项目根目录中。
捕获未出现在仪表板上
请确保是 AI 代理在执行提交。同时检查 aiflare.yml 中的 endpoint 是否正确。
可以捕获手动提交吗？
目前仅捕获 AI 代理的提交。Skill 通过分析代理的对话上下文来总结意图和替代方案，手动提交无法获取这些信息。
想了解 AIFlare 的工作原理吗？ How It Works →