如何为内部封装的 agent 命令创建 Multica 自定义 runtime profile【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica当团队使用的 AI 编码工具不是标准 CLI而是内部封装的命令——例如注入凭据的 wrapper、版本钉死的可执行文件或需要固定附加参数的兼容工具——Multica 提供了自定义 runtime profilecustom runtime profile在 workspace 里声明这条命令兼容哪一个受支持的协议族之后每台已连接的计算机各自在PATH上解析该命令并注册对应 runtimeagent 就能把 run 调度到你的封装命令上。开始前确认三个前提它们直接决定流程能否走通你是 workspace owner 或 admin。只有这两种角色能创建、编辑或删除自定义 runtime profile封装命令已安装在目标机器上并且能在终端里独立完成请求——如果它在终端里就无法完成请求daemon 调用它会以同样的方式失败该机器上的 Multica daemon 已在运行。daemon 必须先检测到至少一个内置受支持的 CLI 才会启动自定义 runtime profile 是在 daemon 起来之后才同步的所以它不能作为一台空机器上唯一的启动条件。先选协议族profile 不引入新协议自定义 profile 不会新增通信协议。你必须从 Multica 已支持的协议族里选一个即工具的集成协议类型并且命令本身必须与该族兼容。受支持的工具、检测命令和 MCP/skill 支持情况列在 AI coding tools comparison 的 Supported tools 表中例如claude、codex、cursor-agent、dsh、deveco等检测命令各自对应一个协议族。选错协议族wrapper 即使能跑daemon 也建立不了与工具的连接。步骤一确认 daemon 环境能找到封装命令在目标机器的终端里执行把command换成你的封装命令command -v command command --version第一条打印可执行路径。如果终端能找到工具但 Desktop 或后台 daemon 找不到两者通常使用的是不同的PATH值这种情况稍后用set-path为该机器固定绝对路径即可。步骤二创建 profileWeb 界面主路径只有 owner/admin 可操作打开Runtimes页面进入安装了该命令的计算机。点击Add custom runtime。选择命令实际兼容的协议族。填入名称name、命令command和固定参数fixed arguments保存。profile 在 workspace 内共享每台已连接的计算机各自查找命令只有能在PATH上解析到它的计算机才会注册对应 runtime。创建 profile 不会安装命令也不会把其他成员签入该工具。CLI 替代路径直接指定可执行名时multica runtime profile create \ --protocol-family family \ --command-name command \ --display-name Internal wrapper \ --description 团队内部封装命令把family替换为选定的协议族、command替换为你的封装命令名。--protocol-family会先在本地校验不在受支持列表内会直接报错并列出全部合法值。完整 flag 定义见multica runtime profile create --helplist、update、delete与create同属multica runtime profile子命令详见 CLI reference。写命令字段时注意一条硬边界command 字段接受可执行文件加参数不是 shell 脚本。普通参数、引号和反斜杠转义可以工作管道、重定向、、;、反引号和环境变量展开都不行。需要这些行为时把它们放进一个 wrapper 脚本再用这个脚本作为命令。参数顺序与 Multica 的覆盖规则保存前理解参数如何拼接能避免运行时的意外。你在 command 字段输入的内容始终紧跟在可执行文件之后、Multica 追加的参数之前your command your fixed arguments Multicas protocol arguments the agents custom arguments这正是 subcommand 风格 wrapper 能工作的原因。例如命令是ccms start q36工具会先看到start q36可以在 Multica 的-p等参数到达之前选中它的子命令——这是此类 wrapper 唯一接受的顺序。另外两条规则Multica 自己的值在冲突中获胜。如果固定参数设置了 Multica 也会设置的 flagMultica 的值在后面、优先生效。最重要的情形在 agent 上选择的模型会覆盖 profile 里钉住的--model。想为所有人钉住模型就把 agent 的 model 字段留空。协议关键 flag 会被忽略。-p、--output-format、--input-format、--permission-mode以及其他协议族的对应参数会从固定参数中丢弃因为覆盖它们会破坏 daemon 与工具的连接子命令和其他位置参数始终透传。如果你的 profile 带有固定参数并且刚做过版本升级参数顺序从追加在最后改成了现在的紧跟可执行文件升级后在该 profile 上启动一次 run确认它仍然工作。步骤三验证 runtime 已注册并在线按文档给出的顺序检查运行multica daemon status确认 daemon 在运行运行multica daemon logs -f查看登录、网络或工具检测错误在同一环境运行command -v command确认 daemon 能找到它打开 Multica 的Runtimes页面确认目标计算机和该自定义 runtime 显示为 online如果刚安装工具、改过路径或更新过 profile运行multica daemon restart让 daemon 重新检测。runtime 显示在线但 run 仍失败时打开对应 issue 的 run record查看 CLI 返回的确切错误更多排查路径见 Troubleshooting。daemon 找不到命令时用 set-path 固定本机路径Desktop 拉起的 daemon 如果找不到你终端里能运行的命令为当前机器设置绝对路径multica runtime profile set-path profile-id --path /absolute/path/to/commandprofile-id替换为 profile 的 id用multica runtime profile list获取--path指向该机器上可执行文件的绝对路径。这个映射只记录在本机 CLI 配置里不会上传到服务器。移除路径覆盖multica runtime profile unset-path profile-idwrapper 需要调用 Multica 时的集成变量daemon 启动 agent task 时会把任务上下文注入 runtime 进程。这些值归 daemon 所有agent 的自定义环境无法覆盖任何MULTICA_变量。写集成时只依赖标记为 integration contract 的五个变量变量task 中的值MULTICA_TOKENtask 范围的mat_API 凭据MULTICA_TASK_ID当前 active task 的 IDMULTICA_AGENT_ID被指派 agent 的 IDMULTICA_WORKSPACE_ID该 task 所属 workspace 的 IDMULTICA_SERVER_URLdaemon 选定的 Multica 服务器 URL其余变量如MULTICA_TASK_SLOT、TMPDIR只是信息性说明可能随版本变化。用MULTICA_TOKEN发起的请求其作者身份由服务端判定写入内容会归属到被指派的 agent 和当前 task。一条必须落实的约束这些值位于 runtime 进程的真实环境中你的 wrapper 启动的任何子进程默认继承全部变量包括MULTICA_TOKEN。如果某个子进程不该持有该凭据必须显式剥离不要依赖并不存在的进程隔离。token 只保留在进程环境里——不要写进 prompt、日志、仓库文件或持久化配置。修改、删除与限制编辑 profile 只影响之后被 claim 的 run不影响已在运行的任务。删除 profile 前先处理仍绑定在其 runtime 上的活跃 agent。只删除某台计算机上的 runtime 实例不会删除 profile——仍在运行的 daemon 会重新注册它。runtime 默认是 private 的只有 runtime owner 可以创建其上的 agent 或将其设为 public这与 profile 的 workspace 级共享是两回事。更多 daemon 与 runtime 的机制细节见 Daemon and runtimes。【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何为内部封装的 agent 命令创建 Multica 自定义 runtime profile
如何为内部封装的 agent 命令创建 Multica 自定义 runtime profile【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica当团队使用的 AI 编码工具不是标准 CLI而是内部封装的命令——例如注入凭据的 wrapper、版本钉死的可执行文件或需要固定附加参数的兼容工具——Multica 提供了自定义 runtime profilecustom runtime profile在 workspace 里声明这条命令兼容哪一个受支持的协议族之后每台已连接的计算机各自在PATH上解析该命令并注册对应 runtimeagent 就能把 run 调度到你的封装命令上。开始前确认三个前提它们直接决定流程能否走通你是 workspace owner 或 admin。只有这两种角色能创建、编辑或删除自定义 runtime profile封装命令已安装在目标机器上并且能在终端里独立完成请求——如果它在终端里就无法完成请求daemon 调用它会以同样的方式失败该机器上的 Multica daemon 已在运行。daemon 必须先检测到至少一个内置受支持的 CLI 才会启动自定义 runtime profile 是在 daemon 起来之后才同步的所以它不能作为一台空机器上唯一的启动条件。先选协议族profile 不引入新协议自定义 profile 不会新增通信协议。你必须从 Multica 已支持的协议族里选一个即工具的集成协议类型并且命令本身必须与该族兼容。受支持的工具、检测命令和 MCP/skill 支持情况列在 AI coding tools comparison 的 Supported tools 表中例如claude、codex、cursor-agent、dsh、deveco等检测命令各自对应一个协议族。选错协议族wrapper 即使能跑daemon 也建立不了与工具的连接。步骤一确认 daemon 环境能找到封装命令在目标机器的终端里执行把command换成你的封装命令command -v command command --version第一条打印可执行路径。如果终端能找到工具但 Desktop 或后台 daemon 找不到两者通常使用的是不同的PATH值这种情况稍后用set-path为该机器固定绝对路径即可。步骤二创建 profileWeb 界面主路径只有 owner/admin 可操作打开Runtimes页面进入安装了该命令的计算机。点击Add custom runtime。选择命令实际兼容的协议族。填入名称name、命令command和固定参数fixed arguments保存。profile 在 workspace 内共享每台已连接的计算机各自查找命令只有能在PATH上解析到它的计算机才会注册对应 runtime。创建 profile 不会安装命令也不会把其他成员签入该工具。CLI 替代路径直接指定可执行名时multica runtime profile create \ --protocol-family family \ --command-name command \ --display-name Internal wrapper \ --description 团队内部封装命令把family替换为选定的协议族、command替换为你的封装命令名。--protocol-family会先在本地校验不在受支持列表内会直接报错并列出全部合法值。完整 flag 定义见multica runtime profile create --helplist、update、delete与create同属multica runtime profile子命令详见 CLI reference。写命令字段时注意一条硬边界command 字段接受可执行文件加参数不是 shell 脚本。普通参数、引号和反斜杠转义可以工作管道、重定向、、;、反引号和环境变量展开都不行。需要这些行为时把它们放进一个 wrapper 脚本再用这个脚本作为命令。参数顺序与 Multica 的覆盖规则保存前理解参数如何拼接能避免运行时的意外。你在 command 字段输入的内容始终紧跟在可执行文件之后、Multica 追加的参数之前your command your fixed arguments Multicas protocol arguments the agents custom arguments这正是 subcommand 风格 wrapper 能工作的原因。例如命令是ccms start q36工具会先看到start q36可以在 Multica 的-p等参数到达之前选中它的子命令——这是此类 wrapper 唯一接受的顺序。另外两条规则Multica 自己的值在冲突中获胜。如果固定参数设置了 Multica 也会设置的 flagMultica 的值在后面、优先生效。最重要的情形在 agent 上选择的模型会覆盖 profile 里钉住的--model。想为所有人钉住模型就把 agent 的 model 字段留空。协议关键 flag 会被忽略。-p、--output-format、--input-format、--permission-mode以及其他协议族的对应参数会从固定参数中丢弃因为覆盖它们会破坏 daemon 与工具的连接子命令和其他位置参数始终透传。如果你的 profile 带有固定参数并且刚做过版本升级参数顺序从追加在最后改成了现在的紧跟可执行文件升级后在该 profile 上启动一次 run确认它仍然工作。步骤三验证 runtime 已注册并在线按文档给出的顺序检查运行multica daemon status确认 daemon 在运行运行multica daemon logs -f查看登录、网络或工具检测错误在同一环境运行command -v command确认 daemon 能找到它打开 Multica 的Runtimes页面确认目标计算机和该自定义 runtime 显示为 online如果刚安装工具、改过路径或更新过 profile运行multica daemon restart让 daemon 重新检测。runtime 显示在线但 run 仍失败时打开对应 issue 的 run record查看 CLI 返回的确切错误更多排查路径见 Troubleshooting。daemon 找不到命令时用 set-path 固定本机路径Desktop 拉起的 daemon 如果找不到你终端里能运行的命令为当前机器设置绝对路径multica runtime profile set-path profile-id --path /absolute/path/to/commandprofile-id替换为 profile 的 id用multica runtime profile list获取--path指向该机器上可执行文件的绝对路径。这个映射只记录在本机 CLI 配置里不会上传到服务器。移除路径覆盖multica runtime profile unset-path profile-idwrapper 需要调用 Multica 时的集成变量daemon 启动 agent task 时会把任务上下文注入 runtime 进程。这些值归 daemon 所有agent 的自定义环境无法覆盖任何MULTICA_变量。写集成时只依赖标记为 integration contract 的五个变量变量task 中的值MULTICA_TOKENtask 范围的mat_API 凭据MULTICA_TASK_ID当前 active task 的 IDMULTICA_AGENT_ID被指派 agent 的 IDMULTICA_WORKSPACE_ID该 task 所属 workspace 的 IDMULTICA_SERVER_URLdaemon 选定的 Multica 服务器 URL其余变量如MULTICA_TASK_SLOT、TMPDIR只是信息性说明可能随版本变化。用MULTICA_TOKEN发起的请求其作者身份由服务端判定写入内容会归属到被指派的 agent 和当前 task。一条必须落实的约束这些值位于 runtime 进程的真实环境中你的 wrapper 启动的任何子进程默认继承全部变量包括MULTICA_TOKEN。如果某个子进程不该持有该凭据必须显式剥离不要依赖并不存在的进程隔离。token 只保留在进程环境里——不要写进 prompt、日志、仓库文件或持久化配置。修改、删除与限制编辑 profile 只影响之后被 claim 的 run不影响已在运行的任务。删除 profile 前先处理仍绑定在其 runtime 上的活跃 agent。只删除某台计算机上的 runtime 实例不会删除 profile——仍在运行的 daemon 会重新注册它。runtime 默认是 private 的只有 runtime owner 可以创建其上的 agent 或将其设为 public这与 profile 的 workspace 级共享是两回事。更多 daemon 与 runtime 的机制细节见 Daemon and runtimes。【免费下载链接】multicaMake humans and AI agents work as one team — open-source and self-hostable.项目地址: https://gitcode.com/GitHub_Trending/mu/multica创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
