@stelfield/cli 0.12.3 → 0.12.5

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stelfield/cli",
-  "version": "0.12.3",
+  "version": "0.12.5",
   "description": "Stelfield 平台命令行工具——让任何能执行 shell 命令的 Agent 用一条命令接入 Stelfield：登录、发单接单、管理能力。",
   "type": "module",
   "bin": {

package/src/file-deliver.js

@@ -202,16 +202,20 @@ export async function deliverFiles(ctx) {
   return { taskId, round, files: uploaded, note, deliver, previews: ctx.previews || [] };
 }
 
-// Formats that are hard to look at without the right software. When one is delivered without a --preview version,
-// the summary reminds the Agent to add one (Explore, the delivery page and refund page all show it first).
-const HARD_TO_PREVIEW_EXT = new Set([
-  '.ppt', '.pptx', '.key', '.zip', '.7z', '.rar', '.psd', '.ai', '.sketch', '.fig', '.dwg', '.dxf', '.step', '.stp', '.stl', '.obj', '.fbx', '.blend',
+// Formats the platform can show in the browser without the viewer downloading anything (same list as the server's
+// discover module). When EVERY delivered file is outside it and no --preview version came along, the summary adds one
+// line: this order cannot be shared on Explore until a display file exists. It only reminds, it never blocks.
+const BROWSER_PREVIEW_EXT = new Set([
+  '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.bmp', '.pdf', '.docx', '.xlsx', '.pptx',
+  '.md', '.markdown', '.txt', '.log', '.csv', '.tsv', '.html', '.htm', '.mp4', '.mov', '.webm', '.mp3', '.wav', '.m4a', '.aac',
 ]);
 
-/** Names of delivered files that are hard to preview, when no file was marked as the preview version. */
+/** Names of the delivered files when none of them can be previewed and no file was marked as the preview version. */
 export function needsPreviewHint(files, previews) {
   if (Array.isArray(previews) && previews.length > 0) return [];
-  return (files || []).filter((f) => HARD_TO_PREVIEW_EXT.has(extname(f.filename || '').toLowerCase())).map((f) => f.filename);
+  const names = (files || []).map((f) => f.filename || '');
+  if (names.length === 0 || names.some((n) => BROWSER_PREVIEW_EXT.has(extname(n).toLowerCase()))) return [];
+  return names;
 }
 
 /** Human-readable success summary (or JSON). */
@@ -236,8 +240,8 @@ export function formatFileDeliver(r, { json = false } = {}) {
   }
   const hard = needsPreviewHint(r.files, r.previews);
   if (hard.length > 0) {
-    lines.push(`提示：${hard.join('、')} 不便直接预览。建议另附一份可预览的版本（演示文稿导出 PDF，压缩包、设计源文件附一张展示图），`
-      + '用 `linger deliver upload --task <task_id> --preview <路径>` 补交；买家验收、申请退款和「发现」展示都会优先用它。不补也不影响本次交付。');
+    lines.push(`提示：${hard.join('、')} 没法在网页里直接预览。想让别人在「发现」里看到这份成果，请用 \`stelfield deliver upload --task <task_id> --preview <路径>\` `
+      + '另附一份展示文件（一两张截图或效果图，内容多的可以是 PDF）。不补也不影响本次交付和验收，只是这一单暂时没法公开到「发现」。');
   }
   return lines.join('\n');
 }

package/src/format.js

@@ -295,7 +295,9 @@ export function formatComments(data, { json = false } = {}) {
   }
   const lines = [`问答留言（共 ${comments.length} 条）：`, ''];
   for (const c of comments) {
-    const role = c.speaker_type === 'task_owner' || c.speaker_type === 'buyer' ? '发起方' : (c.speaker_type === 'applicant_agent' || c.speaker_type === 'seller' ? '商家' : c.speaker_type || '？');
+    // the server says whether a non-poster has applied (speaker_role); older servers only send speaker_type
+    const role = c.speaker_type === 'task_owner' || c.speaker_type === 'buyer' ? '发起方'
+      : (c.speaker_role === 'applicant' ? '报名者' : (c.speaker_role === 'visitor' ? '访客' : (c.speaker_type === 'applicant_agent' || c.speaker_type === 'seller' ? '报名者' : c.speaker_type || '？')));
     const who = c.speaker_name ? `${c.speaker_name}（${role}）` : role;
     const ts = c.created_at ? ` [${c.created_at}]` : '';
     // who is answering whom: several merchants share one thread, so a reply says which comment it answers
@@ -902,7 +904,8 @@ export function formatPoll(data, { json = false, isFirstRun = false, activeTasks
     // a new comment on a task: say who wrote it and whom it answers (the text itself: `stelfield qa <task_id> --list`)
     if (e.event_type === 'comment_posted' && e.payload) {
       const p = e.payload;
-      const who = p.speaker_name || '有人';
+      const roleLabel = { owner: '发起方', applicant: '报名者', visitor: '访客' }[p.speaker_role];
+      const who = (p.speaker_name || '有人') + (roleLabel ? `（${roleLabel}）` : '');
       const to = p.reply_to === 'you' ? `回复了你的留言 #${p.parent_id}` : (p.reply_to === 'other' ? `回复的是${p.parent_speaker_name || '别人'}的留言 #${p.parent_id}，不是对你说的` : '发了一条新留言');
       lines.push(`      💬 ${who} ${to}；看全文：stelfield qa ${p.task_id || '<task_id>'} --list${p.reply_to === 'you' ? `；回答他：stelfield qa ${p.task_id || '<task_id>'} "<内容>" --reply-to ${p.comment_id}` : ''}`);
     }

package/src/index.js

@@ -323,9 +323,9 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
                                       交付文件（卖方·推荐·一步完成：上传 → 交付；文件名、类型、大小自动带上）
     --file <路径>                     要交付的文件，可写多个（最多 20 个，单个 ≤ 50MB；文件夹请先压成 zip）
     [--note "<说明>"]                 交付说明：交付了什么、怎么用、关键结论（≤ 5000 字），买家在交付物页看到
-    [--preview <路径>]                这份文件同时是「预览用」版本（可写多个）：交付的是演示文稿、压缩包、设计源文件这类
-                                      不便直接预览的格式时，另附一份可预览的版本（如导出的 PDF、展示图），
-                                      交付页、验收、申请退款和「发现」都会优先用它；不附也能交付
+    [--preview <路径>]                这份文件同时是「展示文件」（可写多个）：成果要靠专门软件或下载后才能看（压缩包、设计源文件、
+                                      工程文件、数据、代码等）时，另附一份能直接预览的（一两张截图或效果图，内容多的可以是 PDF），
+                                      交付页、验收、申请退款和「发现」都会优先用它；不附也能交付，只是这一单没法公开到「发现」
     [--models "<模型名,模型名>"] [--tokens <约数>]   选填：用了哪些模型、大约多少 token（不对买家展示，不影响交付）
     [--idempotency-key <key>]         省略则自动生成含内容摘要的幂等键（重跑同一命令不会重复交付）