环境预设的核心价值是简化分发
Preset（环境预设）是一套可分享的插件与配置组合。安装一个 Preset，得到一个可运行的 DSH Profile。CLI 的 profile 命令、--profile 参数和 .dshprofile 文件名保持不变。
作者把 Runtime、插件顺序和配置一起发布。接收者可以通过固定版本链接查看内容，并决定何时采用下一版。
Plugin 分发单项能力，环境预设分发的是作者已经精心调好并验证过的完整体验。作者只需要承担一次 runtime 选择、Plugin 组合、加载顺序和配置调试的复杂度；接收者不必理解依赖解析、Cordis patch 或内部加载机制。
完成基础 DSH 和 CLI 准备后，产品、运营、研究等非技术协作者也可以通过一个明确版本和一条命令，使用与你相同的 Agent Harness。环境预设的关键差异化正是把专家能力转化为低门槛分发。
一个 Release 锁定什么
为了让分发结果可信，通过 Builder 发布的 Release 会记录精确的 DSH runtime、作者确认的 bundle 顺序、npm 精确版本或 GitHub commit、Cordis patch、本地输入契约、验证证据和内容哈希。相同版本发布后保持不可变。
输入声明保存环境变量名称、用途和必需/敏感标记，值由使用者在本地提供。配置中的敏感信息仍需作者检查。content hash 标识整份 Release；当前不保证所有传递依赖的字节级一致。
{
"schemaVersion": 1,
"version": "1.0.0",
"name": "Web Workspace",
"runtime": { "version": "0.1.1-rc.2" },
"bundles": [
{ "packageName": "@deepseek-ai/dsh-base", "version": "0.1.1-rc.2", "sourceKind": "builtin" },
{ "packageName": "dsh-better-sidebar", "version": "0.15.0", "sourceKind": "npm" }
],
"inputs": [{ "key": "DEEPSEEK_API_KEY", "label": "DeepSeek API key", "required": true, "secret": true }],
"contentHash": "sha256:ac88d34a1e82dfc01e6908edb157caee27f4b21e349dc922d9babd864dc043dd",
"publishedAt": "2026-08-22T00:00:00.000Z"
}查找并检查环境预设
作者可以直接分享 Hub 上的环境预设链接和 Release 版本。接收者也可以在 /profiles 浏览公开环境预设，或通过 CLI 按用途搜索。详情页会显示 runtime、bundle 顺序、精确插件版本、GitHub commit、patch 数量和本地输入要求。
应用前先确认环境预设的作者、版本、组成和所需输入。需要稳定复现时，应明确指定 Release 版本，而不是依赖 latest。
dsh-hub profile search web
# 公开参考环境预设
# https://dshpluginhub.ai/profiles/dsh-web-workspace?version=0.1.0先预览，再精确应用
接收者不需要逐个安装和配置 Plugin。dry-run 会解析完整 Release 并打印计划执行的命令和 lockfile，但不会改变当前 Profile；确认结果后，一条 apply 命令即可应用同一个精确版本。
CLI 会在独立 staging Profile 中安装和验证，保存当前 revision，然后再切换目标 Profile。缺少必需输入或验证失败时，现有环境保持不变。
dsh-hub profile apply dsh-web-workspace --version 0.1.0 --profile hub-workspace --dry-run
dsh-hub profile apply dsh-web-workspace --version 0.1.0 --profile hub-workspace分享你已经验证过的环境
如果你已经打磨好一个可工作的 DSH Profile，可以通过 CLI 将它捕获并发布，把本地成果交付给其他人。CLI 会保留 package.json 中的 bundle 顺序，读取已安装的精确版本，并检查可变 GitHub 引用、本地路径和疑似凭据。
也可以登录 Dashboard，在 /dashboard/profiles/new 使用 Web Builder 搜索 Hub 已收录的 Plugin、调整顺序、声明 runtime 和本地输入，然后发布同一种环境预设 Release。
dsh-hub login
dsh-hub profile share my-team-stack --version 1.0.0 --profile web --display-name "My Team Stack"History、rollback 和便携文件
建议先使用新 Profile 名称。对于已由 Hub 管理的 Profile，history 可查看保存的历史，rollback 可恢复指定版本的目录。覆盖其他已有环境前请自行备份，本地定制不会自动合并。
.dshprofile 是便携的 Release 文件。导入时 CLI 会验证 release.json 的 schema 和 content hash，再按相同的 staging、验证和切换流程安装。
dsh-hub profile history --profile hub-workspace
dsh-hub profile rollback <revision> --profile hub-workspace
dsh-hub profile import team-stack.dshprofile --profile hub-workspace --dry-run什么时候应该使用环境预设
只需要增加一项独立能力时，安装单个 Plugin 最直接。需要把精心调好的完整 Agent Harness 交付给同事、客户或社区用户时，应发布环境预设。
典型场景包括让非技术团队成员使用内部 Agent、分发客户解决方案、统一团队环境、分享经过验证的 Agent 工具栈、教学或演示，以及新设备初始化。环境预设负责分发组合与顺序；外部服务状态、账号权限和 secret 仍由每台机器在本地提供。