@lengmoxxl/dsh-remote-workspace 0.1.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lengmoXXL
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,85 @@
+# dsh-remote-workspace
+
+A DSH plugin for working on another machine. It manages that machine's repositories and worktrees, routes the
+harness's file, shell, and terminal tools to the directory you opened, and adds terminal tabs to the right Sidebar.
+The model sees ordinary local paths.
+
+English | [中文](README.zh.md)
+
+![A session running tools inside a remote worktree](docs/screenshots/en/08-session.png)
+
+| Machines | Connected | A worktree |
+| --- | --- | --- |
+| ![The machine list](docs/screenshots/en/01-section.png) | ![A connected machine and its repository](docs/screenshots/en/03-connected.png) | ![A created worktree](docs/screenshots/en/06-worktree-created.png) |
+
+## Requirements
+
+- Node 22.19+ or 24+, with `ssh` configured as usual.
+- DSH `0.1.5-rc.2`. Other releases are untested.
+
+## Install
+
+```sh
+dsh plugin --profile web add @lengmoxxl/dsh-remote-workspace
+```
+
+The plugin takes over services the base profile provides, and the host plane holds one implementation per service. Add
+these four lines to `$DSH_HOME/profiles/web/cordis.patch.yml`. Without them the plugin still loads, does not route, and
+says so on stderr.
+
+```yaml
+- id: subprocess
+  disabled: true
+- id: fs-sandbox
+  disabled: true
+- id: bash-sandbox
+  disabled: true
+- id: pwsh-sandbox
+  disabled: true
+```
+
+Then start the profile with `dsh --profile web`. The package ships the built `lib/`, so nothing is compiled on this
+machine. To work on the plugin itself, clone the repository, run `npm install && npm run build`, and add the checkout
+path instead.
+
+## What it does
+
+- Adds machines over SSH, and a built-in `Local` machine for this host. The agent is downloaded from this repository's
+  Releases, checked against `SHA256SUMS`, and reached over `ssh -L`, so nothing has to be installed on the machines.
+- Registers any directory as a repository. Git is not required, and a plain directory can become a repository later.
+- Cuts worktrees from a repository, adopts worktrees that already exist, or opens the repository directory itself.
+  Removing a worktree can delete its branch as well.
+- Opens a directory as a workspace; the file, shell, and terminal tools then run on the machine that owns it.
+- Opens terminal tabs in the right Sidebar, one per Session. The **Terminal** entry first lists that Session's live
+  shells — including one a page reload or a closed tab detached — so one can be reattached or ended.
+- Lets the agent work in a terminal that has a tab open. It lists them, reads output, writes text and keys (including
+  `ctrl+c`), and waits for output to appear. It does not create or close terminals.
+
+## Usage
+
+**Settings → Remote workspaces.** Add a machine with an SSH destination and a token — any string; it is the daemon's
+shared secret. `Local` needs neither. Machines connect on their own, and one that stays unreachable shows a **Connect**
+button. Register a repository, then use a row's menu to open, close, or remove what it holds.
+
+**Terminal.** The right Sidebar's add control has a **Terminal** button: it lists the Session's live terminals and
+offers a new one. **Manage terminals** in the panel's status bar opens a second terminal tab beside the one in view, where
+the chooser offers a fresh shell or one that is already running; a shell another tab already shows is marked
+**Already open**, and picking it brings that tab forward. Closing a tab leaves that shell running — it shows up in the
+chooser as detached — and a row's close control in the chooser, which the panel's **Manage terminals** control opens, is what ends it.
+Hiding the tab, switching Session, or collapsing the sidebar also leaves a shell running.
+
+**Terminal appearance.** Font, size, line height, scrollback, and cursor blink live in the shell's own settings:
+**Settings → Plugins → Plugin configuration → Terminal appearance**. They are stored in the settings document, so every
+page of this deployment draws a terminal the same way.
+
+## Config
+
+| Field | Default | Meaning |
+|---|---|---|
+| `worktreeRoot` | `~/.dsh/worktrees` | Root every managed checkout is cut under, on every machine. |
+| `shell` | unset | Program the Sidebar terminal runs; unset uses the machine's own login shell. |
+| `shellArgs` | `['-l']` | Arguments after `shell`; ignored while `shell` is unset. |
+| `graceMs` | `3000` | How long a closing terminal is given to exit, in milliseconds. |
+| `detachGraceMs` | `0` | Safety valve: how long a terminal whose socket went away (a reload, a dropped connection) is kept for a reattach, in milliseconds. `0` — the default — keeps it for as long as its process lives. |
+
+MIT

package/README.zh.md

