dsh-webui-studio
Harmony WebUI Studio，支持实时 DSH 预览和主机内助手会话
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add github:memorax-ai/dsh-webui-studio#e164c600931af315a3da2ea780949e2f9e2fdbb6Webui Studio 以 dsh-webui-studio 发布，当前版本为 0.3.0。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
A visual-first studio for building DSH WebUI plugins.
Inspect the real interface, edit source, run builds, and validate patches without loading unfinished code into your stable DSH Host.
Powered by dsh-harmony.
WebUI Studio is not a mock page builder. It runs against the official DSH WebUI and its real plugin graph, then turns visual inspection and source edits into distributable plugin-owned artifacts.
Studio is an independent downstream application of
dsh-harmony. It uses Harmony's
public runtime, Patch engine, service API, and CLI control surface together with the
generic React registration API from
dsh-harmony-react.
The dependency direction stays one-way: Studio depends on Harmony; Harmony does
not depend on Studio.
DSH_HOME, profile, dependencies, and child Hostflowchart LR
A["Stable DSH Host"] --> B["WebUI Studio"]
B --> C["Draft worktree"]
B --> D["Draft worktree"]
C --> E["Isolated DSH Home + Preview Host"]
D --> F["Isolated DSH Home + Preview Host"]
E --> G["Harmony runtime + real WebUI"]
F --> G
The stable Host owns the Studio interface, Draft registry, and Agent sessions. Each Draft owns an isolated worktree and child Preview Host. A build becomes active only after the Preview confirms the new live Client graph revision. Stopping a Draft terminates its child Host but preserves its files and state. An existing ordinary DSH session can enter Studio mode without losing its history or identity. Leaving Studio removes the scoped Draft tools, skill, and context so the session resumes through its ordinary DSH composition.
Studio is served locally at:
http://127.0.0.1:<dsh-port>/studio
External Agents can connect to the running instance through MCP at:
http://127.0.0.1:<dsh-port>/studio/mcp
A typical MCP client entry is:
{
"mcpServers": {
"dsh-webui-studio": {
"type": "http",
"url": "http://127.0.0.1:<dsh-port>/studio/mcp"
}
}
}
Add that URL as a Streamable HTTP MCP server in the external Agent. It exposes
studio_get_context, studio_get_selection, studio_get_harmony_profile,
studio_inspect_harmony_target, studio_read_dependency_source, and
studio_preview_status. These tools inspect the current Host only; the external
Agent remains responsible for editing and building its own WebUI project. Harmony
profile, Patch, and dependency-source inspection work directly from the Host.
DOM selection is available while Studio is open and an element is selected in
the current-instance Preview. The endpoint follows Studio's existing loopback-only
boundary, including access through an SSH loopback tunnel.
Its managed data lives under $DSH_HOME/studio/:
studio/
├── workspace.json
├── drafts/<draft-id>.json
├── repositories/<draft-id>/
├── worktrees/<draft-id>/
└── runtimes/<draft-id>/dsh-home/profiles/web/
Creating a new plugin initializes and commits a minimal DSH Web Client package.
New plugins stay inside Studio by default. Creation can optionally record an
absolute destination for a new or empty local folder; Studio does not create
or modify that folder until Save plugin to folder is used from the instance
panel. Later saves synchronize the Studio-owned project snapshot while leaving
destination-only files such as node_modules untouched.
Importing an existing plugin accepts an absolute local folder after validating
its Web Client manifest, then copies an isolated snapshot without .git or
node_modules into a Studio-owned Git repository. Symbolic links are rejected,
and the original folder is never modified.
Each Draft can start from the stable Host's current web profile or from
another local DSH profile selected by absolute folder path. Studio copies that
profile's manifest and configuration into the isolated runtime and resolves
relative link: dependencies against the selected source folder. The source
profile remains untouched.
Draft display names are independent from npm package identities and can be
renamed in the instance panel. Studio persists the ordered open tabs and active
Draft in workspace.json; closing a tab only removes it from the current
workspace and never stops or deletes the Draft. Unsaved Source changes must be saved with Ctrl+S or
Command+S before switching or closing tabs.
[!IMPORTANT] Studio requires the public Harmony service and CLI APIs documented in
docs/harmony-api-requirements.md.dsh-harmony@0.8.7is the minimum compatible release.
dsh plugin --profile web add dsh-webui-studio
dsh web
Studio includes Harmony as a transitive dependency. On the first visit to
/studio, approve Install Harmony and restart; the page installs the
launcher and returns to Studio after the local DSH process restarts. No second
package command is required. An existing Harmony launcher skips this setup.
To develop Studio itself from source:
git clone https://github.com/memorax-ai/dsh-webui-studio.git
cd dsh-webui-studio
npm install
npm run check
dsh plugin --profile web add link:$(pwd)
dsh web
To exercise the same single-package installation path as a release artifact:
studio_tarball="$(npm pack --silent --ignore-scripts)"
dsh plugin --profile web add "file:$(pwd)/${studio_tarball}"
Open the Studio URL printed by the local dsh web process, create or import a
Draft, and start its Preview Host.
A Draft package must:
dsh.client.platform: "web";., ./client, and ./package.json;scripts.build command.| Command | Purpose |
|---|---|
npm run typecheck | Check the Host, browser app, and Preview bridge |
npm test | Run the unit and component test suite |
npm run build | Build the Host, Studio UI, and Preview bridge |
npm run check | Run typecheck, tests, build, and packed fresh-install integration |
npm run test:integration | Pack and install the tarball in a fresh DSH home, then exercise Host, Draft, Preview, build, activation, and shutdown end to end |
For isolated Agent environments on a remote Docker host, see
docs/remote-development.md.
The integration test requires a Harmony build that exposes the APIs described in the compatibility note above.
/api and WebSockets; Studio does not proxy them.DSH WebUI changes are delivered through plugins rather than direct edits to the upstream source. Its interface elements also participate in Cordis plugin lifecycle and control logic, so the problem extends beyond manipulating static DOM and CSS. Those constraints call for a dedicated toolkit that understands the DSH plugin system from preview through distribution.
Studio still connects to the real Agent inside DSH. It gives that Agent richer project context, integrated previews, purpose-built tools and skills, and a tighter edit-build-inspect-validate loop. Studio does not replace the Agent; it turns source editing into a more capable interactive workflow for both the Agent and the developer.
The DSH WebUI exposes many useful slots, but Studio aims for deeper and more
flexible changes—including UI and behavior introduced by other plugins—while
keeping independently authored modifications as compatible as possible.
dsh-harmony provides the runtime
patching and runtime model that makes this possible.
dsh-harmony - runtime patching, transactional plugin reloads, and Patch inspectiondsh-harmony-react - React-aware Patch factories and Studio element/variable registrationDistributed under the MIT License.
This branch targets DSH 0.1.5-rc.2 and 0.1.6-alpha.2 with the native Session Controller and Binding Gateway events. It requires the pending Binding 0.1.8 and Harmony 0.8.12 releases; published Binding 0.1.7 does not contain these APIs. Publish Harmony and Binding first, then refresh this package lock from the registry before releasing Studio.
The adapter follows per-Session journals and assistant streams, reconstructs the active prefix after reconnecting, and returns native approval/question results. Preview Hosts retain the authenticated launch URL and use an exchanged cookie for their backend connection. The Harmony installer startup fix must also ship before validating fresh installations.
npm run test:gateway -- <upstream-install-root> <harmony-lib/bin.js> exercises Studio RPC, Session snapshots, projections, history, model catalog and journal delivery against an isolated real Host. The Windows rc package/Preview integration test also passes. Browser interaction and cross-platform checks remain separate release gates.