aims-workstation 0.1.14 → 0.1.15

package/package.json

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

package/server.js

@@ -396,6 +396,27 @@ async function downloadAgent(agentId) {
   return manifest;
 }
 
+// 本地档案写入（离线创建 / 未发布档案编辑）：与 downloadAgent 同构的物化结构，source 标记 local。
+// 发布到 ARM（同 id，见 /publish）后即转正为远端档案，本地结构不变——身份全程稳定。
+const bumpPatch = (v) => { const p = String(v || 'v1.0.0').replace(/^v/, '').split('.').map(n => +n || 0); p[2] = (p[2] || 0) + 1; return `v${p[0] || 1}.${p[1] || 0}.${p[2]}`; };
+function writeLocalAgent(agentId, { name, description, prompt }, { bump = false } = {}) {
+  const cur = bump ? (localManifest(agentId) || {}) : {};
+  const version = bump ? bumpPatch(cur.version) : 'v1.0.0';
+  const verDir = path.join(ARM_AGENTS_DIR, agentId, 'versions', version);
+  fs.mkdirSync(path.join(verDir, 'knowledges'), { recursive: true });
+  const manifest = {
+    agent_id: agentId, name, version, description: String(description || '').slice(0, 512),
+    downloaded_at: new Date().toISOString(), source: 'local',
+    prompt: String(prompt || ''),
+    skills: cur.skills || [], knowledges: cur.knowledges || [], ui_bindings: cur.ui_bindings || [], // 未发布档案无 ARM 绑定；编辑时保留既有
+  };
+  fs.writeFileSync(path.join(verDir, 'prompt.md'), manifest.prompt);
+  fs.writeFileSync(path.join(verDir, 'manifest.json'), JSON.stringify(manifest, null, 2));
+  commitDownload(manifest);
+  audit({ actor: 'user', agentId, action: bump ? 'update-local-agent' : 'create-local-agent', version });
+  return manifest;
+}
+
 // 同步：比对远端目录与本地库，产出 new/update/delisted 事件；顺带冲账离线经验 outbox
 async function armSync() {
   const remote = await armListAgents();
@@ -1842,6 +1863,7 @@ const server = http.createServer(async (req, res) => {
           update_available: !!(e.remote_version && cmpVersion(e.remote_version, e.installed_version) > 0),
           delisted: !!e.delisted, downloaded_at: e.downloaded_at || null,
           created_by_id: null, created_by: null, // 属主身份以远端目录为准（离线/已下架不可编辑，无需属主）
+          local_only: !!e.local_only, // 本地未发布档案（离线创建）：大厅显示「未发布」徽章 + 发布入口
         });
       }
       if (online) { // 静默刷新远端版本与下架标记（显式事件统计走 /api/arm/sync）——仅在完整拉取时；
@@ -1908,24 +1930,36 @@ const server = http.createServer(async (req, res) => {
       const { name, description, prompt, knowledge_ids } = await body(req);
       const nm = String(name || '').trim(), pr = String(prompt || '').trim();
       if (!nm || !pr) return json(res, 400, { error: '名称与 System Prompt 必填' });
+      // 身份本地生成并随创建上行（新版 ARM 保持同 id；旧版忽略后以其返回 id 为准，行为不变）
+      const localId = crypto.randomUUID();
+      let newId, bound = 0, local = false;
       try {
-        const created = await armRest('/api/v1/agents', { method: 'POST', body: JSON.stringify({ name: nm, description: String(description || '').trim().slice(0, 512), prompt: pr, status: 'active' }) });
-        const newId = created?.id || created?.agent?.id;
+        const created = await armRest('/api/v1/agents', { method: 'POST', body: JSON.stringify({ id: localId, name: nm, description: String(description || '').trim().slice(0, 512), prompt: pr, status: 'active' }) });
+        newId = created?.id || created?.agent?.id;
         if (!newId) throw new Error('ARM 未返回新助手 id');
-        let bound = 0;
         for (const kid of (Array.isArray(knowledge_ids) ? knowledge_ids : [])) { // 绑定幂等（重复绑定返回已有版本）
           try { await armRest(`/api/v1/agents/${newId}/knowledges`, { method: 'POST', body: JSON.stringify({ knowledgeId: kid, kind: 'experience' }) }); bound++; }
           catch { /* 单条绑定失败不阻断创建 */ }
         }
-        const manifest = await downloadAgent(newId); // 创建即物化本地（沿用下载链路）
-        const reg = loadRegistry(); const entry = reg.agents.find((x) => x.agent_id === newId); if (entry) entry.created_via_workstation = true; saveRegistry(reg); // 大厅据此显示编辑/删除入口
-        audit({ actor: 'user', action: 'create-agent', agentId: newId, name: nm, knowledges: bound });
-        return json(res, 200, { agent_id: newId, manifest, knowledges_bound: bound });
-      } catch (e) { return json(res, 502, { error: `创建失败: ${e.message}` }); }
-    }
-    // 编辑档案（工作站创建的助手）：ARM PUT 后重新物化，本地 prompt 同步更新
+      } catch (e) {
+        // 离线降级：仅网络不可达（ARM 请求失败/超时）时本地创建（07 离线理念：出生不依赖 ARM）；
+        // 业务错误（如名称已存在）照常上抛——那种情况下静默转本地只会掩盖问题。
+        if (!/^ARM 请求失败/.test(String(e.message))) return json(res, 502, { error: `创建失败: ${e.message}` });
+        newId = localId; local = true;
+      }
+      const manifest = local
+        ? writeLocalAgent(newId, { name: nm, description: String(description || '').trim(), prompt: pr })
+        : await downloadAgent(newId); // 创建即物化本地（沿用下载链路）
+      const reg = loadRegistry(); const entry = reg.agents.find((x) => x.agent_id === newId);
+      if (entry) { entry.created_via_workstation = true; if (local) entry.local_only = true; } saveRegistry(reg);
+      audit({ actor: 'user', action: local ? 'create-agent-local' : 'create-agent', agentId: newId, name: nm, knowledges: bound });
+      return json(res, 200, { agent_id: newId, manifest, knowledges_bound: bound, local });
+    }
+    // 编辑档案（工作站创建的助手）：ARM PUT 后重新物化，本地 prompt 同步更新；未发布档案仅写本地（版本前进）
     if (req.method === 'GET' && pathname.match(/^\/api\/agents\/[0-9a-f-]{36}\/profile$/)) {
       const id = pathname.split('/')[3];
+      const le = loadRegistry().agents.find((x) => x.agent_id === id);
+      if (le && le.local_only) { const m = localManifest(id) || {}; return json(res, 200, { name: m.name || le.name, description: String(m.description || ''), prompt: m.prompt || '' }); }
       try {
         const d = await armRest(`/api/v1/agents/${id}`);
         return json(res, 200, { name: d.name, description: String(d.description || ''), prompt: d.prompt || '' });
@@ -1939,6 +1973,12 @@ const server = http.createServer(async (req, res) => {
       if (description !== undefined) patch.description = String(description || '').trim().slice(0, 512);
       if (String(prompt || '').trim()) patch.prompt = String(prompt).trim();
       if (!Object.keys(patch).length) return json(res, 400, { error: '没有可更新字段' });
+      const le = loadRegistry().agents.find((x) => x.agent_id === id);
+      if (le && le.local_only) { // 未发布档案：仅写本地（版本前进可回滚），发布后编辑将同步 ARM
+        const cur = localManifest(id) || {};
+        const manifest = writeLocalAgent(id, { name: patch.name || cur.name, description: patch.description ?? cur.description, prompt: patch.prompt || cur.prompt }, { bump: true });
+        return json(res, 200, { ok: true, manifest, local: true });
+      }
       try {
         await armRest(`/api/v1/agents/${id}`, { method: 'PUT', body: JSON.stringify(patch) });
         let manifest = null;
@@ -1957,6 +1997,8 @@ const server = http.createServer(async (req, res) => {
     }
     let mBind = pathname.match(/^\/api\/agents\/([0-9a-f-]{36})\/bindings$/);
     if (mBind && req.method === 'GET') {
+      const le = loadRegistry().agents.find((x) => x.agent_id === mBind[1]);
+      if (le && le.local_only) return json(res, 200, { skills: [], knowledges: [], local_only: true }); // 未发布档案无 ARM 绑定
       try {
         const d = await armRest(`/api/v1/agents/${mBind[1]}`);
         return json(res, 200, {
@@ -2011,18 +2053,48 @@ const server = http.createServer(async (req, res) => {
         return json(res, 200, { agent_id: newId, name: nm, copied, manifest: { agent_id: manifest.agent_id, name: manifest.name, version: manifest.version } });
       } catch (e) { return json(res, 502, { error: `克隆失败: ${e.message}` }); }
     }
-    // 从 ARM 删除（危险操作，前端二次确认）：可选同时卸载本地档案
+    // 从 ARM 删除（危险操作，前端二次确认）：可选同时卸载本地档案；未发布档案只存在于本地，直接卸载
     if (req.method === 'POST' && pathname.match(/^\/api\/agents\/[0-9a-f-]{36}\/arm-delete$/)) {
       const id = pathname.split('/')[3];
       const { also_uninstall, purge_workspaces } = await body(req);
       try {
-        await armRest(`/api/v1/agents/${id}`, { method: 'DELETE' });
+        const le = loadRegistry().agents.find((x) => x.agent_id === id);
+        if (!(le && le.local_only)) await armRest(`/api/v1/agents/${id}`, { method: 'DELETE' });
         let uninstalled = false;
-        if (also_uninstall && loadRegistry().agents.some((a) => a.agent_id === id)) uninstalled = uninstallLocalAgent(id, !!purge_workspaces);
-        audit({ actor: 'user', action: 'arm-delete-agent', agentId: id, also_uninstalled: uninstalled });
+        if (also_uninstall && le) uninstalled = uninstallLocalAgent(id, !!purge_workspaces);
+        audit({ actor: 'user', action: le && le.local_only ? 'delete-local-agent' : 'arm-delete-agent', agentId: id, also_uninstalled: uninstalled });
         return json(res, 200, { ok: true, uninstalled });
       } catch (e) { return json(res, 502, { error: `ARM 删除失败: ${e.message}` }); }
     }
+    // 发布到 ARM（本地未发布档案转正）：同 id 上行（新版 ARM），身份不变、本地 deployment/工作台/数据零迁移。
+    // 幂等：同 id 已在 ARM（上次发布部分成功）→ 校验同名即续走转正；旧版 ARM 忽略 id 返回新 id → 明确报错提示升级。
+    if (req.method === 'POST' && pathname.match(/^\/api\/agents\/[0-9a-f-]{36}\/publish$/)) {
+      const id = pathname.match(/^\/api\/agents\/([0-9a-f-]{36})\/publish$/)[1];
+      const reg = loadRegistry();
+      const le = reg.agents.find((x) => x.agent_id === id);
+      if (!le || !le.local_only) return json(res, 400, { error: '该助手不是本地未发布档案（可能已发布）' });
+      const m = localManifest(id);
+      if (!m) return json(res, 400, { error: '本地档案缺失，请先重新创建' });
+      try {
+        let created;
+        try {
+          created = await armRest('/api/v1/agents', { method: 'POST', body: JSON.stringify({ id, name: m.name, description: String(m.description || '').slice(0, 512), prompt: m.prompt || '', status: 'active' }) });
+        } catch (e) {
+          if (/该 id 已存在/.test(String(e.message))) { // 幂等续走：确认同 id 同名即视为已创建
+            const d = await armRest(`/api/v1/agents/${id}`);
+            if (!d || d.name !== m.name) throw e;
+            created = d;
+          } else throw e;
+        }
+        const finalId = created?.id || created?.agent?.id;
+        if (finalId && finalId !== id) return json(res, 502, { error: '当前 ARM 版本不支持保持助手身份（忽略客户端 id）——请升级 ARM 后再发布' });
+        const manifest = await downloadAgent(id); // 重新物化：source 转正、版本对齐 ARM
+        const reg2 = loadRegistry(); const en = reg2.agents.find((x) => x.agent_id === id);
+        if (en) { en.local_only = false; en.remote_version = manifest.version; } saveRegistry(reg2);
+        audit({ actor: 'user', action: 'publish-agent', agentId: id, name: m.name, version: manifest.version });
+        return json(res, 200, { ok: true, manifest });
+      } catch (e) { return json(res, 502, { error: `发布失败: ${e.message}` }); }
+    }
     // ── 本地助手库：下载 / 升级 / 版本历史 / 回滚 / 卸载 ──
     let mAgt = pathname.match(/^\/api\/agents\/([0-9a-f-]{36})\/(download|upgrade|versions|rollback)$/);
     if (mAgt && req.method === 'POST' && (mAgt[2] === 'download' || mAgt[2] === 'upgrade')) {