dsh-quick-backup 怎么安装？

在已安装 dsh CLI 引擎的环境中，进入插件页复制安装命令一键执行即可；尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-quick-backup 兼容性怎么样？

尚未跑自动兼容性验证，可查看页面内的依赖与入口分析。

dsh-quick-backup 有中文文档吗？

已提供中文翻译 README（由 DeepSeek 最新模型翻译生成），本站可切换中英文对照阅读。

dsh-quick-backup 还在维护吗？

GitHub 0 星。最近一次上游提交在 2026/10/25。

本地快备 SShiRkiT/dsh-quick-backup

DeepSeek Harness

SShiRkiT9 天前有提交已提供中文文档扫描：含敏感能力

在 GitHub 查看 ↗

一键把 DSH 配置增量备份到本地 Git 仓库

29.8/100

综合分

GitHub 星标

—

npm 周下载

—/5

用户评分

数据截至 2026/10/27 · 周下载取自 npm 全网（含 CI / 镜像），非本站安装数；综合分由星标、活跃度与兼容性检查合成。

安装命令 · 需先装 dsh CLI 引擎

dsh plugin --profile web add SShiRkiT/dsh-quick-backup

该包不可直接 npm 安装，改从 GitHub 源安装（明细见下方安装检查）

状态速览

判定依据：实装验证 · 静态安装检查 · 自动扫描 · 仓库维护状态

信任档位：仅索引

是什么

dsh 原生插件 · tool

装得上吗

本站尚未做安装检查

安全吗

本站尚未对该插件做风险分级

暂未覆盖，不等同于无风险

还在维护吗

活跃：最近一次提交在 9 天前

档位由哪些信号合成

本站实装验证（真实安装 L4 覆盖全站；L5 为运行时冒烟或实机截图，覆盖范围小于 L4） · 验证所用 dsh 版本 · 静态安装检查 · 风险分级 · 仓库维护状态。下方各区块是它的证据明细。

验证判据与等级说明 →

社区实装还没有人打卡 · 装过的第一个就是你

安全扫描自动 · 静态分析源码

v2.7.0

🔵 扫描：含敏感能力尚无人工评估

展开查看扫描说明与证据 ↓

静态扫描发现插件具备触达本地系统的能力：执行外部命令、读写/删除本地文件、读取剪贴板或密钥类环境变量（至少其一）。这是能力清单，不是危险判定——具体能力项与证据见下方，安装前请自行判断是否需要。

可执行外部命令读写/删除本地文件写入剪贴板(不计风险)发起外部网络请求

查看扫描证据（共 12 处，展示前 12 条）

