# dsh-workspace-enhancement

[English](README.md) | 中文

![npm 版本](https://img.shields.io/npm/v/dsh-workspace-enhancement) ![许可证](https://img.shields.io/npm/l/dsh-workspace-enhancement) ![Node 版本](https://img.shields.io/badge/node-%3E%3D22-339933) ![dsh-plugin](https://img.shields.io/badge/dsh-plugin-2ea44f)

DeepSeek Harness 插件：本地和远程（SSH）工作区放在一起管。远程执行走一条 SSH（可多级跳板），bash、文件、PTY、LSP 共用这条连接；多机注册表带 TOFU 指纹和 OS 钥匙串；Web UI 负责加工作区和改机器设置；另外提供 3 个 `sw_*` 模型工具。底层用 [ssh2](https://github.com/mscdex/ssh2)。

## 功能列表


| 功能     | 说明                                                                                               |
| ------ | ------------------------------------------------------------------------------------------------ |
| 远程工作区  | `ctx.subprocess` + `ctx.fs` 远程 provider：一条 SSH（多级跳板）跑 bash / 文件 / PTY / LSP。走这两条缝的工具不用改就能切到远程    |
| 多机注册表  | `remote-workspaces/machines.json` + `ssh://<id>/<path>` 路由；能认 `~/.ssh/config` 别名                 |
| 安全     | TOFU 主机指纹（`accept-new` / `verify` / `off`）；按机器存 OS 钥匙串（DPAPI / security / secret-tool）；错误消息里脱敏凭据 |
| Web UI | 添加工作区（连接侧栏 + 远程目录浏览）；机器设置页（增删改 / 测试 / 设当前 / 忘指纹）                                                 |
| 模型工具   | `sw_status`、`sw_connect`（`save:false` 临时）、`sw_pick_workspace`                                    |




## 架构

```mermaid
flowchart LR
    subgraph local["本机"]
        agent["agent loop<br/>编排 · 记忆 · LLM 调用"] --> seam["本插件<br/>ctx.subprocess · ctx.fs"]
    end
    subgraph remote["远程主机"]
        run["bash · 文件 · PTY · LSP"]
    end
    seam -- "一条 SSH（可多级跳板）" --> run
```



远程不用装 DSH：模型在本地编排，命令在远程跑，结果再回本地进上下文。

## 安装

```sh
dsh plugin --profile web add <本仓库路径>   # 源码安装前先 npm run build（宿主加载 lib/）
```



## 路线图

当前进度与剩余里程碑：见 [docs/ROADMAP.md](./docs/ROADMAP.md)。

## 参考项目

- [dsh-ssh](https://github.com/UynajGI/dsh-ssh)：远程执行引擎——`ctx.subprocess` / `ctx.fs` provider、跳板链、PTY、directory-picker 接缝、`session.route` 占位。
- [dsh-remote](https://github.com/flymysql/dsh-remote)：工作区助手——machines 注册表、TOFU、OS 钥匙串、Web UI 与设置页。



## License

MIT