dsh-packer

中文文档

dsh-packer is a configuration packer plugin for DeepSeek Harness (DSH). It packs your local Agent assets into zip archives, module by module, for two purposes:

• Migration — move your whole setup to a new machine or after a reinstall.
• Sharing — hand your Skills (and other assets) to other people.

Version v0.1.0 · MIT License

---

Features

Packable modules (all optional)

Module	Contents	Migrate preset	Share preset
skills	Skills (including the memory-mechanism skill), under ~/.dsh/skills	✅	✅
sessions	Session records (.zstd format), under ~/.dsh/sessions	✅	❌
profiles	Profile configs (excluding node_modules), under ~/.dsh/profiles	✅	❌
settings	Global settings (settings.yaml)	✅	❌
presets	Agent presets (.agent-presets)	✅	❌
memory	Memory data (DSH_MEMORY_ROOT or ~/.dsh/memory, excluding backups/)	✅	❌

Two built-in presets

• Migrate — every module checked (the default).
• Share — only skills is checked; sessions and memory data are automatically excluded. Personal skill subdirectories are also excluded when sharing.

Core capabilities

1. Privacy & security scan — before packing, automatically detects local absolute paths, user-profile directory paths, suspected credentials, and personal nicknames. In share mode a hit hard-blocks the pack (returns an error); in migrate mode it is reported only.
2. File-level operation manifest — previews every file before packing; before a restore it produces a diff report (added / changed / same / skipped).
3. Package management — lists generated packages (time / size / modules / note), delete, rename.
4. Restore — import zip → validate manifest.json (schemaVersion + SHA-256 fingerprints) → diff report → pick a conflict strategy: overwrite / skip / merge (merge appends, never overwrites).
5. Share packs ship with a README — a generated README.md explaining the pack contents is attached automatically.
6. Package notes — write a usage note when packing.

---

Installation

Install as a local bundle from the project directory:

dsh plugin add .     # add the local bundle
# or, during development
pnpm link

Then add dsh-packer to the dsh.profile.bundles list of your profile. Restart DSH and open the Settings → "Config Packer" tab (or use the /pack command).

---

Usage

Packing flow

1. Open the Settings → "Config Packer" tab, or run /pack create.
2. Pick the modules — or use a preset (Migrate = everything, Share = Skills only).
3. The privacy scan runs automatically before packing; in share mode it hard-blocks on any hit.
4. Confirm the file list (use --dry-run to preview without generating a zip).
5. The zip is written to the packs directory (default ~/.dsh/packs); share packs get an automatic README.md.

Restore flow

1. Import the zip (pick the file in the Settings tab, or /pack restore <zip>).
2. manifest.json is validated (schemaVersion + SHA-256 fingerprints).
3. Review the diff report: added / changed / same / skipped.
4. Choose a conflict strategy: overwrite / skip / merge (merge appends text content without overwriting).
5. Apply, and restart DSH if needed.

/pack command reference

…