Skip to content

dsh-plugin-compat-sync

Verified

dsh-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

npm License: MIT

自动保持 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 (历史加载失败)。本插件在应用启动时及周期巡检中自动对齐这些插件。

工作原理

  1. 读取应用运行时版本(resources/runtime/primary-runtime/runtime.json 的 desktopVersion)
  2. 与 profile 中实际安装的插件版本比较(依赖声明与安装版本都检查)
  3. 不一致 → 用应用自带的 pnpm 执行 pnpm add <pkg>@<runtimeVersion> 对齐
  4. 安装后立即校验实际版本:registry 滞后/缓存导致装到旧版时,按失败处理并换源重试
  5. 全部失败 → 指数退避自动重试(1/2/4/8/16/30 分钟封顶),直到对齐成功
  6. 与官方插件管理器共用 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 上尚未被占用。推荐发布流程:

  1. 注册 npm 账号并在本机登录:npm login(本机目前未登录过 npm)
  2. 检查包内容无误:
    npm pack --dry-run
    
  3. 发布:
    cd dsh-plugin-compat-sync
    npm publish
    
  4. 把安装命令告诉对方:
    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