dsh-contextos-devops 0.0.0-stage → 1.48.31

package/lib/base/registry.js

@@ -0,0 +1,186 @@
+// 节点台账与磁盘扫描：~/.contextos/nodes.json（与 macOS 客户端共用）。
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { HOME, stateDir } from './env.js';
+import { platformTriple } from './platform.js';
+import { probe } from './http.js';
+
+export function registryPath() {
+  return process.env.CTX_NODES_FILE || path.join(HOME(), '.contextos', 'nodes.json');
+}
+
+export async function readRegistry() {
+  let list = [];
+  try {
+    const d = JSON.parse(await fs.readFile(registryPath(), 'utf8'));
+    list = Array.isArray(d) ? d : Array.isArray(d.nodes) ? d.nodes : [];
+  } catch {
+    /* no registry yet */
+  }
+  if (list.length) return list;
+  // 老版本插件的台账迁移一次
+  try {
+    const d = JSON.parse(await fs.readFile(path.join(stateDir(), 'nodes.json'), 'utf8'));
+    const old = Array.isArray(d.nodes) ? d.nodes : [];
+    list = old.map((n) => ({ dir: n.dir, name: n.name, port: n.port, source: 'record', createdAt: n.createdAt }));
+  } catch {
+    /* nothing to migrate */
+  }
+  return list;
+}
+
+export async function writeRegistry(nodes) {
+  await fs.mkdir(path.dirname(registryPath()), { recursive: true });
+  await fs.writeFile(registryPath(), JSON.stringify(nodes, null, 2));
+}
+
+/** 把探到的运行信息回写到磁盘台账（~/.contextos/nodes.json），供下次直接读取 */
+export async function saveNodeInfo(nodes) {
+  const prev = await readRegistry();
+  const byDir = new Map(prev.filter((x) => x && x.dir).map((x) => [x.dir, x]));
+  const merged = nodes.map((n) => {
+    const old = byDir.get(n.dir) || {};
+    return {
+      ...old,
+      dir: n.dir, name: n.name, port: n.port, platform: n.platform, source: n.source,
+      version: n.version || old.version || '',
+      builtAt: n.builtAt || old.builtAt || '',
+      sizeText: n.sizeText || old.sizeText || '',
+      state: n.state || old.state || '',
+      updatedAt: new Date().toISOString(),
+    };
+  });
+  // 磁盘上还有但这次没扫到的记录保留下来，不丢台账
+  for (const [dir, rec] of byDir) if (!merged.some((m) => m.dir === dir)) merged.push(rec);
+  await fs.mkdir(path.dirname(registryPath()), { recursive: true });
+  await fs.writeFile(registryPath(), JSON.stringify({ updatedAt: new Date().toISOString(), nodes: merged }, null, 2));
+  return merged;
+}
+
+export async function refreshNodes() {
+  const nodes = await listNodes();
+  await saveNodeInfo(nodes).catch(() => null);
+  return nodes;
+}
+
+/** 从目录名 / ContextOS-<port> 尾部推端口；读 var/log/ice.port 优先。 */
+export async function portOnDisk(dir) {
+  try {
+    const p = Number((await fs.readFile(path.join(dir, 'var', 'log', 'ice.port'), 'utf8')).trim());
+    if (p > 0 && p <= 65535) return p;
+  } catch {
+    /* fall through */
+  }
+  const m = /(\d+)$/.exec(path.basename(dir));
+  return m ? Number(m[1]) : 0;
+}
+
+/** 磁盘扫描：任何含 bin/ice.bin 的 ~/ContextOS* 目录都是一个节点（对齐 CtxDeployer.scanLocalInstalls）。 */
+export async function scanLocalNodes() {
+  const out = [];
+  let subs = [];
+  try {
+    subs = await fs.readdir(HOME());
+  } catch {
+    return out;
+  }
+  for (const sub of subs) {
+    if (!/^ContextOS/.test(sub)) continue;
+    const dir = path.join(HOME(), sub);
+    let st;
+    try {
+      st = await fs.stat(path.join(dir, 'bin', 'ice.bin'));
+      if (!st.isFile()) continue;
+    } catch {
+      continue;
+    }
+    out.push({
+      dir,
+      bin: path.join(dir, 'bin', 'ice.bin'),
+      name: sub,
+      port: (await portOnDisk(dir)) || 9020,
+      source: 'scan',
+      platform: platformTriple(),
+      size: st.size,
+    });
+  }
+  return out;
+}
+
+export async function binExists(node) {
+  try {
+    return (await fs.stat(node.bin || path.join(node.dir, 'bin', 'ice.bin'))).isFile();
+  } catch {
+    return false;
+  }
+}
+
+export async function pidAlive(dir) {
+  try {
+    const pid = Number((await fs.readFile(path.join(dir, 'var', 'log', 'ice.pid'), 'utf8')).trim());
+    if (!(pid > 1)) return { alive: false, pid: 0 };
+    process.kill(pid, 0);
+    return { alive: true, pid };
+  } catch {
+    return { alive: false, pid: 0 };
+  }
+}
+
+export async function listNodes() {
+  const registry = await readRegistry();
+  const scanned = await scanLocalNodes();
+  const byDir = new Map();
+  for (const sc of scanned) byDir.set(sc.dir, { ...sc });
+  for (const rec of registry) {
+    if (!rec.dir) continue;
+    const base = byDir.get(rec.dir) || {
+      dir: rec.dir,
+      bin: path.join(rec.dir, 'bin', 'ice.bin'),
+      name: path.basename(rec.dir),
+      port: rec.port || 9020,
+      source: 'record',
+      platform: rec.platform || platformTriple(),
+    };
+    for (const k of ['name', 'port', 'parent', 'platform', 'source', 'container', 'image', 'resident', 'env', 'createdAt']) {
+      if (rec[k] !== undefined && rec[k] !== null && rec[k] !== '') base[k] = rec[k];
+    }
+    if (rec.source) base.source = rec.source;
+    if (!base.port) base.port = (await portOnDisk(rec.dir)) || 9020;
+    byDir.set(rec.dir, base);
+  }
+  const nodes = [...byDir.values()];
+  const out = await Promise.all(nodes.map(async (n) => {
+    const st = await probe(n.port, 1500);
+    const isContainer = !!n.container;
+    const hasBin = isContainer ? true : await binExists(n);
+    const pid = await pidAlive(n.dir);
+    const running = isContainer ? st.live : pid.pid > 1 ? pid.alive : st.live;
+    const iconFile = ['src/main.png', 'src/main.jpg', 'src/main.ico'].find((rel) => {
+      try { return fs.existsSync(path.join(n.dir, rel)); } catch { return false; }
+    });
+    const image = iconFile ? `http://127.0.0.1:${n.port}/p/${iconFile}?pod=${encodeURIComponent(n.name || '')}` : '';
+    // 版本/编译时间/大小统一从 /c/runtime 取（boot + make），拿不到才退回本地文件
+    const rt = st.runtime || {};
+    const versionText = String(st.version || '');
+    const ver = String(rt.version || (versionText.match(/v\d+\.\d+\.\d+(?:-[0-9A-Za-z.]+)+/) || [''])[0] || '');
+    let builtAt = String(rt.builtAt || '');
+    let sizeText = String(rt.sizeText || '');
+    if (!builtAt || !sizeText) {
+      try {
+        const bst = await fs.stat(path.join(n.dir, 'bin', 'ice.bin'));
+        if (!builtAt) builtAt = bst.mtime.toISOString();
+        if (!sizeText) sizeText = `${Math.round(bst.size / 1048576)}M`;
+      } catch { /* ignore */ }
+    }
+    return { ...n, ...st, version: ver, versionText, builtAt, sizeText, image, hasBin, pid: pid.pid, pidAlive: pid.alive, url: `http://localhost:${n.port}/`, state: running ? 'running' : isContainer || hasBin ? 'stopped' : 'missing' };
+  }));
+  // 排序：运行中优先，其次名称倒序（ContextOS-9191 在 ContextOS-9090 之前）
+  out.sort((a, b) => {
+    const ar = a.state === 'running', br = b.state === 'running';
+    if (ar !== br) return ar ? -1 : 1;
+    return String(b.name || '').localeCompare(String(a.name || ''), 'zh-CN', { numeric: true });
+  });
+  // 每次探测完顺手落盘，台账始终是最新的运行信息
+  await saveNodeInfo(out).catch(() => null);
+  return out;
+}

