Repository navigation
Releases
v0.2.0 Alpha · DSH 原生右侧远程 Agent
0.2.0 Alpha:DSH 原生右侧远程 Agent
验证日期:2026-11-17。DSH:0.2.2-rc.3;平台:macOS。
使用入口
在普通 DSH 会话中,点击标题栏的远程 Agent 按钮;也可以打开 DSH 自带的右侧栏,从引导页或 + 菜单选择 远程 Agent。中央继续使用原生对话,右侧提供文件与监控,不包含终端、命令栏或第二套聊天。
UI/UX 由 DSH 的 DeepSeek V4.1 Flash 实施。使用宿主的字体、圆角、颜色和明暗主题变量;插件内部采用顶部切换。
本次能力
- 综合、CPU、显卡、内存、磁盘和网络六类监控,历史趋势、暂停与刷新间隔。Linux 采用固定只读 SSH 采样;NVIDIA / AMD 取决于硬件、驱动和权限。缺失数据明确显示不可用。
- 远程文件浏览、新建、上传下载、复制、移动、权限修改和删除文件 / 空目录。多文档标签与草稿在切换监控时保留。
- CodeMirror 语法高亮与查找替换;Markdown 源码、预览与分屏;图片及浏览器支持的音视频预览。
- PDF 分页、适应宽度、缩放、文字批注、已有表单填写和页面旋转,保存经 SFTP 原子替换。独立 PDF worker 不覆盖 DSH 自带的 worker 全局。
- 文件与监控摘要可以先预览,再交给当前 DSH 会话。新增
rw_resources工具,只需当前主机读取授权,不要求 Shell 执行授权。 - 从工作台打开文件时回到会话,在原生右侧栏打开;工作台本身不再有 AI 协作栏和内嵌编辑器。
- 密码 / 私钥口令保存到 DSH 凭据记录,输入一次后重连无需重输;可随时“忘记已保存凭据”。
- 新增
rw_connect:在已授权主机上使用已保存凭据重连,不接收或返回密码;授权可在首次连接前创建。 - 所有右栏文件操作(含新建、目录、复制、重命名、
chmod、删除)绑定发起时的连接版本,文本 / PDF 保存同时校验内容 etag。其他窗口修改连接配置后,旧操作会拒绝执行并保留草稿。
独立工作台仍作为次要入口保留原有 SSH 终端与隧道;命令补全、显式发送历史和片段库仅用于该工作台。
自动验证
- TypeScript 类型检查通过,37 项后端测试通过,覆盖真实 OpenSSH / SFTP、HTTP 边界、资源计数器、PDF 冲突、空文件操作、凭据记录持久化与连接前授权。
- Flash 最终一轮 12 项 UI 测试通过。此前在新夹具上连续两轮 24 项通过;测试主动关闭自己创建的 PTY,避免反复验收耗尽 SSH 会话通道。
- 从最终
.tgz安装至隔离 profile,24 项真实 DSH 集成检查通过。包括工作台文件在会话旁的右栏打开、授权后rw_connect可用、原生右侧栏、六类监控、Markdown 草稿与保存、生产版 PDF 非空绘制、表单 / 旋转写回 SFTP,以及连接变化后拒绝待执行的移动操作。 - 详细记录:dsh-verification.json。预览图:
dsh-agent-rightbar-preview.png、dsh-agent-monitor-preview.png、dsh-agent-pdf-preview.png。
桌面实机验收与安装
已将最终安装包从 0.1.1 升级到日常 desktop profile 的 0.2.0,并完全重开 DSH。其他插件依赖、bundle 顺序和 Cordis 配置保持原样;安装后的 Host / Client JS 与发行包逐字节一致。
在实际 dsh-app://app/ 窗口中,通过会话标题栏按钮打开原生右侧 Agent,中央聊天和输入框保留。使用自动生成的临时本机 SSH 服务器验证:
- 资源监控显示本机真实 CPU、内存与磁盘数据;GPU 缺项说明正常。
- Markdown 源码和预览正常,
DESKTOP_VERIFIED标记经 UI 保存到实际远程文件。 - PDF 在桌面专用协议下绘制正常,
Operator表单改为Desktop verified,旋转 90° 后保存;读取真实文件确认表单和页面角度均已落盘,重新绘制无错误。 - 临时连接、主机信任、文件和 SSH 进程已清理;原先不存在的工作台配置文件恢复为不存在。再次重开 DSH 清除验收内存状态,原生右侧 Agent 面板保持打开。
详细结果:desktop-verification.json。桌面验收没有发送模型消息或使用用户远程服务器。
范围与限制
文本编辑仅支持 1 MiB 内 UTF-8;二进制预览和 PDF 保存上限 25 MiB。其他格式可下载。HTML / SVG 只作为源码处理,Markdown 预览经过清理,外部图片主动点击后加载。
PDF 编辑包括批注、表单与旋转,不包含任意排版修改、OCR、数字签名或嵌入字体替换;中文批注采用栅格图像。
macOS 的 GPU、逐核心与磁盘 I/O 实时指标不可用。Linux NVIDIA / AMD 解析已用确定性数据测试,当前验收机器没有对应 GPU,未进行物理显卡实测。
隔离集成检查不发送外部模型请求;工具探针直接调用已注册的工具定义,不代替完整 DSH 原生工具审批流程测试。未使用用户真实远程服务器或凭据。
发行与回滚
安装包:releases/dsh-remote-workbench-0.2.0.tgz。源代码快照与 SHA-256 清单位于同目录;历史 0.1.0 / 0.1.1 包保留。桌面 profile 的清单、锁文件与配置已在安装前备份至本地 .dev/backups/。
最低版本为 DSH 0.2.2-rc.3,使用原生右侧栏扩展接口。升级后完全退出并重新打开 DSH,以装载新的客户端模块。
安装包大小:6,054,617 字节;SHA-256:
b40cf44ddb76365d9c501b8669c491e91cbf4542c89d1993299ec88486c19339
安装
gh release download v0.2.0 --repo Freakz2z/dsh-remote-workbench --pattern '*.tgz'
dsh plugin --profile desktop add ./dsh-remote-workbench-0.2.0.tgz安装后完全退出并重新打开 DSH。要求 DSH ≥ 0.2.2-rc.3 < 0.3.0。
