企业官网建设流程全解析

dsh-pocket 把电脑上的 DeepSeek Harness 搬到手机上，扫码即用、实时同屏，人不在电脑前也能看任务、补指令、点审批。但「装完就能用」和「一路都顺」是两回事：从版本号卡住、桌面端白屏，到访客密码、命令行认证，再到进程关不掉，社区里反复出现的其实就那么几类。本文把它们按「症状 → 定位 → 处置」整理成一份可以直接照着查的排障清单；标题里点到的端口占用（EADDRINUSE）与隧道错误（error 1033）属于联网链路那条线，另有专篇展开。

安装参数速查

先把命令口径统一，后面所有排查都基于它：

这里有两个容易忽略的点：-w是--workspace-root，pnpm 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 -9，Windows 用netstat -ano | findstr :3080找到 LISTENING 的 PID 再taskkill /PID 进程号 /F；对应的日志在 DSH_HOME 目录下，文件名形如 dsh-pocket-restart-进程号.log。

这份清单为什么值得留着

上面五条的共同点是：报错本身不吓人，但定位成本高——版本不动会怀疑网络，白屏会怀疑手机，找不到临时密码会怀疑自己看漏了设置。把它们按症状归类，下次遇到就能直接跳到「处置」那一步。插件本身在 GitHub 上有 1,179 颗星、周下载 2,995，npm 上是 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 自动整理，数据来源于插件详情页。