package/lib/base/state.js

@@ -0,0 +1,66 @@
+// 基础功能：插件状态目录（数据文件清单/读取/旧目录迁移）。
+import fs from 'node:fs/promises';
+import fsp from 'node:fs';
+import os from 'node:os';
+import path from 'node:path';
+import { stateDir } from './env.js';
+
+let STATE_MIGRATED = false;
+
+export async function listDataFiles() {
+  const dir = stateDir();
+  const out = [];
+  try {
+    const names = await fs.readdir(dir);
+    for (const name of names) {
+      try {
+        const st = await fs.stat(path.join(dir, name));
+        out.push({ name, size: st.size, mtime: st.mtime.toISOString() });
+      } catch { /* skip */ }
+    }
+  } catch { /* dir missing */ }
+  out.sort((a, b) => a.name.localeCompare(b.name));
+  return { dir, files: out };
+}
+
+export async function readDataFile({ name = '' } = {}) {
+  const safe = path.basename(String(name));
+  if (!safe || safe !== String(name) || !/^[A-Za-z0-9._-]+$/.test(safe)) throw new Error('invalid file name');
+  const full = path.join(stateDir(), safe);
+  const st = await fs.stat(full);
+  if (!st.isFile()) throw new Error('not a file');
+  if (st.size > 512 * 1024) throw new Error('file too large');
+  return { name: safe, size: st.size, content: await fs.readFile(full, 'utf8') };
+}
+
+// 改名兼容：state.json 里的 chat:/scroll: 键带着旧插件前缀（contextos-devops-dsh: 或更早的
+// contextos-devops:）。不迁移的话，改名前保存的对话与滚动位置在新版本里读不到。
+export function migrateStateKeys(data) {
+  if (!data || typeof data !== 'object') return data;
+  const LEGACY = ['contextos-devops-dsh:', 'contextos-devops:'];
+  const NEXT = 'dsh-contextos-devops:';
+  let moved = 0;
+  for (const key of Object.keys(data)) {
+    if (!key.startsWith('chat:') && !key.startsWith('scroll:')) continue;
+    for (const pre of LEGACY) {
+      if (!key.includes(':' + pre)) continue;
+      const next = key.replace(':' + pre, ':' + NEXT);
+      if (!(next in data)) { data[next] = data[key]; moved += 1; }
+      delete data[key];
+      break;
+    }
+  }
+  if (moved) data.migratedKeys = (Number(data.migratedKeys) || 0) + moved;
+  return data;
+}
+
+export async function migrateStateOnce() {
+  if (STATE_MIGRATED) return;
+  STATE_MIGRATED = true;
+  try {
+    const dir = stateDir();
+    const home = process.env.DSH_HOME || path.join(os.homedir(), '.dsh');
+    const old = path.join(home, 'contextos-devops');
+    if (old !== dir && fsp.existsSync(old) && !fsp.existsSync(dir)) await fs.rename(old, dir);
+  } catch { /* keep old */ }
+}

