Arka CLI 命令与参数参考

arka 命令是主入口。agent 是同一路由器的别名。

请始终在命令前加 arka。 子命令、技能与自然语言请求均通过 arka … 或 arka "…" 运行。Fish 快捷方式（如 chart、stock news）仅在 Fish 中可用，但文档示例统一使用 arka。

安装 CLI（无需从源码构建）

无需克隆仓库即可在终端使用 arka。安装 arka-agent 包：

pipx install "arka-agent[chat]"
arka setup
arka doctor

# PyPI 不可用？从 GitHub 安装，无需 clone：
pipx install "arka-agent[chat] @ git+https://github.com/Sumit884-byte/arka.git"

打开新终端后运行 arka help。只有在你向 Arka 贡献代码或需要可编辑安装时才需要 clone 仓库。

主要命令

命令	说明
`arka <request>`	将自然语言路由到最佳技能
`agent <request>`	相同路由器（别名）
`arka ask <question>`	Web + AI 回答
`arka route <request>`	预览路由但不执行
`arka goal <goal>`	自主多步骤 agent 循环
`arka setup`	初始化配置目录和依赖
`arka doctor`	安装诊断
`arka reload`	重新读取 `.env` 和 `config.fish`
`arka refetch --install`	Git pull + sync + 重新安装
`arka help`	技能概览

YouTube 命令

请参阅完整的 YouTube 指南。

命令	说明
`arka youtube research <query>`	搜索 + 字幕研究摘要
`arka download <id-or-url>`	下载视频、Shorts 或播放列表
`arka summarize youtube <id>`	总结视频或播放列表
`arka youtube_download <url>`	单个视频下载（fish）
`arka youtube_bulk download <url>`	批量下载播放列表/频道

股票命令

请参阅完整的股票情报指南。

命令	说明
`arka stock news`	市场新闻源
`arka stock prices [TICKER…]`	实时价格
`arka stock analyze TICKER`	AI 回测 + ML 信号
`arka stock fundamentals TICKER…`	与同行的比率对比
`arka stock invest <question>`	深度投资研究
`arka predictions --domain stocks <topic>`	机会分析

图表与预测

完整指南：图表

命令	说明
`arka chart line AAPL --range 1y`	股票折线图
`arka chart predict AAPL --days 30`	股价预测图
`arka chart models --type scatter`	LLM 延迟 vs 基准分数
`arka predict future "…" --chart`	天气、降雨、Kaggle、CSV 预测
`arka benchmark run --dry-run`	为 `arka chart models` 填充数据

自然语言（始终加 arka 前缀）：

arka "compare Apple and Tesla stock last year"
arka "predict monsoon rainfall in Mumbai next 2 weeks"
arka "chart AI model characteristics with data points"
arka "forecast kaggle dataset heptapod/titanic next 30 days"

语音与服务

命令	说明
`arka listen`	唤醒词监听器（“hey arka, …”）
`arka start` / `arka stop`	后台服务
`arka serve`	用于手机 STT/TTS 的远程服务器
`arka speak-lang hi-IN`	设置语音语言
`arka reload --listen`	重新加载配置并重启监听器

LLM 管理

命令	说明
`arka ai-models`	列出提供商与默认模型
`arka ai-skill-model`	按技能配置模型
`arka ai-skill-model profiles`	任务配置文件（route、chat、summarize）
`arka select_model`	基于硬件的模型推荐
`arka select_model --apply`	将推荐应用到技能配置

参见硬件感知的模型选择。

路由学习

命令	说明
`arka route_learn learn <phrase> <skill>`	教授短语 → 技能映射
`arka route_learn learn --from-trace --correct <skill>`	修正上一次路由错误
`arka route_learn list`	列出已学习的路由
`arka route_learn delete <id>`	移除已学习的路由
`arka route_learn test <phrase>`	预览短语的路由

参见教授自定义路由。

竞赛

命令	说明
`competitions sources`	列出黑客松/ML 竞赛来源
`competitions search <topic>`	搜索全部来源
`competitions search <topic> --source kaggle`	搜索某个平台

参见黑客松与 ML 竞赛。

每日简报

命令	说明
`daily_brief`	个性化早间科技头条

自然语言：arka daily brief、arka morning tech brief。参见每日与科技简报。

Gemini CLI

命令	说明
`arka gemini`	交互式 Google Gemini CLI
`arka gemini <prompt>`	一次性提示
`arka gemini status`	安装与认证检查

参见 Google Gemini CLI 集成。

社交与媒体

命令	说明
`arka post_x <url>`	抓取、缩短并发布到 X/Twitter
`arka ascii_art <text>`	生成 ASCII 艺术横幅
`arka ascii_art --image <path>`	将图片转换为 ASCII

Google Workspace

命令	说明
`arka google setup`	配置 Google OAuth
`arka google login`	认证 Gmail + Calendar
`arka google gmail --unread`	获取未读邮件
`arka google calendar --today`	今日日历事件

插件

命令	说明
`arka skills list`	列出已安装的插件
`arka skills install <url>`	从 git URL 安装
`arka skills refresh`	重新加载插件注册表

Goal agent

以步骤预算运行自主多步骤任务：

arka goal set up a venv, install requests, and run pytest
arka goal -y -n 30 debug why nginx fails

默认步骤预算：GOAL_MAX_STEPS=25。

Fish shell 辅助函数

使用 fish 时，可用以下函数：

arka route "play bohemian rhapsody"   # 预览路由
arka route # 上一次路由决策
arka route # 解释技能选择

应用配置更改

arka reload              # 重新读取 .env + config.fish
arka reload --listen     # 同时重启唤醒监听器

介绍

设置与 CLI

故障排除

Arka CLI 命令与参数参考

安装 CLI（无需从源码构建）

主要命令

YouTube 命令

股票命令

图表与预测

语音与服务

LLM 管理

路由学习

竞赛

每日简报

Gemini CLI

社交与媒体

Google Workspace

插件

Goal agent

Fish shell 辅助函数

应用配置更改

​安装 CLI（无需从源码构建）

​主要命令

​YouTube 命令

​股票命令

​图表与预测

​语音与服务

​LLM 管理

​路由学习

​竞赛

​每日简报

​Gemini CLI

​社交与媒体

​Google Workspace

​插件

​Goal agent

​Fish shell 辅助函数

​应用配置更改

安装 CLI（无需从源码构建）

主要命令

YouTube 命令

股票命令

图表与预测

语音与服务

LLM 管理

路由学习

竞赛

每日简报

Gemini CLI

社交与媒体

Google Workspace

插件

Goal agent

Fish shell 辅助函数

应用配置更改