dsh-labscript 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,19 @@
+# Changelog
+
+## 0.2.0
+
+- Safe default: backend is mock-labscript unless the config explicitly sets labscript.
+- labs_abort bypasses the serial queue, so it is never blocked behind labs_wait.
+- Pending/last-run state is persisted under DSH_HOME and reloaded after a restart.
+- labs_doctor: read-only diagnostic for python, numpy/h5py, labscript/runmanager, paths and versions.
+- Minimal Plugins-page configuration page (backend, python, runmanager, protocolsDir) + doctor results.
+- Python environment requirements documented per backend.
+
+## 0.1.0
+
+- Eight labs_* tools: status, set, engage, wait, abort, data, protocol, restore.
+- Fixed-operation YAML protocols with postprocess write-back and panel restore.
+- Panel snapshots before writes plus an events.jsonl action log.
+- Built-in mock-labscript backend for tests, examples and hardware-free development.
+- Runmanager (labscript) backend built on the stock remote API and shot HDF5.
+- Stalled-queue diagnosis, selective panel restore and accurate abort semantics.

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 dsh-labscript 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,154 @@
-# Temporary Holding Version
-
-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-labscript
+
+Control a [labscript-suite](https://labscriptsuite.org/) experiment from DeepSeek Harness (DSH).
+
+The plugin exposes the stock labscript control surface only: the runmanager remote API
+(panel globals, n_shots, engage, abort, run_shots, error_in_globals) plus the shot HDF5
+files. It does not require any custom BLACS/lyse patch. Everything lab-specific
+(analysis, protocols, hard limits) is supplied by configuration.
+
+## Status
+
+v0.2.0. The mock-labscript backend, the protocol/postprocess flow and the
+snapshot/diagnosis behaviour are covered by node and python tests. A client
+configuration page (Plugins page) and a read-only `labs_doctor` are included. The real
+labscript backend is implemented against the stock runmanager remote API but has
+not yet been validated on laboratory hardware. Start real-machine work with a
+read-only status call, then a single-key write/restore, then a few shots.
+
+## Requirements
+
+- DSH >= 0.2 and Node.js ^22.19 or >= 24.
+- Python >= 3.9. Mock mode needs only numpy >= 1.23 and h5py >= 3.8; real
+  hardware needs the labscript-suite Python environment (labscript, runmanager,
+  labscript_utils, zprocess importable). Tested with Python 3.11.0,
+  numpy 2.2.5, h5py 3.13.0. The plugin never stores credentials; zprocess
+  authentication is read by labscript from labconfig.
+
+## Install
+
+Clone this repository, add it as a `link:` dependency in your DSH profile and
+`pnpm install`; docs/INSTALL.zh.md walks through it. The backend defaults to
+`mock-labscript`; real hardware is only used when the config sets
+`backend: labscript` explicitly. Connection settings can be edited in
+Plugins -> dsh-labscript after install (advanced keys stay in the profile
+config). Run `labs_doctor` first if anything looks misconfigured.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| labs_doctor | Read-only configuration diagnostic: python, numpy/h5py, labscript/runmanager, paths, approval, versions. |
+| labs_status | Read the panel: labscript, globals, n_shots, error_in_globals, run_shots, pending run progress, snapshot directory |
+| labs_set | Write panel globals (or raw expressions, or the repetition counter). Snapshots the panel first. Does not run. |
+| labs_engage | Submit the current panel for a run; returns immediately with n_shots_at_submit and expected_n_shots |
+| labs_wait | Wait (blocking, with timeout) for the pending run; finalizes a pending protocol: postprocess, finish write-back, restore |
+| labs_abort | Abort the current submission |
+| labs_data | Read the run folder HDF5: first-shot globals and, with scan, a per-shot table |
+| labs_protocol | list / show / run YAML fixed-operation protocols |
+| labs_restore | Restore the panel from the latest snapshot taken before a write |
+
+A runtime skill named labscript carries the workflow rules (status first, fixed
+protocols for stable flows, submit then end the turn, one run at a time, never
+guess panel state).
+
+## Fixed-operation protocols
+
+    name: demo_scan
+    labscript: /path/to/your/sequence.py   # or: joint_script: registry_key
+    set:
+      do_acquire: true
+      amplitude: 0.5
+    scan:
+      duration_test_us: np.linspace(0.0, 8.0, 5)   # expression, number or list
+    reps: 2
+    postprocess: demo.peaks                        # entry configured once
+    finish:
+      restore: true
+      panel:
+        duration_test_us: fit.center               # written back to the panel
+      history:
+        demo.peaks.center_us: fit.center           # appended to the calibration jsonl
+
+    labs_protocol show demo_scan     # validates the plan and hard limits
+    labs_protocol run demo_scan      # set + scan + reps + engage, returns immediately
+    labs_wait                        # waits, then postprocess -> finish -> restore
+
+## Configuration
+
+Add one row to your DSH profile patch (see examples/config.example.yml):
+
+    - id: dsh-labscript
+      name: dsh-labscript
+      config:
+        python: /path/to/labscript-suite/python
+        backend: labscript
+        runmanager: { host: 127.0.0.1, port: 42523, timeoutS: 10 }
+        protocolsDir: /path/to/protocols
+        scriptsFile: /path/to/scripts.json
+        hardLimitsFile: /path/to/hard_limits.json
+        calibrationLog: /path/to/calibration.jsonl
+        pathMap:
+          - { remotePrefix: "E:/Experiments", localPrefix: "//lab-pc/Experiments" }
+        reps: { global: dummy_iterator }
+        postprocess:
+          entry: my_lab.analysis:analyze
+          pythonPaths: [/path/to/my_lab]
+        approval: { engage: true, protocolRun: true }
+
+The python interpreter must be able to import numpy and h5py; the real backend
+also needs runmanager (labscript-suite). The plugin never stores credentials:
+zprocess authentication is read by labscript itself from labconfig.
+
+### Mock backend
+
+    backend: mock-labscript
+
+runs a built-in simulator (fake panel, fake HDF5, persistent state under
+mock.stateDir). It exists for tests, examples and hardware-free development; it
+is not a physics simulation.
+
+## Install (local)
+
+    git clone <this repo> && cd dsh-labscript
+    npm install
+    # add "dsh-labscript": "link:/path/to/dsh-labscript" to the profile package.json
+    # add the bundle name and the cordis.patch.yml row; restart DSH
+
+## Development
+
+    npm install              # only runtime dependency: yaml
+    npm test                 # node --test, 18 tests (fake bridge, no python needed)
+    python python/tests/run_tests.py   # 8 tests (needs numpy + h5py)
+    LABSCRIPT_PYTHON=/path/to/python3 node scripts/demo.mjs   # end-to-end mock demo
+
+A fresh clone must run `npm install` before `npm test`; the CI workflow does this.
+
+## Docs
+
+- docs/README.zh.md - Chinese guide
+- docs/INSTALL.zh.md - local DSH profile install
+
+## Boundaries
+
+- Real hardware: engage/protocol run ask for a DSH approval (one-shot) when the
+  backend is labscript; abort and panel writes do not. The plugin is not a
+  hardware interlock.
+- Completion is detected from the run folder on the filesystem (HDF5 count,
+  stable file sizes, and a readable last shot); stock labscript has no
+  run-state query.
+- Cancelling labs_wait only stops waiting: the run keeps going. Call labs_abort
+  explicitly when something must stop. labscript abort stops compiling/submitting new
+  shots; shots already queued in BLACS or running are not stopped.
+- labs_wait reports a diagnosis (complete, no_shots, compiling, compiled_not_executed,
+  partial). compiled_not_executed means shots exist but show no acquisition data yet;
+  BLACS may be paused or not executing the queue.
+- Real runmanager engage does not return a run folder; the bridge captures the
+  output folder before engage and reports it as the run folder.
+- The panel is snapshotted before every write; labs_restore restores only the keys the
+  write touched (full=true restores the whole panel), so unrelated concurrent edits survive.
+- Actions are logged to events.jsonl next to the snapshots.
+
+---
+
+Development note: implemented with assistance from a DeepSeek Harness coding agent.

package/cordis.patch.yml

@@ -0,0 +1,6 @@
+# dsh-labscript -- DSH bundle patch
+#
+# Declares the plugin row. The "name" must match the installed package name.
+- insert:
+    - id: dsh-labscript
+      name: dsh-labscript

package/docs/INSTALL.zh.md

@@ -0,0 +1,54 @@
+# 安装（DSH desktop profile）
+
+## 0. 环境要求
+
+- DSH >= 0.2，Node.js ^22.19 或 >= 24。
+- Python >= 3.9。
+  - mock 模式：只需 numpy >= 1.23、h5py >= 3.8；
+  - 真机模式：用 labscript-suite 的 Python 环境（labscript、runmanager、
+    labscript_utils、zprocess 可导入）。
+  - 开发时实测：Python 3.11.0、numpy 2.2.5、h5py 3.13.0。
+
+## 1. 安装插件
+
+把仓库放到本机任意目录（下称 `<repo>`），在 DSH desktop profile 里 link 安装：
+
+1. 编辑 `%USERPROFILE%\.dsh\profiles\desktop\package.json`：
+
+       "dependencies": {
+         ...,
+         "dsh-labscript": "link:<repo>"
+       }
+
+   并在 `dsh.profile.bundles` 里加入 `"dsh-labscript"`。
+
+2. 在 profile 目录执行 `pnpm install`，重启 DSH。
+3. 新会话里应出现 9 个 `labs_*` 工具和 `labscript` skill。
+
+实验机建议固定 tag：`git checkout v0.2.0` 后再安装，避免 main 变动影响硬件行为。
+
+## 2. 配置
+
+优先在 DSH 里配置：侧边栏 → 插件 → dsh-labscript，填 backend、python、
+runmanager host/port、protocolsDir，保存后下一次工具调用生效（不用重启）。
+
+高级配置（scriptsFile、hard limits、postprocess、approval、pathMap、超时等）
+仍写在 profile 的 `cordis.patch.yml`：
+
+    - id: dsh-labscript
+      name: dsh-labscript
+      config:
+        scriptsFile: <path>/scripts.json
+        hardLimitsFile: <path>/hard_limits.json
+        postprocess:
+          entry: my_lab.analysis:analyze
+          pythonPaths: [<path>/my_lab]
+        approval: { engage: true, protocolRun: true }
+
+## 3. 冒烟顺序
+
+1. `labs_doctor`：确认 python/依赖/路径/版本身份；
+2. mock：`labs_status` → `labs_protocol list` → `labs_protocol run demo_scan` → `labs_wait`；
+3. 真机：只读 `labs_status` → 单键 `labs_set` + `labs_restore` → ≤10 shots →
+   `labs_data` → 一条协议。
+

package/docs/README.zh.md

@@ -0,0 +1,57 @@
+# dsh-labscript（中文说明）
+
+在 DeepSeek Harness（DSH）里控制 labscript-suite 实验。只用 stock 接口：
+runmanager remote（面板 globals、n_shots、engage、abort、run_shots、
+error_in_globals）+ shot HDF5。不需要改 BLACS/lyse；实验室私有的分析、协议、
+hard limits 全部通过配置接入。
+
+## 工具（9 个）
+
+| 工具 | 作用 |
+|---|---|
+| labs_doctor | 只读诊断：python、numpy/h5py、labscript/runmanager、路径、审批、版本 |
+| labs_status | 读面板：labscript、globals、n_shots、error_in_globals、run_shots、pending 进度 |
+| labs_set | 写面板（标量 / raw 表达式 / reps），写前全量快照；不运行 |
+| labs_engage | 提交当前面板，立即返回 n_shots_at_submit 与 expected_n_shots |
+| labs_wait | 等待 pending run（可超时）；若是协议则收尾：postprocess → finish 写回 → restore |
+| labs_abort | 中止当前提交（不排队，不会被 labs_wait 堵住） |
+| labs_data | 读 run 目录 HDF5：首发 globals、按扫描轴的逐发表格 |
+| labs_protocol | list / show / run YAML 固定操作协议 |
+| labs_restore | 用最近一次写前快照恢复面板（默认只恢复该次写过的键） |
+
+配套 runtime skill（labscript）：先看现场、稳定流程优先用协议、提交后可以结束回合、
+同一时间只跑一个、不猜面板状态；新装或报配置错误时先跑 labs_doctor。
+
+## 安装与配置
+
+- 要求：DSH >= 0.2、Node ^22.19/24；Python >= 3.9。mock 模式只要 numpy+h5py；
+  真机用 labscript-suite 环境。详见 docs/INSTALL.zh.md。
+- 默认 backend 是 mock-labscript；真机必须显式配置 backend: labscript。
+- 安装后在 DSH 插件页填 backend、python、runmanager host/port、protocolsDir；
+  其余高级配置（scriptsFile、hard limits、postprocess、approval、pathMap）写在
+  profile 的 cordis.patch.yml。
+
+## 协议 YAML
+
+    name: demo_scan
+    labscript: /path/to/sequence.py     # 或 joint_script: 登记名
+    set: { do_acquire: true, amplitude: 0.5 }
+    scan: { duration_test_us: np.linspace(0, 8.0, 5) }   # 表达式/数字/列表
+    reps: 2
+    postprocess: demo.peaks              # 全局配置一次，协议里只写名字
+    finish:
+      restore: true
+      panel:  { duration_test_us: fit.center }
+      history: { demo.peaks.center_us: fit.center }
+
+postprocess 是后处理：跑完后调用配置的 Python 函数（entry + pythonPaths），
+返回 dict 供 finish 写回。旧协议里的 analysis: 字段当作 postprocess 别名。
+
+## 边界
+
+- 真机 engage / protocol run 会请求 DSH 审批（一次），abort 和面板写入不请求；
+  插件不是硬件联锁。
+- labscript abort 只停止编译/提交新的 shot，已进 BLACS 队列或正在跑的 shot 不会被停。
+- 完成判定基于 HDF5 数量、大小稳定和最后一发可读；BLACS paused 会报
+  compiled_not_executed 诊断。
+

package/examples/config.example.yml

@@ -0,0 +1,33 @@
+# Two ways to configure dsh-labscript in a DSH profile.
+#
+# 1) Hardware-free development / examples (built-in simulator):
+- id: dsh-labscript
+  name: dsh-labscript
+  config:
+    python: /path/to/python3
+    backend: mock-labscript
+    protocolsDir: /path/to/your/protocols
+    mock:
+      stateDir: ~/.dsh-labscript/mock
+    postprocess:
+      entry: postprocess_demo:analyze
+      pythonPaths: [/path/to/dsh-labscript/examples]
+
+# 2) Real labscript-suite (adjust host/port to your runmanager):
+# - id: dsh-labscript
+#   name: dsh-labscript
+#   config:
+#     python: /path/to/labscript-suite/python
+#     backend: labscript
+#     runmanager: { host: 127.0.0.1, port: 42523, timeoutS: 10 }
+#     protocolsDir: /path/to/your/protocols
+#     scriptsFile: /path/to/scripts.json
+#     hardLimitsFile: /path/to/hard_limits.json
+#     calibrationLog: /path/to/calibration.jsonl
+#     pathMap:
+#       - { remotePrefix: "E:/Experiments", localPrefix: "//lab-pc/Experiments" }
+#     reps: { global: dummy_iterator }
+#     postprocess:
+#       entry: my_lab.analysis:analyze
+#       pythonPaths: [/path/to/my_lab]
+#     approval: { engage: true, protocolRun: true }

package/examples/postprocess_demo.py

@@ -0,0 +1,19 @@
+"""Example postprocess entry: after a run, return the numbers that finish.panel
+and finish.history write back. Replace the fake model with your lab analysis.
+
+Signature: analyze(run_folder=..., scan_global=..., reps=..., name=...)
+Returns a JSON-serializable dict.
+"""
+
+
+def analyze(run_folder, scan_global=None, reps=None, name=None):
+    # Placeholder numbers so the write-back path is demonstrable end to end.
+    return {
+        "fit": {"center": 2.5, "pi_duration_us": 1.25, "r2": 0.99},
+        "meta": {
+            "run_folder": run_folder,
+            "scan_global": scan_global,
+            "reps": reps,
+            "name": name,
+        },
+    }

package/examples/protocols/demo_scan.yaml

@@ -0,0 +1,18 @@
+# Demo fixed-operation protocol. It runs against the built-in mock-labscript
+# backend without hardware; replace labscript with your sequence path and the
+# panel keys with your own globals for real experiments.
+name: demo_scan
+labscript: /path/to/your/sequence.py
+set:
+  do_acquire: true
+  amplitude: 0.5
+scan:
+  duration_test_us: np.linspace(0.0, 8.0, 5)
+reps: 2
+postprocess: demo.peaks
+finish:
+  restore: true
+  panel:
+    duration_test_us: fit.center
+  history:
+    demo.peaks.center_us: fit.center

package/lib/client.js

@@ -0,0 +1,193 @@
+/**
+ * dsh-labscript -- browser half.
+ *
+ * A pre-built client bundle: DSH serves it as-is and expects the
+ * window.__ModuleLoader__.load({ id, factory }) wrapper. It registers one small
+ * configuration page into the official Plugins page (plugins.bundle.config).
+ * The page only edits backend, python, runmanager host/port and protocolsDir;
+ * everything else stays in the profile config. It talks to this plugin's own
+ * routes under /dsh-labscript/api (GET/POST config, POST doctor).
+ */
+window.__ModuleLoader__.load({
+  id: 'dsh-labscript',
+  factory: (require) => {
+    const module = { exports: {} }
+    const exports = module.exports
+    Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' })
+
+    const React = require('react')
+    const h = React.createElement
+    const { useEffect, useState } = React
+
+    const API = '/dsh-labscript/api'
+    const STYLE_ID = 'dsh-labscript/plugin-config.css'
+
+    const CSS = [
+      '.lsc{max-width:720px;display:flex;flex-direction:column;gap:12px;font-size:13px;line-height:20px}',
+      '.lsc-section{border:1px solid #d9d9d9;border-radius:8px;padding:12px;display:flex;flex-direction:column;gap:8px}',
+      '.lsc-section h3{margin:0;font-size:14px;font-weight:600}',
+      '.lsc-row{display:flex;flex-direction:column;gap:4px}',
+      '.lsc label{font-weight:500}',
+      '.lsc input,.lsc select{width:100%;box-sizing:border-box;padding:6px 8px;border-radius:6px;border:1px solid #d9d9d9;background:#fff;color:inherit;font:inherit}',
+      '.lsc .hint{color:#8a8a8a;font-size:12px;line-height:18px}',
+      '.lsc-actions{display:flex;gap:8px;flex-wrap:wrap;align-items:center}',
+      '.lsc button{padding:5px 12px;border-radius:6px;border:1px solid #d9d9d9;background:#f5f5f5;color:inherit;cursor:pointer;font:inherit}',
+      '.lsc button.primary{background:#2b6cb0;border-color:transparent;color:#fff}',
+      '.lsc button:disabled{opacity:.55;cursor:not-allowed}',
+      '.lsc-msg{padding:8px 10px;border-radius:6px;white-space:pre-wrap;font-size:12px;line-height:18px}',
+      '.lsc-msg.ok{background:rgba(22,163,74,.1);color:#16a34a}',
+      '.lsc-msg.err{background:rgba(220,38,38,.1);color:#dc2626}',
+      '.lsc-check{display:flex;gap:8px;font-size:12px;line-height:18px}',
+      '.lsc-check b{min-width:88px;font-weight:600}',
+      '.lsc-check.ok b{color:#16a34a}',
+      '.lsc-check.warn b{color:#ea580c}',
+      '.lsc-check.fail b{color:#dc2626}',
+    ].join(String.fromCharCode(10))
+
+    function ensureStyle() {
+      if (document.getElementById(STYLE_ID) !== null) return
+      const style = document.createElement('style')
+      style.id = STYLE_ID
+      style.textContent = CSS
+      document.head.appendChild(style)
+    }
+
+    async function apiFetch(path, options) {
+      const response = await fetch(API + path, Object.assign({ headers: { 'Content-Type': 'application/json' } }, options || {}))
+      let payload
+      try {
+        payload = await response.json()
+      } catch (error) {
+        throw new Error('接口返回了非 JSON 内容（HTTP ' + response.status + '）')
+      }
+      if (!response.ok || payload.ok === false) throw new Error(payload.error || ('请求失败（HTTP ' + response.status + '）'))
+      return payload
+    }
+
+    function Row(props) {
+      return h('div', { className: 'lsc-row' },
+        h('label', null, props.label),
+        props.children,
+        props.hint === undefined ? null : h('span', { className: 'hint' }, props.hint),
+      )
+    }
+
+    function ConfigPage() {
+      const [loading, setLoading] = useState(true)
+      const [configFile, setConfigFile] = useState('')
+      const [version, setVersion] = useState('')
+      const [backend, setBackend] = useState('mock-labscript')
+      const [python, setPython] = useState('')
+      const [host, setHost] = useState('127.0.0.1')
+      const [port, setPort] = useState(42523)
+      const [protocolsDir, setProtocolsDir] = useState('')
+      const [busy, setBusy] = useState('')
+      const [message, setMessage] = useState(null)
+      const [checks, setChecks] = useState(null)
+
+      const load = async () => {
+        setLoading(true)
+        try {
+          const payload = await apiFetch('/config')
+          setVersion(payload.version || '')
+          setConfigFile(payload.configFile || '')
+          const current = payload.config || {}
+          setBackend(current.backend || 'mock-labscript')
+          setPython(current.python || '')
+          setHost((current.runmanager && current.runmanager.host) || '127.0.0.1')
+          setPort((current.runmanager && current.runmanager.port) || 42523)
+          setProtocolsDir(current.protocolsDir || '')
+        } catch (error) {
+          setMessage({ kind: 'err', text: error.message })
+        } finally {
+          setLoading(false)
+        }
+      }
+
+      useEffect(() => {
+        ensureStyle()
+        load()
+      }, [])
+
+      const save = async () => {
+        setBusy('save')
+        setMessage(null)
+        try {
+          await apiFetch('/config', {
+            method: 'POST',
+            body: JSON.stringify({
+              backend,
+              python,
+              runmanager: { host, port: Number(port) },
+              protocolsDir,
+            }),
+          })
+          setMessage({ kind: 'ok', text: '已保存；下一次工具调用生效，不需要重启。' })
+        } catch (error) {
+          setMessage({ kind: 'err', text: error.message })
+        } finally {
+          setBusy('')
+        }
+      }
+
+      const doctor = async () => {
+        setBusy('doctor')
+        setMessage(null)
+        setChecks(null)
+        try {
+          const payload = await apiFetch('/doctor', { method: 'POST', body: '{}' })
+          setChecks(payload.checks || [])
+        } catch (error) {
+          setMessage({ kind: 'err', text: error.message })
+        } finally {
+          setBusy('')
+        }
+      }
+
+      const checkRows = (checks || []).map((check, index) => h('div', { key: index, className: 'lsc-check ' + check.status },
+        h('b', null, check.status),
+        h('span', null, check.name + ': ' + check.detail + (check.hint ? '  -- ' + check.hint : '')),
+      ))
+
+      return h('div', { className: 'lsc' },
+        h('div', null, h('h3', null, 'dsh-labscript'), h('span', { className: 'hint' }, 'v' + version + (configFile ? '  ·  ' + configFile : ''))),
+        h('section', { className: 'lsc-section' },
+          h('h3', null, '连接'),
+          h(Row, { label: 'backend' },
+            h('select', { value: backend, onChange: (event) => setBackend(event.target.value) },
+              h('option', { value: 'mock-labscript' }, 'mock-labscript（模拟器）'),
+              h('option', { value: 'labscript' }, 'labscript（真实硬件）'),
+            ),
+          ),
+          h(Row, { label: 'python', hint: '真机填 labscript-suite 环境的 python；模拟器只需 numpy+h5py。' }, h('input', { type: 'text', value: python, onChange: (event) => setPython(event.target.value) })),
+          h(Row, { label: 'runmanager host' }, h('input', { type: 'text', value: host, onChange: (event) => setHost(event.target.value) })),
+          h(Row, { label: 'runmanager port' }, h('input', { type: 'number', value: port, onChange: (event) => setPort(event.target.value) })),
+        ),
+        h('section', { className: 'lsc-section' },
+          h('h3', null, '实验'),
+          h(Row, { label: 'protocolsDir', hint: '协议 YAML 目录；留空则协议列表为空。' }, h('input', { type: 'text', value: protocolsDir, onChange: (event) => setProtocolsDir(event.target.value) })),
+          h('span', { className: 'hint' }, 'scriptsFile、hard limits、postprocess、approval、pathMap 等高级配置仍写在 profile 的 cordis.patch.yml。'),
+        ),
+        h('div', { className: 'lsc-actions' },
+          h('button', { className: 'primary', disabled: loading || busy !== '', onClick: save }, busy === 'save' ? '保存中…' : '保存'),
+          h('button', { disabled: loading || busy !== '', onClick: doctor }, busy === 'doctor' ? '诊断中…' : '运行诊断'),
+        ),
+        message === null ? null : h('div', { className: 'lsc-msg ' + message.kind }, message.text),
+        checks === null ? null : h('div', { className: 'lsc-section' }, h('h3', null, '诊断结果'), checkRows),
+      )
+    }
+
+    function apply(ctx) {
+      ctx.effect(
+        () => ctx.slots.inject('plugins.bundle.config', () =>
+          ctx.slots.register({ name: 'plugins.bundle.config', key: 'dsh-labscript' }, ConfigPage)),
+        'dsh-labscript: plugin configuration page',
+      )
+    }
+
+    exports.apply = apply
+    exports.inject = ['slots']
+    exports.ConfigPage = ConfigPage
+    return module.exports
+  },
+})