asdf17128/dshp 预览 preview

asdf17128/dshp

管理DeepSeek Harness配置文件——列出、创建、克隆、对比,并将整个dsh设置作为一个便携式文件分享。

Project Overview项目介绍

dshp is a native command-line interface (CLI) and plugin built exclusively for DeepSeek Harness (DSH) that simplifies profile management and environment sharing. It lets you package your entire DSH setup into a single portable file that can be imported on another machine to reproduce the exact same plugin versions, bundle order, and custom patches. You can run it directly via npx github:asdf17128/dshp ls to list all your existing DSH profiles without installing any dependencies permanently. It fills gaps in core DSH functionality, which currently requires manual management of profiles under ~/.dsh/profiles.

A common workflow for dshp is exporting an existing working profile to share with others, or cloning an existing profile for safe experimentation. To export a profile named web, you run dshp export web -o my-setup.dshp, which outputs a short YAML file that can be pasted into a forum post or issue. On another machine, running dshp import my-setup.dshp will rebuild the entire profile, install all required plugins via DSH's pnpm, and leave it ready to boot with dsh --profile web. If you want to test a new plugin, you can clone your existing profile to a test copy, experiment without risking your working setup, and delete the test profile when done.

dshp requires Node.js 18 or newer to run. The import command needs a working DSH installation available locally either in your PATH or at node_modules/.bin/dsh, since it uses DSH's own package manager to install plugins. All other commands work directly with the local file system and do not require an active DSH instance. You can install dshp as a DSH plugin via dsh plugin --profile web add github:asdf17128/dshp, or uninstall it just as easily. It is verified to work with DSH version 0.1.0-rc.5, and is released under the permissive MIT open source license.

dshp 是专为 DeepSeek Harness (DSH) 设计的原生命令行工具与插件,用于管理 DSH 的配置文件,支持将完整的 DSH 环境导出为单个可移植文件,也支持导入该文件在另一台机器上重建完全一致的工作环境。它还可以列出本机所有已有配置,查看配置中 bundles、插件和补丁的详细信息,还能克隆现有环境供安全实验。

dshp 的核心使用场景是分享可复现的 DSH 环境配置,以及在不破坏原有工作配置的前提下测试实验性改动。用户可以将已有配置克隆为新配置,在克隆版本上测试新增插件,对比原配置和测试配置的差异,如果测试出问题可以直接删除测试配置,完全不会影响原有的工作环境。它弥补了原生 DSH 不能创建空配置、无法快速列出已有配置信息的不足。

dshp 既可以直接通过 npx 运行,不需要本地提前安装,也可以作为 DSH 插件安装到现有配置中使用。它要求环境安装 Node.js 18 及以上版本,导入命令依赖本地可用的 DSH 安装,其余命令仅操作本地文件系统。当前已验证兼容 DSH 0.1.0-rc.5 版本,项目采用 MIT 许可证开源。

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:asdf17128/dshp

把 asdf17128/dshp 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

dshp

Hand your whole dsh setup to someone as one file — and they get the exact same tree.

English | 中文

npx github:asdf17128/dshp ls

Shows every profile on your machine in one line each. Read-only, zero dependencies.

dshp in use

What it gives you

See what you actually have. dshp ls and dshp show answer "what is installed, in what order, and did I patch it" without opening a single file.

Copy before you break it. dshp clone web web-test duplicates a working setup in under a second, node_modules and all. Experiment on the copy; rm it when done.

Share a setup that reproduces exactly. dshp export writes bundle order, plugin versions and your patch into one short file. dshp import rebuilds it — verified: a 132-entry profile reproduced into a fresh $DSH_HOME composes an identical tree, patch included.

dsh itself can boot a profile and forward installs to pnpm, but it cannot create an empty one, list what you have, or copy a working setup before you experiment on it. That is all manual work under ~/.dsh/profiles today.

Share a setup

dshp export web -o my-setup.dshp
# dsh profile — reproduce with: dshp import <this-file>
dshp: 1
name: web
bundles:
  - @deepseek-ai/dsh-base
  - @deepseek-ai/dsh-web-app
  - dsh-cloudflare-browser-run
plugins:
  dsh-cloudflare-browser-run: "^0.1.1"
patch: |
  - id: session-title
    config:
      fallbackMaxWords: 12

Short enough to paste into a forum post. On the other machine:

dshp import my-setup.dshp

That writes the profile, installs the plugins through dsh's own pnpm, and you boot it with dsh --profile web. Verified end-to-end: a fresh $DSH_HOME reproduced a 132-entry tree identical to the original, patch included.

Experiment safely

dshp clone web web-试验田      # instant, keeps node_modules
dsh plugin --profile web-试验田 add some-experimental-plugin
dshp diff web web-试验田
web -> web-试验田

plugins
  + some-experimental-plugin@^0.2.0

If it goes wrong, dshp rm web-试验田 --yes. Your working profile was never touched.

Commands

dshp ls profiles, with bundle/plugin counts and disk size
dshp show <name> bundles in load order, plugins, patch
dshp new <name> [--web|--headless] create a profile — dsh itself cannot make an empty one
dshp clone <from> <to> copy a working setup, node_modules and all
dshp export <name> [-o FILE] portable file (stdout by default)
dshp import <file> [--as NAME] [--no-install] recreate a profile
dshp diff <a> <b> what differs
dshp rm <name> --yes delete

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

← 上一个 Prev dsh-ui-agents-pixe 下一个 Next dsh-gsd-bundle →