命令参考
本页汇总 LinkAI CLI 的全部命令。每个命令都可运行 linkai <命令> --help 查看完整参数。
通用约定
--json：输出结构化 JSON，便于 Agent 或脚本解析。--dry-run：预览将要发送的请求，不实际执行（适用于写操作）。--force：跳过交互式确认（如knowledge delete）。- 退出码：
0成功 /1一般错误 /2参数错误 /3认证或权限错误 /4网络错误。
登录认证 auth
登录采用 OAuth 设备码流程，需在浏览器中完成授权。
| 命令 | 说明 |
|---|---|
linkai auth login | 登录，--scope 申请权限 |
linkai auth logout | 登出（同步吊销服务端 token） |
linkai auth status | 查看登录状态（valid / needs_refresh / expired） |
linkai auth login
linkai auth status --json
应用 app
| 命令 | 说明 |
|---|---|
linkai app list [--key <关键词>] | 查看应用列表，获取 app_code |
linkai app detail <code> | 查看应用详情与配置 |
对话 chat
与 AI 应用或语言模型对话，支持多轮会话。
linkai chat "<消息>" [--app <app_code>] [--model <model_code>] [--session <id>] [--no-stream] [--json]
--app：与配置好的应用对话（app_code来自linkai app list）。--model：直接调用某个语言模型（model_code来自linkai model list）。- 两者都不传时使用平台默认模型；同时传入时
--model覆盖应用配置的模型。 --session <id>：跨多次调用传入同一 id 即可保持上下文，实现多轮对话。
知识库 knowledge
向量检索私有知识库，管理文件与知识库条目。
| 命令 | 说明 | 所需权限 |
|---|---|---|
linkai knowledge list | 查看知识库列表，获取 kb_code | knowledge:read |
linkai knowledge files <kb_code> | 查看知识库中的文件 | knowledge:read |
linkai knowledge search <kb_code> "<query>" [--k <n>] | 向量检索（--k 返回条数，默认 5） | knowledge:read |
linkai knowledge create --name <name> [--desc <txt>] | 创建知识库 | knowledge:create |
linkai knowledge update <kb_code> [--name ...] [--desc ...] | 更新知识库 | knowledge:update |
linkai knowledge add <kb_code> (--text <txt> \| --question <q> --answer <a>) | 添加内容（纯文本或问答对） | knowledge:create |
linkai knowledge delete <kb_code> --force | 删除整个知识库 | knowledge:delete |
数据库 database
查询业务数据库、表结构，执行 SQL（禁止 DDL）。
| 命令 | 说明 |
|---|---|
linkai database list | 查看数据库列表，获取 db_code |
linkai database tables <db_code> | 查看数据表列表 |
linkai database describe <db_code> <table> | 查看表结构 |
linkai database exec <db_code> "<SQL>" | 执行 SQL（SELECT 需 db:read，写操作需 db:write） |
工作流 workflow
运行 LinkAI 上编排好的工作流。
| 命令 | 说明 |
|---|---|
linkai workflow list | 查看工作流列表，获取 code |
linkai workflow run <code> --input "<文本>" | 运行工作流 |
插件 plugin
调用平台插件能力。
| 命令 | 说明 |
|---|---|
linkai plugin list | 查看插件列表 |
linkai plugin detail <code> | 查看插件详情 |
linkai plugin exec <code> | 执行插件 |
内容生成 image / video / audio
| 命令 | 说明 |
|---|---|
linkai image gen "<描述>" | 文生图，输出图片链接 |
linkai video gen "<描述>" | 文生视频，内置轮询等待完成 |
linkai audio speech "<文本>" [--output a.mp3] | 语音合成（TTS），可下载到本地 |
模型 model
linkai model list [--type LLM|IMAGE|VIDEO]
查询可用模型，--type 按模态筛选。
账户 account
| 命令 | 说明 |
|---|---|
linkai account info | 查看账号信息与积分余额 |
linkai account credits | 查看积分套餐 |
linkai account recharge | 充值购买 |
linkai account orders | 查看订单 |
权限
权限在登录时通过 --scope 申请，格式为「资源:动作」。默认授予只读与内容生成权限；写操作权限需显式申请。
| 权限 | 说明 | 默认授予 |
|---|---|---|
app:read | 查询应用列表、详情 | ✅ |
app:create | 创建应用 | ✅ |
user:read | 查询用户信息 | ✅ |
chat:send | 与应用对话 | ✅ |
knowledge:read | 查询知识库 | ✅ |
knowledge:create | 创建知识库 / 添加文件 | ✅ |
db:read | 查询数据库 / 执行 SELECT | ✅ |
image:gen / video:gen / audio:gen | 生成图片 / 视频 / 语音 | ✅ |
plugin:read / plugin:run | 查询 / 执行插件 | ✅ |
workflow:read / workflow:run | 查询 / 运行工作流 | ✅ |
workflow:create | 创建工作流 | ✅ |
score:read / score:buy | 查看 / 购买积分 | ✅ |
app:update / app:delete | 更新 / 删除应用 | ❌ |
knowledge:update / knowledge:delete | 更新 / 删除知识库 | ❌ |
workflow:update / workflow:delete | 更新 / 删除工作流 | ❌ |
db:write | 数据库写操作（INSERT/UPDATE/DELETE） | ❌ |
申请额外权限时重新登录，例如：
linkai auth login --scope "db:read db:write knowledge:update knowledge:delete"
安全设计
- Token：Opaque token 服务端存储、可撤销；
access2h /refresh7d，到期前自动刷新；logout同步吊销服务端 token。 - 设备绑定：请求携带
X-Device-ID，服务端绑定 token 与设备。 - 本地存储：macOS 存入系统钥匙串（服务名
linkai-cli），其他平台文件存储（0600）；配置在~/.linkai/。 - 输入 / 输出防护：拒绝危险 Unicode，数据库禁 DDL，表格输出剥离 ANSI。
- 容错：5xx 自动指数退避重试；退出码结构化，便于程序判断。