# macOS/Linux 一键安装
curl -fsSL https://app.factory.ai/cli | sh

# Linux 用户需要安装 xdg-utils
sudo apt-get install xdg-utils  # Debian/Ubuntu

# Windows PowerShell
iex "& { $(irm https://app.factory.ai/cli) }"

# 从 https://app.factory.ai/settings/api-keys 获取 API Key
export FACTORY_API_KEY='fk-your-api-key'  # 加到 ~/.zshrc 或 ~/.bashrc

cd your-project-folder
droid

# 进入交互模式
droid

# 带问题进入交互模式
droid "explain this project"

# 单次执行（不进入交互模式）
droid exec "summarize src/auth"

# 从文件读取 prompt
droid exec -f prompt.md

# 管道输入
git diff | droid exec "draft release notes"

# 恢复已有会话
droid exec -s session-123 "continue"

# 默认：只读分析
droid exec "Analyze the auth system and create a plan"

# Low：安全编辑
droid exec --auto low "Add JSDoc comments to all functions"

# Medium：开发工作
droid exec --auto medium "Install deps, run tests, fix issues"

# High：CI/CD 场景
droid exec --auto high "Run tests, commit, and push changes"

# 完全放开（仅限沙箱环境！）
droid exec --skip-permissions-unsafe "..."

# 打开 MCP 管理界面
/mcp

# 从注册表添加（推荐）
# 选择 "Add from Registry"，有 40+ 预配置的服务器

# 命令行添加 HTTP 服务器
droid mcp add linear https://mcp.linear.app/mcp --type http

# 添加 stdio 服务器
droid mcp add myserver "node /path/to/server.js"

# 删除
droid mcp remove linear

# 交互模式切换
/model

# 命令行指定
droid exec -m claude-sonnet-4-5-20250929 "review this code"

# Spec Mode 用不同模型规划
droid exec --spec-model claude-sonnet-4-5-20250929 --use-spec "add user profiles"

droid "analyze this codebase and explain the overall architecture"

droid "what technologies and frameworks does this project use?"

droid "where are the main entry points and how is testing set up?"

# 简单描述，让 Droid 理解并实现
droid "add comprehensive error handling to the payment processor in src/payments/processor.ts. Catch gateway timeouts and retry up to 3 times with exponential backoff. Similar retry logic exists in src/notifications/sender.ts. Run the payment integration tests to verify it works."

# 带上下文的 bug 描述
droid "Users report file uploads fail randomly. Error in browser console: 'Network timeout'. Upload logic is in src/upload/handler.ts. Check for timeout handling."

# 审查未提交的修改
droid "review my uncommitted changes and suggest improvements before I commit"

# 用 git diff 审查
droid "look at git diff and review these changes for security issues"

# 带约束的重构
droid "extract the email sending logic into a separate service class. Keep the same interfaces but make it testable in isolation."

# 从 Jira ticket 实现功能
droid "implement the feature described in this Jira ticket: https://company.atlassian.net/browse/PROJ-123"

# 从 Notion 文档获取需求
droid "build the API endpoints based on the spec in this Notion page: https://notion.so/..."

# 智能 commit
droid "create a well-structured commit with a descriptive message following our team conventions"

# 分析历史
droid "analyze the last few commits and identify any potential issues or patterns"

# 找历史代码
droid "find the commit that introduced the caching mechanism and explain how it works"

# 明确目标、指定文件、说明验证方式
droid "Add comprehensive error handling to the payment processor in src/payments/processor.ts. Catch gateway timeouts and retry up to 3 times with exponential backoff. Run the payment integration tests to verify."

# 太模糊
droid "make the app better"
droid "fix the database"
droid "can you help with the frontend?"

droid "implement user data export backend API and job processing. Focus only on the server-side functionality, not the UI yet."

droid "add the frontend UI for data export using the API from Phase 1. Include progress indicators and download management."