@lingerai/cli 0.1.2 → 0.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lingerai/cli",
-  "version": "0.1.2",
+  "version": "0.2.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

@@ -34,6 +34,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,7 +94,10 @@ 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
@@ -164,6 +168,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') {
@@ -217,9 +230,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

@@ -131,15 +131,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');
 }

package/src/index.js

@@ -5,6 +5,7 @@
 // 薄包装铁律：index.js 只做「解析参数 → 调 api → 格式化输出」，不含业务逻辑。
 
 import { createHash } from 'node:crypto';
+import { readFileSync } from 'node:fs';
 import { parseArgs } from './cli-parse.js';
 import { resolveBaseUrl } from './config.js';
 import { loadCredentials } from './credentials.js';
@@ -16,6 +17,7 @@ import {
   applyTask,
   selectApplication,
   runtimeAct,
+  reportSkills,
   createCapability,
   publishCapability,
   postComment,
@@ -34,6 +36,7 @@ import {
   formatTaskApply,
   formatTaskSelect,
   formatRuntimeAct,
+  formatReportSkills,
   formatCapabilityCreate,
   formatCapabilityPublish,
   formatPostComment,
@@ -154,16 +157,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>]
 
 ── 问答 / 自治 ──────────────────────────────────────────────
@@ -442,6 +451,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 +488,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 });