前言¶
DeepSeek Harness (DSH) 的设计理念是“一切皆插件”。在本地编写代码并管理远程服务器之间建立连接，是常见的开发场景。dsh-ssh-files-sidebar 插件为 DSH 提供了完整的 Remote SSH 工作区，整合了文件管理、终端操作、远程编辑以及从零到一的部署闭环能力。
核心功能¶
该插件由 qigelunbiya 维护，属于“工作流”类别。它是一个 Remote SSH workspace & deployment Agent，支持 SSH Files、Terminal、远程编辑，以及基于 DEPLOYMENT.md 的自动化部署与回滚。
-
Remote SSH Workspace
插件内部整合了文件侧栏、终端与远程编辑功能。SSH 主机与凭据只维护一份，存储在~/.dsh/dsh-ssh.json中。一个 Conversation 仅绑定一个 SSH 目标，防止 Agent 枚举或切换主机。 -
SSH Files / SFTP / Terminal
支持远程目录树浏览、编辑（基于 CodeMirror）、上传下载、多选、归档查看（TAR/TGZ/ZIP 等）、图片预览（PNG/JPG/GIF 等）以及远程 Terminal 操作。 -
本地源码 + Linked SSH
推荐的日常开发模式为：本地 Workspace 写代码，会话绑定唯一 SSH 目标，用于服务启动、日志查看和端口检查。 -
Remote Vision / OCR
Agent 可以直接读取当前 SSH 上的图片进行视觉分析，或调用系统 OCR，无需先将截图复制到本地 Workspace。 -
Zero-to-One Bootstrap
对于陌生的项目，插件不会盲目生成DEPLOYMENT.md。它会先只读检查本地项目（技术栈、运行时、入口）和远程服务器（OS、架构、权限、端口），生成 Bootstrap Plan 并逐步验证。只有在第一次真正稳定后，才会将实际成功路径沉淀为DEPLOYMENT.md。 -
Runbook 与自动化边界
插件将部署流程沉淀为DEPLOYMENT.md。在生成脚本前，会通过标记（AUTOMATE / KEEP MANUAL 等）与用户确认真实使用习惯。最终脚本仅自动化用户真正希望交给机器的部分。 -
Agent 自主发布与闭环
验证通过后，Agent 的角色从“给命令”升级为“执行发布”。它可以自主执行已验证的自动化、自检进程/端口/日志、总结变更集，并在用户验收后进行诊断、修复或回滚。
安装与启用¶
推荐使用预构建的 GitHub Release 包，无需自行构建。
dsh plugin --profile web add https://github.com/qigelunbiya/dsh-ssh-files-sidebar/releases/latest/download/dsh-ssh-files-sidebar.tgz
安装后启动 Web Profile：
dsh web
典型用法¶
- 连接与文件操作: 连接 Linux 服务器，通过侧栏浏览、编辑、上传或下载远程文件。
- 本地开发 + 远程服务: 在本地 Workspace 编写代码，通过 Linked SSH 在服务器上启动服务、查看日志或检查端口。
- 陌生项目部署: 接手仅有源码和目标服务器的项目，Agent 可通过 Zero-to-One Bootstrap 分析环境，尝试部署并生成 Runbook。
- 流程沉淀: 将跑通的部署步骤写入
DEPLOYMENT.md，经用户确认后转化为自动化脚本。
注意事项¶
- 会话锁定: 一个 Conversation 只操作一个 SSH 目标。
- 权限控制: 高风险动作仍走 Harness 原生审批。陌生项目 Bootstrap 期间，不会为了“让它跑起来”默认修改全局 Runtime、防火墙、反向代理或数据库。
- 回滚策略: 除非用户已经明确批准自动回滚条件，否则生产异常不会静默自动回滚。
总结¶
该插件通过将 SSH 工作区与部署 Agent 融合，帮助开发者从手动操作走向自动化闭环。如需更多信息或源码，可访问其 GitHub 仓库。
