# @aether-agent/cli 中文文档 规范地址：https://npmcn.com/package/%40aether-agent/cli/ 版本：0\.9\.21 npm 元数据更新时间：2026-11-03T05:55:55.815Z 中文译文更新时间：2026-11-06T00:42:47.555Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40aether-agent/cli 原文对照：https://npmcn.com/package/%40aether-agent/cli/?lang=original 项目主页：https://github.com/contextbridge/aether 源码仓库：https://github.com/contextbridge/aether ## 关键信息（来自 npm 元数据） - 包体积（解压后）：56.5 kB，11 个文件 - TypeScript 类型：未声明 - Node.js 要求：\>=14\.18 - 运行依赖：1 个 - 首次发布：2026-04-13T16:20:18.142Z - 最新版本发布：2026-11-03T05:55:55.397Z - 近 30 天下载量：8042（2026-10-05 至 2026-11-03，npm 官方下载统计） - 已发布版本数：87（近 12 个月 87 个） ## 中文简介 用于 Aether AI 编码代理的 CLI 和 ACP 服务器 ## 安装 ```sh npm install @aether-agent/cli ``` 也可以使用：`pnpm add @aether-agent/cli`、`yarn add @aether-agent/cli`、`bun add @aether-agent/cli` ## README # 异色剂- cli 以太 CLI 号舰作为单一的二进制, **`aether`**,带有每种使用方式的子命令: - `aether` 交互式 TUI( 无参数运行时的默认值) - `aether headless` ——脚本/CI的单速无头跑 - `aether acp` —— 说 [代理客户协议( ACP)](https://agentclientprotocol.com/overview/introduction) 兼容编辑器/IDE客户端的 v2 服务器 - `aether settings init --user|--project` ——初始化用户或项目设置 - `aether show-prompt` ——打印全组装系统快取(调试) ## 目录 - [安装](https://npmcn.com/package/%40aether-agent/cli/#readme-install) - [快速启动](https://npmcn.com/package/%40aether-agent/cli/#readme-quick-start) - [互动 TUI](https://npmcn.com/package/%40aether-agent/cli/#readme-interactive-tui) - [无头](https://npmcn.com/package/%40aether-agent/cli/#readme-headless) - [ACP 服务器](https://npmcn.com/package/%40aether-agent/cli/#readme-acp-server) - [选择一个模型](https://npmcn.com/package/%40aether-agent/cli/#readme-choosing-a-model) - [编辑器集成( ACP)](https://npmcn.com/package/%40aether-agent/cli/#readme-editor-integration-acp) - [齐德](https://npmcn.com/package/%40aether-agent/cli/#readme-zed) - [MCP 配置](https://npmcn.com/package/%40aether-agent/cli/#readme-mcp-configuration) - [斜线命令](https://npmcn.com/package/%40aether-agent/cli/#readme-slash-commands) - [设置](https://npmcn.com/package/%40aether-agent/cli/#readme-settings) - [代理人(模式和子代理人)](https://npmcn.com/package/%40aether-agent/cli/#readme-agents-modes-and-sub-agents) - [日志](https://npmcn.com/package/%40aether-agent/cli/#readme-logs) ## 安装 选择适合您工作流程的任意: ```bash # npm (cross-platform) npm install -g @aether-agent/cli # Homebrew (macOS / Linux) brew install contextbridge/tap/aether # Shell installer (macOS / Linux) curl --proto '=https' --tlsv1.2 -LsSf \ https://github.com/contextbridge/aether/releases/latest/download/aether-agent-cli-installer.sh | sh # From source cargo install aether-agent-cli ``` 要从工作空间检查中构建 : ```bash cargo build --release -p aether-agent-cli # binary lands at target/release/aether ``` ## 快速启动 ### 互动 TUI ```bash aether ``` 如果不存在用户设置或项目设置,二进制会在启动TUI前启动用户级上载. 要明确初始化, 运行 `aether settings init --user` 个人违约,或 `aether settings init --project` 用于项目本地代理的存储器根. ### 无头 ```bash aether headless -m anthropic:claude-sonnet-4-5-20250929 "Refactor auth module" ``` 有用的旗帜 : `-a/--agent` (从设置中指定代理人), `-C/--cwd`, (中文(简体) ), `--system-prompt`, (中文(简体) ), `--output text|json`, (中文(简体) ), `--events tool_call,tool_result,...`, (中文(简体) ), `--mcp-config `, (中文(简体) ), `--settings-file ` 编号 : `--settings-json `。通过提示作为位置的正弦, 或把它吹到Stdin上. ### ACP 服务器 ```bash aether acp --model anthropic:claude-sonnet-4-5-20250929 --mcp-config mcp.json ``` 旗帜 : `--agent ` (与 `--model`, (中文(简体) ), `--reasoning-effort low|medium|high|xhigh`, (中文(简体) ), `--log-dir `,加上同样的 `--settings-file` 编号 : `--settings-json` 选项. ## 选择一个模型 Aether 支持多个 LLM 提供者使用 `provider:model` 字符串格式 : | 提供者 | 示例 | 需要输入 | | --- | --- | --- | | 安东尼 | `anthropic:claude-sonnet-4-5-20250929` | `ANTHROPIC_API_KEY` | | `OpenRouter` | `openrouter:moonshotai/kimi-k2-thinking` | `OPENROUTER_API_KEY` | | 晓美 | `xiaomi:mimo-v2.6-pro` | `XIAOMI_API_KEY` | | 津巴布韦 | `zai:GLM-4.6` | `ZAI_API_KEY` | | 奥拉玛 | `ollama:llama3.2` | 无(当地) | | Llama.cpp (法语) | `llamacpp` | 无(当地) | ## 编辑器集成( ACP) ### 齐德 对于ACP v2 支持的 Zed 版本,请加入您的 `settings.json` (主菜单-"打开设置文件"): ```json { "agent_servers": { "Aether Agent": { "command": "/path/to/aether", "args": [ "acp", "--model", "zai:GLM-4.6", "--mcp-config", "/path/to/your/project/mcp.json" ], "env": { "RUST_LOG": "debug", "ZAI_API_KEY": "your-api-key-here" } } } } ``` 然后打开 [代理小组](https://zed.dev/docs/ai/agent-panel) 并选择“新以太代理线索”. **重要内容:** 更新路径和配置 : - `command`: 通向 `aether` 二进制(例如: `which aether` 或者说 `target/release/aether`(中文(简体) ) - `--mcp-config`: 您的 MCP 配置文件路径 - 为您的模型提供者设置合适的 API 密钥 env var ## MCP 配置 这个 `mcp.json` 文件配置 MCP 工具服务器 : ```json { "servers": { "coding": { "type": "in-memory", "args": ["--rules-dir", ".aether/skills", "--rules-dir", ".claude/rules"] }, "skills": { "type": "in-memory", "args": [ "--dir", ".aether/skills", "--dir", ".claude/skills" ] } } } ``` - **编码** —— 文件系统工具(读取、写取、拍取等) 外加配置的可选自动读取规则 `--rules-dir` 路径 - **技能** —— 从配置中加载的斜线命令和可重复使用的提示 `--dir` 路径 设定 `"deferTools": true` 在服务器上保持其策略不包含模型可见工具定义. 使用 `aether mcp --help` 然后发现被推迟的服务器 `aether mcp --help` 财务报告和审定财务报表 `aether mcp --help` 检查工具和计划。 使用 `--json '{...}'` 或JSON在Stdin上的物体。 用于分区工具 `"deferTools": { "include": [...], "exclude": [...] }`;条目是准确的 MCP - 本地名称,跟踪..`*` 前缀, 或注释匹配符, 如 `{ "readOnly": true }`,以及 `exclude` 赢了. ## 斜线命令 斜线命令是由 `skills` 任何通过目录的 MCP 服务器 `--dir`。每个条目要么是单个条目 `.md` 文件或包含 `SKILL.md` (加上可选的辅助文件). 使一个迅速出现作为一个 `/slash-command` 在 TUI / 非加太客户端中设置 `userInvocable: true` 在它的前题. **示例** `.aether/skills/plan.md`数字 : ```markdown --- description: Create a detailed implementation spec for a task argumentHint: userInvocable: true --- You are an expert software architect. Create a comprehensive technical specification. # Task $ARGUMENTS ``` **前题字段 :** - `description` ——在命令拾取器中显示 - `argumentHint` 参数的可选提示字符串 - `userInvocable` ——曝光快报为: `/slash-command` - `agentInvocable` ——将提示暴露为其他特工能够掌握的技能 `get_skills` 反对 - `tags` 用于 `list_skills` 发现表面 **体内参数语法:** - `$ARGUMENTS` ——全参数字符串(例如. `/plan add user auth` → `add user auth`(中文(简体) ) - `$1`, (中文(简体) ), `$2`, (中文(简体) ), `$3` ——立场论证 ## 设置 用户级设置位于 `$AETHER_HOME/settings.json` 或者说 `~/.aether/settings.json`项目级代理配置 `.aether/settings.json` 在您的项目根。 以太先加载用户设置,然后是工程设置;匹配名的项目代理覆盖用户代理. 设置定义代理(modes和子代理),默认提示,以及默认的MCP服务器配置. ### 代理人(模式和子代理人) 定义具有特定模型、提示和工具配置的代理 : ```json { "agent": "planner", "prompts": [".aether/prompts/shared.md", "AGENTS.md"], "mcps": [".aether/mcp.json"], "agents": [ { "name": "planner", "description": "Planner optimized for decomposition and sequencing", "model": "anthropic:claude-sonnet-4-5", "reasoningEffort": "high", "userInvocable": true, "agentInvocable": true }, { "name": "researcher", "description": "Read-only research agent", "model": "anthropic:claude-sonnet-4-5", "userInvocable": false, "agentInvocable": true, "prompts": [".aether/prompts/researcher.md"], "mcps": [".aether/researcher-mcp.json"], "tools": { "allow": [{ "readOnly": true }], "deny": [] } }, { "name": "coder", "description": "Fast coding agent", "model": "deepseek:deepseek-v4-flash", "userInvocable": true, "agentInvocable": false, "prompts": [".aether/prompts/coder.md"] } ] } ``` - **`agent`** ——可选的默认用户可退出代理名称. - **顶级 `prompts`** ——未定义自己的代理使用的已订购的默认快捷源 `prompts`。文件路径可以作为字符串写入; 键入对象支持 `{ "type": "text", "text": "..." }`, (中文(简体) ), `{ "type": "file", "path": "..." }`,以及 `{ "type": "glob", "pattern": "..." }`。 。 。 . - **顶级 `mcps`** ——命令未定义自己的代理使用的默认 MCP 配置源 `mcps`。文件路径可以作为字符串写入; 键入对象支持 `{ "type": "file", "path": "...", "deferTools": false }` 内置 `{ "type": "inline", "servers": { ... } }` 条目. - **探员 `prompts`** ——可选命令快速源覆盖顶层 `prompts` 为了那个特工 支持与顶级相同的字符串短手和输入对象 `prompts`。 。 。 . - **探员 `mcps`** ——可选命令超顶级的MCP配置源 `mcps` 为了那个特工 支持与顶级相同的字符串短手和输入对象 `mcps`。 。 。 . - **`userInvocable: true`** ——代理作为模式选项出现在ACP客户端(例如Wisp's Shift+Tab)中 - **`agentInvocable: true`** 代理可以被产入子代理 - **`tools`** ——过滤代理工具可以使用的 MCP (可选) 。 支助 `allow` (清单)和 `deny` (块列表)条目. 条目可以是准确的/train --`*` 名称图案,例如 `coding__read_file` 或说明匹配者,例如: `{ "readOnly": true }`, (中文(简体) ), `{ "destructive": false }`, (中文(简体) ), `{ "idempotent": true }`,以及 `{ "openWorld": false }`如果两者都设定好了, `allow` 首先应用,然后 `deny` 从结果中删除。 关闭或留空以允许所有工具 . 您可以通过交互方式进行脚手架设置 `aether settings init --user` 或者说 `aether settings init --project`。直接编辑生成的设置 JSON 以自定义代理 . ## 日志 ACP 运行日志到 `--log-dir` (默认 : `/tmp/aether-acp-logs/`) (中文(简体) ). 控制动词 `RUST_LOG` 环境变量. ## 常见问题 ### @aether-agent/cli 是什么？ 用于 Aether AI 编码代理的 CLI 和 ACP 服务器 ### 如何安装 @aether-agent/cli？ 在项目目录运行 npm install @aether-agent/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 aether，可以用 npx aether 直接运行。 ### @aether-agent/cli 支持 TypeScript 吗？ 该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/aether-agent\_\_cli 是否存在。 ### @aether-agent/cli 需要什么版本的 Node\.js？ package\.json 的 engines 字段要求 Node\.js \>=14\.18。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。 ### @aether-agent/cli 可以商用吗？ @aether-agent/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @aether-agent/cli 的下载量有多少？ 根据 npm 官方下载统计，@aether-agent/cli 在 2026/10/05 – 2026/11/03 这 30 天内被下载 8,042 次，日均约 268 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @aether-agent/cli 还在维护吗？ 最新版本 0\.9\.21 发布于 2026/11/03（2 天前）；至今共发布 87 个版本，其中过去 12 个月发布了 87 个；首次发布于 2026/04/14。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。