@lingerai/cli 0.1.2 → 0.3.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingerai/cli",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "Linger 平台命令行工具——让通用 Agent（Hermes / OpenClaw / Claude Code / Cursor）用一条命令接入 Linger：登录、查钱包、发单接单、管理能力。",
   "type": "module",
   "bin": {

package/src/api.js

@@ -160,6 +160,23 @@ export async function runtimeAct(baseUrl, token, action, payload, idempotencyKey
 // 能力上架（独立端点 · 卖方）
 // ============================================================
 
+/**
+ * 上报技能清单（卖方·A 流程第一步）。
+ * 把 agent 自己会的技能写进平台 agents.skill_catalog，供网页「AI 识别」挑能力卡。
+ * 用 agent token 调用时后端从 token 推导 agent_id（agent 不必知道自己 UUID）。
+ * @param {Array<{name:string,description:string}>} skills 技能清单
+ */
+export async function reportSkills(baseUrl, token, skills, idempotencyKey, opts = {}) {
+  return authedPost(
+    baseUrl,
+    '/api/v1/capabilities/skill_catalog',
+    token,
+    { skills },
+    idempotencyKey,
+    opts
+  );
+}
+
 /**
  * 创建能力卡草稿（卖方）。
  * @param {object} capData  CreateCapabilityRequest 字段（agent_id + title 必填，其余草稿可空）

package/src/cli-parse.js

@@ -1,6 +1,6 @@
 // 命令解析：把 argv 解析成 { command, flags, raw, positionals }。纯函数、无副作用。
 //
-// 支持命令（M4 全量 + M5 deliverable-boundary + M7 任务信息/文件能力）：
+// 支持命令（M4 全量 + M5 deliverable-boundary + M7 任务信息/文件能力 + M2 附件追加）：
 //
 //   已实现（M3 · 不动）
 //   auth login [--no-wait]         → 'auth:login'
@@ -16,6 +16,11 @@
 //     --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 apply <task_id>           → 'task:apply'
@@ -34,6 +39,7 @@
 //   task cancel <task_id>          → 'task:cancel'
 //
 //   能力上架
+//   capability report-skills ...   → 'capability:report-skills'（agent 上报技能清单）
 //   capability create ...          → 'capability:create'
 //   capability publish <cap_id>    → 'capability:publish'
 //
@@ -93,12 +99,18 @@ export function parseArgs(argv) {
     type: null,            // capability create --type
     category: null,        // capability create --category
     tags: null,            // capability create --tags (逗号分隔)
-    priceCents: null,      // capability create --price-cents
+    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（本地文件路径）
+    visibility: null,      // task add-attachment --visibility（public|accepted-only）
   };
   const positionals = [];
 
@@ -164,6 +176,15 @@ export function parseArgs(argv) {
     } 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') {
@@ -172,6 +193,12 @@ export function parseArgs(argv) {
     } else if (a === '--delivery-hours') {
       const v = args.shift();
       flags.deliveryHours = v != null ? parseInt(v, 10) : null;
+    } else if (a === '--file') {
+      // M2：task add-attachment 本地文件路径
+      flags.file = args.shift() ?? null;
+    } else if (a === '--visibility') {
+      // M2：task add-attachment 附件可见性（public|accepted-only）
+      flags.visibility = args.shift() ?? null;
     } else if (a.startsWith('--')) {
       // 未知开关：暂忽略
     } else {
@@ -197,8 +224,9 @@ export function parseArgs(argv) {
       // 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 'download':         command = 'task:download'; break;
+      case 'request-upload':   command = 'task:request-upload'; break;
+      case 'add-attachment':   command = 'task:add-attachment'; break; // M2 新增
       // 原有生命周期命令
       case 'create':       command = 'task:create'; break;
       case 'apply':        command = 'task:apply'; break;
@@ -217,9 +245,10 @@ export function parseArgs(argv) {
     }
   } else if (c0 === 'capability') {
     switch (c1) {
-      case 'create':       command = 'capability:create'; break;
-      case 'publish':      command = 'capability:publish'; break;
-      default:             command = 'unknown';
+      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

package/src/format.js

@@ -69,15 +69,27 @@ export function formatHall(data, { json = false } = {}) {
 /**
  * 格式化任务创建结果。
  * @param {object} data { id, title, status, bounty_amount_cents, ... }
+ * @param {object} opts { json, webBase }
+ *   webBase：任务详情页的网页根域名，缺省读 LINGER_WEB_BASE 环境变量，
+ *             再缺省用 https://a2a.linger.chimap.cn
  */
-export function formatTaskCreate(data, { json = false } = {}) {
-  if (json) return asJson(data);
+export function formatTaskCreate(data, { json = false, webBase } = {}) {
+  const taskId = data.task_id || data.id;
+  // 拼任务详情页链接（让 agent 能把链接转给用户）
+  const base = webBase || process.env.LINGER_WEB_BASE || 'https://a2a.linger.chimap.cn';
+  const taskUrl = `${base}/src/pages/task-detail/index.html?id=${taskId}`;
+
+  if (json) {
+    // json 模式也注入 task_detail_url，方便 agent 程序化读取
+    return asJson({ ...data, task_detail_url: taskUrl });
+  }
   const lines = [`任务已发布！`];
   // 后端返回 task_id（不是 id）
-  lines.push(`  任务 ID：${data.task_id || data.id}`);
+  lines.push(`  任务 ID：${taskId}`);
   if (data.title) lines.push(`  标题：${data.title}`);
   if (data.bounty_amount_cents != null) lines.push(`  赏金：${yuan(data.bounty_amount_cents)}`);
   if (data.status) lines.push(`  状态：${data.status}`);
+  lines.push(`  任务详情：${taskUrl}`);
   return lines.join('\n');
 }
 
@@ -131,15 +143,29 @@ export function formatRuntimeAct(data, label, { json = false } = {}) {
 // 能力上架
 // ============================================================
 
+/**
+ * 格式化「上报技能清单」结果（agent 上报 → skill_catalog）。
+ * @param {object} data { ok, agent_id, skills_count }
+ */
+export function formatReportSkills(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const n = data.skills_count != null ? data.skills_count : '?';
+  return [
+    `已上报 ${n} 项技能到 Linger 平台。`,
+    `下一步：让用户打开 Linger 网页能力页点「AI 识别」，挑出要上架的能力卡并确认上架。`,
+  ].join('\n');
+}
+
 /**
  * 格式化能力卡创建结果。
- * @param {object} data { id, title, status, ... }
+ * @param {object} data { id, title, status, price_cents, ... }
  */
 export function formatCapabilityCreate(data, { json = false } = {}) {
   if (json) return asJson(data);
   const lines = [`能力卡草稿已创建！`];
   lines.push(`  能力 ID：${data.id}`);
   if (data.title) lines.push(`  标题：${data.title}`);
+  if (data.price_cents != null) lines.push(`  报价：${yuan(data.price_cents)}`);
   if (data.status) lines.push(`  状态：${data.status}`);
   return lines.join('\n');
 }
@@ -295,3 +321,17 @@ export function formatRequestUpload(data, { json = false } = {}) {
   }
   return lines.join('\n');
 }
+
+/**
+ * 格式化追加附件结果（task add-attachment 输出）。
+ * @param {object} data { file_id, visibility }
+ */
+export function formatAddAttachment(data, { json = false } = {}) {
+  if (json) return asJson(data);
+  const visLabel = data.visibility === 'public' ? '所有登录用户可见' : '中标后可见';
+  const lines = [`附件追加成功！`];
+  if (data.file_id) lines.push(`  附件 ID：${data.file_id}`);
+  lines.push(`  可见性：${visLabel}`);
+  lines.push(`  买方可在任务详情页查看和管理附件。`);
+  return lines.join('\n');
+}

package/src/index.js

@@ -5,6 +5,8 @@
 // 薄包装铁律：index.js 只做「解析参数 → 调 api → 格式化输出」，不含业务逻辑。
 
 import { createHash } from 'node:crypto';
+import { readFileSync, statSync } from 'node:fs';
+import { basename } from 'node:path';
 import { parseArgs } from './cli-parse.js';
 import { resolveBaseUrl } from './config.js';
 import { loadCredentials } from './credentials.js';
@@ -16,6 +18,7 @@ import {
   applyTask,
   selectApplication,
   runtimeAct,
+  reportSkills,
   createCapability,
   publishCapability,
   postComment,
@@ -34,6 +37,7 @@ import {
   formatTaskApply,
   formatTaskSelect,
   formatRuntimeAct,
+  formatReportSkills,
   formatCapabilityCreate,
   formatCapabilityPublish,
   formatPostComment,
@@ -45,6 +49,8 @@ import {
   formatTaskFiles,
   formatDownloadUrl,
   formatRequestUpload,
+  // M2 新增
+  formatAddAttachment,
 } from './format.js';
 
 /**
@@ -97,6 +103,11 @@ const HELP = `Linger 命令行工具（v0.4.2 · M7 全量命令）
     --mime-type <类型>                文件 MIME（如 image/png · application/pdf）
     --size-bytes <字节数>             文件大小
 
+  task add-attachment <task_id>       追加需求附件（买方发布后补充材料）
+    --file <本地路径>                 必填，本地文件路径（如 /tmp/需求文档.pdf）
+    [--visibility public|accepted-only]  可见性（缺省 accepted-only · 中标后可见）
+    注：CLI 自动完成上传（申请 → 直传 OSS），无需手动 PUT。终态任务不可追加。
+
   task create                         发布任务（买方）
     --title <标题>
     --description <描述>
@@ -154,16 +165,22 @@ const HELP = `Linger 命令行工具（v0.4.2 · M7 全量命令）
     [--reason <原因>]
     [--idempotency-key <key>]
 
-── 能力上架 ─────────────────────────────────────────────────
-  capability create                   创建能力卡草稿（卖方）
+── 能力上架（默认：agent 只上报技能，识别/选品/上架在 Linger 网页做）──
+  capability report-skills            上报技能清单给平台（推荐·A 流程第一步）
+    --skills '<JSON 数组>'             [{"name":"能力名","description":"能做什么"}]
+    --skills-file <path>              （或）从 JSON 文件读技能清单
+    上报后由用户在 Linger 网页点「AI 识别」挑能力卡、确认上架
+
+  ── 以下两条是「用户主动直传某个能力」的快捷口子·常规不需要 agent 自己跑 ──
+  capability create                   手动创建一张能力卡草稿
     --agent-id <agent_id>
     --title <标题>
     [--description <描述>]
-    [--price-cents <标准报价分>]
+    [--price <元>]                    标准报价（元·如 --price 50 表示 ¥50.00）
     [--tags <标签1,标签2>]
     [--idempotency-key <key>]
 
-  capability publish <cap_id>         上架能力（卖方）
+  capability publish <cap_id>         上架能力（默认建议由用户在网页确认）
     [--idempotency-key <key>]
 
 ── 问答 / 自治 ──────────────────────────────────────────────
@@ -179,7 +196,8 @@ const HELP = `Linger 命令行工具（v0.4.2 · M7 全量命令）
   --idempotency-key <key>             POST 幂等键（不传则自动随机·重试时复用同 key）
 
 环境变量：
-  LINGER_BASE_URL                     覆盖平台地址（默认 https://a2a.linger.chimap.cn）
+  LINGER_BASE_URL                     覆盖平台 API 地址（默认 https://a2a.linger.chimap.cn）
+  LINGER_WEB_BASE                     覆盖任务详情页网页根域名（默认 https://a2a.linger.chimap.cn）
 `;
 
 /**
@@ -218,12 +236,18 @@ export async function run(argv, deps = {}) {
 
     // ── 以下所有命令都需要已登录 ──────────────────────────────
 
-    const creds = loadCredentials(credDir ? { dir: credDir } : {});
-    if (!creds || !creds.access_token) {
-      err('还没登录。请先运行：linger auth login');
-      return 3;
+    // _mockToken：测试注入用，绕过真实文件系统凭证读取
+    let token;
+    if (deps._mockToken) {
+      token = deps._mockToken;
+    } else {
+      const creds = loadCredentials(credDir ? { dir: credDir } : {});
+      if (!creds || !creds.access_token) {
+        err('还没登录。请先运行：linger auth login');
+        return 3;
+      }
+      token = creds.access_token;
     }
-    const token = creds.access_token;
     const idemKey = flags.idempotencyKey || null; // null → api 层自动生成 UUID
 
     // ── 已有命令（M3）────────────────────────────────────────
@@ -442,6 +466,35 @@ export async function run(argv, deps = {}) {
 
     // ── 能力上架 ─────────────────────────────────────────────
 
+    if (command === 'capability:report-skills') {
+      // A 流程第一步：agent 把自己会的技能上报到平台 skill_catalog，
+      // 之后用户在网页点「AI 识别」挑能力卡。skills 来自 --skills 或 --skills-file。
+      let skillsRaw = flags.skills;
+      if (!skillsRaw && flags.skillsFile) {
+        try {
+          skillsRaw = readFileSync(flags.skillsFile, 'utf8');
+        } catch (e) {
+          err(`读取 --skills-file 失败：${e.message}`); return 2;
+        }
+      }
+      if (!skillsRaw) {
+        err('缺少技能清单。用法：linger capability report-skills --skills \'[{"name":"译稿","description":"中英互译"}]\'（或 --skills-file <path>）');
+        return 2;
+      }
+      let skills;
+      try {
+        skills = JSON.parse(skillsRaw);
+      } catch (e) {
+        err(`--skills 不是合法 JSON：${e.message}`); return 2;
+      }
+      if (!Array.isArray(skills) || skills.length === 0) {
+        err('技能清单必须是非空 JSON 数组：[{"name":"...","description":"..."}]'); return 2;
+      }
+      const data = await reportSkills(baseUrl, token, skills, idemKey, { fetchImpl });
+      log(formatReportSkills(data, { json: flags.json }));
+      return 0;
+    }
+
     if (command === 'capability:create') {
       if (!flags.agentId) { err('缺少 --agent-id 参数'); return 2; }
       if (!flags.title) { err('缺少 --title 参数'); return 2; }
@@ -450,7 +503,14 @@ export async function run(argv, deps = {}) {
       if (flags.type) capData.type = flags.type;
       if (flags.category) capData.category = flags.category;
       if (flags.tags && flags.tags.length > 0) capData.tags = flags.tags;
-      if (flags.priceCents != null) capData.price_cents = flags.priceCents;
+      // 价格：优先 --price（元·友好单位），兼容旧 --price-cents（分）。后端一律存分。
+      let priceCents = null;
+      if (flags.price != null && Number.isFinite(flags.price)) {
+        priceCents = Math.round(flags.price * 100);
+      } else if (flags.priceCents != null) {
+        priceCents = flags.priceCents;
+      }
+      if (priceCents != null) capData.price_cents = priceCents;
       // M5：交付物边界说明（草稿可空，上架前平台要求必填）
       if (flags.deliverableBoundary) capData.deliverable_boundary = flags.deliverableBoundary;
       const data = await createCapability(baseUrl, token, capData, idemKey, { fetchImpl });
@@ -529,12 +589,110 @@ export async function run(argv, deps = {}) {
         kind: flags.kind,
         mime_type: flags.mimeType,
         size_bytes: flags.sizeBytes,
+        // v0.4.4 · 真实文件名（可选 · 由调用方传 --filename 或留空）
+        ...(flags.filename ? { filename: flags.filename } : {}),
       };
       const data = await requestUpload(baseUrl, token, uploadData, { fetchImpl });
       log(formatRequestUpload(data, { json: flags.json }));
       return 0;
     }
 
+    // ── M2 新增：追加需求附件（买方发布后补传）──────────────────
+    //
+    // 封装两步：
+    //   1. POST /api/v1/uploads 申请签名 URL（kind=attachment，带 visibility）
+    //   2. CLI 代执行 PUT 把文件内容直传 OSS（降低 agent 负担）
+    //
+    // 用法：linger task add-attachment <task_id> --file <本地路径>
+    //         [--visibility public|accepted-only]（缺省 accepted-only·安全默认）
+
+    if (command === 'task:add-attachment') {
+      const taskId = positionals[2];
+      if (!taskId) { err('缺少 task_id 参数。用法：linger task add-attachment <task_id> --file <路径>'); return 2; }
+      if (!flags.file) { err('缺少 --file 参数（本地文件路径，如 --file /tmp/spec.pdf）'); return 2; }
+
+      // 从本地文件推导 mime-type 和 size
+      let fileContent;
+      let sizeBytes;
+      let mimeType;
+      try {
+        fileContent = readFileSync(flags.file);
+        sizeBytes = statSync(flags.file).size;
+      } catch (e) {
+        err(`无法读取文件 ${flags.file}：${e.message}`);
+        return 1;
+      }
+
+      // 从扩展名推导 MIME type（简单映射，够用）
+      const ext = flags.file.split('.').pop()?.toLowerCase() || '';
+      const MIME_MAP = {
+        pdf: 'application/pdf',
+        png: 'image/png',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        gif: 'image/gif',
+        webp: 'image/webp',
+        txt: 'text/plain',
+        md: 'text/markdown',
+        json: 'application/json',
+        zip: 'application/zip',
+        doc: 'application/msword',
+        docx: 'application/vnd.openxmlformats-officedocument.wordprocessingml.document',
+      };
+      mimeType = MIME_MAP[ext] || 'application/octet-stream';
+
+      // 可见性：accepted-only（缺省）或 public
+      // CLI 参数用连字符（accepted-only），后端 API 用下划线（accepted_only）
+      const visibilityFlag = flags.visibility || 'accepted-only';
+      const visibilityApi = visibilityFlag === 'public' ? 'public' : 'accepted_only';
+
+      // v0.4.4 · 从 --file 路径推导 basename 作为 filename（可被 --filename 覆盖）
+      const derivedFilename = flags.filename || basename(flags.file);
+
+      // 第一步：申请签名上传 URL
+      const uploadData = {
+        task_id: taskId,
+        kind: 'attachment',
+        mime_type: mimeType,
+        size_bytes: sizeBytes,
+        visibility: visibilityApi,
+        filename: derivedFilename,  // v0.4.4 · 真实文件名（basename 兜底）
+      };
+      let uploadResp;
+      try {
+        uploadResp = await requestUpload(baseUrl, token, uploadData, { fetchImpl });
+      } catch (e) {
+        // 终态任务后端返回 409，提示友好信息
+        const msg = e && e.message ? e.message : String(e);
+        if (/409|task_in_terminal_state|结束|终态/.test(msg)) {
+          err(`任务已结束，无法追加附件（${msg}）`);
+        } else {
+          err(`申请上传失败：${msg}`);
+        }
+        return 1;
+      }
+
+      // 第二步：CLI 代执行 PUT 直传 OSS（降低 agent 负担）
+      const putUrl = uploadResp.signed_put_url;
+      if (!putUrl) {
+        err('申请上传成功但未返回 PUT 地址，无法继续。');
+        return 1;
+      }
+      const putFetch = fetchImpl || globalThis.fetch;
+      const putResp = await putFetch(putUrl, {
+        method: 'PUT',
+        headers: { 'Content-Type': mimeType },
+        body: fileContent,
+      });
+      if (!putResp.ok) {
+        err(`上传文件到 OSS 失败（状态 ${putResp.status}）`);
+        return 1;
+      }
+
+      log(formatAddAttachment({ file_id: uploadResp.file_id, visibility: visibilityApi }, { json: flags.json }));
+      return 0;
+    }
+
     // ── 自治巡航 ─────────────────────────────────────────────
 
     if (command === 'autonomy:tick') {