本文由本站基于该插件已收录的字段自动派生（wiki / faq / compatibility_json / readme），非 AI 即时创作。每节末尾标源字段。

快速上手

dsh-pocket

— 源: plugin_wiki.wiki_content

安装与验证

dsh plugin --profile web add dsh-pocket

复制以上命令在 DSH Web Profile 内运行。安装完成后在「插件列表」启用即可。

— 源: plugins.install

关键要点

• 下班路上，agent 在电脑上跑任务，你想掏出手机看看它干到哪了、结果如何
• 出门在外，突然想让电脑上的 agent 查点资料、写段代码，但没有远程桌面、没有 SSH
• 电脑在宿舍/办公室，你人在外面，想随时"操控你的 DeepSeek Harness"——发任务、看输出、点审批
• DSH 能执行你电脑上的代码。局域网二维码/URL 配上独立 8 位数字密码才是钥匙（密码默认开启，可关——关闭后局域网扫码直连，仅同一网络设备可访问），请勿把局域网二维码、URL 或密码发给别人
• 公网有 8 位数字密码保护：链接随机分配、每次开启换新密码、旧链接立即作废——泄露了也进不来，改密码/重开即可作废

— 源: plugin_wiki.readme_zh (fallback readme_raw)

常见问题

装好后从哪儿打开？

重启 dsh web 后进入「设置」页面，左侧边栏会多出一项「手机访问」入口（与「通用设置」「模型」同级），局域网二维码会立刻显示。

局域网和公网模式有什么区别？

局域网模式手机与电脑需在同一 WiFi，访问速度取决于本地网络；公网模式通过 cloudflared 隧道生成随机公网 URL，4G/任何网络都能用，但每次开启 URL 与访问密码都会换新。

访问密码是必须的吗？

公网链接始终要求 8 位数字密码，每次开启公网会自动换新、旧链接立即作废。局域网密码默认开启，可在设置页局域网区块一键关闭（关闭后同网段设备扫码即可直连）。

装完/更新完为什么没生效？

必须重启 dsh web 进程，正在运行的进程仍加载旧插件代码。设置页里提供一键重启按钮（桌面版环境除外），或手动停止 dsh web 后重新启动。

公网模式报 error 1033 怎么办？

通常是本机代理/VPN（Clash、Surge、v2ray、sing-box 等 TUN/增强模式）掐断了 cloudflared 隧道。先关闭代理的 TUN 模式或退出代理软件再重试；网络环境受限时改用手机热点+局域网模式也能完全满足「人在外面也能用」。

端口 3081 被占用怎么处理？

旧 dsh-pocket 进程还占着端口时新进程会自动尝试下一个端口（连续 10 个），仍冲突需手动结束旧进程：macOS/Linux 用 lsof -ti :3081 | xargs kill -9，Windows 用 netstat -ano 找 LISTENING 的 PID 再 taskkill /PID。

在 DSH Desktop 上能用吗？

桌面版的扫码同屏功能正常，但一键更新和一键重启由 DSH Desktop 自己管理，本插件在这两项功能上会主动禁用避免冲突。另外桌面端「advanced」模式暂不支持手机访问（会显示提示覆盖层），需切回「compatibility」模式后重启。

升级到 1.x 版本怎么操作？

使用 dsh plugin --profile web update dsh-pocket --latest -w（带 --latest 才能跨 ^0.x 范围升到 1.x，更新完成后必须重启 dsh web 让新代码生效）。

— 源: plugin_wiki.faq_json

兼容性

• DSH: 未声明
• Node: >=22
• Platforms: macOS, Windows, Linux

— 源: plugin_wiki.compatibility_json

踩坑提醒

安装前请审阅上游仓库；本指南基于已收录字段自动派生，可能滞后于最新版本。如发现与官方文档冲突，请以上游为准。

— 来源：通用规则