快速入门

欢迎使用 InfiniteX!本指南将帮助你在 5 分钟内开始使用 AI 编程助手。

1. 安装插件

在QQ群 InfiniteX 下载安装,或使用以下方式:

百度云下载
https://pan.baidu.com/s/1ruMmfTySrwjbdnEyPn-oww?pwd=c55r
提取码: c55r

2. 登录账号

安装后,点击侧边栏的 InfiniteX 图标,输入你的 API Key 进行登录:

InfiniteX
输入 API Key 开始使用
获取 API Key
访问 用户中心 创建 API Key,或在用户中心完成订阅后自动获得。

3. 开始对话

登录成功后,你可以直接在输入框中与 AI 对话:

  • 代码问答 - 询问代码相关问题,AI 会结合你的项目上下文回答
  • 生成代码 - 描述需求,AI 自动生成并编辑文件
  • 执行命令 - AI 可以帮你运行终端命令
  • 浏览器操作 - 让 AI 帮你自动化浏览器任务

4. 核心功能

Agent Skills

预定义的知识模块,让 AI 学会特定任务。了解更多 →

Workflows

通过 /command 快速触发预设的工作流程。了解更多 →

MCP 工具

扩展 AI 能力,连接数据库、GitHub 等外部服务。了解更多 →

下一步

恭喜你已经完成基础设置!接下来可以:

Agent Skills

Skills 是扩展 AI 能力的知识模块,让 AI 学会特定的工作流程和最佳实践。

什么是 Skills?

Agent Skills 是存放在项目 .agent/skills/ 目录下的指令文件。当你与 AI 对话时,它会自动发现并理解这些技能,在需要时运用相关知识来完成任务。

适用场景
• 项目特定的构建和部署流程
• 代码审查标准和规范
• 常用的开发工具链配置
• 团队约定的最佳实践

创建 Skill

在插件中点击 Customizations → Skills → + Workspace 创建新技能,或手动创建文件:

.agent/
└── skills/
    └── my-skill/
        └── SKILL.md      # 必需:技能定义文件

SKILL.md 格式

每个技能文件使用 YAML frontmatter + Markdown 格式:

---
name: 构建与打包
description: 项目的构建和打包流程
---

# 构建与打包

## 目的
描述这个技能的用途。

## 步骤
1. 安装依赖:`npm install`
2. 构建项目:`npm run build`
3. 打包发布:`npm run package`

## 注意事项
- 构建前确保测试通过
- 检查版本号已更新

技能示例

技能名称描述
build-package项目构建和打包流程
code-review代码审查规范和检查清单
deploy-server服务器部署步骤

使用技能

AI 会自动发现可用技能。当你的问题与某个技能相关时,AI 会:

  1. 识别相关技能并读取 SKILL.md 内容
  2. 按照技能中定义的步骤执行
  3. 遵循技能中的注意事项和最佳实践
提示
技能会在每次对话开始时被发现并列出。如果修改了技能文件,可以开始新对话或刷新 Skills 列表使更改生效。

Workflows

Workflows 是预定义的工作流程,通过 /command 快速触发执行。

什么是 Workflows?

Workflows 让你可以将常用的多步骤任务定义为一个命令。在对话中输入 /workflow-name 即可触发 AI 按照预设步骤执行。

与 Skills 的区别

Skills 是知识和最佳实践,AI 在需要时自动参考。
Workflows 是具体的执行步骤,需要用户主动触发。

创建 Workflow

Workflows 存放在项目 .agent/workflows/ 目录中:

.agent/
└── workflows/
    ├── build.md
    ├── deploy.md
    └── test.md

文件格式

---
description: 构建并打包项目
---

# Build Workflow

1. 安装依赖
```bash
npm install
```

2. 运行测试
```bash
npm test
```

// turbo
3. 构建项目
```bash
npm run build
```

触发 Workflow

