dsh-live-preset-switch

English | 中文

---

English

A standard DSH Bundle that adds one additive Host adapter to a profile. The adapter registers a single bundled Skill, live-preset-switch, through the public ctx.skills.register() service contract. The Skill teaches agents and users how to choose agent presets, and how live turn-boundary preset switching behaves on builds that ship it (see deepseek-harness-live-preset-switch).

What this bundle is

• Additive only. cordis.patch.yml inserts exactly one entry, dsh-live-preset-switch-skill-provider, pointing at this package. It does not disable, replace, reorder, or shadow any official @deepseek-ai/* component.
• Self-contained. No runtime dependencies, no lifecycle scripts (preinstall/install/postinstall/prepare), no native artifacts, no symlinks.
• Read-only at runtime. The adapter performs no file, network, subprocess, or credential access; the Skill body is a static string.

What this bundle is not

• It is not the live-preset-switching engine itself. That feature changes DSH core packages (session history derivation, the agentPreset.select turn-boundary guard, the composer chip) and therefore cannot ship as an additive plugin; it lives in the fork branch for upstream review. This bundle only ships guidance content.
• A Catalog listing for this bundle does not mean the fork's core changes are installed or accepted upstream.

Compatibility declarations

Declared in package.json under dsh.compatibility:

• dsh: >=0.1.0-rc.8 <0.2.0, node: >=22.19.0.
• dshReleases: precise compatible declarations for the current official release window (0.1.5-alpha.2, 0.1.5-rc.1, 0.1.5-rc.2) plus 0.1.2-alpha.4, 0.1.2-alpha.5, 0.1.2-rc.1, 0.1.3-alpha.2, and 0.1.5-alpha.1. The basis is the public SkillRegistration contract, which is unchanged across these releases; this bundle uses no other host surface.
• These are source declarations, not runtime acceptance. Isolated-profile install / start / uninstall / rollback evidence per release is still pending and will be recorded before any claim beyond the declaration tier.

Install

Once listed in DSH STORE at a fixed Commit, install through the marketplace or:

dsh plugin --profile <name> add --ignore-scripts 'git+https://github.com/HaoyanZhang123/dsh-live-preset-switch.git#<commit>'

Expected effect: dsh --profile <name> --dump-config contains exactly one new entry, dsh-live-preset-switch-skill-provider, and the live-preset-switch skill appears in the skill catalog.

License

MIT.

---

中文

一个标准 DSH Bundle：向 Profile 中附加一个 Host 适配器，通过公开的 ctx.skills.register() 服务接口注册唯一的内置 Skill live-preset-switch。 该 Skill 指导 Agent 与用户如何选择 Agent 预设，以及支持该功能的构建上 "回合边界实时切换预设" 的行为方式（见 deepseek-harness-live-preset-switch）。

这个 Bundle 是什么

• 纯增量。cordis.patch.yml 只插入一个条目 dsh-live-preset-switch-skill-provider，指向本包；不禁用、替换、重排或 遮蔽任何官方 @deepseek-ai/* 组件。
• 自包含。无运行时依赖，无生命周期脚本 （preinstall/install/postinstall/prepare），无原生制品，无符号链接。
• 运行时只读。适配器不进行任何文件、网络、子进程或凭据访问；Skill 正文是静态字符串。

这个 Bundle 不是什么

• 它不是实时预设切换引擎本身。该功能修改了 DSH 核心包（会话历史推导、 agentPreset.select 回合边界守卫、输入框芯片），无法以增量插件形式发布； 它保留在 fork 分支中等待上游评审。本 Bundle 只发布指导内容。
• 本 Bundle 被 Catalog 收录不代表 fork 的核心改动已被安装或被上游接受。

兼容性声明

见 package.json 的 dsh.compatibility：

• dsh: >=0.1.0-rc.8 <0.2.0，node: >=22.19.0。
• dshReleases：对当前官方发布窗口（0.1.5-alpha.2、0.1.5-rc.1、 0.1.5-rc.2）以及 0.1.2-alpha.4、0.1.2-alpha.5、0.1.2-rc.1、 0.1.3-alpha.2、0.1.5-alpha.1 给出精确的 compatible 声明。依据是这些 版本公开 SkillRegistration 契约一致，本 Bundle 不使用任何其他宿主接口。
• 以上属于来源声明，不等于运行验收。各版本的隔离 Profile 安装 / 启动 / 卸载 / 回滚证据尚未完成，补齐前不作超出声明层级的表述。

安装

在 DSH STORE 以固定 Commit 收录后，可通过商城安装，或：

dsh plugin --profile <name> add --ignore-scripts 'git+https://github.com/HaoyanZhang123/dsh-live-preset-switch.git#<commit>'

预期效果：dsh --profile <name> --dump-config 恰好新增一个条目 dsh-live-preset-switch-skill-provider，且技能目录中出现 live-preset-switch 技能。

许可证

MIT。