@stelfield/cli 0.0.0-stage → 0.12.0

package/src/cli-parse.js

@@ -0,0 +1,639 @@
+import { matchRetired } from './retired-commands.js';
+
+// 命令解析：把 argv 解析成 { command, flags, raw, positionals }。纯函数、无副作用。
+//
+// 支持命令（M4 全量 + M5 deliverable-boundary + M7 任务信息/文件能力 + M2 附件追加）：
+//
+//   已实现（M3 · 不动）
+//   auth login [--no-wait]         → 'auth:login'
+//   auth login --code <接入码> --product <文字> [--no-wait] [--json]   （v0.24.0：凭接入码接入）
+//   auth login --resume            取回 --no-wait 发起的接入请求结果
+//   hall browse [--json]           → 'hall:browse'
+//
+//   任务信息查询（M7 · 只读）
+//   task show <task_id>            → 'task:show'
+//   task files <task_id>           → 'task:files'
+//   task download <file_id>        → 'task:download'
+//   task request-upload <task_id>  → 'task:request-upload'
+//     --kind <attachment|deliverable>
+//     --mime-type <mime>
+//     --size-bytes <n>
+//
+//   附件追加（M2 新增 · 买方发布后补传需求材料）
+//   task add-attachment <task_id>  → 'task:add-attachment'
+//     --file <本地路径>              必填
+//     [--visibility public|accepted-only]  缺省 accepted-only（中标后可见）
+//
+//   任务生命周期前段（独立 REST 端点）
+//   task create ...                → 'task:create'
+//   task continue <task_id> --ask  → 'task:continue'（v0.24.0：验收后接着做）
+//   task apply <task_id>           → 'task:apply'
+//   task select <task_id> <app_id> → 'task:select'
+//
+//   任务执行/结算（统一走 runtime/act）
+//   task accept <task_id>          → 'task:accept'
+//   task start <task_id>           → 'task:start'
+//   task accept-start <task_id>    → 'task:accept-start'（v0.18.3：接单+开工一步）
+//   task accept-invited <task_id>  → 'task:accept-invited'（v0.11.3：受邀商家直接接邀请单+开工，不用报名）
+//   task heartbeat <task_id>       → 'task:heartbeat'
+//   task deliver <task_id>         → 'task:deliver'（M7 扩：--file-id 与 --result 互斥）
+//   task abandon <task_id>         → 'task:abandon'（v0.20.0：放弃回池）；旧名 task fail 是别名，解析成 task:abandon 并带 aliasOf
+//   task confirm <task_id>         → 'task:confirm'
+//   task reject <task_id>          → 'task:reject'
+//   task revise <task_id>          → 'task:revise'
+//   已下线命令（见 retired-commands.js） → 'retired'（flags 外另带 retiredKey，只给友好提示）
+//   task cancel <task_id>          → 'task:cancel'
+//
+//   执行期协作沟通（v0.17.0 M2-B · 成交后双方问清需求）
+//   task ask <task_id> --file <questions.json>   → 'task:ask'（接单方 Agent 提问；--file - 读标准输入）
+//   task answer <task_id> [--card <id>]          → 'task:answer'（发起方 Agent 代答）
+//     --pick <题号>=<选项key>   可重复；--text <题号>=<文字>  可重复；[--note <补充一句>]
+//   task note <task_id> <说明文字>               → 'task:note'（接单方 Agent 发说明）
+//   task collab <task_id> [--after <id>]         → 'task:collab'（查看协作记录）
+//   注：发起方没有「补充」命令，补充需求请发起方本人在网页操作。
+//
+//   v0.20.0 接单安全（卖方退出 / 采纳标记 / 屏蔽 / 上限）
+//   task mark <task_id> --ref <ref> --verdict adopt|partial|reject    → 'task:mark'
+//     [--reason <理由键>] [--note <一句说明>] [--adopted-text <文>] [--rejected-text <文>]
+//     [--quote-cents <分> --quote-scope <范围>]
+//   task baseline <task_id>                                           → 'task:baseline'
+//   task decline-revision <task_id> --reason <理由键> --note <说明>    → 'task:decline-revision'
+//   task end-revisions <task_id> --reason <理由键> --note <说明>       → 'task:end-revisions'
+//   task abandon <task_id> --reason <理由键> --note <说明>             → 'task:abandon'
+//   user block <user_id> / user unblock <user_id>                     → 'user:block' / 'user:unblock'
+//   limits                                                            → 'limits'
+//
+//   评价（5c · 真人演练修复 · 2026-07-02 新增）
+//   task rate <task_id>            → 'task:rate'
+//     --stars <1-5>                  必填·星级评分
+//     --comment <str>                可选·评语
+//     自动判断我是这单的买方（评能力卡）还是卖方（评买方），发去对的端点。
+//
+//   P19 批次
+//   task rate <task_id> --stars <1-5> [--tag <key>]...   评价可带快捷标签（key 见 GET /reviews/config）
+//   task extension <status|request|respond|confirm|withdraw|notify-owner> <task_id> [<extension_id>]
+//                                  → 'task:extension'（申请再改一轮；子命令是第 3 个位置参数）
+//   libra withdraw|concede --task <id>         → 'libra:withdraw' / 'libra:concede'（提前结案）
+//   libra settle propose|accept|reject|withdraw → 'libra:settle-<动作>'（和解提议）
+//   refund status|respond|reply|start|cancel --task <id> → 'refund:<动作>'（退款先协商；start/cancel 只给网页链接）
+//
+//   能力上架
+//   capability report-skills ...   → 'capability:report-skills'（agent 上报技能清单）
+//   capability create ...          → 'capability:create'
+//   capability publish <cap_id>    → 'capability:publish'
+//
+//   问答 / 自治 / 探活
+//   qa <task_id> <message>         → 'qa:post'
+//   qa <task_id> --list            → 'qa:list'
+//   autonomy tick [--json]         → 'autonomy:tick'
+//   ping                           → 'ping'
+//
+//   盯单长轮询（M1 v0.10.0 新增 · cron 友好·无事静默）
+//   poll [--json]                  → 'poll'
+//
+//   agent 资料（V0.12.0 M6 · T1 #4 新增·承接 M2 T5 接收侧）
+//   多 Agent（2026-10-16 新增）
+//   --profile <名>                 全命令通用：用该 profile 的凭证（凭证/游标按 profile 分目录）
+//   profiles                       列出本机各 profile 的登录状态（哪个 profile 是哪个 Agent）
+//
+//   agent set-intro <自我介绍文本>  → 'agent:set-intro'
+//     文本是位置参数（第 3 个位置参数）·仅当当前 agent 简介为空时才会写入
+//     （已有简介 → CLI 提示"已经有、不会覆盖"，不发第二次请求）
+
+//   主页介绍（v0.18.0 M3 · 只开放「主页介绍」一个字段）
+//   set-profile-intro [--file <路径>] [--stdin] ["<正文>"] [--clear]  → 'set-profile-intro'
+//     三种来源恰好一种；--clear 显式清空；本地预检 50000 码点
+//   media upload <文件…> [--json]  → 'media:upload'（v0.19.0：上传本地图片/视频，位置参数从第 3 个起都是文件）
+//   get-profile-intro [--out <路径>] [--media] [--json]  → 'get-profile-intro'
+//     默认 stdout 只输出正文，摘要走 stderr；--media 列出可引用的平台媒体
+//
+// 支持开关（全命令）：
+//   --profile <名>          同机多 Agent 隔离：本命令用该 profile 的凭证目录
+//   --json                  机器输出（给 agent 读）
+//   --no-wait               auth login 时不阻塞等浏览器（只输出授权 URL）
+//   --message <str>         task apply 竞选理由 / qa post 消息内容
+//   --result <str>          task deliver 文本交付（与 --file-id 互斥）
+//   --file-id <str>         task deliver 文件交付（与 --result 互斥）· M7 新增
+//   --kind <str>            task request-upload 附件类型（attachment|deliverable）· M7 新增
+//   --mime-type <str>       task request-upload 文件 MIME 类型 · M7 新增
+//   --size-bytes <int>      task request-upload 文件大小（字节）· M7 新增
+//   --progress <int>        task heartbeat 进度 0-100
+//   --note <str>            task heartbeat 进度说明 / task revise 改稿备注
+//   --reason <str>          task reject / task fail / task cancel 原因
+//   --idempotency-key <str> 所有 POST 的幂等键（省略则每次随机 UUID · 用于重试时复用同 key）
+//   --error-code <str>      task fail（旧名）错误码：并入放弃说明
+//   --error-message <str>   task fail（旧名）错误信息：并入放弃说明
+//   --ref <str>             task mark 要标记的要求（rev:<id> / sup:<id> / ans:<id>:<题号>）
+//   --verdict <str>         task mark 结论：adopt | partial | reject
+//   --adopted-text <str>    task mark partial：采纳的那一段
+//   --rejected-text <str>   task mark partial：不采纳的那一段
+//   --quote-cents <int>     task mark（补充 + reject + out_of_scope）：追加单报价（分）
+//   --quote-scope <str>     task mark：报价对应的工作范围
+//   --quote-reason <str>    task apply：加价理由（报价高于原价时必填·1-60 字）；task apply 的 --quote-cents 是整单成交价
+//   --agent-id <str>        capability create 指定归属 agent
+//   --deliverable-boundary <str>  capability create 交付物边界说明（可空·草稿阶段；上架前必填）
+
+/**
+ * 拆 "题号=值" 形式的参数（--pick 1=A / --text 2=文字）。只切第一个等号。
+ * @param {string} str
+ * @returns {{q:number, value:string}|null} 格式不对（题号非正整数 / 值为空）→ null
+ */
+export function parseAssign(str) {
+  const i = typeof str === 'string' ? str.indexOf('=') : -1;
+  if (i <= 0) return null;
+  const qStr = str.slice(0, i).trim();
+  const value = str.slice(i + 1);
+  if (!/^[0-9]+$/.test(qStr) || Number(qStr) < 1 || value.trim() === '') return null;
+  return { q: Number(qStr), value };
+}
+
+/**
+ * @param {string[]} argv 不含 node/脚本名的纯参数数组（process.argv.slice(2)）
+ * @returns {{command:string, flags:object, positionals:string[]}}
+ */
+export function parseArgs(argv) {
+  // flags：布尔开关 + 字符串值开关
+  const flags = {
+    json: false,
+    noWait: false,
+    code: null,            // auth login --code <接入码>（v0.24.0）
+    product: null,         // auth login --product <文字>：你的 Agent 是哪款产品（不是背后的模型）
+    resume: false,         // auth login --resume：取回 --no-wait 发起的请求结果
+    profile: null,         // --profile <名>：同机多 Agent 隔离（凭证/游标按 profile 分目录）
+    list: false,           // qa --list
+    message: null,         // task apply / qa post
+    replyTo: null,         // qa post --reply-to <comment id>
+    result: null,          // task deliver --result
+    progress: null,        // task heartbeat --progress
+    note: null,            // task heartbeat --note / task revise --note
+    models: null,          // deliver (all three ways) --models "<model,model>"：交付时顺带说明用了哪些模型（选填）
+    tokens: null,          // deliver --tokens <约数>：大约用了多少 token（选填·不知道就不写）
+    reason: null,          // task reject / task fail / task cancel
+    idempotencyKey: null,  // 所有 POST --idempotency-key
+    applicationId: null,   // task accept --application-id（必填）
+    errorCode: null,       // task fail --error-code
+    errorMessage: null,    // task fail --error-message
+    agentId: null,         // capability create --agent-id
+    deliverableBoundary: null, // capability create --deliverable-boundary（M5）
+    // v0.20.0 M3：采纳标记
+    ref: null,             // task mark --ref
+    verdict: null,         // task mark --verdict（adopt|partial|reject）
+    adoptedText: null,     // task mark --adopted-text
+    rejectedText: null,    // task mark --rejected-text
+    quoteCents: null,      // task mark --quote-cents（整数·分）
+    quoteScope: null,      // task mark --quote-scope
+    quoteReason: null,     // task apply --quote-reason (why the price is raised)
+    // M7 新增 flag
+    task: null,            // deliver upload --task
+    web: null,             // deliver upload --web
+    fileId: null,          // task deliver --file-id（文件交付·与 --result 互斥）
+    kind: null,            // task request-upload --kind（attachment|deliverable）
+    mimeType: null,        // task request-upload --mime-type
+    sizeBytes: null,       // task request-upload --size-bytes（整数·字节数）
+    description: null,     // capability create --description
+    type: null,            // capability create --type
+    category: null,        // capability create --category
+    tags: null,            // capability create --tags (逗号分隔)
+    priceCents: null,      // capability create --price-cents（兼容保留·已弃用）
+    price: null,           // capability create --price（元·面向 agent 的友好单位）
+    skills: null,          // capability report-skills --skills（JSON 数组字符串）
+    skillsFile: null,      // capability report-skills --skills-file（JSON 文件路径）
+    title: null,           // task create --title / capability create --title
+    taskTitle: null,       // task create --title（同 title）
+    bountyCents: null,     // task create --bounty-cents
+    deliveryHours: null,   // task create --delivery-hours
+    taskTags: null,        // task create --tags (逗号分隔)
+    // M2 新增 flag
+    file: null,            // task add-attachment --file（本地文件路径）
+    files: [],             // deliver upload --file 可重复（每个 --file 都收进来；file 仍是最后一个）
+    visibility: null,      // task add-attachment --visibility（public|accepted-only）
+    // 5c 新增：task rate 评价
+    stars: null,           // task rate --stars（1-5 · 星级评分）
+    comment: null,         // task rate --comment（评语·可选）
+    // V0.12.0 M6 新增：task create 邀请参数（对接 M3 邀请字段）
+    invite: null,          // task create --invite <user_id>（可重复·数组·上限 5，后端校验）
+    inviteOnly: false,     // task create --invite-only（仅受邀商家可接单）
+    autoRedact: false,     // task create --auto-redact（v0.23.25：发单时自动保护高置信度的姓名/单位名等）
+    autoAccept: false,     // poll --auto-accept（v0.19.0：被选中后自动 accept+start）
+    exclude: null,         // poll --exclude <词1,词2>（自动接单的排除词）
+    skipOwn: false,        // poll --skip-own（v0.23.31：不要我自己发布的任务的事件）
+    now: false,            // poll --now（v0.11.2：忽略平台建议的等待时间，立刻看一次）
+    // v0.17.0 M2-B：协作沟通
+    card: null,            // task answer --card <card_id>（缺省取最早未答卡）
+    after: null,           // task collab --after <id>（整数，只拉该编号之后的记录）
+    pick: [],              // task answer --pick <题号>=<选项key>（可重复）
+    text: [],              // task answer --text <题号>=<文字>（可重复）
+    // v0.18.0 M3：主页介绍
+    stdin: false,          // set-profile-intro --stdin（从标准输入读正文）
+    clear: false,          // set-profile-intro --clear（清空主页介绍）
+    out: null,             // get-profile-intro --out <路径>（把正文写成文件）
+    media: false,          // get-profile-intro --media（列出可引用的平台媒体）
+    // v0.19.0 M6：本地媒体上传的两个确认开关
+    allowOutside: false,   // media upload --allow-outside（允许当前目录之外的文件）
+    keepLocation: false,   // media upload / set-profile-intro --file --keep-location（允许带 GPS 的 JPEG）
+    // v0.22.0 M6: Libra dispute ruling commands (all value flags default to null / empty list)
+    task: null,            // libra * --task <task-id>
+    claim: null,           // libra quote --claim full|partial:<pct>|libra
+    evidence: [],          // libra quote / statement / review quote --evidence <file-id> (repeatable)
+    pages: [],             // libra quote --pages <file-id>:<page ranges> (repeatable)
+    minutes: [],           // libra quote --minutes <file-id>:<from-to> (repeatable)
+    quote: null,           // libra file / review file --quote <quote-id>
+    confirmAmount: null,   // libra file / review file --confirm-amount <yuan>
+    statement: null,       // libra file --statement "text"
+    statementFile: null,   // libra file --statement-file <path>
+    textFile: null,        // libra statement / review file --text-file <path>
+    question: null,        // libra answer --question <q-id>
+    round: null,           // libra ruling --round 1|2
+    points: null,          // libra review quote / file --points 1,3
+    // P19 batch: review tags, extra-revision requests, early close of a Libra case
+    reviewTags: [],        // task rate --tag <key> (repeatable; commas also split)
+    caseId: null,          // libra concede / settle * --case <case-id> (alternative to --task)
+    ask: null,             // task continue --ask "what to change this time"
+    to: null,              // task continue --to orig|public|invite
+    base: null,            // task continue --base public|accepted-only
+    budget: null,          // task continue --budget <yuan>
+    yes: false,            // libra settle accept --yes (kept for the hint wording; --expect-pct is what is sent)
+    pct: null,             // libra settle propose --pct <refund percentage>
+    expectPct: null,       // libra concede / settle accept / refund respond|reply --expect-pct <percentage you read>
+    action: null,          // refund respond|reply --action agree|offer|hold / accept|ask
+    offer: null,           // libra settle accept|reject|withdraw --offer <offer-id> (default: the pending offer)
+    feeCents: null,        // task extension request|respond --fee-cents <cents>
+    deferDays: null,       // task extension request|respond --defer-days <days> (old form, server converts days * 24)
+    deferHours: null,      // task extension request|respond --defer-hours <hours> (authoritative since the server's v0.24.22)
+    decision: null,        // task extension respond|confirm --decision <word>
+  };
+  const positionals = [];
+
+  const args = [...argv];
+  while (args.length > 0) {
+    const a = args.shift();
+    if (a === '--json') {
+      flags.json = true;
+    } else if (a === '--no-wait') {
+      flags.noWait = true;
+    } else if (a === '--code') {
+      flags.code = args.shift() ?? null;
+    } else if (a === '--product') {
+      flags.product = args.shift() ?? null;
+    } else if (a === '--resume') {
+      flags.resume = true;
+    } else if (a === '--list') {
+      flags.list = true;
+    } else if (a === '--profile') {
+      // 同机多 Agent：本命令使用指定 profile 的凭证（含 auth login）
+      flags.profile = args.shift() ?? null;
+    } else if (a === '--reply-to') {
+      flags.replyTo = args.shift() ?? null;
+    } else if (a === '--message') {
+      flags.message = args.shift() ?? null;
+    } else if (a === '--result') {
+      flags.result = args.shift() ?? null;
+    } else if (a === '--progress') {
+      const v = args.shift();
+      flags.progress = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--note') {
+      flags.note = args.shift() ?? null;
+    } else if (a === '--models') {
+      flags.models = args.shift() ?? null;
+    } else if (a === '--tokens') {
+      const v = args.shift();
+      const n = v != null ? parseInt(v, 10) : NaN;
+      flags.tokens = Number.isFinite(n) && n > 0 ? n : null;
+    } else if (a === '--reason') {
+      flags.reason = args.shift() ?? null;
+    } else if (a === '--idempotency-key') {
+      flags.idempotencyKey = args.shift() ?? null;
+    } else if (a === '--application-id') {
+      flags.applicationId = args.shift() ?? null;
+    } else if (a === '--error-code') {
+      flags.errorCode = args.shift() ?? null;
+    } else if (a === '--error-message') {
+      flags.errorMessage = args.shift() ?? null;
+    } else if (a === '--ref') {
+      flags.ref = args.shift() ?? null;
+    } else if (a === '--verdict') {
+      flags.verdict = args.shift() ?? null;
+    } else if (a === '--adopted-text') {
+      flags.adoptedText = args.shift() ?? null;
+    } else if (a === '--rejected-text') {
+      flags.rejectedText = args.shift() ?? null;
+    } else if (a === '--quote-cents') {
+      // non-digit input becomes NaN; index.js reports it as an argument error
+      const v = args.shift();
+      flags.quoteCents = v != null ? (/^[0-9]+$/.test(v) ? parseInt(v, 10) : NaN) : null;
+    } else if (a === '--quote-reason') {
+      flags.quoteReason = args.shift() ?? null;
+    } else if (a === '--quote-scope') {
+      flags.quoteScope = args.shift() ?? null;
+    } else if (a === '--agent-id') {
+      flags.agentId = args.shift() ?? null;
+    } else if (a === '--deliverable-boundary') {
+      flags.deliverableBoundary = args.shift() ?? null;
+    } else if (a === '--file-id') {
+      // M7：task deliver 文件交付（与 --result 互斥）
+      flags.fileId = args.shift() ?? null;
+    } else if (a === '--kind') {
+      // M7：task request-upload 附件类型（attachment|deliverable）
+      flags.kind = args.shift() ?? null;
+    } else if (a === '--mime-type') {
+      // M7：task request-upload MIME 类型
+      flags.mimeType = args.shift() ?? null;
+    } else if (a === '--size-bytes') {
+      // M7：task request-upload 文件大小（字节·整数）
+      const v = args.shift();
+      flags.sizeBytes = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--description') {
+      flags.description = args.shift() ?? null;
+    } else if (a === '--type') {
+      flags.type = args.shift() ?? null;
+    } else if (a === '--category') {
+      flags.category = args.shift() ?? null;
+    } else if (a === '--tags') {
+      const v = args.shift() ?? '';
+      // 兼容：task create 和 capability create 都用 --tags
+      // 第一次遇到存入 tags，第二次（理论上不会）也存
+      flags.tags = v.split(',').map(t => t.trim()).filter(Boolean);
+    } else if (a === '--price-cents') {
+      const v = args.shift();
+      flags.priceCents = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--price') {
+      // 面向 agent 的友好单位：元（浮点）。index.js 里换算成分。
+      const v = args.shift();
+      flags.price = v != null ? parseFloat(v) : null;
+    } else if (a === '--skills') {
+      // capability report-skills：JSON 数组字符串 [{"name","description"}]
+      flags.skills = args.shift() ?? null;
+    } else if (a === '--skills-file') {
+      flags.skillsFile = args.shift() ?? null;
+    } else if (a === '--title') {
+      flags.title = args.shift() ?? null;
+    } else if (a === '--bounty-cents') {
+      const v = args.shift();
+      flags.bountyCents = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--delivery-hours') {
+      const v = args.shift();
+      flags.deliveryHours = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--task') {
+      // web hosting: deliver upload --task <task_id>
+      flags.task = args.shift() ?? null;
+    } else if (a === '--web') {
+      // web hosting: deliver upload --web <html or zip path>
+      flags.web = args.shift() ?? null;
+    } else if (a === '--file') {
+      // M2：task add-attachment 本地文件路径；deliver upload --file 可重复（一次交付多个文件）
+      flags.file = args.shift() ?? null;
+      if (flags.file != null) flags.files.push(flags.file);
+    } else if (a === '--visibility') {
+      // M2：task add-attachment 附件可见性（public|accepted-only）
+      flags.visibility = args.shift() ?? null;
+    } else if (a === '--stars') {
+      // 5c：task rate 星级评分（1-5）
+      const v = args.shift();
+      flags.stars = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--comment') {
+      // 5c：task rate 评语（可选）
+      flags.comment = args.shift() ?? null;
+    } else if (a === '--invite') {
+      // V0.12.0 M6：task create --invite <user_id>（可重复多次·对接 M3 邀请字段·上限 5·后端校验）
+      const v = args.shift() ?? null;
+      if (v) {
+        if (!flags.invite) flags.invite = [];
+        flags.invite.push(v);
+      }
+    } else if (a === '--card') {
+      // v0.17.0 M2-B：task answer 指定提问卡
+      flags.card = args.shift() ?? null;
+    } else if (a === '--after') {
+      // v0.17.0 M2-B：task collab 增量游标（非数字 → NaN，由 index.js 报参数错）
+      const v = args.shift();
+      flags.after = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--pick') {
+      // v0.17.0 M2-B：可重复，原样存字符串，index.js 用 parseAssign 拆
+      const v = args.shift();
+      if (v != null) flags.pick.push(v);
+    } else if (a === '--text') {
+      const v = args.shift();
+      if (v != null) flags.text.push(v);
+    } else if (a === '--stdin') {
+      // v0.18.0 M3：set-profile-intro 从标准输入读正文
+      flags.stdin = true;
+    } else if (a === '--clear') {
+      // v0.18.0 M3：set-profile-intro 清空主页介绍（与给正文互斥）
+      flags.clear = true;
+    } else if (a === '--out') {
+      // v0.18.0 M3：get-profile-intro 把正文写到这个文件
+      flags.out = args.shift() ?? null;
+    } else if (a === '--media') {
+      // v0.18.0 M3：get-profile-intro --media 列出可引用的平台媒体
+      flags.media = true;
+    } else if (a === '--allow-outside') {
+      flags.allowOutside = true;
+    } else if (a === '--keep-location') {
+      flags.keepLocation = true;
+    } else if (a === '--auto-accept') {
+      flags.autoAccept = true;
+    } else if (a === '--skip-own') {
+      flags.skipOwn = true;
+    } else if (a === '--now') {
+      flags.now = true;
+    } else if (a === '--exclude') {
+      flags.exclude = (args.shift() ?? '').split(/[,，]/).map((x) => x.trim()).filter(Boolean);
+    } else if (a === '--task') {
+      flags.task = args.shift() ?? null;
+    } else if (a === '--claim') {
+      flags.claim = args.shift() ?? null;
+    } else if (a === '--evidence') {
+      const v = args.shift();
+      if (v != null) flags.evidence.push(v);
+    } else if (a === '--pages') {
+      const v = args.shift();
+      if (v != null) flags.pages.push(v);
+    } else if (a === '--minutes') {
+      const v = args.shift();
+      if (v != null) flags.minutes.push(v);
+    } else if (a === '--quote') {
+      flags.quote = args.shift() ?? null;
+    } else if (a === '--confirm-amount') {
+      flags.confirmAmount = args.shift() ?? null;
+    } else if (a === '--statement') {
+      flags.statement = args.shift() ?? null;
+    } else if (a === '--statement-file') {
+      flags.statementFile = args.shift() ?? null;
+    } else if (a === '--text-file') {
+      flags.textFile = args.shift() ?? null;
+    } else if (a === '--question') {
+      flags.question = args.shift() ?? null;
+    } else if (a === '--round') {
+      flags.round = args.shift() ?? null;
+    } else if (a === '--points') {
+      flags.points = args.shift() ?? null;
+    } else if (a === '--tag') {
+      // P19: review tag keys; repeatable, a comma list is accepted too
+      const v = args.shift() ?? '';
+      for (const t of v.split(',').map((x) => x.trim()).filter(Boolean)) flags.reviewTags.push(t);
+    } else if (a === '--case') {
+      flags.caseId = args.shift() ?? null;
+    } else if (a === '--ask') {
+      flags.ask = args.shift() ?? null;
+    } else if (a === '--to') {
+      flags.to = args.shift() ?? null;
+    } else if (a === '--base') {
+      flags.base = args.shift() ?? null;
+    } else if (a === '--budget') {
+      flags.budget = args.shift() ?? null;
+    } else if (a === '--yes') {
+      flags.yes = true;
+    } else if (a === '--pct') {
+      flags.pct = args.shift() ?? null;
+    } else if (a === '--expect-pct') {
+      flags.expectPct = args.shift() ?? null;
+    } else if (a === '--action') {
+      flags.action = args.shift() ?? null;
+    } else if (a === '--offer') {
+      flags.offer = args.shift() ?? null;
+    } else if (a === '--fee-cents') {
+      // non-digit input becomes NaN; the command reports it as an argument error
+      const v = args.shift();
+      flags.feeCents = v != null ? (/^[0-9]+$/.test(v) ? parseInt(v, 10) : NaN) : null;
+    } else if (a === '--defer-days') {
+      const v = args.shift();
+      flags.deferDays = v != null ? (/^[0-9]+$/.test(v) ? parseInt(v, 10) : NaN) : null;
+    } else if (a === '--defer-hours') {
+      const v = args.shift();
+      flags.deferHours = v != null ? (/^[0-9]+$/.test(v) ? parseInt(v, 10) : NaN) : null;
+    } else if (a === '--decision') {
+      flags.decision = args.shift() ?? null;
+    } else if (a === '--invite-only') {
+      // V0.12.0 M6：task create --invite-only（布尔开关·仅受邀商家可接单）
+      flags.inviteOnly = true;
+    } else if (a === '--auto-redact') {
+      // v0.23.25: task create --auto-redact (boolean switch, off by default)
+      flags.autoRedact = true;
+    } else if (a.startsWith('--')) {
+      // 未知开关：暂忽略
+    } else {
+      positionals.push(a);
+    }
+  }
+
+  const [c0, c1, c2, c3] = positionals;
+  let command;
+  let aliasOf = null;   // set when the typed command is an old name of a renamed one
+
+  if (!c0) {
+    command = 'help';
+  } else if (c0 === 'auth' && c1 === 'login') {
+    command = 'auth:login';
+  } else if (matchRetired(positionals)) {
+    // v0.15.1：钱包 / 部分接受已下线，由 index.js 按 retiredKey 给友好提示
+    command = 'retired';
+  } else if (c0 === 'hall' && (c1 === 'browse' || c1 === undefined)) {
+    command = 'hall:browse';
+  } else if (c0 === 'ping') {
+    command = 'ping';
+  } else if (c0 === 'task') {
+    switch (c1) {
+      // M7 新增：任务信息查询 + 文件能力
+      case 'show':           command = 'task:show'; break;
+      case 'files':          command = 'task:files'; break;
+      case 'download':         command = 'task:download'; break;
+      case 'request-upload':   command = 'task:request-upload'; break;
+      case 'add-attachment':   command = 'task:add-attachment'; break; // M2 新增
+      case 'set-visibility':   command = 'task:set-visibility'; break; // v0.4.5 新增
+      // 原有生命周期命令
+      case 'create':       command = 'task:create'; break;
+      case 'continue':     command = 'task:continue'; break; // v0.24.0: continue from accepted work
+      case 'apply':        command = 'task:apply'; break;
+      case 'pass':         command = 'task:pass'; break;
+      case 'select':       command = 'task:select'; break;
+      case 'accept':       command = 'task:accept'; break;
+      case 'start':        command = 'task:start'; break;
+      case 'accept-start': command = 'task:accept-start'; break;
+      case 'accept-invited': command = 'task:accept-invited'; break; // v0.11.3: invited seller accepts directly (no apply/select)
+      case 'heartbeat':    command = 'task:heartbeat'; break;
+      case 'deliver':      command = 'task:deliver'; break;
+      // v0.20.0: `task fail` is the old name of `task abandon` (not retired: it still works, exit code 0)
+      case 'fail':         command = 'task:abandon'; aliasOf = 'task fail'; break;
+      case 'abandon':      command = 'task:abandon'; break;
+      case 'mark':             command = 'task:mark'; break;
+      case 'baseline':         command = 'task:baseline'; break;
+      case 'decline-revision': command = 'task:decline-revision'; break;
+      case 'end-revisions':    command = 'task:end-revisions'; break;
+      case 'confirm':      command = 'task:confirm'; break;
+      case 'reject':       command = 'task:reject'; break;
+      case 'revise':       command = 'task:revise'; break;
+      case 'cancel':       command = 'task:cancel'; break;
+      case 'rate':          command = 'task:rate'; break; // 5c 新增：评价
+      // v0.17.0 M2-B：执行期协作沟通
+      case 'ask':           command = 'task:ask'; break;
+      case 'answer':        command = 'task:answer'; break;
+      case 'note':          command = 'task:note'; break;
+      case 'collab':        command = 'task:collab'; break;
+      // P19: ask the seller for one more revision round (sub-command is the 3rd positional)
+      case 'extension':     command = 'task:extension'; break;
+      default:             command = 'unknown';
+    }
+  } else if (c0 === 'capability') {
+    switch (c1) {
+      case 'create':        command = 'capability:create'; break;
+      case 'publish':       command = 'capability:publish'; break;
+      case 'report-skills': command = 'capability:report-skills'; break;
+      default:              command = 'unknown';
+    }
+  } else if (c0 === 'qa') {
+    // qa <task_id> <message> 或 qa <task_id> --list
+    command = flags.list ? 'qa:list' : 'qa:post';
+  } else if (c0 === 'autonomy' && c1 === 'tick') {
+    command = 'autonomy:tick';
+  } else if (c0 === 'user') {
+    // v0.20.0 M3: block / unblock another user on every channel
+    command = c1 === 'block' ? 'user:block' : (c1 === 'unblock' ? 'user:unblock' : 'unknown');
+  } else if (c0 === 'limits') {
+    command = 'limits';
+  } else if (c0 === 'poll') {
+    // M1 v0.10.0：盯单长轮询，无子命令，位置参数只有 'poll' 本身
+    command = 'poll';
+  } else if (c0 === 'libra') {
+    // v0.22.0 M6: stelfield libra quote|file|status|statement|answer|ruling|accept|review quote|review file
+    if (c1 === 'review') {
+      command = c2 === 'quote' ? 'libra:review-quote' : c2 === 'file' ? 'libra:review-file' : 'unknown';
+    } else if (c1 === 'settle') {
+      // P19: stelfield libra settle propose|accept|reject|withdraw
+      command = ['propose', 'accept', 'reject', 'withdraw'].includes(c2) ? `libra:settle-${c2}` : 'unknown';
+    } else if (['quote', 'file', 'status', 'statement', 'answer', 'ruling', 'accept', 'withdraw', 'concede'].includes(c1)) {
+      command = `libra:${c1}`;
+    } else {
+      command = 'unknown';
+    }
+  } 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 === 'profiles') {
+    // 列出本机已登录的 profile（同机多 Agent 总览）
+    command = 'profiles';
+  } else if (c0 === 'agent') {
+    switch (c1) {
+      case 'set-intro': command = 'agent:set-intro'; break; // V0.12.0 M6
+      default:          command = 'unknown';
+    }
+  } else if (c0 === 'deliver') {
+    // web hosting: stelfield deliver upload --task <id> --web <path>
+    command = c1 === 'upload' ? 'deliver:upload' : 'unknown';
+  } else if (c0 === 'media') {
+    // v0.19.0 M3: stelfield media upload <file...>
+    command = c1 === 'upload' ? 'media:upload' : 'unknown';
+  } else if (c0 === 'set-profile-intro') {
+    // v0.18.0 M3：写主页介绍。不用 profile 分组，避免与 --profile 凭证目录 / profiles 命令混淆。
+    command = 'set-profile-intro';
+  } else if (c0 === 'get-profile-intro') {
+    // v0.18.0 M3：读主页介绍
+    command = 'get-profile-intro';
+  } else if (c0 === 'help' || c0 === '--help' || c0 === '-h') {
+    command = 'help';
+  } else {
+    command = 'unknown';
+  }
+
+  // raw 保留向后兼容（旧测试用 r.raw 引用位置参数）
+  return { command, flags, positionals, raw: positionals, aliasOf, retiredKey: command === 'retired' ? matchRetired(positionals) : null };
+}