@futurelastic/muster

中文文档
0.20.0发布于 2026/11/17MIT零依赖构建来源已验证近 30 天下载 2.1万

fuser——一个拥有整个舰队的会话代理的机器-局部服务. 启动器:运行此平台的预建二进制 .

中文使用文档
文档目录12 节
  1. 这到底能解决什么问题
  2. 它永远不会拥有的东西
  3. 不寻常的部分
  4. 安装
  5. 快速启动
  6. 一台机器
  7. 两台机器
  8. 它为谁服务
  9. 版式
  10. 文档
  11. 向甚么处去
  12. 许可证

挂载

您运行的每一次编码代理会话都有一个 API 他们正在运行.

去吧,只有标准库,没有依赖性 麻省理工学院.

你有编码代理在终端运行。 可能有几个 也许更多 不止一个机器。 现在唯一知道他们在做什么的方法就是 看看它, 唯一的答案是走过去.

muster 是一个机器本地服务 拥有 这些会议和安排 在HTTP API 后面 列出它们, 读读每个状态, 发送一个 指令,请回答一个被卡住的权限对话框 。 同行实例 联邦,所以一个会议 在机器在另一个房间是 一个呼叫离开和 看起来像一个当地人.

flowchart TB
    C["supervisors & clients<br/>dashboard · CLI · your program"]

    subgraph MA["machine-a"]
        S["muster<br/>HTTP API"]
        DT["tmux driver"]
        DO["opencode driver"]
        DR["remote driver"]
        CLI["agent CLI<br/>in tmux"]
        SUB["agent subprocess"]
    end

    subgraph MB["machine-b"]
        P["peer muster"]
    end

    C -- "HTTP + bearer token" --> S
    S --> DT --> CLI
    S --> DO --> SUB
    S --> DR -- "HTTP · LAN / VPN" --> P

    classDef hop stroke-width:2px,stroke-dasharray:6 4
    class DR,P hop

会话驱动程序是一个接口 。 远程对等器只是另一个驱动器 因此,联邦没有增加任何费用.


这到底能解决什么问题

一组编码代理需要两个可以分离的东西: 什么样的工作应该发生和一些知道的东西 如何是会话 实际运行和在哪里多数执行都使它们成为引信——主管壳 打开终端多路器,刮出屏幕以猜测代理是什么 进行,从而永久地约束在一个主机上运行一次。 (调查 可比较的项目,以及该分拆购买的: docs/positioning.md. ) (中文(简体) )

muster 是后半段, 提取。 监督员成为客户.

一项裁决中有三个财产:

  • 运行时间独立. 驱动程序是一个接口,而不是硬码 子进程。 三个今天存在: 一个终端多路驱动交互 代理CLI,第三方代理 孵化为子进程 并交谈过 HTTP,还有另一台机器上的对等服务.
  • 机器对机器是免费的. 远程对等器是 只是另一个司机此处 并不是要建立单独的联邦特征.
  • 楚恩是被控制. 当运行时间在你身后变化时,损坏 开着一个司机而不是到处跑.

最后一个比看起来更重要 抽象的值不会 取决于任何特定的运行时间是好的;这是赌注的一个 买得起的.

它永远不会拥有的东西

版本控制状态、工作树、问题跟踪器、工作要求、规划或任何 判断工作是否已经完成.

muster知道一个会话有一个工作目录. 它不知道什么是工作树.

一个了解问题所在的分舰队 成了第二个主管 现在有两个部分认为他们负责 测试此 API 中的每个字段 反对这句话.

这对消费者意味着什么——一个声称发行,产卵会的仪表板 并且合并了分支,比如说—— 依赖是以一种方式运行的:

  • 工作词汇在上方分层,从未被推倒. 一个需要的消费者 储存库、问题、索赔、工作树木、锁或租约保存着它们。 这个 这里只有不透明 调用者提供的字段才有词汇 marker 会话创建和会话 labels,设置在创建或更改时 后来——服务在大小、载体和返回方面没有限制 解释.
  • 消费者的特征探测和降解. 机器能做的是读,不是 假设: GET /v1/runtimes 说哪些时间有线 build 打开 GET /v1/machines 说哪个版本的答案。 消费者发现 能力缺失比失败少.
  • 这个服务从不叫消费者回来. 它只打开连接到它的 自己的运行时间和同行。 一个想听变化的消费者 订阅 GET /v1/events这里没有消费者地址.

不寻常的部分

