dsh-pocket 把电脑上的 DeepSeek Harness 搬到手机上扫码即用、实时同屏人不在电脑前也能看任务、补指令、点审批。但「装完就能用」和「一路都顺」是两回事从版本号卡住、桌面端白屏到访客密码、命令行认证再到进程关不掉社区里反复出现的其实就那么几类。本文把它们按「症状 → 定位 → 处置」整理成一份可以直接照着查的排障清单标题里点到的端口占用EADDRINUSE与隧道错误error 1033属于联网链路那条线另有专篇展开。安装参数速查先把命令口径统一后面所有排查都基于它这里有两个容易忽略的点-w是--workspace-rootpnpm 9 环境下不加会报 ERR_PNPM_ADDING_TO_ROOT装完或更新后一定要重启 dsh web否则运行中的进程还在跑旧代码。完整的版本对照与汉化说明可以先看 完整插件清单与汉化避坑指南 里的插件条目再回来按下面的清单逐条排。逐条排查清单坑一update 之后版本还停在 0.x症状。执行更新命令包管理器没有报错但版本号纹丝不动依旧停在 0.x。定位。这不是网络问题而是版本范围的问题^0.x这种范围根本不允许自动升到 1.x所以命令「成功」了版本却没动。处置。更新时带上--latest写成dsh plugin --profile web update dsh-pocket --latest -w跨大版本时这一步是必须的。坑二桌面端 advanced 模式下手机打开是白屏症状。在 DSH Desktop 的 advanced 模式里手机扫同屏二维码页面一片空白。定位。advanced 模式禁用了网页布局手机端拿不到 layout 服务所以渲染不出来——这是模式本身的限制不是手机或网络坏了。处置。切回 compatibility 模式后重启手机访问恢复正常在 advanced 模式下打开时界面本身会给出一个明确的提示层不会让你对着白屏猜。坑三想给访客一个临时密码却找不到入口症状。需要临时把访问权分享给别人翻遍设置页也找不到「临时访问 PIN」。定位。这个功能确实没了issue #69 里的「临时访问 PIN」已在 2.6.x 移除原因是撤销的时候会崩。处置。现在只能把主密码、或带?token的链接发给对方用完立刻在设置页点「刷新」把密码换掉。分享完不换等于把钥匙留在外面。坑四CLI 模式下要不要密码、能不能用 no-auth症状。用命令行直接跑 dsh-pocket 时手动敲地址会被要求输密码有人干脆想用--no-auth省事。定位。issue #90 修复前CLI 这条路是没有认证的现在默认会随机生成一个 8 位密码打印在终端里、也内嵌进了二维码本机访问免密。处置。正常用二维码扫码即可要自己定就加--pin或设DSH_POCKET_PIN环境变量至少 6 位。--no-auth不要用——那等于把一台能执行代码的 DSH 裸暴露给任何能连上这个端口的人。坑五点了「重启 dsh web」之后进程关不掉症状。页面上点了重启随后提示进程在后台运行可你想停掉它却找不到。定位。自重启拉起的新进程是 detached 的不挂在终端上这是页内更新的标准做法不是残留的僵尸进程。处置。macOS/Linux 用lsof -ti :3080 | xargs kill -9Windows 用netstat -ano | findstr :3080找到 LISTENING 的 PID 再taskkill /PID 进程号 /F对应的日志在 DSH_HOME 目录下文件名形如 dsh-pocket-restart-进程号.log。这份清单为什么值得留着上面五条的共同点是报错本身不吓人但定位成本高——版本不动会怀疑网络白屏会怀疑手机找不到临时密码会怀疑自己看漏了设置。把它们按症状归类下次遇到就能直接跳到「处置」那一步。插件本身在 GitHub 上有 1,179 颗星、周下载 2,995npm 上是 2.10.6 版本采用 GPL-2.0本站做过真实安装验证档位 L4静态安装检查也通过Node 要求 22。但要注意扫描结论是「含敏感能力」共 60 处证据且尚无人工评估、站点未做风险分级——能装、能跑和「安全评估通过」是两件事。更多插件的安装口径与汉化说明可以对照 完整插件清单与汉化避坑指南 一起查。总结dsh-pocket 的故障大多不复杂难在定位版本要带 --latest、桌面端要避开 advanced、临时密码已经移除、CLI 别再关认证、后台进程要按端口号去杀。这些结论连同更完整的插件说明都整理在 完整插件清单与汉化避坑指南 里遇到新报错可以顺藤摸瓜。排障时先看症状再看原因能省掉大半天。适合与不适合适合把 dsh-pocket 当日常远程入口、需要一份故障速查表的个人用户遇到版本升不上去、桌面端白屏这类问题、想直接照做的人习惯命令行、要把认证与端口边界搞清楚的重度用户在 pnpm 9 环境里装插件、被 workspace 根限制卡过一次的人。不适合希望装上就零维护、完全不想碰命令行与配置文件的用户——这里多数处置都得手动执行在涉密或公司网络里部署的人——公网入口会把能执行代码的 DSH 暴露出去合规风险要自己承担需要团队共用访问入口的场景——插件定位是个人自用不适合多人共享同一把钥匙。标签dsh-pocket、DeepSeek Harness、故障排查、CLI 认证本文由 DeepSeek Harness Hub 自动整理数据来源于插件详情页。