@soulspacex/cli 0.1.0 → 0.2.1

package/README.md

@@ -33,6 +33,7 @@ ssx node list                              # 看看都生成完了没
 - **生成默认阻塞到出结果**（最长 55 秒）。不要自己写 while 循环轮询——每轮一次都是一次模型调用，token 是用户在付。要立刻返回就 `--wait 0`。
 - **节点可以用名字指代**，重名时才需要用 id。
 - **命令行创作按积分计费，不使用无限模式额度。**
+- **想让产物在网页素材库里看得到，要显式存**：`ssx asset save 主视觉 --category scene`。分类是 `character` / `scene` / `item`（默认）/ `voice`，**素材库不收视频**。
 
 ## 命令
 
@@ -47,7 +48,9 @@ ssx node list                              # 看看都生成完了没
 | `ssx generate <kind> --model <名> --prompt <描述>` | 不走画布的一次性生成 |
 | `ssx model list` / `ssx model search <词>` | 可用模型与计价 |
 | `ssx schema` | 节点字段契约 |
-| `ssx upload <文件>` / `ssx download <url>` | 素材进出 |
+| `ssx upload <文件>` / `ssx download <url>` | 素材进出（默认只拿 URL，不进素材库） |
+| `ssx asset save <节点名\|url>` / `asset list` | 存进素材库、看库里有什么 |
+| `ssx space list` | 素材空间，不指定就落默认个人空间 |
 
 ## 环境变量
 

package/dist/commands/asset.js

@@ -0,0 +1,149 @@
+import { readFile } from 'node:fs/promises';
+import { basename, resolve as resolvePath } from 'node:path';
+import { api } from '../api.js';
+import { emit, fail } from '../output.js';
+import { find } from './node.js';
+import { resolveWorkflowId } from './workflow.js';
+export async function asset(parsed) {
+    const sub = parsed.positional[1] ?? 'list';
+    switch (sub) {
+        case 'list':
+            return listItems(parsed);
+        case 'save':
+            return save(parsed);
+        default:
+            return fail(`未知的子命令 ${sub}`, '可用：list / save');
+    }
+}
+export async function space(parsed) {
+    const sub = parsed.positional[1] ?? 'list';
+    if (sub !== 'list') {
+        return fail(`未知的子命令 ${sub}`, '可用：list');
+    }
+    emit(await api.get('/openapi/library/spaces'));
+}
+async function listItems(parsed) {
+    const query = new URLSearchParams();
+    const spaceId = str(parsed.options.space);
+    const category = str(parsed.options.category);
+    const keyword = str(parsed.options.keyword) ?? parsed.positional[2];
+    if (spaceId)
+        query.set('spaceId', spaceId);
+    if (category)
+        query.set('category', category);
+    if (keyword)
+        query.set('keyword', keyword);
+    if (str(parsed.options.limit))
+        query.set('limit', str(parsed.options.limit));
+    const page = await api.get(`/openapi/library?${query}`);
+    emit({
+        total: page.total,
+        items: page.items.map((i) => ({
+            id: i.id,
+            name: i.name,
+            category: i.category,
+            type: i.type,
+            url: i.url,
+        })),
+    });
+}
+/**
+ * 存进素材库。参数既接节点名也接裸 URL——agent 手里通常是刚跑完的节点名，
+ * 让它先去翻 URL 再传回来是多一轮往返，而每一轮都是用户在付 token。
+ */
+async function save(parsed) {
+    const ref = parsed.positional[2];
+    if (!ref) {
+        return fail('要指定节点名或 URL', '用法：ssx asset save 主视觉 --category scene');
+    }
+    let url;
+    let sourceAssetId;
+    let name = str(parsed.options.name);
+    if (/^https?:\/\//i.test(ref)) {
+        url = ref;
+    }
+    else {
+        const node = await find(resolveWorkflowId(parsed), ref);
+        const data = (node.data ?? {});
+        const found = artifactOf(data);
+        if (found.url === null) {
+            return found.reason === 'pending'
+                ? fail(`节点「${ref}」还没有产物（当前 ${String(data.status ?? 'idle')}）`, `先跑 ssx node run ${ref}`)
+                : fail(`节点「${ref}」的产物不是图片或音频`, '素材库只收图片与音频，文本节点存不进去');
+        }
+        url = found.url;
+        sourceAssetId = found.sourceAssetId;
+        name = name ?? str(data.title);
+    }
+    const item = await api.post('/openapi/library/from-url', {
+        url,
+        category: str(parsed.options.category),
+        name,
+        description: str(parsed.options.description),
+        spaceId: numeric(str(parsed.options.space)),
+        sourceAssetId,
+    });
+    emit({ assetId: item.id, spaceId: item.spaceId, category: item.category, url: item.url });
+}
+/**
+ * 从节点 data 里取可入库的产物。
+ *
+ * 优先 assets[0]：它带 assetId，能让服务端继承源素材的尺寸和 mime。退回 result 时只有 URL，
+ * 入库后宽高是空的——素材库列表按宽高排版，缺了会塌。
+ *
+ * 取不到时区分两种原因：还没跑（让用户去 run）与产物压根不是媒体（文本节点，重试多少次都一样）。
+ * 合成一句「存不了」会让 agent 反复重跑那个节点。
+ */
+export function artifactOf(data) {
+    const assets = Array.isArray(data.assets) ? data.assets : [];
+    const first = assets[0];
+    if (first?.url) {
+        return { url: first.url, sourceAssetId: first.assetId ?? numeric(data.assetId) };
+    }
+    if (typeof data.result === 'string' && /^https?:\/\//i.test(data.result)) {
+        return { url: data.result, sourceAssetId: numeric(data.assetId) };
+    }
+    return { url: null, reason: data.status === 'completed' ? 'not-media' : 'pending' };
+}
+/** 供 `ssx upload --library` 用：直接把本地文件传成素材库条目。 */
+export async function uploadToLibrary(parsed, path) {
+    const abs = resolvePath(path);
+    const bytes = await readFile(abs).catch(() => fail(`读不到文件 ${abs}`));
+    const form = new FormData();
+    form.append('file', new Blob([bytes], { type: mimeOf(abs) }), basename(abs));
+    const category = str(parsed.options.category);
+    const spaceId = str(parsed.options.space);
+    const name = str(parsed.options.name);
+    const query = new URLSearchParams();
+    if (category)
+        query.set('category', category);
+    if (spaceId)
+        query.set('spaceId', spaceId);
+    if (name)
+        query.set('name', name);
+    const item = await api.upload(`/openapi/library/upload?${query}`, form);
+    emit({ assetId: item.id, spaceId: item.spaceId, category: item.category, url: item.url });
+}
+function str(v) {
+    return typeof v === 'string' && v.length > 0 ? v : undefined;
+}
+function numeric(v) {
+    const n = Number(v);
+    return Number.isFinite(n) && n > 0 ? n : undefined;
+}
+// 与 misc.ts 的 upload 同源：Blob 不带 type 时 multipart 会退成 application/octet-stream，
+// 服务端按 MIME 判类型会直接拒
+function mimeOf(path) {
+    const ext = path.slice(path.lastIndexOf('.') + 1).toLowerCase();
+    const map = {
+        png: 'image/png',
+        jpg: 'image/jpeg',
+        jpeg: 'image/jpeg',
+        webp: 'image/webp',
+        gif: 'image/gif',
+        mp3: 'audio/mpeg',
+        wav: 'audio/wav',
+        m4a: 'audio/mp4',
+    };
+    return map[ext] ?? 'application/octet-stream';
+}

