npm - @lingerai/cli - Versions diffs - 0.2.0 → 0.3.1 - Mend

@lingerai/cli 0.2.0 → 0.3.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (5) hide show

package/package.json CHANGED Viewed

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

package/src/callback-pages.js CHANGED Viewed

@@ -7,7 +7,7 @@
 // 图标用内联 SVG、动画包 prefers-reduced-motion 降级、文案极简（每页 1 句 caption）。
 //
 // 三个常量对应 oauth.js loopback handler 的三个 res.end：
-//   SUCCESS — 拿到 code（绑定成功 · 带「打开 Linger 主页」按钮）
+//   SUCCESS — 拿到 code（绑定成功 · 带「去我的主页」按钮·指向 user-profile 旗下 Agent·非站点根/任务大厅）
 //   ERROR   — error（授权未完成 · 回命令行重试）
 //   MISSING — 缺授权码（回调异常）
@@ -70,7 +70,7 @@ const CALLBACK_HTML_SUCCESS = `<!DOCTYPE html>
     </div>
     <h1>绑定成功 · 已连接 Linger</h1>
     <p>可以关闭此页面，回到命令行</p>
-    <a class="btn" href="https://a2a.linger.chimap.cn">打开 Linger 主页</a>
+    <a class="btn" href="https://a2a.linger.chimap.cn/src/pages/user-profile/index.html#tab=agents">去我的主页</a>
   </main>
 </body>
 </html>`;

package/src/cli-parse.js CHANGED Viewed

@@ -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'
@@ -103,6 +108,9 @@ export function parseArgs(argv) {
     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 = [];
@@ -185,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 {
@@ -210,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;

package/src/format.js CHANGED Viewed

@@ -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');
 }
@@ -309,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 CHANGED Viewed

@@ -5,7 +5,8 @@
 // 薄包装铁律：index.js 只做「解析参数 → 调 api → 格式化输出」，不含业务逻辑。
 import { createHash } from 'node:crypto';
-import { readFileSync } from 'node:fs';
+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';
@@ -48,6 +49,8 @@ import {
   formatTaskFiles,
   formatDownloadUrl,
   formatRequestUpload,
+  // M2 新增
+  formatAddAttachment,
 } from './format.js';
 /**
@@ -100,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 <描述>
@@ -188,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）
 `;
 /**
@@ -227,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）────────────────────────────────────────
@@ -574,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') {