运行方式

运行方式（runtime）是执行智能体 task 的机器或云端 worker。智能体决定做什么，运行方式决定在哪里做——用哪个文件系统、哪套工具链、哪些凭据。运行方式配置得对不对，直接决定智能体是能碰你的真实项目，还是什么都碰不了。

三种类型

为智能体选择运行方式

在智能体详情页选择它通过哪个运行方式执行，并查看该运行方式的在线状态、负载、CLI 和绑定的智能体。绑定到离线运行方式的智能体接不了活——发现"怎么没动静"时先查状态。

本地执行如何工作

local 运行方式是你机器上的一个守护进程：它领取 task，然后调用这台机器上安装的 AI 编程工具去干活。你的项目——代码、依赖、shell 里的凭据——都不离开这台机器，守护进程是唯一的桥梁。

桌面端首次连接

登录 Wujie 桌面端并创建或选择工作区后，上手引导会自动准备本地守护进程、连接你的 Wujie 账号并启动服务。桌面包优先使用内置 CLI，必要时自动下载并校验；无需另外执行 Wujie 安装或登录命令。

引导中的"本地服务已连接"表示守护进程已经就绪。当前工作区出现这台电脑的在线运行方式后，选择它继续进入工作区。安装、账号连接或启动失败时，可在同一步重新准备；只有 Wujie 会话确实过期时才需要重新登录。

准备智能体工具

1. 在这台电脑上安装你选择的 AI 编程工具，使用工具提供的安装说明。
2. 打开该工具，按其账号登录或 API 配置流程完成授权，并确认工具本身可以正常使用。
3. 回到 Wujie 上手引导，点击刷新。空闲的本地服务会重新检测；服务正在执行任务时，会保留任务并等待后台发现结果。

Wujie 登录和工具自身的模型账号授权是两件事。检测到工具不代表已经验证模型账号权限。没有准备好工具时，可以暂时跳过，之后再连接。

已关闭自动启动时，点击"启动本地服务"仅启动本次服务，不修改自动启动偏好。桌面端使用独立配置，不覆盖手动安装的 CLI 配置。

连接器复用这条链路

钉钉和飞书文档连接器同样走本地运行方式：在你拥有且在线的运行方式上调用平台 CLI（dws 或 lark-cli）。具体能做什么见连接器。

自定义运行方式

团队自己的工具——公司内部包装的 CLI、自研网关、带固定启动参数的变体——可以注册成自定义运行方式。在运行方式页面选择「添加自定义运行方式」：

1. 协议家族——该工具兼容的内置协议（claude、codex、cursor 等），决定平台按哪种协议与工具通信；创建后不可更改。
2. 命令行——可执行文件加固定参数，例如 company-codex --profile team-a。第一个词是命令名，其余是固定参数；支持引号与转义，不支持管道、重定向和变量展开。
3. 显示名称与描述——名称会出现在运行方式列表里（带设备名后缀），供智能体绑定。

配置属于整个工作区，会同步到所有已连接的机器。每台机器的守护进程按以下顺序解析命令：

1. 本机路径覆盖（wujie runtime profile set-path）——把配置钉到不在 PATH 里的二进制，或在多个安装版本中选一个；
2. 本机 PATH 查找。

找到命令，就以该配置注册一个运行方式实例；找不到，这台机器静默跳过，不影响其他机器。修改配置后，守护进程会检测到变更并重新注册，无需重启。

删除分两层：在运行方式列表里删除一个实例，只移除当前机器上的实例，配置还在的话守护进程会再次注册它；要彻底移除，请在「自定义运行方式」中删除对应配置。

下一步

• 智能体——智能体绑定运行方式来执行
• 自动化——无人值守的运行同样在运行方式上执行
• 连接器——通过本地运行方式的 CLI 读取链路