# @goodandready/dsh-remote-workspace 中文文档

规范地址：https://npmcn.com/package/%40goodandready/dsh-remote-workspace/

版本：0\.3\.29
npm 元数据更新时间：2026-11-14T13:20:26.324Z
中文译文更新时间：2026-11-16T19:13:33.225Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40goodandready/dsh-remote-workspace
原文对照：https://npmcn.com/package/%40goodandready/dsh-remote-workspace/?lang=original
项目主页：https://github.com/GooDAnDReaDY/dsh-remote-workspace#readme
源码仓库：https://github.com/GooDAnDReaDY/dsh-remote-workspace

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：579 kB，51 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：1 个
- peer 依赖：@deepseek-ai/cordis ^4\.0\.1，@deepseek-ai/dsh-tools ^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1，@deepseek-ai/schemastery ^3\.18\.4，@deepseek-ai/dsh-settings ^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1，@deepseek-ai/dsh-host-webserver ^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1
- 首次发布：2026-09-10T18:19:11.003Z
- 最新版本发布：2026-11-14T13:20:26.161Z
- 近 30 天下载量：4100（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：33（近 12 个月 33 个）

## 中文简介

DeepSeek Harness的企业远程工作空间插件:SSH2连接池,SFTP操作,3向冲突-意识到镜像同步,端口转发,以及本土DSH UI.

## 安装

```sh
npm install @goodandready/dsh-remote-workspace
```

也可以使用：`pnpm add @goodandready/dsh-remote-workspace`、`yarn add @goodandready/dsh-remote-workspace`、`bun add @goodandready/dsh-remote-workspace`

## README

# 📦 @goodandready/dsh-remote-workspace

### 适用于 DeepSeek Harness 的企业级远程工作区插件：SSH、SFTP 文件同步与端口转发