这个空间里的大多数工具都用一台笔记本电脑管理会议, 对于一个供应商的代理, 在一个TUI后面。 这些财产是稀有的——都是 认真对待失败的后果。 每一个都通过工作, 与状态 和交付图,以 docs/unusual-parts.md; 数据 "稀有"背后的调查 docs/positioning.md。 。 。 .

  • 一个会话有状态,不是脉搏. 完成,超出配额,死于 错误和未发送的文本看起来都像一个安静的终端; 它们在这里 不同的州,每个人都说它是否 observed 或者说 inferred。 。 。 .
  • 发出快活不是火与忘. submitted, (中文(简体) ), queued, (中文(简体) ), unknown, (中文(简体) ), refused 财务报告和审定财务报表 stalled (a) 不同的结果; unknown 表示文本是 被困了,没有发送,再试 从来没有重新提交人类的文本; stalled 表示 会议停止了绘图,没有写任何东西.
  • 在对话框上被屏蔽的会话可以远程回答 ——按选项指数, 所以答案不能落在一个变化的问题上.
  • 每个路线都经过认证. 没有非认证模式, 循环绑定 默认,指每个动词赠款的指定校长,每次被审计的变异.

安装

发布到 npm; 一个安装表面 。 需要节点 18 或更新到 发射 页:1 服务——服务本身是一个静态的Go 二进制,不需要其他的.

npx @futurelastic/muster serve        # run it once, nothing installed
npm i -g @futurelastic/muster         # or install the `muster` command
muster --version                      # muster <version> (...)

@futurelastic/muster 是一个小型发射装置: npm 安装一个平台 并运行二进制。 安装时没有下载到任何信息, 每一次释放都带有npm出处. 公布根据 next ditt-tag; (中文(简体) ); latest 只移动到最后发布。 视窗(x64和arm64) 安装方式相同,每一次发布都会在Windows上运行 已发布;没有交互式-终端驱动程序-见 docs/install.md。 。 。 . 每期定稿也向公司发布主机发布,主机安装和 更新机器的应用程序 : docs/install.md。 。 。 .

配置为 FLEET_* 环境状况 快速启动 显示 开始 muster serve在重启后幸存的服务是 docs/install.md由源头构建,只用来入侵它.

快速启动

建筑来源:去1.26或更新. 无相依相.

go build ./... && go test ./...

一台机器

export FLEET_MACHINE=machine-a
export FLEET_TOKEN="$(openssl rand -hex 32)"
export FLEET_ADDR=127.0.0.1:9000
go run ./cmd/muster serve
curl -s -H "Authorization: Bearer $FLEET_TOKEN" http://127.0.0.1:9000/v1/health

没有默认的端口——选择一个并保留它. 默认绑定在回转上 电子端口,所以您没有故意配置的服务是 只能从它自己的机器上达到.

两台机器

联邦两个案例是四个步骤——每个机器的证书,所有者 绑定地址, 呼叫者的对等列表, 以及一个 GET /v1/machines 以核实。 这个 完全通过是 docs/multi-machine.md; 何谓 然后调用者可以这样做( 一个全舰队会话列表, 输入和对话框答案发送) 跳过跳跃)是 docs/driving-a-machine.md。 。 。 .

这是演示 不是安装. 上面的每一个过程都以它的外壳而结束. 在重启后幸存的服务——主表,状态目录,a 服务单位,a muster doctor 运行所有检查,是 docs/install.md在一台macOS或Linux机器上, muster service install 在一个命令中为当前用户执行.

它为谁服务

客户,不是终端用户. 有三种想法,API对待他们一样:

  • 会话仪表板 - 每一场会议每台机器都能看到 说每个都在里面 并有办法回答卡住的.
  • 协调员 ——决定应开展哪些工作,需要制定的方案 要运行它; 他们持有工作词汇, 本服务持有 届会.
  • 桌面和命令行应用程序 - 列出会话的发射器或拾取器 并附着在其中.

你建的哪一个决定从哪里开始 docs/client-guide.md。 。 。 .

版式

路径住在那里的东西
cmd/muster/这个 muster 二进制 : serve, (中文(简体) ), doctor, (中文(简体) ), compat, (中文(简体) ), principal
internal/服务: HTTP API, 状态商店, 会话驱动程序, 交付, 同行联合会
clients/参考 shell 客户端 - clients/README.md
scripts/门、烟、建和发布脚本
npm/发布到 npm 的启动器和平台包
docs/API 参考、规格、安装和部署程序、发展成果评估——见 文档

文档

