# dsh-remote-shell

DSH（DeepSeek Harness）插件，打包 **remote-shell** 技能：安全的 SSH / SFTP / Telnet / WinRM 远程操作，内置加密凭证库（Fernet + PBKDF2-HMAC-SHA256）。

English version: [README.md](./README.md)。

## 安装

从 npm 注册表（发布后）：

```bash
dsh plugin --profile web add dsh-remote-shell
```

从本地检出（开发 / 测试）：

```bash
dsh plugin --profile web add /path/to/dsh-remote-shell
```

安装后重启 `dsh web` 使插件生效。技能会以 `remote-shell` 出现在技能目录中（provider `dsh-remote-shell`，source `bundled`）。

## 功能

打包的技能提供：

- **远程命令执行**（SSH / WinRM / Telnet）：单条命令、批量执行、脚本执行、远程系统信息、健康检查。
- **SFTP 文件传输**：上传、下载、目录遍历。
- **加密凭证库**：登录/执行脚本不接受明文密码（无 `-p` 参数），强制从加密凭证库取用；使用 `credctl` 录入、查询、修改、删除凭证。
- **安全拦截**：修改类命令默认被拦截，需用户确认后以 `--auto-confirm` 执行。

## 工作原理

本插件是一个 Cordis 插件，注入单个**技能提供方**。加载时扫描打包的 `skills/` 目录中的 `SKILL.md` 文件，解析每个文件的 YAML frontmatter，并以 rank 600、source `bundled` 注册到宿主技能注册表。提供方是不可变的：不做文件监听或轮询；缺失或格式错误的技能会优雅降级（跳过，绝不抛错）。

## 行尾策略

打包的技能文件从源技能逐字节复制，而源技能使用**混合**行尾。`.gitattributes` 将每个文件钉住到其源行尾，使任何 `core.autocrlf` 设置下的检出都能精确复现源字节。`SKILL.md` 钉为 LF，因为提供方的 frontmatter 检测要求精确的 `---` 行——CRLF 检出会使提供方完全跳过该技能。

## 开发

运行单元测试（Node.js 内置测试运行器，无需额外工具）：

```bash
node --test
```

## 依赖

技能脚本为 Python 3，需要 `paramiko`（SSH/SFTP）、`pywinrm`（WinRM）等第三方库，首次使用时按技能 `SKILL.md` 中的指引安装。

## 安全声明

安装本插件即会在本机运行第三方代码。凭证库主密码由用户自行管理，插件不存储、不传输该密码。

## 许可

MIT — 见 [LICENSE](./LICENSE)。