package/lib/base/table.js

@@ -0,0 +1,47 @@
+// 基础功能：ContextOS 固定宽度表格解析。
+export function decodeCell(v) {
+  if (typeof v !== 'string' || !v.includes('%')) return v;
+  try {
+    return decodeURIComponent(v.replace(/\+/g, ' '));
+  } catch {
+    return v;
+  }
+}
+
+/** Fixed-width table: use header column offsets, not a 2+ space split. */
+export function parseFixedTable(text) {
+  const lines = String(text || '').split('\n').filter((l) => l.trim() !== '');
+  if (lines.length < 1) return { columns: [], rows: [] };
+  const header = lines[0];
+  const heads = [];
+  const starts = [];
+  for (const m of header.matchAll(/\S+/g)) {
+    heads.push(m[0]);
+    starts.push(m.index);
+  }
+  const rows = lines.slice(1).map((line) => {
+    const row = {};
+    heads.forEach((head, i) => {
+      const start = starts[i];
+      const end = i + 1 < starts.length ? starts[i + 1] : line.length;
+      row[head] = decodeCell(String(line.slice(start, end)).trim());
+    });
+    return row;
+  });
+  return { columns: heads, rows };
+}
+
+/** 空格分隔的表格（非固定宽度）。 */
+export function parseTable(text) {
+  const lines = String(text || '').split('\n').filter((l) => l.trim() !== '');
+  if (lines.length === 0) return { columns: [], rows: [] };
+  const cut = (line) => line.trim().split(/\s{2,}/);
+  const columns = cut(lines[0]);
+  const rows = lines.slice(1).map((line) => {
+    const cells = cut(line);
+    const row = {};
+    columns.forEach((c, i) => { row[c] = decodeCell(cells[i] ?? ''); });
+    return row;
+  });
+  return { columns, rows };
+}

package/lib/base/texttable.js

@@ -0,0 +1,26 @@
+// ContextOS 的系统级列表（/c/aaa.user 等）返回等宽文本表：
+//   time                        userrole username       usernick
+//   2026-11-14+10%3A48%3A09.375 tech     dsh_copilot_9090 DSH Copilot
+// 列为空格填充的固定宽度；这里按表头的列起始位置切片解析。
+export function parseTextTable(text) {
+  const raw = String(text || '').replace(/\r/g, '');
+  const lines = raw.split('\n').filter((l) => l.trim() !== '');
+  if (lines.length < 1) return { columns: [], rows: [] };
+  const header = lines[0];
+  const starts = [];
+  for (let i = 0; i < header.length; i++) {
+    if (header[i] !== ' ' && (i === 0 || header[i - 1] === ' ')) starts.push(i);
+  }
+  const columns = starts.map((s, i) => header.slice(s, i + 1 < starts.length ? starts[i + 1] : header.length).trim());
+  const rows = lines.slice(1).map((line) => {
+    const row = {};
+    starts.forEach((s, i) => {
+      const end = i + 1 < starts.length ? starts[i + 1] : line.length;
+      let v = line.slice(s, end).trim();
+      try { v = decodeURIComponent(v.replace(/\+/g, ' ')); } catch { /* 原样保留 */ }
+      row[columns[i]] = v;
+    });
+    return row;
+  });
+  return { columns, rows };
+}

package/lib/base/url.js