[![npm version](https://img.shields.io/npm/v/@goodandready/dsh-remote-workspace.svg?style=for-the-badge&color=6366f1&labelColor=1e1b4b)](https://www.npmjs.com/package/@goodandready/dsh-remote-workspace) [![license](https://img.shields.io/github/license/GooDAnDReaDY/dsh-remote-workspace.svg?style=for-the-badge&color=10b981&labelColor=064e3b)](https://npmcn.com/package/%40goodandready/dsh-remote-workspace/LICENSE) [![DSH Plugin](https://img.shields.io/badge/DSH-Plugin-8b5cf6.svg?style=for-the-badge&labelColor=2e1065)](https://github.com/topics/dsh-plugin) [![Node version](https://img.shields.io/badge/Node-20%2B-f59e0b.svg?style=for-the-badge&labelColor=451a03)](https://nodejs.org/)

[![GoodAndReady Showcase](https://img.shields.io/badge/%E4%BD%9C%E8%80%85%E5%85%A8%E9%83%A8%E9%A1%B9%E7%9B%AE-goodandready.app-ff4500.svg?style=for-the-badge&logo=rocket&logoColor=white&labelColor=1a1a2e)](https://goodandready.app/)

[**🇬🇧 English**](https://npmcn.com/package/%40goodandready/dsh-remote-workspace/README.md) • [**🇷🇺 Русский**](https://npmcn.com/package/%40goodandready/dsh-remote-workspace/README.ru.md) • [**🇨🇳 中文说明**](https://npmcn.com/package/%40goodandready/dsh-remote-workspace/README.zh.md)

<table><tbody><tr><td align="center">⭐ <strong>如果您喜欢这个插件，请在 GitHub 上为它点亮 Star</strong> — 这能让我知道插件对您有用，并鼓励我继续开发和维护它。<br><br>🐛 <strong>如果您发现 Bug 或希望增加功能</strong>，请使用任意语言在 GitHub 上提交 Issue — 我会评估您的建议，并在后续版本中实现有价值的改进。</td></tr></tbody></table>

* * *

## ⚡ 概述与解决的核心痛点

在现代软件工程与智能体工作流中，由 **DeepSeek Harness (DSH)** 驱动的 AI Agent 往往需要跨越本地限制，在远程基础设施中开展编码与部署工作，例如高性能 GPU 计算节点、云端虚拟机、预发布环境和容器集群。

若没有 `@goodandready/dsh-remote-workspace`，开发者与 Agent 将面临诸多瓶颈：

1.  **本地环境边界**：标准 DSH 的工具与运行环境完全受限于部署 DSH 的本地物理机。
2.  **临时脚本脆弱不堪**：使用系统命令封装的 SSH/SCP 缺乏连接池复用机制，在遇到网络延迟波动时易卡死或断连，且重连握手开销极大。
3.  **静默覆盖与文件损坏风险**：单纯的文件传输无法感知多端并发修改，且在网络中断时极易留下残缺破损的半成品文件。
4.  **服务端口隔离**：访问远程节点上启动的 Web 服务、调试端口或大模型推理接口，往往需要开发者在外部繁琐地配置端口映射。

`@goodandready/dsh-remote-workspace` 将企业级远程工作区能力无缝注入 Cordis 架构：提供基于 SSH2 的高性能连接池、具备原子写入保护的 SFTP、基于 SHA-256 的三向冲突感知同步引擎、动态端口转发隧道，以及参照 `dsh-clinebot` 风格精心打造的 Web UI 设置卡片。

* * *

## 🏗️ 架构设计

```mermaid
graph LR
  subgraph DSH["DeepSeek Harness (Cordis 运行时)"]
    UI["Web UI 设置卡片<br/>(dsh-clinebot 视觉风格)"]
    Routes["REST API 路由<br/>(/state, /browse, /test, /sync)"]
    Tools["模型工具集<br/>(remote_exec, remote_fs, sync, tunnel)"]
    Ssh["SshService<br/>(SSH2 连接池与心跳保活)"]
    SFTP["RemoteFsService<br/>(原子 SFTP 流式传输)"]
    Sync["MirrorSyncService<br/>(三向 SHA-256 同步引擎)"]
    Tunnel["TunnelService<br/>(本地端口转发)"]
  end

  subgraph RemoteNode["远程环境 (云主机 / GPU 算力节点)"]
    SSHD["SSH 服务端 (:22)"]
    FS["远程文件系统"]
    AppPort["远程开发服务 / 应用端口"]
  end

  UI -->|REST API| Routes
  Routes --> Ssh
  Routes --> SFTP
  Routes --> Sync
  Tools --> Ssh
  Tools --> SFTP
  Tools --> Sync
  Tools --> Tunnel
  Ssh -->|SSH2 通道 / 密钥或密码认证| SSHD
  SFTP -->|SFTP 子系统| FS
  Sync -->|增量 Pull / Push| FS
  Tunnel -->|本地端口映射| AppPort

  classDef default fill:#1e1e2e,stroke:#6366f1,stroke-width:1px,color:#cdd6f4;
  classDef accent fill:#313244,stroke:#a6e3a1,stroke-width:2px,color:#a6e3a1;
  class DSH,RemoteNode accent;
```

* * *

## ✨ 核心特性深度解析

### 1\. `SshService` — 高性能连接池与双认证支持

-   **持久连接池**：按 `host:port:username` 缓存已建立认证的 SSH2 客户端会话，极大降低重复握手延迟。
-   **双重认证方式**：
    -   **SSH 私钥认证**：支持读取本地私钥文件路径（如 `~/.ssh/id_ed25519`）、直接输入 PEM 格式密钥文本以及解密口令（Passphrase）。
    -   **密码认证**：原生支持常规账号密码安全登录。
-   **链路诊断探测**：内置 `testConnection` 方法，精确测定毫秒级网络延迟，并自动探测远程主机内核与架构（`uname -srm`）。
-   **心跳保活机制**：主动发送 Keep-Alive 探测包，有效防止各类网络防火墙超时断开空闲连接。
-   **代理命令与跳板**：`proxyCommand` 运行 OpenSSH 风格命令，令牌为 `%h`、`%p`、`%r`、`%n` 和 `%%`。`jumpHosts` 是按顺序排列的配置编号；`jumpHostId` 可以用逗号分隔作为后备。第一跳来自连接池，后续跳板使用独立连接，并在目标会话结束时关闭。
-   **代理与一次性验证码**：`agentPath` 指定 SSH 代理套接字。留空则使用 `SSH_AUTH_SOCK`；在 Windows 上可填写 `pageant`。需要键盘交互时，验证码显示在设置卡片上，60 秒后失效。
-   **空闲连接**：没有隧道、也没有正在执行的命令时，池中的连接在 30 分钟后关闭。下一次命令会重新连接。
-   **输出前重连**：如果连接在命令产生任何输出之前断开，同一命令最多再试 3 次。命令超时、已经开始的输出，以及 `idempotent: false` 不会重试。
-   **独立终端**：终端不共用连接池。关闭终端只关闭这一条 SSH 会话。

### 2\. `RemoteFsService` — 原子高可用 SFTP 文件系统

-   **原子安全写入**：文件首先上传至独立的临时文件（`.tmp.<timestamp>.<hash>`)，上传完成校验后通过原子重命名完成替换，彻底避免因网络异常产生残缺文件。
-   **高性能流式读取**：采用分块流式读取技术，高效传输大文件且不消耗过多内存。
-   **完整文件基语**：提供 `stat`、`listDir`、递归创建目录 `mkdir -p` 以及递归删除 `remove`。

### 3\. `MirrorSyncService` — 冲突感知的两向/三向镜像同步

-   **哈希状态基线**：在 `.dsh-sync-manifest.json` 中完整记录受控文件的 SHA-256 摘要。
-   **并发冲突拦截**：精准识别本地与远程自上次同步基线以来的同时变动，并在发生冲突时主动中断操作并输出详细冲突列表，绝不静默覆盖。
-   **定向传输模式**：支持 `pull`（远程 → 本地）和 `push`（本地 → 远程），并支持安全强制覆盖（`force`）参数。
-   **演练预览 (Dry-Run)**：支持在不产生任何实际磁盘写入的情况下，完整模拟输出变动、新增与删除文件清单。
-   **智能忽略规则**：内置对版本控制目录、依赖包及临时构建文件的过滤（`.git`、`node_modules`、`.dsh`、`.worktrees`、`.DS_Store`）。

### 4\. `TunnelService` — 深度集成的 SSH 端口转发

-   **本地端口转发 (Local Port Forwarding)**：在运行 DSH 的主机上开启本地监听端口，将流量通过加密 SSH 隧道透明转发至远程主机的指定端口（例如访问远程 `127.0.0.1:8080`）。
-   **生命周期管控**：支持动态开启、注销并实时查询活跃隧道列表。

### 5\. `tools.js` — 专为 AI Agent 设计的模型工具

为 Agent 赋予 4 个精简、正交的系统级能力：

-   `remote_exec`：在远程工作区执行 Shell 命令，获取标准输出、错误输出及返回码。
-   `remote_fs`：执行远程文件的读、写、状态查询、目录列表、创建与删除。
-   `remote_sync`：在本地镜像与远程目录间发起具备冲突感知的同步操作。
-   `remote_tunnel`：开启、关闭或枚举 SSH 端口转发隧道。
-   `remote_hosts`：返回不含密码、私钥和代理命令的主机 Markdown 表。`query` 必填，空字符串列出全部主机。
-   `remote_cluster`：在符合环境、标签和别名的主机上运行同一条命令。`maxWorkers` 默认 8。

### 6\. `client.js` — 原生 DSH 设置面板

-   深度适配 `settings.plugin.item` 插槽（Key: `dsh-remote-workspace`）。
-   **分段式认证切换器**：优雅切换私钥认证与密码认证。
-   **远程目录浏览器弹窗**：可视化浏览远程服务器目录树，支持面包屑导航与一键选取。
-   **实时连接状态徽章**：可视化展示连通性、网络延迟以及远程操作系统信息。页眉徽章读取 `/dsh-remote-workspace/state`，分别表示正在检查、没有活动主机、主机已就绪或状态不可用，不再固定显示“就绪”。
-   **快捷动作触发**：一键发起定向文件同步并监控隧道运行状态。保存、删除、设为活动、浏览目录或关闭隧道失败时，卡片上的警告会显示服务器返回的错误。连接测试提交的是配置本身，其中包含 `host`。
-   **插件列表名称**：英文为 `Remote Workspace`，中文为 `远程开发工作区`，取自随卡片加载的词典。
-   **更新版本**：该行显示状态接口返回的已安装版本。结果返回前显示“版本未知”。
-   **主机分组**：配置可以填写 `environment`、`tags`、`location` 和 `description`。卡片可按平铺、环境或标签显示，并一次测试整组。
-   **文件传输**：文件页可以上传和下载远程文件，按已传输字节显示进度，并可取消。超过 512MB 的文件会被拒绝。
-   **终端字体**：`terminalFontFamily` 是终端的 CSS 字体族。留空则使用默认等宽字体。
-   **隐藏页面**：浏览器标签隐藏时暂停状态轮询，回到页面后立即刷新。
-   **侧栏工作区**：左侧导航的“远程”按钮在中央区域打开主机、终端、文件、容器、隧道和集群。返回聊天只是隐藏该区域，终端内容保留。

* * *

## 📦 快速安装

通过 DSH `web` 配置文件安装：

```bash
dsh plugin --profile web add @goodandready/dsh-remote-workspace
```

或使用标准命令安装：

```bash
dsh plugin add @goodandready/dsh-remote-workspace
```

* * *

## ⚙️ 配置参数详解

可在 Web UI 的设置卡片中直接配置，或写入 DSH 配置文件（`settings.yaml`）：

```yaml
dsh-remote-workspace:
  activeProfileId: "prod-cloud-gpu"
  profiles:
    - id: "prod-cloud-gpu"
      name: "Cloud GPU VM"
      host: "remote.example.com"
      port: 22
      username: "deploy"
      authType: "key"              # 可选 "key" 或 "password"
      privateKeyPath: "/home/user/.ssh/id_ed25519"
      passphrase: ""
      password: ""
      remoteWorkspace: "/var/www/my-project"
      localMirrorPath: "/home/user/projects/my-project"
```

### 参数定义列表

| 参数名 | 数据类型 | 默认值 | 说明 |
| --- | --- | --- | --- |
| `profiles` | `Array<Profile>` | `[]` | 已配置的远程主机与工作区清单。 |
| `activeProfileId` | `string` | `""` | 当前激活使用的远程主机配置 ID。 |
| `profile.id` | `string` | `""` | 主机配置的唯一标识符。 |
| `profile.name` | `string` | `""` | 在 UI 中显示的主机友好名称。 |
| `profile.host` | `string` | `""` | 远程服务器的域名或 IP 地址。 |
| `profile.port` | `number` | `22` | SSH 服务端口。 |
| `profile.username` | `string` | `""` | 登录用户名。 |
| `profile.authType` | `string` | `"key"` | 认证方式：`"key"`（私钥）或 `"password"`（密码）。 |
| `profile.privateKeyPath` | `string` | `""` | 本地 OpenSSH 私钥文件的绝对路径。 |
| `profile.privateKey` | `string` | `""` | PEM 格式私钥文本内容（与路径二选一）。 |
| `profile.passphrase` | `string` | `""` | 加密私钥的解密口令。 |
| `profile.password` | `string` | `""` | 密码认证模式下的登录密码。 |
| `profile.remoteWorkspace` | `string` | `""` | 远程服务器上的项目工作区根目录。 |
| `profile.localMirrorPath` | `string` | `""` | 对应远程项目的本地镜像工作目录。 |
| `profile.agentPath` | `string` | `""` | SSH 代理套接字。留空使用 `SSH_AUTH_SOCK`。 |
| `profile.proxyCommand` | `string` | `""` | OpenSSH ProxyCommand。令牌：`%h` `%p` `%r` `%n`。 |
| `profile.jumpHosts` | `string[]` | `[]` | 跳板配置编号，第一台为入口。 |
| `profile.jumpHostId` | `string` | `""` | `jumpHosts` 为空时的逗号分隔跳板编号。 |
| `profile.environment` | `string` | `""` | 分组和集群过滤，忽略大小写。 |
| `profile.tags` | `string[]` | `[]` | 标签。集群过滤要求每个标签都匹配。 |
| `profile.location` | `string` | `""` | 位置说明。 |
| `profile.description` | `string` | `""` | 备注。 |
| `terminalFontFamily` | `string` | `""` | 终端 CSS 字体族。留空使用默认等宽字体。 |

* * *

## 🔌 Agent 模型工具接口规范

### `remote_exec`

在当前激活的远程主机上执行 Shell 命令。

-   **输入参数**：
    -   `command` (`string`，必填)：待执行的命令文本。
    -   `cwd` (`string`，选填)：远程执行工作目录（默认取当前配置的 `remoteWorkspace`）。
-   **返回数据**：`{ exitCode: number, stdout: string, stderr: string }`

### `remote_fs`

通过 SFTP 执行远程文件系统操作。

-   **输入参数**：
    -   `action` (`string`，必填)：可选 `"read"`、`"write"`、`"stat"`、`"list"`、`"mkdir"`、`"remove"`。
    -   `path` (`string`，必填)：目标远程路径。
    -   `content` (`string`，写入时必填)：写入文件的内容。
    -   `recursive` (`boolean`，删除时选填)：是否递归删除目录。
-   **返回数据**：根据不同操作返回对应数据（`{ content }`、`{ stat }`、`{ entries }`、`{ ok: true }`）。

### `remote_sync`

在本地镜像与远程服务器之间执行具备冲突感知的同步。

-   **输入参数**：
    -   `direction` (`string`，必填)：`"pull"`（远程拉取至本地）或 `"push"`（本地推送至远程）。
    -   `force` (`boolean`，选填)：若为 true，在检测到冲突时仍强制覆盖。
    -   `dryRun` (`boolean`，选填)：若为 true，仅演练并返回变动清单，不实际修改磁盘。
-   **返回数据**：包含处理文件清单、统计结果及冲突信息的汇总对象。

### `remote_tunnel`

管理 SSH 本地端口转发隧道。

-   **输入参数**：
    -   `action` (`string`，必填)：`"start"`、`"stop"` 或 `"list"`。
    -   `localPort` (`number`，启动时必填)：本地绑定的监听端口。
    -   `remotePort` (`number`，启动时必填)：远程目标转发端口。
    -   `tunnelId` (`string`，停止时必填)：需要关闭的隧道 ID。
-   **返回数据**：`{ tunnelId, localPort, remotePort }` 或隧道清单 `{ tunnels: [...] }`。

### `remote_hosts`

向模型返回不含秘密的主机表。

-   **输入参数**：
    -   `query` (`string`，必填)：按名称、主机或编号匹配。空字符串列出全部。
-   **返回数据**：Markdown 表。密码、私钥、密钥路径、口令、代理套接字和代理命令不会出现。

### `remote_cluster`

在筛选后的主机上运行同一条命令。

-   **输入参数**：
    -   `command` (`string`，必填)：Shell 命令。
    -   `environment` (`string`，可选)：精确的环境名。
    -   `tags` (`string`，可选)：逗号分隔的标签，必须全部匹配。
    -   `aliases` (`string`，可选)：逗号分隔的配置编号或名称。
    -   `maxWorkers` (`number`，可选)：并行数，默认 8。
-   **返回数据**：每台主机一行，包含成功与否、退出码、耗时、标准输出、标准错误和错误。
-   **限制**：一台主机连接失败只影响自己的结果行。

* * *

## 🌐 HTTP API 接口列表

所有 REST 路由均挂载在 `/dsh-remote-workspace` 命名空间下：

| 请求方法 | 路由路径 | 功能说明 | 请求体格式 |
| --- | --- | --- | --- |
| `GET` | `/dsh-remote-workspace/state` | 获取所有配置、当前激活 ID 与活跃隧道列表。 | — |
| `POST` | `/dsh-remote-workspace/profiles/save` | 创建或更新主机配置。 | 主机配置 JSON |
| `POST` | `/dsh-remote-workspace/profiles/delete` | 删除指定主机配置。 | `{ id: string }` |
| `POST` | `/dsh-remote-workspace/profiles/active` | 切换当前激活的主机。 | `{ id: string }` |
| `POST` | `/dsh-remote-workspace/test` | 测试 SSH 连通性、延迟与系统信息。 | 主机配置 JSON |
| `POST` | `/dsh-remote-workspace/browse` | 获取指定远程路径下的子目录列表（供选择器使用）。 | `{ profile: object, path: string }` |
| `POST` | `/dsh-remote-workspace/sync` | 发起手动目录镜像同步。 | `{ direction: "pull" | "push", dryRun?: boolean, force?: boolean }` |
| `POST` | `/dsh-remote-workspace/profiles/import-ssh-config` | 导入 `~/.ssh/config` 或提交的配置文本。 | `{ content?: string }` |
| `POST` | `/dsh-remote-workspace/profiles/test-group` | 测试提交的已保存配置编号。 | `{ ids: string[] }` |
| `POST` | `/dsh-remote-workspace/cluster` | 在筛选后的已保存主机上运行命令。 | `{ command, environment?, tags?, aliases?, maxWorkers? }` |
| `GET` | `/dsh-remote-workspace/file/download` | 流式下载远程文件。查询参数：`profileId`、`filePath`。 | — |
| `POST` | `/dsh-remote-workspace/file/upload` | 上传原始文件。查询参数：`profileId`、`filePath`。 | 文件字节 |
| `POST` | `/dsh-remote-workspace/terminal/font` | 保存终端字体。 | `{ fontFamily: string }` |
| `POST` | `/dsh-remote-workspace/auth/keyboard` | 提交键盘交互验证码。 | `{ id, answers }` |

* * *

## 📄 开源许可证

MIT © [GooDAnDReaDY](https://github.com/GooDAnDReaDY)

### 13\. 归档流同步与综合诊断 (v0.3.1)

-   **`🚀 快速 Tarball 流式同步`**：利用实时 `tar -czf` 数据流传输整个目录，彻底消除小文件频繁往返的延迟。
-   **`🩺 远程系统诊断 (remote_diagnose)`**：一键检测端口占用 (`ports`)、OOM 终止记录 (`oom_killer`)、磁盘分布 (`disk`) 与服务崩溃日志。
-   **`📥 导入 ~/.ssh/config`**：快速解析本机已有主机、私钥及跳板机配置至加密 `.env` 保管库。
-   **`🗃️ 远程环境变量管理 (remote_env)`**：支持远程 `.env` 的安全预览与原子化变量修改，自动遮蔽敏感密码。
-   **`📡 异常告警监控`**：当磁盘低于 10%、内存不足 5% 或容器异常重启时，主动触发 Cordis 事件总线 (`remote-workspace/alert`) 告警。

### 14\. DSH 0.2.0-rc.1 适配与全面可靠性加固 (v0.3.11)

-   **`⚙️ DSH 0.2.0-rc.1 设置表单适配`**: `Config` 字段 volatile 标记及基于 `whileServed` 的客户端注册 (#76)。
-   **`🛠️ 修复环境变量与诊断路由`**: 修复 `.env` 查看/保存及系统诊断的服务方法调用与参数签名 (#77)。
-   **`⏱️ 终端会话自动清理`**: 自动回收无活跃连接且超时的后台 PTY 终端会话与 SSH 连接 (#78)。
-   **`🛡️ 端口转发隧道生命周期加固`**: 连接断开时双向销毁流与套接字，精准维护活跃连接计数 (#79)。
-   **`📦 Tar 流式同步容错增强`**: 捕获本地 `tar` 进程错误并及时清理僵尸进程 (#80)。
-   **`🔒 Shell 命令注入防范与转义`**: 针对 Docker、系统诊断与远程文件系统操作实施严格数值校验与 POSIX 单引号转义 (#81)。
-   **`💾 二进制文件同步哈希修复`**: `MirrorSyncService.pull` 采用原始 Buffer 计算哈希，避免 UTF-8 编码失真 (#82)。
-   **`👀 文件监听器容错与并发锁`**: 监听器异常处理（防 ENOSPC 崩溃）及防止同一主机重复触发并发同步 (#83)。
-   **`⚡ 标签页可见性轮询控制`**: 浏览器标签页隐藏时自动挂起状态轮询 (#84)。

## 常见问题

### @goodandready/dsh-remote-workspace 是什么？

DeepSeek Harness的企业远程工作空间插件:SSH2连接池,SFTP操作,3向冲突-意识到镜像同步,端口转发,以及本土DSH UI\.

### 如何安装 @goodandready/dsh-remote-workspace？

在项目目录运行 npm install @goodandready/dsh-remote-workspace，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@deepseek-ai/cordis（^4\.0\.1）、@deepseek-ai/dsh-tools（^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1）、@deepseek-ai/schemastery（^3\.18\.4）、@deepseek-ai/dsh-settings（^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1）、@deepseek-ai/dsh-host-webserver（^0\.1\.7-rc\.2 \|\| ^0\.2\.0-rc\.1）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @goodandready/dsh-remote-workspace 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/goodandready\_\_dsh-remote-workspace 是否存在。

### @goodandready/dsh-remote-workspace 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @goodandready/dsh-remote-workspace 可以商用吗？

@goodandready/dsh-remote-workspace 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @goodandready/dsh-remote-workspace 的下载量有多少？

根据 npm 官方下载统计，@goodandready/dsh-remote-workspace 在 2026/10/17 – 2026/11/15 这 30 天内被下载 4,100 次，日均约 137 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @goodandready/dsh-remote-workspace 还在维护吗？

最新版本 0\.3\.29 发布于 2026/11/14（2 天前）；至今共发布 33 个版本，其中过去 12 个月发布了 33 个；首次发布于 2026/09/11。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

