@artflo-ai/artflo-openclaw-plugin 0.0.5 → 0.0.7

package/dist/index.js

@@ -2,6 +2,7 @@ import { createPluginConfig } from './src/config.js';
 import { createSessionRegistryService } from './src/services/canvas-session-registry.js';
 import { registerArtfloTools } from './src/tools/register-tools.js';
 import { fetchClientParams } from './src/core/config/fetch-client-params.js';
+import { fetchUserStatus } from './src/core/config/fetch-user-status.js';
 import { PLUGIN_DESCRIPTION, PLUGIN_ID, PLUGIN_NAME } from './src/constants.js';
 const pluginConfigSchema = {
     type: 'object',
@@ -69,19 +70,25 @@ const plugin = {
             workspaceDir: api.rootDir,
             sessions: sessions.registry,
         });
-        // ── 每次 prompt 构建时注入 Artflo 配置状态 ──────────────────────
-        api.on('before_prompt_build', () => {
+        // ── 每次 prompt 构建时注入 Artflo 配置和用户状态 ──────────────
+        api.on('before_prompt_build', async () => {
             const masked = config.apiKey
                 ? `****${config.apiKey.slice(-4)}`
                 : '未配置';
-            return {
-                appendSystemContext: [
-                    `[Artflo Plugin] env=${config.env}, apiKey=${masked}`,
-                    config.apiKey
-                        ? 'API Key 已配置，可直接使用画布功能。'
-                        : 'API Key 未配置，请引导用户通过 artflo_set_api_key 设置。',
-                ].join(' | '),
-            };
+            const lines = [`[Artflo Plugin] env=${config.env}, apiKey=${masked}, tz=${config.timeZone}, country=${config.countryCode}`];
+            if (!config.apiKey) {
+                lines.push('API Key 未配置，请引导用户通过 artflo_set_api_key 设置。');
+            }
+            else {
+                try {
+                    const status = await fetchUserStatus(config);
+                    lines.push(`plan=${status.plan}, subscribed=${status.isSubscribed}, credits=${status.credits}`);
+                }
+                catch {
+                    lines.push('API Key 已配置，用户状态获取失败。');
+                }
+            }
+            return { appendSystemContext: lines.join(' | ') };
         });
     },
 };

package/dist/src/config.js

