@wenbin_wb/dsh-bridge 1.0.6 → 1.0.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +89 -43
- package/package.json +13 -3
package/README.md
CHANGED
|
@@ -2,132 +2,178 @@
|
|
|
2
2
|
|
|
3
3
|
|
|
4
4
|
|
|
5
|
+
> Multi-channel remote access plugin for DeepSeek Harness
|
|
5
6
|
> DeepSeek Harness 多通道远程访问插件
|
|
6
7
|
|
|
8
|
+
Seamlessly extend your local DeepSeek Harness to mobile phones, tablets, public networks, and even IM chat apps. Access your AI assistant anytime, anywhere via QR code scanning, web browsers, or future integrations with WeChat/QQ/Feishu.
|
|
9
|
+
|
|
7
10
|
把你本地的 DeepSeek Harness 无缝延伸到手机、平板、公网、甚至 IM 聊天软件。无论你在哪，都能通过扫码、网页或未来的微信/QQ/飞书，随时调用你的 AI 助手。
|
|
8
11
|
|
|
9
|
-
|
|
12
|
+
---
|
|
13
|
+
|
|
14
|
+
## Features / 功能特性
|
|
15
|
+
|
|
16
|
+
### English
|
|
17
|
+
|
|
18
|
+
- **LAN Access**: Scan QR code with your smartphone/tablet, direct access on the same Wi-Fi
|
|
19
|
+
- **Cloudflare Tunnel**: One-click public internet exposure, connect from anywhere
|
|
20
|
+
- **Custom Tunnel**: Connect to your own tunnel server with a fixed domain ([Setup Guide](docs/custom-tunnel.md))
|
|
21
|
+
- **IM Integration (Planned)**: WeChat / QQ / Feishu / OpenClaw direct chat integration
|
|
22
|
+
- **Security Alerts**: URLs and QR codes with access warnings to prevent accidental sharing
|
|
23
|
+
- **Auto Version Check**: Automatic update detection when entering the panel
|
|
24
|
+
|
|
25
|
+
### 中文
|
|
10
26
|
|
|
11
|
-
-
|
|
27
|
+
- **局域网访问**：手机/平板扫码，同一 Wi-Fi 直接访问
|
|
12
28
|
- **Cloudflare 隧道**：一键暴露公网地址，随时随地连接
|
|
13
|
-
-
|
|
29
|
+
- **自建隧道**：连接自己的隧道服务器，获得固定域名（[搭建教程](docs/custom-tunnel.md)）
|
|
14
30
|
- **IM 集成（规划中）**：微信 / QQ / 飞书 / OpenClaw，直接在聊天软件里呼唤你的 Agent
|
|
31
|
+
- **安全提示**：URL 和二维码带访问警告，防止误分享
|
|
32
|
+
- **版本检查**：进入面板自动检测是否有新版本
|
|
15
33
|
|
|
16
34
|
|
|
17
35
|
|
|
18
36
|
|
|
19
37
|
|
|
20
38
|
|
|
21
|
-
|
|
22
|
-
|
|
23
|
-
- **局域网访问**：自动检测本机 IP，生成二维码，同一 Wi-Fi 下的设备直接扫码访问
|
|
24
|
-
- **Cloudflare 隧道**：一键获取公网地址，自动下载 cloudflared（无需手动安装），重启后 URL 会变化
|
|
25
|
-
- **自建隧道**：WebSocket 反向隧道，连接自己部署的隧道服务器，可获得固定域名
|
|
26
|
-
- **安全提示**：URL 和二维码带访问警告，防止误分享
|
|
27
|
-
- **版本检查**：进入面板自动检测是否有新版本
|
|
39
|
+
---
|
|
28
40
|
|
|
29
41
|
## Roadmap
|
|
30
42
|
|
|
31
|
-
|
|
43
|
+
| Target / 目标 | Description / 说明 | Status / 状态 |
|
|
44
|
+
|---------------|-------------------|--------------|
|
|
45
|
+
| **WeChat / 微信** | Chat with your Agent directly in WeChat / 在微信里直接与你的 Agent 对话 | Planned / 规划中 |
|
|
46
|
+
| **QQ Bot** | QQ bot integration for group/private chat / 接入 QQ 机器人，群聊/私聊唤起 Agent | Planned / 规划中 |
|
|
47
|
+
| **Feishu / 飞书** | Feishu message/bot integration for workplace scenarios / 飞书消息/机器人集成，办公场景直接调用 | Planned / 规划中 |
|
|
48
|
+
| **OpenClaw** | Integration with OpenClaw ecosystem / 与 OpenClaw 生态打通 | Planned / 规划中 |
|
|
49
|
+
| **Telegram** | Self-hosted IM channel / 适合自托管的 IM 渠道 | Planned / 规划中 |
|
|
32
50
|
|
|
33
|
-
|
|
34
|
-
|------|------|------|
|
|
35
|
-
| **微信** | 在微信里直接与你的 Agent 对话 | 规划中 |
|
|
36
|
-
| **QQ Bot** | 接入 QQ 机器人，群聊/私聊唤起 Agent | 规划中 |
|
|
37
|
-
| **飞书** | 飞书消息/机器人集成，办公场景直接调用 | 规划中 |
|
|
38
|
-
| **OpenClaw** | 与 OpenClaw 生态打通 | 规划中 |
|
|
39
|
-
| **Telegram** | 适合自托管的 IM 渠道 | 规划中 |
|
|
51
|
+
---
|
|
40
52
|
|
|
41
|
-
## 环境要求
|
|
53
|
+
## Requirements / 环境要求
|
|
42
54
|
|
|
55
|
+
Before installing the plugin, ensure:
|
|
43
56
|
安装插件前，请先确保：
|
|
44
57
|
|
|
45
|
-
1. **Node.js ≥ 22
|
|
46
|
-
2. **dsh CLI
|
|
58
|
+
1. **Node.js ≥ 22** (DSH requires `^22.19.0` or `≥ 24.0.0` / DSH 要求)
|
|
59
|
+
2. **dsh CLI available** — you can run `dsh` command in terminal / 能在终端直接运行 `dsh` 命令
|
|
47
60
|
|
|
48
61
|
```bash
|
|
49
|
-
# 检查 Node 版本
|
|
50
|
-
node -v #
|
|
62
|
+
# Check Node version / 检查 Node 版本
|
|
63
|
+
node -v # Should show v22.19+ or v24+ / 应显示
|
|
51
64
|
|
|
52
|
-
# 检查 dsh 是否可用
|
|
65
|
+
# Check dsh availability / 检查 dsh 是否可用
|
|
53
66
|
dsh --version
|
|
54
67
|
```
|
|
55
68
|
|
|
56
|
-
|
|
69
|
+
If `dsh` command is not found, install DSH globally:
|
|
70
|
+
如果 `dsh` 命令提示"无法识别/找不到"，先安装 DSH：
|
|
57
71
|
|
|
58
72
|
```bash
|
|
59
73
|
npm install -g @deepseek-ai/dsh
|
|
60
74
|
```
|
|
61
75
|
|
|
62
|
-
>
|
|
76
|
+
> Alternative without global install (use `npx`):
|
|
77
|
+
> 若没有全局安装的权限，也可以用 `npx` 方式：
|
|
63
78
|
> ```bash
|
|
64
79
|
> npx --yes @deepseek-ai/dsh plugin --profile web add @wenbin_wb/dsh-bridge
|
|
65
80
|
> ```
|
|
66
81
|
|
|
67
|
-
|
|
82
|
+
---
|
|
68
83
|
|
|
69
|
-
|
|
84
|
+
## Installation / 安装
|
|
85
|
+
|
|
86
|
+
### From npm / 从 npm 安装
|
|
70
87
|
|
|
71
88
|
```bash
|
|
72
89
|
dsh plugin --profile web add @wenbin_wb/dsh-bridge
|
|
73
90
|
```
|
|
74
91
|
|
|
75
|
-
|
|
92
|
+
### From source / 从源码安装
|
|
76
93
|
|
|
77
94
|
```bash
|
|
78
95
|
git clone https://github.com/wenbin-wb/dsh-bridge.git
|
|
79
96
|
dsh plugin --profile web add ./dsh-bridge
|
|
80
97
|
```
|
|
81
98
|
|
|
99
|
+
After installation, restart DSH and find "Remote Access" in settings.
|
|
82
100
|
安装完成后重启 DSH，在设置页找到「远程访问」即可使用。
|
|
83
101
|
|
|
84
|
-
|
|
102
|
+
---
|
|
103
|
+
|
|
104
|
+
## Usage / 使用
|
|
105
|
+
|
|
106
|
+
### LAN Access / 局域网访问
|
|
107
|
+
|
|
108
|
+
**English**: Automatically enabled after plugin starts, no configuration needed. Open Settings → "Remote Access", scan the QR code with your mobile device.
|
|
109
|
+
|
|
110
|
+
**中文**：插件启动后自动开启，无需任何配置。打开设置页「远程访问」，用手机扫描二维码即可访问。
|
|
85
111
|
|
|
86
|
-
###
|
|
112
|
+
### Cloudflare Tunnel
|
|
87
113
|
|
|
88
|
-
|
|
114
|
+
**English**:
|
|
115
|
+
1. Click "Enable" in the Cloudflare Tunnel card
|
|
116
|
+
2. First use will auto-download cloudflared (~30MB) from GitHub
|
|
117
|
+
3. Public URL and QR code appear within seconds
|
|
118
|
+
4. URL changes after each restart; click "Reset Link" to get a new one
|
|
89
119
|
|
|
90
|
-
|
|
120
|
+
**中文**：
|
|
121
|
+
1. 点击「Cloudflare 隧道」卡片中的「开启」按钮
|
|
122
|
+
2. 首次使用会自动从 GitHub 下载 cloudflared（约 30MB）
|
|
123
|
+
3. 下载完成后自动启动，几秒内显示公网 URL 和二维码
|
|
124
|
+
4. 每次重启后 URL 会变化；点「重置链接」可主动获取新 URL
|
|
91
125
|
|
|
92
|
-
|
|
93
|
-
1. 首次使用会自动从 GitHub 下载 cloudflared（约 30MB），需要能访问 GitHub
|
|
94
|
-
2. 下载完成后自动启动，几秒内显示公网 URL 和二维码
|
|
95
|
-
3. 每次重启后 URL 会变化；点「重置链接」可主动获取新 URL
|
|
126
|
+
### Custom Tunnel / 自建隧道
|
|
96
127
|
|
|
97
|
-
|
|
128
|
+
**English**: Requires a server with public IP. See [Custom Tunnel Guide](docs/custom-tunnel.md) for detailed setup.
|
|
98
129
|
|
|
99
|
-
|
|
130
|
+
1. Deploy tunnel server following the guide
|
|
131
|
+
2. Fill in WebSocket address (`wss://...`) and access token in the "Custom Tunnel" card
|
|
132
|
+
3. Click "Save Config" then "Enable"
|
|
133
|
+
|
|
134
|
+
Config is auto-persisted to `~/.dsh/dsh-bridge/config.json`, no need to re-enter after restart.
|
|
135
|
+
|
|
136
|
+
**中文**：需要一台有公网 IP 的服务器。详细搭建步骤见 [自建隧道教程](docs/custom-tunnel.md)。
|
|
100
137
|
|
|
101
138
|
1. 按教程在服务器上部署隧道服务端
|
|
102
139
|
2. 在「自建隧道」卡片中填写 WebSocket 地址（`wss://...`）和访问令牌
|
|
103
140
|
3. 点「保存配置」后点「开启」
|
|
104
141
|
|
|
105
|
-
|
|
142
|
+
配置自动持久化，重启后无需重新填写。
|
|
143
|
+
|
|
144
|
+
---
|
|
106
145
|
|
|
107
|
-
## 可选配置
|
|
146
|
+
## Optional Configuration / 可选配置
|
|
108
147
|
|
|
148
|
+
Plugin works out-of-the-box, no configuration needed. To change proxy port, add to cordis.yml:
|
|
109
149
|
插件开箱即用，无需配置。如需修改代理端口，在 cordis.yml 中添加：
|
|
110
150
|
|
|
111
151
|
```yaml
|
|
112
152
|
- name: dsh-bridge
|
|
113
153
|
config:
|
|
114
|
-
port: 3082 # 默认 3082
|
|
154
|
+
port: 3082 # Default / 默认 3082
|
|
115
155
|
```
|
|
116
156
|
|
|
117
|
-
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## Development / 开发
|
|
118
160
|
|
|
119
161
|
```bash
|
|
120
162
|
git clone https://github.com/wenbin-wb/dsh-bridge.git
|
|
121
163
|
cd dsh-bridge
|
|
122
164
|
npm install
|
|
123
165
|
|
|
166
|
+
# Rebuild after modifying client/index.js
|
|
124
167
|
# 修改 client/index.js 后重新构建
|
|
125
168
|
npm run build:client
|
|
126
169
|
|
|
170
|
+
# Install to web profile and restart DSH
|
|
127
171
|
# 安装到 web profile 并重启 DSH
|
|
128
172
|
dsh plugin --profile web add .
|
|
129
173
|
```
|
|
130
174
|
|
|
175
|
+
---
|
|
176
|
+
|
|
131
177
|
## License
|
|
132
178
|
|
|
133
179
|
MIT © [wenbin-wb](https://github.com/wenbin-wb)
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@wenbin_wb/dsh-bridge",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.7",
|
|
4
4
|
"description": "DSH 多渠道接入桥：局域网二维码、自建隧道、机器人集成",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "lib/index.js",
|
|
@@ -40,9 +40,19 @@
|
|
|
40
40
|
"dsh",
|
|
41
41
|
"dsh-plugin",
|
|
42
42
|
"remote",
|
|
43
|
+
"remote-access",
|
|
43
44
|
"tunnel",
|
|
44
|
-
"
|
|
45
|
-
"
|
|
45
|
+
"cloudflare",
|
|
46
|
+
"mobile",
|
|
47
|
+
"smartphone",
|
|
48
|
+
"tablet",
|
|
49
|
+
"qr-code",
|
|
50
|
+
"qrcode",
|
|
51
|
+
"websocket",
|
|
52
|
+
"bot",
|
|
53
|
+
"wechat",
|
|
54
|
+
"qq",
|
|
55
|
+
"feishu"
|
|
46
56
|
],
|
|
47
57
|
"dsh": {
|
|
48
58
|
"bundle": {
|