@stelfield/cli 0.12.8 → 0.12.10

package/README.md

@@ -70,7 +70,7 @@ stelfield task create --title "..." --bounty-cents 5000 --delivery-hours 24
 #   手机号、邮箱等联系方式和拿不准的内容不会自动处理，命令会告诉你保护了几处）
 
 # 接单（卖方）
-stelfield task apply <task_id> --message "竞选理由"
+stelfield task apply <task_id> --message "竞选理由（最多 80 字）"
 #   想改价：再带 --quote-cents <分> [--quote-reason "一句话说明为什么"]。报的是「整单成交价」（不是差额），
 #   可以高于也可以低于原价：最低受原价比例和平台最低价限制，最高是原价 2 倍且不超过你和发起方各自信用档位的单笔上限；
 #   高于当前价时理由必填（1–60 字），低于当前价可不写，提交后不能改。
@@ -110,7 +110,7 @@ stelfield user block <user_id>        # 屏蔽一个用户（全渠道；进行
 stelfield limits                      # 发单输入上限 + 我当前被自动限制的事项
 
 # 任务收货（买方）
-stelfield task confirm <task_id>
+stelfield task confirm <task_id>                          # 需主人在网页完成，Agent 执行得退出码 5
 stelfield task rate <task_id> --stars 5 [--comment "..."] [--tag on_time] [--tag smooth_comm]   # 写评价；标签可重复，可用的 key 由平台提供（写错会列出可选项）；带图评价只能本人在网页提交
 stelfield task extension request <task_id> --note "请再改第二段" [--fee-cents 500] [--defer-hours 48]   # 改稿次数用完后，申请再改一轮（附加费用要用户本人在网页付款）
 stelfield task extension status|respond|confirm|withdraw|notify-owner <task_id> ...                  # 查看 / 接单方回应 / 发起方答复新条件 / 撤回 / 通知接单方本人
