aims-workstation 0.1.11 → 0.1.13

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=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
+# NPM_TOKEN=

package/package.json

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

package/server.js

@@ -236,6 +236,19 @@ async function armRest(pathname, init = {}, timeout_ms = 20000) {
 async function armCreateKnowledge({ name, description, content, tags }) {
   return armRest('/api/v1/knowledges', { method: 'POST', body: JSON.stringify({ name, description, content, tags }) }, 25000);
 }
+
+// 经验与助手关联：沉淀出的知识绑定到当前助手（助手检索范围=已绑定知识；缺这步=沉淀了但检索不到）。
+// 绑定失败不阻断沉淀（老版 ARM 无端点时仅审计留痕）。
+async function bindExperienceToAgent(agentId, knowledgeId) {
+  try {
+    await armRest(`/api/v1/agents/${agentId}/knowledges`, { method: 'POST', body: JSON.stringify({ knowledgeId, kind: 'experience' }) });
+    audit({ actor: 'experience-reflow', target: 'ARM', action: 'bind', agentId, knowledge_id: knowledgeId });
+    return true;
+  } catch (e) {
+    audit({ actor: 'experience-reflow', target: 'ARM', action: 'bind-failed', agentId, knowledge_id: knowledgeId, error: String(e.message || e).slice(0, 90) });
+    return false;
+  }
+}
 const vVer = (v) => (String(v || '').startsWith('v') ? String(v) : `v${v || '0.0.0'}`); // REST 无 v 前缀，统一内部表示
 
 const agentCache = new Map();
@@ -399,7 +412,7 @@ async function flushExperienceOutbox() {
   const lines = fs.readFileSync(OUTBOX_FILE, 'utf8').split('\n').filter(Boolean);
   const remain = []; let ok = 0;
   for (const line of lines) {
-    try { const it = JSON.parse(line); await armCreateKnowledge(it.args); ok++; }
+    try { const it = JSON.parse(line); const r = await armCreateKnowledge(it.args); if (it.agentId && r?.id) await bindExperienceToAgent(it.agentId, r.id); ok++; }
     catch { remain.push(line); }
   }
   fs.writeFileSync(OUTBOX_FILE, remain.length ? remain.join('\n') + '\n' : '');
@@ -618,7 +631,7 @@ const TOOLS = {
     desc: '把本次处置经验沉淀进企业知识库（ARM 经验库；离线时存本地待回流队列）',
     run: async ({ title, markdown }, agentId) => {
       const arm = agentProfileNow(agentId);
-      const content = ['---', 'kind: experience', 'source: aims-platform-mvp', `agent: ${arm.name || agentId}@${arm.version || ''}`, 'scenario: 立库A区智能运维@mvp', '---', '', markdown].join('\n');
+      const content = ['---', 'kind: experience', 'source: aims-platform-mvp', `agent_id: ${agentId}`, `agent: ${arm.name || agentId}@${arm.version || ''}`, 'scenario: 立库A区智能运维@mvp', '---', '', markdown].join('\n');
       const args = { name: title, description: `MVP回流：${title}`, content, tags: ['MVP回流'] };
       let r;
       try { r = await armCreateKnowledge(args); }
@@ -627,9 +640,10 @@ const TOOLS = {
         audit({ actor: 'experience-reflow', target: 'outbox', title });
         return `ARM 不可达（${String(e.message).slice(0, 60)}），经验已存本地待回流队列；恢复连接后在助手大厅点「检查更新」将自动回流。`;
       }
+      const bound = await bindExperienceToAgent(agentId, r.id);
       metric({ kind: 'experience', agentId, title, knowledge_id: r.id });
-      audit({ actor: 'experience-reflow', target: 'ARM', title });
-      return `经验已沉淀到 ARM 知识库：${r.name}（id: ${r.id}${r.shareUrl ? `，${r.shareUrl}` : ''}）`;
+      audit({ actor: 'experience-reflow', target: 'ARM', title, bound });
+      return `经验已沉淀到 ARM 知识库：${r.name}（id: ${r.id}${r.shareUrl ? `，${r.shareUrl}` : ''}）${bound ? '，并已绑定到当前助手（检索即得）' : '；绑定助手未成功（已在审计留痕），可到 ARM 手动关联'}`;
     },
   },
 };
@@ -674,7 +688,23 @@ function loadWorkbench(agentId) {
   const p = path.join(WB_DIR, `${agentId}.json`);
   return fs.existsSync(p) ? JSON.parse(fs.readFileSync(p, 'utf8')) : null;
 }
+// ── 多视图契约（DSL v2）：views 为场景视图；panels 始终同步为各视图面板的扁平拼接（存量读取点零改动）──
+function viewsOfSrv(dsl) {
+  if (Array.isArray(dsl?.views) && dsl.views.length) return dsl.views
+  return [{ id: 'main', name: '主视图', panels: Array.isArray(dsl?.panels) ? dsl.panels : [] }]
+}
+function normDsl(dsl) {
+  if (!dsl || typeof dsl !== 'object') return dsl
+  dsl.views = viewsOfSrv(dsl).map(v => ({
+    id: v.id || `view_${Math.random().toString(36).slice(2, 6)}`,
+    name: v.name || '视图', icon: v.icon,
+    panels: Array.isArray(v.panels) ? v.panels : [],
+  }))
+  dsl.panels = dsl.views.flatMap(v => v.panels)
+  return dsl
+}
 function saveWorkbench(agentId, dsl) {
+  dsl = normDsl(dsl);
   fs.writeFileSync(path.join(WB_DIR, `${agentId}.json`), JSON.stringify(dsl, null, 2));
   const vp = path.join(WB_VER_DIR, `${agentId}.json`);
   const vers = fs.existsSync(vp) ? JSON.parse(fs.readFileSync(vp, 'utf8')) : [];
@@ -911,19 +941,22 @@ function loadDraft(agentId) {
   return fs.existsSync(p) ? JSON.parse(fs.readFileSync(p, 'utf8')) : null;
 }
 function saveDraft(agentId, dsl) {
-  if (!Array.isArray(dsl.panels)) throw new Error('dsl.panels 必须为数组');
-  const prev = loadDraft(agentId) || loadWorkbench(agentId) || { panels: [] };
+  dsl = normDsl(dsl); // v1/v2 统一：补 views、同步扁平 panels
+  const prevFlat = viewsOfSrv(loadDraft(agentId) || loadWorkbench(agentId) || {}).flatMap(v => v.panels);
   // 防护性合并：同 id 同类型的面板，Agent 遗漏的字段（如 action_group.actions）从上一版补全，防止全量重写丢配置
-  dsl.panels = dsl.panels.map(p => {
-    const old = prev.panels.find(x => x.id === p.id && x.type === p.type);
-    return old ? { ...old, ...p } : p;
-  });
-  for (const p of dsl.panels) {
-    if ((p.type === 'custom' || p.type === 'custom_panel') && !panelCodeOf(p)) throw new Error(`面板 ${p.id || p.title} 引用的代码/插件缺失`);
+  for (const v of dsl.views) {
+    v.panels = v.panels.map(p => {
+      const old = prevFlat.find(x => x.id === p.id && x.type === p.type);
+      return old ? { ...old, ...p } : p;
+    });
+    for (const p of v.panels) {
+      if ((p.type === 'custom' || p.type === 'custom_panel') && !panelCodeOf(p)) throw new Error(`面板 ${p.id || p.title} 引用的代码/插件缺失`);
+    }
   }
+  dsl.panels = dsl.views.flatMap(v => v.panels); // 合并后再次同步
   dsl.owner_agent = agentId;
   fs.writeFileSync(draftPath(agentId), JSON.stringify(dsl, null, 2));
-  audit({ actor: 'dev-agent', agentId, action: 'draft', panels: dsl.panels.length });
+  audit({ actor: 'dev-agent', agentId, action: 'draft', panels: dsl.panels.length, views: dsl.views.length });
 }
 
 // ── Skill 装载（Agent Skills 规范：SKILL.md frontmatter 注入描述，正文按需读取）──
@@ -1311,7 +1344,7 @@ const DEV_TOOLS = {
   },
   update_workbench: {
     desc: '把完整的工作台 DSL 写入草稿（不会直接生效，需用户在编辑器审阅后发布）。基于当前 DSL 增量修改后整体提交',
-    schema: { dsl: { type: 'object', description: "完整工作台 DSL {workbench,version,panels:[...]}。panels 元素含 id/type/title；自定义面板用 type=custom_panel 且 panel=插件id，或 type=custom 且 code=面板代码" } },
+    schema: { dsl: { type: 'object', description: "完整工作台 DSL {workbench,version,views:[{id,name,panels:[…]}],panels:[…]}。panels 元素含 id/type/title；自定义面板用 type=custom_panel 且 panel=插件id，或 type=custom 且 code=面板代码。多场景用 views 分视图（新场景新建视图）；panels 扁平字段平台会自动同步，可只维护 views" } },
     required: ['dsl'],
     run: async ({ dsl }) => {
       saveDraft(devCtx.agentId, dsl);
@@ -1384,13 +1417,14 @@ function devSystemPrompt() {
     '  </div>`',
     '}',
     '',
-    '【当前工作台】', JSON.stringify(live ? { workbench: live.workbench, panels: live.panels.map(p => ({ id: p.id, type: p.type, title: p.title, panel: p.panel })) } : null),
+    '【当前工作台】', JSON.stringify(live ? { workbench: live.workbench, views: viewsOfSrv(live).map(v => ({ id: v.id, name: v.name, panels: v.panels.map(p => ({ id: p.id, type: p.type, title: p.title, panel: p.panel })) })) } : null),
     '【插件库】', JSON.stringify(plugins.map(p => ({ id: p.id, name: p.name, version: p.version }))),
     '',
     '【修改已有插件】先 read_panel_plugin 看当前代码 → 需要持久数据就 create_collection → write_panel_plugin 同 id 覆盖（版本自增）→ 需要时 update_workbench 调整布局。同 id 写入即升级，工作台引用不受影响。',
     '【自探索工作流（必须遵守）】理解需求 → 探索 → 规划 → 实现 → 提交草稿：',
     '1. 探索：新需求涉及助手既有能力时，必须先 exec 读它的 AGENT.md（按名 grep 定位），必要时读其 skills/脚本与验证相关接口（curl 实测返回结构）。能推送通常就能搜索——从脚本/配置里找到真实的服务地址与 API。',
     '2. 规划：把探索结论映射为面板方案（数据从哪来、经什么能力取、展示成什么），方案要说清"复用了助手的哪个既有能力"。',
+    '· 工作台支持多视图（DSL views:[{id,name,panels}]，不同高频场景各建一块屏，如「日常监控/专项巡检/报表」）：需求涉及新场景时优先新建视图，而不是往现有视图堆面板；提交的 DSL 带 views 即可，扁平 panels 由平台自动同步',
     '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 增量修改；单一职责，先小后大。',
@@ -2062,7 +2096,7 @@ const server = http.createServer(async (req, res) => {
     }
     if (req.method === 'PUT' && pathname === '/api/workbench') {
       const { agent_id, dsl } = await body(req);
-      if (!agent_id || !dsl?.panels) return json(res, 400, { error: 'agent_id 与 dsl.panels 必填' });
+      if (!agent_id || !(dsl?.panels || dsl?.views?.length)) return json(res, 400, { error: 'agent_id 与 dsl（panels 或 views）必填' });
       dsl.version = nextVersion(dsl.version, agent_id);
       saveWorkbench(agent_id, dsl);
       try { fs.rmSync(draftPath(agent_id), { force: true }); } catch { }
@@ -2574,11 +2608,12 @@ const server = http.createServer(async (req, res) => {
     if (req.method === 'POST' && pathname === '/api/experience/commit') {
       const { agentId, name, description, content } = await body(req);
       const arm = agentProfileNow(agentId);
-      const full = ['---', 'kind: experience', 'source: aims-platform-mvp', `agent: ${arm.name || agentId}@${arm.version || ''}`, 'scenario: 立库A区智能运维@mvp', '---', '', content].join('\n');
+      const full = ['---', 'kind: experience', 'source: aims-platform-mvp', `agent_id: ${agentId}`, `agent: ${arm.name || agentId}@${arm.version || ''}`, 'scenario: 立库A区智能运维@mvp', '---', '', content].join('\n');
       const r = await armCreateKnowledge({ name, description: description || `工作台人工审阅沉淀`, content: full, tags: ['MVP回流'] });
+      const bound = await bindExperienceToAgent(agentId, r.id);
       metric({ kind: 'experience', agentId, title: name, knowledge_id: r.id });
-      audit({ actor: 'experience-reflow', target: 'ARM', name });
-      return json(res, 200, { result: `已创建 ${r.name}（id: ${r.id}）${r.shareUrl ? `\n${r.shareUrl}` : ''}`, knowledge_id: r.id, share_url: r.shareUrl || '' });
+      audit({ actor: 'experience-reflow', target: 'ARM', name, bound });
+      return json(res, 200, { result: `已创建 ${r.name}（id: ${r.id}）${r.shareUrl ? `\n${r.shareUrl}` : ''}${bound ? '\n已绑定到当前助手（检索即得）' : '\n绑定助手未成功（已在审计留痕），可到 ARM 手动关联'}`, knowledge_id: r.id, share_url: r.shareUrl || '' });
     }
     // ── 自进化看板 ──
     if (req.method === 'GET' && pathname === '/api/evolution') {