agent-Specialization/website-content/10-cli.md
JOJO 93628f49fc chore(website): 归档官网文档内容与设计素材
- website-content/:官网 10 篇文档内容 + README
- website-design/:官网设计稿、动画实验、预览图与资源
- 根目录官网截图两张
- .gitignore 忽略 website-design/exp/static/dist 构建产物(7.1MB)
2026-09-02 14:38:51 +08:00

1.5 KiB
Raw Blame History

CLI开发中

⚠️ CLI 目前处于重写中的开发状态,功能与稳定性以 Web 端为准,本文仅介绍当前形态,所列行为后续可能变化。


1. 是什么

一个终端里的对话客户端:React 19 + Ink 6 + TypeScript 实现的 TUI让你不打开浏览器也能与 Astrion 对话。

关键点CLI 不是独立的 Agent 运行时——它连接的是你本地正在运行的 Astrion Web 服务(默认 127.0.0.1:8091所有对话、工具执行、权限控制都走后端CLI 只是一个更轻的交互界面。

2. 启动

npm --prefix cli install   # 首次安装依赖
npm run cli                # 启动,自动连接本地 8091 服务

启动后会清屏、连接本地服务、创建新会话,输入区固定在底部。若当前目录不在任何已授权工作区中,会先询问是否添加为工作区。

3. 当前能力与边界

  • 基础对话、流式输出、工具调用展示;
  • / 指令体系(设计中,详见仓库 docs/cli_slash_commands_spec.md
  • 思考内容默认折叠,只显示「思考中 / 思考完成」;
  • 多模态、快捷窗口、版本控制等 Web 端能力在 CLI 中尚未对齐——需要完整功能时请用 Web 端。

4. 面向开发者

npm run cli:typecheck   # 类型检查
npm run cli:build       # 构建(产物提供 agents / agents-cli 命令)

CLI 代码在 cli/src/App.tsxcomponents.tsxeventMapper.tsapi.ts),欢迎贡献。