dsh-plugin-sync

DSH PLUGIN开发与运行时

仓库 Jfreey/dsh-plugin-sync · npm dsh-plugin-sync

开发与运行时 L5 · 运行验证通过 安全审查:低风险 可信度:金 可安装插件
安装这个插件

通过自己的私有 GitHub 仓库备份与恢复 DSH 插件清单、版本与配置,换机时按需还原,本地源码插件也能一并同步。

一句话选型结论

按资料字段整理

dsh-plugin-sync 是开发与运行时类的 DSH 可安装插件,验证等级 L5 · 运行验证通过,安全审查为低风险,列出 5 项功能,有可直接复制的安装命令。验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么;涉及密钥或系统权限的,建议先在隔离环境试装。

分类开发与运行时 收录类型可安装插件 验证等级L5 · 运行验证通过 安全审查低风险
验证等级 L5 L5 · 运行验证通过
GitHub 星标 0 复刻 0 · 未关闭 issue 0
最近更新 2026-11-05 创建于 2026-11-05
README 11.0 KB 正文体量,越大说明说明书写得越细

安装

可安装插件
在 DSH 里执行,装完用 dsh plugin list 确认已挂上;标了 L4 / L5 的命令已在沙盒里真实跑通
dsh plugin --profile web add github:Jfreey/dsh-plugin-sync
  1. 1
    确认版本与运行环境

    兼容的 DSH 版本为 0.2.2-rc.1;版本不匹配时安装会报错。

  2. 2
    执行安装命令

    在 DSH 里执行上面的命令;多包仓库要注意区分具体子包名,别装错包。

  3. 3
    确认已挂载

    用 dsh plugin list 查看列表里是否出现这个插件,出现即挂载成功。

  4. 4
    试跑并检查权限

    加载后跑一个最小用例,确认它能正常工作;同时看它申请了哪些文件、命令或网络权限。

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求未标注来自仓库 package.json 的 engines 字段
前置依赖无需要同时安装的同级依赖
npm 包名dsh-plugin-sync可用 npm view 查看包信息

能做什么

5 项功能
字段来自项目仓库与公开索引,中文说明由本站标注

dsh-plugin-sync:让 DeepSeek Harness 的插件清单跟着你跨机器走

  • 插件清单与版本备份
  • 配置脱敏后同步
  • 本地源码插件备份
  • 差异预览后按需恢复
  • 插件更新检测与清理

适用场景

GitHub 集成存储

上游标签

backupdeepseek-harnessdshdsh-plugindsh-pluginsgithub-syncmulti-deviceplugin-sync

验证等级与安全审查

L5 · 运行验证通过
自动化流程结论,不是人工审核
验证等级L5 · 运行验证通过在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来
安全审查低风险静态分析结论,未标注不代表已通过审查
仓库健康度活跃按仓库活跃度与最近更新时间给出
可信度金综合仓库活跃度与验证结果

上面的结论来自上游最近一次自动化验证(2026-11-10): 同一套检查会在插件发新版后重跑,页面显示的是最新一次的逐项结果。

逐项检查结果

L1 · 已找到 ✓ 通过
  • L1.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L2 · 结构化 ✓ 通过
  • L2.0_DEFAULTED_FROM_L3 由 L3 推定 默认通过——L3 安装规范已通过(全库 L3 扫描策略)
L3 · 安装规范 ✓ 通过
  • L3.1_INSTALL_COMMAND_PARSED 安装命令已解析 方式:安装规范解析
  • L3.2_DSH_VERSION_DECLARED DSH 版本已声明 方式:DSH 版本声明
L4 · 安装已测 ✓ 通过
  • L4.1_INSTALL_EXECUTED_CONFINED 受限沙盒内执行安装 方式:沙盒安装执行
  • L4.2_INSTALL_SUCCESS 沙盒安装成功 方式:沙盒安装执行
  • L4.3_ARTIFACT_CONFIRMED 安装产物已确认 方式:沙盒安装执行
