aims-workstation 0.1.8 → 0.1.11

package/.env.example

@@ -16,4 +16,4 @@ ARM_API_TOKEN=<arm_pat_xxx-or-leave-empty>
 
 # npm 发版令牌（npmjs.com → Access Tokens 生成；供 scripts/publish-npm.sh 使用，发布免浏览器授权）
 # 选 Granular（限定本包、Read and write）或 Classic → Automation
-# NPM_TOKEN=npm_xxxxxxxxxxxxxxxxxxxx
+# NPM_TOKEN=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

package/package.json

@@ -13,7 +13,7 @@
     "@earendil-works/pi-ai": "^1.2.0"
   },
   "packageManager": "pnpm@11.21.0+sha512.521705bce689924eac72f5a3587122f362689ef6571e55ba80076fd637c11132ecffada26fad4ea79c485bfddbfd3d5a2a5b05805a77e893de71ec8a6cca3bb1",
-  "version": "0.1.8",
+  "version": "0.1.11",
   "description": "AIMS 工作站：本地智能体工作站——ARM 助手本地化（下载/离线/升级）、工作台对话式定制、多工作区隔离、分级自主与审计",
   "bin": {
     "aims-workstation": "bin/aims-workstation.js"

package/scripts/check-panel.mjs

@@ -16,9 +16,9 @@ if (/\b(window|document|globalThis)\b/.test(code)) errors.push('E2 沙箱违规
 // E3 模板完整性：反引号必须成对
 const ticks = (code.match(/`/g) || []).length;
 if (ticks % 2 !== 0) errors.push(`E3 模板断裂：反引号数量为奇数(${ticks})，html\`\` 模板未闭合`);
-// E4 编译检查：与运行时一致的 new Function 编译
+// E4 编译检查：与运行时一致的 new Function 编译（运行时还注入 ui = panel-kit 组件集，见 web/src/components/panel-kit.tsx）
 try {
-  const factory = new Function('React', 'html', 'useState', 'useEffect', 'useRef', 'useMemo',
+  const factory = new Function('React', 'html', 'ui', 'useState', 'useEffect', 'useRef', 'useMemo',
     `"use strict";\n${code}\n;if (typeof Panel !== 'function') throw new Error('no Panel');\nreturn Panel;`);
   if (typeof factory !== 'function') errors.push('E4 编译失败');
 } catch (e) { errors.push(`E4 编译失败：${e.message}`); }
@@ -34,6 +34,10 @@ if (/onInput/.test(code) && /onChange/.test(code)) warnings.push('W2 同时使
 if (!/key=/.test(code) && /\.map\(/.test(code)) warnings.push('W3 列表渲染(.map)缺少 key 属性');
 if (/await /.test(code) && !/try\s*{|\.catch\(/.test(code)) warnings.push('W4 存在 await 但无 try/catch 或 .catch，失败会静默');
 if (!/(loading|加载|…|\.\.\.)|useEffect/.test(code) && /store\.(list|create)/.test(code)) warnings.push('W5 异步读写无加载态提示，首帧可能空白');
+// W6：首屏疑似标题行——独立 font-semibold 文本行会与平台面板头重复标识（面板标题由网格渲染成面板头）
+if (/<div[^>]*\bfont-semibold\b[^>]*>([^<]*\$\{[^}]*\})?[^<]*<\/div>/.test(code)) {
+  warnings.push('W6 疑似标题行（font-semibold 独立文本行）：面板标题由平台面板头渲染，插件首屏直接进入内容，勿重复标题');
+}
 
 const verdict = errors.length ? 'REJECT' : 'PASS';
 const lines = [

package/server.js

@@ -76,7 +76,7 @@ const PORT = +(process.env.PORT || env.PORT || 5600);
 const HOST = process.env.AIMS_HOST || '0.0.0.0'; // 默认局域网可达（团队共用）；仅本机使用可设 AIMS_HOST=127.0.0.1
 // ── 运行时配置（ARM 源与 LLM 均可私有化部署：在「系统设置」页切换，存 AIMS_HOME/config/platform.json，优先级 运行时 > 环境变量 > .env）──
 const CFG_FILE = path.join(AIMS_HOME, 'config/platform.json');
-const cfg = { arm_api_base: '', arm_token: '', llm_base_url: '', llm_api_key: '', llm_model: '', scene_profile: '', access_token: '' };
+const cfg = { arm_api_base: '', arm_token: '', llm_base_url: '', llm_api_key: '', llm_model: '', llm_context_tokens: 0, scene_profile: '', access_token: '' };
 // 守护栏默认策略（可在「系统设置·守护栏」维护，存 platform.json，保存即热生效）：deny=正则源串（命中即永久拒绝，任何级别不豁免）；
 // ro=只读白名单命令名（免确认直行）；sudo_u_l2=true 时 `sudo -u <用户>` 降权形式不再永久拒绝、按写命令走 L2 人工确认（裸 sudo 仍拒绝）
 const GUARD_DEFAULT = {
@@ -106,6 +106,9 @@ const LLM_DEFAULT_BASE = 'http://bifrost.infra.dev.aimstek.cn/v1';
 const llmBaseUrl = () => cfg.llm_base_url || env.LLM_BASE_URL || LLM_DEFAULT_BASE;
 const llmApiKey = () => cfg.llm_api_key || env.LLM_API_KEY || 'def';
 const llmModelName = () => cfg.llm_model || env.LLM_MODEL || 'def';
+// 上下文窗口（token）：设置页可配（跟随所选模型的真实窗口），驱动会话历史裁剪预算；0/未配 = 默认 128K
+const LLM_DEFAULT_CONTEXT_TOKENS = 128_000;
+const llmContextTokens = () => { const n = +cfg.llm_context_tokens; return Number.isFinite(n) && n > 0 ? n : LLM_DEFAULT_CONTEXT_TOKENS; };
 // 场景画像：平台级、全局一份的用户场景描述（团队环境/系统清单/规范），注入所有助手；空则不注入。
 // 与知识检索互补（常驻事实 vs 按需检索）；凭据不进画像（放"凭据在哪、找谁要"）。
 const sceneProfile = () => String(cfg.scene_profile || '').trim();
@@ -175,9 +178,24 @@ async function llmProbe() { // 设置页「保存并测试」：一次极小补
 }
 async function llmComplete(systemPrompt, userText) { // 无工具的一次性调用（起草/摘要）
   const r = await models.complete(model, { systemPrompt, messages: [{ role: 'user', content: userText, timestamp: Date.now() }], tools: [] });
+  // pi-ai 把认证/请求失败表现为 stopReason=error 而非异常（同 llmProbe 判定）——不抛会变成空串静默流向调用方
+  if (r.stopReason === 'error') throw new Error(`LLM 请求失败: ${r.errorMessage || r.rawStopReason || 'stop=error'}`);
   return (r.content || []).filter(b => b.type === 'text').map(b => b.text).join('');
 }
 
+// 助手自描述（灵感库输入）：AGENT.md 优先，manifest description/prompt 兜底
+function agentBrief(agentId) {
+  const la = localAgent(agentId);
+  if (!la || !la.installed_version) return '';
+  const dir = path.join(ARM_AGENTS_DIR, agentId, 'versions', la.installed_version);
+  try { return fs.readFileSync(path.join(dir, 'AGENT.md'), 'utf8').slice(0, 3000) } catch { /* 无 AGENT.md */ }
+  try {
+    const m = JSON.parse(fs.readFileSync(path.join(dir, 'manifest.json'), 'utf8'));
+    return [m.description, m.prompt].filter(Boolean).join('\n').slice(0, 3000);
+  } catch { return '' }
+}
+const inspCache = new Map(); // agent 自描述指纹 → 灵感列表（LLM 一次生成，档案不变即复用）
+
 // ── 现场数据容器：真实数据源（AIMS-MOS）未接入前保持为空——面板按空态渲染，不造假数据
 //（2026-10-15 MVP 打磨：移除模拟立库场景与工厂画像注入，见 README）
 const world = { devices: [], alarms: [], kpi: {}, work_orders: [], inspections: {} };
@@ -1304,17 +1322,18 @@ const DEV_TOOLS = {
 const devCtx = { agentId: null };
 const devSessions = new Map();
 
-// 定制会话上下文裁剪：前端 sessionId 固定为 dev-<agentId前缀>，会话跨请求长存——不裁剪会无限增长，
-// 最终超过模型上下文窗口被网关整单拒绝（2026-10-21 海立实例"发消息没反应"根因）。
+// 会话上下文裁剪（dev/主对话共用）：前端 sessionId 固定（dev-<agentId前缀> / chat-<agentId>-<wsId>），会话跨请求长存——
+// 不裁剪会无限增长，最终超过模型上下文窗口被网关整单拒绝（2026-10-21 海立实例"发消息没反应"根因）。
+// 预算随设置页「上下文窗口（token）」联动：预留 16K token 给系统提示/当前轮/输出，1.6 char/token 对中文最坏比例（~0.67 token/char）仍在预留内。
+const ctxCharBudget = () => Math.max(4_000, Math.floor((llmContextTokens() - 16_000) * 1.6));
 // 超预算从最旧轮次整轮丢弃；下刀点只选 user 消息边界，剩余前缀不会出现孤儿 toolResult（转换层要求其紧跟 assistant 的 toolCall）；当前轮永不裁。
-const DEV_CTX_CHAR_BUDGET = 150_000; // 字符预算：混合中英/代码转录按 ~0.4 token/char 估 ≈ 60K token，对 128K 窗口留足余量
-function trimDevContext(ctx) {
+function trimContext(ctx, budget = ctxCharBudget()) {
   const msgs = ctx.messages;
   const size = () => msgs.reduce((n, m) => n + JSON.stringify(m.content ?? '').length, 0);
-  if (size() <= DEV_CTX_CHAR_BUDGET) return 0;
+  if (size() <= budget) return 0;
   const lastUser = msgs.length - 1 - [...msgs].reverse().findIndex((m) => m.role === 'user');
   let dropped = 0;
-  while (size() > DEV_CTX_CHAR_BUDGET) {
+  while (size() > budget) {
     const cut = msgs.slice(1, lastUser - dropped).findIndex((m) => m.role === 'user');
     if (cut < 0) break; // 当前轮之前再无完整轮次可丢（单轮就超预算只能放行，交由模型侧报错）
     dropped += cut + 1;
@@ -1340,24 +1359,28 @@ function devSystemPrompt() {
     '插件是一段 JS 代码，必须定义：function Panel(props) { return html`...` }',
     '· html 是 htm 模板标签（绑定 React.createElement），写法：html`<div className="text-xs">${x}</div>`',
     '· 可用 hooks：useState / useEffect / useRef / useMemo（已注入，直接用）',
+    '· 注入标识符 ui = 面板组件库（优先使用，禁止手拼等价样式）：',
+    '  ui.Card(卡片段落，title 仅用于面板内多节分节) ui.Badge(徽标) ui.Button(原生按钮) ui.Stat(KPI卡，可带 trend 趋势线)',
+    '  ui.Spark(迷你趋势线) ui.Bars(横向条形) ui.Matrix(状态点阵) ui.StatusDot/ui.StatusItem(统一状态行，列表一律用它)',
+    '  ui.Empty(空态插画) ui.Loading(骨架屏) ui.Error(错误态)——异步面板三态必用后三者',
+    '  组件写法：html`<${ui.StatusItem} key=${d.id} tone="warning" title=${d.id} detail=${d.detail} onClick=${() => onSelect(d.id)} />`',
+    '· 【标题分工·重要】面板标题/图标由平台统一渲染成面板头——插件首屏直接进入内容，禁止再写标题行（font-semibold 独立大字标题）',
     '· props（实时现场数据 + 交互）：',
     '  devices:[{id,name,type,status:normal|warning|alarm,detail}]  alarms:[{id,device,level:高|中|低,text,ts,state}]',
     '  kpi:{出入库吞吐:...}  work_orders:[{id,device,priority,state}]  selected(当前选中设备id)  onSelect(id)(选中设备)',
-    '· 样式用 Tailwind className（暗色主题；卡片 bg-card border rounded-lg p-3；主色 text-primary；状态色 emerald/amber/red）',
+    '  store: 平台数据集读写（store.list/create/update/remove，按助手×工作区隔离）——跨面板业务联动走共享数据集',
+    '· 手写样式时用 Tailwind className（暗色主题）：语义色 text-primary/text-success/text-warning/text-destructive/text-muted-foreground；底 bg-card/bg-muted；数值 tabular-nums 等宽；布局紧凑（面板常为窄条/半宽/通栏）',
     '· 禁止 import/require/window 操作；需要更多数据可 fetch("/api/state")',
-    '· 面板渲染于工作台左栏（宽约 290px）或中栏（dsl 里 slot:"center"），布局要紧凑',
     '',
     '【参考实现（严格仿照此风格）】',
     'function Panel({ devices, selected, onSelect }) {',
     '  const bad = devices.filter(d => d.status !== "normal")',
-    '  return html`<div className="p-2 text-xs">',
-    '    <div className="mb-2 font-semibold">异常设备 ${bad.length} 台</div>',
-    '    ${devices.filter(d=>d.status!=="normal").map(d => html`',
-    '      <div key=${d.id} onClick=${() => onSelect(d.id)}',
-    '        className=${"mb-1 cursor-pointer rounded border p-1.5 " + (d.status==="alarm" ? "border-red-500/60 bg-red-500/10" : "border-amber-500/50 bg-amber-500/5")}>',
-    '        <span className="font-mono">${d.id}</span> <span className="text-muted-foreground">${d.name}</span>',
-    '        <div className="text-[10px] text-muted-foreground">${d.detail}</div>',
-    '      </div>`)}',
+    '  return html`<div className="space-y-1.5 p-2">',
+    '    ${bad.length === 0 ? html`<${ui.Empty} text="设备运行全部正常" />`',
+    '      : bad.map(d => html`<${ui.StatusItem} key=${d.id}',
+    '          tone=${d.status === "alarm" ? "destructive" : "warning"}',
+    '          title=${d.id} detail=${d.detail} meta=${d.name}',
+    '          active=${selected === d.id} onClick=${() => onSelect(d.id)} />`)}',
     '  </div>`',
     '}',
     '',
@@ -1368,7 +1391,7 @@ function devSystemPrompt() {
     '【自探索工作流（必须遵守）】理解需求 → 探索 → 规划 → 实现 → 提交草稿：',
     '1. 探索：新需求涉及助手既有能力时，必须先 exec 读它的 AGENT.md（按名 grep 定位），必要时读其 skills/脚本与验证相关接口（curl 实测返回结构）。能推送通常就能搜索——从脚本/配置里找到真实的服务地址与 API。',
     '2. 规划：把探索结论映射为面板方案（数据从哪来、经什么能力取、展示成什么），方案要说清"复用了助手的哪个既有能力"。',
-    '3. 实现：面板运行在浏览器，内网接口跨域受限——一律经平台代理取数：fetch("/api/proxy?url=" + encodeURIComponent(接口地址))，返回 {status, body}。',
+    '3. 实现：面板运行在浏览器，内网接口跨域受限——一律经平台代理取数：fetch("/api/proxy?url=" + encodeURIComponent(接口地址))，返回 {status, body}。慢接口（>8s 的重查询）追加 &timeout_ms=30000（上限 60s）与 &max_kb=512（默认 128KB 会截断大结果）；但优先改用服务端过滤/分页参数（q=/limit/时间范围）减小单次拉取——不要靠放宽超时硬扛全量拉取。',
     '4. 提交：write_panel_plugin + update_workbench 草稿，明确告知用户审阅发布。',
     '【工作方式】改已有面板时基于当前 DSL 增量修改；单一职责，先小后大。',
     '【已装载技能（用前先 load_skill 读全文）】',
@@ -1417,7 +1440,7 @@ async function devChatLoop(session, emit, signal = null) {
       }
       final = await stream.result();
       // pi-ai 把认证/请求失败表现为 stopReason=error 而非异常（同 llmProbe 判定）——不检查会被吞成静默空回复
-      if (final?.stopReason === 'error') throw new Error(`LLM 请求失败: ${final.error?.errorMessage || JSON.stringify(final.error || {}).slice(0, 200) || final.stopReason}`);
+      if (final?.stopReason === 'error') throw new Error(`LLM 请求失败: ${final.errorMessage || final.rawStopReason || 'stop=error'}`);
     } catch (e) {
       if (!interrupted()) throw e; // 真实错误上抛给路由 catch → SSE error → 前端 toast；中断路径用占位消息兜底
     }
@@ -1483,12 +1506,13 @@ function systemPrompt(armAgent, deployment, autonomy, ws) {
     '',
     '【富回复块（a2ui）】当回复更适合组件而非长文本时，输出 ```a2ui 围栏块（内为严格 JSON，应用原生渲染）：',
     '- choice：需要用户做一个决定（2-5 个选项，可标 recommended:true；块必须是回复结尾；用户点击后以纯文本回传）',
+    '- 多维度选择（向导）：需要用户一次确定多个维度（如 设备+等级+时间范围）时，输出多个**连续** choice 块（彼此间不夹文字，均位于回复结尾）——应用自动合并为分步向导，用户逐题选择、全部完成确认后一次性回传（每行"问题: 答案"）；不要为多个维度分别发起独立提问',
     '- form：一次收集多个输入（1-6 字段 {id,label,kind,placeholder,required}；提交按"label: 答案"逐行回传）',
     '- steps：手工操作步骤（每步一句祈使句；warning/caution 放在它保护的那一步上）',
     '- callout：必须被注意的单一警示/提示（tone: note|tip|caution|warning）',
     '- metrics：少量读数一览（items:[{label,value,unit,warn,danger}]，注明 asOf）',
-    '规则：块前要有一句引导语；choice/form 之后不再有文字；数据必须来自工具实测并注明 asOf，不得编造；一个回复最多 1-2 个块。用户说"给选项/怎么选/选哪个"时优先用 choice。',
-    '强化：凡回复包含 2 个及以上并列的可选动作时，一律用 choice 块呈现（不要用编号/短横线列表罗列选项）。需要采集多个参数（设备/日期/原因等）时用 form 块。示例：\n服务器 CPU 持续 90%，如何处置？\n```a2ui\n{"type":"choice","question":"服务器 CPU 90% 的处置方式","options":[{"label":"先持续观察 30 分钟","description":"短期可控"},{"label":"定位高 CPU 进程","description":"top 找出元凶再决定","recommended":true},{"label":"立即重启服务","description":"影响可用性，需值班确认"}]}\n```',
+    '规则：块前要有一句引导语；choice/form 之后不再有文字；数据必须来自工具实测并注明 asOf，不得编造；一个回复最多 1-2 个块（例外：多维度选择的连续 choice 串，按一组合并向导计）。用户说"给选项/怎么选/选哪个"时优先用 choice。',
+    '强化：凡回复包含 2 个及以上并列的可选动作时，一律用 choice 块呈现（不要用编号/短横线列表罗列选项）。需要采集多个输入（设备/日期/原因等）时用 form 块。示例：\n服务器 CPU 持续 90%，如何处置？\n```a2ui\n{"type":"choice","question":"服务器 CPU 90% 的处置方式","options":[{"label":"先持续观察 30 分钟","description":"短期可控"},{"label":"定位高 CPU 进程","description":"top 找出元凶再决定","recommended":true},{"label":"立即重启服务","description":"影响可用性，需值班确认"}]}\n```\n多维度选择示例（连续 choice 串 = 分步向导，用户全选完才回传）：生成巡检报告前请确认范围：\n```a2ui\n{"type":"choice","question":"设备范围","options":[{"label":"STK-R1 巷道堆垛机"},{"label":"STK-R3 巷道堆垛机","recommended":true},{"label":"全部立库设备"}]}\n```\n```a2ui\n{"type":"choice","question":"时间范围","options":[{"label":"近 24 小时","recommended":true},{"label":"近 7 天"},{"label":"自定义"}]}\n```\n```a2ui\n{"type":"choice","question":"报告侧重","options":[{"label":"异常与告警优先","recommended":true},{"label":"全面均衡"}]}\n```',
   ].join('\n');
 }
 
@@ -1643,6 +1667,7 @@ const server = http.createServer(async (req, res) => {
           model: llmModelName(), model_runtime: !!cfg.llm_model, catalog: llmCatalog,
           key_set: !!k, key_masked: k ? `${k.slice(0, 6)}…${k.slice(-4)}` : '',
           key_source: cfg.llm_api_key ? 'runtime' : (env.LLM_API_KEY ? 'env' : 'none'),
+          context_tokens: llmContextTokens(), context_tokens_runtime: !!cfg.llm_context_tokens, default_context_tokens: LLM_DEFAULT_CONTEXT_TOKENS,
         },
         scene: { profile: sceneProfile(), length: sceneProfile().length },
         auth: { enabled: !!accessToken(), token_masked: accessToken() ? `${accessToken().slice(0, 4)}…${accessToken().slice(-2)}` : '' },
@@ -1650,7 +1675,7 @@ const server = http.createServer(async (req, res) => {
       });
     }
     if (req.method === 'PUT' && pathname === '/api/settings') {
-      const { arm_api_base, arm_token, llm_base_url, llm_api_key, llm_model, scene_profile, access_token, guard } = await body(req);
+      const { arm_api_base, arm_token, llm_base_url, llm_api_key, llm_model, llm_context_tokens, scene_profile, access_token, guard } = await body(req);
       // 守护栏维护：deny 正则可编译 / ro 须为单命令名；保存即热生效（classifyExec 每次调用现读配置）；删减危险规则记入审计
       let guardAudit = null;
       if (guard !== undefined) {
@@ -1692,6 +1717,15 @@ const server = http.createServer(async (req, res) => {
         if (m && !/^[\w.:@\/-]{1,80}$/.test(m)) return json(res, 400, { error: `模型名不合法：${m}` });
         cfg.llm_model = m;
       }
+      if (llm_context_tokens !== undefined) { // 上下文窗口（token）：驱动会话裁剪预算；留空/0 = 默认 128K。不影响 provider，无需热切换
+        const raw = String(llm_context_tokens ?? '').trim();
+        if (raw === '') cfg.llm_context_tokens = 0;
+        else {
+          const n = Math.floor(+raw);
+          if (!Number.isFinite(n) || n < 4_000 || n > 2_000_000) return json(res, 400, { error: `上下文窗口须为 4000-2000000 的 token 数（留空 = 默认 ${LLM_DEFAULT_CONTEXT_TOKENS}）：${raw}` });
+          cfg.llm_context_tokens = n;
+        }
+      }
       if (llm_api_key !== undefined) cfg.llm_api_key = String(llm_api_key || '').trim();
       // LLM 热切换：先应用验证，失败整体回滚（应用只是构建对象，无网络请求）
       let llm_probe = null;
@@ -1706,7 +1740,7 @@ const server = http.createServer(async (req, res) => {
         try { llm_probe = await llmProbe(); } catch (e) { llm_probe = { online: false, error: String(e.message).slice(0, 150) }; }
       }
       saveCfg();
-      audit({ actor: 'settings', action: 'save', arm_api_base: cfg.arm_api_base, llm_model: cfg.llm_model, llm_base_changed: llm_base_url !== undefined, token_changed: arm_token !== undefined || llm_api_key !== undefined, scene_profile_changed: sceneChanged, scene_profile_len: sceneProfile().length, auth_changed: authChanged, guard_changed: guardAudit });
+      audit({ actor: 'settings', action: 'save', arm_api_base: cfg.arm_api_base, llm_model: cfg.llm_model, llm_context_tokens: cfg.llm_context_tokens, llm_base_changed: llm_base_url !== undefined, token_changed: arm_token !== undefined || llm_api_key !== undefined, scene_profile_changed: sceneChanged, scene_profile_len: sceneProfile().length, auth_changed: authChanged, guard_changed: guardAudit });
       // ARM 保存后即时探测（失败不回滚：允许先配置后启动 ARM）
       let probe = { online: false, error: '' };
       if ([arm_api_base, arm_token].some((v) => v !== undefined)) {
@@ -1794,8 +1828,12 @@ const server = http.createServer(async (req, res) => {
         };
         const stream = models.stream(model, ctx);
         let out = '';
-        for await (const ev of stream) { if (ev.type === 'text_delta') out += ev.delta; }
+        for await (const ev of stream) {
+          if (ev.type === 'text_delta') out += ev.delta;
+          else if (ev.type === 'error') throw new Error(`LLM 流错误: ${ev.error?.errorMessage || JSON.stringify(ev.error).slice(0, 200)}`); // pi-ai 失败不抛异常，须显式拦截，否则 200 返回空 prompt
+        }
         const final = await stream.result();
+        if (final?.stopReason === 'error') throw new Error(`LLM 请求失败: ${final.errorMessage || final.rawStopReason || 'stop=error'}`);
         const text = ((final.content || []).filter(b => b.type === 'text').map(b => b.text).join('') || out).trim();
         let draftName = '', prompt = text;
         const jm = text.match(/\{[\s\S]*\}/); // JSON 容错解析：失败则整段当 prompt，不阻断
@@ -1977,6 +2015,38 @@ const server = http.createServer(async (req, res) => {
       if (!loadWorkbench(agent_id)) saveWorkbench(agent_id, defaultWorkbench(dep)); // 新上岗自动生成初版工作台
       return json(res, 200, { deployment: dep });
     }
+    // ── 二开灵感库：按助手自描述动态生成（固定库面向设备场景，对其他助手是噪声）──
+    if (req.method === 'GET' && pathname === '/api/dev/inspirations') {
+      const agentId = url.searchParams.get('agent_id') || '';
+      const brief = agentBrief(agentId);
+      const refresh = url.searchParams.get('refresh') === '1'; // 换一批：绕缓存重新生成并覆盖
+      const key = `${agentId}|${brief.length}|${brief.slice(0, 200)}`;
+      const hit = refresh ? null : inspCache.get(key);
+      if (hit) return json(res, 200, { items: hit, source: 'agent' });
+      const GENERIC_INSPIRATIONS = [
+        { emoji: '📋', title: '最近记录', desc: '该助手数据集/操作的最近 20 条时间线', prompt: '新建一个区块：展示我数据集里最近 20 条记录的倒序时间线（ui.StatusItem，按重要程度着色），数据不足时先建合适的数据集' },
+        { emoji: '⭐', title: '关键指标', desc: '一眼看当前状态的大数字卡', prompt: '新建一个区块：用 ui.Stat 大数字卡展示当前最关键的状态指标（数据从 /api/state 或数据集取），异常着色' },
+        { emoji: '✅', title: '待办清单', desc: '可勾选的任务列表', prompt: '先建 todos 数据集（title/done/due），再做一个面板：ui.StatusItem 待办列表 + 完成态切换（store.update），顶部 ui.Button 清除已完成' },
+        { emoji: '📊', title: '分类统计', desc: '按类型/状态计数条形图', prompt: '新建一个区块：对相关数据按类型或状态聚合计数，用 ui.Bars 横向条形展示' },
+        { emoji: '🔍', title: '快速检索', desc: '对其数据集的关键词搜索面板', prompt: '新建一个区块：输入关键词检索我的数据集（store.list filter 或接口查询），结果用 ui.StatusItem 列表展示，带加载/空/错误三态' },
+        { emoji: '🕒', title: '活动流水', desc: '今天发生的事件流', prompt: '新建一个区块：今天发生的事件/变更流水（按时间倒序），新条目突出显示，支持点击查看详情' },
+      ];
+      if (!brief || !model) return json(res, 200, { items: GENERIC_INSPIRATIONS, source: 'generic' });
+      try {
+        const raw = await llmComplete(
+          '你是工业智能体平台的「工作台定制灵感策划」。根据助手的自描述，为它的定制工作台生成 6 个面板灵感。要求：0) 多样性：从监控/操作/统计/检索/趋势/健康等维度组合挑选，同助手多次生成要有明显差异；1) 每个灵感贴合该助手的真实职责与数据（自描述里提到的系统/脚本/接口），不要套用与它无关的模板；2) prompt 是给二开助手的完整需求描述，必须引用可用的 ui kit 组件（ui.Card/Badge/Button/Stat/Spark/Bars/Matrix/StatusItem/StatusDot/Empty/Loading/Error）并遵守契约：面板标题由平台渲染、插件首屏不写标题行、列表用 ui.StatusItem、KPI 用 ui.Stat（可带 trend）；3) 输出严格为 JSON 数组，每项 {"emoji":"单字符","title":"≤6字","desc":"≤20字一句人话","prompt":"完整需求"}，不要输出其他任何文字。',
+          `助手自描述：\n${brief}`,
+        );
+        const arr = JSON.parse((raw.match(/\[[\s\S]*\]/) || [''])[0]);
+        const items = Array.isArray(arr) ? arr.filter((x) => x && x.title && x.prompt).slice(0, 6).map((x) => ({ emoji: String(x.emoji || '✨').slice(0, 2), title: String(x.title).slice(0, 12), desc: String(x.desc || '').slice(0, 40), prompt: String(x.prompt) })) : [];
+        if (!items.length) throw new Error('空结果');
+        inspCache.set(key, items);
+        return json(res, 200, { items, source: 'agent' });
+      } catch {
+        return json(res, 200, { items: GENERIC_INSPIRATIONS, source: 'generic' });
+      }
+    }
+
     if (req.method === 'GET' && pathname === '/api/tools') {
       return json(res, 200, { tools: Object.entries(TOOLS).map(([n, t]) => ({ name: n, description: t.desc, min_level: t.min_level, confirm_required: t.confirm_required })) });
     }
@@ -2017,7 +2087,9 @@ const server = http.createServer(async (req, res) => {
       const toolsAvail = dep.toolset.map(t => t.tool).join(', ');
       const sys = '你是工业智能体平台的工作台设计师。根据助手档案生成工作台 DSL（JSON）。面板类型只允许: realtime_list(实时告警流)/status_grid(设备状态矩阵)/agent_dialog(诊断对话)/action_group(操作区)/kpi_strip(指标条)/inspection_report(自检报告)。结构: {"workbench":"名称","owner_agent":"agentId","version":"v0.1-draft","layout":[...],"panels":[{"id","type","title"}...]}。action_group 的 panels 含 "actions":[{"id","label","orchestration","autonomy","confirm":{"text","double_check"}}]，orchestration 只能引用这些: logic://设备复位流程@mock / logic://告警派工@mock / logic://服务滚动重启@mock / logic://环境自检@mock。只输出 JSON，不要 markdown 代码围栏。';
       const user = `助手: ${arm.name} ${arm.version}\n职责: ${arm.prompt}\n可用工具: ${toolsAvail}\n默认自主级别: ${dep.default_autonomy}\n请生成 4-6 个面板，含一个 agent_dialog 和一个 action_group。`;
-      const out = await llmComplete(sys, user);
+      let out;
+      try { out = await llmComplete(sys, user); }
+      catch (e) { return json(res, 502, { error: `AI 草稿生成失败: ${e.message}` }); }
       const cleaned = out.replace(/```json|```/g, '').trim();
       let draft;
       try { draft = JSON.parse(cleaned); } catch (e) { return json(res, 502, { error: 'AI 草稿解析失败', raw: cleaned.slice(0, 500) }); }
@@ -2046,15 +2118,25 @@ const server = http.createServer(async (req, res) => {
       if (!proxyAllowedHosts().has(host)) {
         return json(res, 403, { error: `主机 ${host} 未在任何插件中声明（代理仅允许插件代码中出现过的主机，防面板成为任意内网跳板）` });
       }
+      // 按次声明的时限/体量（插件代码里可见、人审可查）：轻查询用默认，重接口单独放宽，钳制防无界
+      const clamp = (v, min, max, dflt) => { if (v === null || v === undefined || v === '') return dflt; const n = Math.round(+v); return Number.isFinite(n) ? Math.min(Math.max(n, min), max) : dflt }
+      const timeoutMs = clamp(url.searchParams.get('timeout_ms'), 1000, 60000, 8000);
+      const maxKb = clamp(url.searchParams.get('max_kb'), 16, 512, 128);
+      const t0 = Date.now();
       try {
         const ctrl = new AbortController();
-        const timer = setTimeout(() => ctrl.abort(), 8000);
+        const timer = setTimeout(() => ctrl.abort(), timeoutMs);
         const r = await fetch(u, { signal: ctrl.signal });
         clearTimeout(timer);
-        const body = (await r.text()).slice(0, 128 * 1024);
-        audit({ actor: 'panel-proxy', url: u.slice(0, 120), status: r.status });
+        const body = (await r.text()).slice(0, maxKb * 1024);
+        audit({ actor: 'panel-proxy', url: u.slice(0, 120), status: r.status, duration_ms: Date.now() - t0, timeout_ms: timeoutMs, max_kb: maxKb });
         return json(res, 200, { status: r.status, body });
-      } catch (e) { return json(res, 502, { error: `代理请求失败: ${e.message}` }); }
+      } catch (e) {
+        const timedOut = e.name === 'AbortError';
+        audit({ actor: 'panel-proxy', url: u.slice(0, 120), error: timedOut ? 'timeout' : String(e.message).slice(0, 80), duration_ms: Date.now() - t0, timeout_ms: timeoutMs });
+        if (timedOut) return json(res, 502, { error: `代理超时（${timeoutMs}ms）：接口未在时限内返回。可在代理调用追加 &timeout_ms=30000（上限 60s，重接口按需放宽）；更优解是改用服务端过滤/分页参数（q=/limit/时间范围）减小单次拉取量`, timeout_ms: timeoutMs });
+        return json(res, 502, { error: `代理请求失败: ${e.message}` });
+      }
     }
 
     // ── 面板运行错误（debug 的眼睛：错误边界/编译失败上报，供 AI 调试取证）──
@@ -2344,7 +2426,7 @@ const server = http.createServer(async (req, res) => {
           s.context.systemPrompt = devSystemPrompt();
         }
         s.context.messages.push({ role: 'user', content: message, timestamp: Date.now() });
-        const dropped = trimDevContext(s.context);
+        const dropped = trimContext(s.context);
         if (dropped > 0) emit('status', { text: `会话历史过长，已自动裁剪最早 ${dropped} 条消息` });
         await devChatLoop(s, emit, ctl.signal);
         emit('meta', { hasDraft: !!loadDraft(agentId) });
@@ -2375,6 +2457,8 @@ const server = http.createServer(async (req, res) => {
           return res.end();
         }
         s.context.messages.push({ role: 'user', content: context ? `${message}\n（界面注入上下文：当前选中设备 ${context.device}）` : message, timestamp: Date.now() });
+        const dropped = trimContext(s.context); // 主对话 sessionId 同样固定（chat-<agentId>-<wsId>），不裁剪会同样撑死
+        if (dropped > 0) emit('status', { text: `会话历史过长，已自动裁剪最早 ${dropped} 条消息` });
         s.running = true; s.sinceTs = Date.now(); s.abortCtl = ctl;
         const out = await agentLoop(s, deployment, emit, ctl.signal);
         emit('done', { reply: out.reply, pending: out.pending });
@@ -2418,6 +2502,18 @@ const server = http.createServer(async (req, res) => {
       finally { finished = true; if (s) { s.running = false; s.statusText = ''; s.abortCtl = null; } }
       return res.end();
     }
+    // ── 会话清空：主动丢弃上下文重开（上下文污染/换思路）；运行中拒绝（先中断），pending 确认卡随会话一并作废 ──
+    if (req.method === 'POST' && pathname === '/api/session/reset') {
+      const { scope, sessionId } = await body(req);
+      if (!sessionId || !String(sessionId).trim()) return json(res, 400, { error: '缺少 sessionId' });
+      const store = scope === 'dev' ? devSessions : sessions;
+      const s = store.get(String(sessionId).trim());
+      if (!s) return json(res, 200, { ok: true, note: '会话本就为空' });
+      if (s.running) return json(res, 409, { error: '会话正在处理中，请先中断再清空' });
+      store.delete(String(sessionId).trim());
+      audit({ actor: 'user', action: 'session-reset', scope: scope === 'dev' ? 'dev' : 'chat', sessionId: String(sessionId).slice(0, 48) });
+      return json(res, 200, { ok: true });
+    }
     // ── 会话历史与进度（切换助手后回来：上下文回放 + 后台运行状态；服务端为唯一事实源）──
     if (req.method === 'GET' && pathname === '/api/chat/history') {
       const sid = url.searchParams.get('sessionId');
@@ -2470,7 +2566,9 @@ const server = http.createServer(async (req, res) => {
       if (!s) return json(res, 400, { error: '会话不存在' });
       const convo = s.context.messages.filter(m => m.role === 'user' || m.role === 'assistant')
         .slice(-12).map(m => `${m.role === 'user' ? '用户' : '助手'}: ${(m.content || []).filter?.(b => b.type === 'text').map(b => b.text).join('') ?? m.content}`).join('\n');
-      const md = await llmComplete('你是经验沉淀器。把运维对话提炼为一条结构化经验 markdown，章节固定：## 现象 / ## 根因 / ## 处置步骤 / ## 验证 / ## 预防。事实不确定就写"待确认"。只输出 markdown 正文。', convo || '（空会话）');
+      let md;
+      try { md = await llmComplete('你是经验沉淀器。把运维对话提炼为一条结构化经验 markdown，章节固定：## 现象 / ## 根因 / ## 处置步骤 / ## 验证 / ## 预防。事实不确定就写"待确认"。只输出 markdown 正文。', convo || '（空会话）'); }
+      catch (e) { return json(res, 502, { error: `经验起草失败: ${e.message}` }); }
       return json(res, 200, { markdown: md });
     }
     if (req.method === 'POST' && pathname === '/api/experience/commit') {

package/skills/workbench-dev/SKILL.md

@@ -19,12 +19,21 @@ function Panel(props) { return html`<div className="...">…</div>` }
 
 - `html`：htm 模板标签（已绑定 React.createElement），写法 `html`<div className="text-xs">${x}</div>``
 - 可用 hooks：`useState / useEffect / useRef / useMemo`（已注入，无需导入）
+- **UI kit `ui`（已注入，优先使用）**：`ui.Card / ui.Badge / ui.Button / ui.Stat / ui.Spark / ui.Bars /
+  ui.Matrix / ui.StatusDot / ui.StatusItem / ui.Empty / ui.Loading / ui.Error`。
+  组件经 htm 语法使用：`` html`<${ui.Card} title="标题">内容<//>` ``（自闭合写 `<${ui.Empty} />`）。
+  三态（加载/空/错误）用 `ui.Loading / ui.Empty / ui.Error`；列表行用 `ui.StatusItem`（统一状态语言）；
+  KPI 用 `ui.Stat`（可带 trend 趋势线）；趋势/分布/多设备健康分别用 `ui.Spark / ui.Bars / ui.Matrix`。
+- **标题分工**：面板标题由平台渲染成面板头——插件首屏直接进入内容，**勿写标题行**；
+  DSL 可设 `bare: true` 做通栏视觉面板（无头无边框，适合 KPI 条/图表墙/矩阵）
 - **props（运行时注入）**：
   - `devices / alarms / kpi / work_orders`：现场实时数据
   - `selected / onSelect(id)`：设备选中态与回传
   - `store`：平台数据集读写 `store.list(name, {filter,sort,limit}) / create / update / remove`（按助手隔离）
-- 样式：Tailwind className（暗色主题；卡片 `bg-card border rounded-lg p-3`；主色 `text-primary`；状态色 emerald/amber/red）
-- 跨域取数：`fetch("/api/proxy?url=" + encodeURIComponent(url))` → `{status, body}`（平台代取；仅允许插件代码中声明过的主机）
+- 样式：优先 ui kit；手写时用 Tailwind className（暗色主题；语义色 `text-success / text-warning / text-destructive`，
+  状态色 emerald/amber/red）。**可用类词汇以 `web/src/index.css` 的 `@source inline` safelist 为准**——
+  safelist 外的新类不会进构建产物（静默丢样式）；需要新词汇时先扩 safelist 再用
+- 跨域取数：`fetch("/api/proxy?url=" + encodeURIComponent(url))` → `{status, body}`（平台代取；仅允许插件代码中声明过的主机；慢接口加 `&timeout_ms=30000`（上限 60s）、大结果加 `&max_kb=512`，优先服务端过滤减小拉取）
 - **禁止**：`import / require / window / document / globalThis`（校验器与沙箱双重拦截）
 - 完整字段与常见错误见 [references/panel-contract.md](references/panel-contract.md)
 

package/skills/workbench-dev/references/panel-contract.md

@@ -2,10 +2,46 @@
 
 ## 运行环境
 
-- 代码经 `new Function('React','html','useState','useEffect','useRef','useMemo', code + ';return Panel')` 在浏览器编译执行
+- 代码经 `new Function('React','html','ui','useState','useEffect','useRef','useMemo', code + ';return Panel')` 在浏览器编译执行
 - htm 绑定 React.createElement：组件、属性、事件、列表 key 与 React 语义一致
 - 错误边界包裹：编译失败/运行时错误显示在面板内，不白屏
 
+## 标题分工与 bare 模式（面板头契约）
+
+- **标识归壳**：面板标题/图标/副标题由平台网格统一渲染成面板头（DSL `title/icon/subtitle`）——
+  **插件首屏直接进入内容，禁止写标题行**（font-semibold 独立大字标题）。`ui.Card` 的 `title` 仅用于面板内部多节分节。
+- **bare 逃生舱**（DSL `bare: true`）：无面板头/无边框/透明底，内容顶格——适合 KPI 条、图表墙、状态矩阵等
+  **全画布视觉面板**。信息型列表面板保持默认框架头。选择标准：面板是"看数据本身"用 bare，是"读一组信息"用框架头。
+
+## ui kit（注入标识符 `ui`，优先于手写样式）
+
+纯 React 组件集（实现见 `web/src/components/panel-kit.tsx`），htm 中经 `<${ui.X} …>` 使用、`<//>` 闭合：
+
+| 组件 | 关键 props | 说明 |
+|---|---|---|
+| `ui.Card` | `title?` `actions?` `flush?` `className?` | 卡片容器；DSL 面板标题已由网格渲染成面板头，**插件内 Card 的 title 仅用于内部分节**；`flush` 通栏变体（p-0，标题行变分隔线） |
+| `ui.Badge` | `tone?: primary\|success\|warning\|destructive\|muted` | 圆角状态徽标（语义色） |
+| `ui.Button` | `variant?: primary\|secondary\|danger\|ghost` + 原生 button 属性 | 原生 `<button>`（键盘可达、focus ring），默认 `type="button"` |
+| `ui.Stat` | `label` `value` `hint?` `tone?` `trend?: number[]` | KPI 指标卡；`trend` 传数值数组自动内嵌迷你趋势线；数值等宽对齐；**value 变化自动提亮反馈**（轮询数据跳变可见） |
+| `ui.Spark` | `data: number[]` `tone?`（含 `'chart'`）`height?` | 迷你趋势线（纯 SVG：面积+折线+末端点）；单点数据返回 null |
+| `ui.Bars` | `items: {label,value,tone?}[]` | 横向微型条形（告警等级/工单优先级分布），自动归一 |
+| `ui.Matrix` | `items: {tone?,title?}[]` `cell?` `gap?` | 状态点阵——几十个对象健康状态一屏看全，替代长表格 |
+| `ui.StatusDot` | `tone?` `pulse?` | 状态色点；destructive 场景可 pulse |
+| `ui.StatusItem` | `tone?` `title` `detail?` `meta?` `active?` `onClick?` | **统一状态行**（左色条+状态点+背景 tint+选中环，可键盘操作）——设备行/告警行/工单行都用它；active 变 true 时自动 pulse 联动反馈 |
+| `ui.Empty` | `text?` | 空态（雷达线稿插画 + 虚线边框） |
+| `ui.Loading` | `rows?` `text?` | 加载骨架屏（默认 3 行 shimmer） |
+| `ui.Error` | `text?` | 错误态（destructive 底色，自动加"加载失败："前缀） |
+
+异步面板的三态一律用 `ui.Loading / ui.Empty / ui.Error`（对应校验器 W4/W5 关注点），不再手写。
+列表行一律 `ui.StatusItem`，不要手拼"色点+文字"的 div。
+
+## Tailwind 类词汇（手写样式时）
+
+暗色主题。优先语义色：`text-primary / text-success / text-warning / text-destructive / text-muted-foreground`，
+卡片/容器底 `bg-card bg-muted bg-secondary`。**可用类词汇以 `web/src/index.css` 中的 `@source inline` safelist 为准**
+（状态色 emerald/amber/red 系列、常用布局密度类）；safelist 之外的新类不会进构建产物——样式会静默丢失。
+需要新词汇：先扩 safelist（并在本文件登记），再使用。
+
 ## props 全量
 
 | prop | 类型 | 说明 |
@@ -37,7 +73,8 @@ store.remove(name, id)              // → Promise<true>
 3. **await 无 catch**：异步失败静默，界面无反馈 → try/catch 或 `.catch(setError)`
 4. **无加载/空/错误三态**：异步面板首帧空白 → `items===null` 显示加载、`[]` 显示空态、catch 显示错误
 5. **IME 回车误发**：`onKeyDown` 判断 `e.nativeEvent.isComposing`（或 htm 下 `e.isComposing`）
-6. **Nexus 类 API 参数**：`name=` 是精确匹配（带分组全名），模糊搜索用 `q=`；分页用 `continuationToken` 循环
+6. **慢接口/大结果**：代理默认 8s 超时、128KB 截断——重查询追加 `&timeout_ms=30000`（上限 60s）与 `&max_kb=512`；但优先用服务端过滤/分页参数（q=/limit/时间范围）减小单次拉取
+7. **Nexus 类 API 参数**：`name=` 是精确匹配（带分组全名），模糊搜索用 `q=`；分页用 `continuationToken` 循环
 
 ## 校验器（产出前必跑）
 
@@ -52,7 +89,7 @@ node scripts/check-panel.mjs < panel.js   # 或 node scripts/check-panel.mjs pan
 ## 骨架模板
 
 ```js
-function Panel({ devices, alarms, selected, onSelect, store }) {
+function Panel({ store }) {
   const [rows, setRows] = useState(null)
   const [error, setError] = useState(null)
   useEffect(() => {
@@ -60,14 +97,17 @@ function Panel({ devices, alarms, selected, onSelect, store }) {
       .then(setRows)
       .catch(e => setError(e.message))
   }, [])
-  if (error) return html`<div className="p-3 text-xs text-red-400">加载失败：${error}</div>`
-  if (rows === null) return html`<div className="p-3 text-xs text-muted-foreground">加载中…</div>`
-  if (!rows.length) return html`<div className="p-3 text-xs text-muted-foreground">暂无记录</div>`
-  return html`<div className="p-2 text-xs">
-    ${rows.map(r => html`<div key=${r._id} className="mb-1 rounded border bg-card p-1.5">
-      <span className="font-mono">${r.name}</span>
-      <div className="text-[10px] text-muted-foreground">${r.detail || ''}</div>
-    </div>`)}
+  if (error) return html`<${ui.Error} text=${error} />`
+  if (rows === null) return html`<${ui.Loading} />`
+  if (!rows.length) return html`<${ui.Empty} text="暂无记录" />`
+  return html`<div className="space-y-1.5 p-2">
+    ${rows.map(r => html`<${ui.StatusItem} key=${r._id}
+      tone=${r.done ? 'success' : 'warning'} title=${r.name} detail=${r.detail || ''}
+      meta=${r.date} onClick=${() => onPick(r)} />`)}
   </div>`
 }
 ```
+
+htm 组件语法备忘：自闭合 `<${ui.Empty} text="…" />`；含子元素闭合写 `<//>`。
+KPI 场景：`<${ui.Stat} label="OEE" value="86.5%" trend=${[70,74,80,83,86.5]} tone="success" />`。
+旧式 6 标识符（无 `ui`）代码仍然兼容可跑，但新代码一律用 kit。

package/skills/workbench-dev/scripts/check-panel.mjs

@@ -16,9 +16,9 @@ if (/\b(window|document|globalThis)\b/.test(code)) errors.push('E2 沙箱违规
 // E3 模板完整性：反引号必须成对
 const ticks = (code.match(/`/g) || []).length;
 if (ticks % 2 !== 0) errors.push(`E3 模板断裂：反引号数量为奇数(${ticks})，html\`\` 模板未闭合`);
-// E4 编译检查：与运行时一致的 new Function 编译
+// E4 编译检查：与运行时一致的 new Function 编译（运行时还注入 ui = panel-kit 组件集，见 web/src/components/panel-kit.tsx）
 try {
-  const factory = new Function('React', 'html', 'useState', 'useEffect', 'useRef', 'useMemo',
+  const factory = new Function('React', 'html', 'ui', 'useState', 'useEffect', 'useRef', 'useMemo',
     `"use strict";\n${code}\n;if (typeof Panel !== 'function') throw new Error('no Panel');\nreturn Panel;`);
   if (typeof factory !== 'function') errors.push('E4 编译失败');
 } catch (e) { errors.push(`E4 编译失败：${e.message}`); }
@@ -34,6 +34,10 @@ if (/onInput/.test(code) && /onChange/.test(code)) warnings.push('W2 同时使
 if (!/key=/.test(code) && /\.map\(/.test(code)) warnings.push('W3 列表渲染(.map)缺少 key 属性');
 if (/await /.test(code) && !/try\s*{|\.catch\(/.test(code)) warnings.push('W4 存在 await 但无 try/catch 或 .catch，失败会静默');
 if (!/(loading|加载|…|\.\.\.)|useEffect/.test(code) && /store\.(list|create)/.test(code)) warnings.push('W5 异步读写无加载态提示，首帧可能空白');
+// W6：首屏疑似标题行——独立 font-semibold 文本行会与平台面板头重复标识（面板标题由网格渲染成面板头）
+if (/<div[^>]*\bfont-semibold\b[^>]*>([^<]*\$\{[^}]*\})?[^<]*<\/div>/.test(code)) {
+  warnings.push('W6 疑似标题行（font-semibold 独立文本行）：面板标题由平台面板头渲染，插件首屏直接进入内容，勿重复标题');
+}
 
 const verdict = errors.length ? 'REJECT' : 'PASS';
 const lines = [