dsh-plugin-compat-sync
Verifieddsh-plugin-compat-sync · v0.1.0 · MIT
自动保持 profile 内 @deepseek-ai 插件版本与 DeepSeek Harness 运行时一致:应用升级后自动对齐配套插件,安装失败或装到旧版时按退避策略自动重试
Install
dsh plugin add dsh-plugin-compat-sync Confirm the layer applied with dsh --profile default --dump-config — see the install guide.
Source
Tags
Creators
Readme
dsh-plugin-compat-sync
自动保持 DeepSeek Harness 桌面端 profile 内 @deepseek-ai/* 插件版本与应用运行时版本一致。
解决的问题
DeepSeek Harness 自动升级后(如 0.2.1-rc.2 → 0.2.1-rc.3),profile 里旧版的
@deepseek-ai/dsh-storage-domain 会被启动兼容性预检禁用,导致
typert gateway: session/follow: active Service "sessionController" is unavailable
(历史加载失败)。本插件在应用启动时及周期巡检中自动对齐这些插件。
工作原理
- 读取应用运行时版本(
resources/runtime/primary-runtime/runtime.json的desktopVersion) - 与 profile 中实际安装的插件版本比较(依赖声明与安装版本都检查)
- 不一致 → 用应用自带的 pnpm 执行
pnpm add <pkg>@<runtimeVersion>对齐 - 安装后立即校验实际版本:registry 滞后/缓存导致装到旧版时,按失败处理并换源重试
- 全部失败 → 指数退避自动重试(1/2/4/8/16/30 分钟封顶),直到对齐成功
- 与官方插件管理器共用
package.json.lock文件锁,拿不到锁就跳过本轮,互不冲突
设计要点
- 零依赖:只用 Node 内置模块,不 import 任何
@deepseek-ai包——本插件自身 永远不会被兼容性预检禁用(没有 dsh peer 依赖可被检查)。 - registry 顺序可配,默认优先
https://registry.npmmirror.com(直连 npmjs 的 tarball 在部分网络下经常超时),失败自动回退官方源。
配置(cordis.patch.yml 中的 config)
| 键 | 默认 | 说明 |
|---|---|---|
checkIntervalMs |
600000 |
巡检周期(毫秒)。应用可能被热更新,周期巡检无需重启即可发现版本变化 |
lockTimeoutMs |
90000 |
等待 package.json.lock 的最长时间 |
installTimeoutMs |
300000 |
单次 pnpm 安装超时 |
registries |
["https://registry.npmmirror.com", ""] |
依次尝试的 registry;空串 = pnpm 默认源 |
autoRestart |
false |
对齐成功后自动重启应用使新插件生效(默认只提示手动重启) |
环境变量(测试/调试用):DSH_COMPAT_SYNC_RUNTIME_VERSION、
DSH_COMPAT_SYNC_PROFILE_DIR、DSH_COMPAT_SYNC_DRY_RUN=1、
DSH_COMPAT_SYNC_PNPM、DSH_COMPAT_SYNC_CHECK_INTERVAL_MS。
安装
方式一:npm 安装(发布后)
dsh plugin --profile desktop add dsh-plugin-compat-sync
方式二:本地路径安装(未发布时)
# 应用需完全退出后执行;务必带 file: 协议——直接传路径会被 pnpm 转成 link:,
# link: 在 Windows 上创建失败会导致空目录,且插件管理器 reconcile 会报错
dsh plugin --profile desktop add "file:/path/to/dsh-plugin-compat-sync"
方式三:GitHub 安装(若发布到 GitHub)
dsh plugin --profile desktop add github:chenxiedou/dsh-plugin-compat-sync
安装完成后因声明了 dsh.bundle.patch,包会自动加入 profile 的 bundles 并激活。
分享给其他人
本包名 dsh-plugin-compat-sync 在 npm 上尚未被占用。推荐发布流程:
- 注册 npm 账号并在本机登录:
npm login(本机目前未登录过 npm) - 检查包内容无误:
npm pack --dry-run - 发布:
cd dsh-plugin-compat-sync npm publish - 把安装命令告诉对方:
dsh plugin --profile desktop add dsh-plugin-compat-sync
更新插件时改 package.json 的 version 后再次 npm publish;用户侧执行
dsh plugin --profile desktop add dsh-plugin-compat-sync@latest 即可升级。
若不想发布到 npm,也可以:
- 建一个 GitHub 仓库把本目录推上去,对方用
github:方式安装; - 或直接打包 zip 发过去,对方解压后用
file:方式安装。
日志与状态
- 活动日志:
<profile>/.compat-sync/activity.log - 状态文件:
<profile>/.compat-sync/state.json(记住上次成功同步的运行时版本)
测试
node test/smoke.mjs