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 预检,其英文提示保留为观察项。