dsh-piano 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-piano contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,40 @@
-# Temporary Holding Version
+# dsh-piano · 滑动钢琴
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+在 DSH 界面里弹一条钢琴键盘：**点单个键出声，按住鼠标 / 触控板横向滑动会像刮奏（glissando）一样连续发声**。声音用 Web Audio 实时合成，零采样、零网络、零第三方依赖。
+
+## 效果
+
+- 左下角一枚 🎹 按钮（默认收起，不打扰正常使用）。**按钮可拖动**：按住移动超过 6px 即判定为拖（不会误开面板），松手后位置存 `localStorage`，下次进来仍在原处；400ms 内的 `click` 才算"点开"，拖动不会吞掉下一次真正点击。
+- 点开是底部居中的浮动键盘面板：音量滑块、八度移调（− / +）、收起。
+- 键盘含白键 + 黑键；按住后滑动，指到哪个键就响哪个音（按住拖动 = 刮奏）。
+- 设置（音量、起始八度）持久化到 `localStorage`，刷新后保留。
+
+## 技术要点
+
+| 项 | 做法 |
+|---|---|
+| 挂载槽位 | `shell.overlay`（常驻应用面座位） |
+| 音频 | Web Audio 合成：基音 + 泛音（指数衰减）+ 高通噪声锤击瞬态 + 低通 + 压缩器防削波 |
+| 刮奏 | 指针按下 `setPointerCapture` → `pointermove` 用 `document.elementFromPoint` 命中 `data-midi` 键 → 键变化即触发新音 |
+| 客户端形态 | 手写 `window.__ModuleLoader__.load` 零构建 bundle，`platform: web` |
+
+## 安装（本地）
+
+```sh
+# 以 file:/link: 目录依赖装进 profile，并加入 bundles（或 cordis insert）
+dsh plugin --profile desktop add /path/to/dsh-piano -w
+# 或手写：profile/package.json 加 "dsh-piano": "link:...", 并在 dsh.profile.bundles 加 "dsh-piano"
+```
+
+## 开发
+
+```sh
+npm test          # node test/bundle-check.mjs —— 断言 bundle 结构与关键 marker
+```
+
+客户端 bundle 用 `link:` 目录依赖时，改完浏览器刷新即生效；服务端半改动需重启 Host。
+
+## 说明
+
+- 首次出声需要一次用户手势（点开按钮或按下琴键即自动解锁 AudioContext）。
+- 浏览器无 `AudioContext`（极老环境）时静默不发声。

package/cordis.patch.yml

@@ -0,0 +1,5 @@
+# dsh-piano：往插件树里插一行（纯客户端插件，服务器半无配置）。
+# 注：name 必须等于包名；id 是本地行标识（也是设置页命名空间）。
+- insert:
+    - id: dsh-piano
+      name: dsh-piano

package/lib/client.js

