☰
如何在 macOS 一键安装 dsh-purge 破甲插件:dry-run 安全校验与 curl 实战完整教程
2026/10/23 4:33:48 网站建设 项目流程

【免费下载链接】dsh-purge

让 AI 更专注地辅助学习与动手实验 —— DeepSeek Harness 附加组件(状态自检 / 提示词管理 / 本机备份与回滚)

项目地址:https://gitcode.com/gh_mirrors/dsh/dsh-purge
点击查看免费下载

dsh-purge(Purge Community)是一款为 DeepSeek Harness 打造的 macOS「破甲」插件:80 条宿主补丁、25 层状态自检、提示词与规则集中管理、本机备份与回滚,且全部逻辑都在你自己的机器上运行。本文带你用 curl 下载官方安装脚本,先跑--dry-run完成安全校验,再一键完成安装——只需 3 条命令。

当前版本1.6.41,已验证适配 DSH Desktop 0.2.1-rc.1 / rc.2。

安装前:确认这 3 个条件 ✅

条件说明
已安装 DSH Desktop默认路径/Applications/DeepSeek Harness.app;不在默认路径时用DSH_APP显式指定
已打开过 DSH 一次用于初始化 profile(数据目录默认~/.dsh)
无需管理员权限 / 全局 Node安装器直接使用应用自带的 Electron 运行时,不装任何全局依赖

安装器的默认路径与安装模式选择逻辑在 scripts/install.sh#L20-L24 中:检测到 macOS(Darwin)后自动进入desktop模式。完整前置说明见 docs/INSTALLATION.md。

第 1 步:用 curl 下载官方安装脚本

打开「终端」,执行下面这 3 条命令:

curl -fsSL https://raw.githubusercontent.com/kingcharleslzy-ai/dsh-purge/master/scripts/install.sh -o /tmp/purge-install.sh sh /tmp/purge-install.sh --dry-run # 先校验来源与 SHA256 sh /tmp/purge-install.sh # 确认无误再执行

🔍curl 参数逐字拆解(新手最常问的就是这几个单字母):

参数含义
-f服务器返回错误时静默失败,避免把 HTML 错误页当脚本保存
-s安静模式,不显示进度条
-S配合-s在出错时仍然显示错误信息
-L自动跟随重定向
-o把内容写入/tmp/purge-install.sh而不是打印到终端

下载到的入口脚本只做两件事:确认运行时、然后让 scripts/bootstrap-install.mjs 在应用自带的 Electron 运行时里执行(ELECTRON_RUN_AS_NODE=1),所以不需要你本机安装 Node。

第 2 步:dry-run 安全校验(强烈建议先跑)

