DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

jinghoor /

jinghoor/dsh-remote-workspaces

Topic repository only

把另一台电脑的 DSH(DeepSeek Harness)工作区与会话并进本机侧边栏|内置公共中转,登录同一账号即可多设备互连

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@073e8b64

DSH 远程工作区

把另一台电脑上的 DSH(DeepSeek Harness)工作区与会话,直接并进本机侧边栏。 远端工作区整组带 🌐,点进去就是那台机器上的会话——读历史、发消息、停止、排队, 执行发生在远端那台机器上。

装好 → 两台设备登录同一账号 → 连上。公共中转已内置,不用开端口、不用公网 IP、不用填地址。

侧边栏:带 🌐 的工作区在另一台电脑上

设置面板

带 🌐 的工作区在另一台电脑上,会话也在那台执行

三步用起来

一、装插件(每台设备都要装)

DSH → 设置 → 插件 → 添加插件,粘贴:

https://github.com/jinghoor/dsh-remote-workspaces/releases/download/v1.13.2/dsh-remote-client-1.13.2.tgz

装完重启 DSH,设置里出现「DSH远程客户端」。

二、两台设备登录同一账号

设置 → DSH远程客户端 → 注册 / 登录

被连接的那台选「远程端(这台跑 DSH)」,你手里这台选「本地端(我在这台查看)」。 设备名两台要一致(例如都叫 desk)。

三、点启动

先起远程端,再起本地端。侧边栏立刻出现带 🌐 的工作区。

常见问题

现象 原因
面板显示「等待对端」 远端没启动,或设备名不一致
「账号下没有设备」 远端还没用同一账号登录并启动
想同时看三台电脑 每台用不同设备名,本地端点「连接」逐台接入
图片上传失败 会话在远端时才会走隧道;本地会话的"上传"只写本机附件库

反馈:277030704@qq.com | QQ 群:DSH远程客户端插件交流群 587118291

想让更多人用上?分发与推广的具体做法(含可直接粘贴的文案)见 docs/distribution.md。

组成部分

目录 是什么
plugin/ 当前插件(就是能用的那份):Host 侧代理 + 设置页面板
relay/ 中转服务端(跑在服务器上,systemd 常驻)
cli/ 两端共用 CLI:agent(远端)与 client(本机)
scripts/ verify.mjs(直连远端)、verify-host.mjs(打本机 Host 真实 HTTP 面)
install.sh 把插件装进某个 profile(幂等,不重启)
plugin/ 当前插件(可发布的 npm 包):Host 侧代理 + 设置页 + 隧道管理
legacy/v1-panel/ 历史版本:早期的「远程面板」独立插件,已被 plugin/ 取代
notes/protocol.md 逆出来的 DSH HTTP/RPC 协议(0.2.1 实测)
.work/review/notes.md 逐轮踩坑与验证记录(含每轮实测数据)

为什么不是官方功能

DSH 0.2.2-rc.1 没有这个能力:客户端没有 remote host 界面,CLI 没有连远端 host 的参数, dsh-api-remotes 只是 BFF 层(不含传输),experimental-liveshare 是反方向 (把本机会话推给外部查看者,且 Relay 服务端要自建)。所以整套是自己写的。

安装方式只能选一种

DSH 有两种装法,不要混用,否则会出现"管理器说装好了、运行的是另一份":

方式 适用 说明
插件管理器(推荐) 所有人 设置 → 插件 → 添加插件,粘贴 release 地址。升级也在管理器里
install.sh 只给开发者/离线环境 直接拷到 profile 的 plugins/。如果该 profile 已被管理器接管,脚本会拒绝执行

早期用 launchctl 起过 CLI 客户端的机器,要先停掉那条 LaunchAgent,否则它一直占着本地端口:

launchctl unload ~/Library/LaunchAgents/dev.dsh.relay.client.plist
mv ~/Library/LaunchAgents/dev.dsh.relay.client.plist ~/Library/LaunchAgents/dev.dsh.relay.client.plist.disabled

安装

1. 服务器(中转)

scp relay/relay.mjs relay/install-relay.sh root@<服务器>:/root/
ssh root@<服务器> 'cd /root && chmod +x install-relay.sh && ./install-relay.sh 19090 <服务器IP>'

安装脚本会生成自签证书、写入 AGENT_SECRET、装 systemd 单元并放行端口, 最后打印证书指纹和 agent/client 的启动命令。

2. 远端(跑 DSH 的那台)

Windows 的完整步骤见 docs/windows.md(含任务计划自启与插件安装两种方式)。 最短路径是只装引擎:

curl.exe -k -o "$env:USERPROFILE\.dsh-relay\dsh-relay.mjs" https://<服务器>:19090/dsh-relay.mjs
node "$env:USERPROFILE\.dsh-relay\dsh-relay.mjs" login --relay <服务器>:19090 --user <账号>
node "$env:USERPROFILE\.dsh-relay\dsh-relay.mjs" setup --role agent --device desk --local auto
node "$env:USERPROFILE\.dsh-relay\dsh-relay.mjs" start

