跳转到内容
RotiferRotifer Protocol

配置与更新

有三个命令管理 CLI 自身而非某个 Gene：rotifer config 管理全局设置，rotifer self-update 负责保持版本最新，rotifer telemetry 管理匿名使用心跳。

rotifer config

Section titled “rotifer config”

读写 Rotifer 的全局配置。配置按用户存储，对该机器上的所有项目生效。

终端窗口
rotifer config <subcommand>

rotifer config list

Section titled “rotifer config list”

列出当前已设置的所有配置项。

终端窗口
rotifer config list
Configuration
───────────────
update-check: true

rotifer config get

Section titled “rotifer config get”

读取单个配置值。

终端窗口
rotifer config get <key>
参数必填说明
key是要读取的配置键
终端窗口
rotifer config get update-check

rotifer config set

Section titled “rotifer config set”

写入单个配置值。

终端窗口
rotifer config set <key> <value>
参数必填说明
key是要写入的配置键
value是新的值
终端窗口
rotifer config set update-check false

配置键

Section titled “配置键”
键含义
update-checkCLI 是否在后台检查新版本。设为 false 可完全关闭检查——在 CI 或离线机器上很有用。
last-version更新检查最近一次见到的版本号。由 CLI 自行维护，通常无需手动设置。
default-publishrotifer publish 未显式指定目标时使用的默认发布目标。

rotifer self-update

Section titled “rotifer self-update”

检查是否有新版本，并升级到该版本。

终端窗口
rotifer self-update [options]

选项：

参数说明
--rollback回退到上一个已安装版本，而非升级。若某次升级引入了问题，用它撤回。
终端窗口
# 检查并升级
rotifer self-update


# 撤销上一次升级
rotifer self-update --rollback

rotifer telemetry

Section titled “rotifer telemetry”

查看或更改匿名使用心跳。

终端窗口
rotifer telemetry [status|on|off]
命令作用
rotifer telemetry status显示心跳是否开启以及原因。直接运行 rotifer telemetry 效果相同。
rotifer telemetry on打开心跳。
rotifer telemetry off关闭遥测：心跳，以及登录后的调用上报。之后什么都不发送，连「已退出」的通知也不发。

发送什么： 一个随机的机器 ID、渠道（cli）、CLI 版本号，以及计数 1。不含代码、不含基因名、不含账号。心跳默认开启；第一次发送时，CLI 会在 stderr 打印一行提示，说明这件事以及怎么关。

选择存在哪里： ~/.rotifer/telemetry.json，只有你的用户能读。

什么会覆盖它： 当前 shell 里的环境变量优先于存下的选择。

  • DO_NOT_TRACK=1 关闭，且优先于其他一切。
  • ROTIFER_TELEMETRY=0（或 false、off）关闭；其他非空值都表示开启，即使你存的是 off。

登录后，CLI 还会上报每一次基因调用，MCP server 也一样。上面每一种开关都会连调用上报一起停掉：rotifer telemetry off、ROTIFER_TELEMETRY=0、DO_NOT_TRACK=1 任何一个，都会同时停掉心跳和调用上报，CLI 和 MCP server 都是如此（两者读同一个 ~/.rotifer/telemetry.json）。CLI 0.30.1、MCP server 0.19.4 及更早的版本里，rotifer telemetry off 只停心跳；用这些版本时请设置上面任一环境变量。

示例：

终端窗口
$ rotifer telemetry status
  Telemetry
  ───────────
  Anonymous heartbeat: on
  Reason: on — default (ADR-329); nobody has chosen otherwise yet
  Machine ID: 3f1c2b7e-…


ℹ `rotifer telemetry off` / ROTIFER_TELEMETRY=0 / DO_NOT_TRACK=1 all disable it.


$ rotifer telemetry off
  Anonymous usage heartbeat: off
  Nothing is sent — not even an opted-out notice.

status 给出的原因是五种之一：环境变量关闭了它、环境变量打开了它、你存下的选择（off 或 on）、默认值。