dsh-pocket 1.0.5 → 1.0.6
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.en.md +20 -1
- package/README.md +20 -1
- package/package.json +1 -1
package/README.en.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
<img src="docs/banner.jpg" alt="DSH Pocket" width="100%">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
<h1 align="center">DSH Pocket</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<a href="https://www.npmjs.com/package/dsh-pocket"><img alt="npm" src="https://img.shields.io/npm/v/dsh-pocket?color=4d6bfe&label=npm"></a>
|
|
@@ -39,6 +39,13 @@ Phone ──scan──> dsh-pocket proxy ──> dsh web :3080
|
|
|
39
39
|
|
|
40
40
|
## 🚀 Usage
|
|
41
41
|
|
|
42
|
+
**Prerequisite**: [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) installed. If your terminal says `dsh: command not found`, install it first:
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
npm install -g @deepseek-ai/dsh # global install; verify: dsh --version
|
|
46
|
+
# No global install? Prefix every command with: npx @deepseek-ai/dsh
|
|
47
|
+
```
|
|
48
|
+
|
|
42
49
|
```sh
|
|
43
50
|
# 1. Install the plugin (everything in one package)
|
|
44
51
|
dsh plugin --profile web add dsh-pocket -w
|
|
@@ -68,6 +75,18 @@ DSH's `/api` browser-trust fence only accepts loopback or `--trusted-host` autho
|
|
|
68
75
|
- LAN mode exposes nothing publicly; only devices on the same network can reach it.
|
|
69
76
|
- Built for personal use; access tokens for multi-device/sharing are planned.
|
|
70
77
|
|
|
78
|
+
## 🩹 Troubleshooting (traps users step on)
|
|
79
|
+
|
|
80
|
+
| Symptom | Cause & fix |
|
|
81
|
+
|---|---|
|
|
82
|
+
| `dsh: command not found` / "DSH is not defined" | dsh CLI missing: `npm install -g @deepseek-ai/dsh`, or prefix commands with `npx @deepseek-ai/dsh` |
|
|
83
|
+
| `ERR_PNPM_ADDING_TO_ROOT` | pnpm 9 workspace-root restriction: append `-w` (`--workspace-root`) to install/update commands |
|
|
84
|
+
| Nothing changed after install/update | **You must restart `dsh web`**; the running process still loads the old code |
|
|
85
|
+
| `listen EADDRINUSE ... :3081` | A stale dsh-pocket process holds the port: `lsof -ti :3081 \| xargs kill -9`, then retry |
|
|
86
|
+
| Version stuck below 1.x | `^0.x` ranges never jump to 1.x: update with `--latest` (`dsh plugin --profile web update dsh-pocket --latest -w`) |
|
|
87
|
+
| No push on iOS Safari | Safari Web Push requires **"Add to Home Screen"** first, then open from the home-screen icon (Chrome/Android don't need this) |
|
|
88
|
+
| Public `error 1033` | See "Public tunnel troubleshooting" below — usually a local proxy/VPN (Clash etc. TUN mode) killing the tunnel |
|
|
89
|
+
|
|
71
90
|
## ⚠️ Public tunnel troubleshooting (read first)
|
|
72
91
|
|
|
73
92
|
**Symptom**: after clicking "Enable anywhere", the public URL shows `error 1033` (Tunnel error) on the phone.
|
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
<img src="docs/banner.jpg" alt="DSH Pocket" width="100%">
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
|
|
5
|
+
<h1 align="center">DSH Pocket</h1>
|
|
6
6
|
|
|
7
7
|
<p align="center">
|
|
8
8
|
<a href="https://www.npmjs.com/package/dsh-pocket"><img alt="npm" src="https://img.shields.io/npm/v/dsh-pocket?color=4d6bfe&label=npm"></a>
|
|
@@ -39,6 +39,13 @@
|
|
|
39
39
|
|
|
40
40
|
## 🚀 怎么用
|
|
41
41
|
|
|
42
|
+
**前提**：电脑上已装好 [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness)。如果终端提示 `dsh: command not found`（找不到 dsh 命令），先安装：
|
|
43
|
+
|
|
44
|
+
```sh
|
|
45
|
+
npm install -g @deepseek-ai/dsh # 全局安装；验证：dsh --version
|
|
46
|
+
# 不想全局装？每次命令前加 npx：npx @deepseek-ai/dsh <命令>
|
|
47
|
+
```
|
|
48
|
+
|
|
42
49
|
```sh
|
|
43
50
|
# 1. 装插件（一个包全都有）
|
|
44
51
|
dsh plugin --profile web add dsh-pocket -w
|
|
@@ -68,6 +75,18 @@ DSH 的 `/api` 浏览器信任栅栏只认 loopback 或 `--trusted-host`（官
|
|
|
68
75
|
- 局域网模式不暴露公网，只有同一网络内的设备能访问
|
|
69
76
|
- 适合个人自用；多设备/分享场景后续会加访问令牌
|
|
70
77
|
|
|
78
|
+
## 🩹 常见问题（别踩的坑）
|
|
79
|
+
|
|
80
|
+
| 现象 | 原因与解决 |
|
|
81
|
+
|---|---|
|
|
82
|
+
| `dsh: command not found` / 提示 DSH 未定义 | dsh CLI 没装：`npm install -g @deepseek-ai/dsh`，或命令前加 `npx @deepseek-ai/dsh` |
|
|
83
|
+
| `ERR_PNPM_ADDING_TO_ROOT` | pnpm 9 对 workspace 根的限制：安装/更新命令**末尾加 `-w`**（`--workspace-root`） |
|
|
84
|
+
| 装完/更新了但界面没变化 | **必须重启 `dsh web`** 才生效；运行中的进程仍加载旧代码 |
|
|
85
|
+
| `listen EADDRINUSE ... :3081` | 旧 dsh-pocket 进程还占着端口：`lsof -ti :3081 \| xargs kill -9` 后重试 |
|
|
86
|
+
| 版本停在 0.x 升不上去 | `^0.x` 范围不允许升到 1.x：更新用 `--latest`（`dsh plugin --profile web update dsh-pocket --latest -w`） |
|
|
87
|
+
| 手机 iOS 收不到推送 | Safari 的 Web Push 要求**先把网页「添加到主屏幕」**，从主屏幕图标打开后才生效（Chrome/Android 无此要求） |
|
|
88
|
+
| 公网 `error 1033` | 见下方「公网隧道常见问题」——多半是本机代理/VPN（Clash 等 TUN 模式）掐断了隧道 |
|
|
89
|
+
|
|
71
90
|
## ⚠️ 公网隧道常见问题（必读）
|
|
72
91
|
|
|
73
92
|
**现象**：点「开启公网访问」后，手机上打开公网地址报 `error 1033`（Tunnel error）。
|
package/package.json
CHANGED