asdf17128/dshp

dshp

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

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
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，你原来能跑的那套一根汗毛都没动。

命令

| | |
|---|---|
| dshp ls | 列出 profile，带 bundle/插件数量和占用空间 |
| dshp show  | 加载顺序、插件、patch |
| dshp new  [--web\|--headless] | 建 profile —— dsh 自己建不了空的 |
| dshp clone   | 连 node_modules 一起复制 |
| dshp export  [-o FILE] | 导出可移植文件（默认输出到 stdout） |
| dshp import  [--as NAME] [--no-install] | 复现一套 profile |
| dshp diff   | 差在哪 |
| dshp rm  --yes | 删除 |

profile 到底是什么

$DSH_HOME/profiles/ 下面：

- 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