dsh-router-laya 2.1.0

package/LICENSE

@@ -0,0 +1,176 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS

package/NOTICE

@@ -0,0 +1,19 @@
+dsh-router-laya
+Copyright 2026 the dsh-router-laya authors
+
+This product includes software developed as part of the dsh-router-laya project
+and its development repository HapyRain/layaDemo, licensed under the Apache License, Version 2.0.
+
+This product vendored and redistributes, in unmodified form, portions of the following
+third-party projects, both licensed under the Apache License, Version 2.0:
+
+  * convaiinnovations/laya -- https://huggingface.co/convaiinnovations/laya
+      Vendored as service/laya/ (package source, laya 0.3.7, carrying the 7-question routing
+      protocol this plugin's finetuned checkpoint was trained for).
+
+  * answerdotai/ModernBERT-large -- https://huggingface.co/answerdotai/ModernBERT-large
+      The encoder backbone of the fine-tuned judge checkpoint (laya-router-7q) that
+      weights/fetch.mjs downloads; its weights are embedded in model.safetensors.
+
+The fine-tuned checkpoint itself (laya-router-7q) is a derivative work of the two projects
+above and is likewise distributed under the Apache License, Version 2.0.

package/README.md

@@ -0,0 +1,108 @@
+# dsh-router-laya
+
+一个 DSH 插件：对没有明确档位指令的消息，自动选择思考档（low / high / max）。
+
+做法是在本地跑一个微调过的分类模型（842MB，CPU 推理不到 1 秒），配合会话内的重试检测自动升档。
+判定服务挂了会自动降级，任务文本不出本机。
+
+## 为什么做它——以及为什么值得你试试
+
+你大概也有同感：想让 AI 在难题上多想一会儿，就得手动把档位拉满；而大多数日常消息，
+拉满纯属浪费——多烧的 token 换不来更好的回答，来回手动切又麻烦，忘了切就一直烧。
+
+这件事不是我们拍脑袋，业界已经有定论：
+
+- **DeepSeek 的 V3.2 技术报告专门写了这个机制**（thinking budget）：模型训练时就按
+  「在给定的思考 token 预算内最大化准确率」来优化，报告里附了不同预算下的性能曲线。
+  所谓档位，对应的其实就是这份预算——档位高，能思考的 token 多，消耗也大。
+- **OpenAI 的 o3-mini 直接按 low/medium/high 三档发布官方成绩**：低档在多数任务上已经够用，
+  高档只在高难任务上拉开差距（[官方公告](https://openai.com/index/o3-mini/)）。
+- **《Thoughtology》综述对 R1 系模型的测量**：强模型的准确率随思考预算增长很快饱和，
+  大多数任务用不满大预算，多出来的基本是白烧。
+- Qwen3 的按请求预算、Anthropic 的 budget_tokens、LangChain 的 reasoning_effort——
+  「档位 ≈ 思考 token 预算帽」已经是行业通行的实现。
+
+既然档位是真实存在的旋钮，问题只剩一个：**谁来判断该拧到几档？** 手动切麻烦，全局拉满浪费。
+dsh-router-laya 把这个判断交给一个本地小模型：它先看一眼你的消息，决定需要多少思考，
+再把请求路由到合适的档位——你只管发消息。具体来说：
+
+- **省钱**：简单消息走 low，思考 token 只有拉满时的零头，不再为简单问题支付推理成本
+- **快**：低档首字响应更快；本地判定不到 1 秒，无感
+- **难事不掉链子**：任务复杂或你在重试时自动升档，max 兜底
+- **隐私**：判定模型本地跑，任务文本不出本机
+- **越用越准**：判定模型可以随你的使用习惯持续重训
+
+我们另做了 120 多次本地对照实验交叉验证，方向与公开结论一致：单任务 low 档约 96% 成功
+（确实不必多花钱）；15 个任务连吃 low 档 42% 翻车、升档后约 17%——这就是这个插件要吃的
+那一段：
+
+![会话失败率 vs 任务数](docs/charts/chart-why.svg)
+
+负责判断的 7 题微调分类头，对金标（三模型交叉标注）一致率 99%、本地判定不到 1 秒：
+
+![判定质量](docs/charts/chart-accuracy.svg)
+
+会话内自动升档的实测阶梯——重试两轮，low 到 max：
+
+![升档实测](docs/charts/chart-ladder.svg)
+
+输入栏有个档位芯片，实时显示当前档位和最近 20 轮的判断原因；服务离线时变灰并给出启动命令。
+
+## 安装
+
+```bash
+npm i -g dsh-router-laya
+npx dsh-router-laya setup
+```
+
+setup 做三件事：建 Python 虚拟环境、下载 846MB 的 checkpoint（走本仓 GitHub Release，
+HF 和镜像做兜底，支持断点续传）、启动判定服务。然后按它打印的 snippet 在你的 DSH profile
+里注册插件行，设两个环境变量：
+
+```
+ROUTEEXP_ARM=auto
+ROUTEEXP_RESPECT_EXPLICIT=1
+```
+
+要求：Node ≥ 18，Python ≥ 3.10，约 2GB 磁盘。判定服务需要常驻（setup 会启动，重启机器后
+重跑 `npx dsh-router-laya setup` 或 service 里的启动脚本）。
+
+## 它怎么决定档位
+
+按顺序过四层，任何一层命中就停：
+
+1. 词典意图：「用最高档」→ 直接定档（一票否决）；「继续」→ 保持上轮；「别用 max」→ 记一个约束
+2. 微调模型：7 个布尔题（副作用 / 跨模块 / 步骤依赖 / 深推理 / 代码 / 生成 / 会话复利）→ 规则引擎出档
+3. 升级：这轮消息是上一轮的重试 → 沿阶梯升一级
+4. 约束过滤：第 1 层记下的约束最后统一执行
+
+失败路径：判定服务不可达 → 落 low，会话不断。
+
+## 已知边界
+
+- 判定耗时 1–3 秒，计入每轮首字延迟
+- 服务需要常驻进程；DSH 大版本更新可能改动前端注入缝，client.js 需要跟着适配
+- 权重下载在国内网络走镜像兜底，首次 846MB
+
+## 数据与复现
+
+README 里的图由 `scripts/make_charts.py`（纯 stdlib）从实测数据生成，CI 会检查图表是否过期。
+实验全记录（试筛、判读规则、标注方案、验收数据）在主开发仓
+[HapyRain/layaDemo](https://github.com/HapyRain/layaDemo) 的 docs/ 目录。
+
+## 写在最后
+
+这个插件目前还在尝试阶段，有不少没做完的地方。当前实现的判断逻辑，针对日常使用是够用的；
+如果你要把它用在大项目、高难度任务，或者对识别率有更高要求，建议基于你自己的使用习惯重新
+微调一版模型——标注、训练、验收的整条链都是现成的（见上面的数据与复现），换一批你自己的
+语料就能重训，本机有 GPU 的话几分钟一轮。
+
+我自己后面有精力的话，也会再用新语料把 Laya 重新微调一版。这次做得比较仓促，见谅。
+
+这本身只是一个小思路。哪里不对、哪里可以更好，欢迎在 GitHub Issues 里提，我都会看。
+
+## License
+
+本项目代码为 Apache-2.0。判定模型基于 [convaiinnovations/laya](https://huggingface.co/convaiinnovations/laya)
+与 [answerdotai/ModernBERT-large](https://huggingface.co/answerdotai/ModernBERT-large) 两个
+Apache-2.0 项目微调而来，按协议要求在 [NOTICE](./NOTICE) 中署名，在此向两个上游项目致谢。

package/bin/setup.mjs

@@ -0,0 +1,297 @@
+#!/usr/bin/env node
+/**
+ * `npx dsh-router-laya setup` -- one-shot bootstrap for the judge service the plugin routes with.
+ *
+ * Four steps, fail-fast, each with a fix hint, and safe to re-run (idempotent):
+ *
+ *   a. python >= 3.10 -> create `.venv-router` -> pip install -r service/requirements.lock.txt
+ *   b. node weights/fetch.mjs              (the ~846 MB checkpoint; --skip-weights to skip)
+ *   c. print the plugin registration guide (profiles found, verbatim patch snippet, env vars)
+ *   d. start the judge service and wait for /health (reuses service/start_router.*)
+ *
+ * It deliberately does NOT edit any cordis/profile config: step c prints the exact snippet for
+ * the user to paste (docs/marketplace-review.md §4 -- an installer that rewrites the user's patch
+ * file is how that file rotted twice before, docs/HANDOFF-20260925.md §5.1).
+ *
+ * Flags:
+ *   --dry-run       print every step's plan, execute nothing (python probe and reads aside)
+ *   --skip-weights  skip step b (weights already in place, or served another way)
+ *   --skip-venv     skip step a entirely (no venv, no pip; launch uses LAYA_PYTHON/PATH python)
+ *   --help          this text
+ *
+ * Environment: LAYA_PYTHON, LAYA_DEVICE, LAYA_ROUTER_URL (port the service binds), HF_ENDPOINT,
+ * LAYA_START_TIMEOUT (health-wait seconds passed to the launcher, default 180 here -- CPU cold
+ * loads take ~70s, and the launcher's own default of 60s is tuned for the warm dev flow).
+ */
+import { spawnSync } from 'node:child_process';
+import fs from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = path.dirname(fileURLToPath(import.meta.url)); // <package>/bin
+const pkg = path.dirname(here);
+const VENV_DIR = path.join(pkg, '.venv-router');
+const LOCK_FILE = path.join(pkg, 'service', 'requirements.lock.txt');
+const FETCH_SCRIPT = path.join(pkg, 'weights', 'fetch.mjs');
+const SERVICE_SCRIPT = path.join(pkg, 'service', 'laya_router.py');
+
+const args = process.argv.slice(2);
+const dryRun = args.includes('--dry-run');
+const skipWeights = args.includes('--skip-weights');
+const skipVenv = args.includes('--skip-venv');
+const help = args.includes('--help') || args.includes('-h');
+
+if (help) {
+  console.log(`usage: npx dsh-router-laya setup [--dry-run] [--skip-weights] [--skip-venv]
+
+  a. python >= 3.10 -> .venv-router -> pip install -r service/requirements.lock.txt
+  b. node weights/fetch.mjs           (checkpoint download, ~846 MB, resumable, sha256-verified)
+  c. print plugin registration guide  (no config is edited -- the snippet is for you to paste)
+  d. start the judge service + /health poll
+
+env: LAYA_PYTHON, LAYA_DEVICE, LAYA_ROUTER_URL (default http://127.0.0.1:8765/judge),
+     HF_ENDPOINT, LAYA_START_TIMEOUT (default 180s for this script's cold-start path)`);
+  process.exit(0);
+}
+
+function fail(step, message, hint) {
+  console.error(`\n[setup] step ${step} FAILED: ${message}`);
+  if (hint) console.error(`[setup] fix: ${hint}`);
+  process.exit(1);
+}
+
+function note(message) {
+  console.log(`[setup] ${message}`);
+}
+
+// ── step a: python + venv + pinned requirements ──────────────────────────────────────────────
+
+function pythonCandidates() {
+  const cands = [];
+  if (process.env.LAYA_PYTHON) cands.push({ cmd: process.env.LAYA_PYTHON, base: [] });
+  if (process.platform === 'win32') cands.push({ cmd: 'py', base: ['-3'] });
+  cands.push({ cmd: 'python3', base: [] }, { cmd: 'python', base: [] });
+  return cands;
+}
+
+function probePython(cand) {
+  const code = 'import sys; print(".".join(map(str, sys.version_info[:3]))); print(sys.executable)';
+  const r = spawnSync(cand.cmd, [...cand.base, '-c', code], { encoding: 'utf8', timeout: 15000 });
+  if (r.status !== 0 || !r.stdout) return null;
+  const [version, exe] = r.stdout.trim().split(/\r?\n/);
+  const parts = version.split('.').map((n) => parseInt(n, 10));
+  if (parts.length < 2 || parts.some(Number.isNaN)) return null;
+  return { version, exe: exe || cand.cmd, major: parts[0], minor: parts[1] };
+}
+
+const venvPython = process.platform === 'win32'
+  ? path.join(VENV_DIR, 'Scripts', 'python.exe')
+  : path.join(VENV_DIR, 'bin', 'python');
+
+function stepA() {
+  console.log('\n== step a: python >= 3.10 + .venv-router + pinned requirements ==');
+  if (skipVenv) {
+    note('--skip-venv: not creating a venv; launch will use LAYA_PYTHON or PATH python.');
+    return;
+  }
+
+  let probe = null;
+  for (const cand of pythonCandidates()) {
+    probe = probePython(cand);
+    if (probe) {
+      note(`python ${probe.version} at ${probe.exe}`);
+      break;
+    }
+  }
+  if (!probe) {
+    fail('a', 'no usable python interpreter found',
+      'install Python 3.10-3.13 from python.org (3.12 recommended) and re-run; '
+      + 'or point LAYA_PYTHON at an existing interpreter');
+  }
+  if (probe.major < 3 || (probe.major === 3 && probe.minor < 10)) {
+    fail('a', `python ${probe.version} is too old (need >= 3.10, 3.12 recommended)`,
+      'install a newer Python from python.org, or point LAYA_PYTHON at one');
+  }
+
+  if (fs.existsSync(venvPython)) {
+    note(`venv already exists: ${VENV_DIR}`);
+  } else {
+    note(`creating venv: ${probe.exe} -m venv ${VENV_DIR}`);
+    if (!dryRun) {
+      const r = spawnSync(probe.exe, [...probe.base, '-m', 'venv', VENV_DIR], { stdio: 'inherit' });
+      if (r.status !== 0 || !fs.existsSync(venvPython)) {
+        fail('a', `venv creation exited ${r.status}`,
+          'on Debian/Ubuntu install python3-venv first; then re-run setup');
+      }
+    }
+  }
+
+  // The marker records the lock file's mtime, so editing requirements.lock.txt invalidates it.
+  const marker = path.join(VENV_DIR, '.laya-reqs-ok');
+  const lockStamp = String(fs.statSync(LOCK_FILE).mtimeMs);
+  if (fs.existsSync(marker) && fs.readFileSync(marker, 'utf8') === lockStamp) {
+    note('requirements already installed (marker matches requirements.lock.txt)');
+    return;
+  }
+  const pipCmd = `${venvPython} -m pip install -r ${LOCK_FILE}`;
+  note(pipCmd);
+  if (!dryRun) {
+    const r = spawnSync(venvPython, ['-m', 'pip', 'install', '-r', LOCK_FILE], { stdio: 'inherit' });
+    if (r.status !== 0) {
+      fail('a', `pip install exited ${r.status}`,
+        'check the pip output above (proxy? disk space?); GPU users: swap the torch line in '
+        + 'service/requirements.lock.txt for a CUDA wheel, then re-run');
+    }
+    fs.writeFileSync(marker, lockStamp);
+  }
+}
+
+// ── step b: checkpoint download ───────────────────────────────────────────────────────────────
+
+function stepB() {
+  console.log('\n== step b: judge checkpoint (~846 MB, once) ==');
+  if (skipWeights) {
+    note('--skip-weights: leaving weights/ as-is.');
+    return;
+  }
+  const manifest = JSON.parse(fs.readFileSync(path.join(pkg, 'weights', 'manifest.json'), 'utf8'));
+  note(`repo ${manifest.repo}@${manifest.revision}, ${manifest.files.length} files, `
+    + `${(manifest.totalBytes / 1e6).toFixed(0)} MB into weights/model/`);
+  note('endpoints: $HF_ENDPOINT (if set) -> https://huggingface.co -> https://hf-mirror.com');
+  if (!dryRun) {
+    const r = spawnSync(process.execPath, [FETCH_SCRIPT], { stdio: 'inherit' });
+    if (r.status !== 0) {
+      fail('b', `weights fetch exited ${r.status}`,
+        'set HF_ENDPOINT to a reachable mirror and re-run; or place the files into '
+        + 'weights/model/ by hand (names + sha256 in weights/manifest.json)');
+    }
+  }
+}
+
+// ── step c: registration guide (read-only; prints, never edits) ──────────────────────────────
+
+function servicePythonForSnippet() {
+  if (fs.existsSync(venvPython)) return venvPython;
+  if (process.env.LAYA_PYTHON) return process.env.LAYA_PYTHON;
+  const probe = pythonCandidates().map(probePython).find(Boolean);
+  return probe ? probe.exe : '<python>';
+}
+
+function stepC() {
+  console.log('\n== step c: register the plugin (guidance only -- nothing is edited) ==');
+  const profilesDir = path.join(os.homedir(), '.dsh', 'profiles');
+  if (fs.existsSync(profilesDir)) {
+    const profiles = fs.readdirSync(profilesDir, { withFileTypes: true })
+      .filter((d) => d.isDirectory()).map((d) => d.name);
+    note(`profiles under ${profilesDir}: ${profiles.length ? profiles.join(', ') : '(none)'}`);
+    note("each profile's module root is ~/.dsh/profiles/<name>/node_modules -- register there.");
+  } else {
+    note(`no profiles directory at ${profilesDir} -- run 'dsh' once to create one, then re-run.`);
+  }
+  const py = servicePythonForSnippet();
+  // Single-quoted YAML scalars treat backslashes literally -- emit Windows paths verbatim.
+  console.log(`
+Paste this row into the profile's cordis patch (verbatim; only add, never rewrite the file):
+
+    - insert:
+        - id: router-laya
+          name: 'dsh-router-laya'
+          config:
+            auto: true
+            servicePython: '${py}'
+            serviceScript: '${SERVICE_SCRIPT}'
+
+`);
+  note('servicePython/serviceScript above let the plugin auto-start the judge (config.autoStart '
+    + 'defaults on; set autoStart: false to opt out).');
+  note('environment switches, read by the plugin at apply() time (a row config cannot set them):');
+  note('  ROUTEEXP_ARM=auto              -- enables auto mode when the row omits `auto: true`');
+  note('  ROUTEEXP_RESPECT_EXPLICIT=1    -- requests with an explicit effort keep it (recommended)');
+}
+
+// ── step d: start the service + /health poll ──────────────────────────────────────────────────
+
+function judgeBase() {
+  const raw = process.env.LAYA_ROUTER_URL || 'http://127.0.0.1:8765/judge';
+  return String(raw).replace(/\/judge\/?$/, '');
+}
+
+async function healthOk(base, timeoutMs = 2000) {
+  try {
+    const res = await fetch(`${base}/health`, { signal: AbortSignal.timeout(timeoutMs) });
+    if (!res.ok) return null;
+    const info = await res.json();
+    return info && info.protocol === 'finetuned' ? info : null;
+  } catch {
+    return null;
+  }
+}
+
+async function stepD() {
+  console.log('\n== step d: judge service + /health ==');
+  const base = judgeBase();
+  const port = new URL(base).port || '80';
+  const launcher = process.platform === 'win32'
+    ? { cmd: 'powershell.exe', args: ['-NoProfile', '-ExecutionPolicy', 'Bypass', '-File',
+        path.join(pkg, 'service', 'start_router.ps1'), '-Port', port] }
+    : { cmd: 'bash', args: [path.join(pkg, 'service', 'start_router.sh'), '--port', port] };
+  const env = { ...process.env, LAYA_START_TIMEOUT: process.env.LAYA_START_TIMEOUT || '180' };
+
+  if (dryRun) {
+    note(`dry-run: would probe ${base}/health, then run:`);
+    console.log(`    ${launcher.cmd} ${launcher.args.join(' ')}`);
+    note(`then poll ${base}/health (protocol must be "finetuned").`);
+    return;
+  }
+
+  const up = await healthOk(base);
+  if (up) {
+    note(`already up at ${base} (protocol=finetuned, model=${up.model})`);
+    return;
+  }
+
+  note(`starting via ${path.basename(launcher.cmd)} launcher on :${port} ...`);
+  const r = spawnSync(launcher.cmd, launcher.args, { stdio: 'inherit', env });
+  if (r.error && r.error.code === 'ENOENT') {
+    fail('d', `${launcher.cmd} not found`,
+      process.platform === 'win32'
+        ? 'run powershell -File service/start_router.ps1 manually'
+        : 'install bash, or run: LAYA_PYTHON=<python> bash service/start_router.sh');
+  }
+  if (r.status !== 0) {
+    fail('d', `launcher exited ${r.status}`,
+      `read the service log (%TEMP%/laya-router-service.err.log or /tmp/laya-router-service.err.log); `
+      + 'a missing checkpoint or a broken pip install shows up here');
+  }
+
+  // The launcher already waited for /health; this re-probe is belt and braces for detached starts.
+  const deadline = Date.now() + 15000;
+  let info = null;
+  while (Date.now() < deadline) {
+    info = await healthOk(base, 1000);
+    if (info) break;
+    await new Promise((resolve) => setTimeout(resolve, 500));
+  }
+  if (!info) {
+    fail('d', `${base}/health never answered with protocol=finetuned`,
+      'check the service log paths printed by the launcher');
+  }
+  note(`judge ready: ${base} (protocol=finetuned, model=${info.model})`);
+}
+
+// ── run ---------------------------------------------------------------------------------------
+
+console.log(`dsh-router-laya setup -- package root: ${pkg}`);
+if (dryRun) note('--dry-run: probing and printing only, nothing will be installed or started.');
+
+stepA();
+stepB();
+stepC();
+await stepD();
+
+console.log('\n== setup done ==');
+note('after registering the plugin row, restart dsh once (bundle layer needs a reboot, '
+  + 'patchReload only covers the user patch layer).');
+note('sanity check: curl the /health URL printed above, then send a message and look for '
+  + "[router-laya] turn 1 auto ... -> low (laya) on the plugin's stderr.");