# @brutalsystems/muster 中文文档

规范地址：https://npmcn.com/package/%40brutalsystems/muster/

版本：3\.16\.1
npm 元数据更新时间：2026-11-03T21:14:11.112Z
中文译文更新时间：2026-11-08T16:52:53.536Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40brutalsystems/muster
原文对照：https://npmcn.com/package/%40brutalsystems/muster/?lang=original
项目主页：https://github.com/BrutalSystems/muster#readme
源码仓库：https://github.com/BrutalSystems/muster

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

- 包体积（解压后）：600 kB，72 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=22\.12
- 运行依赖：4 个
- 首次发布：2026-09-19T16:42:07.266Z
- 最新版本发布：2026-11-03T21:14:10.737Z
- 近 30 天下载量：4800（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：74（近 12 个月 74 个）

## 中文简介

指令发射,可到达的本地代理会话

## 安装

```sh
npm install @brutalsystems/muster
```

也可以使用：`pnpm add @brutalsystems/muster`、`yarn add @brutalsystems/muster`、`bun add @brutalsystems/muster`

## README

![](https://npmcn.com/package/%40brutalsystems/muster/docs/assets/muster-logo.png)

# 战斗

[![license](https://img.shields.io/github/license/BrutalSystems/muster)](https://npmcn.com/package/%40brutalsystems/muster/LICENSE)

**在你的机器上发射编码器 在你选择的封存下 返回一个您可以实际联系的地址.**

Muster代表您开始Claude Code, Codex和OpenCode会话. 你说 muster安排 核实会话是真的 活着,给你一个永久的地址 如果一个会议永远不会变成 可达到的,你得到一个诊断 命名什么阻止它 而不是一个过程看起来 好吧,没有.

这是一个小家庭的半个家庭: 动员启动特工, [锡罐](https://github.com/BrutalSystems/tincan) 让他们互相传达, [鸟犬](https://github.com/BrutalSystems/birddog) 看着他们做什么.

## 是为了什么

故意经营一个以上的特工 一次复议,另一次复议 构建; 一次运行并捕捉其输出的任务; 在一个 独立账户,所以它的工作 从来没有触及到你自己的配置。 战斗是 使这些发射能够重复、控制和处理,而不是 您必须记住一个终端标签 .

A 类 `session` 返回仅在运行时间可达之后的地址。 A 类 `task` 运行一次,抓取输出,从不发布对等地址.

## 是什么让它不同

-   **封存是两个独立的问题,两者都得到了回答.** 是否为 代理停止问你, 以及它会触碰什么—— 第二个由OS执行, 不是通过问得好。 每一次发射都记录着它实际得到的两枚中哪一枚.
-   **据报道,届会只有在可以达到时才准备就绪.** Muster 询问每个 用自己的语言运行时间——会话记录,RPC呼叫,HTTP终点 ——并不会将"开始的过程"与"代理在听"混淆.
-   **它拒绝而不是猜测.** 一面无法辨认的旗帜 一面自相矛盾的一面 选项中,属于不同运行时间的身份:所有错误,在 任何东西都是开始的。 任何半个发射装置都没有留下.
-   **其他机器可以问, 在你设定的限度内.** 注册的呼叫器发射 在配置图的天花板内——它可能使用的目录,最强 控制它可能要求。 配置是授权; 请求永远不会 把它拓宽.
-   **这里的每一项索赔都经过测量.** 运行时间行为由 驾驶真实的程序,记录他们的行为——见 [核查](https://npmcn.com/package/%40brutalsystems/muster/docs/verification.md)如果后来发现错误 更正在发行说明中,而不是悄悄地编辑.

Claude 需要一个操作员已经信任的目录,或者 `--options auto-approve-path`。自动套房使用假运行时间,而非真实 模型; 对真实模型的行为进行手工核查并记录在 `RELEASE_NOTES.md`。 。 。 .

## 快开始

```sh
# Allow the install scripts: muster's postinstall builds node-pty, and npm
# skips install scripts by default — silently, so the pty host fails later.
npm install -g --allow-scripts=@brutalsystems/muster,node-pty @brutalsystems/muster

# A session: an agent you can reach, addressed once it is genuinely alive.
muster run claude --prompt 'Review this project' --cwd .

# A task: runs once, captures output, advertises nothing.
muster run codex --kind task --prompt 'Summarise the failing tests' --read-only
muster output <id>

# Knowing it has finished: block on it, or have muster run a command then.
muster wait <id> --timeout 30m
muster run codex --kind task --prompt 'Review' --on-exit 'notify "$MUSTER_STATE"'

# What is running, and stopping it.
muster list --format human
muster stop <id>

# Show a session in a terminal: terminal, iterm2, ghostty, or one you define
# under [open.apps] in config.toml (see docs/launching.md).
muster run claude --prompt 'Review this project' --open kitty
```

**克劳德发射场没有防弹旗 开的跟你开的一样 手动** 在简介和文件夹。 它得到你的规则和CLAUDE,MD,你的 权限、钩子、状态行、插件、MCP服务器和设置 `env`。 。 。 . Muster没有添加任何东西,也没有替换任何东西. 唯一拒绝的就是档案 默认权限模式被绕过。 Codex 和 OpenCode 保留只读 默认.

当你想要得到募捐担保时, **密封** 发射 密封发射 运行在“ 集合” 本身的设置上, 以代替配置文件的设置, 因此它不装入规则 或CLUDE.MD: (中文(简体) )

| 旗帜 | 代理在行动前问 | 它会触摸到什么 |
| --- | --- | --- |
| `--read-only` | 永远 | 无磁盘 |
| `--write-here` | 没有 | 其阴茎,但 `~/.muster` |
| `--unrestricted` | 没有 | 所有的东西 |

`--unrestricted` 删除沙盒和需要 `allow_dangerous_flags` 内 相会. `--level read|work|open` 是同一个三和 还行.

克劳德第一次要求信任一个目录. 这是一次审查你 做你自己 - 或 `--options auto-approve-path`,它记录在你之后 检查目录 船没有钩子。 见 [克劳德工作空间信托](https://npmcn.com/package/%40brutalsystems/muster/docs/claude-trust.md)。 。 。 .

## 所需资源

**22.12+ 节点** (测试于24: 16),和一个POSIX主机 `ps` 财务报告和审定财务报表 `lsof`。 。 。 . 终端使用tmux或节点-pty. OS沙盒是安全带 所以内核加固 封存只包含macOS; 其他任何地方 `enforcement` 报告什么 而不是假装.

然后,无论你想发射,安装和登录的代理。 已验证 反对 **Claude 代码 2.1.274**, (中文(简体) ), **代码 0.155.1** 财务报告和审定财务报表 **打开代码 1.18.31** 或者说 更新的——更新的OpenCode必须保留CLI并回放HTTP API Muster的使用. 核查范围包括: [核查](https://npmcn.com/package/%40brutalsystems/muster/docs/verification.md)。 。 。 .

## 文档

|  |  |
| --- | --- |
| [发射如何运行](https://npmcn.com/package/%40brutalsystems/muster/docs/launching.md) | 主机、终端、寿命、重复请求 |
| [配置和权限](https://npmcn.com/package/%40brutalsystems/muster/docs/permissions.md) | 封装、配置文件、远程呼叫器 |
| [代理身份](https://npmcn.com/package/%40brutalsystems/muster/docs/identities.md) | 作为命名账户运行 |
| [克劳德工作空间信托](https://npmcn.com/package/%40brutalsystems/muster/docs/claude-trust.md) | 一次对话, 和后面的两个门 |
| [命令行引用](https://npmcn.com/package/%40brutalsystems/muster/docs/cli.md) | 输出格式, 运行时间通过 |
| [MCP 服务器和插件](https://npmcn.com/package/%40brutalsystems/muster/docs/mcp.md) | 用于启动代理的工具,以及Muster自己的MCP服务器 |
| [核查](https://npmcn.com/package/%40brutalsystems/muster/docs/verification.md) | 测试什么,手检查什么 |

## 用克劳德代码

1.  **安装插件 .** 内容 `muster` 技能教克劳德会话使用 集合好:选择一种和水平,达到并阻止它 发射,和陷阱。 它还带来Muster的MCP服务器,只读 (单位:千美元)`list`, (中文(简体) ), `output`),从 `npx` 在发布时,插件来自. 两者都以"Muster"为版本,因此它们描述并运行同版.
    
    ```sh
    claude plugin marketplace add BrutalSystems/muster
    claude plugin install muster@muster
    ```
    
    或者,在一个会话中, `/plugin marketplace add BrutalSystems/muster` 财务报告和审定财务报表 接下来 `/plugin install muster@muster`。 。 。 .
    
    插件服务器需要22.12+节点 `npx` 在路径。 关于macOS和 Windows,节点-pty加载一个预建的二进制. 在Linux上, `npx` 新建节点 从源头第一次, 这需要Python, `make` 和 C++ 编译器; 使用全局安装和第二步代替.
    
2.  **或者自己注册MCP服务器**,当你想获得发射权时,或 一个运行您全局的服务器 `muster`数字 :
    
    ```sh
    muster mcp install
    ```
    
    它也是默认只读的. `muster mcp install --allow-launch` 添加 `run`, (中文(简体) ), `stop`, (中文(简体) ), `title` 财务报告和审定财务报表 `open`,那么,该简介中的每个会话都可以 发射和停止会话. `muster mcp status` 显示您拥有的。 使用 插件的服务器或此服务器, 而不是两者: 见 [插件或注册](https://npmcn.com/package/%40brutalsystems/muster/docs/mcp.md#the-plugins-server-or-your-own)。 。 。 . 细节 : [MCP 安装](https://npmcn.com/package/%40brutalsystems/muster/docs/mcp.md#mcp-installation)。 。 。 .
    
3.  **重新启动 Claude 代码** (或开始新会话)来加载.
    

## 不断更新

发布发布时不触摸已安装的副本 : `muster --version` 保留 报告旧版本直到更新.

```sh
npm update -g @brutalsystems/muster
```

若为 `which muster` 解决版本管理 shim( 例如) `~/.asdf/shims/muster`),在节点下运行该更新,shim决心并 之后,他又说: `asdf reshim nodejs` - 或者shim不停地指着旧的 二进制.

插件, 以及它贴入的服务器, 更新市场 :

```sh
claude plugin marketplace update muster
claude plugin update muster@muster
```

MCP 服务器在会话启动时启动一次, 所以代理会话已经启动 已装入的 Muster 继续运行旧的二进制, 直到该会话重新启动 . 在磁盘上更新是不够的; 重新启动会话 .

## 在当地建立和运行

`npm run check` 是当地的大门:它建造,运行套房,然后包装 校对:soup `scripts/check-tarball.mjs` cI 包装工作 运行,所以两人不能对"验证"的含义有分歧. `npm test` 一个人 不打包任何东西, 所以柏油球漂移是绿色的 局部和红色在推.

这不是CI所做的一切:CI额外运行整个节点的套房 版本矩阵,合同套件只在发布时运行. 通过 `check` 实值 有必要而不是足够.

除以上运行时间要求外,建设需要TypeScript 5. 这个 终端接口本身是平台中立的;macOS终端驱动程序是 无法使用 v1 根根 .

```sh
npm ci
npm run build
node dist/muster.js run codex --prompt 'Review the authentication flow'
node dist/muster.js run claude --prompt 'Summarize the project' --host tmux
node dist/muster.js run opencode --prompt 'Review this project'
node dist/muster.js run opencode --prompt 'Build a plan' -- --model local-provider/qwen3-30b
node dist/muster.js run codex --kind task --prompt 'Explain the test layout'
node dist/muster.js run opencode --kind task --prompt 'Summarize the tests'
node dist/muster.js list
node dist/muster.js list --format human
node dist/muster.js list --kind task
node dist/muster.js output RUN_ID
node dist/muster.js stop THREAD_OR_SESSION_OR_RUN_ID
```

`--prompt` 需要且不能为空白. `--cwd` 默认为当前 工作目录. `--kind` 默认为 `session`。除此之外的所有命令 `output` 释放JSON; `output` 打印抓取的任务输出. `stop` 还接受 明确同龄人的姓名或名称,拒绝与候选人含糊不清. 使用持久 ID 停止运行时间已重命名的会话 .

## 许可证和释放

麻省理工学院 2026 Brutal Systems. 见 [自由主义](https://npmcn.com/package/%40brutalsystems/muster/LICENSE). 销售的锡罐码 保留源属性及其属性 [麻省理工学院通知](https://npmcn.com/package/%40brutalsystems/muster/TINCAN_LICENSE)。 。 。 .

发布由标签驱动, 运行在 GitHub 动作中, 运行在 OIDC 上 发布, 没有存储 npm 令牌 。 一个赤裸的 `git push` 无发布; a 版本标记是触发的 `publish.yml`该工作流程验证a [相关内容:](https://npmcn.com/package/%40brutalsystems/muster/RELEASE_NOTES.md) 页:1 因此,将注释写入 `## Unreleased` 就像你一样 并让他们正常工作。 切除释放是命令之一:

```sh
git commit -am "<the change, including its notes under ## Unreleased>"
npm version patch -m "%s — <what changed>"
```

`npm version` 运行 `version` 钩子,哪个邮票 `## Unreleased` 输入 `## <version> — <date>` 并分级,然后折叠 `postversion` 钩子推动承诺 并标记在一起。 如果没有 `## Unreleased` 区域,或者是空的,邮票拒绝——在标记之前 存在,而不是在CI中被推后.

[相关内容](https://npmcn.com/package/%40brutalsystems/muster/RELEASING.md) 覆盖版本、软件包检查、出版、, 并全文发布笔记。 更改共享地址格式需要明确 合同更新; Muster 从未独立修复被冻结的命名行为.

## 常见问题

### @brutalsystems/muster 是什么？

指令发射,可到达的本地代理会话

### 如何安装 @brutalsystems/muster？

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

### @brutalsystems/muster 支持 TypeScript 吗？

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

### @brutalsystems/muster 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @brutalsystems/muster 需要什么版本的 Node\.js？

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

### @brutalsystems/muster 可以商用吗？

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

### @brutalsystems/muster 的下载量有多少？

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

### @brutalsystems/muster 还在维护吗？

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