# @asiainfo-sdd/multica-cli-test 中文文档

规范地址：https://npmcn.com/package/%40asiainfo-sdd/multica-cli-test/

版本：0\.3\.16
npm 元数据更新时间：2026-11-07T10:54:35.529Z
中文译文更新时间：2026-11-06T23:18:52.250Z
软件包许可：UNLICENSED

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

原始 npm 页面：https://www.npmjs.com/package/%40asiainfo-sdd/multica-cli-test
原文对照：https://npmcn.com/package/%40asiainfo-sdd/multica-cli-test/?lang=original

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

- 包体积（解压后）：44.1 kB，10 个文件
- TypeScript 类型：未声明
- Node.js 要求：\>=18
- 运行依赖：0 个
- 首次发布：2026-10-23T03:12:12.259Z
- 最新版本发布：2026-11-07T10:54:35.247Z
- 近 30 天下载量：2627（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：16（近 12 个月 16 个）

## 中文简介

数字工厂 daemon 客户端安装帮助包（测试环境）：连接测试环境服务器与测试环境二进制下载源

## 安装

```sh
npm install @asiainfo-sdd/multica-cli-test
```

也可以使用：`pnpm add @asiainfo-sdd/multica-cli-test`、`yarn add @asiainfo-sdd/multica-cli-test`、`bun add @asiainfo-sdd/multica-cli-test`

## README

# @asiainfo-sdd/multica-cli — multica（daemon 客户端）安装帮助包

通过 npm 安装数字工厂 multica 命令（daemon 客户端二进制，含主机线能力）。 **本包负责安装二进制与部署级配置**：npm install 时按平台自动下载、sha256 校验、落位， 并把 `server_url` / `app_url` 合并写入 `~/.multica/config.json`（只填空，不覆盖已有值）； **不写 token、不登录、不启动/停止 daemon**——个人凭据与 daemon 生命周期始终由用户掌控。

## 部署级配置的取值优先级

```
MULTICA_SERVER_URL / MULTICA_APP_URL 环境变量（安装时）
  > manifest.json 顶层 server_url / app_url（运维改下载源即可，无需重发 npm 包）
  > 包内 lib/dist-config.json（发布时按 profile 固化）
```

二进制下载源基址同样三级：`MULTICA_DOWNLOAD_BASE` 环境变量 > manifest 对应环境的 `lib/dist-config.json` 的 `download_base` > 包内置默认。

用户 `~/.multica/config.json` 中已有的值**一律不覆盖**，仅提示。

## 适用人群与前置

-   内网办公电脑/服务器上的开发者，机器可访问下载源（可覆盖）
-   已安装 Node.js ≥ 18 与 npm
-   支持平台：darwin / linux / windows × amd64 / arm64

## 安装

```bash
# 全局安装（推荐：npm 全局 bin 目录已在 PATH）
npm i -g @asiainfo-sdd/multica-cli

# 或项目内安装（用 npx 调用）
npm i @asiainfo-sdd/multica-cli
npx multica version
```

安装完成后按提示自行完成剩余步骤（若下载源已带 server\_url 则只需两步）：

```bash
multica config set server_url https://<服务器地址>   # 仅当安装时未自动写入
multica login --token mul_<个人令牌>                  # 令牌在 Web 端“设置→令牌”生成
multica daemon start                                 # 需本机已装至少一个 agent CLI（claude/codex/opencode…）
```

日常管理：`multica daemon status` / `multica daemon logs` / `multica daemon stop`。

## 环境变量

| 变量 | 作用 |
| --- | --- |
| `MULTICA_DOWNLOAD_BASE` | 覆盖二进制下载源基址（源根需有 `manifest.json` 与 `v<版本>/` 目录） |
| `MULTICA_SERVER_URL` / `MULTICA_APP_URL` | 安装时写入 `~/.multica/config.json` 的部署级配置（优先级高于 manifest 与包内置；不覆盖已有值） |
| `MULTICA_SKIP_BINARY_INSTALL=1` | 跳过 postinstall 下载（`--ignore-scripts` 环境或自备二进制时用） |
| `http_proxy` / `https_proxy` / `NO_PROXY` | 走内网代理时识别（Node 自带 fetch 不认这些变量，本包已自实现） |

## 故障恢复

| 症状 | 处理 |
| --- | --- |
| 安装时看不到“上手”提示 | npm ≥ 7 默认隐藏 postinstall 输出（脚本失败时才显示）；加 `--foreground-scripts` 参数即可看到，或安装后执行 `multica version` 确认可用 |
| 执行 `multica` 提示二进制未下载 | `npm rebuild @asiainfo-sdd/multica-cli`（常见于 `--ignore-scripts` 安装或当时下载源不可达） |
| 提示“multica 不是命令” | 重新打开终端；或用 `npx multica ...` |
| 升级时提示文件被占用 | daemon 正在运行：先 `multica daemon stop`，再 `npm i -g @asiainfo-sdd/multica-cli@<版本>` |
| 下载源不可达 | 确认 `MULTICA_DOWNLOAD_BASE`；检查代理变量 |

