dsh cli 和桌面端、Web 版怎么分工：命令、会话与插件管理三块能力的完整对照与限制

dsh cli、Web 版与桌面端不是三个产品，而是同一套能力的三个入口。 CLI 负责命令，Web 负责界面，桌面负责系统集成；混着理解，最容易在「插件装哪」上出错。

三端能力矩阵

先看一张表，后面逐块展开。

CLI 强在命令与自动化，Web 强在界面与远程，桌面端强在系统集成。 启动、装插件、跑脚本都靠 CLI，它不提供完整图形界面（来源）；Web 浏览器打开就能用，适合远程服务器与多设备，但依赖后端服务先启动；桌面端窗口、托盘、文件对话框更完整，它仍然是同一套核心，不是独立生态。

CLI：命令与自动化

CLI 是「入口的入口」。 没有它，Web 与桌面都起不来。

1. 启动服务：dsh web，输出本地地址。
2. 管理插件：dsh plugin --profile web list/add/remove。
3. 查配置：dsh --dump-config，确认插件注册。
4. 自动化：脚本与 CI 调用命令，看退出码。
5. 版本确认：dsh --version，排查兼容问题。

CLI 的边界是「看不见」，但它最适合排查。 它能完成动作，但不展示会话列表与可视化面板；需要浏览时仍要打开 Web。日志、版本、配置树都能在终端里看到；界面出问题时，先回 CLI 确认服务状态。

Web：浏览器与远程

Web 是日常使用的主界面。 会话、插件市场、文件与设置都在这。

1. 由 CLI 或桌面端启动服务后，浏览器访问地址。
2. 浏览会话、搜索、归档与插件市场。
3. 远程场景通过 SSH 或反向代理访问。
4. 多设备共用一个服务时，注意会话锁与并发。
5. 浏览器兼容与缓存问题，先换浏览器对照。

Web 的边界是「依赖服务」，但它最适合远程。 服务没起、端口不通、认证失败，界面就打不开；先查服务，再查浏览器。服务器上跑服务、本地浏览器访问，是 Linux 与云主机最常见的组合。

桌面：窗口与系统集成

桌面端把同一套能力包进客户端，补上系统集成。

1. 安装包安装，启动即用，不需要手动起服务。
2. 提供窗口、托盘、通知与文件对话框。
3. 插件市场与设置内置，交互更完整。
4. 更新走应用内流程，不依赖命令行。
5. 卸载走系统流程，再清数据目录。

桌面端的边界是「平台」。 目前以 macOS 与 Windows 为主；Linux 没有官方包，应改用 CLI 加浏览器。

桌面端不是「功能更多」。 核心能力一致，差别在集成与交互；不要为了某个功能重复装两套。

会话是否共享

共享与否取决于数据目录，不取决于客户端。

1. 同一台机器、同一个 DSH_HOME：会话共享。
2. 不同机器：各自独立，需要同步或迁移。
3. 不同数据目录：看起来像两套环境，会话不互通。
4. 同时写入同一会话：可能出现锁与版本不一致。
5. 迁移时停服务再复制，避免半写文件。

「桌面端看不到 Web 的会话」多半是数据目录不同。 先确认 DSH_HOME，再谈同步。

不要两端同时写。 会话日志是文件，并发写入容易损坏；需要并行时，用不同会话。

插件管理在哪端

插件装进 profile，不装进客户端。 这是最容易误解的一点。

1. 桌面端与 Web 常用不同 profile： 插件要分别安装。
2. CLI 用 --profile 指定目标： 装错就不显示。
3. 同一 profile 下： 三端共享已装插件。
4. 插件市场是界面： 安装动作落到 profile；排查「装了没生效」，先确认 profile。

「在哪端装」不如「装进哪个 profile」重要。 客户端只是操作入口，profile 才决定生效范围。

记录 profile 与插件清单。 换端或换机器时，按清单重装，比逐个猜快。

怎么选

按「在哪用、要不要图形、是否远程」选。

CLI 与 Web 是基础组合。 桌面端是体验增强，不是必需；远程场景直接用 CLI 加 Web 更轻。

不要为了统一而统一。 三端各有边界，按场景选，比强行只用一端有效。

下一步

先认入口，再认 profile，最后认数据目录。 想看 CLI 的完整命令，看《dsh cli 是什么》；想看 Web 与桌面的差异，看《DeepSeek Harness 网页版和桌面端怎么选》；想看远程访问，看《DeepSeek Harness 远程访问怎么配》。

来源：dsh CLI README、DeepSeek Harness 官方文档、deepseek-harness 仓库