--dry-run是整个安装流程里最值得养成的习惯。它会走完全部下载与校验流程,但不写入任何东西:

  1. 从官方 Release 解析最新稳定版版本号(预发布版会被拒绝);
  2. 下载版本包dsh-purge-community-x.y.z.tgz与SHA256SUMS.txt;
  3. 逐字节计算 SHA256 并与清单比对(校验逻辑见 scripts/bootstrap-install.mjs#L166-L170);
  4. 一切通过后打印:SHA256 verified; dry run, nothing installed.,然后干净退出,见 scripts/bootstrap-install.mjs#L314。

💡 只要看到这一行,就说明来源可信、包完整、你机器的网络环境可用,可以放心进入正式安装。

下载通道还有几道"隐形护栏":只信任官方 GitHub Release 域名、限制文件体积、禁止不安全 TLS,且不会自动跟随任意跳转。

第 3 步:正式安装(去掉 --dry-run)

校验无误后,去掉--dry-run重新执行同一脚本即可。正式安装会额外做:

  • 身份核对:解包后校验包名、版本、仓库身份三者一致,不一致立即停止;
  • 自动快照:迁移前先备份,失败可回滚;
  • 保留你的配置:不重写现有提示词、规则和其他插件。

⚠️ 注意安装器的边界:它不会自动应用宿主补丁,也不会重启 DSH。完整流程是三步分开的:

安装(本文命令) → 在面板里「应用」 → 你手动退出重开 DSH

任何一步失败都会保留原入口、日志与快照,可以直接原样重试,不会留下半安装状态。

安装后验证:面板 + selfcheck 状态自检 🚀

打开 DSH,左侧栏会出现整页的dsh-purge面板,顶部一句话说明当前状态,主操作按钮是「应用」:

面板里补丁、提示词、代码、引擎、工具的加载计数与备份状态一目了然。也可以在终端用命令逐层确认:

命令作用
purge-community selfcheck [--json]25 层状态自检,逐层给出结论与证据
purge-community status查看宿主路径与计数
purge-community host-status只读查看安装布局与当前入口(不换包、不重启)
purge-community audit --limit 20查看最近动作记录

自检与回滚的实现分别在 lib/selfcheck.js、lib/rollback-transaction.js,想看哪一层"为什么 ok"可以直接翻源码。

装完之后:在面板里管理提示词、规则与服务器

安装完成不等于只用完。左侧栏面板把最常改的东西集中管理,改坏了也能一键恢复:

  • 提示词与自己的服务器:在这里编辑要注入的提示词,并维护"自己的服务器"名单(每行一个 IP 或完整主机名,不要写密码):

  • 规则集:按 id 管理 AGENTS.md 规则,支持启用、新建与删除:

  • 备份与回滚:purge-community backup显式打快照,purge-community rollback <id>验证快照后回滚插件代码与入口,同时保留你的用户内容。

下载报 fetch failed?认识安装器的 curl 备用通道

从 1.6.39 起,如果内置fetch下载失败,安装器会打印一行脱敏诊断信息,例如:

[download] stage=archive host=github.com transport=fetch attempt=1/3 code=…

随后最多重试两次 fetch,再自动切换系统 curl 备用通道(实现见 scripts/bootstrap-install.mjs#L39-L89)。注意:换通道只是换传输方式,来源、证书与 SHA256 校验一条都不放宽,也不会自动修改你的代理设置或重启 DSH。

遇到持续失败时:重新下载安装脚本再跑一次--dry-run,仍不行就保留失败阶段与错误码,参考排查文档 docs/maintenance-issue-52.md 提交脱敏诊断即可。

常用参数与环境变量速查 ⚙️

参数 / 变量作用适用场景
--dry-run只校验来源与 SHA256,不安装安装前体检(默认推荐)
--version=1.6.41固定安装指定版本不想自动取最新版时
--profile=desktop指定 profile 名多实例、非默认 profile
DSH_APP指向 DeepSeek Harness.app应用不在默认路径
DSH_HOME指定数据目录(默认~/.dsh)自定义数据位置
PURGE_DOWNLOAD_TIMEOUT_MS下载超时预算(30000–900000)慢网络环境

常见问题速查 ❓

  • "Profile is not initialized"→ 先手动打开一次 DSH,让 profile 完成初始化再装。
  • "Runtime not found"→ DSH 不在默认路径,设置DSH_APP指向实际的.app。
  • 安装后没变化?→ 记得三步分开:安装 ≠ 应用 ≠ 重启,去面板点「应用」,再手动退出重开 DSH。
  • 装坏了怎么办?→purge-community rollback <id>回滚;详细恢复流程见 docs/MAINTENANCE.md,不要直接覆盖Resources/app。

相关文档

  • 安装、升级与故障排查:docs/INSTALLATION.md
  • 安装入口脚本:scripts/install.sh
  • 下载与校验核心逻辑:scripts/bootstrap-install.mjs
  • 下载失败诊断:docs/maintenance-issue-52.md
  • 日常维护:docs/MAINTENANCE.md

📌 适用范围提醒:dsh-purge 面向本机学习、个人项目与自动化实验,请在你拥有或已获授权的环境中使用。

【免费下载链接】dsh-purge

让 AI 更专注地辅助学习与动手实验 —— DeepSeek Harness 附加组件(状态自检 / 提示词管理 / 本机备份与回滚)

项目地址:https://gitcode.com/gh_mirrors/dsh/dsh-purge
点击查看免费下载
上一篇:AzurLaneAutoScript:碧蓝航线终极自动化脚本完整指南
下一篇:DLSS Swapper:游戏DLSS文件智能管理解决方案

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询