dsh-live-preset-switch

Readme

# dsh-live-preset-switch

[English](#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](https://github.com/HaoyanZhang123/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:

```sh
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](LICENSE).

---

## 中文

一个标准 **DSH Bundle**：向 Profile 中附加一个 Host 适配器，通过公开的
`ctx.skills.register()` 服务接口注册唯一的内置 Skill `live-preset-switch`。
该 Skill 指导 Agent 与用户如何选择 Agent 预设，以及支持该功能的构建上
"回合边界实时切换预设" 的行为方式（见
[deepseek-harness-live-preset-switch](https://github.com/HaoyanZhang123/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 收录后，可通过商城安装，或：

```sh
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](LICENSE)。