命令行工具 (CLI)
LinkAI CLI 是 LinkAI 平台的命令行工具，让 Agent 和人类 都可以在终端中调用和管理 LinkAI 的全部核心能力（模型、应用、知识库、数据库、工作流、插件、账户）。它把平台能力封装成一个 linkai 命令，作为 Agent 的基础设施资源，扩展 Agent 的能力边界。
LinkAI 平台上编排好的应用、知识库、数据库、工作流、插件等资源，此前主要通过控制台与开放 API 使用。CLI 让这些能力可以被 任意 Agent / Coding 工具（Claude Code、Cursor、Codex、CowAgent 等）在本地终端中直接管理和调用，并内置 Agent Skill——装好即用，Agent 无需额外配置就知道如何驱动它。
能力总览
LinkAI CLI 核心提供两类能力：平台资源（管理和使用在 LinkAI 上配置的资源）和 模型能力（调用不同模型生成内容）。
📦 平台资源
| 资源 | 命令 | 说明 |
|---|---|---|
| 应用 | app | 查询 AI 应用列表与配置 |
| 知识库 | knowledge | 向量检索私有知识库，管理文件与知识库 |
| 数据库 | database | 查询业务数据库、表结构，执行 SQL |
| 工作流 | workflow | 运行 LinkAI 上编排好的工作流 |
| 插件 | plugin | 调用平台插件能力 |
| 账户 | account | 用户账号信息、积分管理 |
🧠 AI 模型能力
| 能力 | 命令 | 说明 |
|---|---|---|
| 对话 | chat | 与 AI 应用或语言模型对话，支持多轮会话 |
| 图片生成 | image | 文生图，输出图片链接 |
| 视频生成 | video | 文生视频，内置轮询等待完成 |
| 语音合成 | audio | 文本转语音（TTS），可下载到本地 |
| 模型列表 | model | 查询可用模型（LLM / IMAGE / VIDEO） |
运行
linkai <命令> --help查看任意命令的完整参数。命令的详细说明见 命令参考。
快速开始
1. 安装
最简单的方式是通过 npm 安装（需要 Node.js 16+）：
npm i -g linkai-cli
或使用一键安装脚本（零依赖，会同时安装 Agent Skill）：
# macOS / Linux
curl -fsSL https://cdn.link-ai.tech/cli/install.sh | sh
# Windows (PowerShell)
irm https://cdn.link-ai.tech/cli/install.ps1 | iex
更多安装方式（Homebrew / Go / 二进制 / 源码）见 安装指南。
2. 三步开始使用
linkai auth login # 1. 登录（在浏览器完成授权）
linkai app list # 2. 查看应用，获取 app_code
linkai chat "你好" --app <app_code> # 3. 与应用对话
auth status 查看登录状态，auth logout 登出。
面向 Agent
CLI 从设计之初就同时服务于 Agent。安装后会附带一个 Agent Skill，装到常见 AI 工具目录（Claude Code / Cursor / Codex / CowAgent 等），Agent 通过 Skill 即可了解如何调用 CLI，无需额外配置。
调用时的几点约定：
- 加
--json获取结构化输出，便于解析。 - 写操作可先加
--dry-run预览请求；knowledge delete等需确认的命令加--force跳过交互。 - 运行
linkai <命令> --help查看命令的完整参数。
详见 Agent 集成与 Skill。
文档导航
📚 深入了解
权限说明
登录时通过 --scope 申请权限，格式为「资源:动作」。默认授予只读与内容生成权限；更新、删除、数据库写入等写操作权限需显式申请：
linkai auth login --scope "db:read db:write knowledge:update knowledge:delete"
完整权限列表见 命令参考 - 权限。