KLRSL/dsh-packer

DeepSeek Harness 配置打包器:将您的代理配置(技能/会话/配置文件/设置/记忆)打包为 zip 文件,以便迁移或共享,支持隐私扫描、差异还原和包管理功能。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness (DSH), designed to pack local DSH agent assets into standard zip archives by module for two core use cases: environment migration and asset sharing. It supports flexible selection of six modules including skills, sessions, profiles, settings, presets, and memory, with two built-in presets: migrate mode that selects all modules by default, and share mode that only includes skills for sharing. You can preview the full file list before packing, and get a clear difference report before restoring assets to your local DSH instance.

If you need to move your entire DSH environment to a new machine or restore it after a system reinstall, you can use the migrate mode to pack all your assets, then restore it on the target device to get your full original configuration back. For users who want to share their custom DSH skills with others, the share mode automatically excludes personal content like session history and memory data, only packing the selected skill modules. It also runs a full privacy scan for sensitive content including API keys, local paths, and personal identifiers, blocking pack generation in share mode if any sensitive content is found.

To install dsh-packer, you need to have DSH version 0.1.1-rc.2 or newer and Node.js 22.19.0 or higher installed on your system. The recommended installation method is running the command dsh plugin --profile <your-profile-name> add github:KLRSL/dsh-packer in your terminal, which automatically registers the plugin with your DSH profile. After installation, you can verify it works by opening the "Configuration Packer" tab in DSH settings or running /pack list in the terminal. For your first use, it is recommended to run /pack create --dry-run to preview the scan results and confirm all paths are accessible before you generate an actual zip package. It is released under the open source MIT license.

dsh-packer 是专为 DeepSeek Harness(DSH)开发的原生 Agent 配置打包插件,可将本地 DSH 资产按模块打包成标准 zip 包,用于环境迁移和资产分享两种核心场景。它支持技能、会话、配置、设置、预设、记忆六大模块自由组合打包,内置迁移(全选模块)和分享(仅选技能)两种预设模式,全程提供隐私安全扫描,打包前可预览文件清单,恢复前提供差异对比。

对需要迁移整套 DSH 环境的用户,比如更换设备或重新安装系统后,可以用迁移模式全选所有模块打包,在新环境恢复即可完整还原原有配置。分享场景下,分享模式会自动排除会话、记忆等个人敏感内容,只打包技能模块,全程自动扫描各类敏感信息,分享模式下命中敏感内容直接拦截打包,迁移模式仅做报告不拦截,适配不同安全需求。

本插件要求 DSH 版本不低于 0.1.1-rc.2,Node.js 版本不低于 22.19.0,采用 MIT 开源许可,可通过 dsh plugin 命令直接从 GitHub 安装。安装后可通过设置页的「配置打包」标签页或终端命令 /pack list 验证安装成功,首次使用建议先运行 /pack create --dry-run 预览扫描结果,确认路径读取正常后再正式打包。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 warning1 项注意
  • Only 3 stars - very few users, little community feedback星标只有 3,几乎没人在用,遇到问题缺少社区反馈
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add github:KLRSL/dsh-packer

把 KLRSL/dsh-packer 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dsh-packer

Agent 配置打包器:把本地 DSH 资产按模块打包成标准 zip——迁移、分享、恢复,隐私扫描全程护航。

简体中文 · English

v0.2.7 · MIT License · DSH ≥ 0.1.1-rc.2(预发布版本号不受 semver 范围约束;已适配 0.2.0-rc.2(桌面版))· Node ≥ 22.19.0

dsh-packer 是 DeepSeek Harness(DSH)的「Agent 配置打包器」插件:把本地 Agent 资产按模块打包成标准 zip,用于两种场景:

  • 迁移 —— 换机器或重装后,把整套环境完整搬过去。
  • 分享 —— 把 Skills 等资产交给别人,敏感内容自动拦截。

打包内容可按模块自由组合(Skills / 会话 / Profile / 设置 / 预设 / 记忆),恢复带差异对比与冲突策略,隐私安全扫描全程护航——全部能力按需开启。

功能特性

特性 说明
模块化打包 七个模块任意组合:skills / sessions / profiles / settings / presets / memory(Markdown 镜像)/ memoryDb(记忆真库 SQLite 一致快照,默认带上)
双模式预设 迁移(全选)/ 分享(只勾 Skills,自动排除会话、记忆与个人 skill 子目录)
隐私安全扫描 打包前检测盘符 / Unix / UNC 路径、用户目录路径、疑似密钥赋值、密钥形状(sk-、ghp_、AKIA、JWT 等)、个人昵称;逐行全量计数;分享命中即拦截,迁移仅报告
文件级操作预览 打包前预览完整文件清单;恢复前差异报告(新增 / 变更 / 相同 / 跳过)
恢复冲突三选 覆盖 / 跳过 / 内容合并(合并 = 追加,绝不覆盖已有内容)
恢复安全写入 先备份目标到 packs 目录下的 .restore-backups/<时间戳>/,写临时文件后 rename 原子替换;任一环节失败即中止并回滚已替换/已新增的文件
清单完整性校验 manifest.json 记录 schemaVersion + 每个文件 SHA-256 指纹;恢复前校验源文件与清单一致,缺指纹或指纹格式非法一律拒绝(fail-closed)
包管理与备注 包列表(时间 / 大小 / 模块 / 备注)、删除、重命名、打包时填写备注
分享包自动附 README 自动生成并附带说明包内容的 README.md
深色模式适配 打包工作流面板跟随 DSH 主题(--dsw-alias-* 变量,双通道探测)
零原生依赖 系统 bsdtar(libarchive)生成标准 zip,任何解压工具可打开

安装

从 GitHub 安装(推荐)

# 需要已安装 git;--profile web 换成你的 profile 名
dsh plugin --profile web add github:KLRSL/dsh-packer

本地 bundle(开发 / link)

# 在项目目录下执行
dsh plugin --profile web add link:./dsh-packer

dsh plugin 会自动把安装的包登记到 profile 的 dsh.profile.bundles 并挂载补丁;安装完成后重启 DSH。

安装后验证:

  1. 打开 设置页 →「配置打包」标签页——能看到模块勾选界面与包列表,即安装成功;
  2. 或在终端运行 /pack list——返回包列表(首次使用为空列表或提示暂无包),即命令已注册;
  3. 再跑一次 /pack create --dry-run——不生成真实 zip,仅预览文件清单与扫描结果,确认各模块路径可读。

快速开始

打包(三步)

# 1. 创建迁移包(默认全选模块)
/pack create --note "迁移到新机器"

# 2. 或创建分享包(只含 Skills,自动排除敏感内容)
/pack create --share --note "分享给朋友"

# 3. 先预览再打包(不生成 zip)
/pack create --mode migrate --dry-run

打包完成后,zip 写入 ~/.dsh/packs/(DSH_PACKS_DIR 可覆盖);分享包自动附带 README.md。

恢复(三步)

# 1. 导入包
/pack restore ~/.dsh/packs/dsh-packer-2026-09-05-223045-migrate.zip

# 2. 查看差异报告(新增 / 变更 / 相同 / 跳过)
# 3. 指定冲突策略:overwrite | skip | merge
/pack restore <zip路径> --strategy merge

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev harness-self-evolution-plugin 下一个 Next maa-dsh-skill →