package/dist/commands/misc.js

@@ -6,6 +6,7 @@ import { pipeline } from 'node:stream/promises';
 import { api } from '../api.js';
 import { emit, fail, log } from '../output.js';
 import { parseKeyValues } from '../args.js';
+import { uploadToLibrary } from './asset.js';
 export async function model(parsed) {
     // 类型只认 --type。位置参数留给关键词：`ssx model search nano` 里的 nano 是要搜的词，
     // 不是模型类型——把它当成 type 会让后端过滤出空列表，而 agent 看到空列表会以为没有可用模型
@@ -71,6 +72,10 @@ export async function upload(parsed) {
     if (!path) {
         fail('要指定文件', '用法：ssx upload ./ref.png');
     }
+    // 默认只把文件放上 OSS 拿个 URL 给画布用；--library 才落成素材库里看得到的条目
+    if (parsed.options.library) {
+        return uploadToLibrary(parsed, path);
+    }
     const abs = resolve(path);
     const bytes = await readFile(abs).catch(() => fail(`读不到文件 ${abs}`));
     const form = new FormData();

package/dist/commands/node.js

@@ -235,7 +235,7 @@ async function runNode(workflowId, nodeId, wait) {
     });
 }
 /** 支持按名字或 id 定位。agent 记名字比记 uuid 容易，这一点对它的可用性影响很大。 */
-async function find(workflowId, ref) {
+export async function find(workflowId, ref) {
     const canvas = await api.get(`/openapi/workflows/${workflowId}`);
     return locate(canvas.nodes, ref);
 }

package/dist/index.js

@@ -5,7 +5,8 @@ import { login, logout, whoami } from './commands/login.js';
 import { workflow } from './commands/workflow.js';
 import { node } from './commands/node.js';
 import { balance, downloadCommand, generate, model, schema, upload } from './commands/misc.js';
-const VERSION = '0.1.0';
+import { asset, space } from './commands/asset.js';
+const VERSION = '0.2.1';
 /**
  * 这段 help 的第一读者是 AI Agent，不是人。
  *
@@ -56,9 +57,17 @@ const HELP = `ssx — SoulSpaceX 命令行工具
   ssx model search nano             按名字搜
 
 素材
-  ssx upload ./ref.png              上传参考图，拿到可用的 URL
+  ssx upload ./ref.png              上传参考图，拿到可用的 URL（不进素材库）
   ssx download <url> -o out.png     下载产物到本地
 
+素材库（用户在网页上看得到的那个库，只收图片与音频）
+  ssx asset save 主视觉              把跑完的节点产物存进素材库，也接裸 URL
+  ssx asset save 主视觉 --category scene --name 赛博街道
+  ssx asset list --category scene   看库里已有什么，省得重复生成
+  ssx upload ./ref.png --library    本地文件直接入库
+  ssx space list                    素材空间列表，不指定就落默认个人空间
+  分类：character 人物 / scene 场景 / item 道具（默认）/ voice 音频
+
 其他
   ssx schema                        节点字段契约。拼 --set 之前先看这个，别猜字段名
   ssx balance                       积分余额
@@ -105,6 +114,10 @@ async function main() {
             return balance();
         case 'generate':
             return generate(parsed);
+        case 'asset':
+            return asset(parsed);
+        case 'space':
+            return space(parsed);
         case 'upload':
             return upload(parsed);
         case 'download':

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@soulspacex/cli",
-  "version": "0.1.0",
+  "version": "0.2.1",
   "description": "SoulSpaceX 命令行工具——让 AI Agent 直接在画布上创作",
   "bin": {
     "ssx": "dist/index.js"