读取本地文件
lib/index.js:11
const readText = (path) => { try { return readFileSync(path, 'utf8').replace(/^ FEFF/, '').trim() } catch { return '' } }
读取本地文件
lib/index.js:12
const readJson = (path) => { try { return JSON.parse(readFileSync(path, 'utf8').replace(/^ FEFF/, '')) } catch { return null } }
写入本地文件
lib/index.js:24
mkdirSync(configDir, { recursive: true })
写入本地文件
lib/index.js:25
writeFileSync(configPath, JSON.stringify(config, null, 2), 'utf8')
读取本地文件
lib/index.js:57
return !!paths.repo && existsSync(join(paths.scripts, 'backup.ps1'))
读取本地文件
lib/index.js:77
if (!existsSync(scriptPath)) return done({ code: 1, output: `找不到备份脚本：${scriptPath}` })
执行外部命令固定命令
lib/index.js:79
const child = spawn('powershell.exe', ['-NoProfile', '-NonInteractive', '-ExecutionPolicy', 'Bypass', '-EncodedCommand', Buffer.from(program, 'utf16le
读取本地文件
lib/index.js:103
while (!existsSync(parent)) {
读取本地文件
lib/index.js:121
if (existsSync(value)) throw new Error('导出目录已存在，请选择一个全新的目录。')
写入本地文件
lib/index.js:235
writeFileSync(backupConfigPath, JSON.stringify(backupConfig, null, 2), 'utf8')
发起网络请求
lib/client.js:30
try { const response = await fetch(path, init); return await response.json() }
写入剪贴板
lib/client.js:121
try { await navigator.clipboard.writeText(result.command) } catch { }

扫描于 2026/11/4（0 天前） · 范围入口闭包 + 发布文件清单 · 来源 GitHub 仓库

静态扫描只反映源码中出现的调用，不构成安全背书；人工评估与自动扫描相互独立、互不覆盖。

依赖的 DSH / Cordis 模块

@deepseek-ai/dsh

给这个插件打分还没有人投票↓

用户评分

还没有人投票，来当第一个

广告精选好物

飞利浦 TAH6519 主动降噪耳机 ¥299

头戴式无线 anc 主动降噪，蓝牙连接，久戴舒适向。

·anc 主动降噪 · 头戴式无线
·价格与库存以商品页实时为准

去淘宝看看→

广告MCP 兼容手册

装完插件，给 AI 接上 MCP

Cursor、Claude Code、VS Code 逐个核对：能不能装、配置怎么写、装不上是什么原因。

·按客户端逐格核对
·结论标注依据与风险等级

查 MCP 兼容性→

DeepSeek Harness 的本地备份控制与工作流

README

由 DeepSeek 最新模型翻译生成

简体中文 · dsh-quick-backup 本地 Git 增量备份工具，面向 DeepSeek Harness（DSH）用户环境，提供设置 → 备份面板。本 GitHub 仓库只包含插件和工作流脚本。你的 DSH profile、会话、凭据、API Key 和备份数据永远不会进入这个仓库。备份保存在 setup.ps1 创建的独立本地仓库中。你将获得 - 在 DSH 设置 → 备份中一键备份 - 本地 Git 历史，日期版本号：vYYMMDD.E.SSS - DSH 启动时自动备份（可选 watcher） - 查看版本、导出、复制安全的恢复命令 - 缓存感知：单纯重启 DSH 不会产生无意义的版本 - 不联网、没有远程仓库、不上云 ⚠️ 数据与密钥风险（务必阅读） [!WARNING] 如果开启“备份凭据与 APIKey”，数据仓库会把 .credentials.yaml 和 APIKey 以明文保存在本地，而且 Git 历史永不遗忘。默认不备份这两项。若你主动开启，并把备份文件夹进行云同步、网盘同步、网络驱动器同步，或者转发给他人，由此导致的凭据或隐私泄露由你自行承担，作者不承担任何责任。注意！v0.1 默认为开启保存密钥设置。使用 v0.1 时请特别小心；建议升级到 v0.2 或更高版本。

展开完整文档（README 剩余 1 节）

简体中文 ·

dsh-quick-backup

本地 Git 增量备份工具，面向 DeepSeek Harness（DSH） 用户环境，提供 设置 → 备份 面板。

本 GitHub 仓库只包含插件和工作流脚本。
你的 DSH profile、会话、凭据、API Key 和备份数据永远不会进入这个仓库。
备份保存在 setup.ps1 创建的独立本地仓库中。

你将获得

- 在 DSH 设置 → 备份 中一键备份
- 本地 Git 历史，日期版本号：vYYMMDD.E.SSS
- DSH 启动时自动备份（可选 watcher）
- 查看版本、导出、复制安全的恢复命令
- 缓存感知：单纯重启 DSH 不会产生无意义的版本
- 不联网、没有远程仓库、不上云

⚠️ 数据与密钥风险（务必阅读）

[!WARNING]
如果开启“备份凭据与 APIKey”，数据仓库会把 .credentials.yaml 和 APIKey 以明文保存在本地，而且 Git 历史永不遗忘。

默认不备份这两项。若你主动开启，并把备份文件夹进行云同步、网盘同步、网络驱动器同步，或者转发给他人，由此导致的凭据或隐私泄露由你自行承担，作者不承担任何责任。

注意！v0.1 默认为开启保存密钥设置。 使用 v0.1 时请特别小心；建议升级到 v0.2 或更高版本。

环境要求

- Windows 10/11
- PowerShell 5.1（系统自带）
- Git for Windows（脚本优先使用 C:\Program Files\Git\cmd\git.exe）
- DSH desktop >= 0.2.1-rc.2

快速开始

1. 获取文件

git clone https://github.com/SShiRkiT/dsh-quick-backup.git
cd dsh-quick-backup

2. 创建本地备份仓库

备份路径默认是空的。 必须显式传入 -RepoPath：

powershell -ExecutionPolicy Bypass -File .\setup.ps1 -RepoPath "D:\DSH-Backups" -EnableAutostart

setup.ps1 会：

- 检测/使用你的 .dsh profile（默认 %USERPROFILE%\.dsh）
- 在你指定的路径创建备份仓库
- 复制工作流脚本并写入 backup.config.json
- 初始化本地 Git，并创建第一个基线版本
- 注册插件发现配置
- 可选安装登录 watcher（-EnableAutostart）

常用参数：

自定义 profile / 安装目录 .\setup.ps1 -RepoPath "D:\DSH-Backups" -DshProfile "$env:USERPROFILE\.dsh"

DSH 安装在自定义目录 .\setup.ps1 -RepoPath "D:\DSH-Backups" -InstallRoot "D:\DSH\Desktop"

只复制脚本和配置，暂不复制 profile .\setup.ps1 -RepoPath "D:\DSH-Backups" -SkipInitial

如需备份 .credentials.yaml 与 APIKey（默认不备份） .\setup.ps1 -RepoPath "D:\DSH-Backups" -IncludeCredentials

3. 安装插件

打开 DSH 桌面端的 设置 → 插件，选择从仓库安装，填写：

https://github.com/SShiRkiT/dsh-quick-backup

然后重启 DSH，应该能看到 设置 → 备份。

私有仓库需要先完成 GitHub 登录；公开后不需要。
开发调试时也可以让 DSH 指向你本地的仓库目录。

4. 使用

打开 设置 → 备份。如果 setup 没有配置过备份路径，在 备份仓库路径 输入框中填写路径，然后点 保存路径。

| 控件 | 作用 |
| 备份仓库路径 | 设置或修改本地数据仓库路径 |
| 备份凭据与 APIKey | 默认关闭；开启后备份 .credentials.yaml 和 APIKey |
| 备份 | 增量备份（遵守 60 秒最小间隔） |
| 忽略间隔备份 | 立即强制备份 |
| 校验 / 深度校验 | 校验仓库与 Git 对象 |
| 历史版本 | 选择版本 |
| 复制恢复命令 | 复制安全的恢复命令 |
| 导出 | 将选定版本导出到新目录 |
| 启用 / 停用 | 安装/移除登录 watcher |
| 运行诊断 | 执行一次不备份的 watcher 检查 |

备份仓库路径

- 插件默认路径为空；不会擅自假设某个目录。
- setup.ps1 会把选定路径写入 %LOCALAPPDATA%\dsh-quick-backup\config.json。
- 插件也支持环境变量 DSH_BACKUP_REPO（优先级最高）和同一个配置文件。
- 路径必须是本地绝对路径，例如 D:\DSH-Backups。
- 该目录必须是由 setup.ps1 创建的数据仓库（包含 scripts\backup.ps1）。如果还没初始化，面板会显示“未就绪”并提示先运行 setup。
- 在插件中修改路径会立即生效，不需要重启 DSH。

凭据备份开关

- 默认关闭：不备份 .credentials.yaml 与 APIKey。
- 可在 设置 → 备份 → 备份凭据与 APIKey 开启，或在 setup 时使用 -IncludeCredentials。
- 开启后，后续版本会包含这两项；关闭只会排除后续版本，旧 Git 历史不会自动清理。如果之前备份过凭据，需要重建数据仓库或清理 Git 历史，才能真正移除旧副本。

版本规则

格式：vYYMMDD.E.SSS

| 段 | 含义 |
| YYMMDD | 当前大环境基线建立日期 |
| E | 该日期内第几次大环境变动（1、2……；跨天重置为 1） |
| SSS | 该基线内第几次小变动（001……；大环境变动时重置） |

以下情况进位：

- 大版本 / 环境变动：DSH 升级、插件安装/更新/移除、dsh-ops 或运行时更新
- 小版本：会话、附件、设置、凭据、工作区状态、脚本/文档更新

示例：

v261025.1.001 基线 v261025.1.002 新对话 v261025.2.001 同一天更新插件 v261026.1.001 次日升级 DSH

详细规则见 docs/VERSIONING.md。

仓库结构

dsh-quick-backup/ # 本仓库（不含个人数据） ├─ package.json # DSH 插件包根配置 ├─ lib/ # 插件 host + client ├─ cordis.patch.yml ├─ scripts/ # 会复制到数据仓库的工作流脚本 ├─ setup.ps1 # 创建本地数据仓库 ├─ docs/ └─ test/ # 插件自测

<你选择的路径>/ # 数据仓库（仅本地，绝不提交到这里） ├─ .git/ # 备份历史 ├─ mirror/ # 当前 DSH 状态镜像 ├─ state/ # 日志、每版本元数据（gitignored） ├─ backup.config.json # 本地配置（gitignored） ├─ version.txt ├─ VERSIONS.md └─ scripts/

数据仓库是一个独立的 Git 仓库。本项目的 .gitignore 不会跟踪任何备份数据。

命令行

以下命令都在数据仓库中运行：

$B = "D:\DSH-Backups"

立即备份 powershell -ExecutionPolicy Bypass -File "$B\scripts\backup.ps1" -Trigger manual

查看版本 powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" -List

回档（会关闭 DSH！）
powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" v261025.1.002 -Force

只导出 powershell -ExecutionPolicy Bypass -File "$B\scripts\restore-version.ps1" v261025.1.002 -ExtractTo "D:\DSH-restore-261025-1-002"

校验 powershell -ExecutionPolicy Bypass -File "$B\scripts\verify.ps1" -Deep

缓存文件不备份

以下内容会被有意排除，避免单纯重启就产生新版本：

- .dsh\cache、.dsh\logs
- storages\session_projcache
- storages\cost-meter\（包括 ledger.json；成本历史不备份）
- studymate\reach\
- Electron 的 Cache、Code Cache、GPU、logs、Local Storage、Session Storage、Network、Shared Dictionary、blob_storage、WebStorage、Preferences、LOG、lockfile、Cookies、DIPS*
- profiles\node_modules（失效 junction）
- DSH 程序本体

会话正文（sessions、attachments）和设置会被备份。

回档安全

- 回档脚本会关闭 DSH（当前会话会结束）。
- 当前 profile 会被改名为 .dsh.pre-restore-<时间戳>，而不是直接删除。
- 设置页不会直接执行回档；插件只复制一条命令，由你在独立 PowerShell 窗口中运行。
- 回档前请先确认选定版本的 DSH 程序版本与当前一致（仓库中保存了 install-info.txt）。
- 回档完成后，下一次备份会把回档后的状态记录为新版本。

隐私与安全

- 备份数据仓库仅在本地；push.default=nothing 和 pre-push 钩子会阻止误推送。
- 数据仓库包含你的会话、附件、设置等隐私内容；若开启凭据备份，还会包含明文凭据（.credentials.yaml、APIKey），请按敏感数据保管。
- 本 GitHub 仓库不包含任何凭据、会话、profile 副本或备份数据。
- 不要把数据仓库上传到 GitHub 或云盘。

详见 docs/SECURITY.md。

卸载

移除 setup 安装的登录 watcher powershell -ExecutionPolicy Bypass -File "D:\DSH-Backups\scripts\uninstall-autostart.ps1"

移除插件
dsh plugin --profile desktop remove dsh-quick-backup

只有当你不再需要历史时才删除数据仓库。

故障排查

- 设置里没有插件：检查 dsh plugin --profile <name> list，然后重启 DSH。
- 面板显示“未就绪”：路径为空，或该目录不是数据仓库；运行 setup.ps1 -RepoPath <path>，或保存正确的路径。
- 备份失败：查看 state\logs\backup.log、state\last-run.json。
- 正常使用不需要 Git 认证；本工具从不推送。
- 需要对象完整性检查时运行 verify.ps1 -Deep。

开发

PowerShell 语法检查（Windows PowerShell 5.1）powershell powershell -File .\scripts\verify.ps1 # 需要已有数据仓库

插件自测

node .\plugin\verify.mjs

test/verify.mjs 使用临时 fixture，不会接触你的 DSH 数据。

许可证

MIT，见 LICENSE。