@@ -41,7 +41,6 @@ export function createPluginConfig(api) {
     return {
         env,
         apiBaseUrl: urls.apiBaseUrl,
-        vipApiBaseUrl: urls.vipApiBaseUrl,
         webApiBaseUrl: urls.webApiBaseUrl,
         apiKey: readString(pluginConfig.apiKey, ''),
         appKey: readString(pluginConfig.appKey, ''),

package/dist/src/constants.js

@@ -4,12 +4,10 @@ export const PLUGIN_DESCRIPTION = 'Expose deterministic Artflo canvas tools over
 export const ENV_CONFIG = {
     release: {
         apiBaseUrl: 'https://webapi.artflo.ai',
-        vipApiBaseUrl: 'https://api-h5-sub.starii.com',
         webApiBaseUrl: 'https://artflo.ai',
     },
     test: {
         apiBaseUrl: 'https://testwebapi.artflo.ai',
-        vipApiBaseUrl: 'https://pre-api-h5-sub.starii.com',
         webApiBaseUrl: 'https://test.artflo.ai',
     },
 };
@@ -33,4 +31,5 @@ export const ARTFLO_TOOL_NAMES = {
     listModels: 'artflo_canvas_list_models',
     uploadFile: 'artflo_upload_file',
     setApiKey: 'artflo_set_api_key',
+    getUserStatus: 'artflo_get_user_status',
 };

package/dist/src/core/api/api-base.js

@@ -1,2 +1,2 @@
 // Re-export from api-paths for backward compatibility
-export { buildApiUrl, buildWsUrl, buildVipUrl, buildWebUrl } from './api-paths.js';
+export { buildApiUrl, buildWsUrl, buildWebUrl } from './api-paths.js';

package/dist/src/core/api/api-paths.js

@@ -8,8 +8,8 @@ export const WS_CANVAS = '/canvas/ws';
 /** apiBaseUrl paths */
 export const API_CREATE_CANVAS = '/canvas';
 export const API_UPLOAD_FILE = '/storage/obs/starii';
-/** vipApiBaseUrl paths */
-export const API_VIP_INFO = '/h5/user/vip_info_by_group.json';
+export const API_CREDITS_REMAINING = '/user/credits_remaining';
+export const API_SUBSCRIPTION_PLAN = '/user/subscription_plan';
 /** webApiBaseUrl paths */
 export const API_CLIENT_PARAMS = '/api/subscribe-client-params';
 // ── Helper builders ─────────────────────────────────────────────────
@@ -19,9 +19,6 @@ function strip(url) {
 export function buildApiUrl(config, path) {
     return `${strip(config.apiBaseUrl)}${path}`;
 }
-export function buildVipUrl(config, path) {
-    return `${strip(config.vipApiBaseUrl)}${path}`;
-}
 export function buildWebUrl(config, path) {
     return `${strip(config.webApiBaseUrl)}${path}`;
 }

package/dist/src/core/config/fetch-user-status.js

@@ -0,0 +1,34 @@
+/**
+ * Fetch user subscription plan and credits from Artflo API.
+ * Replaces the old fetch-vip-info.ts which used the starii VIP API.
+ */
+import { buildApiUrl, API_CREDITS_REMAINING, API_SUBSCRIPTION_PLAN } from '../api/api-paths.js';
+export async function fetchUserStatus(config) {
+    const headers = {
+        'Content-Type': 'application/json',
+        'X-API-Key': config.apiKey,
+    };
+    const [creditsRes, planRes] = await Promise.all([
+        fetch(buildApiUrl(config, API_CREDITS_REMAINING), { headers }).catch(() => null),
+        fetch(buildApiUrl(config, API_SUBSCRIPTION_PLAN), { headers }).catch(() => null),
+    ]);
+    let credits = 0;
+    if (creditsRes?.ok) {
+        const body = (await creditsRes.json());
+        if (body.code === 0 && body.data) {
+            credits = body.data.total_available ?? 0;
+        }
+    }
+    let plan = 'free';
+    let isSubscribed = false;
+    let expireAt = 0;
+    if (planRes?.ok) {
+        const body = (await planRes.json());
+        if (body.code === 0 && body.data) {
+            plan = body.data.plan ?? 'free';
+            isSubscribed = body.data.is_valid === true;
+            expireAt = body.data.expire_at ?? 0;
+        }
+    }
+    return { plan, isSubscribed, credits, expireAt };
+}

package/dist/src/core/config/model-config-transformer.js

@@ -31,11 +31,9 @@ const OUTPUT_TOOL_DESCRIPTIONS = {
 // ---------------------------------------------------------------------------
 // Transform helpers
 // ---------------------------------------------------------------------------
-function transformModelItem(model, isVip) {
+function transformModelItem(model, isSubscribed) {
     const available = !model.disable &&
-        (!model.subscribe_available ||
-            (model.subscribe_available && isVip) ||
-            model.is_free_limit);
+        (!model.subscribe_available || isSubscribed);
     const item = {
         key: model.model_key,
         name: model.model_name,
@@ -43,7 +41,6 @@ function transformModelItem(model, isVip) {
         isDefault: model.is_default,
         available,
         requiresSubscription: model.subscribe_available,
-        isFreeLimit: model.is_free_limit,
     };
     if (model.support_ratio?.length)
         item.supportedRatios = model.support_ratio;
@@ -66,14 +63,14 @@ function transformModelItem(model, isVip) {
 // ---------------------------------------------------------------------------
 // Public API
 // ---------------------------------------------------------------------------
-export function transformCanvasConfig(config, isVip) {
+export function transformCanvasConfig(config, isSubscribed) {
     const categories = [];
     for (const [toolTypeStr, info] of Object.entries(CATEGORY_INFO)) {
         const toolType = Number(toolTypeStr);
         const models = config[info.configKey];
         if (!Array.isArray(models) || models.length === 0)
             continue;
-        const transformed = models.map((m) => transformModelItem(m, isVip));
+        const transformed = models.map((m) => transformModelItem(m, isSubscribed));
         if (transformed.some((m) => m.available)) {
             categories.push({
                 name: info.name,
@@ -90,7 +87,6 @@ export function transformCanvasConfig(config, isVip) {
                 toolType: tool.tool_type,
                 name: tool.name,
                 description: OUTPUT_TOOL_DESCRIPTIONS[tool.tool_type] ?? tool.name,
-                isFreeLimit: tool.is_free_limit,
             });
         }
     }

package/dist/src/tools/register-tools.js

@@ -16,7 +16,7 @@ function jsonResult(payload) {
 import { ARTFLO_TOOL_NAMES } from '../constants.js';
 import { createCanvas } from '../core/canvas/create-canvas.js';
 import { uploadFile } from '../core/api/upload-file.js';
-import { fetchVipInfo } from '../core/config/fetch-vip-info.js';
+import { fetchUserStatus } from '../core/config/fetch-user-status.js';
 import { transformCanvasConfig } from '../core/config/model-config-transformer.js';
 import { executePlan as runExecutePlan } from '../core/executor/execute-plan.js';
 import { ExecutionTraceWriter } from '../core/executor/execution-trace.js';
@@ -153,9 +153,9 @@ export function registerArtfloTools(api, context) {
                 const session = context.sessions.getOrCreate(canvasId);
                 await session.connect({ canvasId });
                 const canvasConfig = session.getCanvasConfig();
-                const vipInfo = await fetchVipInfo(context.config);
+                const userStatus = await fetchUserStatus(context.config);
                 const llmConfig = canvasConfig
-                    ? transformCanvasConfig(canvasConfig, vipInfo.isVip)
+                    ? transformCanvasConfig(canvasConfig, userStatus.isSubscribed)
                     : null;
                 return jsonResult({
                     ok: true,
@@ -163,9 +163,9 @@ export function registerArtfloTools(api, context) {
                     data: {
                         canvasId,
                         subscription: {
-                            isVip: vipInfo.isVip,
-                            membershipLevel: vipInfo.membershipLevel,
-                            membershipName: vipInfo.membershipName,
+                            plan: userStatus.plan,
+                            isSubscribed: userStatus.isSubscribed,
+                            credits: userStatus.credits,
                         },
                         models: llmConfig?.categories ?? [],
                         outputTools: llmConfig?.outputTools ?? [],
@@ -470,7 +470,7 @@ export function registerArtfloTools(api, context) {
                 const session = context.sessions.getOrCreate(payload.canvasId);
                 await session.connect({ canvasId: payload.canvasId });
                 const canvasConfig = session.getCanvasConfig();
-                const vipInfo = await fetchVipInfo(context.config);
+                const userStatus = await fetchUserStatus(context.config);
                 if (!canvasConfig) {
                     return jsonResult({
                         ok: false,
@@ -499,7 +499,7 @@ export function registerArtfloTools(api, context) {
                     const isVideo = VIDEO_TOOL_TYPES.has(info.toolType);
                     const mapped = models.map((m) => {
                         const modelAvailable = !m.disable &&
-                            (!m.subscribe_available || vipInfo.isVip || m.is_free_limit);
+                            (!m.subscribe_available || userStatus.isSubscribed);
                         // Build per-resolution pricing
                         const resolutionPricing = m.multi_config_price && Object.keys(m.multi_config_price).length > 0
                             ? Object.fromEntries(Object.entries(m.multi_config_price).map(([key, price]) => {
@@ -544,11 +544,12 @@ export function registerArtfloTools(api, context) {
                     label: ARTFLO_TOOL_NAMES.listModels,
                     data: {
                         subscription: {
-                            isVip: vipInfo.isVip,
-                            membershipLevel: vipInfo.membershipLevel,
+                            plan: userStatus.plan,
+                            isSubscribed: userStatus.isSubscribed,
+                            credits: userStatus.credits,
                             pricingUrl: 'https://artflo.ai/pricing',
                         },
-                        hint: vipInfo.isVip
+                        hint: userStatus.isSubscribed
                             ? undefined
                             : 'User is not subscribed. Models or resolutions marked requiresSubscription need a subscription. Visit https://artflo.ai/pricing to subscribe, or use free models.',
                         categories: result,
@@ -582,6 +583,35 @@ export function registerArtfloTools(api, context) {
             });
         },
     });
+    api.registerTool({
+        name: ARTFLO_TOOL_NAMES.getUserStatus,
+        label: 'Artflo Get User Status',
+        description: 'Get the current user subscription plan and remaining credits. Does not require a canvas connection.',
+        parameters: Type.Object({}),
+        async execute(_id, params) {
+            return runWithToolTrace(ARTFLO_TOOL_NAMES.getUserStatus, params, async () => {
+                if (!context.config.apiKey) {
+                    return jsonResult({
+                        ok: false,
+                        label: ARTFLO_TOOL_NAMES.getUserStatus,
+                        error: 'API Key not configured. Use artflo_set_api_key to set it first.',
+                    });
+                }
+                const status = await fetchUserStatus(context.config);
+                return jsonResult({
+                    ok: true,
+                    label: ARTFLO_TOOL_NAMES.getUserStatus,
+                    data: {
+                        plan: status.plan,
+                        isSubscribed: status.isSubscribed,
+                        credits: status.credits,
+                        expireAt: status.expireAt,
+                        pricingUrl: 'https://artflo.ai/pricing',
+                    },
+                });
+            });
+        },
+    });
     api.registerTool({
         name: ARTFLO_TOOL_NAMES.setApiKey,
         label: 'Artflo Set Config',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@artflo-ai/artflo-openclaw-plugin",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "type": "module",
   "description": "OpenClaw plugin that connects directly to Artflo canvas WebSocket runtime.",
   "keywords": [
@@ -20,7 +20,12 @@
   "openclaw": {
     "extensions": [
       "./dist/index.js"
-    ]
+    ],
+    "install": {
+      "npmSpec": "@artflo-ai/artflo-openclaw-plugin",
+      "localPath": "extensions/artflo-openclaw-plugin",
+      "defaultChoice": "npm"
+    }
   },
   "publishConfig": {
     "access": "public"

package/skills/artflo-canvas/SKILL.md

@@ -24,10 +24,10 @@ metadata:
 
 ## API Key 配置检查（首要步骤）
 
-在执行任何操作之前，先调用 `artflo_canvas_connection_status` 或 `artflo_canvas_connect` 检查连接。如果返回结果中 `hasApiKey: false`，说明用户还没有配置 API Key。此时你必须：
+**如果 before_prompt_build 注入的上下文显示 `apiKey=未配置`，则：**
 
-1. 停止所有后续操作，不要尝试创建画布或执行工作流。
-2. 引导用户提供 API Key，用以下话术：
+1. **禁止调用除 `artflo_set_api_key` 以外的任何 Artflo 工具。** 没有 API Key，所有接口都会返回 401。
+2. 引导用户提供 API Key：
 
 > 你还没有配置 Artflo API Key，需要先设置才能使用画布功能。
 >
@@ -48,6 +48,7 @@ metadata:
 - 在假设画布运行时已就绪之前，先读取连接状态。
 - 将插件配置视为 WebSocket 凭证和连接默认值的唯一真实来源。
 - **禁止编造 API URL**：不要自行拼接或猜测 Artflo API 路径。所有 API 交互必须通过插件提供的 tool 完成（如 `artflo_canvas_get_last`、`artflo_canvas_create`、`artflo_upload_file` 等）。不要使用 `fetch` 或 `curl` 直接调用 Artflo API。
+- **model_key 保密**：`model_key`（如 `Praline_2`、`ToffeeV1-Lite`）是内部标识，仅供构建 plan 使用。向用户展示模型时只使用 `model_name`（显示名称），绝不向用户暴露 `model_key`。
 - **资源保存路径**：画布生成完成后需要下载保存的资源（图片、视频等），必须保存到 `/artflo/outbound` 目录。不要使用 `/tmp` 或其他临时目录。
 - 当插件布局引擎可用时，不要手工编造节点坐标。
 

package/dist/src/core/config/fetch-vip-info.js

@@ -1,31 +0,0 @@
-/**
- * Fetch user VIP / subscription status from the Artflo subscription API.
- */
-import { buildVipUrl, API_VIP_INFO } from '../api/api-paths.js';
-export async function fetchVipInfo(config) {
-    const url = new URL(buildVipUrl(config, API_VIP_INFO));
-    url.searchParams.set('app_id', config.vipAppId);
-    url.searchParams.set('vip_group', config.vipGroup);
-    const response = await fetch(url.toString(), {
-        method: 'GET',
-        headers: {
-            'X-API-Key': config.apiKey,
-            'app_id': config.vipAppId,
-            'country_code': config.countryCode,
-            'platform': '4',
-            'system_type': '2',
-        },
-    });
-    if (!response.ok) {
-        return { isVip: false, membershipLevel: 'Free', membershipName: 'Free' };
-    }
-    const body = (await response.json());
-    if (body.code !== 0 || !body.data) {
-        return { isVip: false, membershipLevel: 'Free', membershipName: 'Free' };
-    }
-    return {
-        isVip: body.data.is_vip === true || body.data.use_vip === true,
-        membershipLevel: body.data.membership?.level_name ?? 'Free',
-        membershipName: body.data.membership?.display_name ?? 'Free',
-    };
-}