L5 · 运行已测 ✓ 通过
  • L5.1_INSTALL_PASSED_SANDBOXED 沙盒安装通过 方式:沙盒安装执行
  • L5.2_WEB_BOOT_READY Web 启动就绪 方式:Web 启动
  • L5.3_HTTP_SERVED HTTP 服务响应 方式:HTTP 请求
  • L5.4_PLUGIN_INVENTORY_ACTIVE 插件清单中已激活 方式:插件清单查询

风险详情

  • 结论说明 静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。
  • 风险计数 严重 0 / 高 0

选择建议

装之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 验证等级 L5:安装和运行都在沙盒里跑通过,装完能直接用的概率高。
  • 静态安全审查为低风险,没有发现明显可疑行为。
  • 有可直接复制的安装命令,不用自己翻文档找入口。
  • 标注了兼容的 DSH 版本(0.2.2-rc.1),按版本装不容易报错。
  • 列出了 5 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 没有声明 Node.js 版本要求,版本不匹配可能装不上。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

  • 需要在开发与运行时场景里给 DSH 补能力的人。
  • 想装完就能用、不想自己排依赖的人。
  • 能接受在本地装依赖、愿意自己确认权限的人。

不太适合

  • 只使用 DSH 官方内置能力、不接受第三方插件的人。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-plugin-sync当前 L5 · 运行验证通过 低风险 0 0.2.2-rc.1 有
deepseek-harness L3 · 安装规范通过 低风险 24.6 万 未标注 无
rea L4 · 沙盒安装通过 低风险 2.6 万 0.1.1-rc.2 有
dsh-TUI L4 · 沙盒安装通过 中风险 4,292 0.1.7-rc.2 等 5 个 有
mirage L3 · 安装规范通过 低风险 3,681 未标注 无
dashi-taskboard L4 · 沙盒安装通过 低风险 3,311 0.1.1-rc.2 有

仓库档案

开发与运行时
字段来自项目仓库与公开索引,中文说明由本站标注
作者 / 维护方Jfreey仓库 dsh-plugin-sync · 默认分支 main
分类开发与运行时dev
收录类型可安装插件声明了 dsh.bundle、可用 dsh plugin add 安装的条目
开发语言JavaScript仓库主语言
许可证MIT商用或二次分发前请确认条款原文
星标 / 复刻 / issue0 / 0 / 0收录时的数值,非实时
创建 / 更新2026-11-05 · 2026-11-05最后推送 2026-11-05
本站收录2026-11-05首次进入本站目录的时间

README 全文

11.0 KB
作者原文,中文版优先;只做安全转义,不改内容

插件同步

English | 中文

你的插件,跟着你走。换机器也不用再重找插件。

插件的清单、版本和配置,存在你自己的 GitHub 私有仓库里——不是谁的云。你改插件,它自动备份;换了机器,它拉下清单、列出差异,你勾选、点一次就装回来。本地目录安装的插件连源码一起还原,密钥类配置一步都不离开本机,每个文件落地前先验校验和。

截图使用虚构示例数据(octocat、workstation),不含任何真实账号或机器信息。

做什么

  • 清单:所有非安装自带的 bundle —— 名称、版本、启用状态、安装来源、声明的 row id。
  • 来源:每个插件到底从哪来。本地目录优先读 .git 的 origin,其次读包自己的 repository 字段,monorepo 会一直显示到子目录;查不到的标「来源未知」,不猜。
  • 配置项:这些 row 在 profile 里的 override 层。离开本机前,令牌形态的值统一替换成 `;apiKeyEnv` 这类「指向密钥的环境变量名」原样保留,因为它本身不是密钥。
  • 源码备份:从本地目录安装(link: / file:)的插件没有 registry 版本可重装。它的源码以真实文件提交进同一个私有仓库,一次推送一个提交,在 GitHub 上能直接读、能看 diff、能搜索。还原时下载、校验 SHA-256、写盘,再 link 安装。
  • 还原:缺失安装、版本替换、写入配置、切换启用状态,分组勾选。你没点,它不动;每条结果如实回报宿主真正做了什么。
  • 更新检查:来源发布了比本机新的版本时给提示;npm 装的可以在这里一键更新,本地目录的留给你自己处理。
  • 清理:每行一个「同步」开关(只影响这台机器);差异卡片里的「清理备份」可以删掉清单条目,也可以连带删掉仓库里的源码文件。
  • 推送:插件变更后自动(30 秒防抖)+ 手动。
  • 拉取:定时 + 手动;只算差异,绝不自己动手。

