JavaScript 写的 DSH 插件,把手机变成这台电脑的遥控器:扫码 / 6 位码 / 异地配对码三种配对方式、监听 8899 的局域网服务、异地时自动拉起的 frpc 隧道、两盏状态灯,以及带升级与回滚的版号卡。仓库元数据未声明许可证,README 末尾写的是 MIT。
DSH 适配
原生运行时
作者声明
安全审计
未审计
最后核验
2026-11-16
许可证
作者未说明
01它能帮你完成什么?
在手机上接管这台电脑的 DSH 会话:读会话列表、收发消息、看历史、传文件,同一个网络里直接连,不在同一个网络也能连
配对后的鸿蒙 App 直接和插件的 8899 局域网服务通信:`/sessions` 读会话列表,`/cmd` 负责收发、切模型、浏览文件、插件清单、队列与升级,`/attachment` 取附件——都要带访问码;手机不在同一网络时同样的流量走 frpc 隧道
把 DSH 常驻在桌面或云服务器上、希望不开远程桌面就能用手机接着操作的人
不用填 IP 就能完成配对,并且把暴露窗口压到最短
二维码里装的是一次性票据、App 里输 6 位数字让手机自己在同一网络里找电脑,或者 DSH 装在异地时改用 6 位异地配对码
在家里或办公室同一个 WiFi 下配对的人,以及把 DSH 装在云服务器、二维码里的局域网地址根本连不到的人
把 DeepSeek 网页版对话并排放在会话旁边,不用来回切窗口
右侧栏多一个「网页聊天」标签页,内容是 chat.deepseek.com;加载失败时该页显示「重新加载」按钮
同时在用网页版对话、又不想为它多开一个浏览器窗口的 DSH 桌面端用户
02如何接入 DeepSeek Harness?
前置条件
- 手机端需要鸿蒙 App「DSH控制台」,只在应用商店下载——本仓不提供安装包
- `--profile` 后面必须写 profile 名:这个参数不能省,省掉会直接报 `required option '--profile <name>' not specified`
- 不要在 profile 的 `cordis.patch.yml` 里再写一遍 `insert`——包里已经带了,重复写会让插件加载两次
- 可选:公网访问服务,只在手机和电脑不在同一个网络时才需要
安装步骤
- 01
执行 `dsh plugin --profile web add dsh-console-hm`,把 `web` 换成你自己的 profile 名(`web` 是默认值)。
$ dsh plugin --profile web add dsh-console-hm
- 02
刚发的版本有时会装到上一个,这时固定版本号并关掉 pnpm 的最小发布龄策略重试:`dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0`
$ dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0
- 03
也可以在插件页安装:DSH 侧栏 → 插件 → 「添加插件」 → 选 `dsh-console-hm-<版本>.tgz`。
- 04
开发时改用链接:把 `"dsh-console-hm": "link:<你的插件目录绝对路径>"` 写进 profile 的 `package.json` 依赖,再把 `"dsh-console-hm"` 加进 `dsh.profile.bundles` 数组,然后跑一次 `pnpm install`。
- 05
需要调整时(一般不用动)写在 profile 的 `cordis.patch.yml` 里,按 `- id: dsh-console` → `config` 覆盖:`port` 是局域网服务端口,`name` 是面板上显示的节点名(默认取系统主机名),`allowShiftPort` 控制端口被占时是否顺延。
验证接入成功
- 打开 设置 → 导航列表 → DSH控制台(或侧栏入口)看两盏灯:DSH 那盏表示这台电脑的会话服务通不通,手机那盏灰着只说明还没配对,不算错误。
- 在源码仓里跑 `node test/selftest.mjs`:不需要装进 DSH,验 10 组,自测自己占 18777 和 18888、不碰 8899,所以插件正常跑着也能跑。
- 面板上的版号卡会显示 npm 上的版本,可用来确认升级是否真的生效。
回滚
- 在面板的升级卡上回滚:`[ 检测更新 ] [ 升级 ] [ 回滚 ]`。
03DSH 适配与能力边界
DSH 插件,包名 `dsh-console-hm`:用 `dsh plugin --profile web add dsh-console-hm` 安装后,面板挂在 设置 → 导航列表 → DSH控制台,侧栏底部再加两个入口;面板自身路由(`/api/dsh-console/state`、`/newcode`、`/sessions`、`/cmd`)走 DSH 自己的 `connection.fetch.register` 并带 DSH 浏览器认证,手机侧则由另起的 8899 局域网服务负责
扫码配对(一次性票据)
`/qr` 出二维码 PNG,载荷是 `dsh-console://pair?b=…&k=pt_…&n=…&i=dsh-console&c=…&v=…`,其中 `k` 是一次性配对票据,不是长期访问码
每次刷新都会换一张票据、换一个 `v` 值,让二维码真的重画长期访问码不会出现在二维码载荷里6 位码与异地码兑换访问码
`/claim` 换出访问码——错码 403、格式错 400、超限 429,成功即核销
码换成访问码之后立刻作废异地配对要先打开开关,它的 6 位码每 15 分钟自动换一个公网访问与 frpc 隧道
开通公网访问服务后由插件自己拉起隧道,手机在蜂窝网也能连回这台电脑
把 `frpc` 下载到 `~/.dsh/frp`(Windows 下是 `frpc.exe`),先对 size 再对 sha256,任何一项不符都不落盘用户手放的 frpc 永远优先,插件不会覆盖没开通公网访问服务的用户不会触发下载、不会起进程,面板上也不会多出东西两盏互不干扰的状态灯
一盏看手机(App 在前台时每 60 秒心跳,最近 10 分钟内来过请求就算连着),一盏看 DSH(这台电脑进程内能不能拿到会话服务)
手机灯灰着是正常状态,不是错误版号卡与升级 / 回滚
面板上显示当前版本,并提供 检测更新 / 升级 / 回滚,版号来自 npm 版本检测
升级和回滚会替换当前安装的插件版本
04适合谁?何时不该用?
适合
- 把 DSH 常驻在桌面或云服务器上、希望不开远程桌面就能用手机接着操作的人
- 在家里或办公室同一个 WiFi 下配对的人,以及把 DSH 装在云服务器、二维码里的局域网地址根本连不到的人
- 同时在用网页版对话、又不想为它多开一个浏览器窗口的 DSH 桌面端用户
不适合
- 手机端必须是应用商店里的鸿蒙 App「DSH控制台」,本仓不提供安装包;也没有网页版配对页——`/`、`/pair`、`/web`、`/pet` 一律 403,配对只走手机 App。
- 局域网服务默认 8899,6 位码那条路手机侧只探 8899,所以端口被占时插件直接启动失败并打出该怎么办的日志,不偷偷挪;要换端口必须连手机端一起改,只有 `allowShiftPort: true` 才恢复往后顺延 20 个端口的行为。
- 异地配对必须先开通公网访问服务,且默认关闭;开关打开期间,任何拿到公网地址的人都能尝试配对——票据 5 分钟一次性、异地码 15 分钟作废、公网来源输错 20 次锁 15 分钟,README 建议配好之后把它关掉。
- 同一网络里拿到访问码的人就能操控这台电脑的 DSH:能操控 DSH 的路由必须带访问码,访问码每次进程重启都会变,而 `/api/dsh-console` 面板路由带 DSH 浏览器认证,裸 curl 会 401。
05兼容性、维护与安全提示
- 手机端必须是应用商店里的鸿蒙 App「DSH控制台」,本仓不提供安装包;也没有网页版配对页——`/`、`/pair`、`/web`、`/pet` 一律 403,配对只走手机 App。
- 局域网服务默认 8899,6 位码那条路手机侧只探 8899,所以端口被占时插件直接启动失败并打出该怎么办的日志,不偷偷挪;要换端口必须连手机端一起改,只有 `allowShiftPort: true` 才恢复往后顺延 20 个端口的行为。
- 异地配对必须先开通公网访问服务,且默认关闭;开关打开期间,任何拿到公网地址的人都能尝试配对——票据 5 分钟一次性、异地码 15 分钟作废、公网来源输错 20 次锁 15 分钟,README 建议配好之后把它关掉。
- 同一网络里拿到访问码的人就能操控这台电脑的 DSH:能操控 DSH 的路由必须带访问码,访问码每次进程重启都会变,而 `/api/dsh-console` 面板路由带 DSH 浏览器认证,裸 curl 会 401。
README 写 MIT,仓库元数据未声明 · 发布标签 ffmpeg-2026-11-09 · 仅作者 README 声明,未独立审计
06常见问题
怎么把 dsh-console-plugin 装进 DeepSeek Harness?
执行 `dsh plugin --profile web add dsh-console-hm`——npm 包名是 `dsh-console-hm`,不是仓库名——把 `web` 换成你自己的 profile 名。`--profile` 参数不能省,省掉会直接报 `required option '--profile <name>' not specified`。刚发的版本有时会装到上一个,这时指定版本号并关掉最小发布龄策略:`dsh plugin --profile web add dsh-console-hm@latest --config.minimumReleaseAge=0`。
在 DSH 会话里这块面板出现在哪?
在 设置 → 导航列表 → DSH控制台,也在插件页的配置区;侧栏底部还有两个入口:底栏「DSH控制台」打开这块面板,有新版本时图标上会带「可更新」小徽标;底栏「网页聊天」在右侧栏打开 chat.deepseek.com,只在 DSH 桌面端可用,因为需要宿主提供 webview 通道。
它会带来哪些网络暴露?
一个监听 8899 的局域网 HTTP 服务,请求带 `?token=<访问码>` 或 `x-dsh-console-token` 头;`/sessions`、`/cmd`、`/attachment` 不带访问码无法使用。异地配对默认关闭且需要先开通公网访问服务,公网来源只能走带访问码的路由。面板自己的路由在 `/api/dsh-console` 下,走 DSH 的 `connection.fetch.register`,所以裸 curl 拿到的 401 是设计如此。
必须装手机 App 吗?有没有网页版配对?
必须装:手机端是应用商店里的鸿蒙 App「DSH控制台」,本仓不提供安装包。也没有网页版配对页——`/`、`/pair`、`/web`、`/pet` 一律 403,配对只走手机 App。
不装进 DSH 也能验证它能用吗?
能,在源码仓里跑 `node test/selftest.mjs`。它不需要装进 DSH,验 10 组(载荷格式、6 位码一次性、二维码真能出图、`/claim` 通路、配对页已删除、401/403 安全边界、端口被占必须报错、客户端半边与宿主半边契约、包清单),自测自己占 18777 和 18888、不碰 8899,所以插件正常跑着也能跑。
07相关的 DSH 工作流
ds-harness-remote
作者 liguobao
基于 DeepSeek Harness 插件机制构建的远程访问方案,通过低延迟、端到端加密的 P2P 网络,支持使用 PC、移动端 和 Web 随时访问本地设备上的DSH 、CodeX、Cursor、Claude Code等工作区。 (Built on DeepSeek Harness plugins, this low-latency, end-to-end encrypted P2P solution lets PC, mobile, and web clients access local DSH, Codex, Cursor, and Claude Code workspaces.)
dsh-windows-mcp
作者 hellohub1212
DeepSeek Harness Windows 桌面自动化插件,将 CursorTouch/Windows-MCP 接入内置 MCP 客户端桥接。提供默认关闭的 Computer Use 开关和应用内依赖安装器。
dsh-desktop
作者 anywhere-labs
为 DeepSeek Harness (DSH) 插件生态打造的现代化桌面端解决方案。万物皆「插件」,桌面本身也是「插件」。
dsh-go
作者 ccch1mneyyy
dsh-go — DeepSeek Harness 装进口袋:手机本机运行,也能遥控你的电脑。
08数据与来源
dsh plugin --profile web add dsh-console-hm
挂在 **设置 → 导航列表 → DSH控制台**,也挂在**插件页**的配置区,侧栏底部还有两个入口。
前缀 `/api/dsh-console`,走 DSH 自己的 `connection.fetch.register`,
**带 DSH 的浏览器认证层**,所以裸 curl 会 401 —— 这是对的,不是 bug。
页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。
最佳 DeepSeek Harness 插件
从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。
