SSH 远程开发 gooesman/dsh-plugin-remote-dev

@goosesman/dsh-plugin-remote-dev

DeepSeek Harness 的 SSH 远程开发插件

功能 • 安装 • 使用 • API • 开发 • 贡献

📖 项目介绍

dsh-plugin-remote-dev 是 DeepSeek Harness 的 SSH 远程开发插件，提供完整的远程服务器管理能力。界面直观，模型工具丰富，你可以在 DSH 里无缝开展远程开发工作。

✨ 核心特性

- 🔐 认证方式灵活：支持密码认证和 SSH 密钥认证
- 🔍 指纹管理智能：主机指纹可临时保存，也可永久保存
- 🚀 公钥一键推送：自动把本地公钥部署到远程服务器
- 📁 文件操作完整：读取、写入、列出远程文件
- 💻 命令执行：在远程服务器上执行任意 shell 命令
- 🔌 端口转发：支持 SSH 本地端口转发
- 🔄 后台进程：管理长期运行的远程进程
- 🎨 可视化界面：悬浮面板，操作直观
- 🛠️ 工作区管理：设置并浏览远程工作目录

🎯 功能特性

SSH 连接

- ✅ 密码认证（自动处理 SSH_ASKPASS）
- ✅ 密钥认证（支持多种密钥格式）
- ✅ 指纹策略选择
- persistent：永久保存，持久信任
- temporary：会话期间临时信任
- ✅ 自动验证主机密钥

文件管理

- 📄 读取远程文件（最大 200KB）
- ✍️ 写入远程文件（最大 512KB）
- 📂 列出目录内容
- 📋 详细列表（ls -la 格式）

命令执行

- ⚡ 同步执行命令
- ⏱️ 超时可配置（默认 60 秒）
- 📊 标准输出与错误分开返回
- 🔄 检测超时

高级功能

- 🔀 SSH 端口转发
- 启动、停止、列出转发
- 支持任意远程主机
- 🔄 后台进程管理
- 启动长期运行进程
- 实时读取输出
- 优雅终止进程
- 🔑 公钥部署
- 自动查找本地公钥
- 推送操作幂等
- 私钥永不离开本地

界面面板

┌─────────────────────────────────────┐
│ ● 远程开发 Remote Dev [—] │ ├─────────────────────────────────────┤ │ 主机 [192.168.2.10________] │ │ 端口 [22__] 用户 [zlth______] │ │ 密钥 [C:/Users/.../id_ed25519] │ │ 密码 [••••••••••••••••] │ │ │ │ 指纹策略：◉永久保留 ○临时保留 │ │ ☑ 连接后推送本机公钥（可选） │ │ │
│ [连接] [断开] SHA256:xxx... │
│ │
│ 远程工作区 │
│ [/home/user/project______] │
│ [设置] [浏览] │
│ │
│ ┌─ 日志 ─────────────────────────┐ │ │ │ connecting zlth@192.168.2.10...│ │ │ │ connected (password) ✓ │ │ │ │ home: /home/zlth │ │ │ │ fingerprint [永久]: SHA256:... ✓│ │ │ │ 公钥已推送：~/.ssh/id_ed25519.pub│ │ │ └──────────────────────────────────┘ │ └─────────────────────────────────────┘

📦 安装

方式 1：动态加载（推荐）

在 DSH 会话里直接用 cordis_define 工具加载插件。

1. 打开 DSH，调用 cordis_define 工具
2. 填写以下信息：

Plugin kind: new
ID Prefix: remd
Name: Remote Dev SSH
Purpose: SSH 远程开发：密码/密钥登录，指纹策略，可选公钥推送，远程工作区

3. 复制 Host 和 Client 代码（见下方）
4. 点击 Define，然后运行 cordis_run
5. 批准后，界面面板出现在页面右下角

