DeepSeek Harness 三种入口怎么选：CLI、桌面端与 dsh web 的能力边界

DeepSeek Harness 的三种入口不是版本高低，而是同一工具的三个外壳：CLI 适合自动化与远程、桌面端适合图形操作与本地重活、dsh web 适合多设备与轻客户端。 选择依据只有两问：你在哪台设备上、要做什么。真正要留意的是配置边界——同一 profile 共享插件与配置，不同数据目录就是两套环境。

DeepSeek Harness 三入口能力矩阵

一句话结论：CLI 强在自动化与可脚本化、桌面端强在本机图形操作、dsh web 强在跨设备与轻客户端——三者强项几乎不重叠。

方案 A：以 CLI 为主

一句话结论：要自动化、要远程、要在没有图形界面的机器上用——只有 CLI 合适，其他入口都替代不了。

1. 本地跑：直接在终端里用 dsh 启动与操作，最省资源。
2. 远程跑：经由 SSH 在服务器上执行，与你本机的图形环境无关。
3. 脚本里跑：适合放进流水线与定时任务（写法见 CI 里更新 DeepSeek Harness 与 DSH plugin）。
4. 配合网页端看结果：CLI 跑长任务、dsh web 里看会话输出，是常见的高效组合。
5. 取舍：没有图形化界面，复杂会话的浏览与检索体验弱于网页端。

方案 B：以桌面端为主

一句话结论：要在本机做图形化操作、又不想被浏览器策略限制——桌面端是最顺的那一个。

1. 适合场景：本机项目处理、需要精细点击与拖拽的操作、以及企业电脑浏览器被策略锁死的情况。
2. 优势：直接使用系统能力，不受浏览器扩展与策略影响。
3. 注意更新路径差别：桌面端与 CLI 的更新通道不同，版本可能不一致；对齐方法见 多台机器统一更新 DeepSeek Harness。
4. 注意平台支持面：桌面端并非所有平台都有官方包（例如 Linux ARM 上通常只有 CLI）。
5. 取舍：跨设备访问能力弱——想在手机上用还是要靠 dsh web。

方案 C：以 dsh web 为主

一句话结论：要多设备访问、客户端只想装一个浏览器——dsh web 是唯一答案，代价是要处理网络与访问安全。

1. 本机起服务、浏览器访问是基本用法。
2. 跨设备：同一局域网的手机/平板直接访问（见 局域网访问 dsh web）。
3. 对外访问：需要外网可达就加反向代理与 HTTPS（见 给 dsh web 配反向代理与 HTTPS）。
4. 注意暴露面：dsh web 默认只服务本机是有意设计；对公网可达前务必加访问控制。
5. 取舍：受浏览器兼容与策略影响；多标签会各自占资源。

DSH plugin 混用的边界：同一 profile 多处打开的注意点

一句话结论：共享同一 profile 是「共享环境」而不是「合并界面」——要注意并发写与版本一致两件事。

1. 插件与配置是共享的：同一 profile 下，一个入口装的 DSH plugin 另一个入口也能看到。
2. 并发写要注意：多个入口同时操作同一会话数据时行为可能不一致，长任务建议只在一个入口里发起。
3. 版本要一致：CLI 与桌面端各自更新会导致表现差异，排查时先确认两边版本（见 npx 与全局混装的版本漂移）。
4. 不想共享就隔离：给不同入口配不同数据目录/profile，就能得到互不干扰的多套环境——这是有意为之的用法，不是错误配置。
5. 判据：出现「这边和那边不一样」时，先查数据目录与版本，再查功能本身。

DeepSeek Harness 按场景的推荐组合

一句话结论：组合而非单选——常见场景都有固定搭配，照表选能省掉大量试错。

DSH plugin 排查注意事项

一句话结论：入口相关的问题先问「数据目录是否同一份、版本是否一致」——这两条能解释绝大多数「换个入口就不一样」。

1. 插件不见了→ 查两个入口的 DSH_HOME 与 profile 是否相同（不是查插件本身）。
2. 行为不一致→ 查两边版本是否一致。
3. 网页端打不开→ 先在本机 curl 验证服务，再查网络与绑定（见局域网一文的三步）。
4. 桌面端装不上插件→ 查平台支持面与依赖前提。
5. 要用某个插件前→ 在 DSH Plugin Hub 里核对它在你的目标入口上是否可用（不同入口的可用性会随版本变化）。
6. 修复状态如实：本文能力矩阵基于官方 CLI 与桌面端 README 的定位描述归纳而来，未逐版本核对全部能力清单；功能覆盖随版本变化，具体以你所用版本的官方说明与实测为准。

无论用哪个入口，插件状态都可以在同一个地方核对——打开 DSH Plugin Hub 的已安装列表，就能确认当前这套环境装了什么、什么版本。

只在网页版与桌面端之间纠结的话，见网页版和桌面端怎么选。

来源：apps/cli/README.md、apps/desktop/README.zh.md、npm @deepseek-ai/dsh。