安装

本仓库本身就是可安装的 bundle(package.json 声明了 dsh.bundle)。用插件管理器指向这个目录或 GitHub 仓库,然后刷新页面:设置 → 插件同步。

dsh plugin --profile desktop add /绝对路径/plugin-sync

要求 DeepSeek Harness 0.2.x(settings.section、ctx.locale、ctx.pluginManager、ctx.configEditor、ctx.credentials 契约)。

登录

页面把两步都做成预填链接,不用记参数。默认数据仓库叫 dsh-plugin-sync-data:dsh-plugin-sync 这个名字留给插件本身的公开仓库,两个不撞名。

  1. ① 建私有仓库 → github.com/new?name=dsh-plugin-sync-data&visibility=private,点 Create(空仓库,不要勾 README)。
  2. ② 生成令牌(已预填) → 细粒度令牌表单打开时,名称、描述、90 天有效期、Contents: write 都已填好。Repository access 选 Only select repositories 勾上刚建的仓库,Generate,复制 github_pat_…。
  3. 粘进第一个输入框,点「从我的仓库里选」(令牌只用于这一次列仓库,不落盘),挑一个仓库,再点「校验并保存」——这时才真正登录并存令牌。登录后先拉取,不会把本机状态推上去:新机器只读,避免用空清单或旧版本覆盖共享 manifest。要让仓库第一次有内容,登录后点一次「推送」。

登录后,「更换仓库」→「从我的仓库里选」会列出令牌可写的全部仓库,选中后直接用已存的令牌复核可见性与写权限,不用重贴。一个 profile 只有一个活动仓库;两份互不干扰的存储 = 两个 DSH profile。

选到一个不是同步仓库的仓库会被拦住并确认:非空、没有 manifest 的仓库是别人的项目,页面会列出其中几个文件名,你确认后才写;同名文件但格式不对,直接拒绝。

经典令牌(repo scope)也能用,但权限更宽,不推荐。插件不读 git 凭据助手,也不读钥匙串。

仓库必须是私有的:配置会离开本机,公开仓库等于公布。公开仓库在登录时和每次推送前都会被拒,除非你勾选红色的「⚠ 允许公开仓库」。

仓库里有什么

根目录的 dsh-plugin-sync.json:

{
"schema": 1,
"updatedAt": "2026-11-05T05:10:00.000Z",
"devices": {
"3f2a91c0d4e8": { "name": "workstation", "updatedAt": "…" }
},
"plugins": {
"dsh-searxng-search": {
"version": "0.5.0",
"enabled": true,
"source": "local:dsh-searxng-search",
"repository": "https://github.com/octocat/dsh-searxng-search",
"repositoryFrom": "git-remote",
"config": { "searxng-search": { "proxy": "http://127.0.0.1:7890" } },
"snapshot": {
"format": "tree",
"path": "snapshots/dsh-searxng-search/0.5.0",
"commit": "9c33e2c…",
"files": 18,
"bytes": 292546,
"sha256": "…"
},
"redacted": 1,
"updatedAt": "…",
"by": "3f2a91c0d4e8"
}
}
}

本地插件的源码按真实文件放在 snapshots/<名字>/<版本>/ 下,通过 Git Data API 提交,所以一次推送就是一个提交,仓库保持可读:能直接在 GitHub 上翻源码、看两次备份之间的 diff、用仓库搜索。文件按内容寻址,没变的文件不重复上传;被删掉的文件在同一个提交里删除;可执行位保留。