## 升级

```bash
npm i -g @asiainfo-sdd/multica-cli@<新版本>
```

npm 包版本与二进制版本一一对应；postinstall 检测到版本变化会重新下载。 daemon 的 auto-reload 默认开启：二进制替换后运行中的 daemon 会自动重启到新版本。

## 卸载

**用 `multica-uninstall`，不要只用 `npm un -g`**。原因：

-   npm v7 起不再执行 `preuninstall` 等卸载生命周期脚本，`npm un -g` 只能移除 npm 包， 不会停 daemon、不会删 `~/.multica` 配置、也不会删独立安装的 `~/.local/bin/multica`；
-   同机可能同时存在多个 npm 全局目录（nvm prefix、`%APPDATA%\npm`、历史 prefix）， 而 `npm root -g` 只报当前一个 —— 会出现“卸了还能用”。

`multica-uninstall` 一次覆盖全部安装产物：

```bash
multica-uninstall            # 交互确认后卸载
multica-uninstall --yes      # 非交互（脚本/CI）
multica-uninstall --keep-config   # 保留 ~/.multica（保留登录令牌与配置）
multica-uninstall --dry-run  # 只打印将执行的操作，不改动任何文件
```

执行内容依次为：停 daemon → 删 `~/.multica`（除非 `--keep-config`）→ 删独立二进制 `~/.local/bin/multica[.exe]` → 删 PATH 上的命令入口（npm shim）→ 逐个前缀卸载 npm 全局包。

卸载后请**重开终端**以确保 PATH 刷新；再执行 `multica version` 应提示命令不存在。

> 若某 npm 包因文件占用未能删除（Windows 常见），脚本会打印出对应 `npm uninstall -g --prefix <prefix> <包名>` 命令，重开终端后手动执行即可。

## 版本发布（维护者）

本包位于 multica 仓 `apps/multica-cli-installer/`（与 `server/` 同仓管理，随主仓 git 提交发布）。 同一份源码按 profile 发布两个 npm 包（差异仅包名与内置部署级配置），发布流程：

1.  本仓 `server/extensions/agentfoundry/build/build.sh cli-all <版本>`： 6 平台 CLI 产物 + `manifest.json` 落 `server/extensions/agentfoundry/dist/cli/`
2.  如需随包分发部署级配置，在 `manifest.json` 顶层加 `server_url` / `app_url`
3.  将 `dist/cli/` 整目录同步到目标环境下载源的 HTTP 静态根（MinIO `daemon-download/` 前缀）
4.  在 `apps/multica-cli-installer/` 下按 profile 发布：
    -   生产包：`node scripts/publish.mjs prod [版本]`
    -   测试包：`node scripts/publish.mjs test`（连接测试环境，配置见 `publish/profiles.json`）
    -   加 `--dry-run` 只打 tarball 检查，不实际发布
5.  版本号在源 `package.json` 上推进（`lib/dist-config.json` 保持生产默认值；测试包的差异由 profile 注入）

> 两包 bin 命令名均为 `multica`，同一台机器互斥安装；切换环境用 `npm rm -g <A> && npm i -g <B>`，安装时会自动覆盖式更新 `~/.multica/config.json` 的 server\_url/app\_url 并提示（token 需重新登录生成）。

## FAQ

**Q: 为什么不把二进制打进 npm 包？** 每个平台 17-68MB，6 平台约 200MB；HTTP 运行时下载让 npm 包保持 KB 级，且安装哪台机器才拉哪个平台。

**Q: postinstall 下载失败了怎么办？** 安装不会失败到阻断——失败时打印修复指引，之后 `npm rebuild @asiainfo-sdd/multica-cli` 重试。

**Q: daemon 会自动升级吗？** self-host 场景下 daemon 的 auto-update 默认关闭；升级由你通过 npm 主动控制。

## 常见问题

### @asiainfo-sdd/multica-cli-test 是什么？

数字工厂 daemon 客户端安装帮助包（测试环境）：连接测试环境服务器与测试环境二进制下载源

### 如何安装 @asiainfo-sdd/multica-cli-test？

在项目目录运行 npm install @asiainfo-sdd/multica-cli-test，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 multica、multica-uninstall，可以用 npx multica 直接运行。

### @asiainfo-sdd/multica-cli-test 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/asiainfo-sdd\_\_multica-cli-test 是否存在。

### @asiainfo-sdd/multica-cli-test 需要什么版本的 Node\.js？

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

### @asiainfo-sdd/multica-cli-test 可以商用吗？

@asiainfo-sdd/multica-cli-test 使用 UNLICENSED 许可。作者声明为 UNLICENSED，即不授予公开使用许可（与公共领域的 Unlicense 不同）。使用前需获得作者授权。以上为概括，不构成法律意见，请以许可原文为准。

### @asiainfo-sdd/multica-cli-test 的下载量有多少？

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

### @asiainfo-sdd/multica-cli-test 还在维护吗？

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