DeepSeek Harness 桌面版怎么调试？DSH plugin 与 DSH_DESKTOP 端口变量

DeepSeek Harness 桌面版用三个环境变量开调试端口：DSH_DESKTOP_MAIN_INSPECT_PORT（默认 9229，主进程）、DSH_DESKTOP_RENDERER_DEBUG_PORT（默认 9222，渲染进程）、DSH_DESKTOP_HOST_INSPECT_PORT（默认 9230，宿主进程），另用 DSH_DESKTOP_OPEN_DEVTOOLS 控制开发者工具。 这篇讲清端口分工、DevTools 打开方式与开发模式运行。

DeepSeek Harness 桌面版调试端口有哪些：三个 DSH_DESKTOP 变量

DeepSeek Harness 桌面版有三个调试端口环境变量：DSH_DESKTOP_MAIN_INSPECT_PORT（默认 9229）、DSH_DESKTOP_RENDERER_DEBUG_PORT（默认 9222）、DSH_DESKTOP_HOST_INSPECT_PORT（默认 9230）（来源）。 逐个认：

1. DSH_DESKTOP_MAIN_INSPECT_PORT（9229） — 主进程调试端口。预期：用来连主进程调试器，排查窗口与生命周期问题。
2. DSH_DESKTOP_RENDERER_DEBUG_PORT（9222） — 渲染进程调试端口。预期：界面层的控制台与网络请求在这里看。
3. DSH_DESKTOP_HOST_INSPECT_PORT（9230） — 宿主进程调试端口。预期：排查承载宿主逻辑的进程。
4. 按需改端口 — 默认端口被占用时，在启动前 export 同名变量覆盖。预期：改成空闲端口即可。
5. 只开需要的 — 只排查界面问题就先用 9222。预期：不必三个都开。

DeepSeek Harness 桌面版怎么开 DevTools 与开发模式

用 DSH_DESKTOP_OPEN_DEVTOOLS 控制是否自动打开开发者工具；开发模式在仓库里用 pnpm run dev:desktop 启动（来源）。 按步骤走：

1. 设置 DevTools 开关 — 启动桌面版前设置 DSH_DESKTOP_OPEN_DEVTOOLS。预期：需要自动打开界面调试面板时用得上。
2. 启动调试实例 — 带上前面的端口变量启动桌面版。预期：调试端口开始监听。
3. 连接调试器 — 用主进程端口 9229 连主进程、渲染端口 9222 看界面。预期：能在 DevTools 里看到控制台与网络。
4. 开发模式运行 — 从源码跑 pnpm run dev:desktop。预期：改代码即时反映，适合排查桌面壳与插件加载。
5. 复位环境变量 — 排查完把临时变量清掉。预期：避免日常使用也开着调试端口。

调试桌面版里 DSH插件 的加载问题时，先用 DSH Plugin Hub 确认插件本身已装在桌面版的 profile 里。

DeepSeek Harness 桌面版调试端口和 Web UI 3080 的关系

桌面版调试端口（9222、9229、9230）属于 Electron 调试通道，与 dsh Web UI 的 3080 服务端口是两套东西，端口段不同、同时开不冲突（来源）。 分清三点：

1. 用途不同 — 调试端口给开发者工具连，3080 给浏览器访问 Web UI。预期：一个排查、一个使用。
2. 端口段不同 — 调试端口在 92xx，Web UI 在 3080。预期：不会互相占用。
3. 同时开启无碍 — 两者可以并存。预期：一边调试桌面版、一边开 Web UI 互不影响。
4. Web UI 的配法另见 — 访问地址与配置见《dsh web 怎么用》。

DeepSeek Harness 桌面版调试的注意事项与局限

1. 调试端口别长期开：属于开发者通道，日常使用应关掉，避免暴露本机接口。
2. 端口冲突要改：默认 9222/9229/9230 被占用时，启动前 export 变量换成空闲端口。
3. 开发模式面向源码：pnpm run dev:desktop 需要仓库与依赖，普通用户装发行版即可。
4. 调试前先确认插件已装：插件问题先确认它装在桌面版的 profiles/desktop 里，见《桌面版配置独立吗》。
5. 锁文件别乱删：桌面版单实例由 profiles/desktop/lock 保证，调试反复启动后如异常，先确认无残留进程。

来源：桌面端 README（官方仓库）