@@ -0,0 +1,434 @@
+/**
+ * dsh-piano — browser half.
+ *
+ * 一条浮动钢琴键盘：点单键出声，鼠标/触控板按住后横向滑动会像刮奏（glissando）
+ * 一样连续触发不同音高。声音用 Web Audio 实时合成（泛音 + 快速起音 + 指数衰减 +
+ * 噪声锤击瞬态 + 低通/压缩），零采样、零网络、零依赖。
+ *
+ * 挂载点：`shell.overlay`（常驻应用面座位），渲染一个固定定位的悬浮小组件——
+ * 默认收起成左下角一枚 🎹 按钮，点开是底部居中的键盘面板（音量 / 八度移调 / 收起）。
+ */
+window.__ModuleLoader__.load({
+	id: "dsh-piano",
+	factory: (require) => {
+		var module = { exports: {} };
+		var exports = module.exports;
+		Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+		const React = require("react");
+		const { useEffect, useRef, useState, useMemo, useCallback } = React;
+		const h = React.createElement;
+
+		//#region styles
+		const CSS = [
+			".dshp_btn{box-sizing:border-box;position:fixed;left:16px;bottom:16px;z-index:2147483000;height:44px;min-width:44px;padding:0 14px;display:inline-flex;align-items:center;justify-content:center;gap:8px;border:none;border-radius:22px;background:var(--dsw-alias-bg-elevated,#1f2430);color:var(--dsw-alias-label-primary,#e6e8ee);box-shadow:0 6px 24px rgba(0,0,0,.35);cursor:pointer;user-select:none;touch-action:none;will-change:transform;font-size:16px;line-height:20px}",
+			".dshp_btn:hover{background:var(--dsw-alias-interactive-bg-hover,#2a3140)}",
+			".dshp_panel{box-sizing:border-box;position:fixed;left:50%;bottom:16px;transform:translateX(-50%);z-index:2147483000;width:min(94vw,760px);display:flex;flex-direction:column;gap:8px;padding:12px;border-radius:14px;background:var(--dsw-alias-bg-elevated,#1f2430);color:var(--dsw-alias-label-primary,#e6e8ee);box-shadow:0 12px 40px rgba(0,0,0,.45);user-select:none}",
+			".dshp_head{display:flex;align-items:center;gap:12px}",
+			".dshp_title{flex:none;font-size:13px;line-height:20px;color:var(--dsw-alias-label-secondary,#9aa2b1)}",
+			".dshp_controls{flex:1;display:flex;align-items:center;gap:12px}",
+			".dshp_vol{display:flex;align-items:center;gap:6px;color:var(--dsw-alias-label-tertiary,#6b7280);font-size:11px;line-height:16px}",
+			".dshp_vol input[type=range]{width:96px;accent-color:var(--dsw-alias-state-business-primary,#5b8def)}",
+			".dshp_oct{display:flex;align-items:center;gap:6px;color:var(--dsw-alias-label-tertiary,#6b7280);font-size:11px;line-height:16px}",
+			".dshp_oct button{box-sizing:border-box;width:24px;height:24px;padding:0;border:1px solid var(--dsw-alias-border-l2,#3a4150);border-radius:6px;background:transparent;color:var(--dsw-alias-label-primary,#e6e8ee);cursor:pointer;font-size:14px;line-height:1;display:inline-flex;align-items:center;justify-content:center}",
+			".dshp_oct button:hover{background:var(--dsw-alias-interactive-bg-hover,#2a3140)}",
+			".dshp_close{margin-left:auto;box-sizing:border-box;height:24px;padding:0 10px;border:none;border-radius:6px;background:transparent;color:var(--dsw-alias-label-secondary,#9aa2b1);cursor:pointer;font-size:12px;line-height:20px}",
+			".dshp_close:hover{background:var(--dsw-alias-interactive-bg-hover,#2a3140);color:var(--dsw-alias-label-primary,#e6e8ee)}",
+			".dshp_kb{position:relative;height:180px;touch-action:none;cursor:pointer;border-radius:10px;overflow:hidden}",
+			".dshp_kb::after{content:\"\";position:absolute;left:0;right:0;bottom:0;height:4px;background:linear-gradient(90deg,#d33,#e88,#d33);opacity:.55;pointer-events:none}",
+			".dshp_white{position:relative;z-index:1;flex:1 1 0;height:100%;border-right:1px solid var(--dsw-alias-border-l2,#3a4150);border-radius:0 0 4px 4px;background:linear-gradient(180deg,#f7f8fa 0%,#e8ebf0 96%);color:#3a4150;display:flex;align-items:flex-end;justify-content:center;padding-bottom:8px;font-size:11px;line-height:14px}",
+			".dshp_white:last-child{border-right:none}",
+			".dshp_white.isActive{background:linear-gradient(180deg,#bcd4ff 0%,#9fc0ff 96%)}",
+			".dshp_black{position:absolute;z-index:2;top:0;height:62%;border-radius:0 0 4px 4px;background:linear-gradient(180deg,#2b303b 0%,#11141a 100%);color:#9aa2b1;box-shadow:0 2px 6px rgba(0,0,0,.4);display:flex;align-items:flex-end;justify-content:center;padding-bottom:6px;font-size:9px;line-height:12px}",
+			".dshp_black.isActive{background:linear-gradient(180deg,#4a6fb0 0%,#2f4d8f 100%)}",
+			".dshp_hint{margin:0;font-size:11px;line-height:16px;color:var(--dsw-alias-label-tertiary,#6b7280)}"
+		].join("");
+		const tagId = "dsh-piano/piano.css";
+		if (typeof document !== "undefined" && document.querySelector("style[data-plugin-css=" + JSON.stringify(tagId) + "]") === null) {
+			const style = document.createElement("style");
+			style.setAttribute("data-plugin-css", tagId);
+			style.textContent = CSS;
+			document.head.appendChild(style);
+		}
+
+		//#region audio engine
+		let _ctx = null;
+		let _out = null;
+		let _noiseBuf = null;
+		function audioCtx() {
+			if (!_ctx) {
+				const AC = window.AudioContext || window.webkitAudioContext;
+				if (!AC) return null;
+				_ctx = new AC();
+			}
+			if (_ctx.state === "suspended") _ctx.resume().catch(() => {});
+			return _ctx;
+		}
+		function midiToFreq(m) {
+			return 440 * Math.pow(2, (m - 69) / 12);
+		}
+		/**
+		 * 共享输出链（只建一次）：总线 → 低通 → 压缩器。
+		 * 所有音共用一个压缩器，滑奏时多音叠加由它统一压住：既防削波，
+		 * 也避免每个音都重建一条 master/lowpass/compressor 链。
+		 */
+		function outputChain(ctx) {
+			if (_out) return _out;
+			const master = ctx.createGain();
+			master.gain.value = 0.85;
+			const lp = ctx.createBiquadFilter();
+			lp.type = "lowpass";
+			lp.frequency.value = 6500;
+			lp.Q.value = 0.3;
+			const comp = ctx.createDynamicsCompressor();
+			comp.threshold.value = -22;
+			comp.knee.value = 24;
+			comp.ratio.value = 12;
+			comp.attack.value = 0.004;
+			comp.release.value = 0.18;
+			master.connect(lp);
+			lp.connect(comp);
+			comp.connect(ctx.destination);
+			_out = master;
+			return master;
+		}
+		/**
+		 * 缓存的锤击噪声缓冲（只建一次）。
+		 * 上一版每个音都新建一个 AudioBuffer，快速滑动时分配抖动会引入杂音。
+		 */
+		function noiseBuffer(ctx) {
+			if (_noiseBuf) return _noiseBuf;
+			const len = Math.max(1, Math.floor(ctx.sampleRate * 0.02));
+			const buf = ctx.createBuffer(1, len, ctx.sampleRate);
+			const data = buf.getChannelData(0);
+			for (let i = 0; i < len; i++) data[i] = (Math.random() * 2 - 1) * Math.pow(1 - i / len, 3);
+			_noiseBuf = buf;
+			return buf;
+		}
+		/**
+		 * 合成一枚「电钢」音：基音 + 3 枚泛音（各带指数衰减）+ 极轻的击弦瞬态。
+		 * 泛音改成更少更柔的正弦、瞬态降到 0.05 倍，叠加时靠共享压缩器兜底。
+		 */
+		function playNote(midi, volume) {
+			if (volume <= 0.01) return;
+			const ctx = audioCtx();
+			if (!ctx) return;
+			const out = outputChain(ctx);
+			const freq = midiToFreq(midi);
+			const now = ctx.currentTime;
+			const v = Math.max(0.02, Math.min(1, volume));
+
+			const partials = [
+				{ r: 1, a: 0.85, d: 2.0, type: "sine" },
+				{ r: 2, a: 0.28, d: 1.1, type: "sine" },
+				{ r: 3, a: 0.11, d: 0.6, type: "sine" },
+				{ r: 4, a: 0.045, d: 0.4, type: "sine" }
+			];
+			for (const p of partials) {
+				const osc = ctx.createOscillator();
+				osc.type = p.type;
+				osc.frequency.value = freq * p.r;
+				osc.detune.value = (Math.random() - 0.5) * 3;
+				const g = ctx.createGain();
+				g.gain.setValueAtTime(0.0001, now);
+				g.gain.linearRampToValueAtTime(p.a * v, now + 0.006);
+				g.gain.exponentialRampToValueAtTime(0.0001, now + p.d);
+				osc.connect(g);
+				g.connect(out);
+				osc.start(now);
+				osc.stop(now + p.d + 0.08);
+			}
+
+			// 极轻的击弦瞬态：只留一点触键质感，不再是明显嘶声
+			const noise = ctx.createBufferSource();
+			noise.buffer = noiseBuffer(ctx);
+			const hp = ctx.createBiquadFilter();
+			hp.type = "highpass";
+			hp.frequency.value = 2500;
+			const ng = ctx.createGain();
+			ng.gain.value = v * 0.05;
+			noise.connect(hp);
+			hp.connect(ng);
+			ng.connect(out);
+			noise.start(now);
+		}
+
+		//#region note layout
+		const NOTE_NAMES = ["C", "C#", "D", "D#", "E", "F", "F#", "G", "G#", "A", "A#", "B"];
+		const WHITE_SEMITONES = [0, 2, 4, 5, 7, 9, 11];
+		// 黑键：afterWhite = 它右侧紧邻白键在“每个八度内”的序号（用于定位到边界），offset = 半音偏移。
+		const BLACK_KEYS = [
+			{ name: "C#", afterWhite: 1, offset: 1 },
+			{ name: "D#", afterWhite: 2, offset: 3 },
+			{ name: "F#", afterWhite: 4, offset: 6 },
+			{ name: "G#", afterWhite: 5, offset: 8 },
+			{ name: "A#", afterWhite: 6, offset: 10 }
+		];
+
+		function buildKeys(startMidi, octaves) {
+			const white = [];
+			const black = [];
+			for (let o = 0; o < octaves; o++) {
+				for (let i = 0; i < 7; i++) {
+					const midi = startMidi + o * 12 + WHITE_SEMITONES[i];
+					const pc = midi % 12;
+					white.push({
+						midi,
+						label: NOTE_NAMES[pc] + (pc === 0 ? "" + (Math.floor(midi / 12) - 1) : ""),
+						idx: o * 7 + i
+					});
+				}
+				for (const b of BLACK_KEYS) {
+					black.push({
+						midi: startMidi + o * 12 + b.offset,
+						label: b.name,
+						boundary: o * 7 + b.afterWhite
+					});
+				}
+			}
+			return { white, black, totalWhite: white.length };
+		}
+
+		//#region keyboard component
+		function PianoKeyboard({ startMidi, octaves, volume, activeMidi, setActiveMidi }) {
+			const { white, black, totalWhite } = useMemo(
+				() => buildKeys(startMidi, octaves),
+				[startMidi, octaves]
+			);
+			const kbRef = useRef(null);
+			const draggingRef = useRef(false);
+			const lastMidiRef = useRef(null);
+			const lastPlayRef = useRef(0);
+			const volumeRef = useRef(volume);
+			volumeRef.current = volume;
+
+			const keyAt = useCallback((e) => {
+				const el = document.elementFromPoint(e.clientX, e.clientY);
+				if (!el || !el.closest) return null;
+				const keyEl = el.closest("[data-midi]");
+				if (!keyEl) return null;
+				return parseInt(keyEl.getAttribute("data-midi"), 10);
+			}, []);
+
+			const onPointerDown = useCallback((e) => {
+				if (e.button !== 0 && e.pointerType === "mouse") return;
+				audioCtx(); // 用户手势里解锁/恢复 AudioContext
+				draggingRef.current = true;
+				const midi = keyAt(e);
+				if (midi != null) {
+					lastMidiRef.current = midi;
+					setActiveMidi(midi);
+					playNote(midi, volumeRef.current);
+				}
+				try { e.currentTarget.setPointerCapture(e.pointerId); } catch {}
+			}, [keyAt, setActiveMidi]);
+
+			const onPointerMove = useCallback((e) => {
+				if (!draggingRef.current) return;
+				const midi = keyAt(e);
+				if (midi == null) {
+					setActiveMidi(null);
+					return;
+				}
+				if (midi !== lastMidiRef.current) {
+					lastMidiRef.current = midi;
+					setActiveMidi(midi);
+					// 限速：快速划过整排键时不要瞬间堆满音（会糊成一片）
+					const nowMs = performance.now();
+					if (nowMs - lastPlayRef.current >= 24) {
+						lastPlayRef.current = nowMs;
+						playNote(midi, volumeRef.current);
+					}
+				}
+			}, [keyAt, setActiveMidi]);
+
+			const onPointerEnd = useCallback((e) => {
+				draggingRef.current = false;
+				lastMidiRef.current = null;
+				setActiveMidi(null);
+				try { e.currentTarget.releasePointerCapture(e.pointerId); } catch {}
+			}, [setActiveMidi]);
+
+			const whiteWidthPct = 100 / totalWhite;
+			const blackWidthPct = whiteWidthPct * 0.62;
+
+			const whiteRow = white.map((k) =>
+				h("div", {
+					key: "w" + k.midi,
+					"data-midi": k.midi,
+					className: "dshp_white" + (k.midi === activeMidi ? " isActive" : ""),
+					style: { flex: "1 1 0" }
+				}, k.label)
+			);
+
+			const blackRow = black.map((k) => {
+				const leftPct = k.boundary * whiteWidthPct - blackWidthPct / 2;
+				return h("div", {
+					key: "b" + k.midi,
+					"data-midi": k.midi,
+					className: "dshp_black" + (k.midi === activeMidi ? " isActive" : ""),
+					style: { left: leftPct + "%", width: blackWidthPct + "%" }
+				}, k.label);
+			});
+
+			return h("div", {
+				ref: kbRef,
+				className: "dshp_kb",
+				style: { display: "flex" },
+				onPointerDown,
+				onPointerMove,
+				onPointerUp: onPointerEnd,
+				onPointerCancel: onPointerEnd,
+				onContextMenu: (e) => e.preventDefault()
+			}, whiteRow, blackRow);
+		}
+
+		//#region widget
+		const LS_KEY = "dsh-piano:settings";
+		const DEFAULTS = { volume: 0.35, startMidi: 48, octaves: 3 };
+		function loadSettings() {
+			try {
+				return { ...DEFAULTS, ...(JSON.parse(localStorage.getItem(LS_KEY) || "{}")) };
+			} catch {
+				return { ...DEFAULTS };
+			}
+		}
+		function saveSettings(s) {
+			try { localStorage.setItem(LS_KEY, JSON.stringify(s)); } catch {}
+		}
+
+		function PianoWidget() {
+			const [open, setOpen] = useState(false);
+			const [settings, setSettings] = useState(loadSettings);
+			const [activeMidi, setActiveMidi] = useState(null);
+
+			const setVolume = useCallback((volume) => {
+				setSettings((s) => {
+					const next = { ...s, volume };
+					saveSettings(next);
+					return next;
+				});
+			}, []);
+			const shiftOctave = useCallback((delta) => {
+				setSettings((s) => {
+					const startMidi = Math.max(24, Math.min(84, s.startMidi + delta * 12));
+					const next = { ...s, startMidi };
+					saveSettings(next);
+					return next;
+				});
+			}, []);
+			const onOpen = useCallback(() => {
+				audioCtx(); // 点开时预解锁，避免第一次按键静音
+				setOpen(true);
+			}, []);
+
+			// —— 收起态按钮**可拖动**：移动超过 6px 判定为「拖」（不触发开面板），
+			//    松手后位置存 localStorage，下次进来仍在原处。 ——
+			const [btnPos, setBtnPos] = useState(() => {
+				try { return JSON.parse(localStorage.getItem("dsh-piano:btnPos") || "null"); } catch { return null; }
+			});
+			const btnPosRef = useRef(btnPos);
+			btnPosRef.current = btnPos;
+			const dragRef = useRef(null);
+			const draggedRef = useRef(false);
+			const dragClearRef = useRef(0);
+
+			const onBtnDown = (e) => {
+				if (e.pointerType === "mouse" && e.button !== 0) return;
+				draggedRef.current = false;
+				const r = e.currentTarget.getBoundingClientRect();
+				dragRef.current = { x: e.clientX, y: e.clientY, left: r.left, top: r.top, moved: false };
+				try { e.currentTarget.setPointerCapture(e.pointerId); } catch {}
+			};
+			const onBtnMove = (e) => {
+				const d = dragRef.current;
+				if (!d) return;
+				const dx = e.clientX - d.x;
+				const dy = e.clientY - d.y;
+				if (!d.moved && Math.abs(dx) + Math.abs(dy) > 6) d.moved = true;
+				if (!d.moved) return;
+				const left = Math.max(4, Math.min(window.innerWidth - 70, d.left + dx));
+				const top = Math.max(4, Math.min(window.innerHeight - 50, d.top + dy));
+				btnPosRef.current = { left, top };
+				setBtnPos({ left, top });
+			};
+			const onBtnUp = (e) => {
+				const d = dragRef.current;
+				dragRef.current = null;
+				try { e.currentTarget.releasePointerCapture(e.pointerId); } catch {}
+				if (!d || !d.moved) return;
+				draggedRef.current = true;
+				const pos = btnPosRef.current;
+				if (pos) { try { localStorage.setItem("dsh-piano:btnPos", JSON.stringify(pos)); } catch {} }
+				// 拖完不一定紧跟 click（拖到按钮外松手就点不出来）→ 400ms 后自动清标志，
+				// 免得把**下一次**真正的点击吞掉
+				if (dragClearRef.current) window.clearTimeout(dragClearRef.current);
+				dragClearRef.current = window.setTimeout(() => { draggedRef.current = false; }, 400);
+			};
+			const onBtnClick = () => {
+				if (draggedRef.current) { draggedRef.current = false; return; } // 刚才那一下是拖，不是点
+				onOpen();
+			};
+
+			if (!open) {
+				return h("button", {
+					className: "dshp_btn",
+					title: "滑动钢琴（可拖动，点开面板）",
+					onClick: onBtnClick,
+					onPointerDown: onBtnDown,
+					onPointerMove: onBtnMove,
+					onPointerUp: onBtnUp,
+					onPointerCancel: onBtnUp,
+					style: btnPos ? { left: btnPos.left + "px", top: btnPos.top + "px", bottom: "auto" } : undefined
+				}, "🎹 钢琴");
+			}
+
+			return h("div", { className: "dshp_panel" },
+				h("div", { className: "dshp_head" },
+					h("span", { className: "dshp_title" }, "🎹 滑动钢琴"),
+					h("div", { className: "dshp_controls" },
+						h("label", { className: "dshp_vol" },
+							"音量",
+							h("input", {
+								type: "range",
+								min: 0,
+								max: 1,
+								step: 0.05,
+								value: settings.volume,
+								onChange: (e) => setVolume(parseFloat(e.target.value))
+							})
+						),
+						h("div", { className: "dshp_oct" },
+							h("button", { onClick: () => shiftOctave(-1), title: "低一个八度" }, "−"),
+							"八度",
+							h("button", { onClick: () => shiftOctave(1), title: "高一个八度" }, "+")
+						)
+					),
+					h("button", { className: "dshp_close", onClick: () => setOpen(false) }, "收起")
+				),
+				h(PianoKeyboard, {
+					startMidi: settings.startMidi,
+					octaves: settings.octaves,
+					volume: settings.volume,
+					activeMidi,
+					setActiveMidi
+				}),
+				h("p", { className: "dshp_hint" }, "按住鼠标 / 触控板横向滑动 = 刮奏；点单个键 = 单音")
+			);
+		}
+
+		//#region apply
+		const inject = ["slots"];
+		function apply(ctx) {
+			ctx.slots.inject("shell.overlay", () => ctx.slots.register({
+				name: "shell.overlay",
+				id: "dsh-piano:overlay",
+				order: 100,
+				inject: () => ({})
+			}, PianoWidget));
+		}
+		exports.apply = apply;
+		exports.inject = inject;
+
+		return module.exports;
+	}
+});

