返回目录

ChenJun25/dsh-console-plugin

精选清单收录

chenjun25/dsh-console-plugin

为 DeepSeek Harness 提供远程控制能力的控制台插件。

前往 GitHub
$ dsh plugin --profile web add dsh-console-hm

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`——包里已经带了,重复写会让插件加载两次
  • 可选:公网访问服务,只在手机和电脑不在同一个网络时才需要

安装步骤

  1. 01

    执行 `dsh plugin --profile web add dsh-console-hm`,把 `web` 换成你自己的 profile 名(`web` 是默认值)。

    $ dsh plugin --profile web add dsh-console-hm

  2. 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

  3. 03

    也可以在插件页安装:DSH 侧栏 → 插件 → 「添加插件」 → 选 `dsh-console-hm-<版本>.tgz`。

  4. 04

    开发时改用链接:把 `"dsh-console-hm": "link:<你的插件目录绝对路径>"` 写进 profile 的 `package.json` 依赖,再把 `"dsh-console-hm"` 加进 `dsh.profile.bundles` 数组,然后跑一次 `pnpm install`。

  5. 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 插件,包名 `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。
2026-10-182026-11-13ffmpeg-2026-11-09

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,所以插件正常跑着也能跑。

08数据与来源

  • 作者声明github.coma2f18d5d4343…

    dsh plugin --profile web add dsh-console-hm

  • 作者声明github.coma2f18d5d4343…

    挂在 **设置 → 导航列表 → DSH控制台**,也挂在**插件页**的配置区,侧栏底部还有两个入口。

  • 作者声明github.coma2f18d5d4343…

    前缀 `/api/dsh-console`,走 DSH 自己的 `connection.fetch.register`,

  • 作者声明github.coma2f18d5d4343…

    **带 DSH 的浏览器认证层**,所以裸 curl 会 401 —— 这是对的,不是 bug。

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-11-16。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件目录,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。