Host 代码： 从 src/host/index.js 复制（去掉 export function apply(ctx) { 和最后的 export default { apply }）

Client 代码： 从 src/client/index.js 复制（去掉 import React from 'react' 和最后的 export default { apply }）

方式 2：Agent Preset

创建 Agent Preset 配置文件：

~/.dsh/.agent-presets/remote-dev/cordis.yml
name: Remote Dev SSH
plugins:
- name: remote-dev-ssh
path: /path/to/dsh-plugin-remote-dev

方式 3：npm 包（发布后）

npm install @goosesman/dsh-plugin-remote-dev

🚀 使用方法

快速开始

1. 连接服务器

// 密码认证
remote_connect({
host: "192.168.2.10",
port: 22,
user: "username",
password: "your_password",
hostKeyMode: "persistent",
pushKey: false
})

// 密钥认证
remote_connect({
host: "192.168.2.10",
user: "username",
keyPath: "~/.ssh/id_ed25519",
hostKeyMode: "persistent",
pushKey: true
})

2. 执行命令

remote_exec({
command: "ls -la /home/user",
timeoutMs: 60000
})

3. 文件操作

// 读取文件
remote_read({
path: "/home/user/file.txt"
})

// 写入文件
remote_write({
path: "/home/user/newfile.txt",
content: "文件内容" })

// 列出目录
remote_list({
path: "/home/user"
})

4. 设置工作区

remote_set_workspace({
path: "/home/user/project"
})

5. 端口转发

// 启动转发
remote_forward({
action: "start",
localPort: 9229,
remotePort: 9229,
remoteHost: "127.0.0.1"
})

// 停止转发
remote_forward({
action: "stop",
id: "f1"
})

6. 后台进程

// 启动进程
remote_process({
action: "start",
command: "node --inspect=0.0.0.0:9229 app.js"
})

// 读取输出
remote_process({
action: "read",
id: "j1"
})

// 停止进程
remote_process({
action: "stop",
id: "j1"
})

📚 API 文档

完整的 API 文档请查看 API.md

可用工具

| 工具 | 描述 |
| remote_connect | 连接 SSH 服务器 |
| remote_status | 查看连接状态 |
| remote_disconnect | 断开连接 |
| remote_exec | 执行远程命令 |
| remote_read | 读取远程文件 |
| remote_write | 写入远程文件 |
| remote_list | 列出远程目录 |
| remote_set_workspace | 设置工作区 |
| remote_forward | 端口转发管理 |
| remote_process | 后台进程管理 |
| remote_push_key | 推送公钥 |

🔧 配置说明

指纹策略

| 模式 | 说明 | 适用场景 |
| persistent | 永久保存主机指纹 | 可信的固定服务器 |
| temporary | 仅会话期间信任 | 临时服务器或测试环境 |

认证方式

密码认证

- 优点：简单直接
- 缺点：需要记住密码
- 注意：密码通过 SSH_ASKPASS 安全传递

密钥认证

- 优点：更安全，无需密码
- 缺点：需要配置密钥
- 支持：id_ed25519、id_rsa、id_ecdsa

公钥推送

- ✅ 幂等操作（多次执行不会重复）
- ✅ 私钥永不离开本地
- ✅ 自动处理权限设置
- ⚠️ 需要远程服务器有 SSH 访问权限

💻 开发

前置要求

- Node.js 16+
- npm 或 yarn
- Git
- SSH 客户端

本地开发

克隆仓库
git clone https://github.com/Gooesman/dsh-plugin-remote-dev.git
cd dsh-plugin-remote-dev

安装依赖
npm install

构建
npm run build

测试
npm test

发布
npm publish

项目结构

dsh-plugin-remote-dev/
├── src/
│ ├── host/
│ │ └── index.js # Host 端代码 │ └── client/ │ └── index.js # Client 端代码 ├── lib/ # 构建输出 │ ├── host/ │ ├── client/ │ └── types/ ├── package.json # npm 配置 ├── README.md # 项目说明 ├── API.md # API 文档 ├── CHANGELOG.md # 更新日志 ├── CONTRIBUTING.md # 贡献指南 ├── PUBLISH.md # 发布指南 ├── build.js # 构建脚本 └── .gitignore # Git 忽略

🤝 贡献

欢迎贡献代码！参与方式见 CONTRIBUTING.md。

快速开始

1. Fork 项目
2. 创建特性分支 (git checkout -b feature/amazing-feature)
3. 提交变更 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

📝 更新日志

版本历史详见 CHANGELOG.md。

📄 许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

🙏 致谢

- DeepSeek Harness - 强大的 AI 开发平台
- OpenSSH - SSH 协议实现

📞 联系方式

- GitHub Issues：报告问题或建议
- Email: goosesman@example.com

⭐ 支持

如果这个项目对你有帮助，请给一个 ⭐ Star！

Made with ❤️ by Gooesman