package/lib/index.js

@@ -0,0 +1,11 @@
+/**
+ * dsh-piano — host half (browser-only surface).
+ *
+ * 整个功能都在浏览器半（`./client`，通过 package.json → `dsh.client` 声明，
+ * `platform: "web"`）里：一条浮动钢琴键盘 + Web Audio 合成，鼠标/触控板
+ * 滑过去触发刮奏。服务器半不需要任何服务、不新增任何宿主状态，因此这里
+ * 只需导出一个空 `apply`，让 Loader 行能干净挂载即可。
+ */
+function apply() {}
+
+export { apply };

package/package.json

@@ -1,6 +1,59 @@
 {
   "name": "dsh-piano",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "滑动钢琴：在 DSH 界面里弹一条钢琴键盘，鼠标/触控板滑过去像刮奏（glissando）一样出声。",
+  "type": "module",
+  "license": "MIT",
+  "keywords": [
+    "dsh",
+    "dsh-plugin",
+    "deepseek-harness",
+    "piano",
+    "glissando",
+    "music",
+    "钢琴",
+    "滑动钢琴"
+  ],
+  "main": "lib/index.js",
+  "exports": {
+    ".": {
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "default": "./lib/client.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "cordis.patch.yml",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=22",
+    "dsh": ">=0.2.0-rc.1"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1"
+  },
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-ui-slots"
+      ],
+      "platform": "web"
+    },
+    "compatibility": {
+      "dshReleases": {
+        "0.2.0-rc.2": "compatible"
+      }
+    }
+  },
+  "scripts": {
+    "test": "node test/bundle-check.mjs"
+  }
 }