dsh-console-plugin

DSH控制台面板（dsh-console）

在 DSH 里加一块配对面板：手机扫一下二维码（或输 6 位码）就连上这台电脑的 DSH，

之后在手机 App 里收发会话、看历史、传文件。手机不在同一个网络时走公网隧道。

全部能力都在本机跑（局域网服务 + DSH 自己的会话服务），局域网内使用不依赖任何云端。

---

配套 App：鸿蒙「DSH控制台」

本插件是电脑这一侧，手机端要装鸿蒙 App 「DSH控制台」 配合使用。

App 只在应用商店下载，本仓不提供安装包。

---

能干的事

| 能力 | 说明 |

|---|---|

| 扫码配对 | 面板出二维码，手机 App「扫一扫」直接连上。二维码里是一次性票据，5 分钟过期、兑换即焚，长期访问码不进二维码 |

| 6 位码配对 | 面板出 6 位数字，App 里输进去就行，手机自己找同一网络里的电脑，不用填 IP。码 15 分钟有效，用掉即作废 |

| 异地配对 | DSH 装在云服务器 / 手机和电脑不在同一 WiFi 时，打开「异地配对」开关，面板给出 6 位异地配对码，App 输进去也能连 |

| 公网访问 | 开通公网访问服务后，手机在蜂窝网也能连回这台电脑（隧道由插件自己拉，不用另装东西） |

| 状态灯 | 顶部主卡两盏：手机连没连、这台电脑的 DSH 会话服务通不通，互不干扰 |

| 升级卡 | 面板里直接显示 npm 上的最新版号，能一键升级 / 回滚 |

| 网页聊天 | DSH 侧栏底部多一个「网页聊天」入口，把网页版对话放进右侧栏，和会话并排 |

---

安装

方式 A · 一条命令装（推荐）

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

--profile 后面写你自己的 profile 名（默认是 web）。这个参数不能省，省掉会直接报

required option '--profile ' not specified。

刚发的版本有时会装到上一个，那是 pnpm 的「最小发布龄」供应链策略在拦新包，等一会儿再装，

或者指定版本号 / 关掉这条策略：

dsh plugin --profile web add dsh-console-plugin@latest --config.minimumReleaseAge=0

方式 B · 插件页安装

DSH 侧栏 → 插件 → 「添加插件」→ 选 dsh-console-plugin-<版本>.tgz。

方式 C · 写进 profile（开发用）

profile 的 package.json 里：

"dependencies": { "dsh-console-plugin": "link:<你的插件目录绝对路径>" }

再把 "dsh-console-plugin" 加进该文件的 dsh.profile.bundles 数组，然后跑一次 pnpm install。

> ⚠️ 不要在 profile 的 cordis.patch.yml 里再写一遍 insert。

> loader 行放在包自己的 cordis.patch.yml 里（包里已经带了）。

> profile 那个文件只放 id 定向的配置覆盖 —— 重复 insert 会让插件加载两次。

配置项（一般不用动）

写在 profile 的 cordis.patch.yml 里，按 id 定向覆盖：

- id: dsh-console
  config:
    port: 8899           # 局域网服务端口
    name: "我的电脑"      # 面板上显示的节点名，默认取系统主机名
    allowShiftPort: false # 端口被占用时要不要自动往后顺延

---

面板上有什么

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

┌──────────────────────────────────────────────────────────────┐
│  [DFY]  DSH控制台        ● 手机 · 刚刚活跃  ● DSH 正常        │
│         DeepSeek Harness · 我的电脑                          │
└──────────────────────────────────────────────────────────────┘