在对话输入框中输入 / 加工作流名称(文件名去掉 .md):

/build      # 触发 build.md
/deploy     # 触发 deploy.md
/test       # 触发 test.md

Turbo 模式

默认情况下,AI 执行每个步骤前都会等待你确认。使用 // turbo 注解可以让特定步骤自动执行:

注解作用范围说明
// turbo单个步骤紧跟其后的一个命令自动执行
// turbo-all整个文件文件中所有命令都自动执行
安全提示
Turbo 模式会自动执行命令,请确保命令是安全的。不要在包含删除、修改重要文件的命令上使用 turbo。

作用域

Workflows 支持两种作用域:

  • Workspace - 项目级别,存放在项目 .agent/workflows/
  • Global - 全局级别,存放在 ~/.infiniteX/workflows/

MCP 工具扩展

MCP(Model Context Protocol)让 AI 能够使用外部工具和服务,大幅扩展其能力范围。

什么是 MCP?

MCP 是一个开放协议,允许 AI 调用外部工具。通过 MCP,AI 可以:

  • 查询和操作数据库
  • 读写文件系统
  • 调用 GitHub、Slack 等服务 API
  • 执行浏览器自动化任务

安装 MCP 服务器

在插件中进入 Customizations → MCP Servers,你可以:

  1. 浏览可用的 MCP 服务器列表
  2. 点击服务器卡片查看详情
  3. 点击 Install 一键安装

常用 MCP 服务器

服务器功能分类
GitHub管理仓库、Issue、PR开发工具
PostgreSQL查询和管理数据库数据库
Puppeteer浏览器自动化自动化
Filesystem读写本地文件工具
Fetch抓取网页内容工具
Memory跨对话存储信息工具
Cloud Run部署到 Google CloudGoogle Cloud
FirebaseFirebase 项目管理Google Cloud

配置环境变量

部分 MCP 服务器需要配置 API Key 或其他凭证。安装后,在服务器详情页的 Config 标签中配置:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_TOKEN": "your-github-token"
      }
    }
  }
}
配置文件位置
MCP 配置保存在 ~/.infiniteX/mcp.json

使用 MCP 工具

安装并配置 MCP 服务器后,AI 会自动识别可用工具。你可以直接请求 AI 使用这些工具:

// 示例对话
用户:帮我查看 GitHub 上最近的 Issue
AI:正在使用 GitHub MCP 工具查询... [调用 list_issues 工具]

常见问题

查找使用过程中常见问题的解答。

账号与订阅

如何获取 API Key?

登录用户中心,在 API Key 页面点击"创建 Key"即可生成。

Token 额度用完怎么办?

当日额度用完后,系统会降低请求优先级(响应变慢),但不会直接拒绝服务。额度每日 00:00 UTC+8 自动重置。

支持哪些支付方式?

目前支持支付宝扫码支付。

插件使用

如何切换 AI 模型?

在对话界面左下角的模型选择器中切换。Flash 模型更快,Pro 模型更强大。

Skills 没有生效怎么办?

1. 确认 SKILL.md 文件在正确位置:.agent/skills/<name>/SKILL.md
2. 检查 YAML frontmatter 格式是否正确
3. 开始新对话或刷新 Skills 列表

Workflow 命令无法触发?

确保输入格式正确:/workflow-name(斜杠 + 文件名去掉 .md)。检查文件是否在 .agent/workflows/ 目录中。

MCP 工具

MCP 服务器安装后显示 Error?

1. 检查是否安装了 Node.js 16+
2. 部分服务器需要配置环境变量(如 GITHUB_TOKEN)
3. 尝试在终端手动运行命令查看错误详情

如何卸载 MCP 服务器?

在 MCP Servers 页面点击已安装的服务器,然后点击 Uninstall 按钮。

其他问题

遇到其他问题怎么办?

加入 InfiniteX QQ 群获取技术支持,或发送邮件到 infinitex@qq.com。