deepseekplugins

DeepSeek Harness plugin

dsh-anywhere-web

dsh web 任意入口访问增强：注入 crypto.randomUUID polyfill 并放行 0.0.0.0/私网/隧道域名的 privileged API

Tools & Capabilities
Jump to install

Source facts

Repository
CsBpRd/dsh-anywhere-web
Latest update
Aug 18, 2026
Category
Tools & Capabilities
GitHub stars
0
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/CsBpRd/dsh-anywhere-web
Plugin: dsh-anywhere-web
Author: CsBpRd

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer2 files
README.mdSource · read only

dsh-anywhere-web

DeepSeek Harness (dsh) web 的任意入口访问增强插件（dsh bundle）。

解决的问题

1. 非安全上下文缺 crypto.randomUUID：http://0.0.0.0:3080、局域网明文 HTTP 访问 dsh web 时，浏览器将页面判为非安全上下文，crypto.randomUUID 不存在 → 前端崩溃（crypto.randomUUID is not a function）。 2. privileged API 403：dsh 的 browser-trust fence 把 settings.describe / credentials.describe / settings.update 等 privileged 方法硬编码只认 loopback，--trusted-host 对它们无效。经 0.0.0.0、局域网 IP、Cloudflare 隧道域名访问时全部 403。

方案

纯服务器端插件，通过两个官方机制，不修改 dsh 任何内部文件（dist / node_modules / 源码），dsh 升级后依旧生效：

1. webServer.tapIndex() —— 每次 index.html 响应注入 crypto.randomUUID polyfill（UUID v4 手写实现）。 2. server.prependListener("request"/"upgrade") —— 在 browser-trust fence 检查之前，把白名单内（0.0.0.0、私网段 10/8、172.16/12、192.168/16，以及 DSH_EXTRA_HOSTS 环境变量注入的额外域名）的 Host/Origin 改写成 127.0.0.1[:端口]，fence 判定为 loopback → privileged 方法全放行。白名单外的恶意/重绑定域名不改写，照常被 fence 拒绝（保留 DNS rebinding 防护）。

安装

一行安装（推荐）：

curl -fsSL https://raw.githubusercontent.com/CsBpRd/dsh-anywhere-web/main/install.sh | bash

脚本自动：dsh plugin add 装进 profile 的 bundle 层栈（首次使用自动初始化 profile）→ 检测到运行中的 dsh web（LaunchAgent 或手动启动均可）则自动重启加载。可调环境变量：DSH_PROFILE（默认 web）、DSH_HOME、DSH_LAN=1（启用局域网直连，见下文）、DSH_NO_RESTART=1（跳过重启）。

手动安装：

# 方式一：直接引用 GitHub（首次 add 若 pnpm 要求构建授权，按提示在
# pnpm-workspace.yaml 的 allowBuilds 放行本包）
dsh plugin --profile web add github:CsBpRd/dsh-anywhere-web

# 方式二：本地 checkout
dsh plugin --profile web add /path/to/dsh-anywhere-web

装好后重启 dsh web：

launchctl kickstart -k gui/$(id -u)/com.cbr.dsh-web   # LaunchAgent 管理时

验证：

curl -sS http://127.0.0.1:3080/ | grep randomUUID                     # polyfill 注入
curl -sS -o /dev/null -w "%{http_code}\n" \
  -H "Host: 0.0.0.0:3080" http://127.0.0.1:3080/api/settings.describe  # 应 404 而非 403

配套：隧道透传反代（可选）

tunnel-proxy.mjs 是配合 Cloudflare Tunnel 使用的纯透传反代（127.0.0.1:3090 → dsh 127.0.0.1:3080）。Host 改写已由插件在 dsh 内部完成，此反代不改任何头，只做 HTTP + WebSocket 透传。用 LaunchAgent 常驻：

node tunnel-proxy.mjs   # 环境变量 LISTEN_PORT / BIND_HOST / UPSTREAM_PORT

局域网直连（可选，DSH_LAN=1）

默认 dsh 仍只绑 127.0.0.1（监听面不开放）。想让局域网内其他设备直接访问 http://<本机IP>:3080，用一行安装带 DSH_LAN=1：

DSH_LAN=1 curl -fsSL https://raw.githubusercontent.com/CsBpRd/dsh-anywhere-web/main/install.sh | bash

它会把 webserver 的 bind host 覆盖为 0.0.0.0（写进 profile 用户层 cordis.patch.yml，幂等）。此时：

  • 局域网设备 http://192.168.x.x:3080 直达，页面正常（polyfill 注入）；
  • 本插件的白名单改写已覆盖私网段 → 局域网设备上设置页同样可用（这是同类插件 dsh-web-lan-access 做不到的）；
  • 关闭：从 ~/.dsh/profiles/web/cordis.patch.yml 删掉 webserver override 行，重启 dsh。

> ⚠️ 安全：绑 0.0.0.0 = 局域网内任何设备都能操作 dsh（相当于远程代码执行权限）。只建议可信网络使用；公网入口请继续走 Cloudflare Access + 隧道（额外域名通过 DSH_EXTRA_HOSTS 注入白名单）。

卸载

dsh plugin --profile web remove dsh-anywhere-web

结构

dsh-anywhere-web/
├── package.json       # dsh.bundle manifest
├── cordis.patch.yml   # 注入插件行的 patch 层
├── index.js           # apply 插件：tapIndex polyfill + host 白名单改写
├── install.sh         # 一行安装脚本（curl -fsSL | bash）
├── tunnel-proxy.mjs   # 可选：隧道透传反代（与插件本体无关）
└── README.md
Back to searchOpen GitHub repository

More related plugins

View category