dsh-easyssh 使用指南

让 DSH Web GUI 一键切换至 SSH 模式，在远程服务器上读写代码、跑命令，左侧文件树与 LLM 工具透明跟随。

本文为派生内容（基于 wiki / faq / compatibility_json 自动组装），非 AI 即时创作。

本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

— 源: plugin_wiki.wiki_content

dsh plugin --profile web add --allow-build=dsh-easyssh github:chenw2759-wq/dsh-IDE#path:packages/dsh-easyssh

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

🖥️ 右侧边栏：可停靠的右栏抽屉——文件树 + 预览/编辑同框；拖 tab 拖出成浮窗，拖回右缘自动停靠（下框 / 右栏 / 浮动 / 三栏 IDE 四态切换）
📄 预览：Markdown / HTML / 图片 / CSV / Office（docx / xlsx / pptx）/ 日志等多格式直接预览
✏️ 编辑：代码即时编辑（语法高亮 + 行号 + 斑马纹）+ Markdown/HTML Word 式可视化编辑 + Office 框内富文本编辑
🧩 IDE：文件树、命令行终端、Trae 风格红绿 diff、类型颜色标签、Git 角标、监视路径——开箱即用的 JupyterLab 式工作区
下框展示（⇊）：预览显示在下栏

— 源: plugin_wiki.readme_zh (fallback readme_raw)

这个插件和官方 dsh-ssh 是什么关系？

dsh-easyssh 复用 dsh-ssh 的 SSH 引擎与主机配置（~/.dsh/dsh-ssh.json），并在其上加一层「工作区」：把文件操作和子进程接缝透明切换到远程主机，模型日常的 read/write/edit/bash 工具在 SSH 模式下直接作用于远程。

安装后还需要手动改配置文件吗？

不需要。插件自带 dsh.bundle.patch（cordis.patch.yml），安装时会自动禁用部署自带的 fs-sandbox/subprocess 行并插入 easyssh-fs / easyssh-subprocess 两个接缝行；重启 dsh 后即生效。

SSH 模式下模型的普通工具会受影响吗？

在 SSH 模式下，模型本机的 read/write/edit/glob/grep 与 bash/终端工具会透明路由到远程主机执行，路径以远程根目录 remoteRoot（默认登录用户的 ~）为基准；显式的 remote_* 工具仍可用作精确操作。

配置文件存在哪里？是否安全？

沿用 dsh-ssh 的 ~/.dsh/dsh-ssh.json（权限 0600/0700），密码以明文保存在用户主目录下的私有文件里；HTTP API（/api/dsh-easyssh/*）仅接受 loopback 请求并校验同源，禁止跨站调用。

支持哪些平台？Windows 远程主机可以吗？

客户端跨平台；远程主机依赖 SSH、SFTP、GNU find/grep/coreutils（-printf/-mz/base64 -w0），因此对类 POSIX 主机（Linux/macOS）支持最完整，SSH 模式下不要使用 Windows 本机路径（C:\、M:\ 等）。

有哪些使用限制？

进程内模式状态为单例（多标签页共享，P2 才按 sessionId 隔离）；预览仅限 80KB 以下文本，二进制/超大文件请改用 ssh_exec/ssh_download；远程 grep/glob 限深 4~6 层、限 200 条；远程模式不经过本机沙箱。

— 源: plugin_wiki.faq_json

— 源: plugin_wiki.compatibility_json

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则