@ljwei-stak/dsh-fixed-port-bridge

给 DeepSeek Harness（DSH）一个固定的本地端口。

DSH 桌面端的启动器把 --port 0 写死在代码里，所以它的 web 端口每次启动都由操作系统随机分配（实测同一台机器上依次是 59507 → 65361 → 54266 → 58834）。任何"记住 DSH 端口"的客户端——桌宠、IDE 插件、浏览器书签、反向代理——每次重启都要改一遍。

这个插件在 DSH 进程内监听一个你在配置里指定的端口，把连接原样转发给宿主当次真实绑定的端口。客户端从此只认一个地址。

原理

你的客户端 ──固定端口──► 本插件（跑在 DSH 进程里）──► DSH 真实端口（随机）

• 通过 ctx.inject(['webServer']) 拿到宿主服务，惰性读取它真实绑定的 listenedPort
• net.createServer 在 config.port 上监听，每个连接用 socket.pipe 原样转发
• 因为生命周期跟着 DSH 走，DSH 起来它就在，不需要独立守护进程、不需要开机自启、不需要扫描端口

安装

1. 插件市场（桌面端推荐）

在 DSH 的插件市场里，来源填本仓库地址：

https://github.com/Alice-Marx/dsh-fixed-port-bridge

2. npm（web profile）

dsh plugin add @ljwei-stak/dsh-fixed-port-bridge

桌面端的 desktop profile 由 Electron 应用独占管理，dsh plugin 命令行按设计拒绝修改它，所以桌面端请走插件市场。

3. 手工放置

把包目录放进 <profile>/node_modules/@ljwei-stak/dsh-fixed-port-bridge，并在该 profile 的 package.json 里把包名追加进 dsh.profile.bundles，然后重启 DSH。

配置

固定端口只出现在一处 —— 插件自带的 cordis.patch.yml：

- insert:
    - id: fixed-port-bridge
      name: "@ljwei-stak/dsh-fixed-port-bridge"
      required: false
      config:
        port: 19387      # ← 改这里

改完重启 DSH。记得同时把客户端里的地址改成新端口 —— 端口的两半分别在这两处。

验证

# 端口有人监听，且返回 DSH 的状态
curl -s http://127.0.0.1:19387/<your-client-path>

# 确认是本插件在监听：这个 PID 应该等于 DSH 主进程的 PID
netstat -ano | findstr :19387
tasklist | findstr "DeepSeek Harness"

如果固定端口的监听 PID 是一个独立的 node.exe，说明占着端口的是别的进程（例如你自己搭的中继），本插件会因为 EADDRINUSE 记一条 warn 然后让位——宿主不会受影响。

自测

npm test

preflight.mjs 会用一个桩宿主启动插件、伪造一个上游服务，验证"能导入 / 能监听 / 能转发 / 换 config.port 真的换端口"。它不触碰真实的 DSH。

兼容性

• 不声明 engines.dsh，也不声明 @deepseek-ai/* peer 依赖 —— 这样 DSH 的 evaluatePluginCompatibility 不会因版本范围把你拦在门外。
• 行上带 required: false：插件运行时抛错时宿主跳过它，而不是让整个 DSH 起不来。
• apply 全程 try/catch，任何异常只记日志。

已知边界

1. 只做 TCP 转发，不做路径过滤：固定端口上暴露的是整个 DSH web 面（含 GUI），不限于某一条路径。默认只绑 127.0.0.1，不对外网开放。
2. 依赖宿主的 webServer 服务（listenedPort / server.address() / config.port 三选一取值）。DSH 大版本若改变这个服务的形状，插件会失效，症状是固定端口无人监听。
3. 端口被占用时不抢占：记一条 warn 后让位，宿主照常运行。

License

MIT