dshp

把你整套 dsh 配置变成一个文件交给别人，对方得到的是一模一样的树。

English | 中文

npx github:asdf17128/dshp ls

一行一个，列出你机器上所有 profile。只读、零依赖。

它能给你什么

看清自己到底有什么。 dshp ls 和 dshp show 回答「装了什么、加载顺序如何、 我改过没有」，不用打开任何一个文件。

折腾前先复制一份。 dshp clone web web-test 一秒内复制一套能跑的配置（连 node_modules 一起）。在副本上折腾，搞砸了 rm 掉就行。

分享一套能精确复现的配置。 dshp export 把 bundle 顺序、插件版本和你的 patch 写进一个短文件，dshp import 重建它——已验证：132 个条目的 profile 复现到全新的 $DSH_HOME，合成出完全一致的树，patch 也在。

dsh 自己能启动 profile、能把安装转发给 pnpm，但它建不了空的、列不出你有哪些、也 克隆不了一套能跑的配置。今天这些全是在 ~/.dsh/profiles 底下手工操作。

分享一套配置

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

短到可以直接贴进帖子里。对方那边：

dshp import my-setup.dshp

它会写好 profile、用 dsh 自己的 pnpm 装插件，然后 dsh --profile web 就能起。这条链路是端到端验证过的：在一个全新的 $DSH_HOME 里复现出 132 个条目、与原版完全一致的启动树，patch 也精确还原。

放心折腾

dshp clone web web-试验田      # 秒完成，node_modules 一起带走
dsh plugin --profile web-试验田 add some-experimental-plugin
dshp diff web web-试验田

web -> web-试验田

plugins
  + some-experimental-plugin@^0.2.0

搞砸了就 dshp rm web-试验田 --yes，你原来能跑的那套一根汗毛都没动。

命令

profile 到底是什么

$DSH_HOME/profiles/<name> 下面：

• package.json —— dependencies 是插件，dsh.profile.bundles 是有序的层栈
• cordis.patch.yml —— 你自己的 id 定向覆盖
• cordis.yml、pnpm-workspace.yaml —— 样板，可重新生成

所以复现一套配置只需要三样东西：插件版本、bundle 顺序、patch。可移植文件装的正是这三样。

bundle 的顺序是格式的一部分：它决定谁 patch 谁，所以只是调换顺序也会被 diff 当成真实差异报出来。

patch 块是逐字节原样搬运、不重新序列化的，因为里面可能有 !!js 表达式（root: !!js dshHomePath('sessions')），YAML 往返会把它弄坏或执行掉。本工具任何时候都不会执行你的配置。

安装与卸载

当 CLI 用：npx dshp ls，不需要安装。

当插件用：

dsh plugin --profile web add github:asdf17128/dshp   # 安装
dsh plugin --profile web remove dshp                 # 卸载

卸载后 list_profiles 和 export_profile 两个工具消失，你的 profile 分毫未动—— 这个插件只读。

兼容性

基于 @deepseek-ai/dsh 0.1.0-rc.5 验证。它读的 profile 结构（package.json 里的 dsh.profile.bundles、cordis.patch.yml）是 dsh 自己的格式，那里一旦变动会最先受影响。

环境要求

Node 18+。import 需要一个可用的 dsh（优先本地 node_modules/.bin/dsh，否则用 PATH 上的），因为它走 dsh 自己的 pnpm 装依赖；其余命令都是纯文件操作。

相关

dsh-doctor —— 检查 profile 里哪些 patch 已经悄悄失效了。

许可

MIT