dsh-ssh-ops

中文 · English DSH SSH Ops v0.4.8：新增服务器配置的加密导出与导入，方便跨电脑迁移；SSH 终端新增外观设置和可选字体语义高亮。最低支持 DSH 0.2.0。详见 版本说明。 DeepSeek Harness 的 SSH 运维插件：在主对话中驱动当前服务器，同时在右侧保留真实的交互式终端，并集成文件管理、端口转发与数据库管理。

📖 第一次使用？请从产品文档开始——十分钟上手、功能详解、安全模型与场景配方。 v0.4.7：新增流式下载校验、断线及可选跨重启续传，文件编辑差异预览和备份恢复；修复会话日志脱敏与 SFTP 删除目标解析，并更新依赖。跨重启续传会在浏览器本地明文暂存未完成文件，默认关闭。Desktop 新增界面完整交互尚待实机验证。 v0.4.5：新增 sftp_upload_file 单文件并发上传，支持 AI 上传任务进度、取消和当前进程内校验续传；提交前校验远端文件完整性。修复部分宿主的 ssh2 导入兼容问题，为自动重连增加异常兜底；补齐英文工具文档，并说明 DSH 注册表插件更新的适用范围。详见 CHANGELOG.md。 v0.4.4：文件面板新增远程文件搜索与传输任务列表（上传进度、取消、失败清理）；插件内一键更新移除，改为宿主插件管理与手动更新指引（防 link 挂载被静默覆盖）；适配新版宿主设置图标，修复可选服务未注入时面板空白。详见 CHANGELOG.md。 更新方式：设置页提供更新指引。线上安装通过 DSH 插件管理页更新；本地链接请在源码目录更新。插件不再自行执行安装。 兼容性 目标宿主：DSH Desktop / Web Profile，经 engines.dsh 声明为无上界区间 >=0.2.0——宿主自 0.2.1-alpha.4 起优先按该字段判定插件兼容性（includePrerelease 语义，engines.dsh 单独定夺、peer 不再参与门槛），覆盖 0.2.0 起的宿主版本（预发布版本的判断以宿主实现为准），宿主升级无需发版跟进；四个官方包的 peerDependencies 保持各自的兼容范围，继续承担 npm 安装期职责。当前开发环境已验证 0.2.0-rc.2 桌面版。插件使用 DSH 自带的 Node.js 运行时，不要求系统另装 ssh、sftp 或独立 Node.js。 新版右侧边栏（必需）：宿主须同时提供 sidebarRightTabs 与 sidebarRight，SSH 以官方右侧边栏标签运行，支持宿主分栏、缩放和全屏。缺少这两个 API 的旧版宿主不再有浮动面板回退（已移除）：插件宿主半（Agent 的 SSH/SFTP/数据库工具）照常工作，但不会显示终端 UI。 界面语言：自动跟随宿主语言（中文 / English），并随运行中切换即时重绘；宿主运行插件未内置的第三方语言（如俄语）时回退为默认中文并回写设置文件——此类环境可通过设置文件钉住语言（autoApplySystemLanguage: false + language，详见「使用」一节）。 文件字节流：大文件的浏览器上传／下载路由仅在 Web Profile 同时提供 webServer 与请求来源校验服务时注册；不具备该接口的宿主

主对话直接指挥已连接的服务器，SSH 终端作为官方右侧边栏标签与对话并排显示：

文件页签支持 SFTP 管理，并可用 cd 将交互终端切换到选中的远程目录：

能做什么 官方右侧边栏集成（新版 DSH）：SSH 终端是官方右侧边栏的一个标签页（与内置「文件」并列），聊天顶部的 SSH 按钮打开或聚焦该标签（重复点击只聚焦、不重复创建）；需要同时看文件和终端时使用官方分栏，拖宽、全屏、收起全部由官方管理，终端尺寸随之自动重算。分栏时每个窗格独立：各自维护可见的服务器与选中项，新窗格默认空白、不继承已有服务器；同一台服务器在两栏打开会各建一条独立连接（可在连接对话框勾选复用），关掉其中一栏不影响另一栏，某台服务器不再被任何窗格显示时才真正断开宿主连接。被 Agent 使用的连接带「Agent」徽标，点另一栏即可把 Agent 切过去。连接生命周期与标签显示分离：切换标签、收起侧栏、关闭标签、切换聊天都不会断开 SSH；终端实例常驻内存池，重新打开即恢复完整回看，隐藏期间服务器输出由宿主缓冲、重开时自动补齐。 终端显示设置：服务器栏的调色盘按钮提供跟随 DSH／固定深浅主题、按主题自定义背景和可选语义高亮（默认关闭）。配色方案支持颜色与正则标签编辑、拖动或 Alt+↑/↓ 排序、实时可编辑预览、当前主题重置和 JSON 备份。设置即时应用到所有终端和分栏，保存在当前浏览器并同步同源窗口；远端 ANSI/truecolor 和字体样式优先，日志页签原有高亮保持独立。详见终端显示说明。 在 设置 → SSH 资源 中管理任意数量的服务器和分组；它作为左侧菜单的一等项，与通用设置、模型并列，不再藏在“插件”下。顶部的 SSH 仅打开或聚焦右侧终端标签，不断开连接。 跨电脑迁移：服务器分组旁可导出和导入加密备份，包含服务器配置、分组、共享凭据、密码、私钥、跳板关系和已信任主机指纹。备份使用独立口令加密；导入新增服务器并复用同名分组，不覆盖已有服务器。数据库连接、全局 AI 策略和本机工作区绑定不包含在内。 固定远程项目目录：每台保存的服务器可选填一个绝对路径作为默认项目目录。资源卡片上的“进入项目”会建立连接、在经过空闲 shell 与单 PTY 校验后切换终端目录，并让 SFTP 从同一路径载入；目录不接受相对路径或控制字符。未设置的资源仍从登录目录和 SFTP 根目录开始。 远程工作区：在「编辑 SSH 资源 → 高级选项」里（就在「默认项目目录」下面）可以把某个 DSH 工作区绑定到「这台服务器 + 一个远端绝对路径」——之后该工作区里 Agent 调用的 sftp_* 默认落到远端这个目录（相对路径以它为根）、默认使用绑定的服务器，对话上下文里也会写明文件在远端，Agent 不再把本地空目录当成项目。边界是明说的：DSH 原生的 read/write/edit/glob/grep 与本地 bash 仍在你自己机器上（宿主只挂载一个文件系统后端，插件不碰它），所以「远程工作区」不是远端挂载——远端读写请走 sftp_* 或