dsh-settings-sync

DSH PLUGIN开发与运行时

仓库 elfgzp/dsh-settings-sync · npm dsh-settings-sync

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

通过你自己的私有 Git 仓库,为 DeepSeek Harness 备份与恢复全部设置——profile 配置、插件设置、技能、已装插件与 MCP 服务器,跨机器一键推送与拉取。

一句话选型结论

按资料字段整理

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

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

安装

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

    兼容的 DSH 版本为 0.2.2-rc.1,Node.js 要求 >=20;版本不匹配时安装会报错。

  2. 2
    执行安装命令

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

  3. 3
    确认已挂载

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

  4. 4
    试跑并检查权限

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

兼容 DSH 版本0.2.2-rc.1版本不匹配时安装会报错
Node.js 要求>=20来自仓库 package.json 的 engines 字段
前置依赖@deepseek-ai/schemastery@^3.18.1需要同时安装的同级依赖
npm 包名dsh-settings-sync可用 npm view 查看包信息

能做什么

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

dsh-settings-sync:用私有 Git 仓库为 DeepSeek Harness 备份全部设置

  • 私有 Git 仓库备份与恢复
  • 覆盖配置、技能与 MCP
  • 敏感凭据自动脱敏
  • 推送前可查看差异
  • 支持自动同步

适用场景

存储GitHub 集成

上游标签

deepseek-harnessdshdsh-plugin

验证等级与安全审查

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

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

逐项检查结果

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 项功能,能直接看出它解决什么问题。

先想清楚的地方

  • 需要同时装好同级依赖,漏装会启动失败。
  • 验证通过不等于安全:插件会读写文件、执行命令或联网,装前先到仓库确认它做了什么。

更适合

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

不太适合

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

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
插件验证等级安全审查星标兼容版本安装命令
dsh-settings-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 有

仓库档案

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

README 全文

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

设置同步(dsh-settings-sync)

把 DeepSeek Harness 的全部设置通过一个你自己的私有 Git 仓库做备份与恢复——profile 配置、各插件设置、skills、已安装插件、MCP 服务。一台机器推送,另一台机器恢复;覆盖之前一定先留恢复点。

English


为什么需要它

DSH 的配置散在几个地方,任何一处丢了都很麻烦:

内容 位置
插件清单与 profile 的 bundle 列表 ~/.dsh/profiles//package.json
各插件配置(模型、MCP、面板设置) ~/.dsh/profiles//cordis.patch.yml
Skills ~/.dsh/skills/、~/.agents/skills/
插件自身状态(标星、默认项目、任务) ~/.dsh/<插件>/

dsh export 能导出一份,但之后还得自己搬。这个插件把它变成持续动作:一个私有仓库、两个方向各一个按钮、推之前能先看清楚差异。

同步什么