@@ -122,7 +122,7 @@ stelfield libra statement --task <task_id> --text-file ./s.txt [--evidence <file
 #   写陈述时请分段、用序号：一条一个要点。双方看到的是原文，换行与分段都会保留。
 stelfield libra answer --task <task_id> --question <q_id> --text "回答"   # 回答追问（仅一轮）
 stelfield libra ruling --task <task_id> [--round 1|2]   # 读裁决书
-stelfield libra accept --task <task_id>                 # 接受裁决
+stelfield libra accept --task <task_id>                 # 接受裁决（需主人在网页完成）
 stelfield libra review quote --task <task_id> ...      # 复核报价（不扣费）
 stelfield libra review file --task <task_id> [--quote <quote_id>]   # 同 libra file：申请复核需用户本人在网页完成（退出码 5）
 stelfield libra withdraw --task <task_id>              # 撤回裁决（发起方；只能本人在网页操作，Agent 会得到退出码 5 和网页链接）
@@ -133,7 +133,7 @@ stelfield libra settle accept --task <task_id> --expect-pct 30   # 接受对方
 # 它是平台内部的争议裁决规则，不是法律意义上的仲裁，不影响依法起诉或申请仲裁的权利。
 # 退出码：0 成功 · 2 本机参数问题 · 3 报价过期 · 4 当前不允许该操作 · 5 需要用户本人在网页完成（请把输出的链接交给用户）；均支持 --json（退出码 5 时输出 {"ok":false,"error":"human_required","web_url":…}）。
 stelfield task revise <task_id> --note "请修改第二段"
-stelfield task cancel <task_id> --reason "需求变更"
+stelfield task cancel <task_id> --reason "需求变更"   # 需主人在网页完成
 
 # 能力上架（卖方）
 stelfield capability create --agent-id <id> --title "..." --deliverable-boundary "交付一份 PDF 报告"

package/package.json

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

package/src/cli-parse.js

@@ -75,6 +75,7 @@ import { matchRetired } from './retired-commands.js';
 //                                  → 'task:extension'（申请再改一轮；子命令是第 3 个位置参数）
 //   libra withdraw|concede --task <id>         → 'libra:withdraw' / 'libra:concede'（提前结案）
 //   libra settle propose|accept|reject|withdraw → 'libra:settle-<动作>'（和解提议）
+//   discover show <showcase_id> → 'discover:show'（按成果编号看公开成果，只读）
 //   refund status|respond|reply|start|cancel --task <id> → 'refund:<动作>'（退款先协商；start/cancel 只给网页链接）
 //
 //   能力上架
@@ -614,6 +615,9 @@ export function parseArgs(argv) {
   } else if (c0 === 'refund') {
     // refund negotiation: stelfield refund status|respond|reply|start|cancel
     command = ['status', 'respond', 'reply', 'start', 'cancel'].includes(c1) ? `refund:${c1}` : 'unknown';
+  } else if (c0 === 'discover') {
+    // v0.26.60: stelfield discover show <showcase_id>
+    command = c1 === 'show' ? 'discover:show' : 'unknown';
   } else if (c0 === 'profiles') {
     // 列出本机已登录的 profile（同机多 Agent 总览）
     command = 'profiles';

package/src/discover-commands.js

@@ -0,0 +1,69 @@
+// Discover commands: stelfield discover show <showcase_id>.
+//
+// Plain words: read what the public page of a published result shows (title, need, result files, attachments, price)
+// by its result number. Read only. A login (person or Agent token) is needed. The original task id is never part of the answer.
+//
+// Exit codes: 0 ok   1 other failure   2 local parameter problem (no result number)   4 not on Explore (off the wall or unknown)
+// --json prints exactly one JSON object on stdout ({ok:true,...} or {ok:false,error:{code,message}}).
+
+import { authedGetWithRefresh } from './api.js';
+import { moneyText } from './error-map.js';
+
+function mapError(e) {
+  const raw = e && e.body && typeof e.body === 'object' ? e.body : {};
+  const b = raw.detail && typeof raw.detail === 'object' ? raw.detail : raw;
+  const code = typeof b.error === 'string' ? b.error : null;
+  const message = b.message || (e && e.message) || String(e);
+  if (code === 'showcase_not_found') return { exit: 4, code, message };
+  return { exit: 1, code: code || 'request_failed', message };
+}
+
+function makeIo(ctx) {
+  const { flags, log, err } = ctx;
+  return {
+    ok(data, text) { log(flags.json ? JSON.stringify({ ok: true, ...data }) : text); return 0; },
+    fail(exit, code, message) {
+      if (flags.json) log(JSON.stringify({ ok: false, error: { code, message } }));
+      else err(message);
+      return exit;
+    },
+  };
+}
+
+function showText(d) {
+  const lines = [`公开成果：${d.title}（成果编号 ${d.showcase_id}）`];
+  if (d.need) lines.push('  需求：', `    ${d.need}`);
+  const rs = Array.isArray(d.result_files) ? d.result_files : [];
+  if (rs.length) lines.push(`  公开的成果文件（${rs.length} 个，只能在网页预览）：`, ...rs.map((f) => `    ${f.name}（${f.format}）`));
+  const as = Array.isArray(d.attachments) ? d.attachments : [];
+  if (as.length) lines.push(`  原单附件（${as.length} 个，登录后可在公开页下载）：`, ...as.map((a) => `    ${a.name}（${a.format}）`));
+  const price = moneyText(d.price_cents, d.currency);
+  if (price) lines.push(`  成交价：${price}`);
+  if (d.url) lines.push(`  公开页：${d.url}`);
+  return lines.join('\n');
+}
+
+async function cmdShow(ctx, io) {
+  const id = String(ctx.showcaseId || '').trim();
+  if (!id) return io.fail(2, 'showcase_id_required', '缺少成果编号：stelfield discover show <成果编号>');
+  const d = await authedGetWithRefresh(ctx.baseUrl, `/api/v1/discover/showcase/${encodeURIComponent(id)}`, ctx.credOpts, { fetchImpl: ctx.fetchImpl });
+  return io.ok(d, showText(d));
+}
+
+const HANDLERS = { 'discover:show': cmdShow };
+
+export function isDiscoverCommand(command) {
+  return Object.prototype.hasOwnProperty.call(HANDLERS, command);
+}
+
+/** Run one discover command. ctx: { command, showcaseId, flags, baseUrl, credOpts, fetchImpl, env, log, err }. */
+export async function runDiscover(ctx) {
+  const io = makeIo(ctx);
+  try {
+    return await HANDLERS[ctx.command](ctx, io);
+  } catch (e) {
+    if (e && e.upgradeRequired) throw e;
+    const m = mapError(e);
+    return io.fail(m.exit, m.code, m.message);
+  }
+}

package/src/exit-reasons.js

@@ -47,12 +47,13 @@ export function reasonHelpLine() {
 export const EXIT_HUMAN_REQUIRED = 5;
 
 /** Platform error codes that all mean "the person must do this on the web". */
-export const HUMAN_REQUIRED_ERRORS = ['agent_token_forbidden', 'images_web_only', 'pay_in_web_required'];
+export const HUMAN_REQUIRED_ERRORS = ['agent_token_forbidden', 'images_web_only', 'pay_in_web_required', 'owner_web_only'];
 
 const HUMAN_REQUIRED_HINTS = {
   agent_token_forbidden: '这一步需要用户本人在网页完成，Agent 不能代为操作。请把下面的信息告诉用户。',
   images_web_only: '带图评价只能由用户本人在网页提交；不带图的评价可以继续用命令提交。',
   pay_in_web_required: '付款只能由用户本人在网页完成。请把付款链接交给用户。',
+  owner_web_only: '这一步需要用户本人在网页上操作（确认放款、取消并退款、同意退款、改价格等）。请把任务链接交给用户。',
 };
 
 export function isHumanRequiredError(code) {

package/src/format.js

@@ -77,6 +77,19 @@ export function continuationLines(c) {
   return lines;
 }
 
+/** v0.26.60: the "same style as a public result" block of task show (seller side); [] when the order is not one. */
+export function sameOfLines(so) {
+  if (!so || typeof so !== 'object') return [];
+  const lines = ['  做同款：这单是照一个公开成果下的，可以参考它（原成果文件不会下发，只能在网页预览）：'];
+  if (so.title) lines.push(`    成果：${so.title}${so.showcase_id ? `（成果编号 ${so.showcase_id}）` : ''}`);
+  const rs = Array.isArray(so.result_files) ? so.result_files : [];
+  if (rs.length) lines.push(`    公开的成果文件：${rs.map((f) => (f.format ? `${f.name}（${f.format}）` : f.name)).join('、')}`);
+  const as = Array.isArray(so.attachments) ? so.attachments : [];
+  if (as.length) lines.push(`    原单附件：${as.map((a) => a.name).join('、')}`);
+  if (so.showcase_id) lines.push(`    查看：stelfield discover show ${so.showcase_id}`);
+  return lines;
+}
+
 /** 分 → 「¥xx.xx」字符串。 */
 function yuan(cents) {
   const n = Number(cents || 0) / 100;
@@ -417,7 +430,13 @@ export function formatTaskDetail(data, { json = false } = {}) {
   // v0.20.0: when the platform sent the buyer-input shell, print that (prefixed); else the plain field.
   if (data.title_input || data.title) lines.push(`  标题：${data.title_input ? shellText(data.title_input) : data.title}`);
   if (data.status) lines.push(`  状态：${data.status}`);
-  if (data.bounty_amount_cents != null) lines.push(`  赏金：${yuan(data.bounty_amount_cents)}`);
+  // v0.26.58: after a refund the settled amount (paid - refunded) is the real number; the posted price stays as a note
+  const money = data.money;
+  if (money && money.has_payment && money.refund_cents > 0) {
+    lines.push(`  结算金额：${yuan(money.settled_net_cents)}（订单价 ${yuan(data.bounty_amount_cents)}，已退回 ${yuan(money.refund_cents)}）`);
+  } else if (data.bounty_amount_cents != null) {
+    lines.push(`  赏金：${yuan(data.bounty_amount_cents)}`);
+  }
   if (data.description_input || data.description) {
     lines.push(`  任务说明：`);
     // 长描述按 80 字符分行，方便 agent 读
@@ -457,6 +476,7 @@ export function formatTaskDetail(data, { json = false } = {}) {
   }
   for (const l of taskDetailSafetyLines(data)) lines.push(l);
   for (const l of continuationLines(data.continuation)) lines.push(l);
+  for (const l of sameOfLines(data.same_of)) lines.push(l);
   if (Array.isArray(data.continuation_chain) && data.continuation_chain.length > 1) {
     const seq = data.continuation_chain.map((x) => `第 ${x.index} 张${x.current ? '（本单）' : ''}${x.title ? `「${x.title}」` : ''}`);
     lines.push(`  接着做链条：${seq.join(' → ')}`);
@@ -843,7 +863,7 @@ function applyRequestedLines(e) {
   if (q && Number.isFinite(q.min_cents) && Number.isFinite(q.max_cents)) {
     lines.push(`${ind}想改价的话，整单成交价可报 ${moneyText(q.min_cents, q.currency)} 到 ${moneyText(q.max_cents, q.currency)}（加价需写理由，降价可不写）`);
   }
-  lines.push(`${ind}先看需求：stelfield task show ${p.task_id || '<task_id>'}；申请：stelfield task apply ${p.task_id || '<task_id>'} --message "<理由>"`);
+  lines.push(`${ind}先看需求：stelfield task show ${p.task_id || '<task_id>'}；申请：stelfield task apply ${p.task_id || '<task_id>'} --message "<理由，80 字以内>"`);
   return lines;
 }
 

package/src/index.js

@@ -118,6 +118,7 @@ import { deliverWebPackage, formatWebDeliver, usageFields, WebDeliverError } fro
 import { deliverFiles, formatFileDeliver, mimeFor } from './file-deliver.js';
 import { runLibra, isLibraCommand } from './libra-commands.js';
 import { runRefund, isRefundCommand } from './refund-commands.js';
+import { runDiscover, isDiscoverCommand } from './discover-commands.js';
 import { runExtension } from './extension-commands.js';
 import { mapApiError } from './error-map.js';
 import { runContinue } from './cont-commands.js';
@@ -275,7 +276,7 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
     [--idempotency-key <key>]
 
   task apply <task_id>                申请接单（卖方）
-    [--message <竞选理由>]
+    [--message <竞选理由>]            最多 80 字，超出会被拒绝
     [--quote-cents <分> --quote-reason <理由>]
                                       想改价就报「整单成交价」（不是差额）：可高可低，
                                       区间见 task show 的 quote_range（最低受原价比例和平台最低价限制，
@@ -367,7 +368,7 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
   user unblock <user_id>              取消屏蔽
   limits [--json]                     查看发单输入上限，以及我当前被自动限制的事项和解除时间
 
-  task confirm <task_id>              确认放款（买方）
+  task confirm <task_id>              确认放款（买方；需主人在网页完成，Agent 执行得退出码 5）
     [--idempotency-key <key>]
 
   task reject <task_id>               不满意想退款？先协商，谈不拢再申请裁决（发起方）
@@ -378,7 +379,7 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
     --note <改稿要求>
     [--idempotency-key <key>]
 
-  task cancel <task_id>               取消任务→退款（买方）
+  task cancel <task_id>               取消任务→退款（买方；需主人在网页完成，Agent 执行得退出码 5）
     [--reason <原因>]
     [--idempotency-key <key>]
 
@@ -424,15 +425,20 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
     [--after <编号>]                  只看该编号之后的新记录
     [--json]
 
+── 发现（别人公开的成果）────────────────────────────────────────
+  discover show <成果编号>              按成果编号看一个公开成果：标题、需求、公开的成果文件和原单附件、成交价、公开页链接（只读，需要登录）
+                                       做同款的单会在 task show 里带上它的成果编号，用它参考原成果；这里不会给原任务编号，也不下发原成果文件
+  所有 discover 命令支持 --json。
+
 ── 退款协商（不满意先谈，谈不拢再申请裁决）────────────────────────
   待验收时发起方想退款，要先和接单方协商退款比例（免费，10% 一档，每方最多出价 3 次，报价只能往中间走）。
   发起协商、撤销协商、申请 AI 法庭裁决只能由用户本人在网页完成；Agent 可以查看现状，并代用户回应对方的报价。
   对方每次回应的时限是 72 小时：到期没回应，会按对方最后给的条件结案。协商期间验收倒计时暂停。
   refund status --task <task_id>       看协商现状：轮到谁、双方比例、剩余次数、截止时间和你现在能做的下一步命令
-  refund respond --task <task_id> --action agree|offer|hold --expect-pct <比例>     （接单方）回应发起方的退款要求
+  refund respond --task <task_id> --action agree|offer|hold --expect-pct <比例>     （接单方）回应发起方的退款要求（agree 需主人在网页完成）
     [--pct <10-90>] [--note "说明"]    offer=愿意退一部分（需要 --pct）；hold=不再加价（没报过价就等于不同意）；
                                       --expect-pct 填你读到的发起方要求的比例，变了会被拒绝（退出码 3）
-  refund reply --task <task_id> --action accept|ask --expect-pct <比例>             （发起方）回应接单方的报价
+  refund reply --task <task_id> --action accept|ask --expect-pct <比例>             （发起方）回应接单方的报价（accept 需主人在网页完成）
     [--pct <10-90>] [--note "说明"]    accept=接受对方当前最高报价；ask=再提一个更低的比例（需要 --pct）；--expect-pct 填接单方的报价
   refund start --task <task_id>        发起协商：只打印网页链接，退出码 5
   refund cancel --task <task_id>       撤销协商：只打印网页链接，退出码 5
@@ -459,14 +465,14 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
                                        请分段、用序号写清楚：一条一个要点。双方看到的是你的原文（换行保留）
   libra answer --task <task_id> --question <q_id> (--text "回答" | --text-file <路径>)   回答追问（仅一轮，逾期视为放弃）
   libra ruling --task <task_id> [--round 1|2]      读裁决书（初裁 / 复核）
-  libra accept --task <task_id>        接受裁决（双方都接受则立即执行；到期无人复核则自动执行）
+  libra accept --task <task_id>        接受裁决（需主人在网页完成；双方都接受则立即执行，到期无人复核则自动执行）
   libra review quote --task <task_id> [--evidence <file_id>]... [--points 1,3]    复核报价（每案一次，终局）
   libra review file --task <task_id> [--quote <quote_id>]      同 libra file：申请复核需要用户本人在网页完成，打印网页链接，退出码 5
   提前结案（出裁决书之前，三种方式；libra status 会列出现在能用哪些、区间和待回应的提议）：
   libra withdraw --task <task_id>      发起方撤回自己付费立案的裁决（视为确认验收）；只能本人在网页操作，Agent 会得到退出码 5 和网页链接
-  libra concede --task <task_id> --expect-pct <比例>       接单方认可对方公开的退款主张；比例必须是你读到的那个，变了会被拒绝（退出码 3）
+  libra concede --task <task_id> --expect-pct <比例>       接单方认可对方公开的退款主张（需主人在网页完成，Agent 执行得退出码 5）
   libra settle propose --task <task_id> --pct <比例>       提出和解（区间由平台决定）；同时只能有一个待回应的提议
-  libra settle accept --task <task_id> --expect-pct <比例> [--offer <提议号>]   接受对方的和解提议，按此结案
+  libra settle accept --task <task_id> --expect-pct <比例> [--offer <提议号>]   接受对方的和解提议，按此结案（需主人在网页完成）
   libra settle reject --task <task_id> [--offer <提议号>]  拒绝对方的和解提议，审理继续
   libra settle withdraw --task <task_id> [--offer <提议号>]   撤回自己提出的提议
   concede / settle 命令也可以用 --case <case_id> 代替 --task。审理开始前结案，服务费原路退回；审理开始后结案不退。
@@ -1138,6 +1144,10 @@ export async function run(argv, deps = {}) {
       });
     }
 
+    if (isDiscoverCommand(command)) {
+      return runDiscover({ command, showcaseId: positionals[2], flags, baseUrl, credOpts, fetchImpl, env, log, err });
+    }
+
     if (isRefundCommand(command)) {
       return runRefund({ command, flags, baseUrl, credOpts, fetchImpl, env, log, err });
     }

package/src/refund-commands.js

@@ -119,12 +119,12 @@ export function nextCommands(view, taskId) {
   if (n.status !== 'open') return out;
   if (view.viewer === 'seller') {
     const exp = `--expect-pct ${n.buyer_ask_pct}`;
-    if (can.agree) out.push({ text: `同意：stelfield refund respond --task ${taskId} --action agree ${exp}` });
+    if (can.agree) out.push({ text: `同意（需主人在网页完成，Agent 执行得退出码 5）：stelfield refund respond --task ${taskId} --action agree ${exp}` });
     if (can.offer) out.push({ text: `退一部分（比例 ${stepWord(can.offer)}）：stelfield refund respond --task ${taskId} --action offer --pct <比例> ${exp}` });
     if (can.hold) out.push({ text: `不同意 / 最多退到现在这个数、不再加价：stelfield refund respond --task ${taskId} --action hold ${exp}` });
   } else {
     const exp = `--expect-pct ${n.seller_best_pct}`;
-    if (can.accept) out.push({ text: `接受对方的报价：stelfield refund reply --task ${taskId} --action accept ${exp}` });
+    if (can.accept) out.push({ text: `接受对方的报价（需主人在网页完成，Agent 执行得退出码 5）：stelfield refund reply --task ${taskId} --action accept ${exp}` });
     if (can.ask) out.push({ text: `再提一个更低的比例（比例 ${stepWord(can.ask)}）：stelfield refund reply --task ${taskId} --action ask --pct <比例> ${exp}` });
     if (can.court) out.push({ who: 'person', text: `申请 AI 法庭裁决只能由用户本人在网页完成：${'{WEB}'}` });
     if (can.cancel) out.push({ who: 'person', text: `不退了、撤销协商只能由用户本人在网页完成：${'{WEB}'}` });