Name: dsh-web-remote
Author: godchen520

Installer

dsh plugin --profile web add github:godchen520/dsh-web-remote

README

dsh-web-remote

中文 | English

手机 / 外网远程访问 DeepSeek Harness（DSH）的插件。随时随地通过微信或浏览器控制你的 DSH。

✨ 功能亮点

功能	说明
🌐 公网访问	Cloudflare Quick Tunnel，无需公网 IP、无需注册，`cloudflared` 缺失时自动下载
📡 局域网直连	HTTP + HTTPS 直连（HTTPS 自动生成自签名证书，零配置）
🔒 安全认证	每次启动生成随机令牌；HttpOnly Cookie；局域网可免 token
⚡ 性能加速	反向代理自动 gzip 压缩，大历史会话加载更快
📱 侧边栏图标	手机快捷按钮常驻左下角，刷新不消失
🤖 微信机器人	iLink 协议直连微信，支持 AI 对话、会话控制、模型切换
💬 QQ 机器人	NapCat OneBot 11 反向 WebSocket（施工中）

🚀 快速开始

三步上手：

# 1. 安装插件（在 DSH profile 目录执行）
cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote

# 2. 注册 bundle（编辑 package.json）
# 在 "dsh.profile.bundles" 数组中添加 "dsh-web-remote"

# 3. 重启 DSH
dsh web

启动后页面左下角出现 📱 图标 → 点击打开远程面板。

📸 截图

快捷按钮（页面左下角）：

远程面板（公网 / 局域网切换、一键复制链接、二维码、启动 / 停止）：

远程面板

📋 安装方式

方式一：GitHub 直接安装（推荐）

cd $DSH_HOME/profiles/web
pnpm add github:godchen520/dsh-web-remote

在 package.json 的 dsh.profile.bundles 数组中添加 "dsh-web-remote"，重启 DSH。

--config.minimumReleaseAge=0 可绕过 pnpm 11 新包发布年龄校验（如需要）。

方式二：手动 patch

把本包放入 profile 的 node_modules，然后在 cordis.patch.yml 追加：

- insert:
    - id: web-remote
      name: 'dsh-web-remote'

bundle 方式需重启；cordis.patch.yml 方式会被 HMR 热加载。

⚙️ 配置

全部可选，不配置即开箱即用。在 cordis.patch.yml 里覆盖：

参数	默认值	说明
`targetPort`	`3080`	DSH 自身端口
`httpPortStart`	`3081`	局域网 HTTP 起始端口（自动跳过占用）
`httpsPortStart`	`3082`	局域网 HTTPS 起始端口
`qqPortStart`	`3001`	QQ OneBot 桥起始端口
`cloudflaredPath`	`''`	指定 cloudflared 路径；留空自动探测 / 自动下载
`pfxPath`	`''`	指定 PFX 证书；留空自动生成自签名
`pfxPass`	`''`	PFX 密码
`toolsDir`	`''`	工具与证书缓存目录；留空使用 `$DSH_HOME/tools`
`autoStart`	`true`	插件加载即自动启动
`lanOpen`	`true`	局域网免 token（私网来源放行）