dsh-labscript 0.2.0 → 0.2.1

package/docs/README.zh.md

@@ -1,57 +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 诊断。
-
+# 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

@@ -1,33 +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 }
+# 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

@@ -1,19 +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,
-        },
-    }
+"""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

@@ -1,18 +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
+# 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

@@ -1,193 +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
-  },
-})
+/**
+ * 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
+  },
+})