# @ai-support-agent/cli 中文文档

规范地址：https://npmcn.com/package/%40ai-support-agent/cli/

版本：0\.5\.16
npm 元数据更新时间：2026-10-23T01:54:30.673Z
中文译文更新时间：2026-11-06T15:57:06.811Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40ai-support-agent/cli
原文对照：https://npmcn.com/package/%40ai-support-agent/cli/?lang=original
项目主页：https://github.com/mbc-net/ai-support-agent-cli#readme
源码仓库：https://github.com/mbc-net/ai-support-agent-cli

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：6 MB，1249 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- Node.js 要求：\>=20\.0\.0
- 运行依赖：27 个
- 首次发布：2026-02-21T17:26:47.507Z
- 最新版本发布：2026-10-23T01:54:30.306Z
- 近 30 天下载量：2817（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：401（近 12 个月 401 个）

## 中文简介

AI 支持代理 CLI 客户端

## 安装

```sh
npm install @ai-support-agent/cli
```

也可以使用：`pnpm add @ai-support-agent/cli`、`yarn add @ai-support-agent/cli`、`bun add @ai-support-agent/cli`

## README

# AI 支持代理CLI

[![npm version](https://img.shields.io/npm/v/@ai-support-agent/cli.svg)](https://www.npmjs.com/package/@ai-support-agent/cli) [![license](https://img.shields.io/npm/l/@ai-support-agent/cli.svg)](https://github.com/mbc-net/ai-support-agent-cli/blob/main/LICENSE)

一个将你的机器变成AI驱动的遥控器 安装它,通过浏览器认证,你的团队可以发送 shell 命令, AI 聊天提示, 文件操作, 以及更多的—— 全部来自一个Web UI,结果流回实时.

```
┌──────────────┐  AppSync     ┌─────────────────┐  WebSocket/HTTP  ┌──────────────────┐
│   Web UI     │ ──────────── │   API Server    │ ─────────────── │  Agent CLI       │
│  (browser)   │  subscription│   (NestJS)      │  commands/result │  (your machine)  │
└──────────────┘              └─────────────────┘                  └──────────────────┘
                                                                     ├─ Claude Code
                                                                     ├─ Shell / PTY
                                                                     ├─ File I/O
                                                                     ├─ Git repos
                                                                     ├─ MCP server
                                                                     └─ VS Code tunnel
```

## 为什么?

-   **远程 AI 对等编程** ——从Web UI中询问有关您代码库的问题;克洛德代码运行在代理机上,可以完全访问寄存器.
-   **多租户,多项目** 单一代理人管理不同租户的多个项目。 在苍蝇上添加/移动项目;代理热重载.
-   **零配置实时** ——AppSync WebSocket订阅即时发送命令. 没有投票延误,没有港口转发.
-   **默认安全** ——OAuth登录,6600配置权限,无ce被保护回调,SQL注射检测,路径穿行守护,环境消毒.

## 托管服务

最快的启动方式是管理服务 **[ai-support-agent.com (中文(简体) )](https://ai-support-agent.com/)**。在那里创建一个账户,然后将 CLI 从框中连接到它 。 这些是内置默认, 所以不需要额外的标记 :

| 终点 | 網址 | 作用 |
| --- | --- | --- |
| 产品网站 | [ai-support-agent.com (中文(简体) )](https://ai-support-agent.com/) | 登陆页面——报名学习更多 |
| 网页控制台 | [app.ai-support-agent.com (英语)](https://app.ai-support-agent.com/) | 您发送命令并观看结果的 Web UI 。 还有OAuth的目标 `login` 在浏览器中打开( 默认) `--url`) (中文(简体) ). |
| API 密码 | `https://api.ai-support-agent.com` | 代理 QQ 服务器 API 守护进程对话到( 默认) `--api-url`) (中文(简体) ). |

运行 `ai-support-agent login` 打开主机网络控制台( q)`app.ai-support-agent.com`)在浏览器中,在其中签名并选择租户和项目链接.

**自我接待吗?** CLI不与主机服务捆绑. 指着自己的部署 `--url` 编号 : `--api-url` (或 `AI_SUPPORT_AGENT_API_URL` 环境变量)——见 [配置](https://npmcn.com/package/%40ai-support-agent/cli/#readme-configuration)。 。 。 .

## 快速启动

```bash
npm install -g @ai-support-agent/cli

# Opens app.ai-support-agent.com in your browser → sign in → select tenant & project → done
ai-support-agent login

# Start the daemon (Ctrl-C to stop)
ai-support-agent start
```

就是这样。 代理机与服务器注册,同步项目配置,克隆寄存器,并开始监听命令.

Docker必须运行:每个项目默认在一个容器中运行,第一个 `start` 获取代理图像(参见 [在 Docker 中运行](https://npmcn.com/package/%40ai-support-agent/cli/#readme-run-in-docker)) (中文(简体) ). 添加 `--no-docker` 直接在主机上运行.

### 添加更多项目

```bash
ai-support-agent add-project          # browser OAuth flow
ai-support-agent status               # verify registered projects
```

### 从个人访问托肯开始(代理范围)

代替浏览器 OAuth 流,您可以用 **个人访问 托肯语( PAT)** 在网络应用程序中为你自己发布。 发布PAT范围 包含 `agent` 以及他们 `projectCode` 设置,然后在您自己下启动代理 权限( “个人计划 ” ):

```bash
# The tenant comes from the token; the project is given with --project.
ai-support-agent start --token <tenantCode>:<tokenId>:<rawToken> --project <tenantCode>/<projectCode>
```

-   没有浏览器登录, 没有前端 `login`编号 :`configure` 需要步骤.
-   `--api-url` 可选和默认的 API 生产(`https://api.ai-support-agent.com`) (中文(简体) ).
-   租户在 `--project` 必须匹配 PAT 的租户; 不匹配 在代理登记前被拒绝.
-   最好是通过 `AI_SUPPORT_AGENT_TOKEN` 环境变量,所以 在进程列表中没有出现( :`ps aux`) (中文(简体) ).

### 在 Docker 中运行

Docker 是默认值: plain `ai-support-agent start` 在容器中运行每个项目 `--no-docker` 选择退出本地模式.

```bash
ai-support-agent start              # Docker mode (default)
ai-support-agent start --no-docker  # run natively on the host instead
```

项目 dirs, `~/.claude/`,以及 `~/.aws/` 自动挂载。 该容器与您的主机UID/GID运行.

**基础图像.** 给定版本的第一次运行获得 `ai-support-agent:<version>`数字 :

| 情况 | 发生什么事 |
| --- | --- |
| 无自定义( 默认) | 拉动 `ghcr.io/mbc-net/ai-support-agent-cli:<version>` - 公众, `linux/amd64` + 键 `linux/arm64` ——并在当地标记(~2.6 GB压缩,所以分钟而不是一小时) |
| `~/.ai-support-agent/Dockerfile` 或捆绑的建筑资产`entrypoint.sh`, (中文(简体) ), `tmux.conf`, (中文(简体) ), `bashrc-extra.sh`, (中文(简体) ), `nvim/init.lua`, (中文(简体) ), `starship.toml`与捆绑版本不同,或 `--dockerfile` 编号 : `"dockerfilePath"` 设定 | 从您的 Dockerfile 本地构建 —— 需要数十分钟( neovim 是从源头编译的, 加上生锈的工具链和 Playwright 依赖性) |
| `--no-image-pull`,或 `"dockerImagePull": "never"` 内 `config.json` | 总是在本地构建 |
| 牵引失败( 下行, 或标签尚未发布) | 警告并回到本地,所以启动仍然成功 |

已公布的图像由此寄存器的发布工作流程构建 `docker/Dockerfile` 和相同的CLI版本, 所以对于一个未修改的设置拉和构建产生相同的图像.

一旦图像在本地存在, 它会被重新使用 —— 之后自定义 Docker 文件 **没有** 启动重建。 使用 :

```bash
ai-support-agent docker-diff-dockerfile   # compare your Dockerfile with the bundled default
ai-support-agent docker-build             # force a local rebuild after customising
ai-support-agent docker-ensure-image      # obtain the image if missing (pull or build)
```

### 作为背景服务运行

```bash
ai-support-agent service install      # install as a system service
ai-support-agent service start        # start the service
ai-support-agent service status       # check service status
ai-support-agent service stop         # stop the service
ai-support-agent service restart      # restart the service
ai-support-agent service uninstall    # remove the service
```

## 如何运作

1.  **登记册** ——特工将其能力(壳,文件一/O,聊天,终端,vscode)发送给API.
2.  **订阅** ——连接到AppSync进行实时命令发送.
3.  **配置同步** ——从服务器上拉出项目设置,MCP配置和repo列表.
4.  **执行** ——接收命令,在本地运行,溪流会逐个返回.

每个项目都按自己的儿童工序进行。 主进程监视 `config.json` 和不重新启动的热添加/删除项目.

### 支持的命令

| 命令类型 | 它会做什么 |
| --- | --- |
| `chat` | 用您的代码库上下文运行 Claude 代码( 或 Anthropic API) |
| `execute_command` | 执行带有超时和输出抓取的 shell 命令 |
| `file_read` 编号 : `file_write` 编号 : `file_list` 编号 : `file_rename` 编号 : `file_delete` 编号 : `file_mkdir` | 文件系统操作 |
| `process_list` 编号 : `process_kill` | 流程管理 |
| `chat_cancel` | 取消运行中的聊天程序 |
| `e2e_test` | 用 Playwright 浏览器自动化和步骤报告进行端到端测试执行 |
| `setup` 编号 : `config_sync` 编号 : `reboot` 编号 : `update` | 生命周期管理 |

### 聊天模式

| 模式 | 如何运作 |
| --- | --- |
| `claude_code` (默认) | Spawns Claude 代码 CLI 是一个带有 MCP 工具、系统提示和工具允许列表的子进程 |
| `api` | 直接Anthropic API流出. 要求数 `ANTHROPIC_API_KEY` |

模式解析为:代理配置 ~ 服务器默认 ~ 自动检测(是否) `claude` CLI 已安装).

### 内建的 MCP 服务器

代理船舶a [示范背景协议](https://modelcontextprotocol.io/) claude Code 可以调用的服务器:

**一般工具:**

| 工具 | 说明 |
| --- | --- |
| `get_credentials` | 从 API 获取 AWS STS 或数据库证书 |
| `db_query` | 运行 SELECT 查询( 输入保护) |
| `get_db_schemas` | 检索表/栏元数据 |
| `file_upload` | 通过预先签名的 URL 上传文件到 S3 |
| `get_project_info` | 获取工程配置 |
| `read_conversation_file` | 读取对话历史 |

**浏览器自动化工具( Playwright ) :**

| 工具 | 说明 |
| --- | --- |
| `browser_navigate` | 导航到 URL并取一个截图 |
| `browser_click` | 通过 CSS 选择器单击元素 |
| `browser_fill` | 用值填充窗体字段 |
| `browser_get_text` | 从特定元素中提取文本 |
| `browser_login` | 使用已保存的证书登录 |
| `browser_extract` | 提取文本并保存到会话变量中 |
| `browser_set_variable` 编号 : `browser_get_variable` 编号 : `browser_list_variables` | 管理会话变量 |
| `browser_close` | 关闭浏览器会话 |

**E2E 测试工具 :**

| 工具 | 说明 |
| --- | --- |
| `report_test_step` | 向 API 报告 E2E 测试步骤结果( 状态、 截图、 持续时间) |

## CLI 参考

```
ai-support-agent <command> [options]

Commands:
  start              Start the agent daemon
  stop               Stop the running agent
  login              Authenticate via browser OAuth
  add-project        Add a project (browser OAuth)
  remove-project     Remove a project by code
  configure          Register with --token and --api-url
  status             Show agent status and registered projects
  set-language       Set display language (en | ja)
  set-auto-update    Configure auto-update (--enable | --disable | --channel)
  set-project-dir    Set project working directory
  docker-login       Login and start in Docker
  docker-build       Always build the Docker image for this version locally
                     (--dockerfile <path>)
  docker-ensure-image  Make the Docker image available: pull
                     ghcr.io/mbc-net/ai-support-agent-cli when nothing is
                     customised, build locally otherwise (--dockerfile <path>,
                     --no-image-pull)
  docker-diff-dockerfile  Show diff between a Dockerfile and the bundled default
  log-rotate         Read stdin and write to a size-rotating log file
                     (used by the per-project wrapper script)
  service            Manage agent background service

Global options:
  --lang <lang>      Override display language for this invocation
  --version          Show version
```

### `service` 子命令

```
service install     Install the agent as a system background service
service uninstall   Uninstall the agent service
service start       Start the agent service
service stop        Stop the agent service
service restart     Restart the agent service
service status      Show service status

Options (install):
  --verbose          Show detailed installation info
  --no-docker        Install in native mode (skip Docker)
```

### `start` 选项

```
--token <token>            Auth token or agent-scoped PAT (overrides config file)
--api-url <url>            API URL (defaults to the production API)
--verbose                  Enable debug logging
--heartbeat-interval <ms>  Heartbeat interval (default: 60000)
--no-auto-update           Disable auto-update for this session
--update-channel <channel> Release channel: latest | beta | alpha
--no-docker                Force native mode (skip Docker)
--dockerfile <path>        Custom Dockerfile path (overrides config and bundled default)
--no-dockerfile-sync       Skip writing the default Dockerfile to config dir
--no-image-pull            Never pull the base image from the container registry;
                           always build it locally (same as config
                           "dockerImagePull": "never"). By default an
                           uncustomised Dockerfile means the published
                           ghcr.io/mbc-net/ai-support-agent-cli image is pulled
                           instead of being rebuilt on this machine
--project <tenantCode/projectCode>  Start only the matching project; with --token
                                    it selects the project for a direct (PAT) start
```

### `set-project-dir` 选项

```
--default <template>       Set default dir template (e.g. ~/projects/{projectCode})
--project <code> --path <path>  Set dir for a specific project
```

## 配置

存放于 `~/.ai-support-agent/config.json` (模式) `0600`:

```jsonc
{
  "agentId": "macbook-a1b2c3d4",       // auto-generated
  "createdAt": "2025-01-01T00:00:00Z",
  "lastConnected": "2025-06-15T09:00:00Z",
  "language": "en",                     // en | ja
  "agentChatMode": "claude_code",       // claude_code | api
  "defaultProjectDir": "~/.ai-support-agent/projects/{projectCode}",
  "autoUpdate": {
    "enabled": true,
    "autoRestart": true,
    "channel": "latest"                 // latest | beta | alpha
  },
  "projects": [
    {
      "projectCode": "MY_PROJECT",
      "token": "agt_xxxx",
      "apiUrl": "https://api.ai-support-agent.com",   // defaults to the hosted API
      "projectDir": "~/custom-path"     // optional override
    }
  ]
}
```

### 环境变量

| 变量 | 说明 |
| --- | --- |
| `AI_SUPPORT_AGENT_TOKEN` | 覆盖认证符( 最低优先级) |
| `AI_SUPPORT_AGENT_API_URL` | 覆盖 API URL( 最低优先级) |
| `AI_SUPPORT_AGENT_CONFIG_DIR` | 覆盖配置目录路径 |
| `AI_SUPPORT_AGENT_TERMINAL_GRACE_MS` | 在WebSocket断开之后的 PTY 宽度窗口,以毫秒计(正整数;默认为3,600,000=60分). 与 API 侧同步 `TERMINAL_SESSION_GRACE_MS` |
| `AI_SUPPORT_AGENT_ALLOW_HTTP` | 设定为 `true` 允许非 HTTPS API URL( 只开发) |
| `ANTHROPIC_API_KEY` | 所需经费 `api` 聊天模式 |
| `CLAUDE_CODE_OAUTH_TOKEN` | Claude Code OAuth 令牌; 如果设置在主机上, 则传递到多克容器( 通常由服务器发送) |
| `AI_SUPPORT_AGENT_IN_DOCKER` | 自动设定为 `1` 在多克容器内 |
| `AI_SUPPORT_AGENT_PROJECT_DIR_MAP` | 主机到容器项目目录映射( 自动以 Docker 模式设置) |
| `AI_SUPPORT_AGENT_TENANT_CODE` | MCP 服务器进程的租户代码( 自动设置) |
| `AI_SUPPORT_AGENT_PROJECT_CODE` | MCP 服务器进程的项目代码( 自动设置) |
| `AI_SUPPORT_E2E_EXECUTION_ID` | E2E 测试执行 ID (在 `e2e_test` 运行) |
| `AI_SUPPORT_E2E_TEST_CASE_ID` | E2E 测试大小写 ID (在 `e2e_test` 运行) |

优先级: CLI 旗 > 配置文件 > 环境变量.

## 项目目录结构

每个项目都有一个孤立的工作空间:

```
{projectDir}/
├── workspace/
│   ├── repos/          # Git-cloned repositories
│   ├── docs/           # Documentation from server
│   └── artifacts/      # Generated outputs
├── uploads/            # File uploads staging
└── .ai-support-agent/
    ├── cache/          # Temporary cache
    └── aws/            # AWS credential cache
```

## 警卫

| 层 | 细节 |
| --- | --- |
| 认证 | 基于浏览器的 OAuth 有本地host 回调, CSRF 非ce |
| 配置文件 | 模式 `0600`,目录 `0700` |
| 路径倒转 | 被屏蔽的路径 : `/root`, (中文(简体) ), `/etc`, (中文(简体) ), `/sys`, (中文(简体) ), `/proc`, (中文(简体) ), `/dev`, (中文(简体) ), `~/.ssh`, (中文(简体) ), `~/.aws`等 (中文(简体) ). |
| SQL 注射 | 基于模式的检测:评论,基于时间的盲点,编码绕行,文件系统访问 |
| 子进程嵌入 | 产子过程前的敏感变量剥离 |
| 文件传输 | 扩展允许列表(53类), `basename()` 消毒术 |
| Git 业务 | 防止 CLI 注射的分支名称验证 |
| 容器图像 | 调出 `ghcr.io/mbc-net/ai-support-agent-cli`,由这个寄存器的发布工作流程发布,只有当多克文件及其构建资产没有被修改时; `--no-image-pull` 或者说 `"dockerImagePull": "never"` 强迫一个地方建筑代替 |

## 发展

```bash
git clone https://github.com/mbc-net/ai-support-agent-cli.git
cd ai-support-agent-cli

npm install
npm run dev -- start --verbose    # development mode
npm test                          # run tests
npm run test:cov                  # coverage (95%+ thresholds enforced)
npm run build                     # compile to dist/
```

需要节点.js >= 20. `node-pty` 是终端/ PTY 会话的可选依赖.

## 许可证

[麻省理工学院](https://npmcn.com/package/%40ai-support-agent/cli/LICENSE)

## 错误

`auth login/logout` 页:1 `env check/run/pull` で承認済み環境設定を利用できます [{\\fn黑体\\fs22\\bord1\\shad0\\3aHBE\\4aH00\\fscx67\\fscy66\\2cHFFFFFF\\3cH808080}你应该知道](https://npmcn.com/package/%40ai-support-agent/admin-docs/docs/architecture/environment-vault.md) を参照してください。

### `.env`を使うローカル開発(日本語)

空虚 API\\Web\\Voult `local` の設定リリースを承認・有効化します。利用者にはファイル出力用の `export` 権限を付与してください。

開発プロジェクトの `.ai-support/env.yaml` に接続先と識別子を設定します。秘密値はここへ書きません。

```yaml
version: 1
apiUrl: https://api.example.test
tenant: example
project: support
profiles:
  local:
    service: api
    environment: local
    required: [DATABASE_URL]
```

`.gitignore` に `.env.local` 乌尔勒。

```sh
ai-support-agent auth login --url https://app.example.test --profile local --purpose export
# ブラウザーでログインし、設定取得を許可します。
ai-support-agent env pull --profile local --output .env.local
ai-support-agent auth logout --profile local --purpose export
```

`.env` 吉蒂格诺雷 `run` 権限を付与し、`--purpose export` を付けずにログインして `ai-support-agent env run --profile local -- npm run dev` を実行します。

### 空虚 :

`auth login --purpose edit --session-duration 8h` で編集用ログインを行い、 `env add LOG_LEVEL --value debug`编号 :`env set LOG_LEVEL --value info` で未承認の候補を作成します。 国 家 `--from` へ指定します。秘密値は `--secret` の非表示入力、または `--secret --stdin` を使用します。秘密値を `--value` に渡すことは禁止しています。 標準入力の末尾改行は保持し、除去する場合のみ `--strip-final-newline` を指定してください。

`env diff --release <ID>` → `env approve --release <ID>` → `env stage --release <ID> --target <ID>` → `env activate --release <ID> --expected-active <現在のID>` 同意部署。 初回有効化の `--expected-active` 有问题吗 `none`地方阶段。 本番では変更参加者による自己承認を拒否します。

本地 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++。 {\\FN黑体\\FS22\\BORD1\\SHAD0\\3AHBE\\4AH00\\FSCX67\\FSCY66\\2CHFFFFFF\\3CH808080}你觉得呢 自動更新はしません。実行用リースは別管理のままです。 国 家 `env status --operation-id <ID> --purpose <用途>` で確認し、 同じ要求を再送する場合だけ同じ `--operation-id` を使用します。再送可能期間は24時間です。

## E2E 配置迁移

在部署此代理之前先部署带有指令范围E2E配置端点的API. 每个 E2E 执行模式在开始前都会执行一个命令约束的录入检查;代理从不回落到旧的只环境端点. 完成时在终端命令结果提交后使用单独的确认. 失败确认保留原始结果进行重试 .

当一个孩子仍在运行,终止使用信号/ kill/timeout,或浏览器会话清理失败时,配置录入仍然活跃. 正常的完成依赖于被支持的跑者普通浏览器/工人被撕毁;脚本不能拆分出背景过程. 历史工作和独立离散的后代在v2迁移前需要经过核实的操作员关闭. 仅凭最终执行状态并不能证明这些过程已经停止.

### 服务器设置配置完成

服务器设置结果交付和配置录入关闭是单独的确认. 代理商在等待结果的同时坚持有目地观察的完成证据 普通结果先提交 `/agent/commands/:id/server-setup-configuration-complete`。 。 。 . 遗失的确认保留原始结果、证据、实例身份和转让 用于重试。 API在接受终端结果后必须支持相同的结果重放. 此协议不扩展托肯; 过期的证书需要操作员调节 .

自动普通补全目前覆盖直接同步调试/ sassert/ set fact, 复制/文件/行内文件/块状文件/重置/stat/get url/组/用户/等待和授权的 key 模块,在成功完成 Ansible 进程和有效任务输出后。 同步/投放/通知 并排除任意验证命令。 Shell/ 命令任务和未审计的捆绑 即使UI报告成功,角色仍未解决. 他们的远程终止必须是 在配置切换前调节 。 继续运行的预定服务守护进程是 - 扩大自动覆盖范围需要审计 菜谱的任务生命周期,而不是要求所有服务停止.

哨兵完成使用专用远程状态探测器,需要明确 `settled: true`, (中文(简体) ), `active: false` 和匹配的安装运行ID。 单独成功的回收行动 保留可观察到的远程运行ID,用于主机扫描服务器对接. 混合食谱必须 也具有同步可认证的伴奏任务,并且没有超时或 取消 。 SSH 丢失, 缺失的探针字段, 仅局部进程终止, 和 UI 终端 状态从来不是远距离哨兵终止的证据.

每项设置索赔还附有: `x-server-setup-instance-id`,命令前生成 检索并保留待决结果。 恢复原始结果 身份; 重新启动的进程不得再次获取和执行命令。 居民 继续独立检查任务生成和复制身份. 跑步记录 `data.serverSetupLocalTermination` 只有在Ansible孩子出生后 观察 `close` 事件,不包括产卵失败;仅执行文件错误回调是不够的。 这是 当地终止的证据,包括在实际关闭的暂停/终止之后 ;不能确定远程终止。 恢复先前的哨兵收容 必须将其经认证的已保存的本地证据与适当范围远程证据结合起来. 没有这种证据的遗产处决仍然无法进行操作者和解.

哨兵入场关闭还需要原Ansible跑道成功完成. 取消、 超时或其他执行失败后解析的远程快照不会 排除已经分发的延迟远程启动。 这种接纳仍未得到解决 直至有较强的远程围栏或经独立核实的行动终止.

## 常见问题

### @ai-support-agent/cli 是什么？

AI 支持代理 CLI 客户端

### 如何安装 @ai-support-agent/cli？

在项目目录运行 npm install @ai-support-agent/cli，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 ai-support-agent，可以用 npx ai-support-agent 直接运行。

### @ai-support-agent/cli 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @ai-support-agent/cli 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @ai-support-agent/cli 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=20\.0\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @ai-support-agent/cli 可以商用吗？

@ai-support-agent/cli 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @ai-support-agent/cli 的下载量有多少？

根据 npm 官方下载统计，@ai-support-agent/cli 在 2026/10/05 – 2026/11/03 这 30 天内被下载 2,817 次，日均约 94 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @ai-support-agent/cli 还在维护吗？

最新版本 0\.5\.16 发布于 2026/10/23（15 天前）；至今共发布 401 个版本，其中过去 12 个月发布了 401 个；首次发布于 2026/02/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。