DeepSeek Harness 桌面版配置独立吗?profiles/desktop 与 DSH plugin 数据隔离
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 分开(来源)。 四步看清:
- 定位目录 — 桌面版的数据在
$DSH_HOME/profiles/desktop。预期:$DSH_HOME取不到时是~/.dsh。 - 认 profile 内容 — 与普通 profile 一样,含
package.json、cordis.patch.yml与插件依赖。预期:桌面版专属配置就写在这个目录的 patch 里。 - 区分另外两处 — CLI 与 Web 各用自己的 profile 目录。预期:三套数据互不覆盖。
- 备份整个目录 — 需要迁移时整目录一起拷。预期:插件与配置一起带走。
DeepSeek Harness 桌面版为什么和 CLI 插件不互通:profile 隔离
DeepSeek Harness 的 profile 之间默认互不可见:桌面版用 profiles/desktop、CLI 与 Web 各用自己的 profile,装到桌面版的 DSH plugin 不会出现在 CLI 的插件列表里(来源)。 按下面理解:
- 插件按 profile 安装 — 依赖装进各 profile 的
node_modules。预期:A profile 装的不在 B profile 生效。 - 配置按 profile 生效 — 权限、模型、插件配置都跟随 profile。预期:桌面版里改的模型不会改到 CLI。
- 名字不能混用 —
desktop是保留名,CLI 不能拿它当普通 profile boot 或 dump。预期:用会被拒绝,避免误操作桌面版数据。 - 需要一致就各配一遍 — 想桌面版和 CLI 行为一致,得分别配置。预期:没有自动同步机制。
想给桌面版补能力,先在 DSH Plugin Hub 找到想要的 DSH插件,再在桌面版里安装。

DeepSeek Harness 桌面版的锁文件与单实例机制
profiles/desktop/lock 是桌面版用于保证单实例的锁文件,防止多个桌面进程同时写同一份 profile 数据;正常情况下由程序管理,不建议手动删(来源)。 相关判断:
- 正常启动会持锁 — 桌面版运行期间锁文件存在。预期:这是正常状态。
- 重复启动被拦 — 已有实例时再启动不会并行写数据。预期:表现为聚焦到已有窗口或提示已在运行。
- 异常退出后残留 — 进程被强杀可能留下锁文件。预期:先确认没有桌面进程在跑,再按官方指引处理,别盲目删。
- 别多实例并行 — 绕过锁手动开两个实例会并发写同一份数据。预期:可能造成配置文件损坏。
DeepSeek Harness 桌面版配置的注意事项与局限
- 数据是分开的:桌面版、CLI、Web 三套 profile 互不可见,改一处不会同步到另一处。
desktop是保留名:CLI 拒绝用它 boot 与 dump,自定义 profile 要另取名字。- lock 别手动删:先确认无运行实例,再按官方方式处理残留锁。
- 升级前先备份:
$DSH_HOME/profiles/desktop整目录备份,出问题能回退。 - 桌面版调试另说:端口与 DevTools 的配法见《DeepSeek Harness 桌面版怎么调试》;桌面端命令见《DeepSeek Harness 桌面端命令》。
常见问题
DeepSeek Harness 桌面版独占 $DSH_HOME/profiles/desktop,自己的插件、cordis.patch.yml 与运行数据都在这里,与 CLI、Web 用的其它 profile 分开存放。
看不到。DeepSeek Harness 的 profile 之间默认互不可见,桌面版用 profiles/desktop,CLI、Web 各用自己的 profile,装到桌面版的插件不会出现在 CLI 的插件列表里。
desktop 是 DeepSeek Harness 的保留 profile 名,由桌面端独占。CLI 会拒绝用 desktop 去 boot 或 dump 配置,避免命令行误用桌面版的数据目录。
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
来源
- DeepSeek Harness 桌面端 README· deepseek-ai