@wenbin_wb/dsh-bridge 1.0.7 → 1.0.9

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