Skip to content

remote-agent

Verified

@ai-workbench/remote-agent · v0.8.24 · Web UI

通过远程主机运行Claude与Codex会话。

Install

dsh plugin add @ai-workbench/remote-agent

Confirm the layer applied with dsh --profile default --dump-config — see the install guide.

Source

Published to npm without a public repository. Inspect the package contents before installing.

Tags

Readme

AI Workbench 远程助手 · @ai-workbench/[email protected] · 插件 → 添加插件

通过官方 DSH 插件入口使用 Claude(远程主机)与 Codex(远程主机)。登录和工作区来源由“远程主机连接”组件提供;员工在原生工作区和模型菜单中选择文件夹与型号。

文件和命令在所选的本机或主机目录执行,订阅凭据留在主机。插件不改写 DSH 的默认模型,不为员工创建同名主机目录,不自动迁移旧会话的来源。

会话行为

每轮启动一个新助手进程,按原生会话编号恢复上下文;不接回旧进程或重放上一轮输入。改变文件来源后请新建会话。

断线会结束本轮;操作可能已部分执行,请先检查文件。恢复连接后可在原会话继续。旧进程清理和技术详情记录尽力而为,不阻止下一轮。原生本机会话恢复的兼容性及实际设备结果见本轮交付证据,未验证项不作为已通过。

DSH 启动和打开模型菜单时读取一次主机型号列表。发送时不再查询目录或预核所选型号;所选型号不可用时,请在模型菜单重新选择。

执行位置与权限

  • 员工选本机文件夹,就在员工电脑上执行;通道失败不会改在主机运行。
  • 订阅凭据留在主机,不放进命令参数、日志或技术详情。
  • 跟随 DSH 当前权限:完全权限不问、工作区内修改先问、仅可查看只读。需要审批时使用官方卡片。
  • 一条会话对应一个工作区来源;换来源请新建会话。

Codex 员工端只使用随包提供的原生组件,通道等待本次组件的启动标记后才完成开通,不逐通道执行摘要或版本校验。当前员工端支持范围以发布验证记录为准,不让员工手填执行器路径。

本机附加扩展本次不启用,不修改本机配置。能安全显示的扩展名称会用普通提示说明;协议细节只进技术详情,不能安全显示的名称不打印原文。

管理员参数

参数经官方 Config schema 编辑,显式值优先。只有会话运行方式,没有运行模式选项或单次执行路径。

参数 默认值 作用
acpMaxMessageBytes 4194304 会话消息容量
brokerMaxFrameBytes 2097152 主机回传单段容量
brokerControlMaxBytes 1048576 主机会话管理回复容量
employeeShellKillGraceMs 1000 本机命令连接取消后的清理宽限毫秒

容量超限明确失败,不截断成有效消息。参数范围、生效时机和调整后果由官方 schema 与参数页显示;以上四条执行不变量不可关闭。

技术详情与交付

技术详情只写官方 profile 下本地私有日志,并由既有技术详情界面展开显示。写入失败不覆盖原始错误、不等待远端投递回执。每个运行环境只记录首次关闭原因;首先观察到的原因不自动等同跨层根因。

工程验证、独立审查、固定包摘要及实际设备验收分别记录在 docs/evidence/2026-10-24-X-executor-readiness/ 和项目 X 回执中。插件不修改 DSH 核心,不添加启动器或自定义 profile。

远程助手参数页只显示官方 ConfigForms 当前值,不提供保存、放弃或恢复继承值;修改请使用 DSH 官方 Config“打开配置文件”入口。

模型目录在官方启动读取时获取,并在连接变为 connected 时经官方注册刷新;官方菜单打开或重试读取缓存是 DSH 官方限制,本插件不改官方菜单或核心。真正不支持的推理档位由 DSH 预检,其英文提示保留为观察项。