manifest.json                 这份快照由什么生成、什么时候
profile/package.json          插件清单与 bundle 列表
profile/cordis.patch.yml      所有插件的配置
profile/cordis.yml            profile 的根入口列表
profile/pnpm-workspace.yaml   工作区与发布年龄设置
homes/dsh/<插件>/*.json       插件自身状态(标星、默认值、任务)
homes/dsh/skills/<名字>/…     $DSH_HOME 下的用户级 skills
homes/agents/skills/<名字>/…  $DSH_AGENTS_HOME 下的共享 skills

明确不同步的:

  • 凭据。 ~/.dsh/.credentials.yaml、tencent-intranet-auth.json、.env、
    *.pem、*.token、pairing.json——按文件名和内容双重排除。更进一步,
    即使某个配置文件本身要同步,里面的真实密钥值(例如 cordis.patch.yml 里的
    apiKey:)也会在上传前被替换成 ``。配置的结构
    保留下来,所以恢复后你仍然知道那里该有一把钥匙,只是需要重新填。

抹除是单向的:恢复时绝不会把占位符写到本机已有的真实值上。恢复逻辑按 key 名
匹配凭据行,保留本机自己的密钥——所以在快照来源的那台机器上恢复,API key 依然可用。
只有本机还没有值的机器才会拿到占位符,而那正是它该说的话:「这里欠一个 key」。
- 依赖与缓存。 node_modules、pnpm-lock.yaml、__pycache__、
.plugin-manager 日志、附件二进制。
- 会话与历史。 ~/.dsh/sessions、~/.dsh/storages——历史不是设置,而且它是
DSH home 里体积最大的东西。
- 旧版本备份。 profile 里任何 .bak 文件。

实测一台机器——21 个已装插件、66 个 skills、6 个插件状态目录——收集出来是
263 个文件、1.4 MB。

安装

git clone https://github.com/elfgzp/dsh-settings-sync.git ~/Work/Github/dsh-settings-sync

然后在 DSH 里走 设置 → 插件 → 安装,或在终端里:

dsh plugin install ~/Work/Github/dsh-settings-sync

插件会在 设置 里加一个「设置同步」页,并在首次启动时问一个问题:从远端恢复,还是把当前设置推上去。

依赖:PATH 里的 git(也可以在插件配置里填绝对路径);只有想用「一键建私有仓库」时才需要
GitHub CLI 并执行过 gh auth login。

使用

  1. 填仓库。 粘贴一个空的私有仓库地址
    (git@github.com:you/dsh-settings.git 和
    https://github.com/you/dsh-settings.git 都行),或者点「创建私有仓库」让 gh 帮你建。
  2. 推送,把这台机器的设置上传。
  3. 另一台机器装上插件、填同一个地址、恢复。

差异面板会先告诉你这次推送会改什么——+新增、~修改、-删除——再动手。

自动同步

设置 含义
推送前抹除密钥 上传前把真实密钥替换成占位符。默认开启。
自动推送 按检查间隔在设置变化后自动推送。
远端策略 never 忽略远端;ask 每次给选择(默认);always 远端更新且本地干净时直接恢复。
检查间隔 关闭 / 5 分钟 / 30 分钟 / 1 小时。

安全模型

  • 没有恢复点就绝不覆盖。 恢复会把当前状态完整复制到
    /backups/<时间戳>-snapshot/,并在完成后报告路径。设置页里能列出所有恢复点,
    一键回滚。
  • 一个文件都没收集到的推送会被拒绝。 HOME 解析错误看起来就像「用户把设置全删了」,
    而用一个空快照替换掉好备份是不可逆的。同一道闸也会拒绝一次性删掉大部分文件的推送,
    除非你显式强制。
  • 快照就是一个真正的 Git 仓库,在 /mirror。历史本身就是备份:
    在里面 git log 能看到每一次同步,git show :profile/cordis.patch.yml
    能取出任意一个历史版本。这也是为什么这个插件不需要自己发明一套撤销格式。

默认全部落在 $DSH_HOME/settings-sync:

config.json   仓库、分支、策略、提交身份
mirror/       本地克隆,它的历史就是快照历史
backups/      恢复点
last-run.json 最近一次推送或恢复的结果

开发

pnpm test    # 或:node --test test/*.test.js
pnpm check   # 对每个模块跑 node --check

测试用真实的 git 二进制和一个临时 home 目录跑真实代码路径:伪造的 profile、两个 skill 根、
一个插件状态目录、一份绝不能被同步的凭据,以及一个裸仓库充当远端。没有任何一处 mock 掉 git——
因为 git 恰好是最容易出错的部分。

设计说明

镜像是一个克隆,不是一个数据库。 把快照保持成普通仓库,意味着整套撤销机制就是
「checkout 一个更早的提交」,差异就是 git status,用户随时能在终端里自己查看或修复,
不需要这个插件帮忙。

推送与恢复是串行的。 一次只跑一个操作、一个忙碌标志。第二次点击会排队而不是交错执行,
定时器在恢复中途触发也会被跳过。

认证用的是你自己的那套。 插件不存任何令牌:它跑的就是你跑的 git,所以 osxkeychain、
SSH agent、credential.helper 原样生效。推论也如实相告——如果终端里 git push 推不上去,
这里也推不上去,而且报错会直接这么说。

浏览器半边不持有要紧状态。 它只负责渲染和调用;文件系统、仓库、恢复点都在 Host 侧。

目录

路径 作用
index.js Host 入口:路由、自动同步定时器
lib/config.js 路径解析与部署配置
lib/state.js 用户配置与最近一次运行状态
lib/paths.js 什么算设置;密钥与缓存排除规则
lib/snapshot.js 收集、落盘、差异、恢复、恢复点
lib/git.js 唯一执行 git 的地方
lib/engine.js 串行同步引擎:推送、恢复、预览、回滚
client.js 设置页与首次启动对话框

许可

MIT

常见问题

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

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

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

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

dsh-settings-sync 安全吗?

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

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

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

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

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

dsh-settings-sync 需要什么运行环境?

Node.js >=20;需要同时安装 @deepseek-ai/schemastery@^3.18.1。环境不满足时安装会失败,建议先确认本机版本。

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

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

dsh-settings-sync 有哪些功能?

私有 Git 仓库备份与恢复、覆盖配置、技能与 MCP、敏感凭据自动脱敏、推送前可查看差异、支持自动同步。

这条记录的数据可靠吗?

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

同名或近似条目

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

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 星

elfgzp 的其它插件

6 个

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