如果你想的话读取
调用 APIdocs/api.md 一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一一
写客户端docs/client-guide.md ——走过,每一个例子都取自运行中的服务
理解设计docs/spec/session-abstraction.md ——域名模型. 如果你读了一节,读了§5.7
完全知道电线协议docs/spec/api-http.md ——规范化
在现有系统中采用docs/adoption.md ——上演,所以每个步骤都是可逆的;§2是令我们惊讶的先决条件
服务工作docs/internals.md - 测量、确定的问题、已知差距
在舰队抢走前检查一下运行时间docs/compat.md —— 说 muster compat: 一份版本报告,说明一个候选人大楼是否仍然按照这项服务假设行事
两台机器docs/multi-machine.md 证书、绑定地址、同行名单、核查 docs/driving-a-machine.md 来电者能做些什么
安装在新机器上docs/install.md 从无到运行的服务,结束于 muster doctor
部署docs/deploy.md ——从合并承诺到已经运作的服务
放开它docs/release-host.md ——最终如何到达发布主机以及npm,以及一次性设置
宣布全机会议身份docs/session-identity.md —— 说 sessionEnv,优先于呼叫者,核查
看这是什么立场docs/positioning.md 对可比项目的调查:类别、发现的罕见情况、轨迹

代码是复制的,不是 换个角度 会话 spec 组织起来, 以便您能说出当前的事实 从历史 : §1§13是规范的, (中文(简体) ), §14 列出了文档的要求 但无法执行 ——在相信任何保证之前读出它——和 附录A 是结果日志产生规则的测量和错误.

该附录是有意保留而不是平滑的。 读者谁知道 只有一条规则会重述,知道如何被违反的读者会 承认下一个例子.


向甚么处去

按顺序完成,每个修改了规格,而不仅仅是 已执行:

  • ✅ 第一个工作司机 ——一个运行交互式的终端多路驱动器 探员CLI。 它修改了四节 并发现了一个缺陷 光谱 无法自行修复.
  • ✅ 订阅活动 - 担任SSE,有光标、划时代、保留和 已宣布重同步 。 没有投票.
  • ✅ 第二个驱动程序:远程端点 联邦,证明;没有服务 需要一个特殊的案例.
  • ✅ 回答,不只是观察 所列举的选项、非选项和 证实该提示已经清除.
  • ✅ 一秒钟 当地 驱动程序 第三方的毒剂作为子过程产出, 第一个可以宣布的 observesState: true。 。 。 .
  • ✅ 在重启后幸存的状态 ——一能键,事件划时代和 光标和驱动程序会话记录在解剖学上一直存在.
  • ✅ 作为客户的主管 ——一名主管现在与本部门交谈 而不是到终端多路器。 计划到达那里,包括 无法从该存储库中解出的先决条件,是 docs/adoption.md。 。 。 .
  • ✅ 释放路径 - 1 npm 安装表面,释放候选人和 决赛,以及Windows发布前运行的Windows包 并随后从Windows上安装.

下一个 :

  • ⬜ 信用生命周期. 赠款按本金和动词计算,以及 入学是一种命令。 没有过期, 损坏的令牌会被取消 更改校长的补助金意味着取消和 复加一add.
  • ⬜ 度量衡. 已知子进程产卵成本会随着宿主负载而降解—— 8×在重载的机器上——没有在生产中测量.
  • ⬜ Windows上的交互式终端驱动程序. 从 npm 安装窗口 运行子进程运行时间; 这里没有多功能驱动程序.

失踪内容的诚实清单在 docs/internals.md,保持当前状态.


许可证

麻省理工学院复制、运行、改变 —— 收养路径 docs/adoption.md 存在的人不是我们,和 没有许可证的有文件证明的收养途径没有给他们任何好处.

版本与发布记录

@futurelastic/muster 共发布 206 个版本,首次发布于 2026/10/02;过去 12 个月发布了 206 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.20.0latest2026/11/17今天
0.20.1-rc.1next2026/11/17今天
0.20.0-rc.62026/11/17今天
0.20.0-rc.52026/11/17今天
0.20.0-rc.42026/11/16今天
0.20.0-rc.32026/11/16今天

关于 @futurelastic/muster 的常见问题

@futurelastic/muster 是什么?

fuser——一个拥有整个舰队的会话代理的机器-局部服务. 启动器:运行此平台的预建二进制 .

如何安装 @futurelastic/muster?

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

@futurelastic/muster 支持 TypeScript 吗?

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

@futurelastic/muster 需要什么版本的 Node.js?

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

@futurelastic/muster 可以商用吗?

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

@futurelastic/muster 的下载量有多少?

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

@futurelastic/muster 还在维护吗?

最新版本 0.20.0 发布于 2026/11/17(今天);至今共发布 206 个版本,其中过去 12 个月发布了 206 个;首次发布于 2026/10/02。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。