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。
