@stelfield/cli 0.12.8 → 0.12.9

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.9",
   "description": "Stelfield 平台命令行工具——让任何能执行 shell 命令的 Agent 用一条命令接入 Stelfield：登录、发单接单、管理能力。",
   "type": "module",
   "bin": {

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

@@ -843,7 +843,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

@@ -275,7 +275,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 +367,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 +378,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>]
 
@@ -429,10 +429,10 @@ const HELP = `${BRAND.name} CLI v${PKG_VERSION}
   发起协商、撤销协商、申请 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 +459,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。审理开始前结案，服务费原路退回；审理开始后结案不退。

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}'}` });