@@ -0,0 +1,78 @@
+# dsh-remote-workspace
+
+一个在另一台机器上工作的 DSH 插件。它管理那台机器的仓库和 worktree，把 harness 的文件、shell 和终端工具路由到你
+打开的目录，并在右侧边栏加上终端标签页。模型看到的是普通本地路径。
+
+[English](README.md) | 中文
+
+![在远端 worktree 里执行工具的会话](docs/screenshots/zh/08-session.png)
+
+| 机器列表 | 已连接 | 切出的 worktree |
+| --- | --- | --- |
+| ![机器列表](docs/screenshots/zh/01-section.png) | ![已连接的机器与仓库](docs/screenshots/zh/03-connected.png) | ![已创建的 worktree](docs/screenshots/zh/06-worktree-created.png) |
+
+## 环境要求
+
+- Node 22.19+ 或 24+，以及按平时方式配好的 `ssh`。
+- DSH `0.1.5-rc.2`。其他版本未测试。
+
+## 安装
+
+```sh
+dsh plugin --profile web add @lengmoxxl/dsh-remote-workspace
+```
+
+插件要接管 base profile 提供的服务，而 host plane 每项服务只允许一个实现。把这四行加进
+`$DSH_HOME/profiles/web/cordis.patch.yml`；缺了它们插件仍会加载、但不会路由，并在 stderr 上说明。
+
+```yaml
+- id: subprocess
+  disabled: true
+- id: fs-sandbox
+  disabled: true
+- id: bash-sandbox
+  disabled: true
+- id: pwsh-sandbox
+  disabled: true
+```
+
+然后用 `dsh --profile web` 启动。包里带着构建好的 `lib/`，本机不编译任何东西。改插件本身时，改为 clone
+仓库、`npm install && npm run build`，再添加检出目录。
+
+## 功能
+
+- 通过 SSH 添加机器，以及一个操作本机的内置 `Local` 机器。agent 从本仓库 Releases 下载、用 `SHA256SUMS` 校验、
+  经 `ssh -L` 到达，所以机器上不需要安装任何东西。
+- 把任意目录登记为仓库；不要求是 git 仓库，普通目录之后也可以变成仓库。
+- 从仓库切 worktree、纳入已存在的 worktree、或直接打开仓库目录；删除 worktree 时可以选择连分支一起删。
+- 把目录打开为工作区后，文件、shell 和终端工具都跑在拥有它的那台机器上。
+- 在右侧边栏开终端标签页，每个会话一个。**终端**按钮会先列出该会话中仍在运行的终端（包括刷新页面或关闭标签后脱离
+  的那个），可以重新接入，也可以结束。
+- agent 可以在**开着标签的**终端里干活：列出终端、读输出、输入文本和按键（包括 `ctrl+c`）、等待输出出现。它不会
+  创建或关闭终端。
+
+## 使用
+
+**设置 → 远程工作区。** 用 SSH 目标和 token（任意字符串，是 daemon 的共享密钥）添加机器；`Local` 两项都不需要。
+机器会自动连接，一直连不上的显示**连接**按钮。登记仓库后，用每行的菜单打开、关闭或移除它持有的东西。
+
+**终端。** 右侧边栏的添加控件里有一个**终端**按钮：它会列出该会话在运行的终端，也可以新建一个。面板状态栏里的
+**管理终端**会在当前标签旁再开一个终端标签页，由列表让你接入已有 shell 或新建一个；已被其他标签打开的终端标为
+**已打开**，选中它会切到那个标签。关闭标签只是让它脱离：
+shell 会继续在主机上运行，并在列表里显示为已断开；要结束它，用列表里每行的关闭按钮。隐藏标签、
+切换会话、收起边栏同样不会中断它。
+
+**终端外观。** 字体、字号、行高、回滚行数和光标闪烁在 shell 自己的设置里：**设置 → 插件 → 插件配置 → 终端外观**。
+它们存在设置文档里，所以这个部署的每个页面画出来的终端都一样。
+
+## 配置
+
+| 字段 | 默认值 | 含义 |
+|---|---|---|
+| `worktreeRoot` | `~/.dsh/worktrees` | 每台机器上切出的检出所在的根目录。 |
+| `shell` | 未设置 | 侧边栏终端运行的程序；未设置则用机器自己的登录 shell。 |
+| `shellArgs` | `['-l']` | `shell` 之后的参数；`shell` 未设置时忽略。 |
+| `graceMs` | `3000` | 关闭终端时留给它退出的时间（毫秒）。 |
+| `detachGraceMs` | `0` | 安全阀：终端 socket 断开（刷新页面、连接掉线）后保留多久等待重新接入（毫秒）。`0`（默认）表示只要进程还在就一直保留。 |
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# dsh-remote-workspace bundle patch: one insert, nothing else.
+#
+# The stock rows this plugin routes are disabled by the deployment's own patch
+# layer (the README lists the four lines): a submitted bundle must not take over
+# components it does not own — DSH-Store rule 7, and the entry ids already
+# belong to other submissions.
+
+- insert:
+    - id: dsh-remote-workspace
+      name: "@lengmoxxl/dsh-remote-workspace"