dsh-skill-select
DSH 网页插件：从官方 DSH 右侧边栏中的标签页选择技能——列出所有已安装的技能并显示全局/本地标记，提供由 LLM 生成的描述（已缓存，绝不修改技能文件），勾选后将 /skill 手势注入当前会话的编辑器。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:wyzh0117/dsh-skill-select#42ab1c3014d9c00bb0235075d0304670f3c51e1dSkill Select 以 dsh-skill-select 发布，当前版本为 0.2.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
dsh-SkillSelect — Pick skills from the sidebar.
English · 中文
DSH web plugin: pick installed skills from a sidebar and inject them into the current session.
/skill-name to the composer; a fully checked repo writes /repo and expands on send. Hiding and reopening the tab clears this session's checks.skill tool calls outside Auto-start ∪ this session's picks are rejected. Typed /skill is never blocked.description when present; otherwise generates one English line and caches it. Never writes skill files./name@agent; the plugin injects that source's SKILL.md. These are not registered in the model's available_skills.git pull on git-backed skills and re-fetches skills with a per-skill origin marker. Root-level markers and skills with no source are skipped. A changelog appears in the panel.Web profile only.
dsh plugin --profile web add "github:wyzh0117/dsh-skill-select#main"
# local development — use link: so edits apply after restart
# dsh plugin --profile web add "link:/path/to/skill-select"
Restart dsh web, then hard-refresh the browser (Cmd/Ctrl+Shift+R).
| Plugin | DSH | Notes |
|---|---|---|
| 0.2.0 (current) | ^0.2.0-rc.2 | Registers against the official right sidebar (see below). |
| 0.1.1 | ^0.1.0-rc.6 || ^0.1.5-rc.1 | Last release for the 0.1.x lines; on 0.2.x the peer gate below skips it silently. |
| 0.1.0 | ^0.1.0-rc.6 | Broken on 0.1.5+ — see below. |
dsh 0.2.0-rc.2 gates compatibility hard. dsh-app-boot reads the
package.json peerDependencies whose name is @deepseek-ai/dsh or starts
with @deepseek-ai/dsh-, runs
semver.satisfies(runtimeVersion, range, { includePrerelease: true }), and on
any failure it skips the whole bundle: the module is never imported and the
plugin row shows as disabled — silently. If the plugin stops loading after a
DSH upgrade, check these peer ranges against dsh --version first.
engines.dsh in dsh.plugin.json is not enforced in rc.2 (kept as metadata
only). Forced-load escape hatch when you really must: dsh plugin allow-version, which writes <profile>/compatibility.json.
rc.2 also split session reads into two tracks. ctx.sessions is now an
in-memory store of live sessions: sessions.get(id) answers only for a
session this process has activated. A session you merely opened in the web UI is
cold, so the old single-path code returned session "…" not found (404) for
every session that was visibly on screen. openSkillView() covers both: a live
agent becomes the scope and ctx.agentPresets.serviceFor(agent, "skills") picks
the registry; a cold session is read with
ctx.sessionQuery.observeSession(id, { projectionMode }) (→ header.cwd,
projections.values.agentPreset) and given a standing scope from
ctx.agentPresets.acquireScope(preset), because listing skills for a session
that never entered the process still needs one. Each handle is released in a
finally (Symbol.dispose / Symbol.asyncDispose) — an unreleased scope pins
the preset registry. SESSION_QUERY_SESSION_NOT_FOUND maps to 404, any other
query failure to 500, and hosts without sessionQuery fall back to
sessions.get(). Symptom to remember: a 200 response with skills: [],
while the same session clearly has skills available to the model, means the cold
path could not obtain a scope — usually because a @deepseek-ai/dsh-* row in the
profile was version-skipped and acquireScope (which pulls in the shell /
sandbox / tool chain) threw.
DSH 0.1.5 changed the client module table: @deepseek-ai/dsh-client-runtime is no
longer a seed package, so require("@deepseek-ai/dsh-client-runtime") throws
missed the module table and the browser reports Failed to load plugins
(the host itself starts fine). 0.1.1 replaces it with ctx.sessions.scope(sessionId)
and declares the 0.1.5 range. Client code may only require() platform seed
modules — which is why sidebar icons are inline SVG components.
Upgrading DSH? DSH upgrades only the CLI — plugins already installed in the profile keep the old API. Re-resolve them afterwards:
dsh plugin --profile web update # re-resolve github:/registry plugins
# link:/ local checkouts are used in place — just restart dsh web
Then run npm test in this repo: tests/dsh-compat.test.js fails loudly when a
DSH named export disappears, a client seed package goes away, or a
@deepseek-ai/dsh-* peer range no longer covers the installed runtime.
The plugin registers a tab in the official DSH right sidebar (dsh ≥ 0.2), in two stages — both must be correct:
ctx.sidebarRightTabs.register({ id: "dsh-skill-select", kind: "skill-select", priority: "extension", title: () => "Skills", guide: [{ id: "dsh-skill-select", order: 70, /* … */ icon: SkillIcon }] }).
kind is the discriminator ctx.sidebarRight.openTab(kind) uses; the
guide entry is what shows Skills on the sidebar guide page.
guide[].id is required — two entries without an id throw
"duplicate guide entry id".ctx.slots.register({ name: "sidebar.right.pane.tab", key: "dsh-skill-select", inject: () => ({ rootCtx: ctx }) }, SkillSelectTab)
for the body and sidebar.right.pane.tab.title for the pill title. The
slot key must equal the stage-1 id, not the kind; a list-shaped
{id, order} on a keyed slot is a failed registration. Both registrations
run inside ctx.effect(...) via ctx.slots.inject(slotName, cb), so load
order can't break them.Open the right sidebar and pick Skills on the guide page.
ctx.sidebarRight.openTab("skill-select") always expands the sidebar and
throws while no Session is on screen. The tab body receives sessionId plus
useTabInfo(), gates its skill fetch on tab.visible, and resets the
session's checks on hide→show.
No third-party sidebar and no self-drawn fallback UI: without the official sidebar there is simply no tab.
node --test
node --check lib/index.js && node --check lib/client.js
Design: docs/design.md.