@us_momo/dsh-erp-analysis 1.8.0 → 1.10.0

package/selection_archive.mjs

@@ -14,7 +14,7 @@ export function selectionCapability(tools) {
 
 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和原草稿，恢复成功步骤；不会重复建整套档案。普通研究讨论不调用本工具。',
+  description: '用户明确保存后，将本机研究草稿分步写入ERP并返回可读链接。request含固定operationId(UUID)和path(JSON草稿)。草稿为{direction:{id?,expectedVersion?,name?,market?,summary?,relatedId?},report:{id?,expectedVersion?,title?,sections?,references?,comparison?},materials:[{key,path,sourceNote?,site?,collectedOn?}]}。新主题给name；接续先read，给direction.id，已有主报告须给report.id/expectedVersion，仅写本轮章节。comparison为{title?,basis?,dimensions?,groups:[{name,summary?,features?,samples?,evidence?,notes?}]}；samples用{name,identifier?,url?,imageKey?}，imageKey关联materials，保存时换成imageFileId；已有图片可用imageFileId。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' },
@@ -55,10 +55,26 @@ export async function saveResearch(client, root, { request }) {
   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, ['id', 'expectedVersion', 'title', 'sections', 'references', 'comparison'], '报告');
+  draft.report.sections ??= {};
   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))
+  if (!Object.keys(draft.report.sections).length && draft.report.comparison === undefined || Object.values(draft.report.sections).some(value => typeof value !== 'string' || value.length > 60000))
     throw new Error('请提供本轮研究章节文字，每章最多 60000 字符。');
+  const comparisonSamples = [];
+  if (draft.report.comparison != null) {
+    fields(draft.report.comparison, ['title', 'basis', 'dimensions', 'groups'], '图文对照');
+    if (!Array.isArray(draft.report.comparison.groups) || !draft.report.comparison.groups.length || draft.report.comparison.groups.length > 60)
+      throw new Error('图文对照须包含1到60个类型。');
+    for (const group of draft.report.comparison.groups) {
+      fields(group, ['name', 'summary', 'features', 'samples', 'evidence', 'notes'], '类型');
+      if (!Array.isArray(group.samples ?? [])) throw new Error('代表商品须为数组。');
+      for (const sample of group.samples ?? []) {
+        fields(sample, ['name', 'identifier', 'url', 'imageKey', 'imageFileId'], '代表商品');
+        if (sample.imageKey && sample.imageFileId) throw new Error('代表图片请选择本轮imageKey或已保存imageFileId。');
+        comparisonSamples.push(sample);
+      }
+    }
+  }
   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('新研究须有名称；接续须有正确主题/方向编号。');
@@ -77,7 +93,9 @@ export async function saveResearch(client, root, { request }) {
   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})`));
+  for (const sample of comparisonSamples) if (sample.imageKey && !illustrations.some(item => item.key === sample.imageKey))
+    throw new Error('代表商品imageKey须指向本轮提供的图片材料。');
+  const unplaced = illustrations.filter(item => !markdown.includes(`](material:${item.key})`) && !comparisonSamples.some(sample => sample.imageKey === 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];
@@ -135,13 +153,22 @@ export async function saveResearch(client, root, { request }) {
       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 comparison = draft.report.comparison == null ? draft.report.comparison : {
+      ...draft.report.comparison, groups: draft.report.comparison.groups.map(group => ({ ...group,
+        ...(group.samples ? { samples: group.samples.map(({ imageKey, ...sample }) => ({ ...sample,
+          ...(imageKey ? { imageFileId: fileIds[imageKey] } : {}) })) } : {}),
+      })),
+    };
     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);
+      ...(draft.report.title !== undefined ? { title: draft.report.title } : {}), sections, references,
+      ...(comparison !== undefined ? { comparison } : {}) }, 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('保存已受理，但回读未核对完成，请用原请求恢复。');
+    if (comparison !== undefined && !!saved.reports.find(item => item.id === report.id)?.comparison !== !!comparison)
+      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) {