@us_momo/dsh-erp-analysis 1.5.2 → 1.6.0

package/release.mjs

@@ -97,6 +97,7 @@ export function validateRelease(manifest) {
     "app/release.mjs",
     "app/control.mjs",
     "app/launcher.mjs",
+    "app/selection_archive.mjs",
     "app/control.html",
     "workspace/AGENTS.md",
   ];
@@ -212,7 +213,13 @@ async function installReleaseUnlocked(root, manifest, { defer = true } = {}) {
     await atomicJson(join(root, "pending.json"), marker);
     return { ...marker, status: "pending-reload" };
   }
-  await publishWorkspace(root, target, marker);
+  try {
+    await publishWorkspace(root, target, marker);
+  } catch (error) {
+    if (!current || !error.workspaceRestored || !["EPERM", "EBUSY", "EACCES"].includes(error.code)) throw error;
+    await atomicJson(join(root, "pending.json"), marker);
+    return { ...marker, status: "pending-reload", reason: "workspace_busy" };
+  }
   await rm(join(root, "pending.json"), { force: true });
   return { ...marker, status: "installed" };
 }
@@ -248,17 +255,19 @@ async function publishWorkspace(root, target, marker) {
       await rename(join(workspace, name), join(stage, name));
     for (const name of old.reverse())
       await rename(join(previous, name), join(workspace, name));
+    error.workspaceRestored = true;
     throw error;
   }
 }
 async function activatePendingUnlocked(root) {
   const pending = await readJson(join(root, "pending.json"), null);
   if (!pending || (await liveLeases(root)).length) return false;
-  await publishWorkspace(
-    root,
-    join(root, "versions", pending.version),
-    pending,
-  );
+  try {
+    await publishWorkspace(root, join(root, "versions", pending.version), pending);
+  } catch (error) {
+    if (!error.workspaceRestored || !["EPERM", "EBUSY", "EACCES"].includes(error.code)) throw error;
+    return false;
+  }
   await rm(join(root, "pending.json"), { force: true });
   return true;
 }

package/selection_archive.mjs

