安装 Bundle、supervisor、登录升级，以及所有下载落盘位置一览。

安装与管理

命令一览

管理 ginit 本体与运行时的命令就这几条，按顺序执行前三条即可用：

ginit login

ginit device install

ginit up

ginit doctor

ginit update

命令	作用
`ginit login`	飞书登录，建立身份与网关凭证
`ginit device install`	下载自包含 device Bundle（Harness + MCP + 技能集）
`ginit up`	一键就绪：attach 本机 + 起 supervisor（幂等，可反复跑）
`ginit doctor`	体检：版本 / 登录态 / 设备 / 长链路 / 模型可用性
`ginit update`	升级 ginit CLI 本体（`--cli-only` 只更 CLI 不动 Bundle）
`ginit device unsupervise`	停 supervisor（长链路断开）

安装 Bundle

ginit device install

预期输出：

ginit device install
  source:   tos (default)
  variant:  self
  version:  v1.4.115
  → downloading ginit-device-self-linux-amd64.tar.gz (~110 MB)
  → sha256 verified
  → installed to ~/.ginit/device-runtime/

ginit device install: OK (bundle v1.4.115, node 22.x, claude 2.1.226, codex 0.153.4)

同版本重复安装直接跳过（already installed, skipping）。分离式 Harness 运行时也各自独立安装：ginit claude install-runtime 与 ginit codex install-runtime（Codex 运行时独立 pin，当前 0.153.4）。

Supervisor 是什么

ginit up / ginit device supervise 启动的是 resident supervisor——本机上的一个后台常驻进程，它做三件事：

保持长链路：与 ginit 服务端维持一条 WebSocket 连接（日志里看到 [ws] welcome session=... 就是建好了），本机因此"在线"、可被远程调度
认领任务：远程派来的任务（比如 Multica 看板派给你绑定 agent 的 issue）由它接收、在绑定的代码库里拉起 agent 执行
托管凭证刷新：QZ token keeper、session 状态等本地维护工作都在它名下

只要你是纯本地使用（自己起 ginit claude / ginit codex 干活），supervisor 起不起无所谓；想被远程调度、接看板任务，就必须跑着它。pidfile 在 ~/.ginit/run/supervisor.pid，日志 ~/.ginit/supervisor.log，停止用 ginit device unsupervise。

下载都落在哪

所有 ginit 的下载与状态都在用户家目录下，不在系统目录。虚拟机用户注意：如果你的 $HOME 在非持久化镜像层（容器、重置型 VM），以下路径会随重建丢失，需要重新 ginit device install：

路径	内容	大小量级
`~/.ginit/device-runtime/`	device Bundle：Node + Claude Code + Codex + MCP + lark/qz 技能	~1 GB
`~/.ginit/claude-runtime/`	Claude Code 独立运行时（bundle 复用优先）	~250 MB
`~/.ginit/codex-runtime/`	Codex CLI 独立运行时	~100 MB
`~/.ginit/claude-env.json`	网关凭证缓存（24h 刷新）	极小
`~/.ginit/qz-credentials.json`	QZ 账号密码（本机 only，0600）	极小
`~/.ginit/multica/state.json`	Multica 绑定状态（PAT + codebase 映射）	极小
`~/.ginit/devices/<id>/`	设备注册信息与 `managed.flag`	极小
`~/.ginit/run/supervisor.pid`	supervisor pidfile；日志在 `~/.ginit/supervisor.log`	极小
`~/.config/ginit/config.json`	多环境 profile（base_url + token）	极小

ginit CLI 二进制本身装在 /usr/local/bin/ginit（GINIT_INSTALL_DIR 可改到如 ~/.local/bin）。

--lean 变体（约 250 KB）要求宿主机自带 Node ≥ 22 与 Claude Code，默认的 self 变体无任何宿主要求。

正在加载评论…

安装与管理

安装与管理

命令一览

安装 Bundle

Supervisor 是什么

下载都落在哪

评论

本页目录