WSL 端口转发 173787247/dsh-wsl-expose

dsh-wsl-expose

套件安装： 见 dsh-wsl-kit。推荐 KIT_SET=llm | full。故障树：TROUBLESHOOTING.zh.md。

DeepSeek Harness 工具 wsl_expose：建议或执行 Windows portproxy，让局域网客户端访问 WSL 内监听的服务。会读取 .wslconfig 的 networkingMode。

English → README.md

在套件里的位置

建议 WSL 端口如何从 Windows 或局域网访问。本机聊天仍走 :3081/?token=。

flowchart LR
agent["dsh agent"] --> tool["wsl_expose"] --> port["WSL 端口到 Windows 或局域网"]

整套关系图和版本快照：dsh-wsl-kit 中文说明。本插件是 0.2.2（full，也在 llm）。不要把那份总表抄进本 README。

兼容性

| 项 | 值 |
| 插件 | dsh-wsl-expose 0.2.2 |
| 最低 dsh | ≥ 0.1.2（Windows 中继 :3081 一次性 ?token=） |
| 最新验证 | 以 dsh-wsl-kit 兼容性 为准（当前 0.2.0-rc.2）— 套件唯一真源 |
| 套件档位 | llm / full（也可单独装） |
| 云端 Flash | settings / llm-deepseek 使用 deepseek-flash（V4.1 Flash）；本插件不配置模型 id |
| Agent Teams | 上游实验包；本插件不依赖 |

套件版本地板：check-plugin-versions.sh。故障树：TROUBLESHOOTING.zh.md。

范围： 仅 LAN / 非本机 portproxy。本机 dsh UI 用套件中继 :3081 + token，不要用 netsh 把 3080 暴露出去。

为什么需要

手机 / 另一台电脑要访问 WSL 里的开发端口时，才需要 Windows 侧发布端口。这和「本机 Windows 浏览器打开 dsh」不是一回事：

| 目标 | 做法 |
| 本机浏览器聊 dsh | 套件 restart-dsh-web.sh → :3081?token=… |
| 把某 dev server 暴露给局域网 | wsl_expose（白名单端口；注意防火墙风险） |
| dsh --host 0.0.0.0 | 禁止 — dsh 只绑 127.0.0.1:3080 |

NAT 模式下 Windows localhost 转发可能不稳；mirrored 模式行为不同——工具会报告 networkingMode，避免瞎猜。

安装

curl -fsSL https://raw.githubusercontent.com/173787247/dsh-wsl-kit/master/install.sh | KIT_SET=llm bash
或单独：
dsh plugin --profile web add github:173787247/dsh-wsl-expose

重启 dsh web，开新会话。工具名：wsl_expose。

相关工具

- port_doctor — 端口是否在听
- check-dsh-health.sh — 3080/3081 + token
- wslconfig_hint — mirrored vs NAT

测试

npm test

许可

MIT