DeepSeek Harness 桌面版配置独立吗?profiles/desktop 与 DSH plugin 数据隔离

配置与使用发布于 2026-10-02作者: DeepSeek Plugin 插件市场
DeepSeek HarnessDSH plugin桌面版profile数据隔离
DeepSeek Harness 桌面版独占 $DSH_HOME/profiles/desktop,拥有自己的插件、配置与锁文件 profiles/desktop/lock,与 CLI、Web 的 profile 互不可见。本文讲清桌面版数据放哪、为什么插件不互通、以及 lock 与单实例机制。

DeepSeek Harness 桌面版独占 $DSH_HOME/profiles/desktop,拥有自己的插件、配置与锁文件 profiles/desktop/lock,与 CLI、Web 的 profile 互不可见。 这篇讲清桌面版数据放哪、为什么插件不互通、lock 与单实例机制怎么工作。

DeepSeek Harness 桌面版配置存哪:profiles/desktop 独占目录

DeepSeek Harness 桌面版使用独占的 $DSH_HOME/profiles/desktop 存放自己的插件、cordis.patch.yml 与运行数据,与 CLI、Web 各 profile 分开(来源)。 四步看清:

  1. 定位目录 — 桌面版的数据在 $DSH_HOME/profiles/desktop。预期:$DSH_HOME 取不到时是 ~/.dsh。
  2. 认 profile 内容 — 与普通 profile 一样,含 package.json、cordis.patch.yml 与插件依赖。预期:桌面版专属配置就写在这个目录的 patch 里。
  3. 区分另外两处 — CLI 与 Web 各用自己的 profile 目录。预期:三套数据互不覆盖。
  4. 备份整个目录 — 需要迁移时整目录一起拷。预期:插件与配置一起带走。

DeepSeek Harness 桌面版为什么和 CLI 插件不互通:profile 隔离

DeepSeek Harness 的 profile 之间默认互不可见:桌面版用 profiles/desktop、CLI 与 Web 各用自己的 profile,装到桌面版的 DSH plugin 不会出现在 CLI 的插件列表里(来源)。 按下面理解:

  1. 插件按 profile 安装 — 依赖装进各 profile 的 node_modules。预期:A profile 装的不在 B profile 生效。
  2. 配置按 profile 生效 — 权限、模型、插件配置都跟随 profile。预期:桌面版里改的模型不会改到 CLI。
  3. 名字不能混用 — desktop 是保留名,CLI 不能拿它当普通 profile boot 或 dump。预期:用会被拒绝,避免误操作桌面版数据。
  4. 需要一致就各配一遍 — 想桌面版和 CLI 行为一致,得分别配置。预期:没有自动同步机制。

想给桌面版补能力,先在 DSH Plugin Hub 找到想要的 DSH插件,再在桌面版里安装。

已安装插件

DeepSeek Harness 桌面版的锁文件与单实例机制

profiles/desktop/lock 是桌面版用于保证单实例的锁文件,防止多个桌面进程同时写同一份 profile 数据;正常情况下由程序管理,不建议手动删(来源)。 相关判断:

  1. 正常启动会持锁 — 桌面版运行期间锁文件存在。预期:这是正常状态。
  2. 重复启动被拦 — 已有实例时再启动不会并行写数据。预期:表现为聚焦到已有窗口或提示已在运行。
  3. 异常退出后残留 — 进程被强杀可能留下锁文件。预期:先确认没有桌面进程在跑,再按官方指引处理,别盲目删。
  4. 别多实例并行 — 绕过锁手动开两个实例会并发写同一份数据。预期:可能造成配置文件损坏。

DeepSeek Harness 桌面版配置的注意事项与局限

  1. 数据是分开的:桌面版、CLI、Web 三套 profile 互不可见,改一处不会同步到另一处。
  2. desktop 是保留名:CLI 拒绝用它 boot 与 dump,自定义 profile 要另取名字。
  3. lock 别手动删:先确认无运行实例,再按官方方式处理残留锁。
  4. 升级前先备份:$DSH_HOME/profiles/desktop 整目录备份,出问题能回退。
  5. 桌面版调试另说:端口与 DevTools 的配法见《DeepSeek Harness 桌面版怎么调试》;桌面端命令见《DeepSeek Harness 桌面端命令》。

来源:桌面端 README(官方仓库)

常见问题

DeepSeek Harness 桌面版的配置和插件数据放在哪个目录?

DeepSeek Harness 桌面版独占 $DSH_HOME/profiles/desktop,自己的插件、cordis.patch.yml 与运行数据都在这里,与 CLI、Web 用的其它 profile 分开存放。

桌面版装的 DSH plugin 在 CLI 或 Web 里能看到吗?

看不到。DeepSeek Harness 的 profile 之间默认互不可见,桌面版用 profiles/desktop,CLI、Web 各用自己的 profile,装到桌面版的插件不会出现在 CLI 的插件列表里。

为什么 CLI 不能把 desktop 当作普通 profile 名启动?

desktop 是 DeepSeek Harness 的保留 profile 名,由桌面端独占。CLI 会拒绝用 desktop 去 boot 或 dump 配置,避免命令行误用桌面版的数据目录。

DeepSeek Harness 桌面版的 lock 文件是什么、能手动删吗?

profiles/desktop/lock 是桌面版用于保证单实例的锁文件。正常情况下由程序管理,手动删可能造成多个实例并发写同一 profile 的数据,不建议手动干预。

相关术语

profiles/desktop
profiles/desktop 是 DeepSeek Harness 桌面版独占的 profile 目录,位于 $DSH_HOME/profiles 下,承载桌面版自己的插件、配置与运行数据,与 CLI、Web 各 profile 相互隔离。— DeepSeek Harness 桌面端 README
lock 文件
lock 文件(profiles/desktop/lock)是 DeepSeek Harness 桌面版用来保证单实例运行的锁,防止多个桌面进程同时写同一份 profile 数据。— DeepSeek Harness 桌面端 README
profile 隔离
profile 隔离是 DeepSeek Harness 的默认行为:不同 profile 拥有各自独立的 package.json、插件依赖与 patch 层,配置与插件默认不跨 profile 共享。— dsh CLI README
保留 profile 名
保留 profile 名指 DeepSeek Harness 中由特定客户端独占、不允许 CLI 当作普通 profile 使用的名字,当前为 desktop。— dsh CLI README

来源