@@ -0,0 +1,151 @@
+import { readFile, realpath, stat } from 'node:fs/promises';
+import { basename, dirname, join, resolve } from 'node:path';
+import { createHash } from 'node:crypto';
+import { atomicJson, readJson } from './release.mjs';
+
+export const selectionRequirements = ['erp_selection_list', 'erp_selection_read', 'erp_selection_save',
+  'erp_selection_operation', 'erp_selection_file_save', 'erp_selection_analyze'];
+
+export function selectionCapability(tools) {
+  const names = new Set(tools.map(tool => tool.name));
+  const missing = selectionRequirements.filter(name => !names.has(name));
+  return { available: missing.length === 0, missing };
+}
+
+export const researchSaveTool = {
+  name: 'erp_selection_research_save',
+  description: '用户明确保存后，将本机研究草稿分步写入ERP并返回可读链接。request含固定operationId(UUID)和path(JSON草稿)。草稿为{direction:{id?,expectedVersion?,name?,market?,summary?,relatedId?},report:{id?,expectedVersion?,title?,sections,references?},materials:[{key,path,sourceNote?,site?,collectedOn?}]}。新主题给name；接续先read，给direction.id，已有主报告须给report.id/expectedVersion，仅写本轮章节。Markdown图片用![说明](material:唯一key)，材料路径相对草稿文件；保存后自动上传并换为ERP图片地址。每步固定操作号，结果未知再次调用原operationId和原草稿，恢复成功步骤；不会重复建整套档案。普通研究讨论不调用本工具。',
+  inputSchema: { type: 'object', additionalProperties: false, required: ['request'], properties: {
+    request: { type: 'object', additionalProperties: false, required: ['operationId', 'path'], properties: {
+      operationId: { type: 'string', format: 'uuid' }, path: { type: 'string' },
+    } },
+  } },
+};
+
+function stepId(operationId, name) {
+  const bytes = createHash('sha256').update(operationId + ':' + name).digest().subarray(0, 16);
+  bytes[6] = (bytes[6] & 15) | 80; bytes[8] = (bytes[8] & 63) | 128;
+  const hex = bytes.toString('hex');
+  return `${hex.slice(0, 8)}-${hex.slice(8, 12)}-${hex.slice(12, 16)}-${hex.slice(16, 20)}-${hex.slice(20)}`;
+}
+const hash = value => createHash('sha256').update(value).digest('hex');
+function canonical(value) {
+  if (Array.isArray(value)) return value.map(canonical);
+  if (value && typeof value === 'object') return Object.fromEntries(Object.keys(value).sort().map(key => [key, canonical(value[key])]));
+  return value;
+}
+const uuid = value => typeof value === 'string' && /^[0-9a-f]{8}-(?:[0-9a-f]{4}-){3}[0-9a-f]{12}$/i.test(value);
+
+function fields(value, allowed, name) {
+  if (!value || typeof value !== 'object' || Array.isArray(value) || Object.keys(value).some(key => !allowed.includes(key)))
+    throw new Error(`${name}草稿字段不符，请按 erp_selection_research_save 的结构准备。`);
+}
+
+export async function saveResearch(client, root, { request }) {
+  if (!uuid(request?.operationId)) throw new Error('保存操作编号须为固定 UUID。');
+  const capabilities = selectionCapability((await client.tools()).tools || []);
+  if (!capabilities.available)
+    throw new Error(`当前会话连接未提供选品建档工具：${capabilities.missing.join(', ')}。请在公司 ERP 分析入口接续，不把本会话目录缺失解释为ERP未实现。`);
+  const device = await readJson(join(root, 'private', 'device.json'), null);
+  if (!uuid(device?.deviceId)) throw new Error('请先在公司 ERP 分析入口登录本人 ERP。');
+  client.checkIdentity?.(device);
+  const call = (name, args) => client.call(name, args, { expectedDeviceId: device.deviceId });
+  const path = await realpath(resolve(root, 'workspace', request.path));
+  if ((await stat(path)).size > 2 * 1024 * 1024) throw new Error('研究草稿超过 2 MiB。');
+  const draft = JSON.parse(await readFile(path, 'utf8'));
+  fields(draft, ['direction', 'report', 'materials'], '研究');
+  fields(draft.direction, ['id', 'expectedVersion', 'name', 'market', 'summary', 'relatedId'], '主题/方向');
+  fields(draft.report, ['id', 'expectedVersion', 'title', 'sections', 'references'], '报告');
+  fields(draft.report.sections, ['scope', 'types', 'prices', 'needs', 'trends', 'conclusion', 'sourcing'], '章节');
+  if (!Object.keys(draft.report.sections).length || Object.values(draft.report.sections).some(value => typeof value !== 'string' || value.length > 60000))
+    throw new Error('请提供本轮研究章节文字，每章最多 60000 字符。');
+  if (draft.report.references !== undefined && !Array.isArray(draft.report.references)) throw new Error('报告引用须为数组。');
+  if (draft.direction.id && !uuid(draft.direction.id) || !draft.direction.id && (typeof draft.direction.name !== 'string' || !draft.direction.name.trim()))
+    throw new Error('新研究须有名称；接续须有正确主题/方向编号。');
+  if (!Array.isArray(draft.materials ?? []) || (draft.materials?.length ?? 0) > 40) throw new Error('materials须为最多40项的原件与代表图片数组。');
+  const keys = new Set(), materials = [];
+  for (const item of draft.materials ?? []) {
+    fields(item, ['key', 'path', 'sourceNote', 'site', 'collectedOn'], '原件');
+    if (typeof item.key !== 'string' || !/^[a-zA-Z0-9_-]{1,60}$/.test(item.key) || keys.has(item.key)) throw new Error('材料key须唯一，使用字母、数字、下划线或短横线。');
+    keys.add(item.key);
+    const source = await realpath(resolve(dirname(path), item.path));
+    if (!(await stat(source)).isFile() || (await stat(source)).size > 8 * 1024 * 1024) throw new Error('原件须为8MiB以内的文件。');
+    const bytes = await readFile(source);
+    materials.push({ ...item, filename: basename(source), bytes, sha256: hash(bytes) });
+  }
+  const markdown = Object.values(draft.report.sections).join('\n');
+  for (const match of markdown.matchAll(/\(material:([a-zA-Z0-9_-]+)\)/g))
+    if (!keys.has(match[1])) throw new Error('章节引用了未提供的材料key。');
+  const illustrations = materials.filter(item => /\.(png|jpe?g|webp)$/i.test(item.filename));
+  const unplaced = illustrations.filter(item => !markdown.includes(`](material:${item.key})`));
+  if (unplaced.length && draft.report.sections.types === undefined) throw new Error('请提供types章节，用于展示本轮代表图片。');
+  for (const match of markdown.matchAll(/!\[[^\]]*\]\(([^\s)]+)(?:\s+[^)]*)?\)/g)) {
+    const url = match[1];
+    if (url.startsWith('material:')) {
+      const material = materials.find(item => item.key === url.slice(9));
+      if (!material || !/\.(png|jpe?g|webp)$/i.test(material.filename)) throw new Error('报告图片须引用已提供的图片材料key。');
+    } else if (!/^https?:\/\//i.test(url) && !/^\/api\/v1\/selection\/files\/[0-9a-f-]+\?inline=1$/i.test(url)) {
+      throw new Error('报告图片仍指向本机或临时地址，请以 material:key 引用原图材料。');
+    }
+  }
+  const digest = hash(JSON.stringify({ draft, files: materials.map(item => [item.key, item.sha256]) }));
+  const journalPath = join(root, 'private', 'selection-saves', device.deviceId, request.operationId + '.json');
+  let journal = await readJson(journalPath, null);
+  if (journal && journal.digest !== digest) throw new Error('同一保存操作编号的研究内容或原件已变化，请先核对原结果。');
+  journal ||= { digest, deviceId: device.deviceId, steps: {} };
+  await atomicJson(journalPath, journal);
+  const progress = () => ({ directionId: journal.steps.direction?.item.id ?? draft.direction.id,
+    reportId: journal.steps.report?.item.id, fileIds: Object.fromEntries(materials.filter(item => journal.steps['file-' + item.key]).map(item => [item.key, journal.steps['file-' + item.key].item.id])) });
+  async function step(key, action, data, target) {
+    const operationId = stepId(request.operationId, key);
+    const command = { operationId, action, data, ...(target?.id ? { targetId: target.id, expectedVersion: target.expectedVersion } : {}) };
+    const digest = hash(JSON.stringify(canonical(command)));
+    const stored = journal.steps[key];
+    if (stored) {
+      if (stored.digest !== digest) throw new Error('保存步骤内容已变化，请核对原研究。');
+      return stored.item;
+    }
+    const original = await call('erp_selection_operation', { request: { operationId } });
+    if (!['saved', 'not_found'].includes(original.status)) throw new Error('原操作状态未知，本次未重投保存。');
+    if (original.status === 'saved' && original.requestDigest !== digest) throw new Error('原操作回执与本轮内容不一致，不能以原编号认领或覆盖。请核对已保存资料。');
+    const receipt = original.status === 'saved' ? original : await call(action === 'material' ? 'erp_selection_file_save' : 'erp_selection_save', {
+      request: action === 'material' ? { operationId, ...data } : command,
+    });
+    if (receipt.operationId !== operationId || !uuid(receipt.item?.id)) throw new Error('保存回执不完整，请用原操作编号恢复。');
+    journal.steps[key] = { digest, item: receipt.item };
+    await atomicJson(journalPath, journal);
+    return receipt.item;
+  }
+  try {
+    let latest;
+    if (draft.direction.id) latest = await call('erp_selection_read', { request: { directionId: draft.direction.id } });
+    const existingMain = latest?.reports.find(item => item.kind === 'main');
+    if (existingMain && (draft.report.id !== existingMain.id || !Number.isInteger(draft.report.expectedVersion)))
+      throw new Error('已有主报告：请先读取最新报告，合并本轮章节并提供report.id和expectedVersion。');
+    const { id, expectedVersion, ...directionData } = draft.direction;
+    const direction = id && !Object.keys(directionData).length ? latest.direction : await step('direction', 'direction', directionData, id ? { id, expectedVersion } : undefined);
+    const fileIds = {};
+    for (const item of materials) {
+      const { key, filename, bytes, sourceNote, site, collectedOn } = item;
+      const data = { directionId: direction.id, filename, contentBase64: bytes.toString('base64'),
+        ...(sourceNote !== undefined ? { sourceNote } : {}), ...(site !== undefined ? { site } : {}), ...(collectedOn !== undefined ? { collectedOn } : {}) };
+      fileIds[key] = (await step('file-' + key, 'material', data)).id;
+    }
+    const sections = Object.fromEntries(Object.entries(draft.report.sections).map(([key, value]) => [key,
+      value.replace(/\(material:([a-zA-Z0-9_-]+)\)/g, (_, key) => `(/api/v1/selection/files/${fileIds[key]}?inline=1)`)]));
+    if (unplaced.length) sections.types += '\n\n### 代表图片\n' + unplaced.map(item =>
+      `\n![${(item.sourceNote || item.filename).replace(/[\[\]\r\n]/g, ' ')}](/api/v1/selection/files/${fileIds[item.key]}?inline=1)\n\n${item.sourceNote || item.filename}\n`).join('\n');
+    const allReferences = [...(existingMain?.references ?? []), ...(draft.report.references ?? []), ...materials.map(item => ({ title: item.filename, fileId: fileIds[item.key] }))];
+    const references = allReferences.filter((item, index) => allReferences.findIndex(other => JSON.stringify(other) === JSON.stringify(item)) === index);
+    const report = journal.steps.report?.item ?? await step('report', 'report', { ...(draft.report.id ? {} : { directionId: direction.id, kind: 'main' }),
+      ...(draft.report.title !== undefined ? { title: draft.report.title } : {}), sections, references }, draft.report.id ? draft.report : undefined);
+    const saved = await call('erp_selection_read', { request: { directionId: direction.id } });
+    if (!saved.reports.some(item => item.id === report.id) || materials.some(item => !saved.files.some(file => file.id === fileIds[item.key])))
+      throw new Error('保存已受理，但回读未核对完成，请用原请求恢复。');
+    return { status: 'saved', operationId: request.operationId, directionId: direction.id, reportId: report.id, reportVersion: report.version,
+      fileIds, url: new URL('/workspace/selection?directionId=' + direction.id, client.base).href };
+  } catch (error) {
+    error.partial = progress();
+    throw error;
+  }
+}