守护进程与运行时

智能体不在 Multica 服务器上运行——它们跑在你自己的机器上。

在 Multica 里，智能体不在我们的服务器上运行——它们跑在你自己的机器上，由一个叫守护进程（daemon）的小程序调用本地安装的 AI 编程工具。Multica 服务器只做协调：存 issue、排任务、派发给正确的运行时（runtime = 守护进程 × 一款 AI 编程工具）。

这个结构带来 Multica 和 Linear / Jira 最大的差别：你的 API 密钥、工具链、代码目录都留在本地，Multica 服务器一个都看不到。"我的智能体不工作"类问题几乎都是本地问题——守护进程没启动、某款 AI 工具没装、密钥过期——请先从本地查起；定位指引见故障排查。

启动守护进程

守护进程是 Multica CLI 的一部分。装好 Multica CLI 后，在自己机器上跑：

multica daemon start

启动后它会做四件事：

读取你登录时保存的凭证
探测本机 PATH 上已安装的 AI 编程工具（内置支持 10 款：Claude Code、Codex、Cursor、Copilot、Gemini、Hermes、Kimi、OpenCode、OpenClaw、Pi）
向服务器注册自己，以及每款检测到的工具对应的运行时
持续每 3 秒轮询一次是否有任务要领，每 15 秒发一次心跳

常用命令：

命令	作用
`multica daemon start`	启动（默认后台，加 `--foreground` 前台运行）
`multica daemon stop`	停止
`multica daemon restart`	重启
`multica daemon status`	查看状态
`multica daemon logs`	查看日志（加 `-f` 跟随）

完整 CLI 参考见 CLI 命令速查。

**桌面应用自带守护进程。**用桌面应用就不必手动 multica daemon start——它启动时会自动拉起守护进程。

为什么一台机器会有多个运行时

运行时不是一个服务器，也不是一个容器——它是「守护进程 × 一款 AI 编程工具」的组合。举例：你在一台 MacBook 上启动守护进程，本机装了 Claude Code 和 Codex；你是两个工作区的成员。那么 Multica 会注册 4 个运行时：

Rendering diagram…

关键的点：

一个守护进程可以对应多个运行时——装了多款工具、加入了多个工作区，每个组合就各一个
同一个守护进程在同一个工作区同一款工具上只会有一条运行时——重启守护进程不会产生重复记录
Multica 界面的 Runtimes 页面列的就是这些行

云端运行时即将开放，目前处于等待名单阶段。上线后，你无需在本地运行守护进程，即可在 Multica Cloud 上直接执行智能体任务。在下载页面登记邮箱以获取通知。

运行时什么时候被判定为离线

Multica 用心跳判断运行时是否在线。三个关键数字：

事件	阈值
守护进程心跳频率	每 15 秒
标记为失联	超过 45 秒没心跳（漏了 3 次）
自动删除	失联且无关联智能体超过 7 天

失联不是永久的——守护进程只要再次发出心跳就立刻回到在线，运行时记录也会保留。重启守护进程不会丢运行时。

失联的运行时上正在跑的执行任务会被标记为失败（失败原因 runtime_offline）。对可重试的来源（issue、chat），Multica 会自动重新排队；Autopilots 触发的任务不自动重试。详见执行任务 → 哪些失败会自动重试。