收哪些文件:package.json 的 files 白名单(没写就全收),外加 package.json、cordis.patch.yml、locale/、assets/、scripts/、图标和 README。node_modules、.git、.env*、日志、软链永远不收。单文件超过 1 MiB 或整份超过 maxSnapshotBytes,整份拒绝,不会上传半份。

合并

两台机器写同一个文件。每次推送先读当前版本,把本机条目合进去,再用读到的版本号写回;返回 409 说明别人先写了,就重读再合并(最多三次)。本机没有的远端条目原样保留——这是并集,空机器推上去不会删掉任何东西。

配置

字段 默认 含义
repo 空 私有仓库的 owner/name。
apiBase https://api.github.com GitHub Enterprise 时修改。
manifestPath dsh-plugin-sync.json 清单文件的位置。
snapshotsPath snapshots 源码备份的位置。
snapshotFormat tree tree 存真实文件;json 退回单文件 base64 快照。
deviceName 主机名 写进清单的设备名。
deviceId 自动派生 稳定身份,为空时按主机、平台、home 派生。
autoPush true 插件变更后自动推送,30 秒防抖。
autoPull true 定时拉取清单。
intervalMinutes 15 定时周期,限制在 1–1440。
includeSnapshots true 上传本地插件的源码。
maxSnapshotBytes 4194304 单个插件的源码总量上限。
maxManifestBytes 2097152 清单上限,超过直接拒绝。
excludedRows [] 这台机器永不发布的 row id。
excludedPlugins [] 这台机器不推送、也不参与差异的插件。
allowPublicRepo false 允许公开的同步仓库。

页面里改的设置存在 ~/.dsh-plugin-sync/settings.json(在 profile 之外,不重写任何 profile 文件);cordis.patch.yml 里的 row 配置提供默认值。

安全说明

  • 只接受回环浏览器的请求。 /state 和 /api 要求自定义头 x-dsh-plugin-sync: 1(它触发 CORS 预检,而路由从不回应预检,别的源发不出这个请求),对端必须是 127.0.0.1/::1,Origin 不在回环或 Sec-Fetch-Site 为 cross-site 一律拒绝。curl 仍要带头,网页加不了这个头。这两个路由不在 Harness 会话登录之后:请让 Harness 只监听回环。
  • 令牌绑定验证它的主机。 登录用 HTTPS(仅回环允许明文 HTTP)调 GET /user,并把 base 和令牌一起写进凭据记录;之后所有请求都用这个 base,改设置不可能把令牌送去别处,换 API 主机必须重贴令牌。
  • 机密不外发。 脱敏分两层:敏感形态的键名 和 敏感形态的值(ghp_…、github_pat_…、sk-…、xox…、AKIA…、PEM 私钥)都变成 `;apiKeyEnv` 这类引用保留,因为它只是指向密钥的名字。
  • 源码也要过扫描。 源码里出现令牌形态的值,整份拒绝并点名文件,粘进插件的 token 不可能进仓库。
  • 清单不含本机路径。 本地插件的绝对路径被替换成 local:,还原靠源码备份。仓库路径(manifestPath、snapshotsPath、快照自身路径)会校验 ..、绝对路径和反斜杠,还原的每个文件落盘前都验校验和与路径。
  • 来源不携带凭据。 https://user:token@github.com/o/r.git 这类 remote 会被规范化成干净的 URL 再存储。
  • 只按预期来源安装。 应用只接受 github: spec、https://github.com/… spec,或计划生成的那个精确 name@version;其它一律拒绝(INSTALL_REFUSED / SOURCE_MISSING)。更新固定到探测到的具体版本。
  • 公开仓库被拒两次:登录时一次,每次推送前再一次。唯一的口子是红色的「⚠ 允许公开仓库」:勾选会展开确认,写明清单、脱敏后的配置和源码都会公开,且推上去的提交留在 Git 历史里;宿主还会校验请求必须带 acknowledgePublic(ACK_REQUIRED)才肯保存。同步仓库必须保持私有。
  • 令牌存在凭据记录 dsh-plugin-sync/github(存储文件权限 0600),插件自己的设置文件同样是 0600。没有任何路由会返回令牌,插件也不读 git 凭据或钥匙串。