--local auto 会自动跟随 DSH 桌面版的端口(它每次启动都换端口)。

或手动指定端口:

curl -k -o dsh-relay.mjs https://<服务器>:19090/dsh-relay.mjs
node dsh-relay.mjs agent --relay <服务器>:19090 \
  --secret <AGENT_SECRET> --device desk \
  --local 127.0.0.1:<远端 DSH 端口> --fingerprint <指纹>

远端 DSH 本身(桌面版直接开即可;用 CLI 时要带 --trusted-host,见 relay/README.md)。

3. 安装插件(最终用户只需要这一步)

DSH → 设置 → 插件 → 添加插件,粘贴这个地址,点安装,然后重启 DSH:

https://github.com/jinghoor/dsh-remote-workspaces/releases/download/v1.13.2/dsh-remote-client-1.13.2.tgz

这个框接受的是安装包地址(tarball / git 仓库 / npm 包名),不是市场索引。 装完重启 DSH,设置里会出现「DSH远程客户端」。

如果你的 DSH 启用了插件市场,也可以添加索引源:

https://raw.githubusercontent.com/jinghoor/dsh-remote-workspaces/main/market/index.json

发布新版本见 docs/publishing.md。

4. 账号模式(推荐,多人各自隔离)

# 两端各自注册/登录同一个账号
node dsh-relay.mjs register --relay <服务器>:19090 --user alice
# 登录后设置这台机器的角色
node dsh-relay.mjs setup --role agent  --device desk --local 127.0.0.1:52893   # 远端
node dsh-relay.mjs setup --role client --device desk --listen 127.0.0.1:52900  # 本机
node dsh-relay.mjs start

不同账号之间互相看不见:设备名绑定账号,别人的 client 连你的设备会被 relay 拒绝。 详见 relay/README.md。

5. 共享密钥模式(单人)

./cli/install.sh client --device desk --listen 127.0.0.1:52900 \
  --secret <AGENT_SECRET> --fingerprint <指纹> --daemon

./install.sh            # 把插件装进 profile(默认 desktop)
# 重启 DSH

然后打开「设置 → 账号与隧道」:注册/登录账号,选这台机器是远端端还是本地端,点启动。 隧道起来后会自动写好主机凭据,侧边栏直接出现远端工作区。

也可以用 CLI 做同样的事(两者共享 ~/.dsh-relay/config.json):

node cli/dsh-relay.mjs login  --relay <服务器>:19090 --user alice
node cli/dsh-relay.mjs setup  --role client --device desk --listen 127.0.0.1:52900
node cli/dsh-relay.mjs start

凭据的两种模式

模式 适用 说明
token 远端跑 CLI dsh web 启动时打印,每次启动会变
cookie 远端跑桌面版(不打印 token) 从 Electron 的 cookie 库明文取出,与 authority 绑定

cookie 模式要额外给 authority(远端 Host 自己的 127.0.0.1:<端口>),插件据此发 Host 头, 所以本机监听端口不必与远端一致。

自动同步:远端 agent 加 --endpoint-file,每 5 秒读 {authority, cookie} 并推给本机, 本机 client 写进插件配置,插件监听到文件变化自动重载——远端换端口/cookie 不再需要人工搬运。

已验证

verify.mjs      15/15   直连远端:列表 / 工作区 / 建会话 / 跟进流 / 文本 / 事件 /
                                排队 / 停止 / 内联图片 / 文件上传+引用 / 图片回读
verify-host.mjs  7/7    打本机 Host 真实 HTTP 面(桌面版渲染层走的就是这条路)

另有:双向消息同步(远端发→本地收 65 帧)、运行状态事件(api-session/status 到本地)、 设置页保存不丢凭据、工作区勾选即时生效、端点文件改端口后自动跟随。

已知限制

  • 远端会话下的文件树 / 终端 / diff / 目录选择器读的是本机 FS,要一致得连 terminal / fs / workspace-files 一起代理,是另一个量级的工程。
  • 桌面版里粘贴/拖入附件这一步(浏览器把 File 交给上传 API)尚未在应用内实测通过; API 侧已全绿(见上),若失败请在notes里找对应现象。
  • 远端 token/cookie 随远端重启轮换;接上 --endpoint-file 才免人工。
  • 排序只在本次运行内有效。

排障

先看插件自检(任意 dsh-auth-* cookie 即可):

curl -H 'cookie: dsh-auth-x=1' http://127.0.0.1:<本机端口>/remote-workspaces/status

plugin/README.md 里有完整对照表(401 / 工作区为 0 / writer-held / agent preset 缺失 / 改 remote.mjs 不生效等)。

—/ 5

No ratings yet

Manifest verification required

Commit 073e8b64cf05

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout