dsh-contextos-devops 0.0.0-stage → 1.48.32

package/lib/core/copilot.js

@@ -0,0 +1,419 @@
+// 核心业务：AI Copilot（模型解析、对话、动作提取、目标拆解）。
+import path from 'node:path';
+import { http, encode } from '../base/http.js';
+import { fieldSegments, splitFields } from '../base/field.js';
+import { listAvatars } from './avatar.js';
+
+let dshLlm = null;
+export function setLlm(v) { dshLlm = v; }
+export function getLlm() { return dshLlm; }
+
+export function chatProviders() {
+  try { return dshLlm?.listProviders?.() || []; } catch { return []; }
+}
+
+async function resolveChatModel({ provider, model } = {}) {
+  if (!dshLlm) throw new Error('DSH llm service is not mounted');
+  const providers = chatProviders();
+  const ordered = provider
+    ? providers.filter((p) => String(p.id) === String(provider))
+    : providers.slice().sort((a, b) => (/deepseek/i.test(String(a.id)) ? -1 : 0) - (/deepseek/i.test(String(b.id)) ? -1 : 0));
+  let chosen = null;
+  let models = [];
+  for (const p of ordered) {
+    let list = [];
+    try { list = await dshLlm.listModels(p.id); } catch { /* catalog-less adapter */ }
+    if (list.length || (provider && String(p.id) === String(provider))) { chosen = p; models = list; break; }
+  }
+  if (!chosen) {
+    chosen = providers.find((p) => /deepseek/i.test(String(p.id))) || providers[0];
+    if (!chosen) throw new Error('DSH has no llm provider mounted');
+    try { models = await dshLlm.listModels(chosen.id); } catch { models = []; }
+  }
+  const modelId = model || models.find((m) => /flash/i.test(String(m.id)))?.id || models[0]?.id || 'deepseek-v4-flash';
+  return { provider: chosen.id, model: modelId };
+}
+
+function extractAction(text) {
+  const raw = String(text || '').trim();
+  const start = raw.indexOf('{');
+  const end = raw.lastIndexOf('}');
+  if (start < 0 || end <= start) return null;
+  try {
+    const parsed = JSON.parse(raw.slice(start, end + 1));
+    return parsed && typeof parsed === 'object' ? parsed : null;
+  } catch {
+    return null;
+  }
+}
+
+const MODE_ACTIONS = {
+  avatar: ['createInstance', 'createStoreInstance', 'readData', 'writeData', 'listApps', 'storeApps', 'projectStatus', 'pmList', 'pmCreate', 'pmModify', 'pmRemove', 'planProject', 'createAvatar', 'openApp'],
+  factory: ['deploy', 'start', 'stop', 'delete', 'createSpace', 'officialSpaces', 'initSpace', 'spaceStart', 'spaceStop', 'spaceBuild', 'autogenApp', 'createApp', 'generateAppCode', 'code', 'buildSpace', 'compile', 'dockerDeploy', 'remoteDeploy', 'remoteLogin', 'createInstance', 'createStoreInstance', 'listApps', 'storeApps'],
+  iot: ['devices', 'sshHosts', 'sysControl', 'updateBackground', 'createBackground', 'openApp', 'openNode', 'listApps', 'projectStatus', 'pmList'],
+};
+
+export async function chatWithDSH({ message, history = [], context = {}, provider = '', model = '', mode = 'factory' } = {}) {
+  if (!String(message || '').trim()) throw new Error('empty message');
+  const choice = await resolveChatModel({ provider, model });
+  const system = [
+    'RSI IRON LAW (highest priority; applies to every reply):',
+    'GOAL → PLAN(time/cost/risk) → ANALYZE/DECIDE → TASKS → EXECUTE → REPORT(what/how/result) → FEEDBACK(lesson/gate).',
+    'No goal, no action. No report, not done. No feedback, not closed.',
+    'Prefer existing code/specs/flows; abstract duplicates; sediment lessons into code/docs/memory; never repeat a known error.',
+    'For non-trivial work reply with the sections 目标/计划/分析与决策/任务/执行/报告/反馈. Simple Q&A may stay concise but must not invent results.',
+    'If goal or acceptance criteria is missing, ask before changing code. After code changes, verify API read-back and rendered UI; add a gate for every recurring bug.',
+    'CONTEXTOS DOCTRINE (三纲五常): three guides are cluster deployment (all devices connected), modular development (all code generated), automated applications (all data flowing); five constants are code, docs, conversation, team, market.',
+    'Every finished round must leave four artifacts: runnable code, updated docs, a strengthened gate, and a written rule. Prefer abstraction so the next similar feature needs less code.',
+    'You are ContextOS DevOps Copilot inside DeepSeek Harness.',
+    'Turn the user request into exactly one JSON object, no markdown:',
+    '{"reply":"short Chinese answer","action":null}',
+    'or for one operation:',
+    '{"reply":"short Chinese answer","action":{"op":"deploy|createSpace|officialSpaces|initSpace|autogenApp|createApp|generateAppCode|createInstance|storeApps|createStoreInstance|createAvatar|projectStatus|planProject|pmList|pmCreate|pmModify|pmRemove|pmAct|buildSpace|openApp|openNode|code|listApps|devices|data","args":{...}}}',
+    'or for multiple operations:',
+    '{"reply":"short Chinese answer","actions":[{"op":"pmCreate","args":{...}},{"op":"pmCreate","args":{...}}]}',
+    'Rules:',
+    '- Only use actions that are valid in the current context; ask for missing node/space/name instead of inventing.',
+    '- deploy args: {port:number}; createSpace args: {name:string}; initSpace args: {space:string};',
+    '- officialSpaces args: {keys:[standard key or Chinese name]}; autogenApp args: {name,help,place,value,trans}; createInstance args: {space,command,place,name,city,company}; buildSpace args: {space};',
+    '- createApp/generateAppCode args: {name, zone?, help?}; openApp args: {space,name}; openNode args: {port}; code args: {name}; listApps args: {}.',
+    '- data args (仅 avatar 模式，写/读应用数据): {space, command, text}. command 形如 web.team.<module>.<function>（取自最近应用 functions，如 supplier/flow/request）；space 取自该应用；text = 用户原话（客户端据此匹配实例与字段）。这三个参数不能为空，缺一个就凭 context.apps 补，补不到才追问。',
+    '- Six capabilities, in order: deploy node, create workspace, generate app template, edit app code, create app instance, add app data.',
+    '- NEVER answer a data-write request with prose only: always attach the data action with its three args. If you cannot fill them, still return the action with what you can and say what is missing in reply.',
+    '- RSI RULE: every iteration must abstract reusable code/specs/flows, record lessons, and never repeat a known error; prefer existing capabilities over new one-off code.',
+    '- WORKFLOW RULE: 目标 → 计划（时间/金钱预期）→ 分析决策 → 任务拆解 → 执行 → 报告（做了什么/怎么做）→ 反馈（总结/沉淀）。No goal, no action; no report, not done; no feedback, not closed.',
+    '- FACTORY CODE RULES (must follow ContextOS SPEC-CODE.md and USER-CODE.md):',
+    '  * Go commands live under the app module src/<module>/; use icebergs ice.*, mdb/nfs/aaa helpers. Never write raw SQL, never open var/db/*.db directly.',
+    '  * Frontend uses Volcanos can.page/can.onimport and $output-scoped CSS. Never use document.createElement/innerHTML or unscoped global CSS.',
+    '  * API methods: create/insert=PUT, remove/delete=DELETE, other actions=POST; GET /action/ is only for login/run/command.',
+    '  * Parse ContextOS envelopes via option/append/key,value; 200 + count:0x0 is not success; always read back.',
+    '  * Entity ids are 32-char hashes; use target_uid/plan_uid/task_uid/report_uid/feedback_uid naming.',
+    '  * autogenApp value is a comma-separated ASCII Go identifier list (profile,position,...); Chinese display labels belong only in trans.',
+    '  * After Go/JS/CSS changes: compile via vimer/action/compile, inspect warn/catch/error, verify bin/ice.bin mtime, then read back.',
+    '  * Generated UI must use the project design tokens/UI kit (USER-VIEW.md); no ad-hoc duplicate card/table/empty markup.',
+    '  * Never commit secrets or hard-code /Users/<name>; derive paths from CTX_ROOT.',
+
+    `MODE: ${mode}.`,
+    'MODE BEHAVIOUR:',
+    '- avatar（数字分身）: only create app instances and add data; never deploy nodes, create project spaces or generate app code.',
+    '- avatar 模式下的「创建/生成/做一个 <X> 应用」= 先 storeApps 找到最匹配 X 的服务模板（按名称相似度），再 createStoreInstance（name=X，city/company/uid 取 context.avatar）。这是允许的动作，不要拒绝，不要回答「请切换到软件工厂模式」，也不要调用 createApp。',
+    '- avatar 模式下的「给 <X> 添加/录入 <Y>」= 先从最近应用（context.apps）里按名称相似度挑出 X 对应的应用，再从该应用的 functions 里按关键词选功能：定义流程（创建/新建/添加流程）→flow；发起流程（发起/提交/送审/报批/走流程，或「申请」+流程）→request；申请权限→apply；审批（通过/驳回）→allow；通知→notice；事件→event；成员→member；设置→setting。flow 是创建流程定义，request 是发起一次流程申请，两者不可混用，然后返回 action {op:"data", args:{space, command, text}}（space/command 取自该应用，command 形如 web.team.<name>.<function>，text 为用户原话）。只有最近应用里确实没有匹配项时才追问一句，不要先要求用户选应用。',
+    '- factory（软件工厂）: deploy service nodes, create project spaces, generate app templates, generate app code, compile and instantiate —— 全链路生产线。此模式禁止 data 动作、禁止查询最近应用：说「创建空间」就是 createSpace（确认表单），说「生成应用」就是 createApp/autogenApp。',
+    '- iot（赛博世界）: 只做设备三件事——扫描设备（蓝牙/局域网）、连接设备、控制设备（切换场景/下发指令）；不建空间、不生成应用、不读写数据。',
+    `ALLOWED ACTIONS IN ${String(mode).toUpperCase()} MODE: ${(MODE_ACTIONS[mode] || []).join(', ')}.`,
+    '- Refuse any action outside the allowlist with one short Chinese sentence explaining the mode; do not invent extra capabilities.',
+    '- storeApps args: {}; createStoreInstance args: {name?,city?,company?,command?}; createAvatar args: {name,city,company,persona,preferences,style}; projectStatus args: {}; planProject args: {goal}; pmList args: {}; pmCreate args: {kind,target_uid?,plan_uid?,task_uid?,report_uid?,title?,content?,begin_time?,end_time?,report_type?,score?,feedback_status?}; pmAct args: {kind,item_uid,action}; pmModify args: {kind,item_uid,title?,content?,begin_time?,end_time?,report_type?,score?,feedback_status?}; pmRemove args: {kind,item_uid}; devices args: {}.',
+    '- CURRENT SELECTION is authoritative: context.node, context.space and context.app are the active node/workspace/app instance. Use them directly; do not ask the user to repeat node/space/app if present.',
+    '- Every request carries context {node, space, app, avatar, scene, mode}; these are the current conversation parameters. If any action argument is missing, fill it from context.node/space/app/avatar. Only ask when that field is empty.',
+    '- Every request also carries context.functions {target, plan, task, report, feedback}; these are the five project functions of the active plan session. Use their uid/title as defaults for pmCreate and any project action; never ask for a uid that is already present.',
+    '- If the user says add target/plan/task/report/feedback, call pmCreate with kind and omit parent uids when context.functions already provides them.',
+    '- For MULTIPLE items (多个任务/三个计划/批量创建), return an actions array with one pmCreate per item. Never stop after the first item when the user asked for several. Each action is executed sequentially by the host.',
+    '- PROJECT MANAGEMENT SKILL: entities target→plan→task→report→feedback. Operations: List=pmList; Create=pmCreate; Modify=pmModify; Remove=pmRemove.',
+    '- For List/查看/列表, call pmList. For Create/新增/添加, call pmCreate with kind and parent uid defaults from context.functions. For Modify/修改/编辑, call pmModify {kind,item_uid,...}. For Remove/删除, call pmRemove {kind,item_uid}.',
+    '- Current context.functions always contains the selected target/plan/task/report/feedback (uid/title/status). Use the selected one for item_uid; only ask when it is null and the user did not specify which item.',
+    '- After any pmCreate/pmModify/pmRemove the host refreshes the left/right project panels automatically; reply with what changed, do not claim until the action result is returned.',
+    '- Project chain: target → plan → task → report → feedback. Use uid=target_uid for target/action/planCreate, uid=plan_uid for plan/action/taskCreate, uid=task_uid for task/action/reportCreate, uid=report_uid for report/action/feedbackCreate.',
+    '- Project status gates: plan must reach process before taskCreate; task must reach process before reportCreate; feedback canFinish is required before task finish.',
+    '- When the user gives a goal for daily work, call planProject {goal}; ask only for missing goal details (target, date range, task list, report/feedback expectations).',
+    '- If the user says open/data/code/instance and context.app exists, act on context.app without asking for its name.',
+    '- context.avatar is the active digital avatar: uid/city/company/persona/preferences/style. When creating an instance always pass context.avatar.uid, city, company.',
+    '- context.scene is the active virtual scene: theme, language, timezone, location. Treat these as the user environment (language/theme for renders, timezone for dates, location for city-level answers). Switching scene changes them; empty means system default.',
+    '- context.web is the web page the user is currently viewing in a tab (url/title). When the user says "this page" or asks about what they are looking at, use context.web as the reference.',
+    '- CONTEXT FIELDS (single canonical name per concept, no aliases): node=服务节点, space=项目空间, app=应用实例, avatar=数字分身, scene=赛博世界, mode=工作模式(factory/avatar/iot), view=视图模式(chat/manage/dev), web=网页界面, editor=源码编程.',
+    '- When the user says 节点/serve/node use context.node; 空间/pod use context.space; 应用实例/place use context.app; 赛博世界/scene use context.scene; 视图/view use context.view; 网页 use context.web; 文件/代码 use context.editor.',
+    '- sshHosts args: {}; lists ~/.ssh/host/*.json services (name, username, host, port, init — these are the user\'s SSH services), ~/.ssh/known_hosts hosts, ~/.ssh/config entries and shell history ssh commands (hashed known_hosts entries are shown as hashed). Prefer context from sshHosts.services when the user asks about their services.',
+    '- sysControl args: {action, value}. actions: volume (value 0-100, empty=read), mute (on/off), clipboard (empty=read, text=write), screenshot, open (http(s)/absolute path), wifi (on/off/empty=status), sleep, lock, wallpaper (absolute image path), shortcut (name), shortcuts (list), info (battery/disk/displays). Only in iot mode; ask before sleep/lock.',
+    '- context.editor is the file currently open in the dev editor: {node, space, path, language, dirty, content (truncated)}. When the user says "this file"/"这个文件"/asks about the open code, use context.editor.path and context.editor.content.',
+    '- createSpace name regex [a-zA-Z][a-zA-Z0-9_]*; autogen name/place same regex.',
+    '- Standard spaces: community=云社区, enterprise=云办公, operation=云研发, knowledge=云知识, education=云教育, healthy=云健康, tourism=云文旅, charity=云公益, industry=云工业, agriculture=云农业.',
+    '- If the user asks to create/deploy any standard space by Chinese name, use officialSpaces {keys:[...]}; multiple names may be selected at once. Do not use createSpace for these ten.',
+    '- Do not claim success; the host executes the action and reports the real result.',
+    '- reply must be concise Chinese, 1-3 sentences. Translate every label, status, field name and entity type into Chinese; do not leave English enum values or raw field names in reply.',
+    `Current context: ${JSON.stringify(context).slice(0, 6000)}`,
+  ].join('\n');
+  // Use one request-only user message. Durable system/assistant messages need
+  // ids/sources; a single user turn keeps this plugin independent of loop state.
+  const historyText = (history || []).slice(-8)
+    .filter((h) => h && h.text && (h.role === 'user' || h.role === 'ai' || h.role === 'assistant'))
+    .map((h) => `${h.role === 'user' ? 'USER' : 'ASSISTANT'}: ${String(h.text).slice(0, 1200)}`)
+    .join('\n');
+  const prompt = `${system}\n\nHISTORY:\n${historyText || '(none)'}\n\nUSER: ${String(message).slice(0, 2000)}`;
+  const messages = [{ role: 'user', content: [{ type: 'text', text: prompt }] }];
+
+  let output = '';
+  let failure = '';
+  let usage = null;
+  const startedAt = Date.now();
+  for await (const chunk of dshLlm.stream({ provider: choice.provider, model: choice.model, messages })) {
+    if (chunk?.type === 'text-delta' && chunk.text) output += chunk.text;
+    if (chunk?.type === 'usage' && chunk.usage) usage = chunk.usage;
+    if (chunk?.usage) usage = chunk.usage;
+    if (chunk?.type === 'finish' && chunk.reason?.kind === 'error') {
+      failure = chunk.reason.failure?.message || chunk.reason.failure?.code || 'model call failed';
+    }
+    if (chunk?.type === 'finish' && chunk.reason?.kind === 'aborted') failure = 'model call aborted';
+  }
+  if (failure) throw new Error(`DSH model: ${failure}`);
+  const elapsedMs = Date.now() - startedAt;
+  const parsed = extractAction(output);
+  return {
+    reply: String(parsed?.reply || output || '已理解，但没有生成可执行动作。').trim(),
+    action: parsed?.action && typeof parsed.action === 'object' ? parsed.action : null,
+    actions: Array.isArray(parsed?.actions) ? parsed.actions.filter((a) => a && typeof a === 'object') : [],
+    provider: choice.provider,
+    model: choice.model,
+    raw: parsed ? undefined : output.slice(0, 800),
+    ms: elapsedMs,
+    usage: usage || null,
+    promptBytes: Buffer.byteLength(prompt, 'utf8'),
+    outputBytes: Buffer.byteLength(output, 'utf8'),
+  };
+}
+
+
+export async function llmJson({ prompt, provider = '', model = '' } = {}) {
+  const choice = await resolveChatModel({ provider, model });
+  const messages = [{ role: 'user', content: [{ type: 'text', text: prompt }] }];
+  let output = '';
+  let failure = '';
+  for await (const chunk of dshLlm.stream({ provider: choice.provider, model: choice.model, messages })) {
+    if (chunk?.type === 'text-delta' && chunk.text) output += chunk.text;
+    if (chunk?.type === 'finish' && chunk.reason?.kind === 'error') failure = chunk.reason.failure?.message || 'model failed';
+  }
+  if (failure) throw new Error(failure);
+  const start = output.indexOf('{');
+  const end = output.lastIndexOf('}');
+  if (start < 0 || end <= start) throw new Error('model returned no JSON');
+  return JSON.parse(output.slice(start, end + 1));
+}
+
+
+// 生成应用前先调研：按用户需求 + 同类产品（钉钉/飞书/传统 SaaS）的常见做法，
+// 定出这个应用的五个核心功能及其依赖关系。返回值直接进确认表单。
+export async function appFunctionPlan({ name = '', help = '', text = '' } = {}) {
+  const prompt = [
+    '你是企业应用架构师。请为一个业务应用设计「五个核心功能」，并给出依赖关系。',
+    `应用：${help || name || '未命名应用'}`,
+    `用户原话/需求：${String(text || help || name).slice(0, 400)}`,
+    '',
+    '要求：',
+    '1. 恰好五个功能，按业务先后依赖排序（后面的依赖前面的）。',
+    '2. 参考同类产品（钉钉、飞书、用友、金蝶、Salesforce 等）在该业务领域的标准模块，但要用中文命名。',
+    '3. 每个功能给出：name（小写字母，用于代码标识）、label（中文名）、depends（依赖的功能 name，数组，第一个为空）、why（一句话说明为什么需要它）。',
+    '4. 只输出 JSON，不要解释，格式：',
+    '{"functions":[{"name":"target","label":"目标","depends":[],"why":"..."}]}',
+  ].join('\n');
+  const out = await llmJson({ prompt });
+  const list = Array.isArray(out?.functions) ? out.functions : [];
+  const clean = list.map((f) => ({
+    name: String(f?.name || '').toLowerCase().replace(/[^a-z0-9_]/g, '').slice(0, 24),
+    label: String(f?.label || '').trim().slice(0, 12),
+    depends: Array.isArray(f?.depends) ? f.depends.map((x) => String(x).toLowerCase()) : [],
+    why: String(f?.why || '').slice(0, 80),
+  })).filter((f) => /^[a-z][a-z0-9_]*$/.test(f.name) && f.label);
+  if (clean.length !== 5) throw new Error(`model returned ${clean.length} functions, expected 5`);
+  return { name, help: help || name, functions: clean };
+}
+
+// 把「给某个应用写数据」拆成：选应用 → 选功能 → 抽字段值。
+// 应用池来自最近应用；功能名必须来自该应用的 functions。
+// 代码生成意图：把「工具栏加个驳回键」「当状态=待审时显示通过键」解析成模板 + 变量
+export async function codegenPlan({ text = '', module: mod = '', fields = [] } = {}) {
+  const t = String(text || '').trim();
+  const prompt = [
+    'You turn a user request into a ContextOS code plan. Output ONLY JSON:',
+    '{"scope":"toolbar|row","action":"Reject","label":"驳回","field":"status","op":"eq|ne|gt|lt|nonempty|empty","value":"created","why":"..."}',
+    'Rules:',
+    '- scope=toolbar when the button belongs to the toolbar (工具栏/工具条/页面上方).',
+    '- scope=row when it depends on a record (当…时/如果…就/某条数据…).',
+    '- action is a Go identifier in PascalCase derived from the Chinese label.',
+    '- field must be one of the module fields if provided; op defaults to eq; value is the literal compared.',
+    `- module: ${mod || '(unknown)'}; fields: ${(fields || []).join(', ') || '(unknown)'}`,
+    `Request: ${t}`,
+  ].join('\n');
+  let out = null;
+  try {
+    out = await llmJson({ prompt });
+  } catch (e) {
+    out = null;
+  }
+  const isToolbar = /(工具栏|工具条|页面上方|顶部|导航栏)/.test(t);
+  const scope = out ? (out.scope === 'toolbar' ? 'toolbar' : 'row') : (isToolbar ? 'toolbar' : 'row');
+  const label = (out && out.label) || (t.match(/[「"]([^」"]{1,8})[」"]/) || [])[1] || '';
+  const action = (out && out.action) || labelToIdent(label || t);
+  // 兜底：从「状态=待审」「status 为 approved」「金额大于 100」里抽字段/比较/值
+  const hit = t.match(/([a-z_]{2,20})\s*(?:=|==|为|是)\s*([^\s，。;；]{1,20})/i);
+  let field = (out && out.field) || (hit ? hit[1] : 'status');
+  let value = (out && out.value) || (hit ? hit[2] : '');
+  let op = (out && out.op) || 'eq';
+  if (!out) {
+    if (/(不为空|有值|非空)/.test(t)) { op = 'nonempty'; value = ''; }
+    else if (/(为空|没有值)/.test(t)) { op = 'empty'; value = ''; }
+    else if (/(不等于|不为|不是)/.test(t)) op = 'ne';
+    else if (/(大于|超过|高于)/.test(t)) op = 'gt';
+    else if (/(小于|低于|少于)/.test(t)) op = 'lt';
+  }
+  // 意图分类：加字段 / 加操作（按钮）/ 新建功能
+  const wantField = /(字段|一列|列名|column)/i.test(t) && !/(按钮|按键|操作|动作)/.test(t);
+  const wantAction = /(操作|动作|按键|按钮|功能)/.test(t);
+  if (wantField) {
+    const f = (t.match(/[「"]([a-z_]{2,20})[」"]/i) || [])[1] || (t.match(/(?:添加|新增|增加|加)(?:一个|个)?\s*([a-z_]{2,20})\s*(?:字段|列)/i) || [])[1] || '';
+    return {
+      scope: 'field', template: 'field', action: '', label: '', field: f,
+      op: '', value: '', why: '在模块里增加一个字段（系统级改 field，平台级改 fields + model 常量）', source: out ? 'llm' : 'fallback',
+    };
+  }
+  if (!wantAction) {
+    return {
+      scope: 'action', template: 'action', action, label: label || action, field: '', op: '', value: '',
+      params: 'title* content*', why: '给模块加一个动作（声明 + 方法 + 按钮）', source: out ? 'llm' : 'fallback',
+    };
+  }
+  return {
+    scope,
+    template: scope === 'toolbar' ? 'toolbarButton' : 'rowButton',
+    action,
+    label: label || action,
+    field,
+    op,
+    value,
+    params: 'title* content*',
+    why: (out && out.why) || '',
+    source: out ? 'llm' : 'fallback',
+  };
+}
+
+function labelToIdent(s) {
+  const map = { 驳回: 'Reject', 通过: 'Approve', 审批: 'Approve', 提交: 'Submit', 完成: 'Finish', 取消: 'Cancel', 删除: 'Remove', 归档: 'Archive', 提醒: 'Notify', 确认: 'Confirm', 退回: 'SendBack', 撤回: 'Withdraw' };
+  for (const k of Object.keys(map)) if (String(s).includes(k)) return map[k];
+  return 'Custom';
+}
+
+export async function resolveWrite({ text = '', apps = [], mode = 'write' } = {}) {
+  const list = (Array.isArray(apps) ? apps : []).slice(0, 12).map((a, i) => ({
+    i,
+    title: a.title || a.name || '',
+    space: a.space || '',
+    command: a.command || '',
+    functions: String(a.functions || '').slice(0, 200),
+  }));
+  if (!list.length) throw new Error('no recent app');
+  const prompt = [
+    mode === 'read'
+      ? '你是 ContextOS 的应用操作解析器。用户想【查询/查看】某个应用里的数据。'
+      : '你是 ContextOS 的应用操作解析器。用户在描述一次【往应用里写数据】的操作。',
+    '把应用当成目录、把功能当成目录里的文件：先选应用（目录），再选功能（文件）。',
+    `用户原话：${String(text).slice(0, 500)}`,
+    '可用的应用实例（functions 是逗号分隔的功能名）：',
+    JSON.stringify(list),
+    '',
+    '任务：',
+    '1. 选出最匹配的一个应用，用 i 表示它的下标。',
+    '2. 从该应用的 functions 里选出要调用的功能名（如 supplier / flow / request）。',
+    mode === 'read'
+      ? '3. 不需要抽取字段值，values 输出 {}。'
+      : '3. 只抽取原话里明确出现的字段值，抽不到就留空，不要编造。',
+    '只输出 JSON：{"i":0,"fn":"supplier","values":{"title":"中艾科技"},"why":"一句话"}',
+  ].join('\n');
+  const out = await llmJson({ prompt });
+  const i = Number(out?.i);
+  const app = list.find((x) => x.i === i) || null;
+  if (!app) throw new Error('model picked no app');
+  const fn = String(out?.fn || '').toLowerCase().replace(/[^a-z0-9_]/g, '').slice(0, 24);
+  const values = {};
+  if (out && out.values && typeof out.values === 'object') {
+    for (const [k, v] of Object.entries(out.values)) {
+      const key = String(k).replace(/[^a-z0-9_]/gi, '');
+      if (key && v != null && String(v).trim()) values[key] = String(v).slice(0, 200);
+    }
+  }
+  return { space: app.space, command: app.command, fn, values, mode, title: app.title, why: String(out?.why || '').slice(0, 120) };
+}
+
+export async function avatarSession(node, avatar) {
+  const r = await http(node, `/c/aaa.sess/action/create/${encode(avatar.username)}`, { method: 'PUT', timeout: 12000 });
+  const sid = r.text.trim();
+  if (r.status !== 200 || !sid) throw new Error(`avatar session failed: HTTP ${r.status}`);
+  return sid;
+}
+
+export async function pmCreate({ node, space, command, fields, uid, projectUid, sessid = '' }) {
+  const parts = splitFields(fields);
+  const seg = fieldSegments(parts.path);
+  const q = new URLSearchParams({ project_uid: projectUid, 'user.uid': uid });
+  if (sessid) q.set('sessid', sessid);
+  for (const [k, v] of Object.entries(parts.query)) q.set(k, v);
+  const r = await http(node, `/s/${encode(space)}/c/web.team.xiangmuguanli.portal/action/run/${command}/action/create/${seg}?${q}`, { method: 'PUT', timeout: 20000 });
+  try {
+    const env = JSON.parse(r.text);
+    return env.value_uid?.[0] || env.uid?.[0] || '';
+  } catch { return ''; }
+}
+
+export async function pmAction({ node, space, command, action, uid = '', fields = {}, projectUid, actorUid, sessid = '', method = '', taskUid = '', reportUid = '', extra = {} }) {
+  const verb = method || (/Create$/.test(action) ? 'PUT' : /Remove$/.test(action) ? 'DELETE' : /List$/.test(action) ? 'GET' : 'POST');
+  const parts = splitFields(fields || {});
+  const seg = fieldSegments(parts.path);
+  const q = new URLSearchParams({ project_uid: projectUid, 'user.uid': actorUid });
+  for (const [k, v] of Object.entries(parts.query)) q.set(k, v);
+  if (sessid) q.set('sessid', sessid);
+  if (uid) q.set('uid', uid);
+  if (taskUid) q.set('task_uid', taskUid);
+  if (reportUid) q.set('report_uid', reportUid);
+  for (const [k, v] of Object.entries(extra || {})) if (/_uid$/.test(k) && k !== 'uid' && k !== 'user_uid' && v) q.set(k, String(v));
+  const r = await http(node, `/s/${encode(space)}/c/web.team.xiangmuguanli.portal/action/run/${command}/action/${action}${seg ? '/' + seg : ''}?${q}`, { method: verb, timeout: 20000 });
+  let valueUid = '';
+  try { const env = JSON.parse(r.text); valueUid = env.value_uid?.[0] || ''; } catch { /* redirect */ }
+  return { status: r.status, uid: valueUid, text: r.text };
+}
+
+export async function planProject({ node, avatarUid = '', goal = '' } = {}) {
+  const avatars = await listAvatars({ node });
+  const avatar = (avatars.items || []).find((x) => x.uid === (avatarUid || avatars.active));
+  if (!avatar?.project?.space || !avatar.project.place_uid) throw new Error('avatar has no project');
+  const project = avatar.project;
+  let sessid = '';
+  try { sessid = await avatarSession(node, avatar); } catch { /* fall back to query uid */ }
+  const targetText = String(goal || '日常目标').slice(0, 200);
+  let plan = null;
+  try {
+    plan = await llmJson({ prompt: `你是项目管理助手。把目标拆成 JSON，只输出 JSON：\n{"target":{"title":"...","content":"..."},"plans":[{"title":"...","content":"...","begin_time":"YYYY-MM-DD","end_time":"YYYY-MM-DD","tasks":[{"title":"...","content":"...","report":{"title":"...","content":"..."},"feedback":{"title":"...","content":"...","score":"5","feedback_status":"canFinish"}}]}]}\n目标：${targetText}\n当前日期：${new Date().toISOString().slice(0, 10)}` });
+  } catch {
+    plan = { target: { title: targetText, content: `AI 拆解：${targetText}` }, plans: [{ title: '执行计划', content: `完成：${targetText}`, begin_time: new Date().toISOString().slice(0, 10), end_time: new Date(Date.now() + 7 * 86400000).toISOString().slice(0, 10), tasks: [{ title: '第一步', content: targetText, report: { title: '进度报告', content: '待填写' }, feedback: { title: '反馈', content: '待填写', score: '5', feedback_status: 'canFinish' } }] }] };
+  }
+  const warnings = [];
+  const target = plan.target || { title: targetText, content: targetText };
+  const targetUid = await pmCreate({ node, space: project.space, command: 'web.team.xiangmuguanli.target', fields: { title: target.title || targetText, content: target.content || targetText }, uid: avatar.uid, projectUid: project.place_uid, sessid });
+  let plans = 0, tasks = 0, reports = 0, feedbacks = 0;
+  for (const p of plan.plans || []) {
+    let planUid = '';
+    try {
+      const r = await pmAction({ node, space: project.space, command: 'web.team.xiangmuguanli.target', action: 'planCreate', uid: targetUid, fields: { title: p.title || '计划', content: p.content || '', begin_time: p.begin_time || new Date().toISOString().slice(0, 10), end_time: p.end_time || new Date(Date.now() + 7 * 86400000).toISOString().slice(0, 10) }, projectUid: project.place_uid, actorUid: avatar.uid, sessid });
+      planUid = r.uid;
+      plans++;
+    } catch (e) { warnings.push(`plan: ${String(e.message || e)}`); continue; }
+    // State machine: created → submitted → approved → process.
+    for (const action of ['submit', 'approve', 'process']) {
+      try { await pmAction({ node, space: project.space, command: 'web.team.xiangmuguanli.plan', action, uid: planUid, projectUid: project.place_uid, actorUid: avatar.uid, sessid }); }
+      catch { /* role may skip a transition; taskCreate below is the real gate */ }
+    }
+    for (const k of p.tasks || []) {
+      let taskUid = '';
+      try {
+        const r = await pmAction({ node, space: project.space, command: 'web.team.xiangmuguanli.plan', action: 'taskCreate', uid: planUid, fields: { title: k.title || '任务', content: k.content || '' }, projectUid: project.place_uid, actorUid: avatar.uid, sessid });
+        taskUid = r.uid; tasks++;
+      } catch (e) { warnings.push(`task: ${String(e.message || e)}`); continue; }
+      try { await pmAction({ node, space: project.space, command: 'web.team.xiangmuguanli.task', action: 'process', uid: taskUid, projectUid: project.place_uid, actorUid: avatar.uid, sessid }); } catch (e) { warnings.push(`task process: ${String(e.message || e)}`); }
+      let reportUid = '';
+      try {
+        const r = await pmAction({ node, space: project.space, command: 'web.team.xiangmuguanli.task', action: 'reportCreate', uid: taskUid, fields: { report_type: 'daily', title: k.report?.title || '进度报告', content: k.report?.content || '待填写' }, projectUid: project.place_uid, actorUid: avatar.uid, sessid });
+        reportUid = r.uid; reports++;
+      } catch (e) { warnings.push(`report: ${String(e.message || e)}`); continue; }
+      try {
+        await pmAction({ node, space: project.space, command: 'web.team.xiangmuguanli.report', action: 'feedbackCreate', uid: reportUid, fields: { title: k.feedback?.title || '反馈', content: k.feedback?.content || '待填写', score: k.feedback?.score || '5', feedback_status: k.feedback?.feedback_status || 'canFinish' }, projectUid: project.place_uid, actorUid: avatar.uid, sessid, taskUid });
+        feedbacks++;
+      } catch (e) { warnings.push(`feedback: ${String(e.message || e)}`); }
+    }
+  }
+  return { avatar, project, target_uid: targetUid, plans, tasks, reports, feedbacks, warnings };
+}

package/lib/core/data.js

@@ -0,0 +1,157 @@
+// 核心业务：应用数据读写（create/modify/remove + 回读）。
+import { http, encode, envelopeShape } from '../base/http.js';
+import { parseTable } from '../base/table.js';
+import { fieldSegments, splitFields } from '../base/field.js';
+import { waitFor } from '../misc/async.js';
+import { apiPath, dataPath, portalOf, placeUidKey, methodOf } from '../base/url.js';
+
+// URL 形状统一在 lib/base/url.js（接口 URL / 网页 URL 两套，见 docs/URL-SPEC.md）
+const portalPath = portalOf;
+
+// 空间没启动时，任何请求都只回 echo（body 只有 detail），写数据自然不生效。
+async function reviveSpace(node, space) {
+  try { await http(node, `/c/dream/action/start?name=${encode(space)}`, { method: 'POST', timeout: 60000 }); } catch { /* ignore */ }
+  await new Promise((r) => setTimeout(r, 2500));
+}
+
+// 内核没有并发控制：同一个 (节点, 空间, 命令, 实例) 上的写操作串行化，
+// 避免两个对话同时提交造成重复创建 / 覆盖。
+const WRITE_QUEUE = new Map();
+function serialize(key, fn) {
+  const prev = WRITE_QUEUE.get(key) || Promise.resolve();
+  const run = prev.then(fn, fn);
+  WRITE_QUEUE.set(key, run.catch(() => {}));
+  return run;
+}
+
+async function writeDataRaw({ node, space, command, fields = {}, action = 'create', uid = '', scope = {} }) {
+  // 实例条件就是 <place>_uid（place 是表名，默认 system），不存在通用的 system_uid
+  const systemUid = String((scope && (scope['system_uid'] || scope['project_uid'] || Object.entries(scope).find(([k, v]) => /_uid$/.test(k) && k !== 'user_uid' && v)?.[1])) || '');
+  const portal = systemUid ? portalPath(command) : '';
+  const parts = splitFields(fields);
+  const seg = fieldSegments(parts.path);
+  // 门户转发要拿回执（判断是否真的写入），不再用 noecho
+  const query = new URLSearchParams(portal ? {} : { 'space.noecho': 'true' });
+  const actor = String(uid || scope.user_uid || scope['user.uid'] || '');
+  if (uid) query.set('uid', uid);
+  if (actor) { query.set('user.uid', actor); query.set('user_uid', actor); }
+  for (const [k, v] of Object.entries(parts.query)) query.set(k, v);
+  for (const [k, v] of Object.entries(scope || {})) if (v) query.set(k, v);
+  let after;
+  for (let attempt = 0; attempt < 3 && !after; attempt++) {
+    if (attempt) await new Promise((r) => setTimeout(r, attempt * 2500));
+    const q = Object.fromEntries(query.entries());
+    // 写：/action/run/<cmd>/action/<action>/<k>/<v>…?user.uid=&<place>_uid=
+    const path = portal ? dataPath({ pod: space, command, action, seg, portal, scope: q }) : apiPath({ pod: space, command, action, seg, scope: q, portal });
+    const wrote = await http(node, path, { method: methodOf({ action }), timeout: 30000 });
+    if (/"detail"\s*:/.test(String(wrote.text || ''))) {
+      // 空间未启动/重启中：先把空间拉起来再重试
+      await reviveSpace(node, space);
+      continue;
+    }
+    let wroteCount = '';
+    try {
+      const st = JSON.parse(JSON.parse(wrote.text)._status?.[0] || '[]');
+      wroteCount = String(st.find((x) => x.name === 'count')?.value || '');
+    } catch { wroteCount = ''; }
+    if (wroteCount && !/^0x0$/.test(wroteCount)) {
+      // 创建回执本身就是新行：直接从中取 uid，供详情链接使用
+      let columns = [];
+      let rows = [];
+      let newUid = '';
+      try {
+        const env0 = JSON.parse(wrote.text);
+        const raw0 = env0.result ?? env0._result ?? env0.uid ?? '';
+        const first0 = Array.isArray(raw0) ? raw0[0] : raw0;
+        newUid = /^[0-9a-f]{24,64}$/i.test(String(first0 || '')) ? String(first0) : '';
+      } catch { /* 无 result 时留空 */ }
+      try {
+        const env = JSON.parse(wrote.text);
+        columns = Array.isArray(env.append) ? env.append : [];
+        const height = columns.length && Array.isArray(env[columns[0]]) ? env[columns[0]].length : 0;
+        rows = Array.from({ length: height }, (_, i) => {
+          const row = {};
+          for (const c of columns) row[c] = Array.isArray(env[c]) ? env[c][i] : '';
+          return row;
+        });
+      } catch { /* 回执不是表格结构时忽略 */ }
+      return { node, space, command, count: wroteCount, columns, rows, uid: newUid || rows[0]?.uid || '', write: { action, fields }, via: portal ? 'portal' : 'direct' };
+    }
+    try {
+      after = await waitFor(async () => {
+        const data = await readData({ node, space, command, query: scope });
+        return data.count && !/^0x/.test(data.count) ? data : undefined;
+      }, { timeout: 6000, interval: 600, label: `record in ${command}` });
+    } catch {
+      /* the space may still be restarting after compile; retry the write once */
+    }
+  }
+  if (!after) throw new Error(`写入未生效：空间可能正在编译/重启，请等「模板已就绪」后再提交（${command}）`);
+  return { ...after, write: { action, fields } };
+}
+
+export function writeData(args = {}) {
+  const { node, space, command, scope = {}, uid = '' } = args;
+  const inst = scope?.system_uid || scope?.project_uid || Object.entries(scope || {}).find(([k, v]) => /_uid$/.test(k) && k !== 'user_uid' && v)?.[1] || '';
+  const key = `${node}|${space}|${command}|${inst}|${uid}`;
+  return serialize(key, () => writeDataRaw(args));
+}
+
+export async function readData({ node, space, command, query = {}, inst = '', record = '' }) {
+  const qs = new URLSearchParams();
+  for (const [k, v] of Object.entries(query || {})) if (v) qs.set(k, v);
+  // 读：列表 /action/run/<cmd>/<place_uid>?user.uid=
+  //     详情 /action/run/<cmd>/<place_uid>/<uid>?user.uid=
+  const portal = portalOf(command);
+  const path = portal && inst
+    ? dataPath({ pod: space, command, action: '', inst, record, portal, scope: Object.fromEntries(qs.entries()) })
+    : `/s/${encode(space)}/c/${command}${qs.toString() ? '?' + qs : ''}`;
+  const r = await http(node, path, { timeout: 10000 });
+  let count = '';
+  let columns = [];
+  let rows = [];
+  let shape = 'list';
+  let fields = null;
+  try {
+    const envelope = JSON.parse(r.text);
+    const parsed = envelopeShape(r.text);
+    if (parsed.kind === 'detail') { shape = 'detail'; fields = parsed.fields; }
+    if (envelope && !Array.isArray(envelope)) {
+      try {
+        const status = JSON.parse(envelope._status?.[0] || '[]');
+        count = status.find((row) => row.name === 'count')?.value || '';
+      } catch {
+        /* count stays empty */
+      }
+      columns = Array.isArray(envelope.append) ? envelope.append : [];
+      const height = Array.isArray(envelope[columns[0]]) ? envelope[columns[0]].length : 0;
+      rows = Array.from({ length: height }, (_, i) => {
+        const row = {};
+        for (const c of columns) row[c] = Array.isArray(envelope[c]) ? envelope[c][i] : '';
+        return row;
+      });
+    }
+  } catch {
+    const table = parseTable(r.text);
+    columns = table.columns;
+    rows = table.rows;
+  }
+  return { node, space, command, status: r.status, shape, columns, rows, fields, count, raw: r.text.slice(0, 4000) };
+}
+
+// 删除：DELETE /action/run/<cmd>/action/remove?user.uid=&<place>_uid=&uid=
+// 修改用 modify(POST)，删除用 remove(DELETE)，动作名不同，别混。
+export async function removeData({ node, space, command, uid = '', scope = {} }) {
+  const actor = String(scope['user.uid'] || scope.user_uid || '');
+  const inst = String(scope.inst || scope.system_uid || scope.project_uid || Object.entries(scope).find(([k, v]) => /_uid$/.test(k) && k !== 'user_uid' && v)?.[1] || '');
+  const portal = portalOf(command);
+  const q = {};
+  if (actor) q['user.uid'] = actor;
+  if (inst) q[placeUidKey(String(scope.place || 'system'))] = inst;
+  if (uid) q.uid = uid;
+  const path = portal
+    ? dataPath({ pod: space, command, action: 'remove', seg: '', portal, scope: q })
+    : `/s/${encode(space)}/c/${command}/action/remove${new URLSearchParams(q).toString() ? '?' + new URLSearchParams(q) : ''}`;
+  const r = await http(node, path, { method: 'DELETE', timeout: 30000 });
+  return { status: r.status, removed: r.text.slice(0, 500), url: path };
+}