@@ -0,0 +1,178 @@
+// 两种 URL 严格区分，任何地方都不许再手拼：
+//   接口 URL（读写数据）  /s/<pod>/c/<portal>/action/run/<cmd>/action/<action>/<k>/<v>/...
+//                         ?user.uid=<当前分身>&<place>_uid=<实例>&uid=<记录>   ← uid 只用于改/删
+//   网页 URL（浏览器打开） /s/<pod>/c/<portal>?debug=true&<place>_uid=<实例>#<实例>:<cmd>:<记录>
+// 空间一律用名称 pod，绝不用空间 uid。
+export const DEFAULT_PLACE = 'system';
+
+export function portalOf(command) {
+  const parts = String(command || '').split('.');
+  return parts.length >= 3 ? `${parts.slice(0, -1).join('.')}.portal` : '';
+}
+
+export function placeUidKey(place) {
+  const p = String(place || DEFAULT_PLACE).replace(/_(uid|name)$/, '');
+  return `${p || DEFAULT_PLACE}_uid`;
+}
+
+// 接口 URL：seg 是已经编码好的 k/v 路径段，scope 是查询参数
+export function apiPath({ pod, command, action = 'create', seg = '', scope = {}, portal }) {
+  const portalOn = portal === undefined ? portalOf(command) : portal;
+  const usePortal = !!portalOn;
+  const base = usePortal
+    ? `/s/${encodeURIComponent(pod)}/c/${portalOn}/action/run/${command}/action/${action}`
+    : `/s/${encodeURIComponent(pod)}/c/${command}/action/${action}`;
+  const query = new URLSearchParams();
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  return `${base}${seg ? `/${seg}` : ''}${qs ? `?${qs}` : ''}`;
+}
+
+// 平台数据接口（唯一形态，别自己拼）：
+//   写：   /s/<pod>/c/<portal>/action/run/<cmd>/action/<action>/<k>/<v>…?user.uid=&<place>_uid=
+//   列表： /s/<pod>/c/<portal>/action/run/<cmd>/<place_uid>?user.uid=
+//   详情： /s/<pod>/c/<portal>/action/run/<cmd>/<place_uid>/<uid>?user.uid=
+export function dataPath({ pod, command, action = 'create', seg = '', inst = '', record = '', portal, scope = {} }) {
+  const portalOn = portal === undefined ? portalOf(command) : portal;
+  if (!portalOn) throw new Error(`not a platform command: ${command}`);
+  const base = `/s/${encodeURIComponent(pod)}/c/${portalOn}/action/run/${command}`;
+  const query = new URLSearchParams();
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  const tail = qs ? `?${qs}` : '';
+  if (!action) {
+    const path = inst ? `/${encodeURIComponent(inst)}${record ? `/${encodeURIComponent(record)}` : ''}` : '';
+    return `${base}${path}${tail}`;
+  }
+  return `${base}/action/${action}${seg ? `/${seg}` : ''}${tail}`;
+}
+
+// 网页 URL：给浏览器打开某个实例（或某条记录）
+export function webUrl({ node, pod, command, place = DEFAULT_PLACE, placeUid = '', recordUid = '' }) {
+  const portal = portalOf(command) || command;
+  const key = placeUidKey(place);
+  const hash = recordUid ? `#${placeUid || ''}:${command}:${recordUid}` : '';
+  return `http://127.0.0.1:${node}/s/${encodeURIComponent(pod)}/c/${portal}?debug=true&${key}=${encodeURIComponent(placeUid || '')}${hash}`;
+}
+
+// ── 两种接口层：系统级 / 平台级 ───────────────────────────────────────────
+// 系统级：节点自身的命令，直连 /c/<cmd>；空间命令 /s/<pod>/c/<cmd>（不经过门户、不查成员权限）
+// 平台级：应用平台（云社区/云办公…）把门户当入口，/s/<pod>/c/<portal>/action/run/<cmd>
+//         批量命令走门户时会先检查成员权限（member/apply/allow）
+export function systemUrl({ node, command, action = '', seg = '', scope = {} }) {
+  const base = `/c/${command}${action ? `/action/${action}` : ''}`;
+  const query = new URLSearchParams();
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  return `http://127.0.0.1:${node}${base}${seg ? `/${seg}` : ''}${qs ? `?${qs}` : ''}`;
+}
+
+export function spaceUrl({ node, pod, command, action = '', seg = '', scope = {} }) {
+  const base = `/s/${encodeURIComponent(pod)}/c/${command}${action ? `/action/${action}` : ''}`;
+  const query = new URLSearchParams();
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  return `http://127.0.0.1:${node}${base}${seg ? `/${seg}` : ''}${qs ? `?${qs}` : ''}`;
+}
+
+// 平台级：门户 + 内部命令（会做成员权限检查）
+export function platformUrl({ node, pod, command, portal, action = '', seg = '', scope = {} }) {
+  const p = portal || portalOf(command);
+  const base = `/s/${encodeURIComponent(pod)}/c/${p}${command ? `/action/run/${command}` : ''}${action ? `/action/${action}` : ''}`;
+  const query = new URLSearchParams();
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  return `http://127.0.0.1:${node}${base}${seg ? `/${seg}` : ''}${qs ? `?${qs}` : ''}`;
+}
+
+// 五种使用形式：同一条命令，五个入口
+//   参数三类：位置参数 arg（URL Path）、选项参数 opt（URL Query）、锚定参数 hash（URL Hash）
+//   内部 CMD：本进程 m.Cmd("<cmd>", <arg>, map[string]string{<opt>})
+//             其它空间 m.Cmd("space", "<pod>", "<cmd>", <arg>, map[string]string{<opt>})
+//   命令 CLI：本进程 ./bin/ice.bin <cmd> <arg>；发给服务节点 ./bin/ice.bin admin <cmd> <arg>
+export function goOpt(opt = {}) {
+  const pairs = Object.entries(opt || {}).map(([k, v]) => `"${k}": "${String(v).replace(/"/g, '\\"')}"`);
+  return pairs.length ? `map[string]string{${pairs.join(', ')}}` : '';
+}
+
+export function commandForms({ node, pod = '', command, portal = '', arg = '', opt = {}, hash = '' }) {
+  const a = String(arg || '');
+  const goArgs = [a ? `"${a}"` : '', goOpt(opt)].filter(Boolean).join(', ');
+  const goOpts = goArgs ? `, ${goArgs}` : '';
+  return {
+    web: (pod ? spaceUrl({ node, pod, command, seg: a, scope: opt }) : systemUrl({ node, command, seg: a, scope: opt })) + (hash ? `#${hash}` : ''),
+    api: pod ? spaceUrl({ node, pod, command, seg: a, scope: opt }) : systemUrl({ node, command, seg: a, scope: opt }),
+    platform: pod && portal ? platformUrl({ node, pod, command, portal, seg: a, scope: opt }) : '',
+    inner: pod ? `m.Cmd("space", "${pod}", "${command}"${goOpts})` : `m.Cmd("${command}"${goOpts})`,
+    cli: `./bin/ice.bin ${command}${a ? ` ${a}` : ''}`,
+    cliAdmin: `./bin/ice.bin admin ${command}${a ? ` ${a}` : ''}`,
+    mcp: `mcp://contextos/${command}${pod ? `?pod=${pod}` : ''}`,
+  };
+}
+
+// 参数三类与 URL 的对应关系
+export function paramKinds({ arg = '', opt = {}, hash = '' }) {
+  return {
+    arg: { url: 'Path', value: arg },
+    opt: { url: 'Query', value: opt },
+    hash: { url: 'Hash', value: hash },
+  };
+}
+
+// ── 方法语义（严格按 URL 结构判断，不许凭感觉选） ─────────────────────────
+//   最后一段命令后面没有 /action/            → GET
+//   有 /action/ 且 action 是 create 或以 Create 结尾 → PUT
+//   有 /action/ 且 action 是 remove/trash 或以 Remove 结尾 → DELETE
+//   其它                                      → POST
+export function methodOf({ action = '' } = {}) {
+  const a = String(action || '');
+  if (!a) return 'GET';
+  if (a === 'create' || /Create$/.test(a)) return 'PUT';
+  if (a === 'remove' || a === 'trash' || /Remove$/.test(a)) return 'DELETE';
+  return 'POST';
+}
+
+export function methodOfUrl(url = '') {
+  const m = String(url).match(/\/action\/([^/?#]+)/);
+  return methodOf({ action: m ? m[1] : '' });
+}
+
+// ── 文件上传：平台级接口 ────────────────────────────────────────────────
+//   POST /s/<pod>/c/<portal>/action/run/<cmd>/action/upload   （multipart/form-data）
+//   门户先查成员权限，再转给内部命令的 upload
+export function uploadUrl({ node, pod = '', command, portal = '', scope = {} }) {
+  const p = portal || portalOf(command);
+  const base = pod && p
+    ? `/s/${encodeURIComponent(pod)}/c/${p}/action/run/${command}/action/upload`
+    : `/c/${command}/action/upload`;
+  const query = new URLSearchParams();
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  return `http://127.0.0.1:${node}${base}${qs ? `?${qs}` : ''}`;
+}
+
+// ── 网页转发：web.chat.action ────────────────────────────────────────────
+// 前端页面把命令串交给 web.chat.action，由它按 cmds 转发到真实命令。
+//   POST /chat/action/?_index=<cmd>
+//   form-data: cmds=action&cmds=run&cmds=<portal>&cmds=action&cmds=run&cmds=<cmd>&cmds=action&cmds=<action>
+export const CHAT_ACTION = 'web.chat.action';
+
+export function chatActionUrl({ node, index = '', scope = {} }) {
+  const query = new URLSearchParams();
+  if (index) query.set('_index', index);
+  for (const [k, v] of Object.entries(scope || {})) if (v !== '' && v != null) query.set(k, v);
+  const qs = query.toString();
+  return `http://127.0.0.1:${node}/chat/action/${qs ? `?${qs}` : ''}`;
+}
+
+// cmds 链：门户 → 内部命令 → 动作
+export function cmdsChain({ portal = '', command = '', action = '' }) {
+  const out = [];
+  if (portal) out.push('action', 'run', portal);
+  if (command) out.push('action', 'run', command);
+  if (action) out.push('action', action);
+  return out;
+}
+
+// 全局参数：系统按用户语言与主题返回数据
+export const GLOBAL_PARAMS = ['user.lang', 'sess.theme', 'sess.bg', 'sess.fg', 'sess.daemon'];

package/lib/core/README.md

@@ -0,0 +1,17 @@
+# lib/core · 核心业务逻辑
+
+引用方向：`core → base → misc`（core、base 可引用 misc；misc 不引用任何内部模块）。
+
+| 文件 | 职责 |
+|---|---|
+| `nodes.js` | 节点：部署/启停/打开/终端/删除/官方空间/容器与远程部署/流水线 |
+| `spaces.js` | 空间：创建/启动/停止/编译/初始化/官方空间/路径 |
+| `apps.js` | 应用：列表/生成/代码/实例/商店/最近应用 |
+| `files.js` | 文件：列目录/读写/树/新建/改名/删除/git 状态 |
+| `data.js` | 数据：读/写/删（回读校验） |
+| `users.js` | 用户：每节点 `dsh_copilot_<port>`，uid 持久化 |
+| `project.js` | 项目管理：target/plan/task/report/feedback |
+| `avatar.js` | 数字分身/背景/用户媒体 |
+| `copilot.js` | AI Copilot：模型解析/对话/动作提取/目标拆解 |
+| `device.js` | 周边设备发现（节点/WiFi/蓝牙/局域网） |
+| `terminal.js` | 内嵌终端（WebSocket + PTY） |