存储与发布:调研结论

DSH 把 GitHub 来源装成仓库的根包(installBundle('github:owner/repo#v1.0.0'),pnpm 之前先用 git ls-remote 核对)。pnpm 无法安装 git 仓库的子目录,所以「一个仓库装多个 plugins//…」这条路走不通。

于是拆成两件事:

  • 存储(当前版本)——一个私有仓库放清单和源码。多端同步够用,还原是插件自己的活:下载、校验、写到 ~/.dsh-plugin-sync/plugins/…,有依赖就先装依赖,再 installBundle(那个目录)。
  • 发布(下一版)——每个插件一个公开仓库,带 package.json、cordis.patch.yml、v 标签和 dsh 话题。之后任何 Harness 都能用 github:owner/repo#v 装,不再需要本插件。那是分发,不是同步,所以留成独立动作;市场 PR 仍然手动。

开发

node --check index.js && node --check client.js
node --test test/*.test.js

无构建步骤,无运行时依赖。

许可

MIT —— 见 LICENSE。

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
dsh-plugin-sync 怎么安装?

在 DSH 里执行 `dsh plugin --profile web add github:Jfreey/dsh-plugin-sync` 即可。对应的 npm 包名是 `dsh-plugin-sync`。

dsh-plugin-sync 的验证等级是什么意思?

L5 · 运行验证通过。在 dsh 沙盒中完成安装与运行冒烟——装得上、跑得起来

dsh-plugin-sync 安全吗?

低风险。静态扫描 低;动态审计无结论(以下以静态为准)→ 总评级 低。

dsh-plugin-sync 装之前要先确认什么?

先看它会读写哪些文件、执行哪些命令、连接哪些网络地址;验证等级只说明装得上、跑得起来,不等于安全。涉及密钥或系统权限的,建议先在隔离环境试装。

dsh-plugin-sync 支持哪些 DSH 版本?

上游记录的兼容版本包括 0.2.2-rc.1。

dsh-plugin-sync 用的是什么许可证?

上游标注为 MIT。商用或二次分发前请到仓库确认许可证原文。

dsh-plugin-sync 有哪些功能?

插件清单与版本备份、配置脱敏后同步、本地源码插件备份、差异预览后按需恢复、插件更新检测与清理。

这条记录的数据可靠吗?

本站按仓库名去重后合并整理,字段以作者仓库与 npm 元数据为准;安装命令、仓库地址与 README 保持原文,带 L4 / L5 标记的安装命令已在隔离沙盒里真实跑通。

同名或近似条目

3 条
不同作者的仓库分开列,请确认你要装的是哪一个
开发与运行时
按星标排序,可作替代方案

rea

rea

L4 · 沙盒安装通过 2.6 万 星

dsh-TUI

dsh-TUI

Claude Code 风格全屏终端 UI:像素鲸鱼顶栏、实时工作状态行、思考流式展开。

L4 · 沙盒安装通过 4,292 星

mirage

mirage

把文件系统与 bash 提供者换成 mirage 虚拟工作区:文件工具与 shell 命令作用于挂载的资源(RAM、S3、Redis、Sla

L3 · 安装规范通过 3,681 星

dashi-taskboard

dashi-taskboard

把当前已安装并运行中的 Codex Taskboard 嵌入 DeepSeek Harness 侧边栏,并通过 Launcher 运行时描述

L4 · 沙盒安装通过 3,311 星

Jfreey 的其它插件

2 个

插件的元信息来自作者仓库;分类、验证等级与安全结论的中文说明为中文整理,最近核验 2026-11-10。