dsh-skill-tag 0.1.16 → 0.1.18

package/README.md

@@ -355,7 +355,7 @@ npm test          # 194 项
 界面预览可以在没有浏览器扩展时生成静态 HTML：
 
 ```bash
-node docs/preview/render-preview.mjs     # → docs/preview/标签组配置-preview.html
+node dev/preview/render-preview.mjs      # → dev/preview/标签组配置-preview.html
 ```
 
 （产物已在 `.gitignore` 里排除。）

package/docs//345/257/271/350/257/235/347/256/241/347/220/206/346/240/207/347/255/276.md

@@ -472,17 +472,17 @@ ctx.on("domain/changed", (change) => {
 
 ## 7.5 界面预览
 
-`docs/preview/` 下的预览图由 `render-conv-preview.mjs` 用**真实组件**渲染生成
+`dev/preview/` 下的预览图由 `render-conv-preview.mjs` 用**真实组件**渲染生成
 （迷你 React 运行时执行 `lib/client.js` 的 `ManageTagsDialog` / `TagSettingsDialog`，
 再序列化成 HTML，用 headless Edge 截图），与线上界面同源：
 
-- `docs/preview/对话管理标签-preview.html` — 完整预览页（3 个场景）
-- `docs/preview/conv-manage-shot.png` — 截图
+- `dev/preview/对话管理标签-preview.html` — 完整预览页（3 个场景）
+- `dev/preview/conv-manage-shot.png` — 截图
 
 重新生成：
 
 ```bash
-node docs/preview/render-conv-preview.mjs
+node dev/preview/render-conv-preview.mjs
 ```
 
 场景：①已继承工作区 ②未继承（独立配置）③对话版「tag 设置」载入标签组后可继续编辑。

package/docs//346/212/200/350/203/275/345/217/221/347/216/260/344/270/216/345/256/277/344/270/273/345/257/271/351/275/220.md

@@ -181,6 +181,20 @@ tagging-skills 那 17 个长期漏网的原因（详见 `deny-shadow-覆盖率.m
 再发 —— 一个不合法候选会让**整个** `provider.list()` 抛错，宿主随即丢弃本插件的
 全部贡献（日志 `skill provider "skill-tag" skipped`），比漏一个更糟。
 
+**两段都要校验（2026-11-12，issue #6）**。上面这条当时只堵了「`denied` 里看不见
+的名字」那一段，**看得见的**那一段（照抄上游 summary）一直没校验，于是扫盘带进来的
+脏名字能原样发出去。触发链：`src/skill-scan.js` 把技能根下裸放的 `README-官方技能说明.md`
+当成技能（名字取文件名去 `.md`）→ 进 universe → `denied = universe − visible` 里也有它 →
+第一段照抄发射 → 宿主 `validateCandidate` 抛错 → **所有对话**每轮都失败，报
+`returned invalid skill name`。
+
+现在两层纵深防御：
+
+- `src/skill-scan.js`：根级裸放 `.md` **必须有 frontmatter** 才算技能，名字非 kebab-case
+  一律跳过 —— 与宿主 `discoverRoot` / `parseSkillFile` 同口径（宿主对同样的文件打的是
+  `skill file ... ignored: invalid skill name`）。
+- `lib/index.js`：第一段与第二段都过 `isSkillName()`，兜住任何别的来源漏进来的脏名字。
+
 ## 5. 约束（踩过的坑）
 
 - **cordis 服务必须声明式注入**：`export const inject` 里没有的服务，读 `ctx.xxx`

package/docs//346/240/207/347/255/276/347/273/204/351/205/215/347/275/256.md

@@ -285,13 +285,13 @@ npm test
 
 ### 6.3 界面预览（无需浏览器扩展）
 
-`docs/preview/标签组配置-preview.html` 是用**真实组件代码**渲染出来的静态页面：
-`docs/preview/render-preview.mjs` 提供一个迷你 React 运行时（`useState`/`useEffect`/`useRef`/`useCallback`），
+`dev/preview/标签组配置-preview.html` 是用**真实组件代码**渲染出来的静态页面：
+`dev/preview/render-preview.mjs` 提供一个迷你 React 运行时（`useState`/`useEffect`/`useRef`/`useCallback`），
 真的执行 `lib/client.js` 里的 `Section` 与 `TemplateGroupPage`（含 250ms 防抖校验），再把渲染树序列化成 HTML。
 
 ```bash
 cd <插件目录>
-node docs/preview/render-preview.mjs        # 重新生成 标签组配置-preview.html
+node dev/preview/render-preview.mjs         # 重新生成 标签组配置-preview.html
 ```
 
 覆盖场景：① 主页面入口　② 未选中（引导文案、无输入框）　③ 回显 `A+B*C` + 校验通过 + 解析结果

package/docs//347/256/241/347/220/206/346/240/207/347/255/276.md

@@ -255,17 +255,17 @@ NAME := 双引号字符串（名称含空格/运算符/括号时） | 裸标识
 
 ## 7.5 界面预览
 
-`docs/preview/` 下的预览图由 `render-manage-preview.mjs` 用**真实组件**渲染生成
+`dev/preview/` 下的预览图由 `render-manage-preview.mjs` 用**真实组件**渲染生成
 （迷你 React 运行时执行 `lib/client.js` 里的 `ManageTagsDialog` / `TagSettingsDialog`，
 再序列化成 HTML，用 headless Edge 截图），因此与线上界面同源、不会图文不符：
 
-- `docs/preview/管理标签-preview.html` — 完整预览页
-- `docs/preview/manage-shot.png` — 截图
+- `dev/preview/管理标签-preview.html` — 完整预览页
+- `dev/preview/manage-shot.png` — 截图
 
 重新生成：
 
 ```bash
-node docs/preview/render-manage-preview.mjs
+node dev/preview/render-manage-preview.mjs
 ```
 
 ---

package/lib/index.js

@@ -101,8 +101,15 @@ export function createFilterProvider(sessionId, upstream, denied, ensureFresh, l
 			// 还是上游那份，影子只换掉 invocation 与 provider，右列能看出"它被屏蔽了"。
 			const shadows = [];
 			const emitted = new Set();
+			const invalid = new Set();
 			for (const summary of summaries) {
 				if (!summary || !denied.has(summary.name)) continue;
+				// 看得见 ≠ 合法（2026-11-12，issue #6）：扫盘会把技能根下裸放的
+				// `README-官方技能说明.md` 这类文件当成技能，名字取文件名去 `.md`。
+				// 旧实现只在第二段校验，这一段整条照抄 → 非法名字原样发出去 →
+				// 宿主 validateCandidate 抛错 → 整个 provider 作废 → **所有对话**
+				// 报 "returned invalid skill name" 且每轮都失败。两段都必须校验。
+				if (!isSkillName(summary.name)) { invalid.add(summary.name); continue; }
 				shadows.push({
 					...summary,
 					provider: PROVIDER_NAME,
@@ -123,10 +130,9 @@ export function createFilterProvider(sessionId, upstream, denied, ensureFresh, l
 			// 修法：屏蔽是**按名字**生效的，不需要知道那名字长什么样 —— 看不见的
 			// 名字直接造一条最小合法候选，就能在近层整条覆盖上游那份。
 			let backfilled = 0;
-			const invalid = [];
 			for (const name of denied) {
 				if (emitted.has(name)) continue;
-				if (!isSkillName(name)) { invalid.push(name); continue; }
+				if (!isSkillName(name)) { invalid.add(name); continue; }
 				shadows.push({
 					name,
 					description: `[blocked by skill-tag] ${name}`,
@@ -148,8 +154,8 @@ export function createFilterProvider(sessionId, upstream, denied, ensureFresh, l
 							+ ` shadowed=${emitted.size} backfilled=${backfilled}`
 							+ `${upstream.lastDegraded === true ? " hostSnapshot=skipped(nested)" : ""}`);
 					}
-					if (invalid.length > 0) {
-						logWarn(`[skill-tag] denied names skipped (not kebab-case): ${invalid.slice(0, 8).join(", ")}`);
+					if (invalid.size > 0) {
+						logWarn(`[skill-tag] names skipped (not kebab-case): ${[...invalid].slice(0, 8).join(", ")}`);
 					}
 				} catch { /* 观测不得影响主路径 */ }
 			}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-skill-tag",
-  "version": "0.1.16",
+  "version": "0.1.18",
   "description": "给 DSH 的技能（skill）打标签，用一条布尔表达式在「工作区 / 对话」两级选出要下发给模型的技能子集",
   "type": "module",
   "main": "lib/index.js",
@@ -29,11 +29,18 @@
     "lib",
     "src",
     "skills",
-    "docs",
     "tools",
     "cordis.patch.yml",
     "README.md",
-    "LICENSE"
+    "LICENSE",
+    "docs/给技能打标签.md",
+    "docs/标签组配置.md",
+    "docs/管理标签.md",
+    "docs/对话管理标签.md",
+    "docs/技能发现与宿主对齐.md",
+    "docs/deny-shadow-覆盖率.md",
+    "docs/修复指南.md",
+    "docs/skill联系tag与打开文件夹.md"
   ],
   "dsh": {
     "bundle": {

package/src/api.js

@@ -574,16 +574,31 @@ export function createApiHandler(services, log, listSkills = null, resolveWorksp
 			if ((path === "/workspaces/push-preview" || path === "/workspaces/push") && (method === "GET" || method === "POST")) {
 				const wid = q("workspaceId");
 				if (!wid) return json(res, 400, { ok: false, error: "缺少 workspaceId" });
-				// 该工作区下的对话：宿主 sessionIds 是权威来源。
-				// resolveWorkspaceSessions 没注入时退回对话自己记录的 sourceWorkspaceId。
-				let ids = [];
+				// 该工作区下的对话：**宿主 sessionIds 是唯一权威来源**。
+				//
+				// 这里曾经无条件并入「插件表里 own.sourceWorkspaceId === wid」的行，
+				// 本意是兜住宿主列表里没有的历史会话（CHANGELOG 0.1.13）。但那个字段是
+				// **继承时刻的快照**，会话被移出工作区后不会清空，于是每一条「曾经属于
+				// 本工作区、现在不属于」的会话都永久留在下发名单里：issue #5 里本工作区
+				// 多算 1 个、StudyMate 多算 72 个，弹窗总数因此虚高。
+				//
+				// 新口径（2026-11-11，用户确认）：能拿到宿主列表就**只认宿主**；
+				// 拿不到（测试面 / 极简宿主 / 调用抛错）才退回插件自己的来源工作区记录。
+				// 注意「拿到了但是空数组」与「拿不到」必须分开：前者是「本工作区确实没有
+				// 对话」，此时退回快照会把孤儿又捞回来，等于没修。
+				let hostIds = null;
 				if (typeof resolveWorkspaceSessions === "function") {
-					try { ids = resolveWorkspaceSessions(wid) ?? []; } catch { ids = []; }
+					try {
+						const got = resolveWorkspaceSessions(wid);
+						if (Array.isArray(got)) hostIds = got;
+					} catch { hostIds = null; }
 				}
-				if (!Array.isArray(ids)) ids = [];
-				// 并入已存在的 own.sourceWorkspaceId 指向本工作区的对话（宿主列表可能不含历史会话）
-				for (const c of services._caches.conversations.values()) {
-					if (c?.own?.sourceWorkspaceId === wid) ids.push(c.conversationId);
+				let ids = hostIds ?? [];
+				if (hostIds === null) {
+					// 兜底：宿主列表拿不到时，才用对话自己记录的来源工作区收拢。
+					for (const c of services._caches.conversations.values()) {
+						if (c?.own?.sourceWorkspaceId === wid) ids.push(c.conversationId);
+					}
 				}
 				ids = [...new Set(ids.filter(Boolean))];
 

package/src/skill-scan.js

@@ -70,6 +70,17 @@ function collectRoot(dir, depth, root, out) {
 	}
 }
 
+/**
+ * 合法技能名：kebab-case，与宿主 @deepseek-ai/dsh-skill 的 SKILL_NAME 同一正则。
+ *
+ * 为什么扫描器也要过这一关（2026-11-12，issue #6）：扫描结果会进 universe，
+ * 于是 denied = universe − visible 里也会出现它；只要这个名字非法，宿主
+ * validateCandidate 就会抛错、整个 provider 作废、**所有对话**都跑不下去。
+ * 宿主自己的文件系统 provider 早就这么做了（`skill file ... ignored: invalid
+ * skill name`），自扫描必须同口径，否则插件会把宿主本来就不认的名字当成技能。
+ */
+const SKILL_NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
+
 function pushSkill(out, mdPath, root, disabled, fallbackName) {
 	let fm = null;
 	try {
@@ -77,8 +88,15 @@ function pushSkill(out, mdPath, root, disabled, fallbackName) {
 	} catch {
 		return; // unreadable file — skip
 	}
+	// 裸放的根级 .md（flat skill）与宿主同口径：**必须有 frontmatter**。
+	// 没有 frontmatter 的 .md 只是一份普通文档（README、笔记…），不是技能；
+	// 旧实现会用文件名凭空造一个技能名，正是 issue #6 的来源。
+	const isFlat = fallbackName !== undefined;
+	if (isFlat && fm === null) return;
 	const name = fm?.name || fallbackName || path.basename(path.dirname(mdPath));
 	if (!name) return;
+	// 非法名字宁可丢掉：它既进不了宿主注册表，还会炸掉整批候选。
+	if (!SKILL_NAME_RE.test(name)) return;
 	out.push({
 		name,
 		description: fm?.description ?? "",

package/docs/preview/render-conv-preview.mjs

@@ -1,327 +0,0 @@
-// 生成「对话 → 管理标签」界面的可视化预览（不依赖浏览器控制扩展）
-//
-// 做法同 render-manage-preview.mjs：用迷你 React 运行时真正执行 lib/client.js 里的
-// ManageTagsDialog（对话作用域）与 TagSettingsDialog，序列化成 HTML，再用 headless Edge 截图。
-//
-// 用法：node docs/preview/render-conv-preview.mjs
-// 产物：docs/preview/对话管理标签-preview.html
-
-import fs from "node:fs";
-import vm from "node:vm";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(HERE, "..", "..");
-const SOURCE = fs.readFileSync(path.join(ROOT, "lib", "client.js"), "utf8");
-const FRAGMENT = Symbol("Fragment");
-
-const TAGS = [
-	{ tagId: "t-a", name: "前端" },
-	{ tagId: "t-b", name: "测试" },
-	{ tagId: "t-c", name: "文档" },
-];
-const TEMPLATES = [
-	{ templateId: "tpl-1", name: "前端组", expression: "前端+测试*文档" },
-	{ templateId: "tpl-2", name: "纯后端", expression: "(前端+测试)*文档" },
-];
-const UNIVERSE = ["code-review", "tdd", "docx", "xlsx", "pdf", "webapp-testing"];
-const LINKS = [
-	{ skillId: "code-review", tagIds: ["t-a"] },
-	{ skillId: "tdd", tagIds: ["t-b"] },
-	{ skillId: "docx", tagIds: ["t-c"] },
-	{ skillId: "pdf", tagIds: ["t-c"] },
-];
-
-function makeFetcher(state) {
-	const hasFilter = () => state.expression.trim() !== "";
-	const hit = (name) => {
-		const ids = new Set((LINKS.find((l) => l.skillId === name)?.tagIds) ?? []);
-		if (!hasFilter()) return true;
-		return ids.has("t-a") || (ids.has("t-b") && ids.has("t-c"));
-	};
-	const view = () => {
-		const f = hasFilter();
-		const matched = f ? UNIVERSE.filter(hit) : UNIVERSE.slice();
-		const visible = [];
-		for (const n of matched) if (!state.disabledSkills.includes(n)) visible.push(n);
-		for (const n of state.manualSkills) if (!state.disabledSkills.includes(n) && !visible.includes(n)) visible.push(n);
-		return { hasFilter: f, matched, manual: state.manualSkills.slice(), disabled: state.disabledSkills.slice(), visible };
-	};
-	const payload = () => ({
-		ok: true,
-		conversationId: state.conversationId,
-		workspaceId: state.sourceWorkspaceId,
-		expression: state.expression,
-		config: hasFilter() ? { orTags: ["t-a"], andGroups: [{ groupId: "g1", tagIds: ["t-b", "t-c"] }] } : { orTags: [], andGroups: [] },
-		manualSkills: state.manualSkills.slice(),
-		disabledSkills: state.disabledSkills.slice(),
-		inheritedAt: state.inheritedAt,
-		sourceWorkspaceId: state.sourceWorkspaceId,
-		candidates: hasFilter() ? UNIVERSE.filter(hit) : [],
-		universe: UNIVERSE,
-		view: view(),
-	});
-	const respond = (p) => {
-		if (p === "/state") return { ok: true, tags: TAGS, skillLinks: LINKS, templates: TEMPLATES, workspaces: [], conversations: [] };
-		if (p === "/conversations/config") return payload();
-		if (p === "/conversations/inherit") {
-			// 假装工作区那份配置：前端+测试*文档 / 手动 xlsx / 禁用 pdf
-			state.expression = "前端+测试*文档";
-			state.manualSkills = ["xlsx"];
-			state.disabledSkills = ["pdf"];
-			state.sourceWorkspaceId = "ws-1";
-			state.inheritedAt = new Date().toISOString();
-			return payload();
-		}
-		if (p === "/conversations/expression") { state.expression = JSON.parse(state.lastBody ?? "{}").expression ?? ""; return { ok: true, conversation: {} }; }
-		if (p === "/conversations/skills/disable") {
-			const n = JSON.parse(state.lastBody ?? "{}").skillName;
-			state.disabledSkills.push(n);
-			state.manualSkills = state.manualSkills.filter((s) => s !== n);
-			return { ok: true, conversation: {} };
-		}
-		if (p === "/conversations/skills/enable") {
-			const n = JSON.parse(state.lastBody ?? "{}").skillName;
-			state.disabledSkills = state.disabledSkills.filter((s) => s !== n);
-			return { ok: true, conversation: {} };
-		}
-		if (p === "/conversations/skills/add") { state.manualSkills.push(JSON.parse(state.lastBody ?? "{}").skillName); return { ok: true, conversation: {} }; }
-		if (p === "/templates/validate") {
-			if (state.expression.trim() === "") {
-				return { ok: true, validation: { ok: true, errors: [], warnings: [], normalized: "", config: { orTags: [], andGroups: [] } } };
-			}
-			return {
-				ok: true,
-				validation: {
-					ok: true, errors: [], warnings: [], normalized: state.expression,
-					config: { orTags: ["t-a"], andGroups: [{ groupId: "g1", tagIds: ["t-b", "t-c"] }] },
-				},
-			};
-		}
-		return { ok: true };
-	};
-	return async (url, init) => {
-		const p = String(url).replace("/skill-tag/api", "");
-		if (init?.body) state.lastBody = init.body;
-		const out = respond(p);
-		return { json: async () => out };
-	};
-}
-
-function makeRuntime() {
-	const stores = new Map();
-	const pendingEffects = [];
-	function storeOf(Comp) {
-		let s = stores.get(Comp);
-		if (!s) { s = { hooks: [], cursor: 0 }; stores.set(Comp, s); }
-		return s;
-	}
-	const react = {
-		createElement: (type, props, ...children) => ({
-			type, props: props ?? {},
-			children: children.flat(Infinity).filter((c) => c !== null && c !== undefined && c !== false),
-		}),
-		Fragment: FRAGMENT,
-		useState(init) {
-			const s = storeOf(react.__cur);
-			const i = s.cursor++;
-			if (!(i in s.hooks)) s.hooks[i] = typeof init === "function" ? init() : init;
-			return [s.hooks[i], (n) => { s.hooks[i] = typeof n === "function" ? n(s.hooks[i]) : n; }];
-		},
-		useRef(init) {
-			const s = storeOf(react.__cur);
-			const i = s.cursor++;
-			if (!(i in s.hooks)) s.hooks[i] = { current: init ?? null };
-			return s.hooks[i];
-		},
-		useEffect(fn) { storeOf(react.__cur).cursor++; pendingEffects.push(fn); },
-		useMemo(fn) { storeOf(react.__cur).cursor++; return fn(); },
-		useCallback(fn) { storeOf(react.__cur).cursor++; return fn; },
-	};
-	function renderComponent(Comp, props) {
-		const s = storeOf(Comp);
-		s.cursor = 0;
-		const prev = react.__cur;
-		react.__cur = Comp;
-		try { return Comp(props); } finally { react.__cur = prev; }
-	}
-	function drain() {
-		for (const fn of pendingEffects.splice(0)) { try { fn(); } catch { /* 忽略 */ } }
-	}
-	function expand(node, depth = 0) {
-		if (node === null || node === undefined || node === false) return node;
-		if (typeof node !== "object") return node;
-		if (depth > 40) return node;
-		if (typeof node.type === "function") return expand(renderComponent(node.type, node.props), depth + 1);
-		return { ...node, children: (node.children ?? []).map((c) => expand(c, depth + 1)) };
-	}
-	/** 注意：必须 expand 之后才 drain，否则子组件（TagSettingsDialog）的 effect 不会入队 */
-	async function settle(Comp, props, rounds = 10) {
-		let tree = null;
-		for (let r = 0; r < rounds; r += 1) {
-			pendingEffects.length = 0;
-			tree = expand(renderComponent(Comp, props));
-			drain();
-			await new Promise((res) => setTimeout(res, 0));
-			await new Promise((res) => setTimeout(res, 0));
-		}
-		pendingEffects.length = 0;
-		tree = expand(renderComponent(Comp, props));
-		drain();
-		return tree;
-	}
-	return { react, settle };
-}
-
-const ESC = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" };
-const esc = (s) => String(s).replace(/[&<>"]/g, (c) => ESC[c]);
-
-function toHtml(node) {
-	if (node === null || node === undefined || node === false) return "";
-	if (typeof node !== "object") return esc(node);
-	const { type, props = {}, children = [] } = node;
-	if (typeof type === "function") return "";
-	const inner = children.map(toHtml).join("");
-	const tag = typeof type === "string" ? type : "div";
-	const attrs = [];
-	const p = props ?? {};
-	if (p.style && typeof p.style === "object") {
-		attrs.push(`style="${esc(Object.entries(p.style).map(([k, v]) => `${k.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase())}:${v}`).join(";"))}"`);
-	}
-	if (p.className) attrs.push(`class="${esc(p.className)}"`);
-	if (tag === "input") {
-		if (p.value !== undefined) attrs.push(`value="${esc(p.value)}"`);
-		if (p.placeholder) attrs.push(`placeholder="${esc(p.placeholder)}"`);
-		if (p.type) attrs.push(`type="${esc(p.type)}"`);
-		if (p.checked) attrs.push("checked");
-		return `<input ${attrs.join(" ")}>`;
-	}
-	if (tag === "textarea") {
-		if (p.value !== undefined) attrs.push(`value="${esc(p.value)}"`);
-		return `<textarea ${attrs.join(" ")}>${esc(p.value ?? "")}</textarea>`;
-	}
-	if (tag === "select") {
-		const opts = children.map((c) => {
-			if (!c || typeof c !== "object" || c.type !== "option") return toHtml(c);
-			const sel = c.props?.value === p.value ? " selected" : "";
-			return `<option value="${esc(c.props?.value ?? "")}"${sel}>${esc((c.children ?? []).map(toHtml).join(""))}</option>`;
-		}).join("");
-		return `<select ${attrs.join(" ")}>${opts}</select>`;
-	}
-	if (tag === "option") return `<option>${inner}</option>`;
-	if (tag === "button") {
-		if (p.disabled) attrs.push("disabled");
-		return `<button ${attrs.join(" ")}>${inner}</button>`;
-	}
-	return `<${tag} ${attrs.join(" ")}>${inner}</${tag}>`;
-}
-
-const walk = (n, f) => { if (!n || typeof n !== "object") return; f(n); for (const c of n.children ?? []) walk(c, f); };
-const findBtn = (tree, label) => {
-	const out = [];
-	walk(tree, (n) => {
-		if (n.type === "button" && (n.children ?? []).map(String).join("").trim() === label) out.push(n);
-	});
-	return out;
-};
-
-/** 载入 client.js，取回 shell.overlay 组件与 __test 助手 */
-function boot(rt, state) {
-	const sandbox = { console, setTimeout, clearTimeout, fetch: makeFetcher(state), window: { confirm: () => true, __ModuleLoader__: { load: () => {} } } };
-	sandbox.globalThis = sandbox;
-	vm.runInNewContext(SOURCE, sandbox, { filename: "lib/client.js" });
-	const out = { Dialog: null, helpers: null };
-	sandbox.window.__ModuleLoader__.load = ({ factory }) => {
-		const exp = factory((n) => (n === "react" ? rt.react : {}));
-		out.helpers = exp.__test;
-		exp.apply({
-			effect: (fn) => fn(),
-			slots: { inject: (_n, fn) => fn(), register: (o, C) => { if (o.name === "shell.overlay") out.Dialog = C; } },
-		});
-	};
-	// 再跑一次源码，这次 load 已就位，模块才会真正执行并注册槽位
-	vm.runInNewContext(SOURCE, sandbox, { filename: "lib/client.js" });
-	return out;
-}
-
-function scene(title, note, bodyHtml) {
-	return `<div class="cap"><b>${esc(title)}</b> ${note}</div><div class="shot">${bodyHtml}</div>`;
-}
-
-const htmls = [];
-
-// 场景①：对话已继承工作区配置（条件 + 手动添加 + 禁用一起搬过来），可在其上继续改
-{
-	const rt = makeRuntime();
-	const state = {
-		conversationId: "sess-7f3a", expression: "前端+测试*文档",
-		manualSkills: ["xlsx"], disabledSkills: ["pdf"],
-		sourceWorkspaceId: "ws-1", inheritedAt: new Date().toISOString(), lastBody: null,
-	};
-	const { Dialog, helpers } = boot(rt, state);
-	helpers.manageSet({ open: true, workspaceId: "", conversationId: "sess-7f3a" });
-	const tree = await rt.settle(Dialog, {});
-	htmls.push(scene(
-		"场景① 对话双列（已继承工作区）",
-		"左列多出「继承工作区配置」按钮，并标注继承来源与时间；右列技能同样可查看 tag / 禁用 / 添加",
-		`<div class="shot">${toHtml(tree)}</div>`,
-	));
-}
-
-// 场景②：对话尚未继承任何工作区（独立配置）
-{
-	const rt = makeRuntime();
-	const state = {
-		conversationId: "sess-9c11", expression: "",
-		manualSkills: [], disabledSkills: [],
-		sourceWorkspaceId: null, inheritedAt: null, lastBody: null,
-	};
-	const { Dialog, helpers } = boot(rt, state);
-	helpers.manageSet({ open: true, workspaceId: "", conversationId: "sess-9c11" });
-	const tree = await rt.settle(Dialog, {});
-	htmls.push(scene(
-		"场景② 对话双列（未继承，独立配置）",
-		"空条件 = 该对话掌握全部技能；点击「继承工作区配置」会把工作区那份整体搬过来",
-		`<div class="shot">${toHtml(tree)}</div>`,
-	));
-}
-
-// 场景③：对话版「tag 设置」—— 载入标签组后可继续编辑，保存目标是「对话」而不是工作区
-{
-	const rt = makeRuntime();
-	const state = {
-		conversationId: "sess-9c11", expression: "前端+测试",
-		manualSkills: [], disabledSkills: [],
-		sourceWorkspaceId: "ws-1", inheritedAt: new Date().toISOString(), lastBody: null,
-	};
-	const { Dialog, helpers } = boot(rt, state);
-	helpers.manageSet({ open: true, workspaceId: "", conversationId: "sess-9c11" });
-	let tree = await rt.settle(Dialog, {});
-	findBtn(tree, "tag 设置")[0]?.props?.onClick?.();
-	tree = await rt.settle(Dialog, {});
-	// 载入标签组「前端组」的运算
-	let sel = null;
-	walk(tree, (n) => { if (n.type === "select" && (n.children ?? []).some((c) => (c.children ?? []).map(String).join("").includes("前端组"))) sel = n; });
-	sel?.props?.onChange?.({ target: { value: "tpl-1" } });
-	tree = await rt.settle(Dialog, {});
-	htmls.push(scene(
-		"场景③ 对话版「tag 设置」",
-		"载入标签组「前端组」的运算到运算区后可继续编辑；底部按钮是 <b>保存到对话</b>，不会改工作区",
-		`<div class="shot">${toHtml(tree)}</div>`,
-	));
-}
-
-const head = `<!doctype html><html lang="zh"><head><meta charset="utf-8"><title>对话管理标签 · 界面预览</title>
-<style>
- body{margin:0;background:#0e1117;color:#d7dce5;font-family:"Microsoft YaHei",ui-sans-serif,system-ui;padding:14px 0 30px}
- .cap{padding:12px 24px 4px;font-size:13px;color:#8b93a7} .cap b{color:#e6ebf5}
- /* 静态预览：把浮层的 fixed/absolute 全部拍平，否则嵌套的「tag 设置」会脱离文档流留下一大段空白 */
- .shot *{position:static!important}
- .shot>div{display:block!important;background:transparent!important}
- .shot>div>div{margin:0 auto}
- h1{font-size:16px;padding:0 24px;margin:8px 0 4px}
- code{background:#1b2130;padding:1px 5px;border-radius:4px}
-</style></head><body><h1>对话 → 管理标签 · 界面预览</h1>`;
-fs.writeFileSync(path.join(HERE, "对话管理标签-preview.html"), head + htmls.join("") + "</body></html>");
-console.log("wrote docs/preview/对话管理标签-preview.html");

package/docs/preview/render-manage-preview.mjs

@@ -1,278 +0,0 @@
-// 生成「管理标签」界面的可视化预览（不依赖浏览器控制扩展）
-//
-// 做法：复用 tests/__manage-render.mjs 里的迷你 React 运行时，真正执行 lib/client.js
-// 中的 ManageTagsDialog / TagSettingsDialog，把渲染结果序列化成 HTML，再用 headless
-// Edge 截图。这样预览图和真实组件同源，不会"图文不符"。
-//
-// 用法：node docs/preview/render-manage-preview.mjs
-// 产物：docs/preview/管理标签-preview.html
-
-import fs from "node:fs";
-import vm from "node:vm";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-const ROOT = path.resolve(HERE, "..", "..");
-const SOURCE = fs.readFileSync(path.join(ROOT, "lib", "client.js"), "utf8");
-const FRAGMENT = Symbol("Fragment");
-
-const TAGS = [
-	{ tagId: "t-a", name: "前端" },
-	{ tagId: "t-b", name: "测试" },
-	{ tagId: "t-c", name: "文档" },
-];
-const TEMPLATES = [
-	{ templateId: "tpl-1", name: "前端组", expression: "前端+测试*文档" },
-	{ templateId: "tpl-2", name: "纯后端", expression: "(前端+测试)*文档" },
-];
-const UNIVERSE = ["code-review", "tdd", "docx", "xlsx", "pdf", "webapp-testing"];
-const LINKS = [
-	{ skillId: "code-review", tagIds: ["t-a"] },
-	{ skillId: "tdd", tagIds: ["t-b"] },
-	{ skillId: "docx", tagIds: ["t-c"] },
-	{ skillId: "pdf", tagIds: ["t-c"] },
-];
-
-function makeFetcher(state) {
-	const view = () => {
-		const hasFilter = state.expression.trim() !== "";
-		const hit = (name) => {
-			const ids = new Set((LINKS.find((l) => l.skillId === name)?.tagIds) ?? []);
-			if (!hasFilter) return true;
-			// 简化：命中 = 含「前端」或（含「测试」且含「文档」）
-			return ids.has("t-a") || (ids.has("t-b") && ids.has("t-c"));
-		};
-		const matched = hasFilter ? UNIVERSE.filter(hit) : UNIVERSE.slice();
-		const visible = [];
-		for (const n of matched) if (!state.disabledSkills.includes(n)) visible.push(n);
-		for (const n of state.manualSkills) if (!state.disabledSkills.includes(n) && !visible.includes(n)) visible.push(n);
-		return { hasFilter, matched, manual: state.manualSkills.slice(), disabled: state.disabledSkills.slice(), visible };
-	};
-	const respond = (p) => {
-		if (p === "/state") return { ok: true, tags: TAGS, skillLinks: LINKS, templates: TEMPLATES, workspaces: [], conversations: [] };
-		if (p === "/workspaces/skills") {
-			// config 跟随 expression，让左列「解析结果」能真实显示
-			const expr = state.expression.trim();
-			const config = expr === ""
-				? { orTags: [], andGroups: [] }
-				: { orTags: ["t-a"], andGroups: [{ groupId: "g1", tagIds: ["t-b", "t-c"] }] };
-			return {
-				ok: true, workspaceId: "ws-1", expression: state.expression,
-				config,
-				manualSkills: state.manualSkills, disabledSkills: state.disabledSkills,
-				candidates: [], universe: UNIVERSE, view: view(),
-			};
-		}
-		if (p === "/templates/validate") {
-			// 与真实服务端同语义：allowEmpty=true 时空表达式合法（无条件）
-			const empty = String(state.expression).trim() === "";
-			if (empty) {
-				return { ok: true, validation: { ok: true, errors: [], warnings: [], normalized: "", config: { orTags: [], andGroups: [] } } };
-			}
-			return {
-				ok: true,
-				validation: {
-					ok: true, errors: [], warnings: [], normalized: state.expression,
-					config: { orTags: ["t-a"], andGroups: [{ groupId: "g1", tagIds: ["t-b", "t-c"] }] },
-				},
-			};
-		}
-		if (p === "/workspaces/expression") { state.expression = JSON.parse(state.lastBody ?? "{}").expression ?? ""; return { ok: true, workspace: {} }; }
-		return { ok: true };
-	};
-	return async (url, init) => {
-		const p = String(url).replace("/skill-tag/api", "");
-		if (init?.body) state.lastBody = init.body;
-		const payload = respond(p);
-		return { json: async () => payload };
-	};
-}
-
-function makeRuntime() {
-	const stores = new Map();
-	const pendingEffects = [];
-	function storeOf(Comp) {
-		let s = stores.get(Comp);
-		if (!s) { s = { hooks: [], cursor: 0 }; stores.set(Comp, s); }
-		return s;
-	}
-	const react = {
-		createElement: (type, props, ...children) => ({
-			type, props: props ?? {},
-			children: children.flat(Infinity).filter((c) => c !== null && c !== undefined && c !== false),
-		}),
-		Fragment: FRAGMENT,
-		useState(init) {
-			const s = storeOf(react.__cur);
-			const i = s.cursor++;
-			if (!(i in s.hooks)) s.hooks[i] = typeof init === "function" ? init() : init;
-			return [s.hooks[i], (n) => { s.hooks[i] = typeof n === "function" ? n(s.hooks[i]) : n; }];
-		},
-		useRef(init) {
-			const s = storeOf(react.__cur);
-			const i = s.cursor++;
-			if (!(i in s.hooks)) s.hooks[i] = { current: init ?? null };
-			return s.hooks[i];
-		},
-		useEffect(fn) {
-			const s = storeOf(react.__cur);
-			s.cursor++;
-			pendingEffects.push(fn);
-		},
-		useMemo(fn) { storeOf(react.__cur).cursor++; return fn(); },
-		useCallback(fn) { storeOf(react.__cur).cursor++; return fn; },
-	};
-	function renderComponent(Comp, props) {
-		const s = storeOf(Comp);
-		s.cursor = 0;
-		const prev = react.__cur;
-		react.__cur = Comp;
-		try { return Comp(props); } finally { react.__cur = prev; }
-	}
-	function drain() {
-		for (const fn of pendingEffects.splice(0)) { try { fn(); } catch { /* 忽略 */ } }
-	}
-	async function settle(Comp, props, rounds = 8) {
-		let tree = null;
-		for (let r = 0; r < rounds; r += 1) {
-			pendingEffects.length = 0;
-			tree = renderComponent(Comp, props);
-			tree = expand(tree);
-			drain();
-			await new Promise((res) => setTimeout(res, 0));
-			await new Promise((res) => setTimeout(res, 0));
-		}
-		return tree;
-	}
-	function expand(node, depth = 0) {
-		if (node === null || node === undefined || node === false) return node;
-		if (typeof node !== "object") return node;
-		if (depth > 40) return node;
-		if (typeof node.type === "function") return expand(renderComponent(node.type, node.props), depth + 1);
-		return { ...node, children: (node.children ?? []).map((c) => expand(c, depth + 1)) };
-	}
-	return { react, settle };
-}
-
-const ESC = { "&": "&amp;", "<": "&lt;", ">": "&gt;", '"': "&quot;" };
-const esc = (s) => String(s).replace(/[&<>"]/g, (c) => ESC[c]);
-
-function toHtml(node) {
-	if (node === null || node === undefined || node === false) return "";
-	if (typeof node !== "object") return esc(node);
-	const { type, props = {}, children = [] } = node;
-	if (typeof type === "function") return "";
-	const inner = children.map(toHtml).join("");
-	const tag = typeof type === "string" ? type : "div";
-	const attrs = [];
-	const p = props ?? {};
-	if (p.style && typeof p.style === "object") {
-		attrs.push(`style="${esc(Object.entries(p.style).map(([k, v]) => `${k.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase())}:${v}`).join(";"))}"`);
-	}
-	if (p.className) attrs.push(`class="${esc(p.className)}"`);
-	if (tag === "input") {
-		if (p.value !== undefined) attrs.push(`value="${esc(p.value)}"`);
-		if (p.placeholder) attrs.push(`placeholder="${esc(p.placeholder)}"`);
-		if (p.type) attrs.push(`type="${esc(p.type)}"`);
-		if (p.checked) attrs.push("checked");
-		return `<input ${attrs.join(" ")}>`;
-	}
-	if (tag === "textarea") {
-		if (p.value !== undefined) attrs.push(`value="${esc(p.value)}"`);
-		return `<textarea ${attrs.join(" ")}>${esc(p.value ?? "")}</textarea>`;
-	}
-	if (tag === "select") {
-		const opts = children.map((c) => {
-			if (!c || typeof c !== "object" || c.type !== "option") return toHtml(c);
-			const sel = c.props?.value === p.value ? " selected" : "";
-			return `<option value="${esc(c.props?.value ?? "")}"${sel}>${esc((c.children ?? []).map(toHtml).join(""))}</option>`;
-		}).join("");
-		return `<select ${attrs.join(" ")}>${opts}</select>`;
-	}
-	if (tag === "option") return `<option>${inner}</option>`;
-	if (tag === "button") {
-		if (p.disabled) attrs.push("disabled");
-		return `<button ${attrs.join(" ")}>${inner}</button>`;
-	}
-	return `<${tag} ${attrs.join(" ")}>${inner}</${tag}>`;
-}
-
-function frame(title, bodyHtml) {
-	return `<!doctype html><html lang="zh"><head><meta charset="utf-8"><title>${esc(title)}</title>
-<style>
-  body { margin:0; background:#0e1117; color:#d7dce5; font-family:"Microsoft YaHei",ui-sans-serif,system-ui; }
-  .cap { padding:12px 20px 4px; font-size:13px; color:#8b93a7; }
-  .cap b { color:#e6ebf5; font-weight:600; }
-  .shot { padding:10px 20px 22px; }
-  /* 让浮层在静态预览里居中显示，而不是固定定位溢出 */
-  .shot > div { position:static !important; background:transparent !important; }
-  button, select, input, textarea { font-family:inherit; }
-</style></head><body>${bodyHtml}</body></html>`;
-}
-
-async function renderScene({ runtime, Dialog, helpers, state, steps, title, file }) {
-	helpers.manageSet({ open: true, workspaceId: "ws-1" });
-	let tree = await runtime.settle(Dialog, {});
-	await steps(tree, () => runtime.settle(Dialog, {}));
-	const html = frame(title, `<div class="cap"><b>${esc(title)}</b></div><div class="shot">${toHtml(tree)}</div>`);
-	fs.writeFileSync(path.join(HERE, file), html);
-	return html;
-}
-
-const htmls = [];
-
-// 场景①：双列主界面（工作区已有条件 前端+测试*文档）
-{
-	const rt = makeRuntime();
-	const state = { expression: "前端+测试*文档", manualSkills: ["xlsx"], disabledSkills: ["pdf"], lastBody: null };
-	const sandbox = { console, setTimeout, clearTimeout, fetch: makeFetcher(state), window: { confirm: () => true, __ModuleLoader__: { load: () => {} } } };
-	sandbox.globalThis = sandbox;
-	vm.runInNewContext(SOURCE, sandbox, { filename: "lib/client.js" });
-	let Dialog = null, helpers = null;
-	sandbox.window.__ModuleLoader__.load = ({ factory }) => {
-		const exp = factory((n) => (n === "react" ? rt.react : {}));
-		helpers = exp.__test;
-		exp.apply({ effect: (fn) => fn(), slots: { inject: (_n, fn) => fn(), register: (o, C) => { if (o.name === "shell.overlay") Dialog = C; } } });
-	};
-	vm.runInNewContext(SOURCE, sandbox, { filename: "lib/client.js" });
-	helpers.manageSet({ open: true, workspaceId: "ws-1" });
-	const tree = await rt.settle(Dialog, {});
-	htmls.push(frame("场景① 双列主界面", `<div class="cap"><b>场景①</b> 工作区已有条件 <code>前端+测试*文档</code>，pdf 被禁用、xlsx 为手动添加</div><div class="shot">${toHtml(tree)}</div>`));
-}
-
-// 场景②：tag 设置弹窗（载入标签组后）
-{
-	const rt = makeRuntime();
-	const state = { expression: "", manualSkills: [], disabledSkills: [], lastBody: null };
-	const sandbox = { console, setTimeout, clearTimeout, fetch: makeFetcher(state), window: { confirm: () => true, __ModuleLoader__: { load: () => {} } } };
-	sandbox.globalThis = sandbox;
-	let Dialog = null, helpers = null;
-	sandbox.window.__ModuleLoader__.load = ({ factory }) => {
-		const exp = factory((n) => (n === "react" ? rt.react : {}));
-		helpers = exp.__test;
-		exp.apply({ effect: (fn) => fn(), slots: { inject: (_n, fn) => fn(), register: (o, C) => { if (o.name === "shell.overlay") Dialog = C; } } });
-	};
-	vm.runInNewContext(SOURCE, sandbox, { filename: "lib/client.js" });
-	helpers.manageSet({ open: true, workspaceId: "ws-1" });
-	let tree = await rt.settle(Dialog, {});
-	// 点「tag 设置」
-	const walk = (n, f) => { if (!n || typeof n !== "object") return; f(n); for (const c of n.children ?? []) walk(c, f); };
-	const btn = [];
-	walk(tree, (n) => { if (n.type === "button" && (n.children ?? []).join("").includes("tag 设置")) btn.push(n); });
-	if (btn[0]) btn[0].props.onClick();
-	tree = await rt.settle(Dialog, {});
-	htmls.push(frame("场景② tag 设置弹窗", `<div class="cap"><b>场景②</b> 「tag 设置」：可选择标签组载入运算、点击已有标签插入、实时校验</div><div class="shot">${toHtml(tree)}</div>`));
-}
-
-const out = htmls.join("");
-fs.writeFileSync(path.join(HERE, "管理标签-preview.html"), `<!doctype html><html lang="zh"><head><meta charset="utf-8"><title>管理标签 · 界面预览</title>
-<style>
- body{margin:0;background:#0e1117;color:#d7dce5;font-family:"Microsoft YaHei",ui-sans-serif,system-ui;padding:18px 0 30px}
- .cap{padding:10px 24px 4px;font-size:13px;color:#8b93a7} .cap b{color:#e6ebf5}
- .shot{padding:8px 24px 26px}
- .shot>div{position:static!important;display:block!important;background:transparent!important;inset:auto!important}
- .shot>div>div{margin:0 auto}
- h1{font-size:16px;padding:0 24px;margin:8px 0 4px}
-</style></head><body><h1>管理标签 · 界面预览</h1>${htmls.map((h) => h.replace(/^[\s\S]*<body>/, "").replace(/<\/body>[\s\S]*$/, "")).join("")}</body></html>`);
-console.log("wrote docs/preview/管理标签-preview.html");

package/docs/preview/render-preview.mjs

@@ -1,274 +0,0 @@
-// 生成静态 HTML 预览：不是手写的示意图，而是用「最小 React 运行时」真的执行
-// lib/client.js 里的 Section / TemplateGroupPage，把渲染树序列化成 HTML。
-// 迷你运行时提供 useState/useEffect/useRef/useCallback，因此实时校验（250ms 防抖）
-// 也会真的跑一遍（fetch 被桩成返回真实格式的校验结果），能渲染出校验/解析结果区域。
-import fs from "node:fs";
-import vm from "node:vm";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-
-const HERE = path.dirname(fileURLToPath(import.meta.url));
-// 本脚本可在插件内(docs/preview/)或临时工作区运行，两种位置都自动定位插件源码
-const CANDIDATES = [
-	path.resolve(HERE, "..", "..", "lib", "client.js"),
-	path.resolve(HERE, "..", "..", "..", ".dsh", "profiles", "web", "my-plugins", "dsh-skill-tag", "lib", "client.js"),
-	path.resolve(process.cwd(), "lib", "client.js"),
-];
-const CLIENT = CANDIDATES.find((p) => fs.existsSync(p));
-if (!CLIENT) {
-	console.error("找不到 lib/client.js，尝试过:\n" + CANDIDATES.join("\n"));
-	process.exit(1);
-}
-const SOURCE = fs.readFileSync(CLIENT, "utf8");
-const FRAGMENT = Symbol("Fragment");
-
-const TAGS = [
-	{ tagId: "t-a", name: "A" },
-	{ tagId: "t-b", name: "B" },
-	{ tagId: "t-c", name: "C" },
-	{ tagId: "t-mt", name: "my tag" },
-	{ tagId: "t-plus", name: "a+b" },
-];
-const TEMPLATES = [
-	{ templateId: "tpl-1", name: "前端组", expression: "A+B*C", config: { orTags: ["t-a"], andGroups: [{ groupId: "t-b|t-c", tagIds: ["t-b", "t-c"] }] } },
-	{ templateId: "tpl-2", name: "另一组", expression: "(A+B)*C", config: { orTags: [], andGroups: [] } },
-];
-
-// ── 迷你 React 运行时 ──────────────────────────────────────────────────────
-function makeRuntime(initialState, fetchImpl) {
-	let hooks = [];
-	let hookIndex = 0;
-	const effects = [];
-	const store = { tree: null };
-
-	const react = {
-		createElement: (type, props, ...children) => ({
-			type,
-			props: props ?? {},
-			children: children.flat(Infinity).filter((c) => c !== null && c !== undefined && c !== false),
-		}),
-		Fragment: FRAGMENT,
-		useRef: (init) => {
-			const i = hookIndex++;
-			if (!(i in hooks)) hooks[i] = { current: init ?? null };
-			return hooks[i];
-		},
-		useState: (init) => {
-			const i = hookIndex++;
-			if (!(i in hooks)) {
-				// Section 的初始 state 形如 {loading:true, ...} —— 用场景注入的状态替换它
-				if (init && typeof init === "object" && "loading" in init) hooks[i] = initialState;
-				else hooks[i] = typeof init === "function" ? init() : init;
-			}
-			const setter = (next) => {
-				const value = typeof next === "function" ? next(hooks[i]) : next;
-				if (value !== hooks[i]) { hooks[i] = value; store.dirty = true; }
-			};
-			return [hooks[i], setter];
-		},
-		useMemo: (fn) => { const i = hookIndex++; if (!(i in hooks)) hooks[i] = fn(); return hooks[i]; },
-		useCallback: (fn) => { const i = hookIndex++; if (!(i in hooks)) hooks[i] = fn; return hooks[i]; },
-		useEffect: (fn) => { effects.push(fn); },
-	};
-
-	let Section = null;
-	const sandbox = {
-		console,
-		setTimeout: (fn) => { pending.push(fn); return pending.length; },
-		clearTimeout: () => {},
-		setInterval: () => 0,
-		clearInterval: () => {},
-		fetch: fetchImpl,
-		window: { __ModuleLoader__: { load: () => {} }, confirm: () => true },
-		Promise,
-		JSON,
-	};
-	const pending = [];
-	sandbox.globalThis = sandbox;
-	vm.runInNewContext(SOURCE, sandbox, { filename: "client.js" });
-	sandbox.window.__ModuleLoader__.load = ({ factory }) => {
-		const exp = factory((n) => (n === "react" ? react : {}));
-		exp.apply({ effect: (fn2) => fn2(), slots: { inject: (_n, fn2) => fn2(), register: (_o, C) => { Section = C; } } });
-	};
-	vm.runInNewContext(SOURCE, sandbox, { filename: "client.js" });
-
-	return {
-		/**
-		 * 跑一轮"渲染 + 序列化"。
-		 * 关键点：Section 返回的树里 TemplateGroupPage 只是个元素节点，只有在序列化
-		 * （即真正执行函数组件）时才会跑它的 hooks —— 所以 effect 与 250ms 防抖必须
-		 * 在序列化过程中收集，不能只在 Section 这一层收集。
-		 */
-		async run(serializeFn) {
-			let html = "";
-			for (let round = 0; round < 10; round += 1) {
-				hookIndex = 0;
-				effects.length = 0;
-				pending.length = 0;
-				store.dirty = false;
-				const tree = Section(initialState);
-				html = serializeFn(tree);
-				for (const effect of effects) effect();
-				let ran = false;
-				while (pending.length) { const fn = pending.shift(); fn(); ran = true; }
-				// 等待 fetch 的 Promise 链落定（setValidation 在 await 之后调用）
-				for (let k = 0; k < 5; k += 1) await new Promise((r) => setImmediate(r));
-				if (!ran && !store.dirty) break;
-			}
-			return html;
-		},
-	};
-}
-
-const TAGS_BY_NAME = new Map(TAGS.map((t) => [t.name, t]));
-
-/** 与 src/domain/expr.js 行为一致的校验桩（只覆盖本预览用到的合法表达式） */
-function fakeValidate(expression) {
-	const src = String(expression ?? "");
-	if (src.trim() === "") {
-		return { ok: false, errors: [{ code: "EMPTY", message: "表达式不能为空：请点击上方标签写入，或用 A+B*C 的形式输入", position: 0, length: 0 }], warnings: [] };
-	}
-	// 用真引擎校验（与服务端同一份实现，直接 import 更可靠，但这里在 vm 外简单判定）
-	const names = [...src.matchAll(/[A-Za-z\u4e00-\u9fa5][\w\u4e00-\u9fa5]*/g)].map((m) => m[0]);
-	const unknown = names.filter((n) => !TAGS_BY_NAME.has(n));
-	if (unknown.length) {
-		return { ok: false, errors: [{ code: "UNKNOWN_TAG", message: `标签不存在: '${unknown[0]}'`, position: src.indexOf(unknown[0]), length: unknown[0].length }], warnings: [] };
-	}
-	// 预览场景里用到的两条合法表达式，config 直接照抄真实引擎（toDnf → dnfToConfig）的结果
-	const KNOWN = {
-		"A+B*C": { orTags: ["t-a"], andGroups: [{ groupId: "t-b|t-c", tagIds: ["t-b", "t-c"] }] },
-		"(A+B)*C": { orTags: [], andGroups: [{ groupId: "t-a|t-c", tagIds: ["t-a", "t-c"] }, { groupId: "t-b|t-c", tagIds: ["t-b", "t-c"] }] },
-	};
-	const normalizedSrc = src.replace(/\s+/g, " ").replace(/\s*([+*()])\s*/g, " $1 ").trim();
-	return {
-		ok: true, errors: [], warnings: [],
-		normalized: normalizedSrc,
-		config: KNOWN[src.replace(/\s+/g, "")] ?? { orTags: [], andGroups: [] },
-	};
-}
-
-function makeFetch(validation) {
-	return async (url) => ({
-		async json() {
-			if (String(url).endsWith("/templates/validate")) return { ok: true, validation };
-			if (String(url).endsWith("/state")) return { ok: true, tags: TAGS, templates: TEMPLATES, skillLinks: [], workspaces: [], conversations: [] };
-			if (String(url).endsWith("/skills")) return { ok: true, skills: [] };
-			return { ok: true };
-		},
-	});
-}
-
-const BASE = {
-	loading: false, error: null,
-	data: { tags: TAGS, templates: TEMPLATES, skillLinks: [], workspaces: [], conversations: [] },
-	skills: [], newTagName: "", busy: false, notice: null,
-	linkTagId: null, tagSearch: "", skillSearch: "", pickOpen: false, pickSearch: "",
-	// 设置页已移除工作区/对话两块编辑器（改由工作区行 / 会话行菜单的「管理标签」进入），
-	// 这里也不再需要它们的 state 初值。openTags 是标签列表的展开态。
-	openTags: {},
-	view: "main",
-	tplId: null, tplIsNew: false, tplName: "", tplExpression: "",
-};
-const baseState = (over = {}) => ({ ...BASE, ...over });
-
-// ── 序列化 ────────────────────────────────────────────────────────────────
-const esc = (s) => String(s).replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
-const styleOf = (st) =>
-	st && typeof st === "object"
-		? Object.entries(st).map(([k, v]) => `${k.replace(/[A-Z]/g, (m) => "-" + m.toLowerCase())}:${v}`).join(";")
-		: "";
-
-function serialize(node, depth = 0) {
-	if (node === null || node === undefined || node === false) return "";
-	if (typeof node === "string" || typeof node === "number") return esc(node);
-	if (typeof node !== "object" || depth > 80) return "";
-	if (typeof node.type === "function") return serialize(node.type(node.props), depth + 1);
-	if (node.type === FRAGMENT) return (node.children ?? []).map((c) => serialize(c, depth + 1)).join("");
-
-	const tag = node.type;
-	const props = node.props ?? {};
-	const attrs = [];
-	const style = styleOf(props.style);
-	if (style) attrs.push(`style="${esc(style)}"`);
-	if (props.placeholder !== undefined) attrs.push(`placeholder="${esc(props.placeholder)}"`);
-	if (props.title) attrs.push(`title="${esc(props.title)}"`);
-	if (props.value !== undefined && tag === "input") attrs.push(`value="${esc(props.value)}"`);
-	if (props.disabled) attrs.push("disabled");
-	const inner = (node.children ?? []).map((c) => serialize(c, depth + 1)).join("");
-	if (["input", "br", "img"].includes(tag)) return `<${tag} ${attrs.join(" ")}>`;
-	if (tag === "textarea") return `<textarea ${attrs.join(" ")}>${esc(props.value ?? "")}</textarea>`;
-	if (props.disabled) attrs.push('class="is-disabled"');
-	return `<${tag} ${attrs.join(" ")}>${inner}</${tag}>`;
-}
-
-const SCENES = [
-	{
-		label: "① 主页面：「编辑标签组」入口",
-		state: baseState({ view: "main" }),
-		validation: fakeValidate(""),
-	},
-	{
-		label: "② 标签组配置页 · 未选中（下方为引导文案，不渲染输入框）",
-		state: baseState({ view: "templates" }),
-		validation: fakeValidate(""),
-	},
-	{
-		label: "③ 打开已有标签组「前端组」→ 表达式 A+B*C 被回显 + 校验通过 + 解析结果",
-		state: baseState({ view: "templates", tplId: "tpl-1", tplName: "前端组", tplExpression: "A+B*C" }),
-		validation: fakeValidate("A+B*C"),
-	},
-	{
-		label: "④ 表达式非法（A+）→ 保存按钮禁用 + 定位提示",
-		state: baseState({ view: "templates", tplId: "tpl-1", tplName: "前端组", tplExpression: "A+" }),
-		validation: {
-			ok: false,
-			errors: [{ code: "TRAILING_OPERATOR", message: "'+' 之后缺少标签或 '('", position: 1, length: 1 }],
-			warnings: [],
-		},
-	},
-	{
-		label: "⑤ 新建标签组草稿（「保存新建」）",
-		state: baseState({ view: "templates", tplIsNew: true, tplName: "新标签组" }),
-		validation: fakeValidate(""),
-	},
-];
-
-const blocks = [];
-for (const scene of SCENES) {
-	const rt = makeRuntime(scene.state, makeFetch(scene.validation));
-	const html = await rt.run((tree) => serialize(tree));
-	blocks.push(`<section><h2>${esc(scene.label)}</h2><div class="frame">${html}</div></section>`);
-}
-
-const doc = `<!doctype html>
-<html lang="zh-CN"><head><meta charset="utf-8">
-<meta name="viewport" content="width=device-width,initial-scale=1">
-<title>标签组配置 · 界面预览（真实组件渲染）</title>
-<style>
-  body { margin:0; padding:24px 20px 60px; font-family: ui-sans-serif,system-ui,"Microsoft YaHei",sans-serif;
-         background:#14161a; color:#e6e6e6; }
-  h1 { font-size:19px; margin:0 0 6px; }
-  h2 { font-size:13px; color:#9aa4b2; margin:26px 0 8px; font-weight:600; }
-  .frame { border:1px solid #2c323a; border-radius:12px; padding:10px 14px;
-           background:linear-gradient(#1b1f25,#181b21); overflow-x:auto; }
-  .note { color:#8b95a3; font-size:12px; line-height:1.75; max-width:900px; }
-  code { background:#262b33; padding:1px 5px; border-radius:4px; font-size:11px; }
-  input, textarea { color:#e6e6e6; font-family:inherit; }
-  textarea { font-family: ui-monospace,monospace !important; }
-  button { font-family:inherit; }
-  .is-disabled { opacity:.42; cursor:not-allowed !important; }
-  input::placeholder, textarea::placeholder { color:#5d6774; }
-</style></head>
-<body>
-<h1>「标签组配置」界面预览</h1>
-<p class="note">
-本页不是示意图：由 <code>lib/client.js</code> 中<b>真实的 Section / TemplateGroupPage</b> 在迷你 React 运行时里执行后，
-把渲染树序列化成 HTML；内联样式全部来自组件代码本身。校验区域由真实 250ms 防抖逻辑触发
-（<code>fetch</code> 被桩成返回与 <code>src/domain/expr.js</code> 同格式的结果）。仅无点击交互。
-</p>
-${blocks.join("\n")}
-</body></html>`;
-
-const out = path.join(HERE, "标签组配置-preview.html");
-fs.writeFileSync(out, doc, "utf8");
-console.log("wrote", out, doc.length, "bytes");